hoomanjs 1.55.3 → 1.56.0

package/dist/core/approvals/intervention.js

@@ -33,6 +33,9 @@ function switchModeTarget(toolInput) {
     const next = toolInput.mode;
     return typeof next === "string" && next.trim() ? next.trim() : undefined;
 }
+function requestsFreshPlan(toolInput) {
+    return isPlainObjectRecord(toolInput) && toolInput.fresh === true;
+}
 /** True when {@link SWITCH_MODE_TOOL} is leaving plan for another mode. */
 export function isLeavingPlanMode(toolName, toolInput, currentMode) {
     if (toolName !== SWITCH_MODE_TOOL || currentMode !== "plan") {
@@ -86,11 +89,24 @@ export class HoomanToolApprovalIntervention extends InterventionHandler {
         const leavingPlan = isLeavingPlanMode(toolName, event.toolUse.input, currentMode);
         if (isSwitchMode) {
             const targetMode = switchModeTarget(event.toolUse.input);
+            const startsFreshPlan = currentMode === "plan" &&
+                targetMode === "plan" &&
+                requestsFreshPlan(event.toolUse.input);
             request = {
                 ...request,
                 currentMode,
                 ...(targetMode ? { targetMode } : {}),
+                switchModeAction: startsFreshPlan ? "start_fresh_plan" : "switch",
             };
+            const missingPlanDocument = currentMode === "plan" &&
+                targetMode === "plan" &&
+                !getPlanState(event.agent).planFile;
+            if (targetMode === currentMode &&
+                !startsFreshPlan &&
+                !missingPlanDocument) {
+                await this.onApproved?.(request, event, "auto");
+                return InterventionActions.proceed();
+            }
         }
         const planReject = planModeWriteEditRejectionMessage(event.agent, toolName, event.toolUse.input);
         if (planReject) {

package/dist/core/approvals/intervention.js.map

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

package/dist/core/filesystem/backend.d.ts

@@ -0,0 +1,13 @@
+export type TextReadOptions = {
+    line?: number;
+    limit?: number;
+};
+export type FsBackend = {
+    readonly kind: "local" | "remote";
+    readTextFile(path: string, options?: TextReadOptions): Promise<string>;
+    writeTextFile(path: string, content: string): Promise<void>;
+};
+export type RemoteFsBackendCapabilities = {
+    canRead: boolean;
+    canWrite: boolean;
+};

package/dist/core/filesystem/backend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend.js.map

package/dist/core/filesystem/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/core/filesystem/backend.ts"],"names":[],"mappings":""}

package/dist/core/filesystem/backends/index.d.ts

@@ -0,0 +1,2 @@
+export { LocalFsBackend } from "./local-fs-backend.js";
+export { RemoteFsBackend, type RemoteTextFsClient, } from "./remote-fs-backend.js";

package/dist/core/filesystem/backends/index.js

@@ -0,0 +1,3 @@
+export { LocalFsBackend } from "./local-fs-backend.js";
+export { RemoteFsBackend, } from "./remote-fs-backend.js";
+//# sourceMappingURL=index.js.map

package/dist/core/filesystem/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/filesystem/backends/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EACL,eAAe,GAEhB,MAAM,wBAAwB,CAAC"}

package/dist/core/filesystem/backends/local-fs-backend.d.ts

@@ -0,0 +1,6 @@
+import type { FsBackend, TextReadOptions } from "../backend.js";
+export declare class LocalFsBackend implements FsBackend {
+    readonly kind: "local";
+    readTextFile(path: string, options?: TextReadOptions): Promise<string>;
+    writeTextFile(path: string, content: string): Promise<void>;
+}

package/dist/core/filesystem/backends/local-fs-backend.js

@@ -0,0 +1,17 @@
+import fs from "node:fs/promises";
+export class LocalFsBackend {
+    kind = "local";
+    async readTextFile(path, options) {
+        const content = await fs.readFile(path, "utf8");
+        if (!options?.line && !options?.limit) {
+            return content;
+        }
+        const start = Math.max(0, (options.line ?? 1) - 1);
+        const end = options.limit === undefined ? undefined : start + options.limit;
+        return content.split(/\r?\n/).slice(start, end).join("\n");
+    }
+    async writeTextFile(path, content) {
+        await fs.writeFile(path, content, "utf8");
+    }
+}
+//# sourceMappingURL=local-fs-backend.js.map

package/dist/core/filesystem/backends/local-fs-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-fs-backend.js","sourceRoot":"","sources":["../../../../src/core/filesystem/backends/local-fs-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGlC,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,OAAgB,CAAC;IAEjC,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,OAAyB;QACxD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5E,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,OAAe;QAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/core/filesystem/backends/remote-fs-backend.d.ts

@@ -0,0 +1,12 @@
+import type { FsBackend, RemoteFsBackendCapabilities, TextReadOptions } from "../backend.js";
+export type RemoteTextFsClient = RemoteFsBackendCapabilities & {
+    readTextFile(path: string, options?: TextReadOptions): Promise<string>;
+    writeTextFile(path: string, content: string): Promise<void>;
+};
+export declare class RemoteFsBackend implements FsBackend {
+    private readonly client;
+    readonly kind: "remote";
+    constructor(client: RemoteTextFsClient);
+    readTextFile(path: string, options?: TextReadOptions): Promise<string>;
+    writeTextFile(path: string, content: string): Promise<void>;
+}

package/dist/core/filesystem/backends/remote-fs-backend.js

@@ -0,0 +1,20 @@
+export class RemoteFsBackend {
+    client;
+    kind = "remote";
+    constructor(client) {
+        this.client = client;
+    }
+    async readTextFile(path, options) {
+        if (!this.client.canRead) {
+            throw new Error("The active remote filesystem backend cannot read files.");
+        }
+        return this.client.readTextFile(path, options);
+    }
+    async writeTextFile(path, content) {
+        if (!this.client.canWrite) {
+            throw new Error("The active remote filesystem backend cannot write files.");
+        }
+        await this.client.writeTextFile(path, content);
+    }
+}
+//# sourceMappingURL=remote-fs-backend.js.map

package/dist/core/filesystem/backends/remote-fs-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-fs-backend.js","sourceRoot":"","sources":["../../../../src/core/filesystem/backends/remote-fs-backend.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,eAAe;IAGG;IAFpB,IAAI,GAAG,QAAiB,CAAC;IAElC,YAA6B,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;IAAG,CAAC;IAE3D,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,OAAyB;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,OAAe;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/core/filesystem/edits/apply.d.ts

@@ -0,0 +1,4 @@
+import type { FsBackend } from "../backend.js";
+import type { EditResult, FileEdit } from "./types.js";
+export declare function applyFileEdit(backend: FsBackend, edit: FileEdit): Promise<EditResult>;
+export declare function applyFileEdits(backend: FsBackend, edits: FileEdit[]): Promise<EditResult[]>;

package/dist/core/filesystem/edits/apply.js

@@ -0,0 +1,104 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+function applyLineEdit(original, edit) {
+    const lineEnding = original.includes("\r\n") ? "\r\n" : "\n";
+    const endsWithNewline = original.endsWith("\n");
+    const lines = original.length === 0 ? [] : original.replaceAll("\r\n", "\n").split("\n");
+    if (endsWithNewline)
+        lines.pop();
+    const at = edit.insert_at;
+    if (at < 1 || at > lines.length + 1)
+        throw new Error(`insert_at must be between 1 and ${lines.length + 1}.`);
+    const replacement = edit.content.replaceAll("\r\n", "\n").split("\n");
+    if (edit.content.endsWith("\n"))
+        replacement.pop();
+    const until = edit.replace_until;
+    if (until !== undefined && until !== null) {
+        if (until < at || until > lines.length)
+            throw new Error(`replace_until must be between ${at} and ${lines.length}.`);
+        lines.splice(at - 1, until - at + 1, ...replacement);
+    }
+    else {
+        lines.splice(at - 1, 0, ...replacement);
+    }
+    return lines.join(lineEnding) + (endsWithNewline ? lineEnding : "");
+}
+async function sourceContent(backend, filePath, expected) {
+    const content = await backend.readTextFile(filePath);
+    if (expected && sha256(content) !== expected)
+        throw new Error(`File content hash did not match for ${filePath}. Read it again before editing.`);
+    return content;
+}
+export async function applyFileEdit(backend, edit) {
+    if (edit.mode === "write") {
+        let prior;
+        try {
+            prior = await backend.readTextFile(edit.path);
+        }
+        catch {
+            /* creating */
+        }
+        if (prior !== undefined &&
+            edit.expected_sha256 &&
+            sha256(prior) !== edit.expected_sha256)
+            throw new Error(`File content hash did not match for ${edit.path}.`);
+        if (backend.kind === "local")
+            await fs.mkdir(path.dirname(edit.path), { recursive: true });
+        await backend.writeTextFile(edit.path, edit.content);
+        return {
+            path: edit.path,
+            mode: edit.mode,
+            changed: prior !== edit.content,
+        };
+    }
+    const original = await sourceContent(backend, edit.path, edit.expected_sha256);
+    if (edit.mode === "edit") {
+        const next = applyLineEdit(original, edit);
+        await backend.writeTextFile(edit.path, next);
+        return { path: edit.path, mode: edit.mode, changed: next !== original };
+    }
+    if (edit.mode === "rename") {
+        try {
+            await fs.access(edit.new_path);
+            throw new Error(`Rename destination already exists: ${edit.new_path}`);
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                error.message.startsWith("Rename destination"))
+                throw error;
+        }
+        await fs.mkdir(path.dirname(edit.new_path), { recursive: true });
+        await backend.writeTextFile(edit.new_path, original);
+        await backend.writeTextFile(edit.path, "");
+        await fs.rm(edit.path);
+        return {
+            path: edit.path,
+            mode: edit.mode,
+            changed: true,
+            new_path: edit.new_path,
+        };
+    }
+    await backend.writeTextFile(edit.path, "");
+    await fs.rm(edit.path);
+    return { path: edit.path, mode: edit.mode, changed: true };
+}
+export async function applyFileEdits(backend, edits) {
+    if (edits.length === 0)
+        throw new Error("At least one edit is required.");
+    const paths = new Set();
+    for (const edit of edits) {
+        for (const item of edit.mode === "rename"
+            ? [edit.path, edit.new_path]
+            : [edit.path]) {
+            if (paths.has(item))
+                throw new Error(`Conflicting edits target ${item}.`);
+            paths.add(item);
+        }
+    }
+    return Promise.all(edits.map((edit) => applyFileEdit(backend, edit)));
+}
+//# sourceMappingURL=apply.js.map

package/dist/core/filesystem/edits/apply.js.map

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

package/dist/core/filesystem/edits/types.d.ts

@@ -0,0 +1,28 @@
+export type FileEdit = {
+    path: string;
+    mode: "write";
+    content: string;
+    expected_sha256?: string;
+} | {
+    path: string;
+    mode: "edit";
+    content: string;
+    insert_at: number;
+    replace_until?: number | null;
+    expected_sha256?: string;
+} | {
+    path: string;
+    mode: "rename";
+    new_path: string;
+    expected_sha256?: string;
+} | {
+    path: string;
+    mode: "delete";
+    expected_sha256?: string;
+};
+export type EditResult = {
+    path: string;
+    mode: FileEdit["mode"];
+    changed: boolean;
+    new_path?: string;
+};

package/dist/core/filesystem/edits/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/filesystem/edits/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/filesystem/edits/types.ts"],"names":[],"mappings":""}

package/dist/core/filesystem/index.d.ts

@@ -0,0 +1,12 @@
+import type { FsBackend, TextReadOptions } from "./backend.js";
+import type { RemoteTextFsClient } from "./backends/remote-fs-backend.js";
+export type { FsBackend, RemoteFsBackendCapabilities, TextReadOptions, } from "./backend.js";
+export { LocalFsBackend, RemoteFsBackend } from "./backends/index.js";
+export type { RemoteTextFsClient } from "./backends/index.js";
+export { clearFsBackend, getFsBackend, setFsBackend } from "./registry.js";
+export type TextFsReadOptions = TextReadOptions;
+export type TextFsBackend = RemoteTextFsClient;
+export declare function setTextFsBackend(agent: object, backend: RemoteTextFsClient): void;
+export declare function getTextFsBackend(agent: object | undefined): FsBackend | undefined;
+export { applyFileEdit, applyFileEdits } from "./edits/apply.js";
+export type { EditResult, FileEdit } from "./edits/types.js";

package/dist/core/filesystem/index.js

@@ -0,0 +1,12 @@
+import { RemoteFsBackend } from "./backends/remote-fs-backend.js";
+import { getFsBackend, setFsBackend } from "./registry.js";
+export { LocalFsBackend, RemoteFsBackend } from "./backends/index.js";
+export { clearFsBackend, getFsBackend, setFsBackend } from "./registry.js";
+export function setTextFsBackend(agent, backend) {
+    setFsBackend(agent, new RemoteFsBackend(backend));
+}
+export function getTextFsBackend(agent) {
+    return agent ? getFsBackend(agent) : undefined;
+}
+export { applyFileEdit, applyFileEdits } from "./edits/apply.js";
+//# sourceMappingURL=index.js.map

package/dist/core/filesystem/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/filesystem/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAO3D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI3E,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,OAA2B;IAE3B,YAAY,CAAC,KAAK,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC;AACD,MAAM,UAAU,gBAAgB,CAC9B,KAAyB;IAEzB,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AACD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/filesystem/registry.d.ts

@@ -0,0 +1,4 @@
+import type { FsBackend } from "./backend.js";
+export declare function setFsBackend(agent: object, backend: FsBackend): void;
+export declare function getFsBackend(agent?: object): FsBackend;
+export declare function clearFsBackend(agent: object): void;

package/dist/core/filesystem/registry.js

@@ -0,0 +1,13 @@
+import { LocalFsBackend } from "./backends/local-fs-backend.js";
+const remoteBackends = new WeakMap();
+const localBackend = new LocalFsBackend();
+export function setFsBackend(agent, backend) {
+    remoteBackends.set(agent, backend);
+}
+export function getFsBackend(agent) {
+    return agent ? (remoteBackends.get(agent) ?? localBackend) : localBackend;
+}
+export function clearFsBackend(agent) {
+    remoteBackends.delete(agent);
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/filesystem/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/filesystem/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,MAAM,cAAc,GAAG,IAAI,OAAO,EAAqB,CAAC;AACxD,MAAM,YAAY,GAAG,IAAI,cAAc,EAAE,CAAC;AAE1C,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAkB;IAC5D,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/{tools/filesystem.d.ts → filesystem/tools.d.ts}

@@ -37,16 +37,48 @@ export declare function createFilesystemTools(): (import("@strands-agents/sdk").
     binary?: boolean | undefined;
 }, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
     path: string;
+    mode: "write";
     content: string;
-    append?: boolean | undefined;
-    create_parents?: boolean | undefined;
-}, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    expected_sha256?: string | undefined;
+} | {
+    path: string;
+    mode: "edit";
+    content: string;
+    insert_at: number;
+    replace_until?: number | null | undefined;
+    expected_sha256?: string | undefined;
+} | {
     path: string;
-    edits: {
-        oldText: string;
-        newText: string;
-    }[];
-    dry_run?: boolean | undefined;
+    mode: "rename";
+    new_path: string;
+    expected_sha256?: string | undefined;
+} | {
+    path: string;
+    mode: "delete";
+    expected_sha256?: string | undefined;
+}, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    edits: ({
+        path: string;
+        mode: "write";
+        content: string;
+        expected_sha256?: string | undefined;
+    } | {
+        path: string;
+        mode: "edit";
+        content: string;
+        insert_at: number;
+        replace_until?: number | null | undefined;
+        expected_sha256?: string | undefined;
+    } | {
+        path: string;
+        mode: "rename";
+        new_path: string;
+        expected_sha256?: string | undefined;
+    } | {
+        path: string;
+        mode: "delete";
+        expected_sha256?: string | undefined;
+    })[];
 }, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
     path: string;
     recursive?: boolean | undefined;