terse-sdk 0.1.53 → 0.1.55

package/README.md

@@ -19,27 +19,16 @@ The fastest way to get started is `npm install -g terse-cli && terse init my-pro
 A Terse workflow is a single TypeScript file. The job below watches a repo for new pull requests, posts a deterministic Slack message, then threads an agent-written summary under it:
 
 ```ts
-import { GithubPRTrigger, TerseAgent, createJob } from "terse-sdk"
-import { Repos, Skills, SlackChannel, Triggers } from "../terse.generated"
+import { GithubPRTrigger, generateText, createJob } from "terse-sdk"
+import { Repos, Skills, SlackChannel, Triggers, toolbox } from "../terse.generated"
 // ^^ Generated based on your workspace
 
 createJob({
     name: "Summarize PR and send slack message",
     triggers: [Triggers.github.onPROpened({ repo: Repos.TerseAI.Terse })],
     onTrigger: async (event: GithubPRTrigger) => {
-        // Create durable Agents
-        const prompt = "Summarize the incoming PR and send to slack. Format the summary in Block Kit; include screenshots or diagrams from the PR as image blocks."
-        const agent = TerseAgent.create({
-            prompt,
-            skills: [
-                // Fine tune what agents have access to. Impossible to modify anything outside of this scope
-                Skills.github({ repos: [Repos.TerseAI.Terse] }),
-                Skills.slack({ channel: SlackChannel.AllTerseInc })
-            ]
-        })
-
-        // deterministically call a tool
-        const message = await agent.tools.slack.sendMessage({
+        // Deterministic call — fixed channel, fixed message. No agent needed.
+        const message = await toolbox.slack.sendMessage({
             channelId: SlackChannel.AllTerseInc.channelId,
             message: "New PR from " + event.sender.login + "!"
         })
@@ -47,11 +36,19 @@ createJob({
         // Outputs are strongly typed
         const parentId = message.message_ts
 
-        // Trigger the Agent with Github + Slack tools auto added
-        await agent.runAndWait(`
-        Summarize this PR ${event.formatForAgentRunner()}.
-        Keep it short. Reply in a thread to the Slack message (thread parent ts: ${parentId}).
-        `)
+        // Agentic: one prompt in, the model uses the GitHub + Slack tools granted via skills
+        await generateText({
+            prompt: `
+            Summarize this PR ${event.formatForAgentRunner()}.
+            Keep it short. Format the summary in Block Kit; include screenshots or diagrams from the PR as image blocks.
+            Reply in a thread to the Slack message (thread parent ts: ${parentId}).
+            `,
+            skills: [
+                // Fine tune what the agent has access to. Impossible to touch anything outside this scope
+                Skills.github({ repos: [Repos.TerseAI.Terse] }),
+                Skills.slack({ channel: SlackChannel.AllTerseInc })
+            ]
+        })
     }
 })
 ```
@@ -61,14 +58,13 @@ createJob({
 | Concept | What it is |
 |---|---|
 | `createJob()` | Registers a workflow at module load time. |
-| `TerseAgent.create()` | Build an agent inside `onTrigger` with `prompt`, `skills`, and `toolApprovals`. |
-| `agent.run()` | Stream the model run as an async iterable. |
-| `agent.runAndWait()` | Run to completion. Pass a `zod` schema for structured output. |
-| `agent.tools.*` | Generated, deterministic wrappers. Call directly to bypass the LLM. |
+| `generateText()` | The shorthand for agentic runs: one prompt in, final output out. The model can call any tool granted via `skills`. Pass a `zod` `outputSchema` for structured output. Reach for this in almost every job. |
+| `toolbox.*` | Generated, deterministic wrappers. Call directly to bypass the LLM. No agent or `skills` needed. |
 | `Triggers.*` | Per-integration trigger builders, plus `Triggers.schedule.cron()` and `Triggers.webhook.onRequest<Body>()`. |
-| `Skills.*` | Integration skill factories (e.g. `Skills.github({...})`, `Skills.slack({...})`) that scope the tools available to the agent. |
+| `Skills.*` | Integration skill factories (e.g. `Skills.github({...})`, `Skills.slack({...})`) that scope the tools available to the model. |
+| `TerseAgent.create()` | The lower-level agent `generateText` wraps. Use directly only to stream with `run()` or reuse one agent instance across calls. |
 
-The trigger builders, skill constructors, and `agent.tools.*` wrappers come from `src/terse.generated.ts`, which is produced by `terse generate`. Do not edit it by hand.
+The trigger builders, skill constructors, and `toolbox.*` wrappers come from `src/terse.generated.ts`, which is produced by `terse generate`. Do not edit it by hand.
 
 Full reference: [docs.useterse.ai/reference/typescript-sdk](https://docs.useterse.ai/reference/typescript-sdk).
 

package/dist/memoryfs/file.d.ts

@@ -0,0 +1,16 @@
+import type { FsEntry, LocalFsStore } from "./store.js";
+export type FileCommand = "list" | "read" | "write" | "delete";
+export type FileCommandInput = {
+    command: FileCommand;
+    path?: string | null;
+    content?: string | null;
+};
+export type FileCommandResult = {
+    success: true;
+    message: string;
+    entries?: FsEntry[];
+    content?: string;
+};
+export declare function executeFileCommand(store: LocalFsStore, input: FileCommandInput): Promise<FileCommandResult>;
+export declare const MUTATING_FILE_COMMANDS: ReadonlySet<FileCommand>;
+//# sourceMappingURL=file.d.ts.map

package/dist/memoryfs/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/memoryfs/file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,WAAW,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,IAAI,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoCjH;AAED,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,WAAW,CAAgC,CAAA"}

package/dist/memoryfs/file.js

@@ -0,0 +1,40 @@
+import { formatHumanSize } from "./paths.js";
+export async function executeFileCommand(store, input) {
+    switch (input.command) {
+        case "list": {
+            const entries = await store.list(input.path ?? "");
+            if (entries.length === 0) {
+                return { success: true, message: `Directory ${input.path || "/"} is empty.`, entries: [] };
+            }
+            const listing = entries.map(entry => `${formatHumanSize(entry.sizeBytes)}\t${entry.path}${entry.isDirectory ? "/" : ""}`).join("\n");
+            return { success: true, message: `Files in ${input.path || "/"}:\n${listing}`, entries };
+        }
+        case "read": {
+            if (!input.path) {
+                throw new Error("read requires path");
+            }
+            const content = await store.read(input.path);
+            return { success: true, message: `Read ${input.path}`, content };
+        }
+        case "write": {
+            if (!input.path || input.content === undefined || input.content === null) {
+                throw new Error("write requires path and content");
+            }
+            await store.write(input.path, input.content);
+            return { success: true, message: `Wrote file ${input.path}` };
+        }
+        case "delete": {
+            if (!input.path) {
+                throw new Error("delete requires path");
+            }
+            await store.deletePath(input.path);
+            return { success: true, message: `Deleted ${input.path}` };
+        }
+        default: {
+            const exhaustive = input.command;
+            throw new Error(`Unsupported file command: ${exhaustive}`);
+        }
+    }
+}
+export const MUTATING_FILE_COMMANDS = new Set(["write", "delete"]);
+//# sourceMappingURL=file.js.map

package/dist/memoryfs/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/memoryfs/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAkB5C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAmB,EAAE,KAAuB;IACjF,QAAQ,KAAK,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,MAAM,CAAC,CAAC,CAAC;YACV,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;YAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,KAAK,CAAC,IAAI,IAAI,GAAG,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;YAC9F,CAAC;YACD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACpI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,KAAK,CAAC,IAAI,IAAI,GAAG,MAAM,OAAO,EAAE,EAAE,OAAO,EAAE,CAAA;QAC5F,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACV,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;YACzC,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAA;QACpE,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACvE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;YACtD,CAAC;YACD,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,KAAK,CAAC,IAAI,EAAE,EAAE,CAAA;QACjE,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;YAC3C,CAAC;YACD,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,KAAK,CAAC,IAAI,EAAE,EAAE,CAAA;QAC9D,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,UAAU,GAAU,KAAK,CAAC,OAAO,CAAA;YACvC,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAA;QAC9D,CAAC;IACL,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAA6B,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA"}

package/dist/memoryfs/index.d.ts

@@ -0,0 +1,25 @@
+import { type FileCommandInput, type FileCommandResult } from "./file.js";
+import { type MemoryCommandInput, type MemoryCommandResult } from "./memory.js";
+export { LocalFsStore } from "./store.js";
+export type { FsEntry } from "./store.js";
+export { executeMemoryCommand, type MemoryCommand, type MemoryCommandInput, type MemoryCommandResult } from "./memory.js";
+export { executeFileCommand, type FileCommand, type FileCommandInput, type FileCommandResult } from "./file.js";
+export { MEMORY_ROOT, resolveFsRoot } from "./paths.js";
+/** Tool names that resolve against the co-located filesystem instead of the backend. */
+export declare const MEMORY_FS_TOOL_NAMES: readonly ["memory", "file"];
+export type MemoryFsToolName = (typeof MEMORY_FS_TOOL_NAMES)[number];
+export declare function isMemoryFsTool(toolName: string): toolName is MemoryFsToolName;
+export type MemoryFsRequest = {
+    tool: "memory";
+    input: MemoryCommandInput;
+} | {
+    tool: "file";
+    input: FileCommandInput;
+};
+export type MemoryFsResult = MemoryCommandResult | FileCommandResult;
+/**
+ * Single entry point used by both reach-back paths. Resolves the co-located root, runs the
+ * command against the local filesystem, and commits the volume after a mutating op.
+ */
+export declare function runMemoryFsCommand(request: MemoryFsRequest): Promise<MemoryFsResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/memoryfs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memoryfs/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAA8C,MAAM,WAAW,CAAA;AACrH,OAAO,EAA4B,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAwB,MAAM,aAAa,CAAA;AAI/H,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACzH,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC/G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEvD,wFAAwF;AACxF,eAAO,MAAM,oBAAoB,6BAA8B,CAAA;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,IAAI,gBAAgB,CAE7E;AAuBD,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAA;AAEvH,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,iBAAiB,CAAA;AAEpE;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB1F"}

package/dist/memoryfs/index.js

@@ -0,0 +1,60 @@
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import { MUTATING_FILE_COMMANDS, executeFileCommand } from "./file.js";
+import { MUTATING_MEMORY_COMMANDS, executeMemoryCommand } from "./memory.js";
+import { FILES_SUBDIR, MEMORY_SUBDIR, resolveFsRoot } from "./paths.js";
+import { LocalFsStore } from "./store.js";
+export { LocalFsStore } from "./store.js";
+export { executeMemoryCommand } from "./memory.js";
+export { executeFileCommand } from "./file.js";
+export { MEMORY_ROOT, resolveFsRoot } from "./paths.js";
+/** Tool names that resolve against the co-located filesystem instead of the backend. */
+export const MEMORY_FS_TOOL_NAMES = ["memory", "file"];
+export function isMemoryFsTool(toolName) {
+    return MEMORY_FS_TOOL_NAMES.includes(toolName);
+}
+const execFileAsync = promisify(execFile);
+/**
+ * Commit pending writes to the backing Modal volume. On Volumes v2 `sync <mountpoint>`
+ * flushes and commits, so changes become visible to other containers. Gated by
+ * TERSE_FS_COMMIT (set by the backend only when running on a mounted volume); a no-op for
+ * local-dev where writes already live on the dev machine's disk.
+ */
+async function commitMount(mountPath) {
+    if (process.env.TERSE_FS_COMMIT !== "1")
+        return;
+    try {
+        await execFileAsync("sync", [mountPath]);
+    }
+    catch {
+        try {
+            await execFileAsync("sync", []);
+        }
+        catch {
+            // best-effort: fall back to Modal's background commit
+        }
+    }
+}
+/**
+ * Single entry point used by both reach-back paths. Resolves the co-located root, runs the
+ * command against the local filesystem, and commits the volume after a mutating op.
+ */
+export async function runMemoryFsCommand(request) {
+    const root = resolveFsRoot();
+    if (request.tool === "memory") {
+        const store = new LocalFsStore(path.join(root, MEMORY_SUBDIR));
+        const result = await executeMemoryCommand(store, request.input);
+        if (MUTATING_MEMORY_COMMANDS.has(request.input.command)) {
+            await commitMount(root);
+        }
+        return result;
+    }
+    const store = new LocalFsStore(path.join(root, FILES_SUBDIR));
+    const result = await executeFileCommand(store, request.input);
+    if (MUTATING_FILE_COMMANDS.has(request.input.command)) {
+        await commitMount(root);
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/memoryfs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memoryfs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,OAAO,EAAiD,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACrH,OAAO,EAAE,wBAAwB,EAAqD,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAC/H,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,EAAE,oBAAoB,EAAyE,MAAM,aAAa,CAAA;AACzH,OAAO,EAAE,kBAAkB,EAAmE,MAAM,WAAW,CAAA;AAC/G,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEvD,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAU,CAAA;AAG/D,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC3C,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AACzE,CAAC;AAED,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAEzC;;;;;GAKG;AACH,KAAK,UAAU,WAAW,CAAC,SAAiB;IACxC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG;QAAE,OAAM;IAC/C,IAAI,CAAC;QACD,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACL,IAAI,CAAC;YACD,MAAM,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QACnC,CAAC;QAAC,MAAM,CAAC;YACL,sDAAsD;QAC1D,CAAC;IACL,CAAC;AACL,CAAC;AAMD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAwB;IAC7D,MAAM,IAAI,GAAG,aAAa,EAAE,CAAA;IAE5B,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAA;QAC9D,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QAC/D,IAAI,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QACD,OAAO,MAAM,CAAA;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7D,IAAI,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/memoryfs/memory.d.ts

@@ -0,0 +1,21 @@
+import type { LocalFsStore } from "./store.js";
+export type MemoryCommand = "view" | "create" | "str_replace" | "insert" | "delete" | "rename";
+export type MemoryCommandInput = {
+    command: MemoryCommand;
+    path?: string;
+    view_range?: [number, number] | null;
+    file_text?: string;
+    old_str?: string;
+    new_str?: string;
+    insert_line?: number;
+    insert_text?: string;
+    old_path?: string;
+    new_path?: string;
+};
+export type MemoryCommandResult = {
+    success: true;
+    message: string;
+};
+export declare function executeMemoryCommand(store: LocalFsStore, input: MemoryCommandInput): Promise<MemoryCommandResult>;
+export declare const MUTATING_MEMORY_COMMANDS: ReadonlySet<MemoryCommand>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memoryfs/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/memoryfs/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE9F,MAAM,MAAM,kBAAkB,GAAG;IAC7B,OAAO,EAAE,aAAa,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAgFpE,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoIvH;AAED,eAAO,MAAM,wBAAwB,EAAE,WAAW,CAAC,aAAa,CAAoE,CAAA"}

package/dist/memoryfs/memory.js

@@ -0,0 +1,196 @@
+import { MEMORY_ROOT, formatHumanSize, resolveRelativePath } from "./paths.js";
+function memoryDisplayPath(relativePath) {
+    const normalized = relativePath.replace(/^\/+/, "");
+    if (!normalized)
+        return MEMORY_ROOT;
+    return `${MEMORY_ROOT}/${normalized}`;
+}
+function resolveMemoryPath(inputPath) {
+    const trimmed = inputPath.trim();
+    if (trimmed === MEMORY_ROOT || trimmed === `${MEMORY_ROOT}/`) {
+        return "";
+    }
+    let pathPart = trimmed;
+    if (pathPart.startsWith(`${MEMORY_ROOT}/`)) {
+        pathPart = pathPart.slice(MEMORY_ROOT.length + 1);
+    }
+    else if (pathPart.startsWith("/")) {
+        pathPart = pathPart.slice(1);
+    }
+    return resolveRelativePath(pathPart);
+}
+function resolveMemoryPathOptional(inputPath) {
+    if (!inputPath || inputPath.trim().length === 0) {
+        return "";
+    }
+    return resolveMemoryPath(inputPath);
+}
+function formatLineNumber(lineNumber) {
+    return String(lineNumber).padStart(6, " ");
+}
+async function listDirectoryView(store, relativePath, displayPath) {
+    const entries = await store.list(relativePath);
+    const lines = [`Here're the files and directories up to 2 levels deep in ${displayPath}, excluding hidden items and node_modules:`];
+    const rootStat = relativePath ? await store.stat(relativePath) : null;
+    lines.push(`${formatHumanSize(rootStat?.sizeBytes ?? 4096)}\t${displayPath}`);
+    for (const entry of entries) {
+        lines.push(`${formatHumanSize(entry.sizeBytes)}\t${memoryDisplayPath(entry.path)}`);
+        if (entry.isDirectory) {
+            const children = await store.list(entry.path);
+            for (const child of children) {
+                lines.push(`${formatHumanSize(child.sizeBytes)}\t${memoryDisplayPath(child.path)}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+async function viewFile(store, relativePath, displayPath, viewRange) {
+    const content = await store.read(relativePath);
+    const lines = content.split("\n");
+    if (lines.length > 999_999) {
+        return `File ${displayPath} exceeds maximum line limit of 999,999 lines.`;
+    }
+    const start = viewRange?.[0] ?? 1;
+    const end = viewRange?.[1] ?? lines.length;
+    const selected = lines.slice(Math.max(start, 1) - 1, end);
+    const body = selected.map((line, index) => `${formatLineNumber(start + index)}\t${line}`).join("\n");
+    return `Here's the content of ${displayPath} with line numbers:\n${body}`;
+}
+function snippetWithLineNumbers(content, centerLine, radius = 4) {
+    const lines = content.split("\n");
+    const start = Math.max(centerLine - radius, 1);
+    const end = Math.min(centerLine + radius, lines.length);
+    return lines
+        .slice(start - 1, end)
+        .map((line, index) => `${formatLineNumber(start + index)}\t${line}`)
+        .join("\n");
+}
+export async function executeMemoryCommand(store, input) {
+    switch (input.command) {
+        case "view": {
+            const relativePath = resolveMemoryPathOptional(input.path);
+            const displayPath = memoryDisplayPath(relativePath);
+            const exists = relativePath === "" ? true : await store.exists(relativePath);
+            if (!exists) {
+                return { success: true, message: `The path ${displayPath} does not exist. Please provide a valid path.` };
+            }
+            const stat = relativePath === "" ? { isDirectory: true } : await store.stat(relativePath);
+            if (stat.isDirectory) {
+                return { success: true, message: await listDirectoryView(store, relativePath, displayPath) };
+            }
+            return { success: true, message: await viewFile(store, relativePath, displayPath, input.view_range ?? undefined) };
+        }
+        case "create": {
+            if (!input.path || input.file_text === undefined) {
+                throw new Error("create requires path and file_text");
+            }
+            const relativePath = resolveMemoryPath(input.path);
+            const displayPath = memoryDisplayPath(relativePath);
+            if (await store.exists(relativePath)) {
+                return { success: true, message: `Error: File ${displayPath} already exists` };
+            }
+            await store.write(relativePath, input.file_text);
+            return { success: true, message: `File created successfully at: ${displayPath}` };
+        }
+        case "str_replace": {
+            if (!input.path || input.old_str === undefined || input.new_str === undefined) {
+                throw new Error("str_replace requires path, old_str, and new_str");
+            }
+            const relativePath = resolveMemoryPath(input.path);
+            const displayPath = memoryDisplayPath(relativePath);
+            if (!(await store.exists(relativePath))) {
+                return { success: true, message: `Error: The path ${displayPath} does not exist. Please provide a valid path.` };
+            }
+            const stat = await store.stat(relativePath);
+            if (stat.isDirectory) {
+                return { success: true, message: `Error: The path ${displayPath} does not exist. Please provide a valid path.` };
+            }
+            const content = await store.read(relativePath);
+            const occurrences = [];
+            let index = content.indexOf(input.old_str);
+            while (index !== -1) {
+                const lineNumber = content.slice(0, index).split("\n").length;
+                occurrences.push(lineNumber);
+                index = content.indexOf(input.old_str, index + input.old_str.length);
+            }
+            if (occurrences.length === 0) {
+                return { success: true, message: `No replacement was performed, old_str \`${input.old_str}\` did not appear verbatim in ${displayPath}.` };
+            }
+            if (occurrences.length > 1) {
+                return {
+                    success: true,
+                    message: `No replacement was performed. Multiple occurrences of old_str \`${input.old_str}\` in lines: ${occurrences.join(", ")}. Please ensure it is unique`
+                };
+            }
+            const updated = content.replace(input.old_str, input.new_str);
+            await store.write(relativePath, updated);
+            const editedLine = content.slice(0, content.indexOf(input.old_str)).split("\n").length;
+            return {
+                success: true,
+                message: `The memory file has been edited.\n${snippetWithLineNumbers(updated, editedLine)}`
+            };
+        }
+        case "insert": {
+            if (!input.path || input.insert_line === undefined || input.insert_text === undefined) {
+                throw new Error("insert requires path, insert_line, and insert_text");
+            }
+            const relativePath = resolveMemoryPath(input.path);
+            const displayPath = memoryDisplayPath(relativePath);
+            if (!(await store.exists(relativePath))) {
+                return { success: true, message: `Error: The path ${displayPath} does not exist` };
+            }
+            const stat = await store.stat(relativePath);
+            if (stat.isDirectory) {
+                return { success: true, message: `Error: The path ${displayPath} does not exist` };
+            }
+            const content = await store.read(relativePath);
+            const lines = content.split("\n");
+            const maxLine = lines.length;
+            if (input.insert_line < 0 || input.insert_line > maxLine) {
+                return {
+                    success: true,
+                    message: `Error: Invalid \`insert_line\` parameter: ${input.insert_line}. It should be within the range of lines of the file: [0, ${maxLine}]`
+                };
+            }
+            const insertLines = input.insert_text.split("\n");
+            lines.splice(input.insert_line, 0, ...insertLines);
+            await store.write(relativePath, lines.join("\n"));
+            return { success: true, message: `The file ${displayPath} has been edited.` };
+        }
+        case "delete": {
+            if (!input.path) {
+                throw new Error("delete requires path");
+            }
+            const relativePath = resolveMemoryPath(input.path);
+            const displayPath = memoryDisplayPath(relativePath);
+            if (!(await store.exists(relativePath))) {
+                return { success: true, message: `Error: The path ${displayPath} does not exist` };
+            }
+            await store.deletePath(relativePath);
+            return { success: true, message: `Successfully deleted ${displayPath}` };
+        }
+        case "rename": {
+            if (!input.old_path || !input.new_path) {
+                throw new Error("rename requires old_path and new_path");
+            }
+            const fromPath = resolveMemoryPath(input.old_path);
+            const toPath = resolveMemoryPath(input.new_path);
+            const fromDisplay = memoryDisplayPath(fromPath);
+            const toDisplay = memoryDisplayPath(toPath);
+            if (!(await store.exists(fromPath))) {
+                return { success: true, message: `Error: The path ${fromDisplay} does not exist` };
+            }
+            if (await store.exists(toPath)) {
+                return { success: true, message: `Error: The destination ${toDisplay} already exists` };
+            }
+            await store.rename(fromPath, toPath);
+            return { success: true, message: `Successfully renamed ${fromDisplay} to ${toDisplay}` };
+        }
+        default: {
+            const exhaustive = input.command;
+            throw new Error(`Unsupported memory command: ${exhaustive}`);
+        }
+    }
+}
+export const MUTATING_MEMORY_COMMANDS = new Set(["create", "str_replace", "insert", "delete", "rename"]);
+//# sourceMappingURL=memory.js.map

package/dist/memoryfs/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/memoryfs/memory.ts"],"names":[],"mappings":"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"}

package/dist/memoryfs/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const MEMORY_ROOT = "/memories";
+export declare const MEMORY_SUBDIR = "memories";
+export declare const FILES_SUBDIR = "files";
+export declare function resolveFsRoot(): string;
+export declare function resolveRelativePath(inputPath: string): string;
+export declare function formatHumanSize(sizeBytes: number): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/memoryfs/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/memoryfs/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,WAAW,cAAc,CAAA;AAEtC,eAAO,MAAM,aAAa,aAAa,CAAA;AACvC,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsB7D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzD"}

package/dist/memoryfs/paths.js

@@ -0,0 +1,39 @@
+import os from "node:os";
+import path from "node:path";
+export const MEMORY_ROOT = "/memories";
+export const MEMORY_SUBDIR = "memories";
+export const FILES_SUBDIR = "files";
+export function resolveFsRoot() {
+    const fromEnv = process.env.TERSE_FS_ROOT;
+    if (fromEnv && fromEnv.trim().length > 0) {
+        return fromEnv.trim();
+    }
+    return path.join(os.tmpdir(), "terse-memoryfs");
+}
+export function resolveRelativePath(inputPath) {
+    const normalized = inputPath.replace(/\\/g, "/").trim();
+    if (!normalized) {
+        throw new Error("Path is required.");
+    }
+    const withoutLeadingSlash = normalized.startsWith("/") ? normalized.slice(1) : normalized;
+    if (withoutLeadingSlash.includes("\0")) {
+        throw new Error("Invalid path.");
+    }
+    const segments = withoutLeadingSlash.split("/").filter(segment => segment.length > 0);
+    if (segments.some(segment => segment === "..")) {
+        throw new Error("Path traversal is not allowed.");
+    }
+    const resolved = path.posix.normalize(segments.join("/") || ".");
+    if (resolved === ".." || resolved.startsWith("../")) {
+        throw new Error("Path traversal is not allowed.");
+    }
+    return resolved === "." ? "" : resolved;
+}
+export function formatHumanSize(sizeBytes) {
+    if (sizeBytes < 1024)
+        return `${sizeBytes}B`;
+    if (sizeBytes < 1024 * 1024)
+        return `${(sizeBytes / 1024).toFixed(1)}K`;
+    return `${(sizeBytes / (1024 * 1024)).toFixed(1)}M`;
+}
+//# sourceMappingURL=paths.js.map

package/dist/memoryfs/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/memoryfs/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAA;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAA;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAA;AAEnC,MAAM,UAAU,aAAa;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAA;IACzC,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACjD,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACvD,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;IACxC,CAAC;IAED,MAAM,mBAAmB,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;IACzF,IAAI,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACrF,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAA;IAChE,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IACrD,CAAC;IAED,OAAO,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC7C,IAAI,SAAS,GAAG,IAAI;QAAE,OAAO,GAAG,SAAS,GAAG,CAAA;IAC5C,IAAI,SAAS,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;IACvE,OAAO,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AACvD,CAAC"}

package/dist/memoryfs/store.d.ts

@@ -0,0 +1,18 @@
+export interface FsEntry {
+    path: string;
+    isDirectory: boolean;
+    sizeBytes: number;
+}
+export declare class LocalFsStore {
+    private readonly root;
+    constructor(root: string);
+    private resolveAbsolute;
+    read(relativePath: string): Promise<string>;
+    write(relativePath: string, content: string): Promise<void>;
+    list(relativePath: string): Promise<FsEntry[]>;
+    exists(relativePath: string): Promise<boolean>;
+    stat(relativePath: string): Promise<FsEntry>;
+    deletePath(relativePath: string): Promise<void>;
+    rename(fromPath: string, toPath: string): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/memoryfs/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memoryfs/store.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,YAAY;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC,OAAO,CAAC,eAAe;IAUjB,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgC9C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9C,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAa5C,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYhE"}