@namzu/sdk 62.12.0 → 62.13.0

package/dist/tools/goal/confirmation.js

@@ -0,0 +1,290 @@
+import { StaleGoalError } from '../../store/goal/index.js';
+import { showCommand } from '../coordinator/outcome-record.js';
+import { handBackKindSentence, handBackReason } from '../hand-back/index.js';
+/**
+ * Ending a goal by the record of the work.
+ *
+ * Today the model's own report ends a goal. With `confirmedBy: 'record'` the
+ * kernel first reads the record it keeps of the work (`Turn.outcome`, built
+ * from what the tool calls did and never from what the model says) and the
+ * goal ends only as that record allows. There is no judge model and no model
+ * call beyond the turns themselves: the decision is a pure function over what
+ * the model reported, the record and the count of refusals so far.
+ */
+/**
+ * Times the record may send a goal back to the model before the goal ends as
+ * not confirmed. Three: a first refusal normally costs one fix and one rerun of
+ * the check, a second covers a fix that did not hold, a third a check that
+ * needed a second look; past that the model is looping, and every further
+ * refusal costs a model call that has stopped moving the work. The limit is
+ * per goal and a host can set its own.
+ */
+export const DEFAULT_GOAL_REFUSALS = 3;
+/** The `reasonCode` that makes a `complete` report say that no check exists to run. */
+export const NO_CHECK_REASON_CODE = 'no-check-available';
+/** The record in plain words, without a lead and without a final stop. */
+export function recordSentence(record) {
+    if (record === undefined)
+        return 'there is no record of this work';
+    const named = (command) => command === undefined ? 'a check' : (showCommand(command) ?? 'a command');
+    const passedCheck = [...record.checks].reverse().find((check) => check.result === 'passed');
+    switch (record.verdict) {
+        case 'checked':
+            return `${named(passedCheck?.command)} passed and nothing changed after it`;
+        case 'unchanged':
+            return passedCheck
+                ? `${named(passedCheck.command)} passed and nothing changed`
+                : 'nothing changed and no check ran';
+        case 'stale':
+            return 'files changed after the last passing check';
+        case 'failing': {
+            const failed = record.checks.filter((check) => check.result === 'failed');
+            const more = failed.length > 1 ? ` (and ${failed.length - 1} more)` : '';
+            return `${named(failed[0]?.command)} failed${more}`;
+        }
+        case 'unchecked':
+            return 'files changed and no check ran';
+        case 'inconclusive': {
+            const masked = record.checks.find((check) => check.result === 'masked');
+            if (masked) {
+                const how = /(?<!\|)\|(?!\|)/.test(masked.command) ? 'the pipe' : 'the command line';
+                return `${named(masked.command)} ran, but ${how} hides whether it passed`;
+            }
+            const unsettled = record.checks.find((check) => check.result === 'unsettled');
+            if (unsettled)
+                return `${named(unsettled.command)} ran, but its result was not seen`;
+            return 'files changed and no check gave a result that could be read';
+        }
+        case 'unknown':
+            return 'a command ran that may have changed files, and nothing could tell whether it did';
+    }
+}
+const HOW_TO_SAY_SO = 'To say so, call update_goal with status "blocked" and the reason if the check cannot be made to pass, or with status "complete", reasonCode "no-check-available" and the reason if no check exists here.';
+function refusalNote(record, earlierChanged) {
+    switch (record?.verdict) {
+        case 'failing':
+            return `The record says ${recordSentence(record)}. Fix what it reports and run it again, or say plainly that you could not make it pass. ${HOW_TO_SAY_SO}`;
+        case 'stale':
+            return `The record says ${recordSentence(record)}. Run the check again, or say plainly that you could not. ${HOW_TO_SAY_SO}`;
+        case 'unchecked':
+            return `The record says ${recordSentence(record)}. Run the project's check on the files as they are now, or say plainly that no check can be run here. ${HOW_TO_SAY_SO}`;
+        case 'inconclusive':
+            return `The record says ${recordSentence(record)}. Run the check again on its own so that its result can be read, or say plainly that you could not. ${HOW_TO_SAY_SO}`;
+        default:
+            return earlierChanged
+                ? `The record of this round says ${recordSentence(record)}, and an earlier round of this goal changed files. Run the project's check on the files as they are now, or say plainly that you could not. ${HOW_TO_SAY_SO}`
+                : `The record says ${recordSentence(record)}. Run the check, or say plainly that you could not. ${HOW_TO_SAY_SO}`;
+    }
+}
+/**
+ * What to do with the model's report of a goal, given the record.
+ *
+ * - The model says it could not: the goal ends `not-confirmed`; it is never
+ *   pushed again.
+ * - The model says no check exists: `stated-not-checked`, unless the record
+ *   holds a failing or stale check (`not-confirmed`) or a passing one
+ *   (`confirmed`).
+ * - The model says it is met: a passing check with nothing changed after it is
+ *   `confirmed`; a failing check, files changed after the last pass, files
+ *   changed and no check, or a check whose result could not be read are refused
+ *   while refusals remain and `not-confirmed` once they do not; nothing
+ *   changed, a command that may have changed files (`unknown`) or no record at
+ *   all is `stated-not-checked`. `unknown` is not refused on purpose: the
+ *   record keeps it for the whole turn, so no later check could clear it and a
+ *   refusal would only cost calls until the bound.
+ */
+export function decideGoalConfirmation(input) {
+    const { statement, record, refusals, maxRefusals } = input;
+    const sentence = recordSentence(record);
+    if (statement === 'could-not')
+        return { kind: 'end', ending: 'not-confirmed', sentence };
+    const verdict = record?.verdict;
+    if (verdict === 'checked')
+        return { kind: 'end', ending: 'confirmed', sentence };
+    if (verdict === 'unchanged' &&
+        record?.checks.some((check) => check.result === 'passed' && check.fresh !== false)) {
+        return { kind: 'end', ending: 'confirmed', sentence };
+    }
+    const contradicted = verdict === 'failing' || verdict === 'stale';
+    if (statement === 'no-check') {
+        return contradicted
+            ? { kind: 'end', ending: 'not-confirmed', sentence }
+            : { kind: 'end', ending: 'stated-not-checked', sentence };
+    }
+    const earlierChanged = input.earlierRoundsChanged === true;
+    const refusable = contradicted ||
+        verdict === 'unchecked' ||
+        verdict === 'inconclusive' ||
+        (verdict === 'unchanged' && earlierChanged);
+    if (!refusable)
+        return { kind: 'end', ending: 'stated-not-checked', sentence };
+    if (refusals >= Math.max(0, maxRefusals)) {
+        return { kind: 'end', ending: 'not-confirmed', sentence };
+    }
+    return { kind: 'refuse', sentence, note: refusalNote(record, earlierChanged) };
+}
+/** The closing line of a goal: which of the three endings it was and, always, what the record held. */
+export function describeGoalEnding(report) {
+    if (report.handedBack) {
+        return `Goal not confirmed: the model handed the task back to a person (${report.sentence}).`;
+    }
+    switch (report.ending) {
+        case 'confirmed':
+            return `Goal confirmed by the record: ${report.sentence}.`;
+        case 'stated-not-checked':
+            return `Goal stated, not checked: the record cannot confirm it (${report.sentence}).`;
+        case 'not-confirmed':
+            return `Goal not confirmed: the record says ${report.sentence}.`;
+    }
+}
+/**
+ * Holds, for one session, what the model reported this turn, how many times a
+ * goal was sent back, and whether an earlier round of it changed files. All of
+ * it lives in memory: a restart begins the count again, which is the cautious
+ * side of the bound only in that the model gets its refusals again.
+ */
+export class GoalConfirmation {
+    options;
+    claims = new Map();
+    refusals = new Map();
+    changed = new Set();
+    endings = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    /** What decides this goal: its own choice, else the host's setting, else the model. */
+    confirmedByFor(goal) {
+        return goal.confirmedBy ?? this.options.defaultConfirmedBy ?? 'model';
+    }
+    get maxRefusals() {
+        return this.options.maxRefusals ?? DEFAULT_GOAL_REFUSALS;
+    }
+    /** Refusals given to a goal so far. */
+    refusalsFor(goalId) {
+        return this.refusals.get(goalId) ?? 0;
+    }
+    /**
+     * The model reported on the goal in the round now running; the record is read
+     * when it finishes its answer. Held by goal, because only one round of a goal
+     * runs at a time and a round that ends without an answer leaves the goal
+     * active: the next report replaces this one.
+     */
+    claim(goalId, statement, reason) {
+        this.claims.set(goalId, { statement, ...(reason !== undefined ? { reason } : {}) });
+    }
+    /** The ending the turn's goal came to, once; `undefined` when it did not end here. */
+    takeEnding(turnId) {
+        const ending = this.endings.get(turnId);
+        this.endings.delete(turnId);
+        return ending;
+    }
+    /**
+     * The model handed this round's task back to a person: the goal, when this
+     * turn is a round of an active one, ends as not confirmed and is left blocked
+     * with the reason, whatever it was confirmed by. Nothing for any other turn.
+     */
+    async handBack(turnId, handBack) {
+        const authority = this.options.resolveAuthority(turnId);
+        if (!authority)
+            return undefined;
+        const goal = await this.options.store.getGoal(authority.sessionId, authority.tenantId);
+        if (!goal || goal.id !== authority.id || goal.phase !== 'active')
+            return undefined;
+        const ref = { id: authority.id, revision: authority.revision };
+        try {
+            await this.options.store.blockGoal(authority.sessionId, authority.tenantId, ref, {
+                code: 'handed-back-to-a-person',
+                message: handBackReason(handBack),
+            });
+        }
+        catch (error) {
+            if (error instanceof StaleGoalError)
+                return undefined;
+            throw error;
+        }
+        const report = {
+            goalId: goal.id,
+            ending: 'not-confirmed',
+            sentence: handBackKindSentence(handBack.kind),
+            refusals: this.refusalsFor(goal.id),
+            handedBack: handBack,
+        };
+        this.claims.delete(goal.id);
+        this.refusals.delete(goal.id);
+        this.changed.delete(goal.id);
+        return report;
+    }
+    /** Drop a report that was never answered for, when its round ends without the turn finishing an answer. */
+    forget(goalId) {
+        this.claims.delete(goalId);
+    }
+    /**
+     * For `TurnConfig.outcome.beforeEnd`: the note that sends the model back to
+     * the work, or `undefined` when the turn may end. A turn that is not a round
+     * of a goal confirmed by the record is never touched.
+     */
+    beforeEnd(turnId) {
+        return async (read) => {
+            const authority = this.options.resolveAuthority(turnId);
+            if (!authority)
+                return undefined;
+            const goal = await this.options.store.getGoal(authority.sessionId, authority.tenantId);
+            if (!goal || goal.id !== authority.id || goal.phase !== 'active')
+                return undefined;
+            if (this.confirmedByFor(goal) !== 'record')
+                return undefined;
+            const record = await read();
+            const claim = this.claims.get(goal.id);
+            this.claims.delete(goal.id);
+            const changedHere = (record?.changes.total ?? 0) > 0 || record?.changes.outsideKnownTools;
+            if (!claim) {
+                if (changedHere)
+                    this.changed.add(goal.id);
+                return undefined;
+            }
+            const decision = decideGoalConfirmation({
+                statement: claim.statement,
+                record,
+                refusals: this.refusalsFor(goal.id),
+                maxRefusals: this.maxRefusals,
+                earlierRoundsChanged: this.changed.has(goal.id),
+            });
+            if (changedHere)
+                this.changed.add(goal.id);
+            if (decision.kind === 'refuse') {
+                this.refusals.set(goal.id, this.refusalsFor(goal.id) + 1);
+                return decision.note;
+            }
+            const ref = { id: authority.id, revision: authority.revision };
+            try {
+                if (decision.ending === 'not-confirmed') {
+                    const said = claim.reason ? ` The model said: ${claim.reason}` : '';
+                    await this.options.store.blockGoal(authority.sessionId, authority.tenantId, ref, {
+                        code: 'not-confirmed-by-record',
+                        message: `The record says ${decision.sentence}.${said}`,
+                    });
+                }
+                else {
+                    await this.options.store.completeGoal(authority.sessionId, authority.tenantId, ref);
+                }
+            }
+            catch (error) {
+                // The person changed the goal while the model was answering; what they
+                // did stands, and nothing is said about an ending that did not happen.
+                if (error instanceof StaleGoalError)
+                    return undefined;
+                throw error;
+            }
+            this.endings.set(turnId, {
+                goalId: goal.id,
+                ending: decision.ending,
+                sentence: decision.sentence,
+                refusals: this.refusalsFor(goal.id),
+            });
+            this.refusals.delete(goal.id);
+            this.changed.delete(goal.id);
+            return undefined;
+        };
+    }
+}
+//# sourceMappingURL=confirmation.js.map

package/dist/tools/goal/confirmation.js.map

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

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

@@ -2,6 +2,7 @@ import { type SessionGoalStore } from '../../store/goal/index.js';
 import type { GoalRoundAuthority } from '../../types/goal/index.js';
 import type { TurnId } from '../../types/ids/index.js';
 import type { ToolDefinition } from '../../types/tool/index.js';
+import { type GoalConfirmation } from './confirmation.js';
 export declare const SESSION_GOAL_TOOL_NAMES: readonly ["get_goal", "update_goal"];
 export declare const MIN_GOAL_BLOCK_ROUND = 3;
 /**
@@ -20,5 +21,7 @@ export declare class GoalRoundAuthorityError extends Error {
  * Registration is not authorization. A host must also withhold these names
  * from every non-goal provider request and executor allow-list.
  */
-export declare function buildSessionGoalTools(store: SessionGoalStore, resolveAuthority: ResolveGoalRoundAuthority): ToolDefinition[];
+export declare function buildSessionGoalTools(store: SessionGoalStore, resolveAuthority: ResolveGoalRoundAuthority, options?: {
+    readonly confirmation?: GoalConfirmation;
+}): ToolDefinition[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/goal/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,gBAAgB,EAAkB,MAAM,2BAA2B,CAAA;AACpG,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,2BAA2B,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,eAAO,MAAM,uBAAuB,sCAAuC,CAAA;AAC3E,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAA;AAEjG,kFAAkF;AAClF,qBAAa,uBAAwB,SAAQ,KAAK;gBACrC,MAAM,EAAE,MAAM;CAI1B;AA2BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,gBAAgB,EACvB,gBAAgB,EAAE,yBAAyB,GACzC,cAAc,EAAE,CAwElB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/goal/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,gBAAgB,EAAkB,MAAM,2BAA2B,CAAA;AACpG,OAAO,KAAK,EAAE,kBAAkB,EAAe,MAAM,2BAA2B,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,mBAAmB,CAAA;AAE/E,eAAO,MAAM,uBAAuB,sCAAuC,CAAA;AAC3E,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAErC;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAAA;AAEjG,kFAAkF;AAClF,qBAAa,uBAAwB,SAAQ,KAAK;gBACrC,MAAM,EAAE,MAAM;CAI1B;AA2BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,gBAAgB,EACvB,gBAAgB,EAAE,yBAAyB,EAC3C,OAAO,GAAE;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAA;CAAO,GACxD,cAAc,EAAE,CA0GlB"}

package/dist/tools/goal/index.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { GoalNotFoundError, StaleGoalError } from '../../store/goal/index.js';
 import { defineTool } from '../defineTool.js';
+import { NO_CHECK_REASON_CODE } from './confirmation.js';
 export const SESSION_GOAL_TOOL_NAMES = ['get_goal', 'update_goal'];
 export const MIN_GOAL_BLOCK_ROUND = 3;
 /** A goal tool was reached outside the one turn whose admission authorized it. */
@@ -35,7 +36,7 @@ function authorityFor(resolveAuthority, turnId) {
  * Registration is not authorization. A host must also withhold these names
  * from every non-goal provider request and executor allow-list.
  */
-export function buildSessionGoalTools(store, resolveAuthority) {
+export function buildSessionGoalTools(store, resolveAuthority, options = {}) {
     const getGoal = defineTool({
         name: 'get_goal',
         description: 'Read the exact completion goal and admitted-round budget that authorized this automatic turn.',
@@ -80,8 +81,32 @@ export function buildSessionGoalTools(store, resolveAuthority) {
         concurrencySafe: false,
         async execute({ status, reasonCode, reason }, context) {
             const authority = authorityFor(resolveAuthority, context.turnId);
-            await currentGoal(store, authority);
+            const current = await currentGoal(store, authority);
             const ref = { id: authority.id, revision: authority.revision };
+            const confirmation = options.confirmation;
+            if (confirmation && confirmation.confirmedByFor(current) === 'record') {
+                // The report is held until the model finishes its answer; the kernel then
+                // reads the record of the work and the goal ends as the record allows.
+                if (status === 'complete') {
+                    confirmation.claim(authority.id, reasonCode === NO_CHECK_REASON_CODE ? 'no-check' : 'met', reason);
+                    return {
+                        success: true,
+                        output: 'Completion reported. This goal is confirmed by the record: when you finish your answer the kernel reads the record of the work done, and the goal ends as that record allows. Give your final answer now.',
+                    };
+                }
+                if (authority.round < MIN_GOAL_BLOCK_ROUND &&
+                    confirmation.refusalsFor(authority.id) === 0) {
+                    throw new Error(`A goal cannot be marked blocked before admitted round ${MIN_GOAL_BLOCK_ROUND}, unless the record has already sent it back once; this is round ${authority.round}.`);
+                }
+                if (!reasonCode || !reason) {
+                    throw new TypeError('Blocked goal updates require reasonCode and reason.');
+                }
+                confirmation.claim(authority.id, 'could-not', reason);
+                return {
+                    success: true,
+                    output: 'Reported as not met. The goal ends as not confirmed when you finish your answer, and the record of the work is shown with your reason. Give your final answer now.',
+                };
+            }
             if (status === 'complete') {
                 const goal = await store.completeGoal(authority.sessionId, authority.tenantId, ref);
                 return { success: true, output: 'Goal marked complete.', data: goal };

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

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

package/dist/tools/hand-back/index.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import type { HandBack, HandBackKind } from '../../types/session/hand-back.js';
+import type { ToolDefinition } from '../../types/tool/index.js';
+/** The name the model calls. */
+export declare const HAND_BACK_TOOL_NAME = "hand_back_task";
+/** Each of the three sentences is cut to this many characters when it is kept. */
+export declare const HAND_BACK_MAX_CHARS = 800;
+/** What the model is told when the setting is on. One place, added to the static prompt. */
+export declare const HAND_BACK_GUIDANCE = "## Handing a task back\nIf the task cannot be done as specified, call `hand_back_task` instead of forcing a result: it ends the turn and tells a person what blocks you, what you tried and what they must decide or provide. Never weaken, skip, delete or special-case a check to make it pass; if the request and its checks cannot both hold, hand it back. Hand back only what you could not finish.";
+/**
+ * What the tool answers when the hand-back was accepted. A saved conversation
+ * holds this receipt beside the call, so a reader can tell an accepted call
+ * (the turn ended there) from one that was refused.
+ */
+export declare const HAND_BACK_RECEIPT = "Handed back to a person.";
+/** The id of the prompt contribution that carries {@link HAND_BACK_GUIDANCE}. */
+export declare const HAND_BACK_GUIDANCE_CONTRIBUTION_ID = "namzu.hand-back";
+export declare const HandBackInputSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        decision: "decision";
+        missing: "missing";
+        conflict: "conflict";
+    }>;
+    blocker: z.ZodString;
+    tried: z.ZodString;
+    needed: z.ZodString;
+}, z.core.$strip>;
+/**
+ * The hand-back a tool call's input holds, or `undefined` when it is not one.
+ * Never throws; text is stripped of control and bidirectional characters, whitespace-folded and clipped.
+ */
+export declare function parseHandBack(input: unknown): HandBack | undefined;
+/** The kernel's own sentence for a kind; the model's words are never part of it. */
+export declare function handBackKindSentence(kind: HandBackKind): string;
+/** The closing line in the kernel's words: `The model handed the task back: <kind>.` */
+export declare function describeHandBack(handBack: HandBack): string;
+/**
+ * The model's three sentences, labelled as the model's, one per line. The
+ * labels are the kernel's; every value after a label is the model's own text.
+ */
+export declare function handBackModelLines(handBack: HandBack): readonly string[];
+/** The one-line reason a goal or a scheduled run records. */
+export declare function handBackReason(handBack: HandBack): string;
+/** What a refused sibling call is told in the step that handed the task back. */
+export declare const HAND_BACK_SIBLING_REFUSAL = "Not run: this step handed the task back to a person with hand_back_task, and the turn ends there.";
+/** The tool. Offered only when `TurnConfig.handBack` is on. */
+export declare function buildHandBackTool(): ToolDefinition;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/hand-back/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/hand-back/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,mBAAmB,CAAA;AAEnD,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,MAAM,CAAA;AAEtC,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,8YAC6V,CAAA;AAE5X;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,6BAA6B,CAAA;AAE3D,iFAAiF;AACjF,eAAO,MAAM,kCAAkC,oBAAoB,CAAA;AAInE,eAAO,MAAM,mBAAmB;;;;;;;;;iBAS9B,CAAA;AAgCF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAalE;AAQD,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAMxE;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,sGAA8G,CAAA;AAEpJ,+DAA+D;AAC/D,wBAAgB,iBAAiB,IAAI,cAAc,CAwBlD"}

package/dist/tools/hand-back/index.js

@@ -0,0 +1,129 @@
+import { z } from 'zod';
+import { defineTool } from '../defineTool.js';
+/** The name the model calls. */
+export const HAND_BACK_TOOL_NAME = 'hand_back_task';
+/** Each of the three sentences is cut to this many characters when it is kept. */
+export const HAND_BACK_MAX_CHARS = 800;
+/** What the model is told when the setting is on. One place, added to the static prompt. */
+export const HAND_BACK_GUIDANCE = `## Handing a task back
+If the task cannot be done as specified, call \`${HAND_BACK_TOOL_NAME}\` instead of forcing a result: it ends the turn and tells a person what blocks you, what you tried and what they must decide or provide. Never weaken, skip, delete or special-case a check to make it pass; if the request and its checks cannot both hold, hand it back. Hand back only what you could not finish.`;
+/**
+ * What the tool answers when the hand-back was accepted. A saved conversation
+ * holds this receipt beside the call, so a reader can tell an accepted call
+ * (the turn ended there) from one that was refused.
+ */
+export const HAND_BACK_RECEIPT = 'Handed back to a person.';
+/** The id of the prompt contribution that carries {@link HAND_BACK_GUIDANCE}. */
+export const HAND_BACK_GUIDANCE_CONTRIBUTION_ID = 'namzu.hand-back';
+const text = z.string().trim().min(1);
+export const HandBackInputSchema = z.object({
+    kind: z
+        .enum(['conflict', 'missing', 'decision'])
+        .describe('conflict: request and checks disagree. missing: something needed is missing or not allowed. decision: the person must decide.'),
+    blocker: text.describe('What blocks you.'),
+    tried: text.describe('What you tried.'),
+    needed: text.describe('What a person has to decide or provide.'),
+});
+/** Control, invisible-format and bidirectional code points: none of them is text a person reads. */
+const UNSHOWN = [
+    [0x0000, 0x001f],
+    [0x007f, 0x009f],
+    [0x00ad, 0x00ad],
+    [0x061c, 0x061c],
+    [0x180e, 0x180e],
+    [0x200b, 0x200f],
+    [0x2028, 0x202e],
+    [0x2060, 0x206f],
+    [0xfeff, 0xfeff],
+    [0xfff9, 0xfffb],
+];
+/** Whitespace-like controls become a space; every other unshown code point is dropped. */
+const cleaned = (value) => {
+    let out = '';
+    for (const ch of value) {
+        const code = ch.codePointAt(0) ?? 0;
+        if (code === 0x09 || code === 0x0a || code === 0x0d)
+            out += ' ';
+        else if (!UNSHOWN.some(([lo, hi]) => code >= lo && code <= hi))
+            out += ch;
+    }
+    return out;
+};
+const clip = (value) => {
+    const flat = cleaned(value).replace(/\s+/g, ' ').trim();
+    return flat.length > HAND_BACK_MAX_CHARS ? `${flat.slice(0, HAND_BACK_MAX_CHARS - 1)}…` : flat;
+};
+/**
+ * The hand-back a tool call's input holds, or `undefined` when it is not one.
+ * Never throws; text is stripped of control and bidirectional characters, whitespace-folded and clipped.
+ */
+export function parseHandBack(input) {
+    let value = input;
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const parsed = HandBackInputSchema.safeParse(value);
+    if (!parsed.success)
+        return undefined;
+    const { kind, blocker, tried, needed } = parsed.data;
+    return { kind, blocker: clip(blocker), tried: clip(tried), needed: clip(needed) };
+}
+const KIND_SENTENCE = {
+    conflict: 'the request conflicts with itself or with its checks',
+    missing: 'something needed is missing or not allowed',
+    decision: 'a decision is needed that belongs to a person',
+};
+/** The kernel's own sentence for a kind; the model's words are never part of it. */
+export function handBackKindSentence(kind) {
+    return KIND_SENTENCE[kind] ?? KIND_SENTENCE.decision;
+}
+/** The closing line in the kernel's words: `The model handed the task back: <kind>.` */
+export function describeHandBack(handBack) {
+    return `The model handed the task back to a person: ${handBackKindSentence(handBack.kind)}.`;
+}
+/**
+ * The model's three sentences, labelled as the model's, one per line. The
+ * labels are the kernel's; every value after a label is the model's own text.
+ */
+export function handBackModelLines(handBack) {
+    return [
+        `The model says it is blocked by: ${handBack.blocker}`,
+        `It tried: ${handBack.tried}`,
+        `It needs a person to: ${handBack.needed}`,
+    ];
+}
+/** The one-line reason a goal or a scheduled run records. */
+export function handBackReason(handBack) {
+    return `${describeHandBack(handBack).replace(/\.$/, '')}. The model said: ${handBack.blocker}`;
+}
+/** What a refused sibling call is told in the step that handed the task back. */
+export const HAND_BACK_SIBLING_REFUSAL = `Not run: this step handed the task back to a person with ${HAND_BACK_TOOL_NAME}, and the turn ends there.`;
+/** The tool. Offered only when `TurnConfig.handBack` is on. */
+export function buildHandBackTool() {
+    return defineTool({
+        name: HAND_BACK_TOOL_NAME,
+        description: 'Hand the task back to a person when it cannot be done as specified. Ends the turn: nothing else runs after it.',
+        inputSchema: HandBackInputSchema,
+        category: 'custom',
+        permissions: [],
+        readOnly: true,
+        destructive: false,
+        concurrencySafe: false,
+        async execute(input) {
+            const handBack = parseHandBack(input);
+            if (!handBack)
+                throw new TypeError('The hand-back needs a kind, a blocker, what was tried and what is needed.');
+            return {
+                success: true,
+                output: `${HAND_BACK_RECEIPT} The turn ends now; nothing more will run and no further answer is needed.`,
+                data: handBack,
+            };
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/hand-back/index.js.map

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

package/dist/tools/schedules/schedule-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schedule-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/schedules/schedule-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAc,MAAM,2BAA2B,CAAA;AAKxF,OAAO,KAAK,EAOX,gBAAgB,EAChB,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,kBAAkB,aAAa,CAAA;AA4iB5C;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAkC3E"}
+{"version":3,"file":"schedule-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/schedules/schedule-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAc,MAAM,2BAA2B,CAAA;AAKxF,OAAO,KAAK,EAOX,gBAAgB,EAChB,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,kBAAkB,aAAa,CAAA;AA8jB5C;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAkC3E"}