agent-afk 5.342.0 → 5.344.0

package/dist/agent/artifact-registry/store.d.ts

@@ -1,8 +1,8 @@
 import type { ArtifactListFilter, ArtifactPutOptions, ArtifactRecord } from './types.js';
 export declare function artifactPut(opts: ArtifactPutOptions, _storeDir?: string, _indexPath?: string): Promise<ArtifactRecord>;
-export declare function artifactGet(id: string, _indexPath?: string): ArtifactRecord | undefined;
-export declare function artifactList(filter?: ArtifactListFilter, _indexPath?: string): ArtifactRecord[];
+export declare function artifactGet(id: string, _indexPath?: string, maxIndexBytes?: number): ArtifactRecord | undefined;
+export declare function artifactList(filter?: ArtifactListFilter, _indexPath?: string, maxIndexBytes?: number): ArtifactRecord[];
 export declare function artifactRead(id: string, _indexPath?: string): Promise<Buffer>;
-export declare function artifactCount(_indexPath?: string): number;
+export declare function artifactCount(_indexPath?: string, maxIndexBytes?: number): number;
 export declare function compactIndex(_indexPath?: string): Promise<void>;
 export declare function listStoreBlobs(_storeDir?: string): string[];

package/dist/agent/daemon-instance.lock.d.ts

@@ -0,0 +1,6 @@
+export declare class DaemonAlreadyRunningError extends Error {
+    readonly ownerPid: number | null;
+    constructor(lockPath: string, ownerPid: number | null);
+}
+export declare function getDaemonLockPath(instanceId?: string): string;
+export declare function acquireDaemonLock(lockPath?: string, platform?: string): Promise<() => Promise<void>>;

package/dist/agent/daemon.oauth-timer.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_OAUTH_REFRESH_INTERVAL_MS: number;
+export declare function startOAuthRefreshTimer(refresher: (() => Promise<unknown>) | undefined, intervalMs?: number): ReturnType<typeof setInterval> | undefined;

package/dist/agent/effect-ledger/remote-idempotency.d.ts

@@ -0,0 +1,5 @@
+import type { EffectRecord } from './types.js';
+export declare function remoteIdempotencyInput(toolName: string, input: unknown, prior: EffectRecord | null): {
+    updatedInput?: Record<string, unknown>;
+    remoteIdempotencyKey?: string;
+};

package/dist/agent/effect-ledger/store.d.ts

@@ -1,4 +1,5 @@
-import type { EffectRecord, EffectQuery, PendingEffectInput, ExecuteEffectInput } from './types.js';
+import { type InputBudget } from '../outcomes/outcomes-input.js';
+import type { EffectRecord, EffectQuery, PendingEffectInput, ExecuteEffectInput, EffectRemoteRead } from './types.js';
 export declare class EffectStore {
     private readonly path;
     private cachedRecords;
@@ -7,8 +8,15 @@ export declare class EffectStore {
     private invalidateCache;
     writePending(input: PendingEffectInput): EffectRecord;
     updateStatus(input: ExecuteEffectInput): Promise<EffectRecord>;
+    reconcile(id: string, readRemote: EffectRemoteRead): Promise<EffectRecord>;
     acknowledgeRetry(id: string): Promise<EffectRecord>;
     findByIdempotencyKey(key: string, sessionId?: string): Promise<EffectRecord | null>;
     query(filters?: EffectQuery): Promise<EffectRecord[]>;
     all(): Promise<EffectRecord[]>;
 }
+export interface ReadEffectsForSessionOptions {
+    path?: string;
+    maxRecords?: number;
+    budget?: InputBudget;
+}
+export declare function readEffectsForSession(sessionId: string, opts?: ReadEffectsForSessionOptions): Promise<EffectRecord[]>;

package/dist/agent/effect-ledger/types.d.ts

@@ -10,6 +10,7 @@ export interface EffectRecord {
     taskId?: string;
     timestamp: number;
     retryOf?: string;
+    remoteIdempotencyKey?: string;
     retryAcknowledgedAt?: number;
     result?: unknown;
     reconciledAt?: number;
@@ -27,7 +28,12 @@ export interface PendingEffectInput {
     sessionId?: string;
     taskId?: string;
     retryOf?: string;
+    remoteIdempotencyKey?: string;
 }
+export type EffectRemoteRead = (record: Readonly<EffectRecord>) => Promise<{
+    matched: boolean;
+    evidence: unknown;
+}>;
 export interface ExecuteEffectInput {
     id: string;
     status: Exclude<EffectStatus, 'pending'>;

package/dist/agent/facets/derive.aggregate.d.ts

@@ -2,6 +2,7 @@ import { type SubagentInvocation, type ToolEventInput } from './schema.js';
 export declare const EVIDENCE_CAP = 50;
 export declare function parseInput(input: string | undefined): Record<string, unknown> | undefined;
 export declare function asString(v: unknown): string | undefined;
+export declare function patchApplyPaths(parsed: Record<string, unknown> | undefined): string[];
 export declare function dedupeToolEvents(events: ToolEventInput[]): ToolEventInput[];
 export interface AggregateToolEventsResult {
     toolCounts: Record<string, number>;

package/dist/agent/facets/journal-adapter.d.ts

@@ -2,6 +2,7 @@ import type { SubagentToolSummary, ToolEventInput } from './schema.js';
 import type { JournalRecord } from '../journal/types.js';
 export interface JournalAdapterOptions {
     resultTextCap?: number;
+    checkBudget?: () => void;
 }
 export declare function journalRecordsToToolEvents(records: readonly JournalRecord[], options?: JournalAdapterOptions): ToolEventInput[];
 export declare function summarizeSubagentJournal(subagentId: string, records: readonly JournalRecord[]): SubagentToolSummary;

package/dist/agent/hooks.d.ts

@@ -6,6 +6,7 @@ export interface HookDecision {
     continue?: boolean;
     decision?: 'block' | 'approve';
     reason?: string;
+    ruleId?: string;
     riskCategory?: import('./risk-classifier.js').RiskCategory;
     injectContext?: string;
     updatedInput?: Record<string, unknown>;

package/dist/agent/lsp/repo-map.d.ts

@@ -0,0 +1,11 @@
+import { type LspServerPool } from './pool.js';
+export declare const MAX_SYMBOLS = 200;
+export declare const MAX_LINES = 80;
+export interface RepoMapOptions {
+    readonly rootDir?: string;
+    readonly timeoutMs?: number;
+    readonly pool?: LspServerPool;
+    readonly serverCmd?: readonly string[];
+    readonly signal?: AbortSignal;
+}
+export declare function buildRepoMap(opts?: RepoMapOptions): Promise<string>;

package/dist/agent/outcomes/commit-survival-artifacts.d.ts

@@ -0,0 +1,6 @@
+import type { Artifacts, Vote } from './schema.js';
+import { type CheckAncestor, type CheckRevert } from './lf-delayed.js';
+export declare function commitSurvivalForArtifacts(artifacts: Artifacts, deps: {
+    checkAncestor: CheckAncestor;
+    checkRevert: CheckRevert;
+}, now: string): Promise<Vote[]>;

package/dist/agent/outcomes/compute-outcomes.d.ts

@@ -0,0 +1,21 @@
+import type { EffectRecord } from '../effect-ledger/types.js';
+import type { ToolEventInput } from '../facets/schema.js';
+import { type OutcomeCommit, type OutcomeSchedule, type OutcomesV1 } from './outcomes-v1.schema.js';
+export interface GitLogEntry {
+    sha: string;
+    subject: string;
+    repo: string;
+}
+export interface ComputeOutcomesInput {
+    cwd: string;
+    startHead: string | null;
+    endHead: string | null;
+    gitLog?: readonly GitLogEntry[];
+    ledgerEntries: readonly (EffectRecord | unknown)[];
+    toolEvents: readonly ToolEventInput[];
+    lastAssistantMessage: string | null;
+}
+export declare function mergeCommits(gitLog: readonly OutcomeCommit[], ledger: readonly OutcomeCommit[]): OutcomeCommit[];
+export declare function filesFromToolEvents(events: readonly ToolEventInput[], cwd: string): string[];
+export declare function schedulesFromToolEvents(events: readonly ToolEventInput[]): OutcomeSchedule[];
+export declare function computeOutcomes(input: ComputeOutcomesInput): OutcomesV1;

package/dist/agent/outcomes/git-range.d.ts

@@ -0,0 +1,6 @@
+import type { GitLogEntry } from './compute-outcomes.js';
+export interface GitLogRangeOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare function gitLogRange(cwd: string, startHead: string | null, endHead: string | null, opts?: GitLogRangeOptions): Promise<GitLogEntry[]>;

package/dist/agent/outcomes/index.d.ts

@@ -5,3 +5,8 @@ export { lfPrFate, lfCommitSurvival } from './lf-delayed.js';
 export { combine } from './combine.js';
 export { createOutcomeSessionEndHook } from './session-end-hook.js';
 export { createChildAttributionHook } from './child-attribution.js';
+export { computeOutcomes } from './compute-outcomes.js';
+export type { ComputeOutcomesInput, GitLogEntry } from './compute-outcomes.js';
+export { gitLogRange } from './git-range.js';
+export { OutcomesV1Schema } from './outcomes-v1.schema.js';
+export type { OutcomesV1 } from './outcomes-v1.schema.js';

package/dist/agent/outcomes/outcomes-input.d.ts

@@ -0,0 +1,22 @@
+import type { SessionMeta } from '../session/session-meta.js';
+export interface InputBudget {
+    signal: AbortSignal;
+    deadline: number;
+}
+export declare function checkBudget(budget: InputBudget): void;
+export declare function boundedLines(path: string, budget: InputBudget, maxBytes?: number): AsyncGenerator<string>;
+export declare function readOutcomesMeta(sessionId: string, budget: InputBudget): Promise<SessionMeta | null>;
+export declare function readOutcomesJournal(sessionId: string, budget: InputBudget): Promise<{
+    toolEvents: {
+        [x: string]: unknown;
+        toolName: string;
+        toolUseId?: string | undefined;
+        input?: string | undefined;
+        inputRaw?: string | undefined;
+        result?: string | undefined;
+        isError?: boolean | undefined;
+        incomplete?: boolean | undefined;
+        partialNodeCount?: number | undefined;
+    }[];
+    lastAssistantMessage: string | null;
+}>;

package/dist/agent/outcomes/outcomes-ledger.d.ts

@@ -0,0 +1,13 @@
+import type { OutcomeCommit, OutcomePr, OutcomeService, PrAction } from './outcomes-v1.schema.js';
+interface LedgerEffect {
+    command: string;
+    result: string;
+}
+export declare function settledEffects(entries: readonly unknown[]): LedgerEffect[];
+export declare function repoFromCommand(command: string, cwd: string): string;
+export declare function ledgerCommits(effects: readonly LedgerEffect[], cwd: string): OutcomeCommit[];
+export declare function prActionFromCommand(command: string): PrAction;
+export declare function addPr(list: OutcomePr[], pr: OutcomePr): void;
+export declare function ledgerPrs(effects: readonly LedgerEffect[]): OutcomePr[];
+export declare function ledgerServices(effects: readonly LedgerEffect[]): OutcomeService[];
+export {};

package/dist/agent/outcomes/outcomes-v1.schema.d.ts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+export declare const OUTCOMES_COMMITS_CAP = 200;
+export declare const OUTCOMES_PRS_CAP = 50;
+export declare const OUTCOMES_FILES_CAP = 500;
+export declare const ShaSchema: z.ZodString;
+export declare const OutcomeCommitSchema: z.ZodObject<{
+    sha: z.ZodString;
+    repo: z.ZodString;
+    subject: z.ZodString;
+    source: z.ZodEnum<{
+        tool_result: "tool_result";
+        git_log: "git_log";
+        effect_ledger: "effect_ledger";
+    }>;
+}, z.core.$strip>;
+export type OutcomeCommit = z.infer<typeof OutcomeCommitSchema>;
+export declare const PrActionSchema: z.ZodEnum<{
+    unknown: "unknown";
+    create: "create";
+    merge: "merge";
+    update: "update";
+}>;
+export type PrAction = z.infer<typeof PrActionSchema>;
+export declare const OutcomePrSchema: z.ZodObject<{
+    url: z.ZodString;
+    action: z.ZodEnum<{
+        unknown: "unknown";
+        create: "create";
+        merge: "merge";
+        update: "update";
+    }>;
+}, z.core.$strip>;
+export type OutcomePr = z.infer<typeof OutcomePrSchema>;
+export declare const OutcomeScheduleSchema: z.ZodObject<{
+    id: z.ZodString;
+    action: z.ZodEnum<{
+        cancel: "cancel";
+        create: "create";
+        update: "update";
+    }>;
+}, z.core.$strip>;
+export type OutcomeSchedule = z.infer<typeof OutcomeScheduleSchema>;
+export declare const OutcomeServiceSchema: z.ZodObject<{
+    name: z.ZodString;
+    action: z.ZodString;
+}, z.core.$strip>;
+export type OutcomeService = z.infer<typeof OutcomeServiceSchema>;
+export declare const OutcomesV1Schema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    cwd: z.ZodString;
+    startHead: z.ZodNullable<z.ZodString>;
+    endHead: z.ZodNullable<z.ZodString>;
+    commits: z.ZodArray<z.ZodObject<{
+        sha: z.ZodString;
+        repo: z.ZodString;
+        subject: z.ZodString;
+        source: z.ZodEnum<{
+            tool_result: "tool_result";
+            git_log: "git_log";
+            effect_ledger: "effect_ledger";
+        }>;
+    }, z.core.$strip>>;
+    prs: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        action: z.ZodEnum<{
+            unknown: "unknown";
+            create: "create";
+            merge: "merge";
+            update: "update";
+        }>;
+    }, z.core.$strip>>;
+    filesChanged: z.ZodArray<z.ZodString>;
+    filesChangedTruncated: z.ZodBoolean;
+    schedules: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        action: z.ZodEnum<{
+            cancel: "cancel";
+            create: "create";
+            update: "update";
+        }>;
+    }, z.core.$strip>>;
+    services: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        action: z.ZodString;
+    }, z.core.$strip>>;
+    terminalState: z.ZodNullable<z.ZodEnum<{
+        blocked: "blocked";
+        done: "done";
+        interrupted: "interrupted";
+        asking: "asking";
+    }>>;
+}, z.core.$strip>;
+export type OutcomesV1 = z.infer<typeof OutcomesV1Schema>;

package/dist/agent/outcomes/schema.d.ts

@@ -31,6 +31,7 @@ export declare const ArtifactsSchema: z.ZodObject<{
     commits: z.ZodArray<z.ZodString>;
     prs: z.ZodArray<z.ZodString>;
     repo: z.ZodNullable<z.ZodString>;
+    commitRepos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type Artifacts = z.infer<typeof ArtifactsSchema>;
 export declare const VerifiedOutcomeSchema: z.ZodObject<{
@@ -64,6 +65,7 @@ export declare const VerifiedOutcomeSchema: z.ZodObject<{
         commits: z.ZodArray<z.ZodString>;
         prs: z.ZodArray<z.ZodString>;
         repo: z.ZodNullable<z.ZodString>;
+        commitRepos: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strip>;
     votes: z.ZodArray<z.ZodObject<{
         lf: z.ZodString;
@@ -98,6 +100,51 @@ export declare const VerifiedOutcomeSchema: z.ZodObject<{
         normal: "normal";
     }>>;
     session_ended_at: z.ZodOptional<z.ZodString>;
+    outcomes: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        cwd: z.ZodString;
+        startHead: z.ZodNullable<z.ZodString>;
+        endHead: z.ZodNullable<z.ZodString>;
+        commits: z.ZodArray<z.ZodObject<{
+            sha: z.ZodString;
+            repo: z.ZodString;
+            subject: z.ZodString;
+            source: z.ZodEnum<{
+                tool_result: "tool_result";
+                git_log: "git_log";
+                effect_ledger: "effect_ledger";
+            }>;
+        }, z.core.$strip>>;
+        prs: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            action: z.ZodEnum<{
+                unknown: "unknown";
+                create: "create";
+                merge: "merge";
+                update: "update";
+            }>;
+        }, z.core.$strip>>;
+        filesChanged: z.ZodArray<z.ZodString>;
+        filesChangedTruncated: z.ZodBoolean;
+        schedules: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            action: z.ZodEnum<{
+                cancel: "cancel";
+                create: "create";
+                update: "update";
+            }>;
+        }, z.core.$strip>>;
+        services: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            action: z.ZodString;
+        }, z.core.$strip>>;
+        terminalState: z.ZodNullable<z.ZodEnum<{
+            blocked: "blocked";
+            done: "done";
+            interrupted: "interrupted";
+            asking: "asking";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type VerifiedOutcome = z.infer<typeof VerifiedOutcomeSchema>;
 export type OutcomeLabel = VerifiedOutcome['label'];

package/dist/agent/outcomes/session-end-hook.d.ts

@@ -1,2 +1,5 @@
 import type { HookHandler } from '../hooks.js';
+import type { OutcomesV1 } from './outcomes-v1.schema.js';
+import type { Artifacts } from './schema.js';
 export declare function createOutcomeSessionEndHook(): HookHandler;
+export declare function artifactsFromOutcomes(o: OutcomesV1): Artifacts;

package/dist/agent/outcomes/session-outcomes.d.ts

@@ -0,0 +1,9 @@
+import { type OutcomesV1 } from './outcomes-v1.schema.js';
+export interface SessionOutcomesContext {
+    cwd?: string;
+}
+export declare function _resetSessionOutcomesCache(): void;
+export declare function readEndHead(cwd: string, signal?: AbortSignal): Promise<string | null>;
+export declare function getSessionOutcomes(sessionId: string, ctx?: SessionOutcomesContext, opts?: {
+    timeoutMs?: number;
+}): Promise<OutcomesV1 | null>;

package/dist/agent/tools/compose-executor.node-build.d.ts

@@ -6,6 +6,10 @@ export type ComposeNodeBuildResult = SubagentDAGNode | {
     attachmentError: true;
     nodeId: string;
     error: Error;
+} | {
+    usageBlocked: true;
+    nodeId: string;
+    notice: string;
 };
 export interface BuildComposeDagNodeArgs {
     node: ComposeNodeInput;

package/dist/agent/tools/compose-node-results.d.ts

@@ -3,6 +3,10 @@ type BuildResult = SubagentDAGNode | {
     attachmentError: true;
     nodeId: string;
     error: Error;
+} | {
+    usageBlocked: true;
+    nodeId: string;
+    notice: string;
 };
 export declare function splitComposeNodeResults(results: BuildResult[]): {
     dagNodes: SubagentDAGNode[];
@@ -10,5 +14,9 @@ export declare function splitComposeNodeResults(results: BuildResult[]): {
         id: string;
         error: Error;
     }>;
+    usageBlocks: Array<{
+        id: string;
+        notice: string;
+    }>;
 };
 export {};

package/dist/agent/tools/handlers/artifact.d.ts

@@ -0,0 +1,8 @@
+import type { ToolHandler } from '../types.js';
+interface ArtifactHandlerOptions {
+    cwd?: string;
+    storeDir?: string;
+    indexPath?: string;
+}
+export declare function createArtifactHandlers(opts?: ArtifactHandlerOptions): Map<string, ToolHandler>;
+export {};

package/dist/agent/tools/handlers/bash-sandbox.d.ts

@@ -0,0 +1,12 @@
+export type SandboxPolicy = 'workspace-write' | 'read-only' | 'off';
+export interface SandboxedCommand {
+    readonly shell: string;
+    readonly args: readonly string[];
+    readonly command: string;
+    readonly sandboxed: boolean;
+}
+export declare function parseSandboxPolicy(): SandboxPolicy | undefined;
+export declare function _resetBwrapCacheForTests(): void;
+export declare function _forceBwrapUnavailableForTests(): void;
+export declare function buildSandboxedCommand(command: string, policy: SandboxPolicy, cwd: string | undefined, childTemp?: string): SandboxedCommand;
+export declare function sandboxDescription(policy: SandboxPolicy): string;

package/dist/agent/tools/handlers/bash-sandbox.paths.d.ts

@@ -0,0 +1,5 @@
+export declare function canonicalSandboxPath(input: string): string;
+export declare function sandboxWriteFloor(): readonly string[];
+export declare function sandboxFloorAncestors(floor: readonly string[]): readonly string[];
+export declare function assertDisjointSandboxGrants(grants: readonly string[], floor: readonly string[]): void;
+export declare function sandboxSchemeString(value: string): string;

package/dist/agent/tools/handlers/worktree-managed.d.ts

@@ -5,7 +5,7 @@ export interface RepoContext {
     repoRoot: string;
     afkWorktreesRoot: string;
 }
-export declare function resolveRepoContext(execFile: ExecFileFn, cwd: string): Promise<RepoContext>;
+export declare function resolveRepoContext(execFile: ExecFileFn, cwd: string, explicitRepo?: string): Promise<RepoContext>;
 export declare function sanitizeSlug(name: string): string;
 export declare function detectRemoteDefaultRef(execFile: ExecFileFn, repoRoot: string): Promise<string | undefined>;
 export declare function resolveAnchorBaseRef(execFile: ExecFileFn, anchor: string): Promise<string>;

package/dist/agent/tools/handlers/worktree.d.ts

@@ -4,4 +4,4 @@ export interface WorktreeHandlerDeps {
     execFile?: ExecFileFn;
     generateSuffix?: () => string;
 }
-export declare function createWorktreeHandler(cwd?: string, deps?: WorktreeHandlerDeps): ToolHandler;
+export declare function createWorktreeHandler(cwdFallback?: string, deps?: WorktreeHandlerDeps): ToolHandler;

package/dist/agent/tools/handlers/write-denylist.d.ts

@@ -1,4 +1,5 @@
 export declare const BUILTIN_WRITE_DENYLIST: readonly string[];
+export declare function getUnresolvedWriteDenylist(): readonly string[];
 export declare function getWriteDenylist(): readonly string[];
 export declare function _resetWriteDenylistCacheForTests(): void;
 export declare function safeRealpath(p: string): string;

package/dist/agent/tools/schemas.artifact.d.ts

@@ -0,0 +1,5 @@
+import type { AnthropicToolDef } from './types.js';
+export declare const artifactGetTool: AnthropicToolDef;
+export declare const artifactListTool: AnthropicToolDef;
+export declare const artifactReadTool: AnthropicToolDef;
+export declare const artifactToolSchemas: readonly [AnthropicToolDef, AnthropicToolDef, AnthropicToolDef];

package/dist/agent/trace/events.d.ts

@@ -137,6 +137,7 @@ export declare const HookDecisionPayloadSchema: z.ZodObject<{
         "outbound-message": "outbound-message";
         "release-boundary": "release-boundary";
     }>>;
+    ruleId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const HookSummaryPayloadSchema: z.ZodObject<{
     scope: z.ZodLiteral<"root-session-including-subagents">;
@@ -415,6 +416,7 @@ export declare const TraceEventInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject
             "outbound-message": "outbound-message";
             "release-boundary": "release-boundary";
         }>>;
+        ruleId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"hook_summary">;
@@ -874,6 +876,7 @@ export declare const TraceEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             "outbound-message": "outbound-message";
             "release-boundary": "release-boundary";
         }>>;
+        ruleId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     ts: z.ZodString;

package/dist/agent/trace/receipt.d.ts

@@ -1,83 +1,10 @@
 import { renderReceiptMarkdown } from './receipt.render.js';
 import type { HookHandler } from '../hooks.js';
-import { type CostTokens, type SessionCostSource } from './cost.js';
-import { type JournalSummary } from './receipt.journal.js';
-import { type ClosureReason, type ToolFailureClass, type TraceEvent, type TraceEventKind } from './types.js';
+import { type TraceEvent } from './types.js';
 export { renderReceiptMarkdown };
+export { RECEIPT_SCHEMA_VERSION, type ReceiptMeta, type ReceiptToolFailure, type RunReceipt } from './receipt.types.js';
+import { type ReceiptMeta, type RunReceipt } from './receipt.types.js';
 export { extractJournalSummary, type JournalSummary } from './receipt.journal.js';
-export declare const RECEIPT_SCHEMA_VERSION: 2;
-export interface ReceiptToolFailure {
-    toolUseId: string;
-    name: string;
-    failureClass?: ToolFailureClass;
-    durationMs: number;
-    ts: string;
-    truncated: boolean;
-    exempt: boolean;
-    subagentId?: string;
-}
-export interface RunReceipt {
-    schemaVersion: typeof RECEIPT_SCHEMA_VERSION;
-    generatedAt: string;
-    witnessLabel: string;
-    tracePath: string;
-    sessionId?: string;
-    endReason?: string;
-    status: 'succeeded' | 'failed' | 'cancelled' | 'unknown';
-    closureReason?: ClosureReason;
-    lastStopReason?: string;
-    guidance?: string;
-    incomplete: boolean;
-    startedAt?: string;
-    endedAt?: string;
-    durationMs?: number;
-    toolCalls: {
-        total: number;
-        succeeded: number;
-        errored: number;
-        erroredNotable: number;
-        refused: number;
-        circuitBreakerHits: number;
-        byTool: Record<string, {
-            total: number;
-            errored: number;
-        }>;
-        byFailureClass: Record<string, number>;
-    };
-    events: {
-        total: number;
-        byKind: Partial<Record<TraceEventKind, number>>;
-    };
-    subagents: {
-        started: number;
-        succeeded: number;
-        failed: number;
-        cancelled: number;
-    };
-    cost: {
-        finalCostUsd?: number;
-        turnCount?: number;
-        tokens?: CostTokens;
-        rootCostUsd?: number;
-        subagentCostUsd?: number;
-        totalCostUsd?: number;
-        totalTokens?: CostTokens;
-        costSource?: SessionCostSource;
-    };
-    failures: ReceiptToolFailure[];
-    humanReviewRequired: boolean;
-    humanReviewReasons: string[];
-    limitations: string[];
-    journalSummary?: JournalSummary;
-}
-export interface ReceiptMeta {
-    tracePath: string;
-    witnessLabel: string;
-    sessionId?: string;
-    endReason?: string;
-    now?: Date;
-    journalSummary?: JournalSummary;
-}
 export declare function parseTraceJsonl(raw: string): TraceEvent[];
 export declare function receiptPathsFor(tracePath: string): {
     label: string;
@@ -90,6 +17,7 @@ export interface WriteRunReceiptOptions {
     sessionId?: string;
     reason?: string;
     now?: Date;
+    cwd?: string;
 }
 export declare function writeRunReceipt(opts: WriteRunReceiptOptions): Promise<{
     label: string;