hoomanjs 1.18.0 → 1.18.1

package/dist/core/prompts/system.js

@@ -0,0 +1,164 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import handlebars from "handlebars";
+import { getEnvironmentPromptContext } from "./environment.js";
+const { compile } = handlebars;
+/** Bundled markdown next to this module (`prompts/static/`). */
+const STATIC_PROMPT_FILES = [
+    "identity.md",
+    "environment.md",
+    "ltm.md",
+    "todo.md",
+    "thinking.md",
+    "filesystem.md",
+    "fetch.md",
+    "web-search.md",
+    "shell.md",
+    "sleep.md",
+    "daemon.md",
+    "wiki.md",
+    "skills.md",
+    "subagents.md",
+];
+const HARNESS_PROMPT_FILES = [
+    { key: "behaviour", file: "behaviour.md" },
+    { key: "communication", file: "communication.md" },
+    { key: "execution", file: "execution.md" },
+    { key: "engineering", file: "engineering.md" },
+    { key: "guardrails", file: "guardrails.md" },
+];
+const SECTION_BREAK = "\n\n---\n\n";
+const EXTRA_CWD_INSTRUCTIONS = "AGENTS.md";
+/**
+ * Loads `prompts/static/*.md` from the package, then `instructions.md` from disk,
+ * concatenates them, and renders with Handlebars using `context`.
+ */
+export class System {
+    path;
+    config;
+    mode;
+    data = "";
+    constructor(path, config, mode = "default") {
+        this.path = path;
+        this.config = config;
+        this.mode = mode;
+    }
+    staticPromptFiles() {
+        return STATIC_PROMPT_FILES.filter((file) => {
+            switch (file) {
+                case "ltm.md":
+                    return this.config.tools.ltm.enabled;
+                case "fetch.md":
+                    return this.config.tools.fetch.enabled;
+                case "web-search.md":
+                    return this.config.search.enabled;
+                case "todo.md":
+                    return this.config.tools.todo.enabled;
+                case "filesystem.md":
+                    return this.config.tools.filesystem.enabled;
+                case "shell.md":
+                    return this.config.tools.shell.enabled;
+                case "sleep.md":
+                    return this.config.tools.sleep.enabled;
+                case "daemon.md":
+                    return this.mode === "daemon";
+                case "wiki.md":
+                    return this.config.tools.wiki.enabled;
+                case "skills.md":
+                    return this.config.tools.skills.enabled;
+                case "subagents.md":
+                    return this.config.tools.agents.enabled;
+                case "thinking.md":
+                default:
+                    return true;
+            }
+        });
+    }
+    readBundledStaticPrompts() {
+        const dir = join(dirname(fileURLToPath(import.meta.url)), "static");
+        const parts = [];
+        for (const file of this.staticPromptFiles()) {
+            const full = join(dir, file);
+            if (!existsSync(full)) {
+                continue;
+            }
+            const text = readFileSync(full, "utf8").trim();
+            if (text.length > 0) {
+                parts.push(text);
+            }
+        }
+        return parts.join("\n\n");
+    }
+    readBundledHarnessPrompts() {
+        const dir = join(dirname(fileURLToPath(import.meta.url)), "harness");
+        const parts = [];
+        for (const { key, file } of HARNESS_PROMPT_FILES) {
+            if (!this.config.prompts[key]) {
+                continue;
+            }
+            const full = join(dir, file);
+            if (!existsSync(full)) {
+                continue;
+            }
+            const text = readFileSync(full, "utf8").trim();
+            if (text.length > 0) {
+                parts.push(text);
+            }
+        }
+        return parts.join("\n\n");
+    }
+    readCwdAgentsInstructions() {
+        const path = join(process.cwd(), EXTRA_CWD_INSTRUCTIONS);
+        if (!existsSync(path)) {
+            return "";
+        }
+        return readFileSync(path, "utf8").trim();
+    }
+    readRawText() {
+        const instructions = existsSync(this.path)
+            ? readFileSync(this.path, "utf8").trim()
+            : "";
+        const bundled = this.readBundledStaticPrompts();
+        const harness = this.readBundledHarnessPrompts();
+        const extra = this.readCwdAgentsInstructions();
+        const blocks = [];
+        if (bundled.length > 0) {
+            blocks.push(bundled);
+        }
+        if (harness.length > 0) {
+            blocks.push(harness);
+        }
+        if (instructions.length > 0) {
+            blocks.push(instructions);
+        }
+        if (extra.length > 0) {
+            blocks.push(extra);
+        }
+        if (blocks.length === 0) {
+            return "";
+        }
+        return blocks.join(SECTION_BREAK);
+    }
+    get content() {
+        return this.data;
+    }
+    /** Plain object for Handlebars (`{{name}}`, `{{llm.model}}`, …). */
+    context() {
+        return {
+            name: this.config.name,
+            llm: this.config.llm,
+            environment: getEnvironmentPromptContext(),
+            ltm: this.config.tools.ltm,
+            wiki: this.config.tools.wiki,
+            compaction: this.config.compaction,
+            mode: this.mode,
+        };
+    }
+    async reload() {
+        const raw = this.readRawText();
+        const template = compile(raw);
+        this.data = template(this.context()).trim();
+    }
+}
+//# sourceMappingURL=system.js.map

package/dist/core/prompts/system.js.map

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

package/dist/core/skills/built-in/hooman-config/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: Hooman config
+description: Where hooman stores config, skills, and MCP; how to inspect or change them safely.
+---
+
+Use this skill when the user asks about **hooman** installation paths, config files, installed skills (Vercel `skills` CLI layout), or MCP server definitions.
+
+- Prefer reading existing files over guessing paths.
+- Do not remove or edit built-in skill sources under the package; they are not the same as user-installed skills under the agent data directory.

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

@@ -0,0 +1,2 @@
+export { Registry, create as createSkillsRegistry } from "./registry.js";
+export { create as createSkillsTools } from "./tools.js";

package/dist/core/skills/index.js

@@ -0,0 +1,3 @@
+export { Registry, create as createSkillsRegistry } from "./registry.js";
+export { create as createSkillsTools } from "./tools.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/skills/metadata.d.ts

@@ -0,0 +1,8 @@
+export type SkillMetadata = {
+    name: string;
+    description?: string;
+};
+/**
+ * Parse name and description from a SKILL.md file's YAML frontmatter.
+ */
+export declare function parseSkillFrontmatter(content: string, dirName: string): SkillMetadata;

package/dist/core/skills/metadata.js

@@ -0,0 +1,20 @@
+import matter from "gray-matter";
+/**
+ * Parse name and description from a SKILL.md file's YAML frontmatter.
+ */
+export function parseSkillFrontmatter(content, dirName) {
+    try {
+        const { data } = matter(content);
+        const name = typeof data?.name === "string" && data.name.trim()
+            ? data.name.trim()
+            : dirName;
+        const description = typeof data?.description === "string" && data.description.trim()
+            ? data.description.trim()
+            : undefined;
+        return { name, description };
+    }
+    catch {
+        return { name: dirName };
+    }
+}
+//# sourceMappingURL=metadata.js.map

package/dist/core/skills/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/core/skills/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAOjC;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,OAAe;IAEf,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,IAAI,GACR,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAChD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAClB,CAAC,CAAC,OAAO,CAAC;QACd,MAAM,WAAW,GACf,OAAO,IAAI,EAAE,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;YAC9D,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;YACzB,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,38 @@
+export type SkillListEntry = {
+    /** Display title (skill `name` from SKILL.md) */
+    name: string;
+    /** Full description read using gray-matter */
+    description?: string;
+    /** Absolute path to the skill package root from `skills list --json`. */
+    path: string;
+};
+export interface SkillSearchResult {
+    name: string;
+    slug: string;
+    source: string;
+    installs: number;
+}
+/**
+ * Install / list / delete skills via the Vercel [`skills` CLI](https://github.com/vercel-labs/skills)
+ * (`npx skills`), using OpenClaw scope (`./skills/`).
+ */
+export declare class Registry {
+    private readonly cwd;
+    constructor(cwd: string);
+    list(): Promise<SkillListEntry[]>;
+    /**
+     * `skills add <source> -y -a openclaw --copy` — supports owner/repo, Git URLs with tree paths, local paths, etc.
+     */
+    install(source: string): Promise<void>;
+    /**
+     * Remove by on-disk folder name (basename of `path` from `skills list --json`).
+     *
+     * We do **not** pass `--agent` so removal matches the CLI’s universal layout behavior.
+     */
+    delete(folder: string): Promise<void>;
+    /**
+     * Search the public catalog at skills.sh (same API as the `skills` CLI `find` command).
+     */
+    search(query: string): Promise<SkillSearchResult[]>;
+}
+export declare function create(cwd: string): Registry;

package/dist/core/skills/registry.js

@@ -0,0 +1,165 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { readFile, rm } from "node:fs/promises";
+import { basename, isAbsolute, join, resolve } from "node:path";
+import { parseSkillFrontmatter } from "./metadata.js";
+const execFileAsync = promisify(execFile);
+/** Vercel `skills` CLI package; uses latest every time. */
+const SKILLS_CLI = "skills@latest";
+/** Agent target for `skills add/list` — OpenClaw layout → `./skills/`. */
+const SKILLS_AGENT = "openclaw";
+const SKILLS_API_URL = "https://skills.sh";
+const NPX_BIN = process.platform === "win32" ? "npx.cmd" : "npx";
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+function stripAnsi(s) {
+    return s.replace(ANSI_RE, "");
+}
+async function runNpxSkills(args, options = {}) {
+    const { cwd, timeout = 300_000 } = options;
+    return execFileAsync(NPX_BIN, ["--yes", SKILLS_CLI, ...args], {
+        cwd,
+        maxBuffer: 20 * 1024 * 1024,
+        timeout,
+        env: { ...process.env, NO_COLOR: "1", FORCE_COLOR: "0" },
+    });
+}
+/**
+ * Install / list / delete skills via the Vercel [`skills` CLI](https://github.com/vercel-labs/skills)
+ * (`npx skills`), using OpenClaw scope (`./skills/`).
+ */
+export class Registry {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async list() {
+        let stdout;
+        try {
+            const r = await runNpxSkills(["list", "--json", "-a", SKILLS_AGENT], {
+                cwd: this.cwd,
+            });
+            stdout = r.stdout;
+        }
+        catch (e) {
+            const err = e;
+            const detail = err.stderr ?? err.message ?? String(e);
+            throw new Error(`skills list failed. Is Node/npm available?\n${stripAnsi(detail)}`);
+        }
+        const text = stdout.trim();
+        if (!text) {
+            return [];
+        }
+        let rows;
+        try {
+            rows = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`Unexpected skills list output (expected JSON):\n${text.slice(0, 500)}`);
+        }
+        if (!Array.isArray(rows)) {
+            return [];
+        }
+        const entries = [];
+        for (const row of rows) {
+            try {
+                const folder = basename(row.path);
+                const root = isAbsolute(row.path)
+                    ? resolve(row.path)
+                    : resolve(this.cwd, row.path);
+                const md = resolve(join(root, "SKILL.md"));
+                const raw = await readFile(md, "utf-8");
+                const { name, description } = parseSkillFrontmatter(raw, folder);
+                entries.push({
+                    name,
+                    description,
+                    path: md,
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+        return entries;
+    }
+    /**
+     * `skills add <source> -y -a openclaw --copy` — supports owner/repo, Git URLs with tree paths, local paths, etc.
+     */
+    async install(source) {
+        const raw = source.trim();
+        if (!raw) {
+            throw new Error("Enter a skill source (e.g. owner/repo or a GitHub URL).");
+        }
+        try {
+            await runNpxSkills(["add", raw, "-y", "-a", SKILLS_AGENT, "--copy"], {
+                cwd: this.cwd,
+                timeout: 600_000,
+            });
+        }
+        catch (e) {
+            const err = e;
+            const detail = stripAnsi(err.stderr || err.stdout || err.message || String(e));
+            throw new Error(`skills add failed:\n${detail}`);
+        }
+    }
+    /**
+     * Remove by on-disk folder name (basename of `path` from `skills list --json`).
+     *
+     * We do **not** pass `--agent` so removal matches the CLI’s universal layout behavior.
+     */
+    async delete(folder) {
+        const safe = folder.trim();
+        if (!safe || /[\\/]/.test(safe) || safe.includes("..")) {
+            throw new Error("Invalid skill name.");
+        }
+        try {
+            await runNpxSkills(["remove", safe, "-y"], { cwd: this.cwd });
+        }
+        catch (e) {
+            const err = e;
+            const detail = stripAnsi(err.stderr || err.stdout || err.message || String(e));
+            throw new Error(`skills remove failed:\n${detail}`);
+        }
+        await rm(join(this.cwd, "skills", safe), {
+            recursive: true,
+            force: true,
+        }).catch(() => { });
+    }
+    /**
+     * Search the public catalog at skills.sh (same API as the `skills` CLI `find` command).
+     */
+    async search(query) {
+        const q = query.trim();
+        if (!q) {
+            throw new Error("Enter a search term for the skills catalog.");
+        }
+        if (q.length < 2) {
+            throw new Error("Use at least 2 characters to search.");
+        }
+        try {
+            const url = `${SKILLS_API_URL}/api/search?q=${encodeURIComponent(q)}&limit=10`;
+            const res = await fetch(url);
+            if (!res.ok) {
+                return [];
+            }
+            const data = (await res.json());
+            if (!Array.isArray(data.skills)) {
+                throw new Error("Skills search did not return .skills[] in response");
+            }
+            return data.skills
+                .map((skill) => ({
+                name: skill.name,
+                slug: `${skill.source.trim()}@${skill.skillId.trim()}`,
+                source: skill.source || "",
+                installs: skill.installs,
+            }))
+                .sort((a, b) => (b.installs || 0) - (a.installs || 0));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+export function create(cwd) {
+    return new Registry(cwd);
+}
+//# sourceMappingURL=registry.js.map

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

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

package/dist/core/skills/tools.d.ts

@@ -0,0 +1,9 @@
+import type { JSONValue } from "@strands-agents/sdk";
+import type { Registry } from "./registry.js";
+export declare function create(registry: Registry): (import("@strands-agents/sdk").InvokableTool<Record<string, never>, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    query: string;
+}, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    source: string;
+}, JSONValue> | import("@strands-agents/sdk").InvokableTool<{
+    folder: string;
+}, JSONValue>)[];

package/dist/core/skills/tools.js

@@ -0,0 +1,73 @@
+import { tool } from "@strands-agents/sdk";
+import { z } from "zod";
+function toJsonValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function create(registry) {
+    return [
+        tool({
+            name: "list_skills",
+            description: "List currently installed skills available to the local agent.",
+            inputSchema: z.object({}),
+            callback: async () => {
+                const skills = await registry.list();
+                return toJsonValue({
+                    count: skills.length,
+                    skills,
+                });
+            },
+        }),
+        tool({
+            name: "search_skills",
+            description: "Search the public skills catalog for skills matching a query.",
+            inputSchema: z.object({
+                query: z
+                    .string()
+                    .min(2)
+                    .describe("Search query for the public skills catalog."),
+            }),
+            callback: async (input) => {
+                const results = await registry.search(input.query);
+                return toJsonValue({
+                    count: results.length,
+                    results,
+                });
+            },
+        }),
+        tool({
+            name: "install_skill",
+            description: "Install a skill from a source such as owner/repo, a GitHub URL, or a local path.",
+            inputSchema: z.object({
+                source: z
+                    .string()
+                    .min(1)
+                    .describe("Skill source to install (repo, URL, or local path)."),
+            }),
+            callback: async (input) => {
+                await registry.install(input.source);
+                return toJsonValue({
+                    installed: true,
+                    source: input.source,
+                });
+            },
+        }),
+        tool({
+            name: "delete_skill",
+            description: "Delete an installed skill by its folder name under the local skills directory.",
+            inputSchema: z.object({
+                folder: z
+                    .string()
+                    .min(1)
+                    .describe("Installed skill folder name to remove."),
+            }),
+            callback: async (input) => {
+                await registry.delete(input.folder);
+                return toJsonValue({
+                    deleted: true,
+                    folder: input.folder,
+                });
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/core/skills/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/core/skills/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAc,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,QAAkB;IACvC,OAAO;QACL,IAAI,CAAC;YACH,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,+DAA+D;YACjE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACnB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACrC,OAAO,WAAW,CAAC;oBACjB,KAAK,EAAE,MAAM,CAAC,MAAM;oBACpB,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,IAAI,CAAC;YACH,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,+DAA+D;YACjE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,CAAC;qBACL,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CAAC,6CAA6C,CAAC;aAC3D,CAAC;YACF,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACxB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACnD,OAAO,WAAW,CAAC;oBACjB,KAAK,EAAE,OAAO,CAAC,MAAM;oBACrB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,IAAI,CAAC;YACH,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,kFAAkF;YACpF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,MAAM,EAAE,CAAC;qBACN,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CAAC,qDAAqD,CAAC;aACnE,CAAC;YACF,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACxB,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACrC,OAAO,WAAW,CAAC;oBACjB,SAAS,EAAE,IAAI;oBACf,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC,CAAC;YACL,CAAC;SACF,CAAC;QACF,IAAI,CAAC;YACH,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,gFAAgF;YAClF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,MAAM,EAAE,CAAC;qBACN,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,QAAQ,CAAC,wCAAwC,CAAC;aACtD,CAAC;YACF,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACxB,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACpC,OAAO,WAAW,CAAC;oBACjB,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,KAAK,CAAC,MAAM;iBACrB,CAAC,CAAC;YACL,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/core/state/file-tool-display.d.ts

@@ -0,0 +1,20 @@
+import type { JSONValue } from "@strands-agents/sdk";
+export type StructuredPatchHunk = {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: string[];
+};
+export type FileToolDisplay = {
+    previews?: string[];
+    structuredPatch?: StructuredPatchHunk[];
+};
+type DisplayStateStore = {
+    get(key: string): JSONValue | undefined;
+    set(key: string, value: unknown): void;
+    delete(key: string): void;
+};
+export declare function setFileToolDisplay(appState: DisplayStateStore, toolUseId: string | undefined, display: FileToolDisplay): void;
+export declare function takeFileToolDisplay(appState: DisplayStateStore, toolUseId: string | null): FileToolDisplay | undefined;
+export {};

package/dist/core/state/file-tool-display.js

@@ -0,0 +1,35 @@
+const FILE_TOOL_DISPLAY_STATE_KEY = "fileToolDisplay";
+function readDisplayState(appState) {
+    const value = appState.get(FILE_TOOL_DISPLAY_STATE_KEY);
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function setFileToolDisplay(appState, toolUseId, display) {
+    if (!toolUseId) {
+        return;
+    }
+    appState.set(FILE_TOOL_DISPLAY_STATE_KEY, {
+        ...readDisplayState(appState),
+        [toolUseId]: display,
+    });
+}
+export function takeFileToolDisplay(appState, toolUseId) {
+    if (!toolUseId) {
+        return undefined;
+    }
+    const state = readDisplayState(appState);
+    const display = state[toolUseId];
+    if (!display) {
+        return undefined;
+    }
+    const { [toolUseId]: _removed, ...nextState } = state;
+    if (Object.keys(nextState).length === 0) {
+        appState.delete(FILE_TOOL_DISPLAY_STATE_KEY);
+    }
+    else {
+        appState.set(FILE_TOOL_DISPLAY_STATE_KEY, nextState);
+    }
+    return display;
+}
+//# sourceMappingURL=file-tool-display.js.map

package/dist/core/state/file-tool-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tool-display.js","sourceRoot":"","sources":["../../../src/core/state/file-tool-display.ts"],"names":[],"mappings":"AAEA,MAAM,2BAA2B,GAAG,iBAAiB,CAAC;AAqBtD,SAAS,gBAAgB,CACvB,QAA2B;IAE3B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACxD,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAyC;QAC5C,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,SAA6B,EAC7B,OAAwB;IAExB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,GAAG,CAAC,2BAA2B,EAAE;QACxC,GAAG,gBAAgB,CAAC,QAAQ,CAAC;QAC7B,CAAC,SAAS,CAAC,EAAE,OAAO;KACrB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAA2B,EAC3B,SAAwB;IAExB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,GAAG,CAAC,2BAA2B,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/state/thought-process.d.ts

@@ -0,0 +1,18 @@
+import type { ToolContext } from "@strands-agents/sdk";
+export type ThoughtEntry = {
+    thought: string;
+    thoughtNumber: number;
+    totalThoughts: number;
+    nextThoughtNeeded: boolean;
+    isRevision: boolean;
+    revisesThought: number | null;
+    branchFromThought: number | null;
+    branchId: string | null;
+    needsMoreThoughts: boolean;
+};
+export type ThinkingState = {
+    history: ThoughtEntry[];
+    branches: string[];
+};
+export declare function readThinkingState(context: ToolContext): ThinkingState;
+export declare function writeThinkingState(context: ToolContext, state: ThinkingState): void;

package/dist/core/state/thought-process.js

@@ -0,0 +1,21 @@
+const THINKING_STATE_KEY = "thinking.sequential";
+function isThinkingState(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        !Array.isArray(value) &&
+        "history" in value &&
+        "branches" in value &&
+        Array.isArray(value.history) &&
+        Array.isArray(value.branches));
+}
+export function readThinkingState(context) {
+    const current = context.agent.appState.get(THINKING_STATE_KEY);
+    if (isThinkingState(current)) {
+        return current;
+    }
+    return { history: [], branches: [] };
+}
+export function writeThinkingState(context, state) {
+    context.agent.appState.set(THINKING_STATE_KEY, state);
+}
+//# sourceMappingURL=thought-process.js.map

package/dist/core/state/thought-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought-process.js","sourceRoot":"","sources":["../../../src/core/state/thought-process.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAmBjD,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,SAAS,IAAI,KAAK;QAClB,UAAU,IAAI,KAAK;QACnB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAoB;IACpD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAE/D,IAAI,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAoB,EACpB,KAAoB;IAEpB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}