openhorse 0.2.23 → 0.2.24

package/dist/runtime/goals/accounting.d.ts

@@ -0,0 +1,17 @@
+/**
+ * v0.2.24 — Goal Accounting.
+ *
+ * Token and time ledger for goal-level usage tracking.
+ * Deduplicates subagent usage, prevents double-counting across retries.
+ */
+import type { AgentTurnOutcome } from './types';
+export interface GoalAccounting {
+    tokensUsed: number;
+    timeUsedMs: number;
+    continuationCount: number;
+    noProgressCount: number;
+}
+export declare function accumulateTurn(accounting: GoalAccounting, outcome: AgentTurnOutcome): GoalAccounting;
+export declare function isBudgetExceeded(tokensUsed: number, tokenBudget?: number): boolean;
+export declare function formatGoalUsage(accounting: GoalAccounting): string;
+//# sourceMappingURL=accounting.d.ts.map

package/dist/runtime/goals/accounting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounting.d.ts","sourceRoot":"","sources":["../../../src/runtime/goals/accounting.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAOhB;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAGT;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAMlE"}

package/dist/runtime/goals/accounting.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * v0.2.24 — Goal Accounting.
+ *
+ * Token and time ledger for goal-level usage tracking.
+ * Deduplicates subagent usage, prevents double-counting across retries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.accumulateTurn = accumulateTurn;
+exports.isBudgetExceeded = isBudgetExceeded;
+exports.formatGoalUsage = formatGoalUsage;
+function accumulateTurn(accounting, outcome) {
+    return {
+        tokensUsed: accounting.tokensUsed + outcome.usage.totalTokens,
+        timeUsedMs: accounting.timeUsedMs + (outcome.endedAt - outcome.startedAt),
+        continuationCount: accounting.continuationCount + 1,
+        noProgressCount: outcome.madeProgress ? 0 : accounting.noProgressCount + 1,
+    };
+}
+function isBudgetExceeded(tokensUsed, tokenBudget) {
+    if (tokenBudget === undefined || tokenBudget <= 0)
+        return false;
+    return tokensUsed >= tokenBudget;
+}
+function formatGoalUsage(accounting) {
+    const tokens = accounting.tokensUsed >= 1000
+        ? `${(accounting.tokensUsed / 1000).toFixed(1)}K`
+        : String(accounting.tokensUsed);
+    const time = formatDuration(accounting.timeUsedMs);
+    return `${accounting.continuationCount} turns · ${tokens} tokens · ${time}`;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60)
+        return `${minutes}m ${remainingSeconds}s`;
+    const hours = Math.floor(minutes / 60);
+    return `${hours}h ${minutes % 60}m`;
+}
+//# sourceMappingURL=accounting.js.map

package/dist/runtime/goals/accounting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounting.js","sourceRoot":"","sources":["../../../src/runtime/goals/accounting.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAWH,wCAUC;AAED,4CAMC;AAED,0CAMC;AA1BD,SAAgB,cAAc,CAC5B,UAA0B,EAC1B,OAAyB;IAEzB,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW;QAC7D,UAAU,EAAE,UAAU,CAAC,UAAU,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;QACzE,iBAAiB,EAAE,UAAU,CAAC,iBAAiB,GAAG,CAAC;QACnD,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,eAAe,GAAG,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,SAAgB,gBAAgB,CAC9B,UAAkB,EAClB,WAAoB;IAEpB,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,UAAU,IAAI,WAAW,CAAC;AACnC,CAAC;AAED,SAAgB,eAAe,CAAC,UAA0B;IACxD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,IAAI,IAAI;QAC1C,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;QACjD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,GAAG,UAAU,CAAC,iBAAiB,YAAY,MAAM,aAAa,IAAI,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,EAAU;IAChC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,GAAG,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAC;IACtC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,KAAK,gBAAgB,GAAG,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;AACtC,CAAC"}

package/dist/runtime/goals/completion-audit.d.ts

@@ -0,0 +1,24 @@
+/**
+ * v0.2.24 — Goal Completion & Blocked Audit.
+ *
+ * Two-phase terminal-state audit. Model requests complete/blocked via
+ * update_goal tool; Coordinator runs audit after turn persistence.
+ */
+import type { GoalCompletionAudit, GoalBlocker } from './types';
+export interface CompletionAuditInput {
+    objective: string;
+    evidenceRefs: string[];
+    verificationSummary: string;
+}
+export declare function auditCompletion(input: CompletionAuditInput): GoalCompletionAudit;
+export interface BlockedAuditInput {
+    blocker: GoalBlocker;
+    noProgressCount: number;
+}
+export declare function auditBlocked(input: BlockedAuditInput): {
+    allowed: boolean;
+    reason: string;
+};
+export declare function blockerFingerprint(category: string, resource: string, reason: string): string;
+export declare function blockersMatch(a: GoalBlocker | undefined, fingerprint: string): boolean;
+//# sourceMappingURL=completion-audit.d.ts.map

package/dist/runtime/goals/completion-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-audit.d.ts","sourceRoot":"","sources":["../../../src/runtime/goals/completion-audit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,mBAAmB,CAWhF;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAcA;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGtF"}

package/dist/runtime/goals/completion-audit.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * v0.2.24 — Goal Completion & Blocked Audit.
+ *
+ * Two-phase terminal-state audit. Model requests complete/blocked via
+ * update_goal tool; Coordinator runs audit after turn persistence.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditCompletion = auditCompletion;
+exports.auditBlocked = auditBlocked;
+exports.blockerFingerprint = blockerFingerprint;
+exports.blockersMatch = blockersMatch;
+function auditCompletion(input) {
+    const now = Date.now();
+    const passed = input.evidenceRefs.length > 0 && input.verificationSummary.length > 0;
+    return {
+        requestedAt: now,
+        auditedAt: now,
+        passed,
+        verificationSummary: input.verificationSummary || 'No verification evidence provided.',
+        remainingRequirements: passed ? [] : ['Verification evidence required before completion.'],
+        evidenceRefs: input.evidenceRefs,
+    };
+}
+function auditBlocked(input) {
+    if (input.blocker.consecutiveTurns < 3) {
+        return {
+            allowed: false,
+            reason: `Blocker seen ${input.blocker.consecutiveTurns}/3 required turns.`,
+        };
+    }
+    if (input.noProgressCount < 3) {
+        return {
+            allowed: false,
+            reason: 'Progress was made in recent turns; blocking not justified.',
+        };
+    }
+    return { allowed: true, reason: `Blocker persisted for ${input.blocker.consecutiveTurns} consecutive turns with no progress.` };
+}
+function blockerFingerprint(category, resource, reason) {
+    return `${category}:${resource}:${reason}`;
+}
+function blockersMatch(a, fingerprint) {
+    if (!a)
+        return false;
+    return a.fingerprint === fingerprint;
+}
+//# sourceMappingURL=completion-audit.js.map

package/dist/runtime/goals/completion-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-audit.js","sourceRoot":"","sources":["../../../src/runtime/goals/completion-audit.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAUH,0CAWC;AAOD,oCAiBC;AAED,gDAEC;AAED,sCAGC;AA5CD,SAAgB,eAAe,CAAC,KAA2B;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;IACrF,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,GAAG;QACd,MAAM;QACN,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,oCAAoC;QACtF,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,mDAAmD,CAAC;QAC1F,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;AACJ,CAAC;AAOD,SAAgB,YAAY,CAAC,KAAwB;IAInD,IAAI,KAAK,CAAC,OAAO,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gBAAgB,KAAK,CAAC,OAAO,CAAC,gBAAgB,oBAAoB;SAC3E,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,4DAA4D;SACrE,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,yBAAyB,KAAK,CAAC,OAAO,CAAC,gBAAgB,sCAAsC,EAAE,CAAC;AAClI,CAAC;AAED,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,QAAgB,EAAE,MAAc;IACnF,OAAO,GAAG,QAAQ,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,SAAgB,aAAa,CAAC,CAA0B,EAAE,WAAmB;IAC3E,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC;AACvC,CAAC"}

package/dist/runtime/goals/coordinator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * v0.2.24 — Goal Coordinator.
+ *
+ * Single-flight state machine that manages goal lifecycle: creation,
+ * pause/resume, auto-continuation, completion/blocked audit, and
+ * persistence. Owned by AgentRuntimeController — NOT a global singleton.
+ */
+import { type SessionGoalV1, type RuntimeGoalSnapshot, type AgentTurnOutcome, type AgentTurnRequest } from './types';
+export interface GoalCoordinatorState {
+    goal: SessionGoalV1 | null;
+    generation: number;
+    continuationDeferred: boolean;
+}
+export declare class GoalCoordinator {
+    private readonly projectPath;
+    private readonly sessionId;
+    private state;
+    constructor(projectPath: string, sessionId: string);
+    get goal(): SessionGoalV1 | null;
+    get generation(): number;
+    get isActive(): boolean;
+    get canContinue(): boolean;
+    snapshot(): RuntimeGoalSnapshot | null;
+    load(): boolean;
+    create(objective: string): {
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    };
+    pause(): boolean;
+    resume(): boolean;
+    edit(objective: string): boolean;
+    replace(objective: string): boolean;
+    setBudget(tokenBudget: number | null): boolean;
+    clear(): boolean;
+    buildContinuationRequest(): AgentTurnRequest | null;
+    finalizeTurn(outcome: AgentTurnOutcome): void;
+    deferContinuation(): void;
+    private persist;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/runtime/goals/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/runtime/goals/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAExB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAItB,MAAM,SAAS,CAAC;AAUjB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,KAAK,CAAoF;gBAG9E,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM;IAOpC,IAAI,IAAI,IAAI,aAAa,GAAG,IAAI,CAA4B;IAC5D,IAAI,UAAU,IAAI,MAAM,CAAkC;IAC1D,IAAI,QAAQ,IAAI,OAAO,CAAiD;IACxE,IAAI,WAAW,IAAI,OAAO,CAIzB;IAED,QAAQ,IAAI,mBAAmB,GAAG,IAAI;IAqBtC,IAAI,IAAI,OAAO;IAWf,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAoBtE,KAAK,IAAI,OAAO;IAchB,MAAM,IAAI,OAAO;IAiBjB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAahC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAWnC,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO;IAY9C,KAAK,IAAI,OAAO;IAahB,wBAAwB,IAAI,gBAAgB,GAAG,IAAI;IAgBnD,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAoF7C,iBAAiB,IAAI,IAAI;IAkBzB,OAAO,CAAC,OAAO;CAIhB"}

package/dist/runtime/goals/coordinator.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * v0.2.24 — Goal Coordinator.
+ *
+ * Single-flight state machine that manages goal lifecycle: creation,
+ * pause/resume, auto-continuation, completion/blocked audit, and
+ * persistence. Owned by AgentRuntimeController — NOT a global singleton.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoalCoordinator = void 0;
+const types_1 = require("./types");
+const goal_storage_1 = require("../../services/goal-storage");
+const accounting_1 = require("./accounting");
+const completion_audit_1 = require("./completion-audit");
+class GoalCoordinator {
+    constructor(projectPath, sessionId) {
+        this.projectPath = projectPath;
+        this.sessionId = sessionId;
+        this.state = { goal: null, generation: 0, continuationDeferred: false };
+    }
+    // ==========================================================================
+    // Queries
+    // ==========================================================================
+    get goal() { return this.state.goal; }
+    get generation() { return this.state.generation; }
+    get isActive() { return this.state.goal?.status === 'active'; }
+    get canContinue() {
+        return this.isActive
+            && !this.state.continuationDeferred
+            && !(0, accounting_1.isBudgetExceeded)(this.state.goal.tokensUsed, this.state.goal.tokenBudget);
+    }
+    snapshot() {
+        const g = this.state.goal;
+        if (!g)
+            return null;
+        return {
+            goalId: g.goalId,
+            revision: g.revision,
+            objective: g.objective,
+            status: g.status,
+            tokenBudget: g.tokenBudget,
+            tokensUsed: g.tokensUsed,
+            timeUsedMs: g.timeUsedMs,
+            continuationCount: g.continuationCount,
+            updatedAt: g.updatedAt,
+            stopReason: g.stopReason?.message,
+        };
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    load() {
+        const result = (0, goal_storage_1.loadGoal)(this.projectPath, this.sessionId);
+        if (result.ok) {
+            this.state.goal = result.value;
+            this.state.generation = 0;
+            this.state.continuationDeferred = false;
+            return true;
+        }
+        return false;
+    }
+    create(objective) {
+        if (this.state.goal && !types_1.GOAL_TERMINAL_STATES.has(this.state.goal.status)) {
+            return { ok: false, error: 'An active goal already exists. Use /target replace to change it.' };
+        }
+        if (!objective.trim()) {
+            return { ok: false, error: 'Objective cannot be empty.' };
+        }
+        if (objective.length > types_1.GOAL_INVARIANTS.maxObjectiveChars) {
+            return { ok: false, error: `Objective too long (max ${types_1.GOAL_INVARIANTS.maxObjectiveChars} chars).` };
+        }
+        const result = (0, goal_storage_1.createGoal)(this.projectPath, this.sessionId, objective);
+        if (!result.ok)
+            return { ok: false, error: result.message };
+        this.state.goal = result.value;
+        this.state.generation += 1;
+        this.state.continuationDeferred = false;
+        return { ok: true };
+    }
+    pause() {
+        if (!this.state.goal || this.state.goal.status !== 'active')
+            return false;
+        this.state.goal = {
+            ...this.state.goal,
+            status: 'paused',
+            revision: this.state.goal.revision + 1,
+            updatedAt: Date.now(),
+            stopReason: { kind: 'user', message: 'Paused by user.', at: Date.now() },
+        };
+        this.persist();
+        this.state.continuationDeferred = true;
+        return true;
+    }
+    resume() {
+        if (!this.state.goal || !types_1.GOAL_USER_RECOVERABLE_STATES.has(this.state.goal.status))
+            return false;
+        this.state.goal = {
+            ...this.state.goal,
+            status: 'active',
+            revision: this.state.goal.revision + 1,
+            updatedAt: Date.now(),
+            activeSince: Date.now(),
+            stopReason: undefined,
+            blocker: undefined,
+            noProgressCount: 0,
+        };
+        this.persist();
+        this.state.continuationDeferred = false;
+        return true;
+    }
+    edit(objective) {
+        if (!this.state.goal)
+            return false;
+        if (!objective.trim())
+            return false;
+        this.state.goal = {
+            ...this.state.goal,
+            objective: objective.trim(),
+            revision: this.state.goal.revision + 1,
+            updatedAt: Date.now(),
+        };
+        this.persist();
+        return true;
+    }
+    replace(objective) {
+        if (!objective.trim())
+            return false;
+        // Create new goal, old generation invalidated.
+        const result = (0, goal_storage_1.createGoal)(this.projectPath, this.sessionId, objective);
+        if (!result.ok)
+            return false;
+        this.state.goal = result.value;
+        this.state.generation += 1;
+        this.state.continuationDeferred = false;
+        return true;
+    }
+    setBudget(tokenBudget) {
+        if (!this.state.goal)
+            return false;
+        this.state.goal = {
+            ...this.state.goal,
+            tokenBudget: tokenBudget ?? undefined,
+            revision: this.state.goal.revision + 1,
+            updatedAt: Date.now(),
+        };
+        this.persist();
+        return true;
+    }
+    clear() {
+        if (!this.state.goal)
+            return false;
+        (0, goal_storage_1.deleteGoal)(this.projectPath, this.sessionId);
+        this.state.goal = null;
+        this.state.generation += 1;
+        this.state.continuationDeferred = false;
+        return true;
+    }
+    // ==========================================================================
+    // Turn integration
+    // ==========================================================================
+    buildContinuationRequest() {
+        if (!this.canContinue)
+            return null;
+        const g = this.state.goal;
+        return {
+            inputKind: 'goal_continuation',
+            sessionId: this.sessionId,
+            persistAsUserMessage: false,
+            echoToTranscript: false,
+            goal: {
+                goalId: g.goalId,
+                revision: g.revision,
+                continuationIndex: g.continuationCount + 1,
+            },
+        };
+    }
+    finalizeTurn(outcome) {
+        const g = this.state.goal;
+        if (!g)
+            return;
+        if (outcome.goalId !== g.goalId || outcome.goalRevision !== g.revision)
+            return;
+        // Accumulate usage.
+        const acc = (0, accounting_1.accumulateTurn)({ tokensUsed: g.tokensUsed, timeUsedMs: g.timeUsedMs, continuationCount: g.continuationCount, noProgressCount: g.noProgressCount }, outcome);
+        const updated = {
+            ...g,
+            tokensUsed: acc.tokensUsed,
+            timeUsedMs: acc.timeUsedMs,
+            continuationCount: acc.continuationCount,
+            noProgressCount: acc.noProgressCount,
+            revision: g.revision + 1,
+            updatedAt: Date.now(),
+            lastTurn: {
+                turnId: outcome.turnId,
+                finishReason: outcome.finishReason,
+                endedAt: outcome.endedAt,
+                promptTokens: outcome.usage.promptTokens,
+                completionTokens: outcome.usage.completionTokens,
+                subagentTokens: outcome.usage.subagentTokens,
+                totalTokens: outcome.usage.totalTokens,
+                madeProgress: outcome.madeProgress,
+            },
+        };
+        // Process pending terminal request.
+        if (outcome.pendingTerminalRequest) {
+            if (outcome.pendingTerminalRequest.requestedStatus === 'complete') {
+                const audit = (0, completion_audit_1.auditCompletion)({
+                    objective: updated.objective,
+                    evidenceRefs: [],
+                    verificationSummary: '',
+                });
+                updated.completionAudit = audit;
+                if (audit.passed) {
+                    updated.status = 'complete';
+                    updated.completedAt = Date.now();
+                }
+            }
+            else if (outcome.pendingTerminalRequest.requestedStatus === 'blocked') {
+                const blocker = outcome.blocker;
+                if (blocker) {
+                    const fingerprint = (0, completion_audit_1.blockerFingerprint)(blocker.fingerprint, '', '');
+                    const same = (0, completion_audit_1.blockersMatch)(updated.blocker, fingerprint);
+                    const newBlocker = {
+                        fingerprint,
+                        firstSeenAt: same && updated.blocker ? updated.blocker.firstSeenAt : Date.now(),
+                        lastSeenAt: Date.now(),
+                        consecutiveTurns: same ? (updated.blocker?.consecutiveTurns ?? 0) + 1 : 1,
+                        summary: blocker.summary,
+                    };
+                    updated.blocker = newBlocker;
+                    const blockAudit = (0, completion_audit_1.auditBlocked)({ blocker: newBlocker, noProgressCount: updated.noProgressCount });
+                    if (blockAudit.allowed) {
+                        updated.status = 'blocked';
+                        updated.stopReason = { kind: 'blocked', message: blockAudit.reason, at: Date.now() };
+                    }
+                }
+            }
+        }
+        // Auto-pause on no-progress threshold.
+        if (updated.noProgressCount >= types_1.GOAL_INVARIANTS.maxConsecutiveNoProgressTurns && updated.status === 'active') {
+            updated.status = 'paused';
+            updated.stopReason = { kind: 'user', message: 'Auto-paused: no progress for 3 consecutive turns.', at: Date.now() };
+            this.state.continuationDeferred = true;
+        }
+        // Budget limit.
+        if ((0, accounting_1.isBudgetExceeded)(updated.tokensUsed, updated.tokenBudget) && updated.status === 'active') {
+            updated.status = 'budget_limited';
+            updated.stopReason = { kind: 'budget_limit', message: `Token budget reached: ${updated.tokensUsed}/${updated.tokenBudget}`, at: Date.now() };
+        }
+        this.state.goal = updated;
+        this.persist();
+    }
+    deferContinuation() {
+        if (!this.state.goal || this.state.goal.status !== 'active')
+            return;
+        this.state.continuationDeferred = true;
+        const g = this.state.goal;
+        this.state.goal = {
+            ...g,
+            status: 'paused',
+            revision: g.revision + 1,
+            updatedAt: Date.now(),
+            stopReason: { kind: 'user', message: 'Paused by interrupt.', at: Date.now() },
+        };
+        this.persist();
+    }
+    // ==========================================================================
+    // Persistence
+    // ==========================================================================
+    persist() {
+        if (!this.state.goal)
+            return;
+        (0, goal_storage_1.saveGoal)(this.projectPath, this.sessionId, this.state.goal);
+    }
+}
+exports.GoalCoordinator = GoalCoordinator;
+//# sourceMappingURL=coordinator.js.map

package/dist/runtime/goals/coordinator.js.map

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

package/dist/runtime/goals/prompt.d.ts

@@ -0,0 +1,16 @@
+/**
+ * v0.2.24 — Goal Prompt Fragment.
+ *
+ * Injects structured [Persistent Goal] context into the model prompt.
+ * Continuation instructions are ephemeral and never enter user transcript.
+ */
+import type { SessionGoalV1 } from './types';
+export interface GoalPromptFragment {
+    /** The assembled text to inject into the system prompt. */
+    text: string;
+    /** Estimated token count for this fragment. */
+    estimatedTokens: number;
+}
+export declare function buildGoalContextFragment(goal: SessionGoalV1 | null): GoalPromptFragment | null;
+export declare function buildContinuationInstruction(): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/runtime/goals/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/runtime/goals/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,kBAAkB,GAAG,IAAI,CAwB9F;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAUrD"}

package/dist/runtime/goals/prompt.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * v0.2.24 — Goal Prompt Fragment.
+ *
+ * Injects structured [Persistent Goal] context into the model prompt.
+ * Continuation instructions are ephemeral and never enter user transcript.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGoalContextFragment = buildGoalContextFragment;
+exports.buildContinuationInstruction = buildContinuationInstruction;
+function buildGoalContextFragment(goal) {
+    if (!goal || goal.status !== 'active')
+        return null;
+    const lines = [
+        '[Persistent Goal]',
+        `Goal ID: ${goal.goalId.slice(0, 8)}`,
+        `Status: ${goal.status}`,
+        `Objective: ${goal.objective}`,
+        `Progress: continuation ${goal.continuationCount}, tokens ${formatTokens(goal.tokensUsed)}${goal.tokenBudget ? ` / budget ${formatTokens(goal.tokenBudget)}` : ' / no explicit budget'}`,
+        '',
+        'Rules:',
+        '- Preserve the complete objective across turns.',
+        '- Inspect current worktree and external state; they are authoritative.',
+        '- Make concrete progress. A plan is not a substitute for execution.',
+        '- Do not mark complete until every requirement is verified.',
+        '- Do not mark blocked unless the same blocker persisted for 3 consecutive goal turns.',
+        '- User corrections refine the work but do not replace the objective unless /target edit/replace occurs.',
+    ];
+    const text = lines.join('\n');
+    // Rough estimate: ~1.3 tokens per word for English text.
+    const estimatedTokens = Math.ceil(text.split(/\s+/).length * 1.3);
+    return { text, estimatedTokens };
+}
+function buildContinuationInstruction() {
+    return [
+        'Continue pursuing the persistent goal.',
+        'Re-check the current worktree and external state before acting.',
+        'Review completed and remaining requirements against evidence.',
+        'Make concrete progress in this turn.',
+        'If fully verified, request goal completion.',
+        'If the same blocker has persisted for three consecutive goal turns, request blocked status.',
+        'Otherwise continue working and leave the goal active.',
+    ].join('\n');
+}
+function formatTokens(n) {
+    if (n >= 1000)
+        return `${(n / 1000).toFixed(1)}K`;
+    return String(n);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/runtime/goals/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/runtime/goals/prompt.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAWH,4DAwBC;AAED,oEAUC;AApCD,SAAgB,wBAAwB,CAAC,IAA0B;IACjE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEnD,MAAM,KAAK,GAAG;QACZ,mBAAmB;QACnB,YAAY,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACrC,WAAW,IAAI,CAAC,MAAM,EAAE;QACxB,cAAc,IAAI,CAAC,SAAS,EAAE;QAC9B,0BAA0B,IAAI,CAAC,iBAAiB,YAAY,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,EAAE;QACxL,EAAE;QACF,QAAQ;QACR,iDAAiD;QACjD,wEAAwE;QACxE,qEAAqE;QACrE,6DAA6D;QAC7D,uFAAuF;QACvF,yGAAyG;KAC1G,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,yDAAyD;IACzD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAElE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACnC,CAAC;AAED,SAAgB,4BAA4B;IAC1C,OAAO;QACL,wCAAwC;QACxC,iEAAiE;QACjE,+DAA+D;QAC/D,sCAAsC;QACtC,6CAA6C;QAC7C,6FAA6F;QAC7F,uDAAuD;KACxD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAClD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/runtime/goals/tools.d.ts

@@ -0,0 +1,43 @@
+/**
+ * v0.2.24 — Goal Model Tools.
+ *
+ * get_goal, create_goal, update_goal tool definitions for the Agent.
+ * These tools allow the model to read and request changes to the
+ * persistent goal. Actual state changes go through GoalCoordinator.
+ */
+import type { RuntimeGoalSnapshot } from './types';
+import type { GoalCoordinator } from './coordinator';
+export interface GoalToolBindings {
+    coordinator: GoalCoordinator;
+}
+export declare function buildGetGoalTool(): {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+};
+export declare function executeGetGoal(bindings: GoalToolBindings): RuntimeGoalSnapshot | null;
+export declare function buildCreateGoalTool(): {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+};
+export declare function executeCreateGoal(bindings: GoalToolBindings, objective: string, tokenBudget?: number): {
+    ok: true;
+    goal: RuntimeGoalSnapshot;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function buildUpdateGoalTool(): {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+};
+export declare function executeUpdateGoal(bindings: GoalToolBindings, status: 'complete' | 'blocked'): {
+    ok: true;
+    message: string;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/runtime/goals/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/runtime/goals/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAUA;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,IAAI,CAErF;AAED,wBAAgB,mBAAmB,IAAI;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAmBA;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUxE;AAED,wBAAgB,mBAAmB,IAAI;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,CAgBA;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,UAAU,GAAG,SAAS,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAS9D"}