@xrkseek/harness-cli 0.0.6 → 0.0.7

package/node_modules/@xrkseek/core-session/dist/surface-fold.d.ts

@@ -5,12 +5,17 @@
  * `shadowedTokenCount` applies signed delta:
  *   estimate(formatCompactionForModel) − shadowedTokenCount
  * Legacy compaction without the field folds at 0 (DSH replace-without-claim).
+ *
+ * Pruned `tool/result` replacements carry
+ * `meta.xrkPrunePreviousSurfaceTokens` so the fold can apply a net delta
+ * without re-scanning the log.
  */
 import type { SessionEvent } from "@xrkseek/protocol";
 export declare function foldSurfaceTokens(surfaceTokens: number, event: SessionEvent): number;
 /**
  * Heuristic price of the current model window's append surface
  * (events after the latest compaction, or from 0).
+ * Uses the latest `tool/result` per callId (prune replacements).
  * Used by compaction producers as `shadowedTokenCount`.
  */
 export declare function priceCurrentSurfaceWindow(events: readonly SessionEvent[]): number;

package/node_modules/@xrkseek/core-session/dist/surface-fold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface-fold.d.ts","sourceRoot":"","sources":["../src/surface-fold.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAA0B,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6C9E,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,YAAY,GAClB,MAAM,CAIR;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,MAAM,CAQR"}
+{"version":3,"file":"surface-fold.d.ts","sourceRoot":"","sources":["../src/surface-fold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAA0B,YAAY,EAAmB,MAAM,mBAAmB,CAAC;AAuD/F,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,YAAY,GAClB,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,MAAM,CAkBR"}

package/node_modules/@xrkseek/core-session/dist/surface-fold.js

@@ -5,9 +5,14 @@
  * `shadowedTokenCount` applies signed delta:
  *   estimate(formatCompactionForModel) − shadowedTokenCount
  * Legacy compaction without the field folds at 0 (DSH replace-without-claim).
+ *
+ * Pruned `tool/result` replacements carry
+ * `meta.xrkPrunePreviousSurfaceTokens` so the fold can apply a net delta
+ * without re-scanning the log.
  */
 import { formatCompactionForModel, findLatestCompaction } from "./compaction.js";
 import { estimateAssistantSurface, estimateMessageContent, } from "./surface-estimate.js";
+import { TOOL_RESULT_PRUNE_META_PREV_TOKENS } from "./tool-result-prune.js";
 /** Append-only surface price (excludes compaction). */
 function appendSurfaceDelta(event) {
     switch (event.type) {
@@ -17,11 +22,19 @@ function appendSurfaceDelta(event) {
         case "assistant/message":
             return estimateAssistantSurface(event.content, event.toolCalls);
         case "tool/result":
-            return estimateMessageContent(event.result.content);
+            return toolResultSurfaceDelta(event);
         default:
             return 0;
     }
 }
+function toolResultSurfaceDelta(event) {
+    const next = estimateMessageContent(event.result.content);
+    const prevRaw = event.result.meta?.[TOOL_RESULT_PRUNE_META_PREV_TOKENS];
+    if (typeof prevRaw === "number" && Number.isFinite(prevRaw)) {
+        return next - prevRaw;
+    }
+    return next;
+}
 /** Checkpoint price after a compaction window swap (one synthetic user message). */
 function estimateCompactionCheckpoint(event) {
     return estimateMessageContent(formatCompactionForModel(event));
@@ -50,14 +63,27 @@ export function foldSurfaceTokens(surfaceTokens, event) {
 /**
  * Heuristic price of the current model window's append surface
  * (events after the latest compaction, or from 0).
+ * Uses the latest `tool/result` per callId (prune replacements).
  * Used by compaction producers as `shadowedTokenCount`.
  */
 export function priceCurrentSurfaceWindow(events) {
     const latest = findLatestCompaction(events);
     const start = latest ? latest.index + 1 : 0;
     let tokens = 0;
-    for (let i = start; i < events.length; i++) {
-        tokens += appendSurfaceDelta(events[i]);
+    const seenToolResults = new Set();
+    // Walk newest-first so the first tool/result per callId is the surface.
+    for (let i = events.length - 1; i >= start; i--) {
+        const ev = events[i];
+        if (ev.type === "tool/result") {
+            if (seenToolResults.has(ev.result.toolCallId))
+                continue;
+            seenToolResults.add(ev.result.toolCallId);
+            tokens += estimateMessageContent(ev.result.content);
+            continue;
+        }
+        if (ev.type === "context/compaction")
+            continue;
+        tokens += appendSurfaceDelta(ev);
     }
     return tokens;
 }

package/node_modules/@xrkseek/core-session/dist/surface-fold.js.map

@@ -1 +1 @@
-{"version":3,"file":"surface-fold.js","sourceRoot":"","sources":["../src/surface-fold.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,uDAAuD;AACvD,SAAS,kBAAkB,CAAC,KAAmB;IAC7C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe;YAClB,OAAO,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,mBAAmB;YACtB,OAAO,wBAAwB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,KAAK,aAAa;YAChB,OAAO,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtD;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,4BAA4B,CACnC,KAA6B;IAE7B,OAAO,sBAAsB,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,KAA6B;IAC3D,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrD,OAAO,4BAA4B,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC;AACxE,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QACxC,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,KAAmB;IAEnB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA+B;IAE/B,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"surface-fold.js","sourceRoot":"","sources":["../src/surface-fold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAE5E,uDAAuD;AACvD,SAAS,kBAAkB,CAAC,KAAmB;IAC7C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,cAAc,CAAC;QACpB,KAAK,eAAe;YAClB,OAAO,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,KAAK,mBAAmB;YACtB,OAAO,wBAAwB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,KAAK,aAAa;YAChB,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACvC;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAsB;IACpD,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,kCAAkC,CAAC,CAAC;IACxE,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,GAAG,OAAO,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oFAAoF;AACpF,SAAS,4BAA4B,CACnC,KAA6B;IAE7B,OAAO,sBAAsB,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,KAA6B;IAC3D,IAAI,KAAK,CAAC,kBAAkB,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrD,OAAO,4BAA4B,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC;AACxE,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB;IAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;QACxC,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,KAAmB;IAEnB,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA+B;IAE/B,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,wEAAwE;IACxE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACtB,IAAI,EAAE,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC9B,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,SAAS;YACxD,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,IAAI,sBAAsB,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,KAAK,oBAAoB;YAAE,SAAS;QAC/C,MAAM,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/node_modules/@xrkseek/core-session/dist/tool-result-prune.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Truncate oversized model-visible `tool/result` surfaces (DSH-aligned).
+ * Appends a replacement `tool/result` for the same callId; log keeps the
+ * original. `deriveMessages` / surface pricing fold to the latest per callId.
+ */
+import type { SessionStore } from "./store.js";
+/** DSH-aligned: prune when result text exceeds this many characters. */
+export declare const TOOL_RESULT_PRUNE_THRESHOLD_CHARS = 8192;
+export declare const TOOL_RESULT_PRUNE_HEAD_CHARS = 4096;
+export declare const TOOL_RESULT_PRUNE_TAIL_CHARS = 1024;
+/** `tool/result.meta` key: previous surface token price (for O(1) fold delta). */
+export declare const TOOL_RESULT_PRUNE_META_PREV_TOKENS: "xrkPrunePreviousSurfaceTokens";
+export interface ToolResultPruneOptions {
+    readonly thresholdChars?: number;
+    readonly headChars?: number;
+    readonly tailChars?: number;
+    readonly now?: () => number;
+    readonly turnId?: string;
+    readonly stepId?: string;
+}
+export interface ToolResultPruneResult {
+    readonly pruned: number;
+}
+export declare function pruneToolResultText(text: string, options?: {
+    readonly thresholdChars?: number;
+    readonly headChars?: number;
+    readonly tailChars?: number;
+}): string | undefined;
+/**
+ * Append pruned replacement `tool/result` events for oversized results in the
+ * current model window (after latest compaction). Idempotent when the latest
+ * surface is already under threshold.
+ */
+export declare function pruneOversizedToolResults(store: SessionStore, sessionId: string, options?: ToolResultPruneOptions): ToolResultPruneResult;
+//# sourceMappingURL=tool-result-prune.d.ts.map

package/node_modules/@xrkseek/core-session/dist/tool-result-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-prune.d.ts","sourceRoot":"","sources":["../src/tool-result-prune.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wEAAwE;AACxE,eAAO,MAAM,iCAAiC,OAAO,CAAC;AACtD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,kFAAkF;AAClF,eAAO,MAAM,kCAAkC,EAC7C,+BAAwC,CAAC;AAE3C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAaD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CACxB,GACL,MAAM,GAAG,SAAS,CAYpB;AAgBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAyCvB"}

package/node_modules/@xrkseek/core-session/dist/tool-result-prune.js

@@ -0,0 +1,99 @@
+/**
+ * Truncate oversized model-visible `tool/result` surfaces (DSH-aligned).
+ * Appends a replacement `tool/result` for the same callId; log keeps the
+ * original. `deriveMessages` / surface pricing fold to the latest per callId.
+ */
+import { estimateMessageContent } from "./surface-estimate.js";
+import { findLatestCompaction } from "./compaction.js";
+/** DSH-aligned: prune when result text exceeds this many characters. */
+export const TOOL_RESULT_PRUNE_THRESHOLD_CHARS = 8192;
+export const TOOL_RESULT_PRUNE_HEAD_CHARS = 4096;
+export const TOOL_RESULT_PRUNE_TAIL_CHARS = 1024;
+/** `tool/result.meta` key: previous surface token price (for O(1) fold delta). */
+export const TOOL_RESULT_PRUNE_META_PREV_TOKENS = "xrkPrunePreviousSurfaceTokens";
+function contentPlainText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content) || content.length === 0)
+        return undefined;
+    const parts = [];
+    for (const block of content) {
+        if (block.type !== "text")
+            return undefined;
+        parts.push(block.text);
+    }
+    return parts.join("\n");
+}
+export function pruneToolResultText(text, options = {}) {
+    const threshold = options.thresholdChars ?? TOOL_RESULT_PRUNE_THRESHOLD_CHARS;
+    const headChars = options.headChars ?? TOOL_RESULT_PRUNE_HEAD_CHARS;
+    const tailChars = options.tailChars ?? TOOL_RESULT_PRUNE_TAIL_CHARS;
+    // DSH budgets are Unicode code points, not UTF-16 code units.
+    const units = Array.from(text);
+    if (units.length <= threshold)
+        return undefined;
+    if (headChars + tailChars >= units.length)
+        return undefined;
+    const omitted = units.length - headChars - tailChars;
+    const head = units.slice(0, headChars).join("");
+    const tail = units.slice(-tailChars).join("");
+    return `${head}\n\n…[${omitted} chars omitted]…\n\n${tail}`;
+}
+function latestToolResultByCallId(events, start) {
+    const latest = new Map();
+    for (let i = start; i < events.length; i++) {
+        const ev = events[i];
+        if (ev.type === "tool/result") {
+            latest.set(ev.result.toolCallId, ev);
+        }
+    }
+    return latest;
+}
+/**
+ * Append pruned replacement `tool/result` events for oversized results in the
+ * current model window (after latest compaction). Idempotent when the latest
+ * surface is already under threshold.
+ */
+export function pruneOversizedToolResults(store, sessionId, options = {}) {
+    const threshold = options.thresholdChars ?? TOOL_RESULT_PRUNE_THRESHOLD_CHARS;
+    const headChars = options.headChars ?? TOOL_RESULT_PRUNE_HEAD_CHARS;
+    const tailChars = options.tailChars ?? TOOL_RESULT_PRUNE_TAIL_CHARS;
+    const now = options.now ?? Date.now;
+    const events = store.get(sessionId).events;
+    const latestCompaction = findLatestCompaction(events);
+    const start = latestCompaction ? latestCompaction.index + 1 : 0;
+    const latest = latestToolResultByCallId(events, start);
+    let pruned = 0;
+    for (const ev of latest.values()) {
+        const plain = contentPlainText(ev.result.content);
+        if (plain === undefined)
+            continue;
+        const next = pruneToolResultText(plain, {
+            thresholdChars: threshold,
+            headChars,
+            tailChars,
+        });
+        if (next === undefined)
+            continue;
+        const previousSurfaceTokens = estimateMessageContent(ev.result.content);
+        store.append(sessionId, {
+            type: "tool/result",
+            ts: now(),
+            turnId: options.turnId ?? ev.turnId,
+            stepId: options.stepId ?? ev.stepId,
+            result: {
+                toolCallId: ev.result.toolCallId,
+                name: ev.result.name,
+                content: next,
+                ...(ev.result.isError ? { isError: true } : {}),
+                meta: {
+                    ...(ev.result.meta ?? {}),
+                    [TOOL_RESULT_PRUNE_META_PREV_TOKENS]: previousSurfaceTokens,
+                },
+            },
+        });
+        pruned += 1;
+    }
+    return { pruned };
+}
+//# sourceMappingURL=tool-result-prune.js.map

package/node_modules/@xrkseek/core-session/dist/tool-result-prune.js.map

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

package/node_modules/@xrkseek/core-system-prompt/dist/index.d.ts

@@ -1,7 +1,7 @@
 import type { SessionEvent } from "@xrkseek/protocol";
 import { type ThreeLayerInput } from "./three-layer.js";
 import { type PipelineStep, type SlashResolveFn } from "./outbound.js";
-export { assembleThreeLayers, buildSkeletonSystem, buildSkeletonUser, buildVolatileUser, mergeHistory, orderToolsForWire, type AssembledRequest, type SkeletonSystemInput, type SkeletonUserInput, type ThreeLayerInput, type VolatileUserInput, } from "./three-layer.js";
+export { assembleThreeLayers, buildSkeletonSystem, buildSkeletonUser, buildVolatileUser, mergeHistory, orderToolsForWire, TOOL_ORDER_REST, type AssembledRequest, type SkeletonSystemInput, type SkeletonUserInput, type ThreeLayerInput, type VolatileUserInput, } from "./three-layer.js";
 export { compactionStep, createAssembleStep, createContextWindowStep, createOutboundPipeline, createSlashRecipeStep, createToolPairStep, slashRecipeStep, type OutboundPipeline, type PipelineStep, type PipelineStepContext, type SlashExpandResult, type SlashResolveFn, } from "./outbound.js";
 export interface PromptSection {
     readonly id: string;

package/node_modules/@xrkseek/core-system-prompt/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKnE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAqBnE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7D,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B,4CA2BA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKnE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAQL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAqBnE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7D,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B,4CA2BA"}

package/node_modules/@xrkseek/core-system-prompt/dist/index.js

@@ -1,7 +1,7 @@
 import { assertModelVisible, deriveMessages, } from "@xrkseek/core-session";
 import { assembleThreeLayers, } from "./three-layer.js";
 import { compactionStep, createAssembleStep, createContextWindowStep, createOutboundPipeline, createSlashRecipeStep, createToolPairStep, slashRecipeStep, } from "./outbound.js";
-export { assembleThreeLayers, buildSkeletonSystem, buildSkeletonUser, buildVolatileUser, mergeHistory, orderToolsForWire, } from "./three-layer.js";
+export { assembleThreeLayers, buildSkeletonSystem, buildSkeletonUser, buildVolatileUser, mergeHistory, orderToolsForWire, TOOL_ORDER_REST, } from "./three-layer.js";
 export { compactionStep, createAssembleStep, createContextWindowStep, createOutboundPipeline, createSlashRecipeStep, createToolPairStep, slashRecipeStep, } from "./outbound.js";
 export function createSystemPromptAssembler() {
     const sections = [];

package/node_modules/@xrkseek/core-system-prompt/dist/index.js.map

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

package/node_modules/@xrkseek/core-system-prompt/dist/three-layer.d.ts

@@ -40,6 +40,13 @@ export interface ThreeLayerInput {
      * so the volatile suffix can stay byte-stable across a turn's tool loop.
      */
     readonly includeVolatileTime?: boolean;
+    /**
+     * Optional tool wire order (DSH `toolOrder`). Exactly one `' '` rest marker;
+     * named tools before/after the rest appear in that order, remaining tools
+     * fill the rest slot in lexicographic order. Omit / empty → pure lex sort.
+     * Unknown names, duplicates, or wrong rest count throw.
+     */
+    readonly toolOrder?: readonly string[];
 }
 export declare function buildSkeletonSystem(input: SkeletonSystemInput): string;
 export declare function buildSkeletonUser(input: SkeletonUserInput): ChatMessage;
@@ -51,13 +58,19 @@ export declare function mergeHistory(history: readonly ChatMessage[], options?:
     readonly includeCurrentMarker?: boolean;
 }): ChatMessage[];
 /** Lexicographic tool order — registration order must not leak to the wire. */
-export declare function orderToolsForWire(tools: AssembledRequest["tools"]): AssembledRequest["tools"];
+export declare const TOOL_ORDER_REST: " ";
+/**
+ * Order tools for the wire.
+ * @param tools - tool definitions for this request
+ * @param toolOrder - optional DSH-style order with exactly one `' '` rest
+ */
+export declare function orderToolsForWire(tools: AssembledRequest["tools"], toolOrder?: readonly string[]): AssembledRequest["tools"];
 /**
  * Fixed order:
  * 1. system = skeleton system (+ optional workspace blocks appended)
  * 2. messages = history(+optional marker) + skeleton user + volatile user
  * Volatile content must never appear in `system`.
- * Tools are sorted by name for prompt-cache stability (DSH parity).
+ * Tools are sorted by name (or `toolOrder`) for prompt-cache stability (DSH parity).
  */
 export declare function assembleThreeLayers(input: ThreeLayerInput): AssembledRequest;
 //# sourceMappingURL=three-layer.d.ts.map

package/node_modules/@xrkseek/core-system-prompt/dist/three-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"three-layer.d.ts","sourceRoot":"","sources":["../src/three-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,EAAE,CAAC;CACL;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAMtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CASvE;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,WAAW,CAWb;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE;IAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,WAAW,EAAE,CAWf;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAC/B,gBAAgB,CAAC,OAAO,CAAC,CAI3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,GACrB,gBAAgB,CA0BlB"}
+{"version":3,"file":"three-layer.d.ts","sourceRoot":"","sources":["../src/three-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,EAAE,CAAC;CACL;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAMtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CASvE;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,WAAW,CAWb;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAC1B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,GAAE;IAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,WAAW,EAAE,CAWf;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAG,GAAY,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAC5B,gBAAgB,CAAC,OAAO,CAAC,CAkC3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,eAAe,GACrB,gBAAgB,CA0BlB"}

package/node_modules/@xrkseek/core-system-prompt/dist/three-layer.js

@@ -43,15 +43,49 @@ export function mergeHistory(history, options = {}) {
     ];
 }
 /** Lexicographic tool order — registration order must not leak to the wire. */
-export function orderToolsForWire(tools) {
-    return [...tools].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+export const TOOL_ORDER_REST = " ";
+/**
+ * Order tools for the wire.
+ * @param tools - tool definitions for this request
+ * @param toolOrder - optional DSH-style order with exactly one `' '` rest
+ */
+export function orderToolsForWire(tools, toolOrder) {
+    const lex = [...tools].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    if (!toolOrder || toolOrder.length === 0)
+        return lex;
+    const restMarks = toolOrder.filter((x) => x === TOOL_ORDER_REST);
+    if (restMarks.length !== 1) {
+        throw new Error(`toolOrder must contain exactly one ' ' rest marker (got ${restMarks.length})`);
+    }
+    const named = toolOrder.filter((x) => x !== TOOL_ORDER_REST);
+    if (new Set(named).size !== named.length) {
+        throw new Error("toolOrder must not list the same tool name twice");
+    }
+    const byName = new Map(tools.map((t) => [t.name, t]));
+    for (const name of named) {
+        if (!byName.has(name)) {
+            throw new Error(`toolOrder references unknown tool: ${name}`);
+        }
+    }
+    const restIdx = toolOrder.indexOf(TOOL_ORDER_REST);
+    const before = toolOrder.slice(0, restIdx).filter((x) => x !== TOOL_ORDER_REST);
+    const after = toolOrder.slice(restIdx + 1).filter((x) => x !== TOOL_ORDER_REST);
+    const pinned = new Set([...before, ...after]);
+    const middle = lex.filter((t) => !pinned.has(t.name));
+    const pick = (names) => names.map((n) => {
+        const t = byName.get(n);
+        if (!t)
+            throw new Error(`toolOrder references unknown tool: ${n}`);
+        return t;
+    });
+    return [...pick(before), ...middle, ...pick(after)];
 }
 /**
  * Fixed order:
  * 1. system = skeleton system (+ optional workspace blocks appended)
  * 2. messages = history(+optional marker) + skeleton user + volatile user
  * Volatile content must never appear in `system`.
- * Tools are sorted by name for prompt-cache stability (DSH parity).
+ * Tools are sorted by name (or `toolOrder`) for prompt-cache stability (DSH parity).
  */
 export function assembleThreeLayers(input) {
     const systemParts = [buildSkeletonSystem(input.skeletonSystem)];
@@ -71,7 +105,7 @@ export function assembleThreeLayers(input) {
     return {
         system,
         messages,
-        tools: orderToolsForWire(input.tools ?? []),
+        tools: orderToolsForWire(input.tools ?? [], input.toolOrder),
     };
 }
 //# sourceMappingURL=three-layer.js.map

package/node_modules/@xrkseek/core-system-prompt/dist/three-layer.js.map

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

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

@@ -0,0 +1,5 @@
+import type { ToolResultContent } from "./definition.js";
+export declare function isAbortError(err: unknown): boolean;
+/** Model-facing result when cancel wins after the tool body was invoked. */
+export declare function abortedToolContent(): ToolResultContent;
+//# sourceMappingURL=abort.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKlD;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,IAAI,iBAAiB,CAMtD"}

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

@@ -0,0 +1,14 @@
+import { TOOL_ABORTED, TOOL_ABORTED_MESSAGE, } from "@xrkseek/protocol";
+export function isAbortError(err) {
+    return ((err instanceof DOMException || err instanceof Error) &&
+        err.name === "AbortError");
+}
+/** Model-facing result when cancel wins after the tool body was invoked. */
+export function abortedToolContent() {
+    return {
+        content: TOOL_ABORTED_MESSAGE,
+        isError: true,
+        error: { name: "AbortError", code: TOOL_ABORTED },
+    };
+}
+//# sourceMappingURL=abort.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,CACL,CAAC,GAAG,YAAY,YAAY,IAAI,GAAG,YAAY,KAAK,CAAC;QACrD,GAAG,CAAC,IAAI,KAAK,YAAY,CAC1B,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,OAAO,EAAE,oBAAoB;QAC7B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE;KAClD,CAAC;AACJ,CAAC"}

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

@@ -1,15 +1,32 @@
 import type { ToolResult } from "@xrkseek/protocol";
 import type { MessageContent } from "@xrkseek/protocol";
 import type { PresentableToolResult, ToolCallView, ToolResultView } from "./presentation.js";
-/** Optional execute extras — pipeline wires `emitToolEvent` → session side events. */
+/** Optional execute extras — pipeline wires session side-effects. */
 export interface ToolExecuteExtras {
     emitToolEvent(type: string, payload: unknown): void;
+    /**
+     * Mark a successful final result as terminal for the current agent turn
+     * (DSH `ToolRunContext.concludeTurn`). Equivalent to returning
+     * `{ concludesTurn: true }`; ignored when the result is an error.
+     */
+    concludeTurn(): void;
+    /**
+     * Defer a user-visible context string until after this tool's `tool/result`
+     * (DSH `deferContext`, string form — XRK appends `user/message`).
+     */
+    deferContext(text: string): void;
 }
 export interface ToolDefinition<TArgs = unknown> {
     readonly name: string;
     readonly description: string;
     readonly parameters: Record<string, unknown>;
     execute(args: TArgs, signal?: AbortSignal, extras?: ToolExecuteExtras): Promise<ToolResultContent>;
+    /**
+     * Per-call concurrency classifier (DSH `isConcurrencySafe`).
+     * Exact `true` may run overlapping with other safe calls; undeclared,
+     * throwing, or any other return → exclusive barrier.
+     */
+    isConcurrencySafe?(args: TArgs): boolean;
     /**
      * Pure UI render intent. Soft-fail (return undefined / never throw) — Face
      * `viewFor` catches throws the same way DSH apiproxy does.
@@ -22,6 +39,20 @@ export interface ToolResultContent {
     readonly isError?: boolean;
     /** Face presentation replay; copied onto session `tool/result`. */
     readonly meta?: Readonly<Record<string, unknown>>;
+    /**
+     * DSH `ToolExecutionSuccess.concludesTurn`: successful body may end the
+     * current agent turn after this step settles (no further LLM step).
+     * Ignored when `isError` is set.
+     */
+    readonly concludesTurn?: true;
+    /**
+     * Structured failure class (e.g. abort codes). Copied onto session
+     * `tool/result.error` by {@link normalizeToolResult}.
+     */
+    readonly error?: {
+        readonly name: string;
+        readonly code: string;
+    };
 }
 export interface ToolRegistry {
     register(tool: ToolDefinition): void;

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,OAAO;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,CACL,IAAI,EAAE,KAAK,EACX,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B;;;OAGG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;IACpD,aAAa,CAAC,CACZ,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,MAAM,EAAE,qBAAqB,GAC5B,cAAc,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,0FAA0F;IAC1F,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC9C,IAAI,IAAI,SAAS,cAAc,EAAE,CAAC;CACnC;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CA0BjD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,iBAAiB,GACrB,UAAU,CAQZ;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,UAAU,CAOZ;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE/D"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EACV,qBAAqB,EACrB,YAAY,EACZ,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpD;;;;OAIG;IACH,YAAY,IAAI,IAAI,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,OAAO;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,CACL,IAAI,EAAE,KAAK,EACX,MAAM,CAAC,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;IACpD,aAAa,CAAC,CACZ,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,MAAM,EAAE,qBAAqB,GAC5B,cAAc,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACrC,0FAA0F;IAC1F,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IAC9C,IAAI,IAAI,SAAS,cAAc,EAAE,CAAC;CACnC;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CA0BjD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,iBAAiB,GACrB,UAAU,CASZ;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,UAAU,CAOZ;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE/D"}

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

@@ -32,6 +32,7 @@ export function normalizeToolResult(callId, name, out) {
         content: out.content,
         ...(out.isError ? { isError: true } : {}),
         ...(out.meta !== undefined ? { meta: out.meta } : {}),
+        ...(out.error !== undefined ? { error: out.error } : {}),
     };
 }
 export function errorToolResult(callId, name, content) {

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

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAiDA,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,OAAO;QACL,QAAQ,CAAC,IAAI;YACX,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,IAAI;YACN,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,kGAAkG;QAClG,OAAO,CAAC,IAAI;YACV,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,UAAU,CAAC,IAAI;YACb,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAY,EACZ,GAAsB;IAEtB,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI;QACJ,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAgFA,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAChD,OAAO;QACL,QAAQ,CAAC,IAAI;YACX,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,GAAG,CAAC,IAAI;YACN,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,kGAAkG;QAClG,OAAO,CAAC,IAAI;YACV,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,UAAU,CAAC,IAAI;YACb,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,IAAY,EACZ,GAAsB;IAEtB,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI;QACJ,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAY,EACZ,OAAe;IAEf,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI;QACJ,OAAO;QACP,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Fail-closed tool concurrency classification (DSH executionMode).
+ */
+import type { ToolCall } from "@xrkseek/protocol";
+import type { ToolRegistry } from "./definition.js";
+export type ToolExecutionModeKind = "parallel" | "exclusive";
+export interface ToolExecutionMode {
+    readonly kind: ToolExecutionModeKind;
+}
+/**
+ * Classify one pending call. Only exact `true` from a registered tool's
+ * `isConcurrencySafe` is parallel; unknown / missing / throw → exclusive.
+ */
+export declare function classifyToolExecutionMode(registry: ToolRegistry, call: ToolCall): ToolExecutionMode;
+//# sourceMappingURL=execution-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-mode.d.ts","sourceRoot":"","sources":["../src/execution-mode.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,QAAQ,GACb,iBAAiB,CASnB"}

package/node_modules/@xrkseek/core-tools/dist/execution-mode.js

@@ -0,0 +1,17 @@
+/**
+ * Classify one pending call. Only exact `true` from a registered tool's
+ * `isConcurrencySafe` is parallel; unknown / missing / throw → exclusive.
+ */
+export function classifyToolExecutionMode(registry, call) {
+    const tool = registry.get(call.name);
+    if (!tool?.isConcurrencySafe)
+        return { kind: "exclusive" };
+    try {
+        const safe = tool.isConcurrencySafe(call.arguments);
+        return safe === true ? { kind: "parallel" } : { kind: "exclusive" };
+    }
+    catch {
+        return { kind: "exclusive" };
+    }
+}
+//# sourceMappingURL=execution-mode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-mode.js","sourceRoot":"","sources":["../src/execution-mode.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAsB,EACtB,IAAc;IAEd,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,iBAAiB;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

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

@@ -1,4 +1,6 @@
+export { abortedToolContent, isAbortError, } from "./abort.js";
 export { createToolRegistry, errorToolResult, freezeToolResult, normalizeToolResult, type ToolDefinition, type ToolExecuteExtras, type ToolRegistry, type ToolResultContent, } from "./definition.js";
+export { classifyToolExecutionMode, type ToolExecutionMode, type ToolExecutionModeKind, } from "./execution-mode.js";
 export { parseExitStatus, type DiffCallView, type DiffResultView, type FileDiff, type FileLocation, type GenericCallView, type GenericResultView, type ParsedExitStatus, type PresentableToolResult, type ReadFileLine, type ReadResultView, type SearchFileMatches, type SearchLineMatch, type SearchMatchesResultView, type SearchPathsResultView, type TerminalCallView, type TerminalResultView, type TextBlock, type ToolCallKind, type ToolCallView, type ToolEventView, type ToolResultView, type WebFetchResultView, type WebResultView, type WebSearchResultView, type WebSource, } from "./presentation.js";
 export { presentToolEventView, type PresentToolLookup, type ToolCallPairing, } from "./present-event.js";
 export { createPolicyToolCallGuard, createReadTracker, createSandboxArgvWrapGuard, createWriteIntentGuard, extractPathArg, foldGuardVerdicts, runGuards, } from "./guards.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,eAAe,EACf,6BAA6B,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,eAAe,EACf,6BAA6B,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

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

@@ -1,4 +1,6 @@
+export { abortedToolContent, isAbortError, } from "./abort.js";
 export { createToolRegistry, errorToolResult, freezeToolResult, normalizeToolResult, } from "./definition.js";
+export { classifyToolExecutionMode, } from "./execution-mode.js";
 export { parseExitStatus, } from "./presentation.js";
 export { presentToolEventView, } from "./present-event.js";
 export { createPolicyToolCallGuard, createReadTracker, createSandboxArgvWrapGuard, createWriteIntentGuard, extractPathArg, foldGuardVerdicts, runGuards, } from "./guards.js";