openhorse 0.2.22 → 0.2.24

package/dist/runtime/goals/tools.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGetGoalTool = buildGetGoalTool;
+exports.executeGetGoal = executeGetGoal;
+exports.buildCreateGoalTool = buildCreateGoalTool;
+exports.executeCreateGoal = executeCreateGoal;
+exports.buildUpdateGoalTool = buildUpdateGoalTool;
+exports.executeUpdateGoal = executeUpdateGoal;
+function buildGetGoalTool() {
+    return {
+        name: 'get_goal',
+        description: 'Read the current persistent goal for this session. Returns null if no goal is active.',
+        parameters: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    };
+}
+function executeGetGoal(bindings) {
+    return bindings.coordinator.snapshot();
+}
+function buildCreateGoalTool() {
+    return {
+        name: 'create_goal',
+        description: 'Create a persistent goal for this session. Only use when the user explicitly requests a long-running goal. Rejects if a goal already exists.',
+        parameters: {
+            type: 'object',
+            properties: {
+                objective: {
+                    type: 'string',
+                    description: 'The goal objective. Must be clear, specific, and verifiable.',
+                },
+                token_budget: {
+                    type: 'number',
+                    description: 'Optional token budget. Only set when the user explicitly provides a budget.',
+                },
+            },
+            required: ['objective'],
+        },
+    };
+}
+function executeCreateGoal(bindings, objective, tokenBudget) {
+    const result = bindings.coordinator.create(objective);
+    if (!result.ok)
+        return { ok: false, error: result.error };
+    if (tokenBudget && tokenBudget > 0) {
+        bindings.coordinator.setBudget(tokenBudget);
+    }
+    const snap = bindings.coordinator.snapshot();
+    return snap ? { ok: true, goal: snap } : { ok: false, error: 'Goal was created but snapshot is unavailable.' };
+}
+function buildUpdateGoalTool() {
+    return {
+        name: 'update_goal',
+        description: 'Request a status change for the current goal. The request is audited before the change takes effect.',
+        parameters: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['complete', 'blocked'],
+                    description: 'The requested target status: "complete" when all requirements are verified; "blocked" when the same blocker persisted for 3+ turns.',
+                },
+            },
+            required: ['status'],
+        },
+    };
+}
+function executeUpdateGoal(bindings, status) {
+    const goal = bindings.coordinator.goal;
+    if (!goal)
+        return { ok: false, error: 'No active goal to update.' };
+    if (goal.status !== 'active')
+        return { ok: false, error: `Goal is not active (current status: ${goal.status}).` };
+    return {
+        ok: true,
+        message: `Goal ${status} request recorded. Audit will verify before applying.`,
+    };
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/runtime/goals/tools.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AASH,4CAcC;AAED,wCAEC;AAED,kDAuBC;AAED,8CAcC;AAED,kDAoBC;AAED,8CAYC;AA/FD,SAAgB,gBAAgB;IAK9B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,uFAAuF;QACpG,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,cAAc,CAAC,QAA0B;IACvD,OAAO,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,mBAAmB;IAKjC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8IAA8I;QAC3J,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8DAA8D;iBAC5E;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,6EAA6E;iBAC3F;aACF;YACD,QAAQ,EAAE,CAAC,WAAW,CAAC;SACxB;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,QAA0B,EAC1B,SAAiB,EACjB,WAAoB;IAEpB,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAE1D,IAAI,WAAW,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;AACjH,CAAC;AAED,SAAgB,mBAAmB;IAKjC,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sGAAsG;QACnH,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;oBAC7B,WAAW,EAAE,qIAAqI;iBACnJ;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,iBAAiB,CAC/B,QAA0B,EAC1B,MAA8B;IAE9B,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;IACpE,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,uCAAuC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IAElH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,QAAQ,MAAM,uDAAuD;KAC/E,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,167 @@
+/**
+ * v0.2.24 — Goal / Target Mode domain types.
+ *
+ * Goal is a persistent, single-session entity that the Agent pursues across
+ * multiple turns, Compact, process restart, and /resume. It is NOT a
+ * Harness field, a prompt string, or a UI state — it is an independent
+ * lifecycle entity with its own sidecar storage.
+ */
+export type GoalStatus = 'active' | 'paused' | 'blocked' | 'usage_limited' | 'budget_limited' | 'complete';
+export declare const GOAL_ACTIVE_STATES: ReadonlySet<GoalStatus>;
+export declare const GOAL_TERMINAL_STATES: ReadonlySet<GoalStatus>;
+export declare const GOAL_USER_RECOVERABLE_STATES: ReadonlySet<GoalStatus>;
+export interface GoalBlocker {
+    fingerprint: string;
+    firstSeenAt: number;
+    lastSeenAt: number;
+    consecutiveTurns: number;
+    summary: string;
+}
+export interface GoalLastTurn {
+    turnId: string;
+    finishReason: string;
+    endedAt: number;
+    promptTokens: number;
+    completionTokens: number;
+    subagentTokens: number;
+    totalTokens: number;
+    madeProgress: boolean;
+}
+export interface GoalCompletionAudit {
+    requestedAt: number;
+    auditedAt: number;
+    passed: boolean;
+    verificationSummary: string;
+    remainingRequirements: string[];
+    evidenceRefs: string[];
+}
+export interface GoalStopReason {
+    kind: 'user' | 'blocked' | 'usage_limit' | 'budget_limit' | 'runtime_error';
+    message: string;
+    at: number;
+}
+export interface SessionGoalV1 {
+    version: 1;
+    goalId: string;
+    sessionId: string;
+    revision: number;
+    objective: string;
+    status: GoalStatus;
+    tokenBudget?: number;
+    tokensUsed: number;
+    timeUsedMs: number;
+    createdAt: number;
+    updatedAt: number;
+    activeSince?: number;
+    completedAt?: number;
+    continuationCount: number;
+    noProgressCount: number;
+    blocker?: GoalBlocker;
+    lastTurn?: GoalLastTurn;
+    completionAudit?: GoalCompletionAudit;
+    stopReason?: GoalStopReason;
+}
+export interface RuntimeGoalSnapshot {
+    goalId: string;
+    revision: number;
+    objective: string;
+    status: GoalStatus;
+    tokenBudget?: number;
+    tokensUsed: number;
+    timeUsedMs: number;
+    continuationCount: number;
+    updatedAt: number;
+    stopReason?: string;
+}
+export type AgentInputKind = 'user' | 'revision' | 'goal_continuation' | 'command';
+export interface GoalTurnContext {
+    goalId: string;
+    revision: number;
+    continuationIndex: number;
+}
+export interface AgentTurnRequest {
+    inputKind: AgentInputKind;
+    text?: string;
+    sessionId: string;
+    goal?: GoalTurnContext;
+    persistAsUserMessage: boolean;
+    echoToTranscript: boolean;
+}
+export interface AgentTurnOutcome {
+    turnId: string;
+    sessionId: string;
+    goalId?: string;
+    goalRevision?: number;
+    startedAt: number;
+    endedAt: number;
+    finishReason: string;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        subagentTokens: number;
+        totalTokens: number;
+    };
+    madeProgress: boolean;
+    blocker?: {
+        fingerprint: string;
+        summary: string;
+        retryable: boolean;
+    };
+    providerError?: {
+        kind: 'usage_limit' | 'rate_limit' | 'auth' | 'network' | 'unknown';
+        retryable: boolean;
+    };
+    pendingTerminalRequest?: {
+        requestedStatus: 'complete' | 'blocked';
+        requestedAt: number;
+    };
+}
+export type GoalControlAction = 'show' | 'create' | 'edit' | 'replace' | 'pause' | 'resume' | 'clear' | 'set_budget';
+export interface GoalControlInput {
+    type: 'goal_control';
+    action: GoalControlAction;
+    payload?: {
+        objective?: string;
+        tokenBudget?: number | null;
+        confirmed?: boolean;
+    };
+}
+export interface GoalUpdatedEvent {
+    type: 'goal_updated';
+    goal: RuntimeGoalSnapshot;
+    reason: string;
+}
+export interface GoalClearedEvent {
+    type: 'goal_cleared';
+    goalId: string;
+    reason: string;
+}
+export interface GoalContinuationEvent {
+    type: 'goal_continuation';
+    goalId: string;
+    phase: 'scheduled' | 'started' | 'deferred' | 'stopped';
+    reason: string;
+}
+export interface GoalAuditFailedEvent {
+    type: 'goal_audit_failed';
+    goalId: string;
+    audit: 'completion' | 'blocked';
+    summary: string;
+}
+export interface GoalRestoredEvent {
+    type: 'goal_restored';
+    goal: RuntimeGoalSnapshot;
+}
+/**
+ * Valid status transitions for the Goal state machine.
+ * Returns the allowed next status, or null if the transition is invalid.
+ */
+export declare function goalTransition(current: GoalStatus | null, event: 'create' | 'pause' | 'resume' | 'complete' | 'block' | 'usage_limit' | 'budget_limit' | 'replace' | 'clear'): GoalStatus | null;
+/** Constraints from the goal plan that must hold across the state machine. */
+export declare const GOAL_INVARIANTS: {
+    readonly maxObjectiveChars: 4000;
+    readonly maxConsecutiveBlockerTurns: 3;
+    readonly maxConsecutiveNoProgressTurns: 3;
+    readonly tokenBudgetMin: 1;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/runtime/goals/types.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * v0.2.24 — Goal / Target Mode domain types.
+ *
+ * Goal is a persistent, single-session entity that the Agent pursues across
+ * multiple turns, Compact, process restart, and /resume. It is NOT a
+ * Harness field, a prompt string, or a UI state — it is an independent
+ * lifecycle entity with its own sidecar storage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOAL_INVARIANTS = exports.GOAL_USER_RECOVERABLE_STATES = exports.GOAL_TERMINAL_STATES = exports.GOAL_ACTIVE_STATES = void 0;
+exports.goalTransition = goalTransition;
+exports.GOAL_ACTIVE_STATES = new Set(['active']);
+exports.GOAL_TERMINAL_STATES = new Set([
+    'blocked', 'usage_limited', 'budget_limited', 'complete',
+]);
+exports.GOAL_USER_RECOVERABLE_STATES = new Set([
+    'paused', 'blocked', 'usage_limited', 'budget_limited',
+]);
+// ============================================================================
+// State machine
+// ============================================================================
+/**
+ * Valid status transitions for the Goal state machine.
+ * Returns the allowed next status, or null if the transition is invalid.
+ */
+function goalTransition(current, event) {
+    if (event === 'create')
+        return current === null ? 'active' : null;
+    if (event === 'replace')
+        return 'active'; // always allowed, generates new goalId
+    if (event === 'clear')
+        return null; // removes goal entirely
+    if (current === null)
+        return null;
+    switch (current) {
+        case 'active':
+            if (event === 'pause')
+                return 'paused';
+            if (event === 'complete')
+                return 'complete';
+            if (event === 'block')
+                return 'blocked';
+            if (event === 'usage_limit')
+                return 'usage_limited';
+            if (event === 'budget_limit')
+                return 'budget_limited';
+            return null;
+        case 'paused':
+            if (event === 'resume')
+                return 'active';
+            return null;
+        case 'blocked':
+        case 'usage_limited':
+        case 'budget_limited':
+            if (event === 'resume')
+                return 'active';
+            return null;
+        case 'complete':
+            return null; // terminal — only replace or clear
+        default:
+            return null;
+    }
+}
+/** Constraints from the goal plan that must hold across the state machine. */
+exports.GOAL_INVARIANTS = {
+    maxObjectiveChars: 4000,
+    maxConsecutiveBlockerTurns: 3,
+    maxConsecutiveNoProgressTurns: 3,
+    tokenBudgetMin: 1,
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/goals/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAqOH,wCAmCC;AA1PY,QAAA,kBAAkB,GAA4B,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,QAAA,oBAAoB,GAA4B,IAAI,GAAG,CAAC;IACnE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU;CACzD,CAAC,CAAC;AACU,QAAA,4BAA4B,GAA4B,IAAI,GAAG,CAAC;IAC3E,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB;CACvD,CAAC,CAAC;AAyMH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAA0B,EAC1B,KAAkH;IAElH,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,CAAE,uCAAuC;IAClF,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC,CAAQ,wBAAwB;IAEnE,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAElC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO,QAAQ,CAAC;YACvC,IAAI,KAAK,KAAK,UAAU;gBAAE,OAAO,UAAU,CAAC;YAC5C,IAAI,KAAK,KAAK,OAAO;gBAAE,OAAO,SAAS,CAAC;YACxC,IAAI,KAAK,KAAK,aAAa;gBAAE,OAAO,eAAe,CAAC;YACpD,IAAI,KAAK,KAAK,cAAc;gBAAE,OAAO,gBAAgB,CAAC;YACtD,OAAO,IAAI,CAAC;QAEd,KAAK,QAAQ;YACX,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YACxC,OAAO,IAAI,CAAC;QAEd,KAAK,SAAS,CAAC;QACf,KAAK,eAAe,CAAC;QACrB,KAAK,gBAAgB;YACnB,IAAI,KAAK,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YACxC,OAAO,IAAI,CAAC;QAEd,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,CAAE,mCAAmC;QAEnD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,8EAA8E;AACjE,QAAA,eAAe,GAAG;IAC7B,iBAAiB,EAAE,IAAI;IACvB,0BAA0B,EAAE,CAAC;IAC7B,6BAA6B,EAAE,CAAC;IAChC,cAAc,EAAE,CAAC;CACT,CAAC"}

package/dist/runtime/tool-detail-repository.d.ts

@@ -0,0 +1,45 @@
+/**
+ * v0.2.23 — Tool Detail Repository.
+ *
+ * Read-only interface for accessing tool output details from durable sources
+ * (artifacts, session traces). Supports paginated reads with byte-offset
+ * limits. Never loads full multi-MB artifacts into memory at once.
+ */
+export interface ToolDetailSummary {
+    callId: string;
+    sequence: number;
+    turnId?: string;
+    toolName: string;
+    state: 'success' | 'error' | 'skipped';
+    outputBytes: number;
+    artifactId?: string;
+    hasArtifact: boolean;
+}
+export interface ToolDetailPage {
+    content: string;
+    offsetBytes: number;
+    nextOffsetBytes?: number;
+    totalBytes: number;
+    redacted: boolean;
+}
+export interface ToolDetailRepository {
+    list(projectPath: string): Promise<ToolDetailSummary[]>;
+    read(ref: ToolDetailRef, options: {
+        offsetBytes: number;
+        limitBytes: number;
+    }, projectPath: string): Promise<ToolDetailPage>;
+}
+export interface ToolDetailRef {
+    callId: string;
+    sequence: number;
+    artifactId?: string;
+    outputBytes: number;
+}
+export declare class FileToolDetailRepository implements ToolDetailRepository {
+    list(projectPath: string): Promise<ToolDetailSummary[]>;
+    read(ref: ToolDetailRef, options: {
+        offsetBytes: number;
+        limitBytes: number;
+    }, projectPath: string): Promise<ToolDetailPage>;
+}
+//# sourceMappingURL=tool-detail-repository.d.ts.map

package/dist/runtime/tool-detail-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-detail-repository.d.ts","sourceRoot":"","sources":["../../src/runtime/tool-detail-repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxD,IAAI,CACF,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EACpD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,wBAAyB,YAAW,oBAAoB;IAC7D,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiBvD,IAAI,CACR,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EACpD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;CAuD3B"}

package/dist/runtime/tool-detail-repository.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * v0.2.23 — Tool Detail Repository.
+ *
+ * Read-only interface for accessing tool output details from durable sources
+ * (artifacts, session traces). Supports paginated reads with byte-offset
+ * limits. Never loads full multi-MB artifacts into memory at once.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileToolDetailRepository = void 0;
+const fs_1 = require("fs");
+const tool_artifacts_1 = require("../core/tool-artifacts");
+const config_dir_1 = require("../services/config-dir");
+const redaction_1 = require("../services/redaction");
+const path_1 = require("path");
+// ============================================================================
+// Implementation
+// ============================================================================
+const MAX_PAGE_BYTES = 1024 * 1024; // 1 MB max per page
+const DEFAULT_LIMIT_BYTES = 64 * 1024; // 64 KB default page
+class FileToolDetailRepository {
+    async list(projectPath) {
+        try {
+            const artifacts = (0, tool_artifacts_1.listArtifacts)(projectPath);
+            return artifacts.map(a => ({
+                callId: artifactIdToCallId(a.id),
+                sequence: 0, // sequence not stored in artifact metadata currently
+                toolName: a.toolName,
+                state: 'success',
+                outputBytes: a.outputBytes,
+                artifactId: a.id,
+                hasArtifact: true,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async read(ref, options, projectPath) {
+        const limitBytes = Math.min(options.limitBytes || DEFAULT_LIMIT_BYTES, MAX_PAGE_BYTES);
+        const offsetBytes = Math.max(0, options.offsetBytes || 0);
+        // Try reading from artifact file on disk.
+        if (ref.artifactId) {
+            // v0.2.23: reject path traversal in artifact IDs.
+            if (ref.artifactId.includes('..') || ref.artifactId.includes('/') || ref.artifactId.includes('\\')) {
+                return { content: 'detail unavailable', offsetBytes: 0, totalBytes: 0, redacted: false };
+            }
+            try {
+                const artifactDir = (0, config_dir_1.getProjectArtifactsDir)(projectPath);
+                const filePath = (0, path_1.join)(artifactDir, `${ref.artifactId}.txt`);
+                if ((0, fs_1.existsSync)(filePath)) {
+                    const totalBytes = (0, fs_1.statSync)(filePath).size;
+                    if (offsetBytes >= totalBytes) {
+                        return { content: '', offsetBytes, totalBytes, redacted: false };
+                    }
+                    const requestedBytes = Math.min(limitBytes + 3, totalBytes - offsetBytes);
+                    const buffer = Buffer.allocUnsafe(requestedBytes);
+                    const fd = (0, fs_1.openSync)(filePath, 'r');
+                    let bytesRead = 0;
+                    try {
+                        bytesRead = (0, fs_1.readSync)(fd, buffer, 0, requestedBytes, offsetBytes);
+                    }
+                    finally {
+                        (0, fs_1.closeSync)(fd);
+                    }
+                    const targetBytes = Math.min(limitBytes, bytesRead);
+                    const safeBytes = utf8SafePrefixLength(buffer.subarray(0, targetBytes));
+                    const consumedBytes = safeBytes > 0
+                        ? safeBytes
+                        : Math.min(bytesRead, utf8SequenceLength(buffer[0]));
+                    const rawPage = buffer.subarray(0, consumedBytes).toString('utf8');
+                    const content = (0, redaction_1.redactTraceText)(rawPage);
+                    const nextOffset = offsetBytes + consumedBytes;
+                    return {
+                        content,
+                        offsetBytes,
+                        nextOffsetBytes: nextOffset < totalBytes ? nextOffset : undefined,
+                        totalBytes,
+                        redacted: content !== rawPage,
+                    };
+                }
+            }
+            catch {
+                // Fall through to unavailable.
+            }
+        }
+        return {
+            content: 'detail unavailable',
+            offsetBytes: 0,
+            totalBytes: 0,
+            redacted: false,
+        };
+    }
+}
+exports.FileToolDetailRepository = FileToolDetailRepository;
+function artifactIdToCallId(id) {
+    // artifact IDs look like "toolName-seq-random" — use as callId fallback.
+    return id;
+}
+function utf8SafePrefixLength(buffer) {
+    if (buffer.length === 0)
+        return 0;
+    let lead = buffer.length - 1;
+    while (lead >= 0 && (buffer[lead] & 0xc0) === 0x80)
+        lead -= 1;
+    if (lead < 0)
+        return 0;
+    const first = buffer[lead];
+    const expected = (first & 0x80) === 0
+        ? 1
+        : (first & 0xe0) === 0xc0
+            ? 2
+            : (first & 0xf0) === 0xe0
+                ? 3
+                : (first & 0xf8) === 0xf0
+                    ? 4
+                    : 1;
+    return buffer.length - lead < expected ? lead : buffer.length;
+}
+function utf8SequenceLength(first) {
+    if ((first & 0x80) === 0)
+        return 1;
+    if ((first & 0xe0) === 0xc0)
+        return 2;
+    if ((first & 0xf0) === 0xe0)
+        return 3;
+    if ((first & 0xf8) === 0xf0)
+        return 4;
+    return 1;
+}
+//# sourceMappingURL=tool-detail-repository.js.map

package/dist/runtime/tool-detail-repository.js.map

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

package/dist/runtime/tool-output-presentation.d.ts

@@ -0,0 +1,89 @@
+/**
+ * v0.2.23 — Tool Output Presentation Policy.
+ *
+ * Renderer-neutral pure function that creates a ToolOutputView from raw
+ * tool output. Terminal adapter continues to use full output; only TUI
+ * applies the adaptive/collapsed/full collapse policy.
+ */
+export type ToolOutputViewMode = 'inline' | 'preview' | 'collapsed';
+export type ToolOutputContentKind = 'text' | 'json' | 'diff' | 'log' | 'table' | 'batch' | 'unknown';
+export interface ToolOutputDetailRef {
+    callId: string;
+    sequence: number;
+    turnId?: string;
+    artifactId?: string;
+    traceSessionId?: string;
+    outputBytes: number;
+    outputLines: number;
+}
+export interface ToolOutputStepSummary {
+    index: number;
+    toolName: string;
+    state: 'success' | 'error' | 'skipped';
+    target?: string;
+    summary: string;
+    outputBytes: number;
+    detailRef?: ToolOutputDetailRef;
+}
+export interface ToolAggregateView {
+    version: 1;
+    kind: 'batch_read' | 'subtask_batch' | 'generic_batch';
+    total: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+    steps: ToolOutputStepSummary[];
+}
+export interface ToolOutputView {
+    mode: ToolOutputViewMode;
+    contentKind: ToolOutputContentKind;
+    summary: string;
+    preview: string;
+    previewBytes: number;
+    omittedBytes: number;
+    omittedLines: number;
+    detailRef?: ToolOutputDetailRef;
+    aggregate?: ToolAggregateView;
+}
+export type ToolTranscriptViewMode = 'adaptive' | 'collapsed' | 'full';
+export interface ResolvedToolOutputPolicy {
+    mode: ToolTranscriptViewMode;
+    inlineMaxLines: number;
+    inlineMaxBytes: number;
+    previewMaxLines: number;
+    previewMaxBytes: number;
+    errorPreviewMaxLines: number;
+    errorPreviewMaxBytes: number;
+}
+export declare const DEFAULT_TOOL_OUTPUT_POLICY: ResolvedToolOutputPolicy;
+export interface CreateToolOutputViewInput {
+    toolName: string;
+    success: boolean;
+    summary?: string;
+    rawOutput: string;
+    outputBytes: number;
+    artifactRef?: {
+        id: string;
+        outputBytes: number;
+    };
+    callId: string;
+    sequence: number;
+    turnId?: string;
+    policy: ResolvedToolOutputPolicy;
+}
+export declare function createToolOutputView(input: CreateToolOutputViewInput): ToolOutputView;
+export interface AggregateBatchReadResult {
+    steps: Array<{
+        tool: string;
+        target: string;
+        success: boolean;
+        summary: string;
+        outputBytes: number;
+    }>;
+}
+/**
+ * Try to parse a known aggregate tool result into a structured view.
+ * Returns null if the output doesn't match any known schema.
+ */
+export declare function tryParseAggregateOutput(toolName: string, rawOutput: string, detailRef?: ToolOutputDetailRef): ToolAggregateView | null;
+//# sourceMappingURL=tool-output-presentation.d.ts.map

package/dist/runtime/tool-output-presentation.d.ts.map

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