@xrkseek/harness 0.1.26

package/node_modules/@xrkseek/core-tools/dist/presentation.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Tool render-intent vocabulary (DSH `dsh-tools/presentation`).
+ * Tools declare this via `presentCall` / `presentResult`; Face only looks up.
+ */
+export type ToolCallKind = "read" | "edit" | "delete" | "move" | "search" | "execute" | "fetch" | "other";
+export interface FileLocation {
+    readonly path: string;
+    readonly line?: number;
+}
+export interface FileDiff {
+    readonly path: string;
+    readonly oldText: string | null;
+    readonly newText: string;
+}
+export interface TextBlock {
+    readonly type: "text";
+    readonly text: string;
+}
+export interface GenericCallView {
+    readonly card: "generic";
+    readonly title: string;
+    readonly kind?: ToolCallKind;
+    readonly rawInput?: unknown;
+    readonly content?: readonly TextBlock[];
+    readonly locations?: readonly FileLocation[];
+}
+export interface TerminalCallView {
+    readonly card: "terminal";
+    readonly title: string;
+    readonly description?: string;
+    readonly cwd?: string;
+}
+export interface DiffCallView {
+    readonly card: "diff";
+    readonly title: string;
+    readonly diffs: readonly FileDiff[];
+    readonly locations?: readonly FileLocation[];
+}
+export type ToolCallView = GenericCallView | TerminalCallView | DiffCallView;
+export interface GenericResultView {
+    readonly card: "generic";
+    readonly title?: string;
+    readonly content?: readonly TextBlock[];
+}
+export interface TerminalResultView {
+    readonly card: "terminal";
+    readonly title?: string;
+    readonly output?: string;
+    readonly exitCode?: number;
+    readonly signal?: string;
+}
+export interface DiffResultView {
+    readonly card: "diff";
+    readonly title?: string;
+    readonly diffs: readonly FileDiff[];
+}
+export interface SearchLineMatch {
+    readonly lineNumber: number;
+    readonly line: string;
+}
+export interface SearchFileMatches {
+    readonly path: string;
+    readonly matches: readonly SearchLineMatch[];
+}
+export interface SearchMatchesResultView {
+    readonly card: "search";
+    readonly shape: "matches";
+    readonly title?: string;
+    readonly files: readonly SearchFileMatches[];
+    readonly truncated: boolean;
+    readonly total: number;
+}
+export interface SearchPathsResultView {
+    readonly card: "search";
+    readonly shape: "paths";
+    readonly title?: string;
+    readonly paths: readonly string[];
+    readonly truncated: boolean;
+    readonly total: number;
+}
+export interface ReadFileLine {
+    readonly number: number;
+    readonly text: string;
+}
+export interface ReadResultView {
+    readonly card: "read";
+    readonly title?: string;
+    readonly path: string;
+    readonly offset: number;
+    readonly lines: readonly ReadFileLine[];
+    readonly totalLines: number;
+    readonly lang?: string;
+    readonly content?: readonly TextBlock[];
+}
+/** One citeable web-search source (DSH `WebSource`). */
+export interface WebSource {
+    readonly url: string;
+    readonly title?: string;
+    readonly snippet?: string;
+    readonly publishedAt?: string;
+}
+export interface WebSearchResultView {
+    readonly card: "web";
+    readonly kind: "search";
+    readonly title?: string;
+    readonly sources: readonly WebSource[];
+    readonly answer?: string;
+    readonly truncated: boolean;
+}
+export interface WebFetchResultView {
+    readonly card: "web";
+    readonly kind: "fetch";
+    readonly title?: string;
+    readonly url: string;
+    readonly statusCode: number;
+    readonly truncated: boolean;
+}
+export type WebResultView = WebSearchResultView | WebFetchResultView;
+export type ToolResultView = GenericResultView | TerminalResultView | DiffResultView | SearchMatchesResultView | SearchPathsResultView | ReadResultView | WebSearchResultView | WebFetchResultView;
+export type ToolEventView = {
+    readonly for: "call";
+    readonly view: ToolCallView;
+} | {
+    readonly for: "result";
+    readonly view: ToolResultView;
+};
+/** Shape presenters receive (flattened text; image refs stay on the session log). */
+export interface PresentableToolResult {
+    readonly content: string;
+    readonly isError?: boolean;
+    readonly meta?: Readonly<Record<string, unknown>>;
+}
+export type ParsedExitStatus = {
+    readonly body: string;
+    readonly exitCode: number;
+} | {
+    readonly body: string;
+    readonly signal: string;
+};
+/**
+ * Inverse of DSH shell render markers `[exit code: N]` / `[killed by signal: X]`.
+ * Copied from `@xrkseek/xrk-shell` `parseExitStatus`.
+ */
+export declare function parseExitStatus(text: string): ParsedExitStatus;
+//# sourceMappingURL=presentation.d.ts.map

package/node_modules/@xrkseek/core-tools/dist/presentation.d.ts.map

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

package/node_modules/@xrkseek/core-tools/dist/presentation.js

@@ -0,0 +1,20 @@
+/**
+ * Tool render-intent vocabulary (DSH `dsh-tools/presentation`).
+ * Tools declare this via `presentCall` / `presentResult`; Face only looks up.
+ */
+/**
+ * Inverse of DSH shell render markers `[exit code: N]` / `[killed by signal: X]`.
+ * Copied from `@xrkseek/xrk-shell` `parseExitStatus`.
+ */
+export function parseExitStatus(text) {
+    const signal = /\n\[killed by signal: ([^\]\n]+)\]$/.exec(text);
+    if (signal?.[1] !== undefined) {
+        return { body: text.slice(0, signal.index), signal: signal[1] };
+    }
+    const exit = /\n\[exit code: (\d+)\]$/.exec(text);
+    if (exit?.[1] !== undefined) {
+        return { body: text.slice(0, exit.index), exitCode: Number(exit[1]) };
+    }
+    return { body: text, exitCode: 0 };
+}
+//# sourceMappingURL=presentation.js.map

package/node_modules/@xrkseek/core-tools/dist/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0KH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,MAAM,GAAG,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,CAAC;IACD,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AACrC,CAAC"}

package/node_modules/@xrkseek/core-tools/dist/run-tool.d.ts

@@ -0,0 +1,23 @@
+import type { ToolCall, ToolResult } from "@xrkseek/protocol";
+import type { ToolRegistry } from "./definition.js";
+import type { ToolMaterialization } from "./materialize.js";
+import { createToolPipeline } from "./pipeline.js";
+import type { RunToolOutcome, ToolPipeline } from "./types.js";
+export interface RunToolInput {
+    readonly registry: ToolRegistry;
+    readonly call: ToolCall;
+    readonly signal?: AbortSignal;
+    readonly pipeline?: ToolPipeline;
+    readonly timeoutMs?: number;
+    readonly maxRetries?: number;
+    /** When set, settle via step snapshot (stale/unknown) instead of live get(). */
+    readonly materialization?: ToolMaterialization;
+}
+/**
+ * Full waterfall entry. Caller must append `tool/call` to the session
+ * **before** invoking this (see agent-loop).
+ */
+export declare function runTool(registryOrInput: ToolRegistry | RunToolInput, call?: ToolCall, signal?: AbortSignal): Promise<ToolResult>;
+export declare function runToolDetailed(registryOrInput: ToolRegistry | RunToolInput, call?: ToolCall, signal?: AbortSignal): Promise<RunToolOutcome>;
+export { createToolPipeline };
+//# sourceMappingURL=run-tool.d.ts.map

package/node_modules/@xrkseek/core-tools/dist/run-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.d.ts","sourceRoot":"","sources":["../src/run-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAmB,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC;CAChD;AAaD;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,eAAe,EAAE,YAAY,GAAG,YAAY,EAC5C,IAAI,CAAC,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAGrB;AAED,wBAAsB,eAAe,CACnC,eAAe,EAAE,YAAY,GAAG,YAAY,EAC5C,IAAI,CAAC,EAAE,QAAQ,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,CAAC,CA0BzB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/node_modules/@xrkseek/core-tools/dist/run-tool.js

@@ -0,0 +1,42 @@
+import { createToolPipeline, runToolPipeline } from "./pipeline.js";
+function isRunToolInput(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "registry" in value &&
+        "call" in value);
+}
+/**
+ * Full waterfall entry. Caller must append `tool/call` to the session
+ * **before** invoking this (see agent-loop).
+ */
+export async function runTool(registryOrInput, call, signal) {
+    const outcome = await runToolDetailed(registryOrInput, call, signal);
+    return outcome.result;
+}
+export async function runToolDetailed(registryOrInput, call, signal) {
+    const input = isRunToolInput(registryOrInput)
+        ? registryOrInput
+        : {
+            registry: registryOrInput,
+            call: call,
+            ...(signal ? { signal } : {}),
+        };
+    if (input.materialization) {
+        return input.materialization.settle({
+            call: input.call,
+            ...(input.signal ? { signal: input.signal } : {}),
+            ...(input.pipeline ? { pipeline: input.pipeline } : {}),
+            ...(input.timeoutMs !== undefined ? { timeoutMs: input.timeoutMs } : {}),
+            ...(input.maxRetries !== undefined
+                ? { maxRetries: input.maxRetries }
+                : {}),
+        });
+    }
+    const tool = input.registry.get(input.call.name);
+    return runToolPipeline(tool, input.call, input.signal, input.pipeline, {
+        ...(input.timeoutMs !== undefined ? { timeoutMs: input.timeoutMs } : {}),
+        ...(input.maxRetries !== undefined ? { maxRetries: input.maxRetries } : {}),
+    });
+}
+export { createToolPipeline };
+//# sourceMappingURL=run-tool.js.map

package/node_modules/@xrkseek/core-tools/dist/run-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.js","sourceRoot":"","sources":["../src/run-tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAcpE,SAAS,cAAc,CACrB,KAAkC;IAElC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,UAAU,IAAI,KAAK;QACnB,MAAM,IAAI,KAAK,CAChB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,eAA4C,EAC5C,IAAe,EACf,MAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,eAA4C,EAC5C,IAAe,EACf,MAAoB;IAEpB,MAAM,KAAK,GAAiB,cAAc,CAAC,eAAe,CAAC;QACzD,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC;YACE,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,IAAK;YACX,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC;IAEN,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC;YAClC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;gBAClC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE;QACrE,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5E,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/node_modules/@xrkseek/core-tools/dist/std-tools.d.ts

@@ -0,0 +1,27 @@
+import type { ToolDefinition } from "./definition.js";
+export declare const EXIT_PLAN_MODE = "exit_plan_mode";
+export declare const PLAN_REVIEW_ID = "plan-review";
+export declare const PLAN_APPROVE_LABEL = "Approve";
+export declare const PLAN_KEEP_LABEL = "Keep planning";
+export interface PlanReviewAnswer {
+    readonly approved: boolean;
+    readonly feedback?: string;
+    readonly dismissed?: boolean;
+}
+export interface StdToolsOptions {
+    /** Interactive ask; if unset, ask_user returns isError. */
+    askUser?: (question: string) => Promise<string>;
+    /** Plan-mode gate for `exit_plan_mode`. Default: inactive. */
+    isPlanModeActive?: () => boolean;
+    /** Review channel for `exit_plan_mode`. */
+    askPlanReview?: (plan: string, signal?: AbortSignal) => Promise<PlanReviewAnswer>;
+}
+/** Standard session tools: todo_write + ask_user + exit_plan_mode. */
+export declare function createStdTools(options?: StdToolsOptions): ToolDefinition[];
+/** The plan's first markdown heading (any level), or undefined when it has none. */
+export declare function firstPlanHeading(plan: string): string | undefined;
+export declare function createExitPlanModeTool(options: {
+    isActive: () => boolean;
+    askReview?: (plan: string, signal?: AbortSignal) => Promise<PlanReviewAnswer>;
+}): ToolDefinition;
+//# sourceMappingURL=std-tools.d.ts.map

package/node_modules/@xrkseek/core-tools/dist/std-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"std-tools.d.ts","sourceRoot":"","sources":["../src/std-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,iBAAiB,CAAC;AAEzE,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAC5C,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAChC;AAqBD,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,OAAO,GAAE,eAAoB,GAC5B,cAAc,EAAE,CAgMlB;AAQD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAChC,GAAG,cAAc,CAiFjB"}

package/node_modules/@xrkseek/core-tools/dist/std-tools.js

@@ -0,0 +1,290 @@
+export const EXIT_PLAN_MODE = "exit_plan_mode";
+export const PLAN_REVIEW_ID = "plan-review";
+export const PLAN_APPROVE_LABEL = "Approve";
+export const PLAN_KEEP_LABEL = "Keep planning";
+const TODO_STATUSES = new Set([
+    "pending",
+    "in_progress",
+    "completed",
+]);
+function toWireTodos(rows) {
+    const out = [];
+    for (const t of rows) {
+        const content = t.content.trim();
+        if (!content)
+            return undefined;
+        if (!TODO_STATUSES.has(t.status))
+            return undefined;
+        out.push({ content, status: t.status });
+    }
+    return out;
+}
+/** Standard session tools: todo_write + ask_user + exit_plan_mode. */
+export function createStdTools(options = {}) {
+    const todos = [];
+    return [
+        {
+            name: "todo_write",
+            description: "Update the in-session todo list.",
+            parameters: {
+                type: "object",
+                properties: {
+                    merge: { type: "boolean" },
+                    todos: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                id: { type: "string" },
+                                content: { type: "string" },
+                                status: { type: "string" },
+                            },
+                        },
+                    },
+                },
+                required: ["todos"],
+            },
+            async execute(args, _signal, extras) {
+                const a = args;
+                const next = a.todos ?? [];
+                if (!a.merge) {
+                    todos.length = 0;
+                }
+                for (const t of next) {
+                    const i = todos.findIndex((x) => x.id === t.id);
+                    if (i >= 0)
+                        todos[i] = t;
+                    else
+                        todos.push(t);
+                }
+                const wire = toWireTodos(todos);
+                if (wire && extras) {
+                    extras.emitToolEvent("todo/write", { todos: wire });
+                }
+                return { content: JSON.stringify(todos, null, 2) };
+            },
+            presentCall: (args) => ({
+                card: "generic",
+                title: "Update todo list",
+                kind: "other",
+                rawInput: args.todos,
+            }),
+        },
+        {
+            name: "ask_user",
+            description: "Ask the user a concise question when you need confirmation, a choice, or missing information. " +
+                "Prefer `questions` (stable ids, optional options / multi_select / detail). " +
+                "`question` is a single free-text shortcut. " +
+                "Do not set `intent` for ordinary asks — plan-review intent is reserved for exit_plan_mode.",
+            parameters: {
+                type: "object",
+                properties: {
+                    question: {
+                        type: "string",
+                        description: "Single free-text question (shortcut; use questions[] when offering choices).",
+                    },
+                    questions: {
+                        type: "array",
+                        description: "One or more questions; each id is echoed in the answer.",
+                        items: {
+                            type: "object",
+                            properties: {
+                                id: {
+                                    type: "string",
+                                    description: "Stable id; echoed in the answer.",
+                                },
+                                question: {
+                                    type: "string",
+                                    description: "The question to ask.",
+                                },
+                                header: {
+                                    type: "string",
+                                    description: "Optional short heading.",
+                                },
+                                detail: {
+                                    type: "string",
+                                    description: "Optional longer body shown under the question (e.g. plan markdown).",
+                                },
+                                options: {
+                                    type: "array",
+                                    description: 'Optional choices. If recommending one, put it first and append "(Recommended)" to the label.',
+                                    items: {
+                                        type: "object",
+                                        properties: {
+                                            label: { type: "string" },
+                                            description: { type: "string" },
+                                        },
+                                        required: ["label"],
+                                    },
+                                },
+                                multi_select: {
+                                    type: "boolean",
+                                    description: "Allow more than one option. Defaults to false.",
+                                },
+                                intent: {
+                                    type: "object",
+                                    description: "Reserved: plan-review for exit_plan_mode. Do not set on casual ask_user calls.",
+                                    properties: {
+                                        kind: {
+                                            type: "string",
+                                            description: 'Must be "plan-review".',
+                                        },
+                                        approve: {
+                                            type: "string",
+                                            description: "Label of the approve option.",
+                                        },
+                                    },
+                                    required: ["kind", "approve"],
+                                },
+                            },
+                            required: ["id", "question"],
+                        },
+                    },
+                },
+            },
+            presentCall: (args) => {
+                const a = args;
+                const title = a.question?.trim() ||
+                    a.questions?.find((q) => q.question?.trim())?.question ||
+                    "Ask user";
+                return {
+                    card: "generic",
+                    title: String(title),
+                    kind: "other",
+                    rawInput: args,
+                };
+            },
+            async execute(args) {
+                const a = args;
+                const questions = Array.isArray(a.questions)
+                    ? a.questions
+                        .map((q) => ({
+                        id: String(q?.id ?? "").trim(),
+                        question: String(q?.question ?? "").trim(),
+                        header: String(q?.header ?? "").trim(),
+                    }))
+                        .filter((q) => q.question.length > 0)
+                    : [];
+                const q = String(a.question ?? "").trim() ||
+                    questions.map((row) => row.question).join("\n") ||
+                    "";
+                if (!options.askUser) {
+                    const preview = questions.length > 0
+                        ? questions
+                            .map((row) => row.id
+                            ? `[${row.id}] ${row.header ? `${row.header}: ` : ""}${row.question}`
+                            : row.question)
+                            .join("\n")
+                        : q;
+                    return {
+                        content: `ask_user unavailable (no UI): ${preview || "(empty)"}`,
+                        isError: true,
+                    };
+                }
+                if (!q) {
+                    return { content: "ask_user: empty question", isError: true };
+                }
+                const answer = await options.askUser(q);
+                return { content: answer };
+            },
+        },
+        createExitPlanModeTool({
+            isActive: () => options.isPlanModeActive?.() === true,
+            ...(options.askPlanReview
+                ? { askReview: options.askPlanReview }
+                : {}),
+        }),
+    ];
+}
+const EXIT_DESCRIPTION = "Use only in plan mode. Present your plan for the user's review and, on approval, leave plan mode. " +
+    "Send the COMPLETE plan as markdown, starting with a # heading that names it. " +
+    "The user may approve (carry out the plan from your next step) or keep " +
+    "planning — their feedback comes back in the tool result; revise and present again.";
+/** The plan's first markdown heading (any level), or undefined when it has none. */
+export function firstPlanHeading(plan) {
+    for (const line of plan.split("\n")) {
+        const match = /^#{1,6}\s+(.+?)\s*$/u.exec(line);
+        if (match)
+            return match[1];
+    }
+    return undefined;
+}
+export function createExitPlanModeTool(options) {
+    return {
+        name: EXIT_PLAN_MODE,
+        description: EXIT_DESCRIPTION,
+        parameters: {
+            type: "object",
+            properties: {
+                plan: {
+                    type: "string",
+                    description: "The complete plan, as markdown, starting with a # heading that names it.",
+                },
+            },
+            required: ["plan"],
+        },
+        presentCall: (args) => {
+            const plan = String(args.plan ?? "");
+            return {
+                card: "generic",
+                title: firstPlanHeading(plan) ?? "Plan",
+                kind: "other",
+                content: [{ type: "text", text: plan }],
+            };
+        },
+        presentResult: (_args, result) => ({
+            card: "generic",
+            title: "Plan review",
+            content: [{ type: "text", text: result.content }],
+        }),
+        async execute(args, signal, extras) {
+            const plan = String(args.plan ?? "");
+            if (!options.isActive()) {
+                return {
+                    content: `${EXIT_PLAN_MODE} is only available in plan mode`,
+                    isError: true,
+                };
+            }
+            if (!/^#\s+\S/u.test(plan.trim())) {
+                return {
+                    content: `${EXIT_PLAN_MODE} requires a non-empty markdown plan starting with a # heading`,
+                    isError: true,
+                };
+            }
+            if (!options.askReview) {
+                return {
+                    content: "no user-questions channel is available to review the plan; ask the user to switch the session mode instead",
+                    isError: true,
+                };
+            }
+            let review;
+            try {
+                review = await options.askReview(plan, signal);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { content: msg, isError: true };
+            }
+            if (review.dismissed) {
+                return {
+                    content: "The user dismissed the plan review to speak instead; stay in plan mode, stop here, and wait for their message.",
+                    isError: true,
+                };
+            }
+            if (!review.approved) {
+                const feedback = review.feedback?.trim() ?? "";
+                return {
+                    content: feedback === ""
+                        ? "The user chose to keep planning; revise the plan and present it again."
+                        : `The user chose to keep planning; their feedback: ${feedback}`,
+                    isError: true,
+                };
+            }
+            extras?.emitToolEvent("plan/mode", { active: false });
+            return {
+                content: "Plan approved — plan mode exited; carry out the plan starting with your next step.",
+            };
+        },
+    };
+}
+//# sourceMappingURL=std-tools.js.map

package/node_modules/@xrkseek/core-tools/dist/std-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"std-tools.js","sourceRoot":"","sources":["../src/std-tools.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAoB/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAiB;IAC5C,SAAS;IACT,aAAa;IACb,WAAW;CACZ,CAAC,CAAC;AAEH,SAAS,WAAW,CAClB,IAAuD;IAEvD,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAwB,CAAC;YAAE,OAAO,SAAS,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAwB,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC5B,UAA2B,EAAE;IAE7B,MAAM,KAAK,GAAsD,EAAE,CAAC;IACpE,OAAO;QACL;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,kCAAkC;YAC/C,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC1B,KAAK,EAAE;wBACL,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACtB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6BAC3B;yBACF;qBACF;iBACF;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,MAA0B;gBACrD,MAAM,CAAC,GAAG,IAGT,CAAC;gBACF,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC3B,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;oBACb,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnB,CAAC;gBACD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;oBACrB,MAAM,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBAChD,IAAI,CAAC,IAAI,CAAC;wBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;;wBACpB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrB,CAAC;gBACD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;gBAChC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACnB,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YACrD,CAAC;YACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,kBAAkB;gBACzB,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAG,IAA4B,CAAC,KAAK;aAC9C,CAAC;SACH;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,gGAAgG;gBAChG,6EAA6E;gBAC7E,6CAA6C;gBAC7C,4FAA4F;YAC9F,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE;wBACR,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,8EAA8E;qBACjF;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,OAAO;wBACb,WAAW,EAAE,yDAAyD;wBACtE,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,EAAE,EAAE;oCACF,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,kCAAkC;iCAChD;gCACD,QAAQ,EAAE;oCACR,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,sBAAsB;iCACpC;gCACD,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,yBAAyB;iCACvC;gCACD,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ;oCACd,WAAW,EACT,qEAAqE;iCACxE;gCACD,OAAO,EAAE;oCACP,IAAI,EAAE,OAAO;oCACb,WAAW,EACT,8FAA8F;oCAChG,KAAK,EAAE;wCACL,IAAI,EAAE,QAAQ;wCACd,UAAU,EAAE;4CACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4CACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yCAChC;wCACD,QAAQ,EAAE,CAAC,OAAO,CAAC;qCACpB;iCACF;gCACD,YAAY,EAAE;oCACZ,IAAI,EAAE,SAAS;oCACf,WAAW,EAAE,gDAAgD;iCAC9D;gCACD,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ;oCACd,WAAW,EACT,gFAAgF;oCAClF,UAAU,EAAE;wCACV,IAAI,EAAE;4CACJ,IAAI,EAAE,QAAQ;4CACd,WAAW,EAAE,wBAAwB;yCACtC;wCACD,OAAO,EAAE;4CACP,IAAI,EAAE,QAAQ;4CACd,WAAW,EAAE,8BAA8B;yCAC5C;qCACF;oCACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;iCAC9B;6BACF;4BACD,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;yBAC7B;qBACF;iBACF;aACF;YACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;gBACpB,MAAM,CAAC,GAAG,IAGT,CAAC;gBACF,MAAM,KAAK,GACT,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE;oBAClB,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ;oBACtD,UAAU,CAAC;gBACb,OAAO;oBACL,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;oBACpB,IAAI,EAAE,OAAO;oBACb,QAAQ,EAAE,IAAI;iBACf,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,IAAI;gBAChB,MAAM,CAAC,GAAG,IAGT,CAAC;gBACF,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;oBAC1C,CAAC,CAAC,CAAC,CAAC,SAAS;yBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBACX,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;wBAC9B,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;wBAC1C,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;qBACvC,CAAC,CAAC;yBACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;oBACzC,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM,CAAC,GACL,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;oBAC/B,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;oBAC/C,EAAE,CAAC;gBACL,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBACrB,MAAM,OAAO,GACX,SAAS,CAAC,MAAM,GAAG,CAAC;wBAClB,CAAC,CAAC,SAAS;6BACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACX,GAAG,CAAC,EAAE;4BACJ,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE;4BACrE,CAAC,CAAC,GAAG,CAAC,QAAQ,CACjB;6BACA,IAAI,CAAC,IAAI,CAAC;wBACf,CAAC,CAAC,CAAC,CAAC;oBACR,OAAO;wBACL,OAAO,EAAE,iCAAiC,OAAO,IAAI,SAAS,EAAE;wBAChE,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC,CAAC,EAAE,CAAC;oBACP,OAAO,EAAE,OAAO,EAAE,0BAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAChE,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACxC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC7B,CAAC;SACF;QACD,sBAAsB,CAAC;YACrB,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,KAAK,IAAI;YACrD,GAAG,CAAC,OAAO,CAAC,aAAa;gBACvB,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,aAAa,EAAE;gBACtC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,gBAAgB,GACpB,oGAAoG;IACpG,+EAA+E;IAC/E,wEAAwE;IACxE,oFAAoF,CAAC;AAEvF,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAMtC;IACC,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,gBAAgB;QAC7B,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,0EAA0E;iBAC7E;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,CAAE,IAA2B,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7D,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,MAAM;gBACvC,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aACxC,CAAC;QACJ,CAAC;QACD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;SAC3D,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAA0B;YACpD,MAAM,IAAI,GAAG,MAAM,CAAE,IAA2B,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,GAAG,cAAc,iCAAiC;oBAC3D,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAClC,OAAO;oBACL,OAAO,EAAE,GAAG,cAAc,+DAA+D;oBACzF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EACL,4GAA4G;oBAC9G,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,IAAI,MAAwB,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACzC,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,OAAO;oBACL,OAAO,EACL,gHAAgH;oBAClH,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAC/C,OAAO;oBACL,OAAO,EACL,QAAQ,KAAK,EAAE;wBACb,CAAC,CAAC,wEAAwE;wBAC1E,CAAC,CAAC,oDAAoD,QAAQ,EAAE;oBACpE,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YACD,MAAM,EAAE,aAAa,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACtD,OAAO;gBACL,OAAO,EACL,oFAAoF;aACvF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/node_modules/@xrkseek/core-tools/dist/subagent-prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Model-facing subagent routing (injected every turn when tools are bound).
+ * Kept in core-tools so presets can register without depending on server-face.
+ */
+export declare const SUBAGENT_ROUTING_PROMPT_TEXT: string;
+//# sourceMappingURL=subagent-prompt.d.ts.map

package/node_modules/@xrkseek/core-tools/dist/subagent-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-prompt.d.ts","sourceRoot":"","sources":["../src/subagent-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,4BAA4B,QAM7B,CAAC"}

package/node_modules/@xrkseek/core-tools/dist/subagent-prompt.js

@@ -0,0 +1,12 @@
+/**
+ * Model-facing subagent routing (injected every turn when tools are bound).
+ * Kept in core-tools so presets can register without depending on server-face.
+ */
+export const SUBAGENT_ROUTING_PROMPT_TEXT = [
+    "Subagents:",
+    "- Use `subagent` to delegate a self-contained task (fresh child context).",
+    "- Foreground (default): waits and returns the child's final answer.",
+    "- Background (`run_in_background: true`): returns a durable child session id; you are notified in-session when it finishes a turn — follow up with `send_message` / `interrupt_agent`; list with `list_agents`.",
+    "- Do not nest beyond the configured depth; prefer independent parallel children over deep chains.",
+].join("\n");
+//# sourceMappingURL=subagent-prompt.js.map

package/node_modules/@xrkseek/core-tools/dist/subagent-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-prompt.js","sourceRoot":"","sources":["../src/subagent-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,YAAY;IACZ,2EAA2E;IAC3E,qEAAqE;IACrE,iNAAiN;IACjN,mGAAmG;CACpG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}