@oharness/engine 0.5.0 → 0.6.0

package/dist/tools/builtin/ask.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { defineTool } from "../define.js";
+import { ASK_USER_TOOL, describeResult } from "../questions.js";
+const OptionSchema = z.object({
+    label: z.string().trim().min(1).max(80).describe("What the user clicks; 1-5 words"),
+    description: z.string().trim().max(300).optional().describe("What choosing this means, or its trade-off"),
+    preview: z
+        .string()
+        .max(4000)
+        .optional()
+        .describe("Optional code, layout or snippet shown while this option is focused"),
+});
+const QuestionSchema = z
+    .object({
+    header: z.string().trim().min(1).max(16).describe("Very short tag shown on the card, e.g. \"Database\""),
+    question: z.string().trim().min(1).max(500).describe("The full question, ending with a question mark"),
+    multiSelect: z.boolean().default(false).describe("Allow more than one option to be chosen"),
+    options: z.array(OptionSchema).min(2).max(4).describe("2-4 distinct choices; an \"Other\" field is always added"),
+})
+    .refine((question) => new Set(question.options.map((option) => option.label)).size === question.options.length, {
+    message: "option labels must be unique",
+    path: ["options"],
+});
+/**
+ * Stops the turn on a question only a person can answer.
+ *
+ * Read-only on purpose: asking changes nothing, so it needs no approval, and
+ * plan mode — which refuses everything else that is not read-only — is exactly
+ * when clarifying before committing to a plan is most useful. An explicit deny
+ * rule still turns it off for anyone who wants the agent fully autonomous.
+ */
+export const askUserTool = defineTool({
+    name: ASK_USER_TOOL,
+    description: [
+        "Ask the user 1-4 multiple-choice questions and wait for the answer.",
+        "Use it only when the answer changes what you do next and cannot be found in the code, the configuration, or a sensible default.",
+        "Do not ask for facts you can look up, and do not ask \"should I proceed?\" or \"is this plan OK?\".",
+        "Put related questions in one call rather than asking several times in a row.",
+        "If you recommend an option, list it first and end its label with \"(Recommended)\".",
+        "Never add an \"Other\" option yourself: the user can always type their own answer.",
+        "In plan mode, use this to clarify requirements before presenting the plan.",
+    ].join(" "),
+    parameters: z.object({
+        questions: z.array(QuestionSchema).min(1).max(4).describe("The questions, in the order they should be answered"),
+    }),
+    readOnly: true,
+    // One card at a time: a second question racing the first would leave the
+    // person answering in whichever order the frontend happened to draw them.
+    concurrencySafe: false,
+    renderTitle: (input) => input.questions.length === 1 ? `Ask(${input.questions[0].header})` : `Ask(${input.questions.length} questions)`,
+    async execute(input, ctx) {
+        const questions = input.questions.map((question, index) => ({
+            id: `q${index + 1}`,
+            header: question.header,
+            question: question.question,
+            multiSelect: question.multiSelect,
+            options: question.options.map((option) => ({
+                label: option.label,
+                ...(option.description ? { description: option.description } : {}),
+                ...(option.preview ? { preview: option.preview } : {}),
+            })),
+        }));
+        const result = ctx.ask ? await ctx.ask(questions) : { outcome: "unavailable" };
+        return {
+            content: [{ type: "text", text: describeResult(questions, result) }],
+            isError: result.outcome === "unavailable" || result.outcome === "aborted",
+            metadata: { questions, result },
+        };
+    },
+});
+//# sourceMappingURL=ask.js.map

package/dist/tools/builtin/ask.js.map

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

package/dist/tools/builtin/index.d.ts

@@ -1,4 +1,5 @@
 import type { Tool } from "../types.ts";
+export { askUserTool } from "./ask.ts";
 export { bashTool } from "./bash.ts";
 export { artifactTool, artifactReadTool, artifactTools, ARTIFACT_METADATA_KEY } from "./artifact.ts";
 export { readTool, writeTool, editTool, listTool, fileTools, resolvePath } from "./fs.ts";

package/dist/tools/builtin/index.js

@@ -4,6 +4,8 @@ import { globTool, grepTool, searchTools } from "./search.js";
 import { recallTool } from "./recall.js";
 import { todoTool } from "./todo.js";
 import { artifactReadTool, artifactTool, artifactTools } from "./artifact.js";
+import { askUserTool } from "./ask.js";
+export { askUserTool } from "./ask.js";
 export { bashTool } from "./bash.js";
 export { artifactTool, artifactReadTool, artifactTools, ARTIFACT_METADATA_KEY } from "./artifact.js";
 export { readTool, writeTool, editTool, listTool, fileTools, resolvePath } from "./fs.js";
@@ -21,6 +23,7 @@ export const builtinTools = [
     bashTool,
     recallTool,
     todoTool,
+    askUserTool,
     ...artifactTools,
 ];
 /**

package/dist/tools/builtin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,GAAG,SAAS;IACZ,GAAG,WAAW;IACd,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,GAAG,aAAa;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,gBAAgB;CACjB,CAAC;AAEF,KAAK,SAAS,CAAC;AACf,KAAK,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,GAAG,SAAS;IACZ,GAAG,WAAW;IACd,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,WAAW;IACX,GAAG,aAAa;CACjB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,gBAAgB;CACjB,CAAC;AAEF,KAAK,SAAS,CAAC;AACf,KAAK,QAAQ,CAAC"}

package/dist/tools/builtin/memory.d.ts

@@ -1,10 +1,10 @@
-import type { MemoryStore } from "../../agent/memory.ts";
+import type { MemoryStore, MemoryStores } from "../../agent/memory.ts";
 import type { Tool } from "../types.ts";
 /**
- * Read and write the agent's durable notes.
+ * Read, write and delete the agent's durable notes.
  *
- * Split into two tools rather than one with a `mode` argument: writing a note
- * is a decision the model should make deliberately, and a single tool whose
+ * Separate tools rather than one with a `mode` argument: writing a note is a
+ * decision the model should make deliberately, and a single tool whose
  * behaviour flips on a string is one the model gets wrong under pressure.
  */
-export declare function createMemoryTools(memory: MemoryStore): Tool[];
+export declare function createMemoryTools(memory: MemoryStore | MemoryStores): Tool[];

package/dist/tools/builtin/memory.js

@@ -1,76 +1,187 @@
 import { z } from "zod";
+import { findScoped, loadScoped, memoryNote, storeFor } from "../../agent/memory.js";
+import { backupNote } from "../../agent/memory-backup.js";
+import { MEMORY_SCOPES, MEMORY_TYPES, defaultScopeFor } from "../../agent/memory-limits.js";
+import { extractLinks } from "../../agent/memory-links.js";
+import { rankNotes } from "../../agent/memory-recall.js";
+import { findSecrets } from "../../agent/memory-redact.js";
 import { defineTool } from "../define.js";
 import { toolError, toolText } from "../types.js";
 /**
- * Read and write the agent's durable notes.
+ * Read, write and delete the agent's durable notes.
  *
- * Split into two tools rather than one with a `mode` argument: writing a note
- * is a decision the model should make deliberately, and a single tool whose
+ * Separate tools rather than one with a `mode` argument: writing a note is a
+ * decision the model should make deliberately, and a single tool whose
  * behaviour flips on a string is one the model gets wrong under pressure.
  */
 export function createMemoryTools(memory) {
+    const stores = "project" in memory && !("load" in memory) ? memory : { project: memory };
     const read = defineTool({
         name: "memory",
         readOnly: true,
         description: "Read notes recorded in earlier sessions. Call with an id from the memory index " +
-            "in the system prompt to read one in full, or with a query to search. The index " +
-            "shows summaries only — read the note before relying on it.",
+            "in the system prompt, or from a <recalled-memory> block, to read one in full with " +
+            "the notes it links to and the notes that link to it. Call with a query to search. " +
+            "The index shows summaries only — read the note before relying on it.",
         parameters: z.object({
             id: z.string().optional().describe("Note id to read in full"),
             query: z.string().optional().describe("Text to search summaries, bodies and tags for"),
         }),
         renderTitle: (input) => `Memory(${input.id ?? input.query ?? "all"})`,
         async execute(input) {
-            const entries = await memory.load();
-            if (entries.length === 0) {
+            const { notes, links } = await loadScoped(stores);
+            if (notes.length === 0)
                 return toolText("No notes have been recorded yet.");
-            }
             if (input.id) {
-                const entry = entries.find((candidate) => candidate.id === input.id);
-                if (!entry) {
-                    return toolError(`No note with id "${input.id}". Known ids: ${entries.map((e) => e.id).join(", ")}`);
+                const note = findScoped(notes, input.id);
+                if (!note) {
+                    const near = rankNotes(notes, input.id.replace(/[-_]/g, " ")).slice(0, 5);
+                    return toolError(`No note with id "${input.id}".` +
+                        (near.length ? ` Closest: ${near.map((entry) => `\`${entry.note.id}\``).join(", ")}` : ""));
                 }
-                return toolText(render(entry));
+                const summaryOf = (id) => findScoped(notes, id)?.summary ?? "";
+                const sections = [render(note)];
+                const outgoing = links.outgoing.get(note.id) ?? [];
+                const incoming = links.incoming.get(note.id) ?? [];
+                const dangling = links.dangling.get(note.id) ?? [];
+                if (outgoing.length)
+                    sections.push(`Links to:\n${outgoing.map((id) => `- \`${id}\` — ${summaryOf(id)}`).join("\n")}`);
+                if (incoming.length)
+                    sections.push(`Linked from:\n${incoming.map((id) => `- \`${id}\` — ${summaryOf(id)}`).join("\n")}`);
+                if (dangling.length)
+                    sections.push(`Links to notes that do not exist yet: ${dangling.map((id) => `\`${id}\``).join(", ")}`);
+                return toolText(sections.join("\n\n"));
             }
-            const matches = input.query ? await memory.search(input.query) : entries;
-            if (matches.length === 0) {
-                return toolText(`No note matches "${input.query}".`);
+            let matches;
+            if (input.query) {
+                matches = rankNotes(notes, input.query).map((entry) => entry.note);
+                if (!matches.length) {
+                    const needle = input.query.toLowerCase();
+                    matches = notes.filter((note) => note.summary.toLowerCase().includes(needle) || note.body.toLowerCase().includes(needle) ||
+                        note.tags.some((tag) => tag.toLowerCase().includes(needle)) || note.id.toLowerCase().includes(needle));
+                }
             }
-            return toolText(matches.slice(0, 10).map(render).join("\n\n---\n\n"), {
-                matched: matches.length,
-            });
+            else {
+                matches = [...notes].sort((a, b) => (b.updatedAt ?? b.createdAt) - (a.updatedAt ?? a.createdAt));
+            }
+            if (matches.length === 0)
+                return toolText(`No note matches "${input.query}".`);
+            return toolText(matches.slice(0, 10).map(render).join("\n\n---\n\n"), { matched: matches.length });
         },
     });
     const write = defineTool({
         name: "remember",
-        description: "Record something worth carrying into future sessions — a correction, a convention " +
-            "this project follows, an approach that worked. Do not record what the code or git " +
-            "history already says, or anything that only matters to the current task. Writing " +
-            "the same summary again updates the existing note rather than adding a duplicate.",
+        description: "Record something worth carrying into future sessions — a correction, a preference, a " +
+            "convention this project follows, a decision and why, where something external lives. " +
+            "Do not record what the code or git history already says, anything that only matters to " +
+            "the current task, or credentials. The summary is what later messages are matched against, " +
+            "so write it as one concrete line naming the subject, and put the other words someone might use " +
+            "for it in `tags`: synonyms and the term in the other language in use. Pass `id` to update a specific note; " +
+            "writing the same summary again also updates rather than duplicates. The result lists " +
+            "related existing notes: update one of those instead when it covers the same thing, and " +
+            "link the rest from the body as [[note-id]].",
         parameters: z.object({
-            summary: z
-                .string()
-                .min(4)
-                .describe("One line naming the lesson; this is what appears in the index"),
-            body: z
-                .string()
-                .min(4)
-                .describe("The note itself: what was learned, why it matters, how to apply it"),
-            tags: z.array(z.string()).optional().describe("Tags to help find it later"),
+            summary: z.string().min(4).describe("One concrete line naming the lesson; matched against future messages"),
+            body: z.string().min(4).describe("The note itself: the fact, why it matters, how to apply it. Link related notes as [[note-id]]"),
+            type: z.enum(MEMORY_TYPES).optional().describe("user: who the user is and how they like to work. feedback: a correction or a confirmed approach. " +
+                "project: a decision, constraint or piece of ongoing work not derivable from the code. reference: where external information lives"),
+            scope: z.enum(MEMORY_SCOPES).optional().describe("user: holds in every project. project: tied to this codebase. Defaults to user for user notes and project otherwise; " +
+                "choose user for feedback only when it plainly applies to every project"),
+            id: z.string().optional().describe("Existing note id to update"),
+            tags: z.array(z.string()).optional().describe("Words to find it by beyond the summary's own: synonyms and the other language's term, e.g. border, 边框, 描边. Recall matches words, not meaning"),
         }),
         renderTitle: (input) => `Remember(${input.summary.slice(0, 40)})`,
         async execute(input) {
-            const entry = await memory.remember(input);
-            return toolText(`Recorded as \`${entry.id}\`.`, { id: entry.id, file: entry.file });
+            const secrets = findSecrets(`${input.summary}\n${input.body}`);
+            if (secrets.length) {
+                return toolError(`Not recorded: the note contains what looks like a credential (${secrets.join(", ")}). Notes sync and are shown to future sessions; describe where the secret lives instead of including it.`);
+            }
+            const { notes } = await loadScoped(stores);
+            let scope;
+            let targetId;
+            if (input.id) {
+                const existing = findScoped(notes, input.id);
+                if (!existing)
+                    return toolError(`No note with id "${input.id}" to update.`);
+                scope = existing.scope;
+                targetId = existing.id;
+            }
+            else {
+                scope = input.scope ?? defaultScopeFor(input.type);
+                if (scope === "user" && !stores.user)
+                    scope = "project";
+            }
+            let entry;
+            try {
+                entry = await storeFor(stores, scope).remember({
+                    summary: input.summary, body: input.body,
+                    ...(input.tags ? { tags: input.tags } : {}),
+                    ...(input.type ? { type: input.type } : {}),
+                    ...(targetId ? { id: targetId } : {}),
+                });
+            }
+            catch (error) {
+                return toolError(error instanceof Error ? error.message : String(error));
+            }
+            const lines = [`Recorded as \`${entry.id}\` (${[scope, entry.type].filter(Boolean).join(" · ")}).`];
+            const others = notes.filter((note) => note.id !== entry.id);
+            const related = rankNotes(others, `${entry.summary}\n${entry.body}`)
+                .filter((candidate) => candidate.strong > 0)
+                .slice(0, 3);
+            if (related.length) {
+                const top = related[0];
+                lines.push("", "Related notes — if one covers the same thing, update it with its `id` and forget this one; otherwise link them as [[note-id]]:");
+                for (const candidate of related) {
+                    const flag = candidate === top && sameSubject(candidate.note.summary, entry.summary) ? " (possible duplicate)" : "";
+                    lines.push(`- \`${candidate.note.id}\` — ${candidate.note.summary}${flag}`);
+                }
+            }
+            const known = new Set(notes.map((note) => note.id));
+            const dangling = extractLinks(entry.body).filter((id) => !known.has(id) && id !== entry.id);
+            if (dangling.length)
+                lines.push("", `Links to notes that do not exist yet: ${dangling.map((id) => `\`${id}\``).join(", ")}`);
+            return toolText(lines.join("\n"), { id: entry.id, file: entry.file, scope });
         },
     });
-    return [read, write];
+    const forget = defineTool({
+        name: "forget",
+        description: "Delete a memory note that turned out to be wrong or no longer applies. A backup is kept " +
+            "on this machine. Prefer updating a note with `remember` when it is only partly out of date.",
+        parameters: z.object({
+            id: z.string().describe("Id of the note to delete"),
+        }),
+        renderTitle: (input) => `Forget(${input.id})`,
+        async execute(input) {
+            const { notes, links } = await loadScoped(stores);
+            const note = findScoped(notes, input.id);
+            if (!note)
+                return toolError(`No note with id "${input.id}".`);
+            const store = storeFor(stores, note.scope);
+            await backupNote(store, memoryNote(note.entry), "forget");
+            await store.forget(note.id);
+            const incoming = links.incoming.get(note.id) ?? [];
+            return toolText(`Deleted \`${note.id}\`.` +
+                (incoming.length ? ` ${incoming.length} note${incoming.length === 1 ? "" : "s"} still link to it: ${incoming.map((id) => `\`${id}\``).join(", ")}.` : ""));
+        },
+    });
+    return [read, write, forget];
+}
+function sameSubject(a, b) {
+    const words = (value) => new Set(value.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((word) => word.length > 1));
+    const left = words(a);
+    const right = words(b);
+    if (!left.size || !right.size)
+        return false;
+    let shared = 0;
+    for (const word of left)
+        if (right.has(word))
+            shared++;
+    return shared / Math.min(left.size, right.size) >= 0.6;
 }
-function render(entry) {
-    const when = entry.createdAt
-        ? new Date(entry.createdAt).toISOString().slice(0, 10)
-        : "unknown date";
-    const tags = entry.tags.length > 0 ? ` · ${entry.tags.join(", ")}` : "";
-    return `### ${entry.id} (${when}${tags})\n${entry.summary}\n\n${entry.body}`;
+function render(note) {
+    const when = note.createdAt ? new Date(note.createdAt).toISOString().slice(0, 10) : "unknown date";
+    const updated = note.updatedAt && note.updatedAt !== note.createdAt ? `, updated ${new Date(note.updatedAt).toISOString().slice(0, 10)}` : "";
+    const labels = [note.scope, note.type, ...note.tags].filter(Boolean).join(", ");
+    return `### ${note.id} (${when}${updated} · ${labels})\n${note.summary}\n\n${note.body}`;
 }
 //# sourceMappingURL=memory.js.map

package/dist/tools/builtin/memory.js.map

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

package/dist/tools/index.d.ts

@@ -4,4 +4,6 @@ export { ToolRegistry, matchesFilter, matchPattern } from "./registry.ts";
 export type { ToolFilter } from "./registry.ts";
 export { toolText, toolError, toolImage, toolResultText } from "./types.ts";
 export type { SubagentRunOptions, SubagentRunResult, Tool, ToolContent, ToolContext, ToolHost, ToolProgress, ToolResult, } from "./types.ts";
+export { ASK_USER_TOOL, QUESTION_TEXT_LIMIT, checkAnswer, describeResult, picksFromNumbers } from "./questions.ts";
+export type { Question, QuestionOption, QuestionPick, QuestionPrompt, QuestionRequest, QuestionResult, } from "./questions.ts";
 export * from "./builtin/index.ts";

package/dist/tools/index.js

@@ -1,5 +1,6 @@
 export { defineTool } from "./define.js";
 export { ToolRegistry, matchesFilter, matchPattern } from "./registry.js";
 export { toolText, toolError, toolImage, toolResultText } from "./types.js";
+export { ASK_USER_TOOL, QUESTION_TEXT_LIMIT, checkAnswer, describeResult, picksFromNumbers } from "./questions.js";
 export * from "./builtin/index.js";
 //# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAW5E,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE1E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAW5E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AASnH,cAAc,oBAAoB,CAAC"}

package/dist/tools/questions.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Questions a tool puts to the person running the agent.
+ *
+ * Lives in the tool layer rather than beside the permission engine because the
+ * `ask_user` tool builds these and the tool layer never imports the agent. The
+ * agent only carries them from a tool to whatever frontend can answer.
+ */
+export interface QuestionOption {
+    label: string;
+    description?: string;
+    /** Shown beside the options while this one is focused — code, a layout, a snippet. */
+    preview?: string;
+}
+export interface Question {
+    /** `q1`..`q4`, in the order asked. Answers are keyed by it. */
+    id: string;
+    /** A short tag for the card, e.g. "Database". */
+    header: string;
+    question: string;
+    multiSelect: boolean;
+    options: QuestionOption[];
+}
+export interface QuestionRequest {
+    /** The tool call asking, which is also what a frontend pairs the answer with. */
+    id: string;
+    sessionId: string;
+    agentId: string;
+    questions: Question[];
+}
+export interface QuestionPick {
+    /** Labels of the chosen options, exactly as offered. */
+    selected: string[];
+    /** Free text from the "other" field, which every question has. */
+    other?: string;
+}
+/**
+ * How a question ended.
+ *
+ * `dismissed` is a person deciding not to choose; `unavailable` is there being
+ * nobody to ask; `aborted` is the turn stopping underneath the question. They
+ * read differently to the model, which is told to do different things after
+ * each, so they are not folded together.
+ */
+export type QuestionResult = {
+    outcome: "answered";
+    answers: Record<string, QuestionPick>;
+} | {
+    outcome: "dismissed";
+    note?: string;
+} | {
+    outcome: "unavailable";
+} | {
+    outcome: "aborted";
+};
+/**
+ * Puts questions to a person. The signal fires when the turn is interrupted;
+ * a frontend should take the card down then rather than leave it answerable.
+ */
+export type QuestionPrompt = (request: QuestionRequest, signal: AbortSignal) => Promise<QuestionResult>;
+export declare const ASK_USER_TOOL = "ask_user";
+/** The longest free-text answer or dismissal note carried back to the model. */
+export declare const QUESTION_TEXT_LIMIT = 2000;
+/**
+ * An answer from outside the process, checked against what was asked.
+ *
+ * Frontends post whatever their page sent, so a label is only accepted if it
+ * was one of the options, a single-choice question gets one pick, and every
+ * question has something. Returns a reason instead when it does not hold up.
+ */
+export declare function checkAnswer(questions: readonly Question[], raw: unknown): {
+    ok: true;
+    result: QuestionResult;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Options picked by number, for frontends that read a line of text: "1,3" or
+ * "1 3". Numbers that name no option are dropped rather than guessed at.
+ */
+export declare function picksFromNumbers(question: Question, text: string): string[];
+/**
+ * What the model reads back.
+ *
+ * Each outcome says what to do next, because a bare "dismissed" is an
+ * invitation to guess the answer anyway — which is the one thing asking was
+ * meant to prevent.
+ */
+export declare function describeResult(questions: readonly Question[], result: QuestionResult): string;

package/dist/tools/questions.js

@@ -0,0 +1,97 @@
+/**
+ * Questions a tool puts to the person running the agent.
+ *
+ * Lives in the tool layer rather than beside the permission engine because the
+ * `ask_user` tool builds these and the tool layer never imports the agent. The
+ * agent only carries them from a tool to whatever frontend can answer.
+ */
+export const ASK_USER_TOOL = "ask_user";
+/** The longest free-text answer or dismissal note carried back to the model. */
+export const QUESTION_TEXT_LIMIT = 2000;
+/**
+ * An answer from outside the process, checked against what was asked.
+ *
+ * Frontends post whatever their page sent, so a label is only accepted if it
+ * was one of the options, a single-choice question gets one pick, and every
+ * question has something. Returns a reason instead when it does not hold up.
+ */
+export function checkAnswer(questions, raw) {
+    if (typeof raw !== "object" || raw === null)
+        return { ok: false, error: "answer must be an object" };
+    const body = raw;
+    if (body["outcome"] === "dismissed") {
+        const note = typeof body["note"] === "string" ? body["note"].trim().slice(0, QUESTION_TEXT_LIMIT) : "";
+        return { ok: true, result: note ? { outcome: "dismissed", note } : { outcome: "dismissed" } };
+    }
+    if (body["outcome"] !== "answered")
+        return { ok: false, error: "outcome must be answered or dismissed" };
+    const given = body["answers"];
+    if (typeof given !== "object" || given === null)
+        return { ok: false, error: "answers are required" };
+    const answers = {};
+    for (const question of questions) {
+        const entry = given[question.id];
+        if (typeof entry !== "object" || entry === null)
+            return { ok: false, error: `${question.id} is unanswered` };
+        const pick = entry;
+        const selected = Array.isArray(pick["selected"])
+            ? [...new Set(pick["selected"].filter((label) => typeof label === "string"))]
+            : [];
+        const offered = new Set(question.options.map((option) => option.label));
+        const unknown = selected.find((label) => !offered.has(label));
+        if (unknown !== undefined)
+            return { ok: false, error: `${question.id}: "${unknown}" was not an option` };
+        const other = typeof pick["other"] === "string" ? pick["other"].trim().slice(0, QUESTION_TEXT_LIMIT) : "";
+        if (!question.multiSelect && selected.length + (other ? 1 : 0) > 1) {
+            return { ok: false, error: `${question.id} takes one answer` };
+        }
+        if (!selected.length && !other)
+            return { ok: false, error: `${question.id} is unanswered` };
+        answers[question.id] = other ? { selected, other } : { selected };
+    }
+    return { ok: true, result: { outcome: "answered", answers } };
+}
+/**
+ * Options picked by number, for frontends that read a line of text: "1,3" or
+ * "1 3". Numbers that name no option are dropped rather than guessed at.
+ */
+export function picksFromNumbers(question, text) {
+    const labels = text
+        .split(/[\s,，、]+/)
+        .map(Number)
+        .filter((n) => Number.isInteger(n) && n >= 1 && n <= question.options.length)
+        .map((n) => question.options[n - 1].label);
+    return [...new Set(labels)];
+}
+/**
+ * What the model reads back.
+ *
+ * Each outcome says what to do next, because a bare "dismissed" is an
+ * invitation to guess the answer anyway — which is the one thing asking was
+ * meant to prevent.
+ */
+export function describeResult(questions, result) {
+    switch (result.outcome) {
+        case "answered": {
+            const lines = questions.map((question) => {
+                const pick = result.answers[question.id];
+                const parts = [...(pick?.selected ?? [])];
+                if (pick?.other)
+                    parts.push(`other: "${pick.other}"`);
+                return `- [${question.header}] ${question.question}\n  → ${parts.join(", ") || "(no answer)"}`;
+            });
+            return `The user answered:\n${lines.join("\n")}`;
+        }
+        case "dismissed":
+            return [
+                "The user closed the question without choosing.",
+                result.note ? `They wrote instead: "${result.note}"` : "",
+                "Do not assume an answer. Act on what they wrote if it settles the question; otherwise say in plain text what you need, or stop.",
+            ].filter(Boolean).join("\n");
+        case "unavailable":
+            return "Nobody is available to answer questions in this run. Pick a sensible default, carry on, and state the assumption in your final reply.";
+        case "aborted":
+            return "The turn was interrupted while the question was waiting for an answer.";
+    }
+}
+//# sourceMappingURL=questions.js.map

package/dist/tools/questions.js.map

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