[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_309":310,"_311":312},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_17":18,"_43":-7,"_160":-5,"_19":161,"_162":163,"_164":165,"_166":167,"_168":169,"_21":-5,"_170":-5,"_171":-5,"_172":30,"_173":174,"_175":24,"_176":-5,"_177":-5,"_178":179},"routes/_app.x.$handle.$name.branch.$branch.history_.$",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":-5},"handle","nbbaier","name","agentfs","branchName","main","path","docs","project",{"_37":108,"_13":14,"_41":109,"_110":-5,"_111":30,"_112":113,"_114":113,"_115":116,"_117":-5,"_31":72,"_118":-5,"_119":30,"_120":-5,"_121":-5,"_122":123,"_45":46,"_124":125,"_126":127,"_128":129,"_130":-5,"_131":132,"_133":132,"_134":135,"_136":135,"_137":135,"_138":132,"_139":132,"_56":140,"_141":142,"_143":144,"_145":30},"file",{"_66":105,"_13":18,"_69":106,"_71":24,"_107":99},"isDirectory",true,"page",0,"history",[32,33,34,35,36],"hasNext",false,"userId",{"_37":97,"_39":40,"_41":98,"_43":99,"_45":46,"_47":100,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":101,"_21":102,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":103},{"_37":90,"_39":40,"_41":91,"_43":92,"_45":46,"_47":83,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":93,"_21":94,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":95},{"_37":83,"_39":40,"_41":84,"_43":85,"_45":46,"_47":75,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":86,"_21":87,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":88},{"_37":75,"_39":40,"_41":76,"_43":77,"_45":46,"_47":38,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":78,"_21":79,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":80},{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":57,"_21":58,"_59":-5,"_60":-5,"_61":-5,"_62":-5,"_63":64},"id","0e760f48-2ff2-11f1-bb6d-42dde27851f2","branchId","0efb5874-2fed-11f1-ad2f-42dde27851f2","createdAt",["D",1775285209611],"version",20,"orgId","5f80108f-7ca4-4327-b77b-089dbe4b5a82","parentId","07986fd6-2ff2-11f1-85d0-42dde27851f2","incomingCommitId","aiChatMessageId","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle","source","clientLabel","user",{"_37":72,"_45":46,"_11":12,"_73":74},{"_66":67,"_13":68,"_69":70,"_71":30},"pull","merge","revert","multiple","commits",[65],{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":57,"_21":58,"_59":-5,"_60":-5,"_61":-5},"fileId","0e73bc02-2ff2-11f1-bb6d-42dde27851f2","new-file-4427.ts","fileType","script","deleted","5d1042a9-7b0b-499d-8a72-3a8ac7a4e185","avatar","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","132c8972-2ff2-11f1-bb74-42dde27851f2",["D",1775285217525],21,{"_37":72,"_45":46,"_11":12,"_73":74},{"_66":67,"_13":82,"_69":70,"_71":30},[81],{"_37":75,"_39":40,"_41":76,"_43":77,"_45":46,"_47":38,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":78,"_21":79,"_59":-5,"_60":-5,"_61":-5},"spec.md","1330b682-2ff2-11f1-bb74-42dde27851f2",["D",1775285217555],22,{"_37":72,"_45":46,"_11":12,"_73":74},{"_66":67,"_13":82,"_69":21,"_71":30},[89],{"_37":83,"_39":40,"_41":84,"_43":85,"_45":46,"_47":75,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":86,"_21":87,"_59":-5,"_60":-5,"_61":-5},"1ca16068-2ff2-11f1-8fc0-42dde27851f2",["D",1775285233385],23,{"_37":72,"_45":46,"_11":12,"_73":74},{"_66":67,"_13":82,"_69":21,"_71":30},[96],{"_37":90,"_39":40,"_41":91,"_43":92,"_45":46,"_47":83,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":93,"_21":94,"_59":-5,"_60":-5,"_61":-5},"bd89a4da-3048-11f1-aeb4-42dde27851f2",["D",1775322440068],39,"4c92b776-3048-11f1-92b2-42dde27851f2",{"_37":72,"_45":46,"_11":12,"_73":74},{"_66":67,"_13":82,"_69":21,"_71":24},[104],{"_37":97,"_39":40,"_41":98,"_43":99,"_45":46,"_47":100,"_49":-5,"_50":-5,"_51":-5,"_52":-5,"_53":-5,"_54":-5,"_55":-5,"_56":101,"_21":102,"_59":-5,"_60":-5,"_61":-5},"06992c10-2ff2-11f1-832b-42dde27851f2","directory","deletedAtVersion","0efaa3f2-2fed-11f1-ad2f-42dde27851f2",["D",1775283063025],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","A virtual filesystem for AI agents, backed by SQLite.","imageUrl","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",1,"tursoName","0efaa3f22fed11f1ad2f42dde27851f2","tursoHostname","0efaa3f22fed11f1ad2f42dde27851f2-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789470042795],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm",{"_11":12,"_159":74},"org",{"_11":12,"_155":-5,"_73":74,"_31":72,"_156":157,"_158":30},"branch",{"_43":146,"_13":16,"_37":40,"_147":108,"_148":-5,"_149":-5,"_150":-5,"_151":-5,"_152":-5,"_153":14,"_154":12},"isOwned",55,"projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","tier","pro","canRestrictVals","profileImageUrl","adoptOrgId",{"_37":108,"_13":14,"_41":304,"_110":-5,"_111":30,"_112":113,"_114":113,"_115":116,"_117":-5,"_31":72,"_118":-5,"_119":30,"_120":-5,"_121":-5,"_122":123,"_45":46,"_124":125,"_126":127,"_128":305,"_130":-5,"_131":132,"_133":132,"_134":135,"_136":135,"_137":135,"_138":132,"_139":132,"_56":306,"_141":307,"_143":308,"_145":30},"tree",[267,268,269,270,271,272,273,274,275],"files",[267,268,269,270,271,272,273,274,275],"counts",{"_257":26,"_258":123,"_259":26,"_260":261,"_262":263},"contents",[180,181,182,183,184,185,186,187,188],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_37":250,"_13":251,"_66":252,"_47":-5,"_39":40,"_192":253,"_194":24,"_41":254,"_43":212,"_69":21,"_196":255,"_71":30,"_198":-5,"_17":256},{"_37":244,"_13":245,"_66":246,"_47":-5,"_39":40,"_192":233,"_194":24,"_41":247,"_43":123,"_69":21,"_196":248,"_71":30,"_198":-5,"_17":249},{"_37":237,"_13":238,"_66":239,"_47":-5,"_39":40,"_192":240,"_194":24,"_41":241,"_43":26,"_69":21,"_196":242,"_71":30,"_198":-5,"_17":243},{"_37":229,"_13":230,"_66":231,"_47":-5,"_39":40,"_192":146,"_194":24,"_41":232,"_43":233,"_69":234,"_196":235,"_71":30,"_198":-5,"_17":236},{"_37":222,"_13":223,"_66":224,"_47":-5,"_39":40,"_192":225,"_194":24,"_41":226,"_43":26,"_69":21,"_196":227,"_71":30,"_198":-5,"_17":228},{"_37":215,"_13":216,"_66":217,"_47":-5,"_39":40,"_192":218,"_194":24,"_41":219,"_43":26,"_69":21,"_196":220,"_71":30,"_198":-5,"_17":221},{"_37":207,"_13":208,"_66":209,"_47":-5,"_39":40,"_192":210,"_194":24,"_41":211,"_43":212,"_69":70,"_196":213,"_71":30,"_198":-5,"_17":214},{"_37":200,"_13":201,"_66":202,"_47":-5,"_39":40,"_192":203,"_194":24,"_41":204,"_43":26,"_69":21,"_196":205,"_71":30,"_198":-5,"_17":206},{"_37":189,"_13":190,"_66":191,"_47":-5,"_39":40,"_192":193,"_194":24,"_41":195,"_43":26,"_69":21,"_196":197,"_71":30,"_198":-5,"_17":199},"19f9a47c-2fef-11f1-8163-42dde27851f2","types.ts","19f9a54e-2fef-11f1-8163-42dde27851f2","branchVersion",6,"latest",["D",1775283940460],"content","/**\n * AgentFS type definitions — mirrors the v0.4 spec.\n */\n\n// ─── Tool Calls ──────────────────────────────────────────────────────\n\nexport interface ToolCall {\n id: number;\n name: string;\n parameters: string | null;\n result: string | null;\n error: string | null;\n started_at: number;\n completed_at: number;\n duration_ms: number;\n}\n\nexport interface ToolPerformance {\n name: string;\n total_calls: number;\n successful: number;\n failed: number;\n avg_duration_ms: number;\n}\n\n// ─── Virtual Filesystem ──────────────────────────────────────────────\n\n/** Unix mode constants */\nexport const S_IFMT = 0o170000;\nexport const S_IFREG = 0o100000;\nexport const S_IFDIR = 0o040000;\nexport const S_IFLNK = 0o120000;\nexport const S_IFIFO = 0o010000;\nexport const S_IFCHR = 0o020000;\nexport const S_IFBLK = 0o060000;\nexport const S_IFSOCK = 0o140000;\n\n/** Default modes */\nexport const DEFAULT_FILE_MODE = 0o100644; // rw-r--r--\nexport const DEFAULT_DIR_MODE = 0o040755; // rwxr-xr-x\n\n/** Root inode number */\nexport const ROOT_INO = 1;\n\n/** Default chunk size in bytes */\nexport const DEFAULT_CHUNK_SIZE = 4096;\n\nexport interface Inode {\n ino: number;\n mode: number;\n nlink: number;\n uid: number;\n gid: number;\n size: number;\n atime: number;\n mtime: number;\n ctime: number;\n rdev: number;\n atime_nsec: number;\n mtime_nsec: number;\n ctime_nsec: number;\n}\n\nexport interface DirEntry {\n id: number;\n name: string;\n parent_ino: number;\n ino: number;\n}\n\nexport interface StatResult {\n ino: number;\n mode: number;\n nlink: number;\n uid: number;\n gid: number;\n size: number;\n atime: number;\n mtime: number;\n ctime: number;\n rdev: number;\n atime_nsec: number;\n mtime_nsec: number;\n ctime_nsec: number;\n}\n\n// ─── Key-Value Store ─────────────────────────────────────────────────\n\nexport interface KVEntry {\n key: string;\n value: string;\n created_at: number;\n updated_at: number;\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────\n\n/** Checks whether a mode value represents a directory */\nexport function isDir(mode: number): boolean {\n return (mode & S_IFMT) === S_IFDIR;\n}\n\n/** Checks whether a mode value represents a regular file */\nexport function isFile(mode: number): boolean {\n return (mode & S_IFMT) === S_IFREG;\n}\n\n/** Checks whether a mode value represents a symlink */\nexport function isSymlink(mode: number): boolean {\n return (mode & S_IFMT) === S_IFLNK;\n}\n","label",[190],"4b76572a-2fef-11f1-8c6e-42dde27851f2","tool-calls.ts","4b7657c0-2fef-11f1-8c6e-42dde27851f2",9,["D",1775284023483],"/**\n * AgentFS Tool Call Audit Log\n *\n * Insert-only audit trail for tool invocations.\n * Records are never updated or deleted.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport type { ToolCall, ToolPerformance } from \"./types.ts\";\n\n/**\n * Record a completed tool call.\n *\n * Provide either `result` (on success) or `error` (on failure), not both.\n * Timestamps are Unix epoch seconds; duration is computed automatically.\n */\nexport async function record(opts: {\n name: string;\n parameters?: unknown;\n result?: unknown;\n error?: string;\n started_at: number;\n completed_at: number;\n}): Promise {\n const duration_ms = Math.round((opts.completed_at - opts.started_at) * 1000);\n const res = await sqlite.execute({\n sql: `INSERT INTO tool_calls (name, parameters, result, error, started_at, completed_at, duration_ms)\n VALUES (?, ?, ?, ?, ?, ?, ?)`,\n args: [\n opts.name,\n opts.parameters != null ? JSON.stringify(opts.parameters) : null,\n opts.result != null ? JSON.stringify(opts.result) : null,\n opts.error ?? null,\n opts.started_at,\n opts.completed_at,\n duration_ms,\n ],\n });\n return Number(res.lastInsertRowid ?? 0);\n}\n\n/**\n * Convenience wrapper: execute a function and automatically record\n * the tool call with timing, result, and error capture.\n */\nexport async function trace(\n name: string,\n parameters: unknown,\n fn: () => Promise,\n): Promise {\n const started_at = Date.now() / 1000;\n try {\n const result = await fn();\n const completed_at = Date.now() / 1000;\n await record({ name, parameters, result, started_at, completed_at });\n return result;\n } catch (err) {\n const completed_at = Date.now() / 1000;\n const error = err instanceof Error ? err.message : String(err);\n await record({ name, parameters, error, started_at, completed_at });\n throw err;\n }\n}\n\n/** Get a single tool call by ID. */\nexport async function get(id: number): Promise {\n const res = await sqlite.execute({\n sql: `SELECT * FROM tool_calls WHERE id = ?`,\n args: [id],\n });\n return (res.rows[0] as unknown as ToolCall) ?? undefined;\n}\n\n/** Query tool calls by name, most recent first. */\nexport async function queryByName(\n name: string,\n limit = 100,\n): Promise {\n const res = await sqlite.execute({\n sql: `SELECT * FROM tool_calls WHERE name = ? ORDER BY started_at DESC LIMIT ?`,\n args: [name, limit],\n });\n return res.rows as unknown as ToolCall[];\n}\n\n/** Query tool calls after a given timestamp, most recent first. */\nexport async function queryRecent(\n since: number,\n limit = 100,\n): Promise {\n const res = await sqlite.execute({\n sql: `SELECT * FROM tool_calls WHERE started_at > ? ORDER BY started_at DESC LIMIT ?`,\n args: [since, limit],\n });\n return res.rows as unknown as ToolCall[];\n}\n\n/** Aggregate performance stats grouped by tool name. */\nexport async function analyzePerformance(): Promise {\n const res = await sqlite.execute({\n sql: `SELECT\n name,\n COUNT(*) as total_calls,\n SUM(CASE WHEN error IS NULL THEN 1 ELSE 0 END) as successful,\n SUM(CASE WHEN error IS NOT NULL THEN 1 ELSE 0 END) as failed,\n AVG(duration_ms) as avg_duration_ms\n FROM tool_calls\n GROUP BY name\n ORDER BY total_calls DESC`,\n args: [],\n });\n return res.rows as unknown as ToolPerformance[];\n}\n",[201],"ed5ab19a-3048-11f1-89d5-42dde27851f2","test.ts","3aba72b2-2ff0-11f1-b843-42dde27851f2",41,["D",1775322520301],4,"/**\n * Quick smoke test — run as a script to verify AgentFS works.\n */\n\nimport { fs, init, isFile, kv, tools } from \"./mod.ts\";\n\n// Initialize\nawait init();\nconsole.log(\"init: OK\");\n\n// KV\nawait kv.set(\"test:x\", { a: 1 });\nconst val = await kv.get(\"test:x\");\nconsole.log(\"kv.set/get:\", JSON.stringify(val));\nawait kv.del(\"test:x\");\nconsole.log(\"kv.del: OK\");\n\n// Tool calls\nconst t = Date.now() / 1000;\nconst id = await tools.record({\n name: \"test_tool\",\n parameters: { q: \"hello\" },\n result: { ok: true },\n started_at: t,\n completed_at: t + 0.1,\n});\nconst tc = await tools.get(id);\nconsole.log(\"tools.record/get:\", tc?.name, tc?.duration_ms + \"ms\");\n\n// Filesystem\nawait fs.writeFile(\"/test.txt\", \"hello world\");\nconst content = await fs.readFile(\"/test.txt\", \"utf-8\");\nconsole.log(\"fs.writeFile/readFile:\", content);\n\nconst st = await fs.stat(\"/test.txt\");\nconsole.log(\"fs.stat: size=\" + st.size, \"isFile=\" + isFile(st.mode));\n\nawait fs.writeFile(\"/sub/dir/deep.txt\", \"nested\");\nconst dirs = await fs.readdir(\"/\");\nconsole.log(\"readdir /:\", dirs);\n\nconst subDirs = await fs.readdir(\"/sub\");\nconsole.log(\"readdir /sub:\", subDirs);\n\n// Cleanup\nawait fs.deleteFile(\"/test.txt\");\nawait fs.deleteFile(\"/sub/dir/deep.txt\");\nawait fs.rmdir(\"/sub/dir\");\nawait fs.rmdir(\"/sub\");\nconsole.log(\"cleanup: OK\");\n\nconsole.log(\"\\nAll tests passed.\");",[208],"256f77dc-2fef-11f1-acbc-42dde27851f2","schema.ts","256f78a4-2fef-11f1-acbc-42dde27851f2",7,["D",1775283959685],"/**\n * AgentFS schema definitions and initialization.\n *\n * All DDL is idempotent (CREATE TABLE IF NOT EXISTS / CREATE INDEX IF NOT EXISTS)\n * so init() can be called safely on every startup.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { DEFAULT_CHUNK_SIZE, DEFAULT_DIR_MODE, ROOT_INO } from \"./types.ts\";\n\n// ─── DDL Statements ──────────────────────────────────────────────────\n\nconst TOOL_CALLS_DDL = `\nCREATE TABLE IF NOT EXISTS tool_calls (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n parameters TEXT,\n result TEXT,\n error TEXT,\n started_at INTEGER NOT NULL,\n completed_at INTEGER NOT NULL,\n duration_ms INTEGER NOT NULL\n)`;\n\nconst TOOL_CALLS_INDEXES = [\n `CREATE INDEX IF NOT EXISTS idx_tool_calls_name ON tool_calls(name)`,\n `CREATE INDEX IF NOT EXISTS idx_tool_calls_started_at ON tool_calls(started_at)`,\n];\n\nconst FS_CONFIG_DDL = `\nCREATE TABLE IF NOT EXISTS fs_config (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL\n)`;\n\nconst FS_INODE_DDL = `\nCREATE TABLE IF NOT EXISTS fs_inode (\n ino INTEGER PRIMARY KEY AUTOINCREMENT,\n mode INTEGER NOT NULL,\n nlink INTEGER NOT NULL DEFAULT 0,\n uid INTEGER NOT NULL DEFAULT 0,\n gid INTEGER NOT NULL DEFAULT 0,\n size INTEGER NOT NULL DEFAULT 0,\n atime INTEGER NOT NULL,\n mtime INTEGER NOT NULL,\n ctime INTEGER NOT NULL,\n rdev INTEGER NOT NULL DEFAULT 0,\n atime_nsec INTEGER NOT NULL DEFAULT 0,\n mtime_nsec INTEGER NOT NULL DEFAULT 0,\n ctime_nsec INTEGER NOT NULL DEFAULT 0\n)`;\n\nconst FS_DENTRY_DDL = `\nCREATE TABLE IF NOT EXISTS fs_dentry (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL,\n parent_ino INTEGER NOT NULL,\n ino INTEGER NOT NULL,\n UNIQUE(parent_ino, name)\n)`;\n\nconst FS_DENTRY_INDEXES = [\n `CREATE INDEX IF NOT EXISTS idx_fs_dentry_parent ON fs_dentry(parent_ino, name)`,\n];\n\nconst FS_DATA_DDL = `\nCREATE TABLE IF NOT EXISTS fs_data (\n ino INTEGER NOT NULL,\n chunk_index INTEGER NOT NULL,\n data BLOB NOT NULL,\n PRIMARY KEY (ino, chunk_index)\n)`;\n\nconst FS_SYMLINK_DDL = `\nCREATE TABLE IF NOT EXISTS fs_symlink (\n ino INTEGER PRIMARY KEY,\n target TEXT NOT NULL\n)`;\n\nconst KV_STORE_DDL = `\nCREATE TABLE IF NOT EXISTS kv_store (\n key TEXT PRIMARY KEY,\n value TEXT NOT NULL,\n created_at INTEGER DEFAULT (unixepoch()),\n updated_at INTEGER DEFAULT (unixepoch())\n)`;\n\nconst KV_STORE_INDEXES = [\n `CREATE INDEX IF NOT EXISTS idx_kv_store_created_at ON kv_store(created_at)`,\n];\n\n// ─── Initialization ──────────────────────────────────────────────────\n\n/**\n * Initialize all AgentFS tables and seed required data.\n *\n * Safe to call multiple times — uses IF NOT EXISTS throughout and\n * only inserts seed data when it's absent.\n */\nexport async function init(): Promise {\n // Create all tables\n await sqlite.batch([\n { sql: TOOL_CALLS_DDL, args: [] },\n ...TOOL_CALLS_INDEXES.map((sql) => ({ sql, args: [] as any[] })),\n { sql: FS_CONFIG_DDL, args: [] },\n { sql: FS_INODE_DDL, args: [] },\n { sql: FS_DENTRY_DDL, args: [] },\n ...FS_DENTRY_INDEXES.map((sql) => ({ sql, args: [] as any[] })),\n { sql: FS_DATA_DDL, args: [] },\n { sql: FS_SYMLINK_DDL, args: [] },\n { sql: KV_STORE_DDL, args: [] },\n ...KV_STORE_INDEXES.map((sql) => ({ sql, args: [] as any[] })),\n ]);\n\n // Seed fs_config (chunk_size) if not present\n await sqlite.execute({\n sql: `INSERT OR IGNORE INTO fs_config (key, value) VALUES ('chunk_size', ?)`,\n args: [String(DEFAULT_CHUNK_SIZE)],\n });\n\n // Seed root directory inode if not present\n const root = await sqlite.execute({\n sql: `SELECT ino FROM fs_inode WHERE ino = ?`,\n args: [ROOT_INO],\n });\n\n if (root.rows.length === 0) {\n const now = Math.floor(Date.now() / 1000);\n await sqlite.execute({\n sql: `INSERT INTO fs_inode (ino, mode, nlink, uid, gid, size, atime, mtime, ctime)\n VALUES (?, ?, 1, 0, 0, 0, ?, ?, ?)`,\n args: [ROOT_INO, DEFAULT_DIR_MODE, now, now, now],\n });\n }\n}\n",[216],"7ad46fac-2fef-11f1-a11c-42dde27851f2","mod.ts","7ad4706a-2fef-11f1-a11c-42dde27851f2",11,["D",1775284102955],"/**\n * AgentFS — A virtual filesystem for AI agents.\n *\n * Implements the Agent Filesystem Specification v0.4 using Val Town SQLite.\n * https://www.agentfs.ai/\n *\n * Usage:\n * import { init, kv, tools, fs } from \"https://esm.town/v/nbbaier/agentfs/mod.ts\";\n *\n * await init();\n * await kv.set(\"greeting\", \"hello\");\n * await fs.writeFile(\"/notes.md\", \"# My Notes\");\n */\n\nexport { init } from \"./schema.ts\";\n\n// Re-export modules as namespaces\nexport * as kv from \"./kv.ts\";\nexport * as tools from \"./tool-calls.ts\";\nexport * as fs from \"./fs.ts\";\n\n// Re-export types\nexport type {\n DirEntry,\n Inode,\n KVEntry,\n StatResult,\n ToolCall,\n ToolPerformance,\n} from \"./types.ts\";\n\nexport {\n DEFAULT_CHUNK_SIZE,\n DEFAULT_DIR_MODE,\n DEFAULT_FILE_MODE,\n isDir,\n isFile,\n isSymlink,\n ROOT_INO,\n S_IFBLK,\n S_IFCHR,\n S_IFDIR,\n S_IFIFO,\n S_IFLNK,\n S_IFMT,\n S_IFREG,\n S_IFSOCK,\n} from \"./types.ts\";\n",[223],"3b0ae06e-5668-11f1-909e-ee650bb23af1","main.ts","0efdef3a-2fed-11f1-ad2f-42dde27851f2",["D",1779514109222],16,"http","/**\n * AgentFS test handler — exercises all modules against the scoped SQLite database.\n *\n * Hit the endpoint to run the test suite.\n */\n\nimport { fs, init, kv, tools } from \"./mod.ts\";\n\ntype TestResult = { name: string; ok: boolean; detail?: string };\n\nasync function runTest(\n\tname: string,\n\tfn: () => Promise,\n): Promise {\n\ttry {\n\t\tconst detail = (await fn()) ?? \"ok\";\n\t\treturn { name, ok: true, detail };\n\t} catch (err) {\n\t\tconst msg = err instanceof Error ? err.message : String(err);\n\t\treturn { name, ok: false, detail: msg };\n\t}\n}\n\nexport default async function handler(_req: Request): Promise {\n\tconst results: TestResult[] = [];\n\n\t// ── Schema init ──────────────────────────────────────────────────\n\tresults.push(\n\t\tawait runTest(\"init\", async () => {\n\t\t\tawait init();\n\t\t}),\n\t);\n\n\t// ── KV store ─────────────────────────────────────────────────────\n\tresults.push(\n\t\tawait runTest(\"kv.set + kv.get (object)\", async () => {\n\t\t\tawait kv.set(\"test:obj\", { hello: \"world\" });\n\t\t\tconst val = await kv.get<{ hello: string }>(\"test:obj\");\n\t\t\tif (val?.hello !== \"world\") {\n\t\t\t\tthrow new Error(`Expected \"world\", got ${JSON.stringify(val)}`);\n\t\t\t}\n\t\t\treturn JSON.stringify(val);\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"kv.set + kv.get (number)\", async () => {\n\t\t\tawait kv.set(\"test:num\", 42);\n\t\t\tconst val = await kv.get(\"test:num\");\n\t\t\tif (val !== 42) throw new Error(`Expected 42, got ${val}`);\n\t\t\treturn String(val);\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"kv.has\", async () => {\n\t\t\tconst yes = await kv.has(\"test:num\");\n\t\t\tconst no = await kv.has(\"test:nonexistent\");\n\t\t\tif (!yes) throw new Error(\"Expected true for existing key\");\n\t\t\tif (no) throw new Error(\"Expected false for missing key\");\n\t\t\treturn `exists=${yes}, missing=${no}`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"kv.list\", async () => {\n\t\t\tconst entries = await kv.list(\"test:\");\n\t\t\tif (entries.length < 2) {\n\t\t\t\tthrow new Error(`Expected >= 2 entries, got ${entries.length}`);\n\t\t\t}\n\t\t\treturn `${entries.length} entries`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"kv.del\", async () => {\n\t\t\tawait kv.del(\"test:obj\");\n\t\t\tawait kv.del(\"test:num\");\n\t\t\tconst val = await kv.get(\"test:obj\");\n\t\t\tif (val !== undefined) throw new Error(\"Expected undefined after delete\");\n\t\t}),\n\t);\n\n\t// ── Tool calls ───────────────────────────────────────────────────\n\tresults.push(\n\t\tawait runTest(\"tools.record\", async () => {\n\t\t\tconst now = Date.now() / 1000;\n\t\t\tconst id = await tools.record({\n\t\t\t\tname: \"test_tool\",\n\t\t\t\tparameters: { query: \"hello\" },\n\t\t\t\tresult: { answer: 42 },\n\t\t\t\tstarted_at: now,\n\t\t\t\tcompleted_at: now + 0.150,\n\t\t\t});\n\t\t\tif (!id || id <= 0) throw new Error(`Expected positive id, got ${id}`);\n\t\t\treturn `id=${id}`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"tools.trace\", async () => {\n\t\t\tconst result = await tools.trace(\n\t\t\t\t\"traced_tool\",\n\t\t\t\t{ input: \"x\" },\n\t\t\t\tasync () => {\n\t\t\t\t\tawait new Promise((r) => setTimeout(r, 10));\n\t\t\t\t\treturn \"done\";\n\t\t\t\t},\n\t\t\t);\n\t\t\tif (result !== \"done\") throw new Error(`Expected \"done\", got ${result}`);\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"tools.queryByName\", async () => {\n\t\t\tconst calls = await tools.queryByName(\"test_tool\");\n\t\t\tif (calls.length === 0) throw new Error(\"Expected at least 1 call\");\n\t\t\treturn `${calls.length} call(s)`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"tools.analyzePerformance\", async () => {\n\t\t\tconst perf = await tools.analyzePerformance();\n\t\t\tif (perf.length === 0) throw new Error(\"Expected performance data\");\n\t\t\treturn perf.map((p) => `${p.name}: ${p.total_calls} calls`).join(\", \");\n\t\t}),\n\t);\n\n\t// ── Filesystem ───────────────────────────────────────────────────\n\tresults.push(\n\t\tawait runTest(\"fs.writeFile + fs.readFile (string)\", async () => {\n\t\t\tawait fs.writeFile(\"/test.txt\", \"hello agentfs\");\n\t\t\tconst content = await fs.readFile(\"/test.txt\", \"utf-8\");\n\t\t\tif (content !== \"hello agentfs\") {\n\t\t\t\tthrow new Error(`Expected \"hello agentfs\", got \"${content}\"`);\n\t\t\t}\n\t\t\treturn `\"${content}\"`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.writeFile (auto-mkdir)\", async () => {\n\t\t\tawait fs.writeFile(\"/deep/nested/dir/file.md\", \"# Nested\");\n\t\t\tconst content = await fs.readFile(\"/deep/nested/dir/file.md\", \"utf-8\");\n\t\t\tif (!content.startsWith(\"# Nested\")) throw new Error(\"Content mismatch\");\n\t\t\treturn `\"${content}\"`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.writeFile (overwrite)\", async () => {\n\t\t\tawait fs.writeFile(\"/test.txt\", \"version 1\");\n\t\t\tawait fs.writeFile(\"/test.txt\", \"version 2\");\n\t\t\tconst content = await fs.readFile(\"/test.txt\", \"utf-8\");\n\t\t\tif (content !== \"version 2\") {\n\t\t\t\tthrow new Error(`Expected \"version 2\", got \"${content}\"`);\n\t\t\t}\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.exists\", async () => {\n\t\t\tconst yes = await fs.exists(\"/test.txt\");\n\t\t\tconst no = await fs.exists(\"/nonexistent.txt\");\n\t\t\tif (!yes) throw new Error(\"Expected true for existing file\");\n\t\t\tif (no) throw new Error(\"Expected false for missing file\");\n\t\t\treturn `exists=${yes}, missing=${no}`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.stat\", async () => {\n\t\t\tconst st = await fs.stat(\"/test.txt\");\n\t\t\tif (!st.ino || st.size <= 0) {\n\t\t\t\tthrow new Error(`Bad stat: ${JSON.stringify(st)}`);\n\t\t\t}\n\t\t\treturn `ino=${st.ino}, size=${st.size}, mode=${st.mode.toString(8)}`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.readdir\", async () => {\n\t\t\tconst entries = await fs.readdir(\"/\");\n\t\t\tif (!entries.includes(\"test.txt\")) {\n\t\t\t\tthrow new Error(\"Missing test.txt in readdir\");\n\t\t\t}\n\t\t\treturn entries.join(\", \");\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.mkdir + fs.readdir\", async () => {\n\t\t\tif (!(await fs.exists(\"/mydir\"))) {\n\t\t\t\tawait fs.mkdir(\"/mydir\");\n\t\t\t}\n\t\t\tawait fs.writeFile(\"/mydir/a.txt\", \"aaa\");\n\t\t\tawait fs.writeFile(\"/mydir/b.txt\", \"bbb\");\n\t\t\tconst entries = await fs.readdir(\"/mydir\");\n\t\t\tif (entries.length < 2) {\n\t\t\t\tthrow new Error(`Expected >= 2 entries, got ${entries.length}`);\n\t\t\t}\n\t\t\treturn entries.join(\", \");\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.link (hard link)\", async () => {\n\t\t\tawait fs.link(\"/test.txt\", \"/test-link.txt\");\n\t\t\tconst content = await fs.readFile(\"/test-link.txt\", \"utf-8\");\n\t\t\tif (content !== \"version 2\") {\n\t\t\t\tthrow new Error(\"Hard link content mismatch\");\n\t\t\t}\n\t\t\tconst st = await fs.stat(\"/test.txt\");\n\t\t\tif (st.nlink < 2) throw new Error(`Expected nlink >= 2, got ${st.nlink}`);\n\t\t\treturn `nlink=${st.nlink}`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.symlink + fs.readlink\", async () => {\n\t\t\tif (await fs.exists(\"/test-sym.txt\")) {\n\t\t\t\tawait fs.deleteFile(\"/test-sym.txt\");\n\t\t\t}\n\t\t\tawait fs.symlink(\"/test.txt\", \"/test-sym.txt\");\n\t\t\tconst target = await fs.readlink(\"/test-sym.txt\");\n\t\t\tif (target !== \"/test.txt\") {\n\t\t\t\tthrow new Error(`Expected \"/test.txt\", got \"${target}\"`);\n\t\t\t}\n\t\t\treturn `target=\"${target}\"`;\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.rename\", async () => {\n\t\t\tawait fs.writeFile(\"/rename-me.txt\", \"moving\");\n\t\t\tawait fs.rename(\"/rename-me.txt\", \"/renamed.txt\");\n\t\t\tconst gone = await fs.exists(\"/rename-me.txt\");\n\t\t\tconst there = await fs.exists(\"/renamed.txt\");\n\t\t\tif (gone) throw new Error(\"Old path still exists\");\n\t\t\tif (!there) throw new Error(\"New path doesn't exist\");\n\t\t\tconst content = await fs.readFile(\"/renamed.txt\", \"utf-8\");\n\t\t\tif (content !== \"moving\") throw new Error(\"Content lost during rename\");\n\t\t}),\n\t);\n\n\tresults.push(\n\t\tawait runTest(\"fs.readFileAt (partial read)\", async () => {\n\t\t\tawait fs.writeFile(\"/partial.txt\", \"abcdefghijklmnop\");\n\t\t\tconst chunk = await fs.readFileAt(\"/partial.txt\", 4, 4);\n\t\t\tconst text = new TextDecoder().decode(chunk);\n\t\t\tif (text !== \"efgh\") throw new Error(`Expected \"efgh\", got \"${text}\"`);\n\t\t\treturn `\"${text}\"`;\n\t\t}),\n\t);\n\n\t// ── Cleanup ──────────────────────────────────────────────────────\n\tresults.push(\n\t\tawait runTest(\"cleanup\", async () => {\n\t\t\tfor (\n\t\t\t\tconst p of [\n\t\t\t\t\t\"/test.txt\",\n\t\t\t\t\t\"/test-link.txt\",\n\t\t\t\t\t\"/test-sym.txt\",\n\t\t\t\t\t\"/renamed.txt\",\n\t\t\t\t\t\"/partial.txt\",\n\t\t\t\t]\n\t\t\t) {\n\t\t\t\tif (await fs.exists(p)) await fs.deleteFile(p);\n\t\t\t}\n\t\t\tfor (const p of [\"/mydir/a.txt\", \"/mydir/b.txt\"]) {\n\t\t\t\tif (await fs.exists(p)) await fs.deleteFile(p);\n\t\t\t}\n\t\t\tif (await fs.exists(\"/mydir\")) await fs.rmdir(\"/mydir\");\n\t\t\tfor (const p of [\"/deep/nested/dir/file.md\"]) {\n\t\t\t\tif (await fs.exists(p)) await fs.deleteFile(p);\n\t\t\t}\n\t\t\t// Clean nested dirs\n\t\t\tfor (const d of [\"/deep/nested/dir\", \"/deep/nested\", \"/deep\"]) {\n\t\t\t\tif (await fs.exists(d)) await fs.rmdir(d);\n\t\t\t}\n\t\t}),\n\t);\n\n\t// ── Format output ────────────────────────────────────────────────\n\tconst passed = results.filter((r) => r.ok).length;\n\tconst failed = results.filter((r) => !r.ok).length;\n\n\tconst lines = results.map((r) => {\n\t\tconst icon = r.ok ? \"PASS\" : \"FAIL\";\n\t\treturn `[${icon}] ${r.name}${r.detail ? ` — ${r.detail}` : \"\"}`;\n\t});\n\n\tlines.push(\"\");\n\tlines.push(`${passed} passed, ${failed} failed, ${results.length} total`);\n\n\treturn new Response(lines.join(\"\\n\"), {\n\t\tstatus: failed > 0 ? 500 : 200,\n\t\theaders: { \"content-type\": \"text/plain; charset=utf-8\" },\n\t});\n}",[230],"2d9c2c3e-2fef-11f1-8aaf-42dde27851f2","kv.ts","2d9c2cfc-2fef-11f1-8aaf-42dde27851f2",8,["D",1775283973401],"/**\n * AgentFS Key-Value Store\n *\n * Simple get/set/delete/list for agent context and structured state.\n * Values are JSON-serialized on write and deserialized on read.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport type { KVEntry } from \"./types.ts\";\n\n/**\n * Set a key-value pair. Upserts — creates if new, updates if existing.\n * The value is JSON-serialized before storage.\n */\nexport async function set(key: string, value: unknown): Promise {\n const serialized = JSON.stringify(value);\n await sqlite.execute({\n sql: `INSERT INTO kv_store (key, value, updated_at)\n VALUES (?, ?, unixepoch())\n ON CONFLICT(key) DO UPDATE SET\n value = excluded.value,\n updated_at = unixepoch()`,\n args: [key, serialized],\n });\n}\n\n/**\n * Get a value by key. Returns the deserialized value, or undefined if not found.\n */\nexport async function get(key: string): Promise {\n const result = await sqlite.execute({\n sql: `SELECT value FROM kv_store WHERE key = ?`,\n args: [key],\n });\n if (result.rows.length === 0) return undefined;\n return JSON.parse(result.rows[0].value as string) as T;\n}\n\n/**\n * Delete a key-value pair. No-op if the key doesn't exist.\n */\nexport async function del(key: string): Promise {\n await sqlite.execute({\n sql: `DELETE FROM kv_store WHERE key = ?`,\n args: [key],\n });\n}\n\n/**\n * Check if a key exists.\n */\nexport async function has(key: string): Promise {\n const result = await sqlite.execute({\n sql: `SELECT 1 FROM kv_store WHERE key = ?`,\n args: [key],\n });\n return result.rows.length > 0;\n}\n\n/**\n * List all keys, optionally filtered by prefix.\n * Returns metadata (key, timestamps) without values for efficiency.\n */\nexport async function list(\n prefix?: string,\n): Promise> {\n if (prefix) {\n const result = await sqlite.execute({\n sql: `SELECT key, created_at, updated_at FROM kv_store\n WHERE key LIKE ? ORDER BY key ASC`,\n args: [prefix + \"%\"],\n });\n return result.rows as Array<{\n key: string;\n created_at: number;\n updated_at: number;\n }>;\n }\n\n const result = await sqlite.execute({\n sql: `SELECT key, created_at, updated_at FROM kv_store ORDER BY key ASC`,\n args: [],\n });\n return result.rows as Array<{\n key: string;\n created_at: number;\n updated_at: number;\n }>;\n}\n\n/**\n * Get the full KV entry including metadata.\n */\nexport async function getEntry(key: string): Promise {\n const result = await sqlite.execute({\n sql: `SELECT key, value, created_at, updated_at FROM kv_store WHERE key = ?`,\n args: [key],\n });\n if (result.rows.length === 0) return undefined;\n return result.rows[0] as unknown as KVEntry;\n}\n",[238],"ffb84396-2ff0-11f1-8cb7-42dde27851f2","fs.ts","74970d2a-2fef-11f1-b8d6-42dde27851f2",["D",1775284755396],"/**\n * AgentFS Virtual Filesystem\n *\n * POSIX-like file operations backed by Val Town SQLite.\n * Uses an inode-based design with chunked content storage.\n */\n\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport {\n DEFAULT_DIR_MODE,\n DEFAULT_FILE_MODE,\n isDir,\n ROOT_INO,\n S_IFDIR,\n S_IFLNK,\n S_IFMT,\n} from \"./types.ts\";\nimport type { Inode, StatResult } from \"./types.ts\";\n\n// ─── Internal helpers ────────────────────────────────────────────────\n\nfunction now(): number {\n return Math.floor(Date.now() / 1000);\n}\n\n/** Split a path into components, filtering empties. */\nfunction splitPath(path: string): string[] {\n return path.split(\"/\").filter((c) => c.length > 0);\n}\n\n/** Get parent path and basename from a full path. */\nfunction parsePath(path: string): { parent: string; name: string } {\n const components = splitPath(path);\n if (components.length === 0) {\n throw new Error(\"Cannot parse root path\");\n }\n const name = components.pop()!;\n const parent = \"/\" + components.join(\"/\");\n return { parent, name };\n}\n\n/** Retrieve the configured chunk size. */\nasync function getChunkSize(): Promise {\n const res = await sqlite.execute({\n sql: `SELECT value FROM fs_config WHERE key = 'chunk_size'`,\n args: [],\n });\n if (res.rows.length === 0) throw new Error(\"fs_config missing chunk_size\");\n return Number((res.rows[0] as any).value);\n}\n\n/**\n * Normalize blob data from SQLite into a Uint8Array.\n *\n * Val Town's scoped SQLite (Turso) returns BLOB columns as ArrayBuffer.\n * This helper handles that plus other potential representations.\n */\nfunction toBytes(d: unknown): Uint8Array {\n if (d instanceof Uint8Array) return d;\n if (d instanceof ArrayBuffer) return new Uint8Array(d);\n if (ArrayBuffer.isView(d)) return new Uint8Array(d.buffer, d.byteOffset, d.byteLength);\n if (typeof d === \"string\") return new TextEncoder().encode(d);\n return new Uint8Array(0);\n}\n\n/** Concatenate an array of Uint8Arrays into a single Uint8Array. */\nfunction concatBytes(chunks: Uint8Array[]): Uint8Array {\n const totalLen = chunks.reduce((sum, c) => sum + c.length, 0);\n const combined = new Uint8Array(totalLen);\n let offset = 0;\n for (const chunk of chunks) {\n combined.set(chunk, offset);\n offset += chunk.length;\n }\n return combined;\n}\n\n// ─── Path Resolution ─────────────────────────────────────────────────\n\n/**\n * Resolve an absolute path to its inode number.\n * Returns undefined if any component along the path doesn't exist.\n */\nexport async function resolve(path: string): Promise {\n const components = splitPath(path);\n if (components.length === 0) return ROOT_INO;\n\n let currentIno = ROOT_INO;\n for (const name of components) {\n const res = await sqlite.execute({\n sql: `SELECT ino FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [currentIno, name],\n });\n if (res.rows.length === 0) return undefined;\n currentIno = (res.rows[0] as any).ino as number;\n }\n return currentIno;\n}\n\n/**\n * Resolve a path, throwing if it doesn't exist.\n */\nasync function resolveOrThrow(path: string): Promise {\n const ino = await resolve(path);\n if (ino === undefined) throw new Error(`ENOENT: ${path}`);\n return ino;\n}\n\n// ─── Stat ────────────────────────────────────────────────────────────\n\n/** Get file/directory metadata. */\nexport async function stat(path: string): Promise {\n const ino = await resolveOrThrow(path);\n const res = await sqlite.execute({\n sql: `SELECT ino, mode, nlink, uid, gid, size, atime, mtime, ctime, rdev,\n atime_nsec, mtime_nsec, ctime_nsec\n FROM fs_inode WHERE ino = ?`,\n args: [ino],\n });\n if (res.rows.length === 0) throw new Error(`Inode ${ino} not found`);\n return res.rows[0] as unknown as StatResult;\n}\n\n/** Check whether a path exists. */\nexport async function exists(path: string): Promise {\n return (await resolve(path)) !== undefined;\n}\n\n// ─── Directory Operations ────────────────────────────────────────────\n\n/**\n * Create a directory. Throws if it already exists or the parent doesn't exist.\n */\nexport async function mkdir(path: string): Promise {\n const { parent, name } = parsePath(path);\n const parentIno = await resolveOrThrow(parent);\n\n const ts = now();\n const res = await sqlite.execute({\n sql: `INSERT INTO fs_inode (mode, nlink, uid, gid, size, atime, mtime, ctime)\n VALUES (?, 0, 0, 0, 0, ?, ?, ?) RETURNING ino`,\n args: [DEFAULT_DIR_MODE, ts, ts, ts],\n });\n const ino = (res.rows[0] as any).ino as number;\n\n await sqlite.execute({\n sql: `INSERT INTO fs_dentry (name, parent_ino, ino) VALUES (?, ?, ?)`,\n args: [name, parentIno, ino],\n });\n\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink + 1 WHERE ino = ?`,\n args: [ino],\n });\n\n return ino;\n}\n\n/**\n * Create a directory and all missing parents (like mkdir -p).\n */\nexport async function mkdirp(path: string): Promise {\n const components = splitPath(path);\n let currentIno = ROOT_INO;\n\n for (const name of components) {\n const res = await sqlite.execute({\n sql: `SELECT ino FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [currentIno, name],\n });\n\n if (res.rows.length > 0) {\n currentIno = (res.rows[0] as any).ino as number;\n } else {\n const ts = now();\n const newInode = await sqlite.execute({\n sql: `INSERT INTO fs_inode (mode, nlink, uid, gid, size, atime, mtime, ctime)\n VALUES (?, 0, 0, 0, 0, ?, ?, ?) RETURNING ino`,\n args: [DEFAULT_DIR_MODE, ts, ts, ts],\n });\n const newIno = (newInode.rows[0] as any).ino as number;\n\n await sqlite.execute({\n sql: `INSERT INTO fs_dentry (name, parent_ino, ino) VALUES (?, ?, ?)`,\n args: [name, currentIno, newIno],\n });\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink + 1 WHERE ino = ?`,\n args: [newIno],\n });\n\n currentIno = newIno;\n }\n }\n\n return currentIno;\n}\n\n/** List the names in a directory. */\nexport async function readdir(path: string): Promise {\n const ino = await resolveOrThrow(path);\n const res = await sqlite.execute({\n sql: `SELECT name FROM fs_dentry WHERE parent_ino = ? ORDER BY name ASC`,\n args: [ino],\n });\n return res.rows.map((r: any) => r.name as string);\n}\n\n/**\n * Remove an empty directory. Throws if not empty or not a directory.\n */\nexport async function rmdir(path: string): Promise {\n if (path === \"/\") throw new Error(\"Cannot remove root directory\");\n\n const { parent, name } = parsePath(path);\n const ino = await resolveOrThrow(path);\n\n // Check it's a directory\n const inodeRes = await sqlite.execute({\n sql: `SELECT mode FROM fs_inode WHERE ino = ?`,\n args: [ino],\n });\n if (inodeRes.rows.length === 0) throw new Error(`Inode ${ino} not found`);\n if (!isDir((inodeRes.rows[0] as any).mode as number)) {\n throw new Error(`ENOTDIR: ${path}`);\n }\n\n // Check it's empty\n const children = await sqlite.execute({\n sql: `SELECT 1 FROM fs_dentry WHERE parent_ino = ? LIMIT 1`,\n args: [ino],\n });\n if (children.rows.length > 0) throw new Error(`ENOTEMPTY: ${path}`);\n\n const parentIno = await resolveOrThrow(parent);\n\n await sqlite.execute({\n sql: `DELETE FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [parentIno, name],\n });\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink - 1 WHERE ino = ?`,\n args: [ino],\n });\n\n // If no more links, delete the inode\n const linkCheck = await sqlite.execute({\n sql: `SELECT nlink FROM fs_inode WHERE ino = ?`,\n args: [ino],\n });\n if (linkCheck.rows.length > 0 && (linkCheck.rows[0] as any).nlink <= 0) {\n await sqlite.execute({\n sql: `DELETE FROM fs_inode WHERE ino = ?`,\n args: [ino],\n });\n }\n}\n\n// ─── File Operations ─────────────────────────────────────────────────\n\n/**\n * Write a file at the given path. Creates parent directories as needed.\n * If the file already exists, its content is replaced.\n *\n * Accepts string or Uint8Array content.\n */\nexport async function writeFile(\n path: string,\n content: string | Uint8Array,\n): Promise {\n const { parent, name } = parsePath(path);\n const data =\n typeof content === \"string\" ? new TextEncoder().encode(content) : content;\n const chunkSize = await getChunkSize();\n\n // Ensure parent directories exist\n const parentIno = await mkdirp(parent);\n\n // Check if file already exists\n const existing = await sqlite.execute({\n sql: `SELECT ino FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [parentIno, name],\n });\n\n let ino: number;\n\n if (existing.rows.length > 0) {\n // Overwrite: delete old chunks, rewrite\n ino = (existing.rows[0] as any).ino as number;\n await sqlite.execute({\n sql: `DELETE FROM fs_data WHERE ino = ?`,\n args: [ino],\n });\n } else {\n // Create new inode + dentry\n const ts = now();\n const res = await sqlite.execute({\n sql: `INSERT INTO fs_inode (mode, nlink, uid, gid, size, atime, mtime, ctime)\n VALUES (?, 0, 0, 0, 0, ?, ?, ?) RETURNING ino`,\n args: [DEFAULT_FILE_MODE, ts, ts, ts],\n });\n ino = (res.rows[0] as any).ino as number;\n\n await sqlite.execute({\n sql: `INSERT INTO fs_dentry (name, parent_ino, ino) VALUES (?, ?, ?)`,\n args: [name, parentIno, ino],\n });\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink + 1 WHERE ino = ?`,\n args: [ino],\n });\n }\n\n // Write chunks\n const totalChunks = data.length === 0 ? 0 : Math.ceil(data.length / chunkSize);\n for (let i = 0; i < totalChunks; i++) {\n const start = i * chunkSize;\n const end = Math.min(start + chunkSize, data.length);\n const chunk = data.slice(start, end);\n\n await sqlite.execute({\n sql: `INSERT INTO fs_data (ino, chunk_index, data) VALUES (?, ?, ?)`,\n args: [ino, i, chunk],\n });\n }\n\n // Update size + mtime\n await sqlite.execute({\n sql: `UPDATE fs_inode SET size = ?, mtime = ? WHERE ino = ?`,\n args: [data.length, now(), ino],\n });\n\n return ino;\n}\n\n/**\n * Read an entire file. Returns a Uint8Array by default.\n * Pass encoding = \"utf-8\" to get a string.\n */\nexport async function readFile(\n path: string,\n encoding?: \"utf-8\",\n): Promise {\n const ino = await resolveOrThrow(path);\n\n const res = await sqlite.execute({\n sql: `SELECT data FROM fs_data WHERE ino = ? ORDER BY chunk_index ASC`,\n args: [ino],\n });\n\n // Update atime\n await sqlite.execute({\n sql: `UPDATE fs_inode SET atime = ? WHERE ino = ?`,\n args: [now(), ino],\n });\n\n if (res.rows.length === 0) {\n return encoding === \"utf-8\" ? \"\" : new Uint8Array(0);\n }\n\n const combined = concatBytes(res.rows.map((r: any) => toBytes(r.data)));\n\n if (encoding === \"utf-8\") {\n return new TextDecoder().decode(combined);\n }\n return combined;\n}\n\n/**\n * Read a portion of a file at a given byte offset.\n */\nexport async function readFileAt(\n path: string,\n offset: number,\n length: number,\n): Promise {\n const ino = await resolveOrThrow(path);\n const chunkSize = await getChunkSize();\n\n const startChunk = Math.floor(offset / chunkSize);\n const endChunk = Math.floor((offset + length - 1) / chunkSize);\n\n const res = await sqlite.execute({\n sql: `SELECT chunk_index, data FROM fs_data\n WHERE ino = ? AND chunk_index >= ? AND chunk_index <= ?\n ORDER BY chunk_index ASC`,\n args: [ino, startChunk, endChunk],\n });\n\n if (res.rows.length === 0) return new Uint8Array(0);\n\n const combined = concatBytes(res.rows.map((r: any) => toBytes(r.data)));\n\n // Extract the requested window\n const offsetInFirst = offset % chunkSize;\n return combined.slice(offsetInFirst, offsetInFirst + length);\n}\n\n/**\n * Delete (unlink) a file. If this is the last link, the inode and data are removed.\n */\nexport async function deleteFile(path: string): Promise {\n const { parent, name } = parsePath(path);\n const parentIno = await resolveOrThrow(parent);\n const ino = await resolveOrThrow(path);\n\n // Remove dentry\n await sqlite.execute({\n sql: `DELETE FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [parentIno, name],\n });\n\n // Decrement nlink\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink - 1 WHERE ino = ?`,\n args: [ino],\n });\n\n // If last link, clean up inode + data + symlink\n const linkCheck = await sqlite.execute({\n sql: `SELECT nlink FROM fs_inode WHERE ino = ?`,\n args: [ino],\n });\n\n if (linkCheck.rows.length > 0 && (linkCheck.rows[0] as any).nlink <= 0) {\n await sqlite.execute({ sql: `DELETE FROM fs_data WHERE ino = ?`, args: [ino] });\n await sqlite.execute({ sql: `DELETE FROM fs_symlink WHERE ino = ?`, args: [ino] });\n await sqlite.execute({ sql: `DELETE FROM fs_inode WHERE ino = ?`, args: [ino] });\n }\n}\n\n// ─── Links ───────────────────────────────────────────────────────────\n\n/**\n * Create a hard link: a new name pointing to an existing inode.\n */\nexport async function link(srcPath: string, destPath: string): Promise {\n const srcIno = await resolveOrThrow(srcPath);\n const { parent, name } = parsePath(destPath);\n const destParentIno = await resolveOrThrow(parent);\n\n await sqlite.execute({\n sql: `INSERT INTO fs_dentry (name, parent_ino, ino) VALUES (?, ?, ?)`,\n args: [name, destParentIno, srcIno],\n });\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink + 1 WHERE ino = ?`,\n args: [srcIno],\n });\n}\n\n/**\n * Create a symbolic link at `linkPath` pointing to `target`.\n */\nexport async function symlink(target: string, linkPath: string): Promise {\n const { parent, name } = parsePath(linkPath);\n const parentIno = await resolveOrThrow(parent);\n\n const ts = now();\n // Mode: symlink + 0777\n const mode = S_IFLNK | 0o777;\n const res = await sqlite.execute({\n sql: `INSERT INTO fs_inode (mode, nlink, uid, gid, size, atime, mtime, ctime)\n VALUES (?, 0, 0, 0, ?, ?, ?, ?) RETURNING ino`,\n args: [mode, target.length, ts, ts, ts],\n });\n const ino = (res.rows[0] as any).ino as number;\n\n await sqlite.execute({\n sql: `INSERT INTO fs_dentry (name, parent_ino, ino) VALUES (?, ?, ?)`,\n args: [name, parentIno, ino],\n });\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink + 1 WHERE ino = ?`,\n args: [ino],\n });\n await sqlite.execute({\n sql: `INSERT INTO fs_symlink (ino, target) VALUES (?, ?)`,\n args: [ino, target],\n });\n\n return ino;\n}\n\n/**\n * Read the target of a symbolic link.\n */\nexport async function readlink(path: string): Promise {\n const ino = await resolveOrThrow(path);\n const res = await sqlite.execute({\n sql: `SELECT target FROM fs_symlink WHERE ino = ?`,\n args: [ino],\n });\n if (res.rows.length === 0) throw new Error(`Not a symlink: ${path}`);\n return (res.rows[0] as any).target as string;\n}\n\n// ─── Rename / Move ───────────────────────────────────────────────────\n\n/**\n * Rename or move a file/directory from oldPath to newPath.\n */\nexport async function rename(oldPath: string, newPath: string): Promise {\n const { parent: oldParent, name: oldName } = parsePath(oldPath);\n const { parent: newParent, name: newName } = parsePath(newPath);\n\n const oldParentIno = await resolveOrThrow(oldParent);\n const ino = await resolveOrThrow(oldPath);\n\n // Ensure new parent exists\n const newParentIno = await mkdirp(newParent);\n\n // Remove old dentry\n await sqlite.execute({\n sql: `DELETE FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [oldParentIno, oldName],\n });\n\n // Check if destination exists and remove it\n const destExisting = await sqlite.execute({\n sql: `SELECT ino FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [newParentIno, newName],\n });\n if (destExisting.rows.length > 0) {\n const destIno = (destExisting.rows[0] as any).ino as number;\n await sqlite.execute({\n sql: `DELETE FROM fs_dentry WHERE parent_ino = ? AND name = ?`,\n args: [newParentIno, newName],\n });\n await sqlite.execute({\n sql: `UPDATE fs_inode SET nlink = nlink - 1 WHERE ino = ?`,\n args: [destIno],\n });\n }\n\n // Insert new dentry\n await sqlite.execute({\n sql: `INSERT INTO fs_dentry (name, parent_ino, ino) VALUES (?, ?, ?)`,\n args: [newName, newParentIno, ino],\n });\n\n // Update ctime\n await sqlite.execute({\n sql: `UPDATE fs_inode SET ctime = ? WHERE ino = ?`,\n args: [now(), ino],\n });\n}\n",[245],"fbe92926-3048-11f1-9931-42dde27851f2","README.md","d04421c8-2ff2-11f1-ad77-42dde27851f2",45,["D",1775322544723],"# AgentFS\n\nA virtual filesystem for AI agents, backed by SQLite. Implements the\n[Agent Filesystem Specification v0.4](https://github.com/tursodatabase/agentfs/blob/main/SPEC.md)\non Val Town.\n\nAgentFS gives agents persistent, structured storage through three primitives:\n\n- **Virtual Filesystem** — POSIX-like file operations (read, write, mkdir, link,\n symlink, rename) using a Unix inode design with chunked content storage\n- **Key-Value Store** — Simple typed get/set for agent context, preferences, and\n structured state\n- **Tool Call Audit Log** — Insert-only trail of tool invocations with timing,\n parameters, results, and performance analytics\n\n**Why use this?** - I'm not sure! Just seemed fun to implement on val town!\n\n## Quick Start\n\n```ts\nimport { fs, init, kv, tools } from \"https://esm.town/v/nbbaier/agentfs/mod.ts\";\n\n// Initialize tables (idempotent — safe to call on every run)\nawait init();\n\n// Write and read files\nawait fs.writeFile(\"/notes/today.md\", \"# Meeting Notes\\n- Ship v2\");\nconst content = await fs.readFile(\"/notes/today.md\", \"utf-8\");\n\n// Key-value store (auto JSON serialization)\nawait kv.set(\"agent:config\", { model: \"gpt-4\", temperature: 0.7 });\nconst config = await kv.get<{ model: string }>(\"agent:config\");\n\n// Tool call tracking\nconst result = await tools.trace(\n \"web_search\",\n { query: \"Val Town\" },\n async () => {\n // ... your tool implementation\n return { results: [\"...\"] };\n },\n);\n```\n\n## Architecture\n\n```mermaid\ngraph TD\n A[mod.ts] --> B[schema.ts]\n A --> C[fs.ts]\n A --> D[kv.ts]\n A --> E[tool-calls.ts]\n A --> F[types.ts]\n C --> F\n D --> F\n E --> F\n B --> F\n B --> G[(SQLite)]\n C --> G\n D --> G\n E --> G\n```\n\nAll modules import from Val Town's scoped SQLite (`std/sqlite/main.ts`) so each\nval gets its own isolated database.\n\n## API Reference\n\n### `init()`\n\nCreates all tables and seeds the root directory. Uses\n`CREATE TABLE IF NOT EXISTS` — safe to call on every startup.\n\n```ts\nawait init();\n```\n\n### Filesystem (`fs`)\n\n| Function | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------- |\n| `writeFile(path, content)` | Write a string or `Uint8Array`. Auto-creates parent dirs. Overwrites if exists. |\n| `readFile(path, encoding?)` | Read a file. Pass `\"utf-8\"` for string, omit for `Uint8Array`. |\n| `readFileAt(path, offset, length)` | Partial read at a byte offset. |\n| `exists(path)` | Check if a path exists. |\n| `stat(path)` | Get inode metadata (size, mode, timestamps, nlink). |\n| `mkdir(path)` | Create a directory. |\n| `mkdirp(path)` | Create a directory and all missing parents. |\n| `readdir(path)` | List names in a directory. |\n| `rmdir(path)` | Remove an empty directory. |\n| `deleteFile(path)` | Unlink a file. Cleans up inode/data when last link is removed. |\n| `link(src, dest)` | Create a hard link. |\n| `symlink(target, linkPath)` | Create a symbolic link. |\n| `readlink(path)` | Read a symlink's target. |\n| `rename(oldPath, newPath)` | Move/rename a file or directory. |\n| `resolve(path)` | Resolve a path to its inode number (or `undefined`). |\n\n### Key-Value Store (`kv`)\n\nValues are automatically JSON-serialized on write and deserialized on read.\n\n| Function | Description |\n| ----------------- | ----------------------------------------------------------------------- |\n| `set(key, value)` | Upsert a key-value pair. |\n| `get(key)` | Get a value (or `undefined`). |\n| `del(key)` | Delete a key. |\n| `has(key)` | Check if a key exists. |\n| `list(prefix?)` | List keys with optional prefix filter. Returns metadata without values. |\n| `getEntry(key)` | Get the full entry including `created_at` and `updated_at` timestamps. |\n\n### Tool Call Audit Log (`tools`)\n\nAn insert-only audit trail — records are never updated or deleted.\n\n| Function | Description |\n| ---------------------------- | --------------------------------------------------------------------------------- |\n| `record(opts)` | Record a completed tool call with name, parameters, result/error, and timestamps. |\n| `trace(name, params, fn)` | Execute a function and auto-record timing, result, and errors. |\n| `get(id)` | Get a tool call by ID. |\n| `queryByName(name, limit?)` | Query calls by tool name, most recent first. |\n| `queryRecent(since, limit?)` | Query calls after a Unix timestamp. |\n| `analyzePerformance()` | Aggregate stats (call count, success/fail, avg duration) by tool name. |\n\n### Types & Constants\n\n```ts\nimport {\n DEFAULT_CHUNK_SIZE, // 4096\n DEFAULT_DIR_MODE, // 0o040755\n DEFAULT_FILE_MODE, // 0o100644\n type DirEntry,\n // Types\n type Inode,\n isDir,\n // Mode helpers\n isFile,\n isSymlink,\n type KVEntry,\n // Constants\n ROOT_INO, // 1\n S_IFBLK,\n S_IFCHR,\n S_IFDIR,\n S_IFIFO,\n S_IFLNK,\n S_IFMT,\n S_IFREG,\n S_IFSOCK,\n type StatResult,\n type ToolCall,\n type ToolPerformance,\n} from \"https://esm.town/v/nbbaier/agentfs/mod.ts\";\n```\n\n## Files\n\n| File | Purpose |\n| --------------- | ---------------------------------------------------------- |\n| `mod.ts` | Public entry point — re-exports all modules |\n| `schema.ts` | DDL definitions and `init()` |\n| `fs.ts` | Virtual filesystem operations |\n| `kv.ts` | Key-value store operations |\n| `tool-calls.ts` | Tool call audit log operations |\n| `types.ts` | Type definitions and constants |\n| `main.ts` | HTTP test handler — hit the endpoint to run the test suite |\n| `test.ts` | Quick smoke test script |\n| `docs/spec.md` | Full Agent Filesystem Specification v0.4 |",[251],"pulls","branches","forks","envVars",{"_264":26,"_266":26},"connections",{"_264":26,"_265":26},"count","unfilledCount","emptyCount",{"_37":250,"_13":251,"_66":252,"_47":-5,"_39":40,"_192":253,"_194":24,"_41":301,"_43":212,"_69":21,"_196":255,"_71":30,"_198":-5,"_277":302,"_17":303},{"_37":244,"_13":245,"_66":246,"_47":-5,"_39":40,"_192":233,"_194":24,"_41":298,"_43":123,"_69":21,"_196":248,"_71":30,"_198":-5,"_277":299,"_17":300},{"_37":237,"_13":238,"_66":239,"_47":-5,"_39":40,"_192":240,"_194":24,"_41":295,"_43":26,"_69":21,"_196":242,"_71":30,"_198":-5,"_277":296,"_17":297},{"_37":229,"_13":230,"_66":231,"_47":-5,"_39":40,"_192":146,"_194":24,"_41":292,"_43":233,"_69":234,"_196":235,"_71":30,"_198":-5,"_277":293,"_17":294},{"_37":222,"_13":223,"_66":224,"_47":-5,"_39":40,"_192":225,"_194":24,"_41":289,"_43":26,"_69":21,"_196":227,"_71":30,"_198":-5,"_277":290,"_17":291},{"_37":215,"_13":216,"_66":217,"_47":-5,"_39":40,"_192":218,"_194":24,"_41":286,"_43":26,"_69":21,"_196":220,"_71":30,"_198":-5,"_277":287,"_17":288},{"_37":207,"_13":208,"_66":209,"_47":-5,"_39":40,"_192":210,"_194":24,"_41":283,"_43":212,"_69":70,"_196":213,"_71":30,"_198":-5,"_277":284,"_17":285},{"_37":200,"_13":201,"_66":202,"_47":-5,"_39":40,"_192":203,"_194":24,"_41":280,"_43":26,"_69":21,"_196":205,"_71":30,"_198":-5,"_277":281,"_17":282},{"_37":189,"_13":190,"_66":191,"_47":-5,"_39":40,"_192":193,"_194":24,"_41":276,"_43":26,"_69":21,"_196":197,"_71":30,"_198":-5,"_277":278,"_17":279},["D",1775283940460],"children",[],[190],["D",1775284023483],[],[201],["D",1775322520301],[],[208],["D",1775283959685],[],[216],["D",1775284102955],[],[223],["D",1779514109222],[],[230],["D",1775283973401],[],[238],["D",1775284755396],[],[245],["D",1775322544723],[],[251],["D",1775283063025],["D",1789470042795],{"_11":12,"_159":74},{"_11":12,"_155":-5,"_73":74,"_31":72,"_156":157,"_158":30},{"_43":146,"_13":16,"_37":40,"_147":108,"_148":-5,"_149":-5,"_150":-5,"_151":-5,"_152":-5,"_153":14,"_154":12},"ctx",{"_56":-5,"_177":342,"_343":344,"_345":346,"_347":30,"_348":30,"_349":30,"_350":24,"_351":-5,"_352":-7,"_353":-7,"_354":26,"_355":30,"_356":30,"_357":-5,"_358":30,"_359":30,"_360":30,"_361":-5},"ENV",{"_313":314,"_315":316,"_317":16,"_318":319,"_320":321,"_322":323,"_324":325,"_326":327,"_328":329,"_330":331,"_332":333,"_334":335,"_336":337,"_338":339,"_340":341},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · docs