@namzu/sdk 43.0.0 → 44.1.0

package/dist/tools/paths.js

@@ -25,18 +25,60 @@ export function resolveWithin(root, candidate) {
     // An absolute `rel` means the two paths share no root at all (a
     // different drive on Windows); a leading `..` means it climbed out.
     if (rel.startsWith('..') || isAbsolute(rel)) {
-        throw new Error(`Path escapes the working directory: ${candidate}. Tools may only reach inside ${resolvedRoot}.`);
+        throw new Error(`Path escapes the working directory: ${candidate}. ${OUTSIDE_ROOTS_GUIDANCE(`inside ${resolvedRoot}`)}`);
     }
     return resolved;
 }
-/** True when `candidate` resolves inside `root`. */
+/**
+ * What a refusal says after naming the path: where the tools DO reach, and
+ * how that is widened.
+ *
+ * It used to end at "Tools may only reach inside X", which reads as a wall.
+ * It is not one: a host can add a directory to the session, and a host that
+ * reviews such paths (`QueryParams.outsideRootAccess: 'review'`) turns them
+ * into an approval request before the tool ever runs, so a model that meets
+ * this text is in a turn where that did not happen. Told only "may only", a
+ * model either rewords the path forever or tells the user the file cannot be
+ * read at all; told the route, it asks for the directory.
+ */
+export const OUTSIDE_ROOTS_GUIDANCE = (reach) => `This turn's file tools reach ${reach}. The boundary is the session's, not the file system's: ask the user to add the directory to the session (or approve the path, where the host asks), rather than retrying another spelling of the same path.`;
 /**
  * The directories a tool may reach: the working directory first, then any
- * the host added for the session (`/add-dir`). Relative paths resolve
- * against the first; an absolute path is accepted inside any.
+ * the host added for the session (`/add-dir`), then any path a review
+ * approved for THIS call (`ToolContext.approvedPaths`). Relative paths
+ * resolve against the first; an absolute path is accepted inside any.
  */
 export function toolRoots(context) {
-    return [context.workingDirectory, ...(context.additionalDirectories ?? [])];
+    return [
+        context.workingDirectory,
+        ...(context.additionalDirectories ?? []),
+        ...(context.approvedPaths ?? []),
+    ];
+}
+/**
+ * The absolute path `candidate` names when it lies outside every root, or
+ * `undefined` when a tool would accept it as it stands.
+ *
+ * Decided with {@link resolveWithinAnyReal} — the resolver the file tools
+ * run — so the review and the execution cannot disagree about which side of
+ * the boundary a path is on, symlinks included. The returned path is the
+ * lexical one, which is what {@link toolRoots} is then handed: a link inside
+ * the working directory that points outside is approved under the name the
+ * reviewer saw.
+ */
+export async function pathOutsideRoots(roots, candidate) {
+    if (candidate === undefined || candidate === '')
+        return undefined;
+    const [first] = roots;
+    if (first === undefined)
+        return undefined;
+    try {
+        await resolveWithinAnyReal(roots, candidate);
+        return undefined;
+    }
+    catch {
+        return resolve(resolve(first), candidate);
+    }
 }
 function describeRoots(roots) {
     return roots.length === 1
@@ -60,7 +102,7 @@ export function resolveWithinAny(roots, candidate) {
         if (isWithin(root, resolved))
             return resolveWithin(root, resolved);
     }
-    throw new Error(`Path escapes the working directory: ${candidate}. Tools may only reach ${describeRoots(roots)}.`);
+    throw new Error(`Path escapes the working directory: ${candidate}. ${OUTSIDE_ROOTS_GUIDANCE(describeRoots(roots))}`);
 }
 /** `resolveWithinReal` over several roots: the first that contains the path, links followed. */
 export async function resolveWithinAnyReal(roots, candidate) {
@@ -81,7 +123,7 @@ export async function resolveWithinAnyReal(roots, candidate) {
             firstError ??= err;
         }
     }
-    throw new Error(`Path escapes the working directory: ${candidate}. Tools may only reach ${describeRoots(roots)}.`, { cause: firstError });
+    throw new Error(`Path escapes the working directory: ${candidate}. ${OUTSIDE_ROOTS_GUIDANCE(describeRoots(roots))}`, { cause: firstError });
 }
 export function isWithin(root, candidate) {
     try {
@@ -134,30 +176,46 @@ export function isWithin(root, candidate) {
 export async function resolveWithinReal(root, candidate) {
     // Cheap, and the only step that can name the caller's input in its error.
     const lexical = resolveWithin(root, candidate);
-    const realRoot = await realpath(root).catch(() => resolve(root));
+    // The root is canonicalized the same way as the candidate. A root that
+    // does not exist yet is not hypothetical: a reviewer approves the path a
+    // `write` is about to create (`ToolContext.approvedPaths`), and that path
+    // is then a root of its own. `realpath` on it throws, and the old fallback
+    // — the lexical root against a canonical candidate — refused the very file
+    // the user had just said yes to.
+    const realRoot = await canonicalize(resolve(root));
+    const canonical = await canonicalize(lexical);
+    // The whole canonical path, not only its deepest existing ancestor: for a
+    // root that exists the two agree (walking up stops at the root at the
+    // latest), and for one that does not, only the whole path can equal it.
+    // The part past the existing ancestor is lexical and cannot hide a link,
+    // because nothing is there to be one.
+    const rel = relative(realRoot, canonical);
+    if (rel.startsWith('..') || isAbsolute(rel)) {
+        throw new Error(`Path escapes the working directory: ${candidate}. It resolves through a link to ${canonical}, outside ${realRoot}. ${OUTSIDE_ROOTS_GUIDANCE(`inside ${realRoot}`)}`);
+    }
+    return canonical;
+}
+/**
+ * The canonical form of an absolute path that may not exist: the deepest
+ * existing ancestor with its links resolved, and the rest appended as
+ * written. A path of which nothing exists is returned as it stands.
+ */
+async function canonicalize(absolute) {
     // Walk up to the deepest existing ancestor. Terminates at the filesystem
     // root, where `dirname` becomes a fixed point.
-    let existing = lexical;
+    let existing = absolute;
     let remainder = '';
     for (;;) {
         const found = await realpath(existing).then((value) => value, () => undefined);
-        if (found !== undefined) {
-            existing = found;
-            break;
-        }
+        if (found !== undefined)
+            return remainder ? join(found, remainder) : found;
         const parent = dirname(existing);
-        if (parent === existing) {
-            // Nothing on this branch exists at all, so there is no link to
-            // follow and the lexical answer is already the canonical one.
-            return lexical;
-        }
+        // Nothing on this branch exists at all, so there is no link to follow
+        // and the lexical answer is already the canonical one.
+        if (parent === existing)
+            return absolute;
         remainder = remainder ? join(basename(existing), remainder) : basename(existing);
         existing = parent;
     }
-    const rel = relative(realRoot, existing);
-    if (rel.startsWith('..') || isAbsolute(rel)) {
-        throw new Error(`Path escapes the working directory: ${candidate}. It resolves through a link to ${existing}, outside ${realRoot}.`);
-    }
-    return remainder ? join(existing, remainder) : existing;
 }
 //# sourceMappingURL=paths.js.map

package/dist/tools/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,SAA6B;IACxE,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;IAErE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACjD,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;IAE5C,gEAAgE;IAChE,oEAAoE;IACpE,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACd,uCAAuC,SAAS,KAAK,sBAAsB,CAAC,UAAU,YAAY,EAAE,CAAC,EAAE,CACvG,CAAA;IACF,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAU,EAAE,CAC/D,gCAAgC,KAAK,8MAA8M,CAAA;AAEpP;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAIzB;IACA,OAAO;QACN,OAAO,CAAC,gBAAgB;QACxB,GAAG,CAAC,OAAO,CAAC,qBAAqB,IAAI,EAAE,CAAC;QACxC,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;KAChC,CAAA;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,KAAwB,EACxB,SAA6B;IAE7B,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAA;IACrB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACzC,IAAI,CAAC;QACJ,MAAM,oBAAoB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;QAC5C,OAAO,SAAS,CAAA;IACjB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAA;IAC1C,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,KAAwB;IAC9C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACxB,CAAC,CAAC,UAAU,OAAO,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC,EAAE;QACzC,CAAC,CAAC,UAAU,OAAO,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC,6BAA6B,KAAK;aACtE,KAAK,CAAC,CAAC,CAAC;aACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;aACtB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AACjB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,KAAwB,EAAE,SAA6B;IACvF,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAA;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IAC7D,MAAM,QAAQ,GACb,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAC1C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAChB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAA;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;YAAE,OAAO,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACnE,CAAC;IACD,MAAM,IAAI,KAAK,CACd,uCAAuC,SAAS,KAAK,sBAAsB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CACnG,CAAA;AACF,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,KAAwB,EACxB,SAA6B;IAE7B,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAA;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IACjE,MAAM,QAAQ,GACb,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAC1C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QAChB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAA;IACtC,IAAI,UAAmB,CAAA;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACJ,OAAO,MAAM,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,UAAU,KAAK,GAAG,CAAA;QACnB,CAAC;IACF,CAAC;IACD,MAAM,IAAI,KAAK,CACd,uCAAuC,SAAS,KAAK,sBAAsB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EACnG,EAAE,KAAK,EAAE,UAAU,EAAE,CACrB,CAAA;AACF,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACvD,IAAI,CAAC;QACJ,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,IAAY,EACZ,SAA6B;IAE7B,0EAA0E;IAC1E,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAE9C,uEAAuE;IACvE,yEAAyE;IACzE,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,iCAAiC;IACjC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAClD,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;IAE7C,0EAA0E;IAC1E,sEAAsE;IACtE,wEAAwE;IACxE,yEAAyE;IACzE,sCAAsC;IACtC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IACzC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACd,uCAAuC,SAAS,mCAAmC,SAAS,aAAa,QAAQ,KAAK,sBAAsB,CAAC,UAAU,QAAQ,EAAE,CAAC,EAAE,CACpK,CAAA;IACF,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC3C,yEAAyE;IACzE,+CAA+C;IAC/C,IAAI,QAAQ,GAAG,QAAQ,CAAA;IACvB,IAAI,SAAS,GAAG,EAAE,CAAA;IAClB,SAAS,CAAC;QACT,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAChB,GAAG,EAAE,CAAC,SAAS,CACf,CAAA;QACD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;QAChC,sEAAsE;QACtE,uDAAuD;QACvD,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO,QAAQ,CAAA;QACxC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChF,QAAQ,GAAG,MAAM,CAAA;IAClB,CAAC;AACF,CAAC"}

package/dist/tools/posix-path.js

@@ -60,7 +60,7 @@ export function resolveWithinPosix(root, candidate) {
     const resolved = candidate.startsWith('/') ? joinPosix(candidate) : joinPosix(root, candidate);
     const rel = relativePosix(root, resolved);
     if (rel.startsWith('..')) {
-        throw new Error(`Path escapes the working directory: ${candidate}. Tools may only reach inside ${root}.`);
+        throw new Error(`Path escapes the working directory: ${candidate}. Inside this sandbox the file tools reach only ${root}; nothing else is mounted, so no spelling of the path will be found. Ask the user to add the directory to the session (a later sandboxed turn binds it), rather than retrying.`);
     }
     return resolved;
 }

package/dist/tools/posix-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"posix-path.js","sourceRoot":"","sources":["../../src/tools/posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,SAAS,iBAAiB,CAAC,IAAY;IACtC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAQ;QAC/C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,8DAA8D;YAC9D,wDAAwD;YACxD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAA;;gBACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,SAAQ;QACT,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAG,KAAe;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAClD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,EAAU;IACrD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAA;IAExC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,OACC,MAAM,GAAG,YAAY,CAAC,MAAM;QAC5B,MAAM,GAAG,UAAU,CAAC,MAAM;QAC1B,YAAY,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,EAC1C,CAAC;QACF,MAAM,EAAE,CAAA;IACT,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACrD,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAA6B;IAC7E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;IAEvE,oEAAoE;IACpE,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAC9F,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACzC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACd,uCAAuC,SAAS,iCAAiC,IAAI,GAAG,CACxF,CAAA;IACF,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC"}
+{"version":3,"file":"posix-path.js","sourceRoot":"","sources":["../../src/tools/posix-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,SAAS,iBAAiB,CAAC,IAAY;IACtC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG;YAAE,SAAQ;QAC/C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACtB,8DAA8D;YAC9D,wDAAwD;YACxD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAA;;gBACxD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,SAAQ;QACT,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClB,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAG,KAAe;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAClD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,EAAU;IACrD,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;IAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAA;IAExC,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,OACC,MAAM,GAAG,YAAY,CAAC,MAAM;QAC5B,MAAM,GAAG,UAAU,CAAC,MAAM;QAC1B,YAAY,CAAC,MAAM,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,EAC1C,CAAC;QACF,MAAM,EAAE,CAAA;IACT,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IACrD,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,SAA6B;IAC7E,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;IAEvE,oEAAoE;IACpE,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAC9F,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACzC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACd,uCAAuC,SAAS,mDAAmD,IAAI,gLAAgL,CACvR,CAAA;IACF,CAAC;IACD,OAAO,QAAQ,CAAA;AAChB,CAAC"}

package/dist/tools/resident-history.d.ts

@@ -3,7 +3,7 @@ import type { ToolContext, ToolDefinition } from '../types/tool/index.js';
 /**
  * @experimental
  * Read-only tools over an explicitly authorized historical source. The host
- * resolves and checks the executing run's scope; models choose no paths,
+ * resolves and checks the executing turn's scope; models choose no paths,
  * tenant, resident, pursuit or upper-history boundary.
  */
 export declare function buildResidentHistoryTools(resolveSource: (context: ToolContext) => ResidentHistorySource): ToolDefinition[];

package/dist/tools/resident-history.js

@@ -3,7 +3,7 @@ import { defineTool } from './defineTool.js';
 /**
  * @experimental
  * Read-only tools over an explicitly authorized historical source. The host
- * resolves and checks the executing run's scope; models choose no paths,
+ * resolves and checks the executing turn's scope; models choose no paths,
  * tenant, resident, pursuit or upper-history boundary.
  */
 export function buildResidentHistoryTools(resolveSource) {

package/dist/tools/resident-tool-evidence.d.ts

@@ -1,5 +1,5 @@
 import type { ResidentToolEvidenceSource } from '../manager/resident/tool-evidence.js';
 import type { ToolContext, ToolDefinition } from '../types/tool/index.js';
-/** @experimental The host must authorize each executing run before returning its bound source. */
+/** @experimental The host must authorize each executing turn before returning its bound source. */
 export declare function buildResidentToolEvidenceTools(resolveSource: (context: ToolContext) => ResidentToolEvidenceSource): ToolDefinition[];
 //# sourceMappingURL=resident-tool-evidence.d.ts.map

package/dist/tools/resident-tool-evidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resident-tool-evidence.d.ts","sourceRoot":"","sources":["../../src/tools/resident-tool-evidence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGzE,kGAAkG;AAClG,wBAAgB,8BAA8B,CAC7C,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,0BAA0B,GACjE,cAAc,EAAE,CA2DlB"}
+{"version":3,"file":"resident-tool-evidence.d.ts","sourceRoot":"","sources":["../../src/tools/resident-tool-evidence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGzE,mGAAmG;AACnG,wBAAgB,8BAA8B,CAC7C,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,0BAA0B,GACjE,cAAc,EAAE,CA2DlB"}

package/dist/tools/resident-tool-evidence.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { defineTool } from './defineTool.js';
-/** @experimental The host must authorize each executing run before returning its bound source. */
+/** @experimental The host must authorize each executing turn before returning its bound source. */
 export function buildResidentToolEvidenceTools(resolveSource) {
     async function execute(context, read) {
         try {

package/dist/tools/resident-tool-evidence.js.map

@@ -1 +1 @@
-{"version":3,"file":"resident-tool-evidence.js","sourceRoot":"","sources":["../../src/tools/resident-tool-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,kGAAkG;AAClG,MAAM,UAAU,8BAA8B,CAC7C,aAAmE;IAEnE,KAAK,UAAU,OAAO,CACrB,OAAoB,EACpB,IAA8D;QAE9D,IAAI,CAAC;YACJ,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAA;YACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QACrF,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAA;YACrC,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EACJ,kNAAkN;aACnN,CAAA;QACF,CAAC;IACF,CAAC;IACD,OAAO;QACN,UAAU,CAAC;YACV,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACV,opBAAopB;YACrpB,WAAW,EAAE,CAAC;iBACZ,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;iBAC1F,MAAM,EAAE;YACV,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,sBAAsB,EAAE,CAAC;YAC3F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAC3B,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;SACxE,CAAC;QACF,UAAU,CAAC;YACV,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACV,oYAAoY;YACrY,WAAW,EAAE,CAAC;iBACZ,MAAM,CAAC;gBACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;gBAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;aAC5D,CAAC;iBACD,MAAM,EAAE;YACV,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,iCAAiC,KAAK,CAAC,QAAQ,EAAE;aACxD,CAAC;YACF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAC3B,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;SACtE,CAAC;KACF,CAAA;AACF,CAAC"}
+{"version":3,"file":"resident-tool-evidence.js","sourceRoot":"","sources":["../../src/tools/resident-tool-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,mGAAmG;AACnG,MAAM,UAAU,8BAA8B,CAC7C,aAAmE;IAEnE,KAAK,UAAU,OAAO,CACrB,OAAoB,EACpB,IAA8D;QAE9D,IAAI,CAAC;YACJ,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAA;YACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAA;QACrF,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,CAAA;YACrC,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EACJ,kNAAkN;aACnN,CAAA;QACF,CAAC;IACF,CAAC;IACD,OAAO;QACN,UAAU,CAAC;YACV,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EACV,opBAAopB;YACrpB,WAAW,EAAE,CAAC;iBACZ,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;iBAC1F,MAAM,EAAE;YACV,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,sBAAsB,EAAE,CAAC;YAC3F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAC3B,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;SACxE,CAAC;QACF,UAAU,CAAC;YACV,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACV,oYAAoY;YACrY,WAAW,EAAE,CAAC;iBACZ,MAAM,CAAC;gBACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;gBAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;aAC5D,CAAC;iBACD,MAAM,EAAE;YACV,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,KAAK;YAClB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACxB,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE,iCAAiC,KAAK,CAAC,QAAQ,EAAE;aACxD,CAAC;YACF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAC3B,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;SACtE,CAAC;KACF,CAAA;AACF,CAAC"}

package/dist/tools/task/create.d.ts

@@ -1,5 +1,5 @@
-import type { RunId } from '../../types/ids/index.js';
 import type { TaskStore } from '../../types/task/index.js';
 import type { ToolDefinition } from '../../types/tool/index.js';
-export declare function buildTaskCreateTool(taskStore: TaskStore, runId: RunId): ToolDefinition;
+import type { TaskToolScope } from './index.js';
+export declare function buildTaskCreateTool(taskStore: TaskStore, scope: Pick<TaskToolScope, 'sessionId' | 'turnId'>): ToolDefinition;
 //# sourceMappingURL=create.d.ts.map

package/dist/tools/task/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/tools/task/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAI/D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CA6CtF"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/tools/task/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,QAAQ,CAAC,GAChD,cAAc,CAgDhB"}

package/dist/tools/task/create.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 import { asTaskId } from '../../utils/id.js';
 import { defineTool } from '../defineTool.js';
-export function buildTaskCreateTool(taskStore, runId) {
+import { presentTaskCreateCall, presentTaskCreateResult } from './present.js';
+export function buildTaskCreateTool(taskStore, scope) {
     return defineTool({
         name: 'task_create',
         description: 'Create a task to track a unit of planned work. Use this to break down complex work into trackable steps before starting. Each task has a subject (imperative: "Fix auth bug") and optionally an activeForm (present continuous: "Fixing auth bug") for progress display.',
@@ -27,9 +28,12 @@ export function buildTaskCreateTool(taskStore, runId) {
         readOnly: false,
         destructive: false,
         concurrencySafe: true,
+        presentCall: presentTaskCreateCall,
+        presentResult: presentTaskCreateResult,
         async execute({ subject, description, activeForm, owner, blockedBy, metadata }) {
             const task = await taskStore.create({
-                runId,
+                sessionId: scope.sessionId,
+                turnId: scope.turnId,
                 subject,
                 description,
                 activeForm,
@@ -40,7 +44,7 @@ export function buildTaskCreateTool(taskStore, runId) {
             return {
                 success: true,
                 output: `Task created: ${task.id} — "${subject}"${owner ? ` [owner: ${owner}]` : ''}`,
-                data: { id: task.id, status: task.status, owner: task.owner },
+                data: { id: task.id, subject: task.subject, status: task.status, owner: task.owner },
             };
         },
     });

package/dist/tools/task/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/task/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,mBAAmB,CAAC,SAAoB,EAAE,KAAY;IACrE,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,0QAA0Q;QAC3Q,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACtF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC/E,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;YACrF,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;YACxF,SAAS,EAAE,CAAC;iBACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SACrF,CAAC;QACF,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE;YAC7E,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;gBACnC,KAAK;gBACL,OAAO;gBACP,WAAW;gBACX,UAAU;gBACV,KAAK;gBACL,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC;gBACnC,QAAQ;aACR,CAAC,CAAA;YAEF,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iBAAiB,IAAI,CAAC,EAAE,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrF,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;aAC7D,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/task/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE7E,MAAM,UAAU,mBAAmB,CAClC,SAAoB,EACpB,KAAkD;IAElD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,aAAa;QACnB,WAAW,EACV,0QAA0Q;QAC3Q,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACtF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC/E,UAAU,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;YACrF,KAAK,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;YACxF,SAAS,EAAE,CAAC;iBACV,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CAAC,wDAAwD,CAAC;YACpE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SACrF,CAAC;QACF,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,qBAAqB;QAClC,aAAa,EAAE,uBAAuB;QACtC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE;YAC7E,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;gBACnC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO;gBACP,WAAW;gBACX,UAAU;gBACV,KAAK;gBACL,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC;gBACnC,QAAQ;aACR,CAAC,CAAA;YAEF,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iBAAiB,IAAI,CAAC,EAAE,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrF,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;aACpF,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}

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

@@ -1,7 +1,21 @@
-import type { RunId } from '../../types/ids/index.js';
+import type { SessionId, TurnId } from '../../types/ids/index.js';
 import type { TaskStore } from '../../types/task/index.js';
 import type { ToolDefinition } from '../../types/tool/index.js';
-export declare function buildTaskTools(taskStore: TaskStore, runId: RunId): ToolDefinition[];
+/**
+ * The turn the task tools act for. Tasks are kept per session; each records
+ * the turn that created it, and the listing shows the open tasks of every
+ * turn plus those closed in this one (spec §4.5).
+ */
+export interface TaskToolScope {
+    readonly sessionId: SessionId;
+    readonly turnId: TurnId;
+    /**
+     * When the turn started (epoch milliseconds); a resumed turn passes the
+     * time it first started. Absent: the time the tools were built.
+     */
+    readonly turnStartedAt?: number;
+}
+export declare function buildTaskTools(taskStore: TaskStore, scope: TaskToolScope): ToolDefinition[];
 export { buildTaskCreateTool } from './create.js';
 export { buildTaskUpdateTool } from './update.js';
 export { buildTaskListTool } from './list.js';

package/dist/tools/task/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK/D,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE,CAMnF;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK/D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,cAAc,EAAE,CAO3F;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}

package/dist/tools/task/index.js

@@ -1,11 +1,12 @@
 import { buildTaskCreateTool } from './create.js';
 import { buildTaskListTool } from './list.js';
 import { buildTaskUpdateTool } from './update.js';
-export function buildTaskTools(taskStore, runId) {
+export function buildTaskTools(taskStore, scope) {
+    const resolved = { ...scope, turnStartedAt: scope.turnStartedAt ?? Date.now() };
     return [
-        buildTaskCreateTool(taskStore, runId),
+        buildTaskCreateTool(taskStore, resolved),
         buildTaskUpdateTool(taskStore),
-        buildTaskListTool(taskStore, runId),
+        buildTaskListTool(taskStore, resolved),
     ];
 }
 export { buildTaskCreateTool } from './create.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,UAAU,cAAc,CAAC,SAAoB,EAAE,KAAY;IAChE,OAAO;QACN,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC;QACrC,mBAAmB,CAAC,SAAS,CAAC;QAC9B,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC;KACnC,CAAA;AACF,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAiBjD,MAAM,UAAU,cAAc,CAAC,SAAoB,EAAE,KAAoB;IACxE,MAAM,QAAQ,GAAG,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;IAC/E,OAAO;QACN,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC;QACxC,mBAAmB,CAAC,SAAS,CAAC;QAC9B,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC;KACtC,CAAA;AACF,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}

package/dist/tools/task/list.d.ts

@@ -1,5 +1,7 @@
-import type { RunId } from '../../types/ids/index.js';
 import { type TaskStore } from '../../types/task/index.js';
 import type { ToolDefinition } from '../../types/tool/index.js';
-export declare function buildTaskListTool(taskStore: TaskStore, runId: RunId): ToolDefinition;
+import type { TaskToolScope } from './index.js';
+export declare function buildTaskListTool(taskStore: TaskStore, scope: TaskToolScope & {
+    readonly turnStartedAt: number;
+}): ToolDefinition;
 //# sourceMappingURL=list.d.ts.map

package/dist/tools/task/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/task/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,KAAK,SAAS,EAAwB,MAAM,2BAA2B,CAAA;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAgDpF"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/task/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAwB,MAAM,2BAA2B,CAAA;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/C,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,aAAa,GAAG;IAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvD,cAAc,CAoDhB"}

package/dist/tools/task/list.js

@@ -1,19 +1,26 @@
 import { z } from 'zod';
+import { selectTaskContext } from '../../store/task/context.js';
 import { isTerminalTaskStatus } from '../../types/task/index.js';
 import { defineTool } from '../defineTool.js';
-export function buildTaskListTool(taskStore, runId) {
+import { countTasks, presentTaskListCall, presentTaskListResult } from './present.js';
+export function buildTaskListTool(taskStore, scope) {
     return defineTool({
         name: 'task_list',
-        description: 'List planning items for the current run, not delegated agent invocations. Use agent_task_list, when available, to inspect agent execution. Shows subject, status, owner, and unresolved blockers. Use this to review your plan and decide what to work on next.',
+        description: 'List planning items for this session: every open one, and those closed during the current turn. Not delegated agent invocations. Use agent_task_list, when available, to inspect agent execution. Shows subject, status, owner, and unresolved blockers. Use this to review your plan and decide what to work on next.',
         inputSchema: z.object({}),
         category: 'custom',
         permissions: [],
         readOnly: true,
         destructive: false,
         concurrencySafe: true,
+        presentCall: presentTaskListCall,
+        presentResult: presentTaskListResult,
         async execute() {
-            const tasks = await taskStore.list({ runId });
-            const completedIds = new Set(tasks.filter((t) => isTerminalTaskStatus(t.status)).map((t) => t.id));
+            const all = await taskStore.list({ sessionId: scope.sessionId });
+            // Blockers resolve against every task of the session, shown or not: a
+            // blocker closed in an earlier turn is resolved, not unknown.
+            const completedIds = new Set(all.filter((t) => isTerminalTaskStatus(t.status)).map((t) => t.id));
+            const tasks = selectTaskContext(all, scope);
             const summary = tasks.map((task) => {
                 const unresolvedBlockers = task.blockedBy.filter((bid) => !completedIds.has(bid));
                 return {
@@ -35,7 +42,7 @@ export function buildTaskListTool(taskStore, runId) {
                 success: true,
                 output: tasks.length === 0
                     ? 'No planning tasks yet. This list does not report delegated agent status; use agent_task_list when available.'
-                    : `${stats.total} tasks: ${stats.completed} completed, ${stats.in_progress} in progress, ${stats.pending} pending.`,
+                    : `${countTasks(stats.total)}: ${stats.completed} completed, ${stats.in_progress} in progress, ${stats.pending} pending.`,
                 data: { tasks: summary, stats },
             };
         },

package/dist/tools/task/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/task/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAkB,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,iBAAiB,CAAC,SAAoB,EAAE,KAAY;IACnE,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,WAAW;QACjB,WAAW,EACV,iQAAiQ;QAClQ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO;YACZ,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YAE7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAC3B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACpE,CAAA;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAClC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;gBAEjF,OAAO;oBACN,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;oBACzB,SAAS,EAAE,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;oBACzE,UAAU,EAAE,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;iBACvE,CAAA;YACF,CAAC,CAAC,CAAA;YAEF,MAAM,KAAK,GAAG;gBACb,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;gBAC3D,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;gBACnE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;aAC/D,CAAA;YAED,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EACL,KAAK,CAAC,MAAM,KAAK,CAAC;oBACjB,CAAC,CAAC,8GAA8G;oBAChH,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,WAAW,iBAAiB,KAAK,CAAC,OAAO,WAAW;gBACrH,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;aAC/B,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/task/list.ts"],"names":[],"mappings":"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"}

package/dist/tools/task/present.d.ts

@@ -0,0 +1,18 @@
+import type { ToolResult } from '../../types/tool/index.js';
+import type { ToolCallView, ToolResultView } from '../../types/tool/presentation.js';
+/** `N task` / `N tasks`. */
+export declare function countTasks(count: number): string;
+export declare function presentTaskCreateCall(input: {
+    readonly subject?: unknown;
+}): ToolCallView;
+export declare function presentTaskCreateResult(_input: unknown, result: ToolResult): ToolResultView;
+/** The verb for a `task_update` call, from the status it asks for. */
+export declare function taskUpdateVerb(status: unknown): string;
+export declare function presentTaskUpdateCall(input: {
+    readonly status?: unknown;
+    readonly subject?: unknown;
+}): ToolCallView;
+export declare function presentTaskUpdateResult(_input: unknown, result: ToolResult): ToolResultView;
+export declare function presentTaskListCall(): ToolCallView;
+export declare function presentTaskListResult(_input: unknown, result: ToolResult): ToolResultView;
+//# sourceMappingURL=present.d.ts.map

package/dist/tools/task/present.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"present.d.ts","sourceRoot":"","sources":["../../../src/tools/task/present.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAA;AA+BpF,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAWD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAGzF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,CAG3F;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAatD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC1B,GAAG,YAAY,CAIf;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,CAG3F;AAED,wBAAgB,mBAAmB,IAAI,YAAY,CAElD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,CAWzF"}

package/dist/tools/task/present.js

@@ -0,0 +1,88 @@
+/**
+ * How the task tools read to a person.
+ *
+ * The model-facing output of these tools names task ids, because the model
+ * needs them to call `task_update`. None of that is for the operator: with no
+ * opinion of its own a task call fell through to the generic presenter, which
+ * printed the arguments (`{"id":"01a0…","status":"completed"}`) as the call
+ * row and the model's receipt (`Task 01a0… updated — status: completed`) as
+ * the result. So each tool says what happened in words — `Added task ·
+ * Write the parser` — and a successful receipt adds nothing beneath it.
+ *
+ * Deliberately no ids, no owner and no JSON anywhere in these views. A host
+ * that wants the ids still has the tool result and its `data`.
+ */
+const MAX_SUBJECT = 100;
+function oneLine(value) {
+    const flat = value.replace(/\s+/g, ' ').trim();
+    return flat.length > MAX_SUBJECT ? `${flat.slice(0, MAX_SUBJECT - 1)}…` : flat;
+}
+function activity(label) {
+    return { kind: 'generic', presentation: 'activity', label };
+}
+/** A successful receipt: the call row already said it. */
+const HIDDEN_RESULT = { kind: 'generic', label: '', visibility: 'hidden' };
+/** `N task` / `N tasks`. */
+export function countTasks(count) {
+    return `${count} task${count === 1 ? '' : 's'}`;
+}
+/** What a failed task call says, without the id the model passed. */
+function failure(result, fallback) {
+    const text = `${result.error ?? result.output ?? ''}`;
+    return {
+        kind: 'generic',
+        label: /not found/i.test(text) ? 'No task has that id' : fallback,
+    };
+}
+export function presentTaskCreateCall(input) {
+    const subject = typeof input.subject === 'string' ? oneLine(input.subject) : '';
+    return activity(subject ? `Add task · ${subject}` : 'Add task');
+}
+export function presentTaskCreateResult(_input, result) {
+    if (!result.success)
+        return failure(result, 'The task was not added');
+    return HIDDEN_RESULT;
+}
+/** The verb for a `task_update` call, from the status it asks for. */
+export function taskUpdateVerb(status) {
+    switch (status) {
+        case 'in_progress':
+            return 'Start task';
+        case 'completed':
+            return 'Complete task';
+        case 'deleted':
+            return 'Remove task';
+        case 'pending':
+            return 'Reopen task';
+        default:
+            return 'Update task';
+    }
+}
+export function presentTaskUpdateCall(input) {
+    const verb = taskUpdateVerb(input.status);
+    const subject = typeof input.subject === 'string' ? oneLine(input.subject) : '';
+    return activity(subject ? `${verb} · ${subject}` : verb);
+}
+export function presentTaskUpdateResult(_input, result) {
+    if (!result.success)
+        return failure(result, 'The task was not changed');
+    return HIDDEN_RESULT;
+}
+export function presentTaskListCall() {
+    return activity('Check tasks');
+}
+export function presentTaskListResult(_input, result) {
+    if (!result.success)
+        return { kind: 'generic', label: 'The task list could not be read' };
+    const stats = result.data
+        ?.stats;
+    const total = typeof stats?.total === 'number' ? stats.total : undefined;
+    const completed = typeof stats?.completed === 'number' ? stats.completed : undefined;
+    if (total === undefined || completed === undefined)
+        return HIDDEN_RESULT;
+    return {
+        kind: 'generic',
+        label: total === 0 ? 'No tasks yet' : `Tasks · ${completed}/${total} done`,
+    };
+}
+//# sourceMappingURL=present.js.map

package/dist/tools/task/present.js.map

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

package/dist/tools/task/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/tools/task/update.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAI/D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CAqFxE"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/tools/task/update.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK/D,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,CA4FxE"}

package/dist/tools/task/update.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { asTaskId } from '../../utils/id.js';
 import { defineTool } from '../defineTool.js';
+import { presentTaskUpdateCall, presentTaskUpdateResult } from './present.js';
 export function buildTaskUpdateTool(taskStore) {
     return defineTool({
         name: 'task_update',
@@ -30,6 +31,8 @@ export function buildTaskUpdateTool(taskStore) {
         readOnly: false,
         destructive: false,
         concurrencySafe: true,
+        presentCall: presentTaskUpdateCall,
+        presentResult: presentTaskUpdateResult,
         async execute({ id, subject, description, activeForm, status, owner, addBlocks, addBlockedBy, metadata, }) {
             // Checked. Without it a malformed id reads as "Task not found",
             // which tells the model its task disappeared rather than that it
@@ -66,7 +69,12 @@ export function buildTaskUpdateTool(taskStore) {
             return {
                 success: true,
                 output: `Task ${id} updated — status: ${updated.status}`,
-                data: { id: updated.id, status: updated.status, owner: updated.owner },
+                data: {
+                    id: updated.id,
+                    subject: updated.subject,
+                    status: updated.status,
+                    owner: updated.owner,
+                },
             };
         },
     });

package/dist/tools/task/update.js.map

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