@code-yeongyu/senpi-agent-core 2026.9.12 → 2026.9.13

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

@@ -0,0 +1,105 @@
+import type { RetryPolicy } from "@earendil-works/pi-ai";
+import type { QueueMode } from "../../types.ts";
+import type { AgentHarnessOptions, DriveOptions, DriveOutcome, HarnessEvent, Resources } from "../agent-harness.ts";
+import type { CompactionSettings } from "../compaction/compaction.ts";
+import { type Context } from "../context.ts";
+import { type Gate } from "../execution/effect-gate.ts";
+import type { CommitResult, InboxItem, LaneConfiguration, Operation, OperationResultRecord, OperationState, Write } from "../session/types.ts";
+import type { AgentHarnessStreamOptions, AgentHarnessTool } from "../types.ts";
+export declare class SliceNotImplemented extends Error {
+    constructor(operation: string);
+}
+/** Current process-local harness configuration. */
+export interface Config<TContext extends object | undefined> {
+    readonly tools: AgentHarnessTool<TContext>[];
+    readonly resources: Resources;
+    readonly streamOptions: AgentHarnessStreamOptions;
+    readonly retryPolicy: RetryPolicy;
+    readonly compaction: CompactionSettings;
+    readonly steeringMode: QueueMode;
+    readonly followUpMode: QueueMode;
+    readonly toolExecution: "sequential" | "parallel";
+    readonly toolContext: AgentHarnessOptions<TContext>["toolContext"];
+    readonly systemPrompt: AgentHarnessOptions<TContext>["systemPrompt"];
+    readonly toProviderMessages: NonNullable<AgentHarnessOptions<TContext>["toProviderMessages"]>;
+    readonly entryProjectors: Readonly<NonNullable<AgentHarnessOptions<TContext>["entryProjectors"]>>;
+}
+/** The current durable state owned by one lane. */
+export interface LaneState {
+    readonly tipId: string | null;
+    readonly configuration: LaneConfiguration;
+    readonly inbox: InboxItem[];
+    readonly lastOperationId: string | null;
+    readonly operation: Operation | null;
+}
+type Synchronous<TResult> = TResult extends PromiseLike<unknown> ? never : TResult;
+interface CommitDecision<TResult> {
+    kind: "commit";
+    writes: Write[];
+    materialize(commit: CommitResult): Synchronous<TResult>;
+    events?(commit: CommitResult): HarnessEvent[];
+}
+/** One effect-free decision made on a lane's serialized mutation line. */
+export type LaneCommand<TResult> = (CommitDecision<TResult> & {
+    next: LaneState;
+}) | {
+    kind: "return";
+    result: TResult;
+} | {
+    kind: "reject";
+    error: Error;
+};
+export type ContinueOperationResult<TResult> = {
+    kind: "cancel_requested";
+} | {
+    kind: "result";
+    value: TResult;
+};
+/** A durable operation transition. The Lane pairs the state write with projection publication. */
+type LanePatch = Partial<Pick<LaneState, "tipId" | "configuration" | "inbox">>;
+interface FinishDecision<TResult> {
+    kind: "finish";
+    writes: Write[];
+    record: OperationResultRecord;
+    lane?: LanePatch;
+    materialize(commit: CommitResult): Synchronous<TResult>;
+    events?(commit: CommitResult): HarnessEvent[];
+}
+export type OperationCommand<TResult> = (CommitDecision<TResult> & {
+    operationState: OperationState;
+    lane?: LanePatch;
+}) | FinishDecision<TResult> | {
+    kind: "return";
+    result: TResult;
+};
+/** One installed process-local drive pass. */
+export declare class Drive {
+    readonly operationId: string;
+    readonly completion: Promise<DriveOutcome>;
+    readonly gate: Gate;
+    readonly context: Context;
+    readonly waitForRetry: boolean;
+    readonly closeSignal: AbortSignal;
+    deferredPermits: number;
+    private readonly control;
+    private readonly closeController;
+    private readonly resolveCompletion;
+    private readonly rejectCompletion;
+    constructor(options: DriveOptions, context: Context);
+    settle(outcome: DriveOutcome): void;
+    fail(error: unknown): void;
+    beginAbort(cancellation: Promise<void>): void;
+    signalAbort(): void;
+    closeGate(error: Error): void;
+}
+export type ProcedureResult = {
+    kind: "continue";
+} | {
+    kind: "waiting";
+    outcome: DriveOutcome;
+} | {
+    kind: "settled";
+    outcome: OperationResultRecord;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/harness/runtime/types.js

@@ -0,0 +1,50 @@
+import { withoutAbortSignal } from "../context.js";
+import { createGate } from "../execution/effect-gate.js";
+export class SliceNotImplemented extends Error {
+    constructor(operation) {
+        super(`${operation} is not implemented until its later AgentHarness slice`);
+        this.name = "SliceNotImplemented";
+    }
+}
+/** One installed process-local drive pass. */
+export class Drive {
+    constructor(options, context) {
+        this.operationId = options.operationId;
+        this.context = withoutAbortSignal(context);
+        this.waitForRetry = options.waitForRetry ?? false;
+        this.deferredPermits = options.pollDeferred === true ? 1 : 0;
+        let resolveCompletion;
+        let rejectCompletion;
+        this.completion = new Promise((resolve, reject) => {
+            resolveCompletion = resolve;
+            rejectCompletion = reject;
+        });
+        this.resolveCompletion = resolveCompletion;
+        this.rejectCompletion = rejectCompletion;
+        void this.completion.catch(() => { });
+        const { gate, control } = createGate();
+        this.gate = gate;
+        this.control = control;
+        this.closeController = new AbortController();
+        this.closeSignal = this.closeController.signal;
+    }
+    settle(outcome) {
+        this.resolveCompletion(outcome);
+    }
+    fail(error) {
+        this.rejectCompletion(error);
+    }
+    beginAbort(cancellation) {
+        this.control.beginAbort(cancellation);
+    }
+    signalAbort() {
+        this.control.signalAbort();
+    }
+    closeGate(error) {
+        this.control.close(error);
+        if (!this.closeSignal.aborted)
+            this.closeController.abort(error);
+        this.rejectCompletion(error);
+    }
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/runtime/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,UAAU,EAA+B,MAAM,6BAA6B,CAAC;AAYtF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C,YAAY,SAAiB;QAC5B,KAAK,CAAC,GAAG,SAAS,wDAAwD,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AA6DD,8CAA8C;AAC9C,MAAM,OAAO,KAAK;IAcjB,YAAY,OAAqB,EAAE,OAAgB;QAClD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;QAClD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,IAAI,iBAAmD,CAAC;QACxD,IAAI,gBAA2C,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC/D,iBAAiB,GAAG,OAAO,CAAC;YAC5B,gBAAgB,GAAG,MAAM,CAAC;QAC3B,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,KAAK,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,OAAqB;QAC3B,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,CAAC,KAAc;QAClB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU,CAAC,YAA2B;QACrC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC;IAED,WAAW;QACV,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED,SAAS,CAAC,KAAY;QACrB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO;YAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACD","sourcesContent":["import type { RetryPolicy } from \"@earendil-works/pi-ai\";\nimport type { QueueMode } from \"../../types.ts\";\nimport type { AgentHarnessOptions, DriveOptions, DriveOutcome, HarnessEvent, Resources } from \"../agent-harness.ts\";\nimport type { CompactionSettings } from \"../compaction/compaction.ts\";\nimport { type Context, withoutAbortSignal } from \"../context.ts\";\nimport { createGate, type Gate, type GateControl } from \"../execution/effect-gate.ts\";\nimport type {\n\tCommitResult,\n\tInboxItem,\n\tLaneConfiguration,\n\tOperation,\n\tOperationResultRecord,\n\tOperationState,\n\tWrite,\n} from \"../session/types.ts\";\nimport type { AgentHarnessStreamOptions, AgentHarnessTool } from \"../types.ts\";\n\nexport class SliceNotImplemented extends Error {\n\tconstructor(operation: string) {\n\t\tsuper(`${operation} is not implemented until its later AgentHarness slice`);\n\t\tthis.name = \"SliceNotImplemented\";\n\t}\n}\n\n/** Current process-local harness configuration. */\nexport interface Config<TContext extends object | undefined> {\n\treadonly tools: AgentHarnessTool<TContext>[];\n\treadonly resources: Resources;\n\treadonly streamOptions: AgentHarnessStreamOptions;\n\treadonly retryPolicy: RetryPolicy;\n\treadonly compaction: CompactionSettings;\n\treadonly steeringMode: QueueMode;\n\treadonly followUpMode: QueueMode;\n\treadonly toolExecution: \"sequential\" | \"parallel\";\n\treadonly toolContext: AgentHarnessOptions<TContext>[\"toolContext\"];\n\treadonly systemPrompt: AgentHarnessOptions<TContext>[\"systemPrompt\"];\n\treadonly toProviderMessages: NonNullable<AgentHarnessOptions<TContext>[\"toProviderMessages\"]>;\n\treadonly entryProjectors: Readonly<NonNullable<AgentHarnessOptions<TContext>[\"entryProjectors\"]>>;\n}\n\n/** The current durable state owned by one lane. */\nexport interface LaneState {\n\treadonly tipId: string | null;\n\treadonly configuration: LaneConfiguration;\n\treadonly inbox: InboxItem[];\n\treadonly lastOperationId: string | null;\n\treadonly operation: Operation | null;\n}\n\ntype Synchronous<TResult> = TResult extends PromiseLike<unknown> ? never : TResult;\n\ninterface CommitDecision<TResult> {\n\tkind: \"commit\";\n\twrites: Write[];\n\tmaterialize(commit: CommitResult): Synchronous<TResult>;\n\tevents?(commit: CommitResult): HarnessEvent[];\n}\n\n/** One effect-free decision made on a lane's serialized mutation line. */\nexport type LaneCommand<TResult> =\n\t| (CommitDecision<TResult> & { next: LaneState })\n\t| { kind: \"return\"; result: TResult }\n\t| { kind: \"reject\"; error: Error };\n\nexport type ContinueOperationResult<TResult> = { kind: \"cancel_requested\" } | { kind: \"result\"; value: TResult };\n\n/** A durable operation transition. The Lane pairs the state write with projection publication. */\ntype LanePatch = Partial<Pick<LaneState, \"tipId\" | \"configuration\" | \"inbox\">>;\n\ninterface FinishDecision<TResult> {\n\tkind: \"finish\";\n\twrites: Write[];\n\trecord: OperationResultRecord;\n\tlane?: LanePatch;\n\tmaterialize(commit: CommitResult): Synchronous<TResult>;\n\tevents?(commit: CommitResult): HarnessEvent[];\n}\n\nexport type OperationCommand<TResult> =\n\t| (CommitDecision<TResult> & { operationState: OperationState; lane?: LanePatch })\n\t| FinishDecision<TResult>\n\t| { kind: \"return\"; result: TResult };\n\n/** One installed process-local drive pass. */\nexport class Drive {\n\treadonly operationId: string;\n\treadonly completion: Promise<DriveOutcome>;\n\treadonly gate: Gate;\n\treadonly context: Context;\n\treadonly waitForRetry: boolean;\n\treadonly closeSignal: AbortSignal;\n\tdeferredPermits: number;\n\n\tprivate readonly control: GateControl;\n\tprivate readonly closeController: AbortController;\n\tprivate readonly resolveCompletion: (outcome: DriveOutcome) => void;\n\tprivate readonly rejectCompletion: (error: unknown) => void;\n\n\tconstructor(options: DriveOptions, context: Context) {\n\t\tthis.operationId = options.operationId;\n\t\tthis.context = withoutAbortSignal(context);\n\t\tthis.waitForRetry = options.waitForRetry ?? false;\n\t\tthis.deferredPermits = options.pollDeferred === true ? 1 : 0;\n\t\tlet resolveCompletion!: (outcome: DriveOutcome) => void;\n\t\tlet rejectCompletion!: (error: unknown) => void;\n\t\tthis.completion = new Promise<DriveOutcome>((resolve, reject) => {\n\t\t\tresolveCompletion = resolve;\n\t\t\trejectCompletion = reject;\n\t\t});\n\t\tthis.resolveCompletion = resolveCompletion;\n\t\tthis.rejectCompletion = rejectCompletion;\n\t\tvoid this.completion.catch(() => {});\n\t\tconst { gate, control } = createGate();\n\t\tthis.gate = gate;\n\t\tthis.control = control;\n\t\tthis.closeController = new AbortController();\n\t\tthis.closeSignal = this.closeController.signal;\n\t}\n\n\tsettle(outcome: DriveOutcome): void {\n\t\tthis.resolveCompletion(outcome);\n\t}\n\n\tfail(error: unknown): void {\n\t\tthis.rejectCompletion(error);\n\t}\n\n\tbeginAbort(cancellation: Promise<void>): void {\n\t\tthis.control.beginAbort(cancellation);\n\t}\n\n\tsignalAbort(): void {\n\t\tthis.control.signalAbort();\n\t}\n\n\tcloseGate(error: Error): void {\n\t\tthis.control.close(error);\n\t\tif (!this.closeSignal.aborted) this.closeController.abort(error);\n\t\tthis.rejectCompletion(error);\n\t}\n}\n\nexport type ProcedureResult =\n\t| { kind: \"continue\" }\n\t| { kind: \"waiting\"; outcome: DriveOutcome }\n\t| { kind: \"settled\"; outcome: OperationResultRecord };\n"]}

package/dist/harness/session/commit.d.ts

@@ -0,0 +1,53 @@
+import type { CommitResult, Entry, EntryWrite, NewEntry, UsageRow, UsageWrite, Write } from "./types.ts";
+export type CommittedEntryWrite = Entry & {
+    kind: "entry";
+};
+export type CommittedUsageWrite = UsageRow & {
+    kind: "usage";
+};
+export interface CommittedValueSetWrite {
+    kind: "value";
+    op: "set";
+    seq: number;
+    namespace: string;
+    key: string;
+    value: unknown;
+}
+export interface CommittedValueDeleteWrite {
+    kind: "value";
+    op: "delete";
+    seq: number;
+    namespace: string;
+    key: string;
+}
+export interface CommittedListAppendWrite {
+    kind: "list";
+    op: "append";
+    seq: number;
+    namespace: string;
+    key: string;
+    value: unknown;
+}
+export interface CommittedListDeleteWrite {
+    kind: "list";
+    op: "delete";
+    seq: number;
+    namespace: string;
+    key: string;
+}
+export type CommittedWrite = CommittedEntryWrite | CommittedUsageWrite | CommittedValueSetWrite | CommittedValueDeleteWrite | CommittedListAppendWrite | CommittedListDeleteWrite;
+export interface PreparedCommit {
+    writes: CommittedWrite[];
+    result: Omit<CommitResult, "stats">;
+}
+export interface CommitValidationState {
+    hasEntryOrUsageId(id: string): boolean;
+    hasEntryId(id: string): boolean;
+}
+export declare function insertEntry(entry: NewEntry): EntryWrite;
+export declare function insertUsage(row: Omit<UsageRow, "seq">): UsageWrite;
+export declare function commitWrite(write: Write, seq: number, timestamp: number): CommittedWrite;
+export declare function materializeCommittedEntry(entry: NewEntry, seq: number, timestamp: number): Entry;
+export declare function prepareStorageCommit(writes: Write[], firstSeq: number, timestamp: number): PreparedCommit;
+export declare function validateCommittedWrites(writes: readonly CommittedWrite[], firstSeq: number, state: CommitValidationState): void;
+//# sourceMappingURL=commit.d.ts.map

package/dist/harness/session/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../../src/harness/session/commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEzG,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAC/D,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,KAAK,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CACf;AACD,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACZ;AACD,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CACf;AACD,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACZ;AACD,MAAM,MAAM,cAAc,GACvB,mBAAmB,GACnB,mBAAmB,GACnB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,wBAAwB,CAAC;AAE5B,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACrC,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAEvD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,UAAU,CAElE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAexF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAEhG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAMzG;AAED,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,GAC1B,IAAI,CAsBN"}

package/dist/harness/session/commit.js

@@ -0,0 +1,57 @@
+export function insertEntry(entry) {
+    return { kind: "entry", entry };
+}
+export function insertUsage(row) {
+    return { kind: "usage", row };
+}
+export function commitWrite(write, seq, timestamp) {
+    switch (write.kind) {
+        case "entry":
+            return { kind: "entry", ...write.entry, seq, timestamp };
+        case "usage":
+            return { kind: "usage", ...write.row, seq };
+        case "value":
+            return write.op === "set"
+                ? { kind: "value", op: "set", seq, namespace: write.namespace, key: write.key, value: write.value }
+                : { kind: "value", op: "delete", seq, namespace: write.namespace, key: write.key };
+        case "list":
+            return write.op === "append"
+                ? { kind: "list", op: "append", seq, namespace: write.namespace, key: write.key, value: write.value }
+                : { kind: "list", op: "delete", seq, namespace: write.namespace, key: write.key };
+    }
+}
+export function materializeCommittedEntry(entry, seq, timestamp) {
+    return { ...entry, seq, timestamp };
+}
+export function prepareStorageCommit(writes, firstSeq, timestamp) {
+    const committedWrites = writes.map((write, index) => commitWrite(write, firstSeq + index, timestamp));
+    return {
+        writes: committedWrites,
+        result: { firstSeq, seqs: committedWrites.map((write) => write.seq), timestamp },
+    };
+}
+export function validateCommittedWrites(writes, firstSeq, state) {
+    let previousSeq = firstSeq - 1;
+    const transactionIds = new Set();
+    const transactionEntryIds = new Set();
+    for (const write of writes) {
+        if (write.seq <= previousSeq)
+            throw new Error(`Non-monotonic storage sequence: ${write.seq}`);
+        previousSeq = write.seq;
+        if (write.kind !== "entry" && write.kind !== "usage")
+            continue;
+        if (state.hasEntryOrUsageId(write.id) || transactionIds.has(write.id)) {
+            throw new Error(`Duplicate entry or usage id: ${write.id}`);
+        }
+        if (write.kind === "entry" &&
+            write.parentId !== null &&
+            !state.hasEntryId(write.parentId) &&
+            !transactionEntryIds.has(write.parentId)) {
+            throw new Error(`Missing parent entry: ${write.parentId}`);
+        }
+        transactionIds.add(write.id);
+        if (write.kind === "entry")
+            transactionEntryIds.add(write.id);
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/harness/session/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../../src/harness/session/commit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CommitResult, Entry, EntryWrite, NewEntry, UsageRow, UsageWrite, Write } from \"./types.ts\";\n\nexport type CommittedEntryWrite = Entry & { kind: \"entry\" };\nexport type CommittedUsageWrite = UsageRow & { kind: \"usage\" };\nexport interface CommittedValueSetWrite {\n\tkind: \"value\";\n\top: \"set\";\n\tseq: number;\n\tnamespace: string;\n\tkey: string;\n\tvalue: unknown;\n}\nexport interface CommittedValueDeleteWrite {\n\tkind: \"value\";\n\top: \"delete\";\n\tseq: number;\n\tnamespace: string;\n\tkey: string;\n}\nexport interface CommittedListAppendWrite {\n\tkind: \"list\";\n\top: \"append\";\n\tseq: number;\n\tnamespace: string;\n\tkey: string;\n\tvalue: unknown;\n}\nexport interface CommittedListDeleteWrite {\n\tkind: \"list\";\n\top: \"delete\";\n\tseq: number;\n\tnamespace: string;\n\tkey: string;\n}\nexport type CommittedWrite =\n\t| CommittedEntryWrite\n\t| CommittedUsageWrite\n\t| CommittedValueSetWrite\n\t| CommittedValueDeleteWrite\n\t| CommittedListAppendWrite\n\t| CommittedListDeleteWrite;\n\nexport interface PreparedCommit {\n\twrites: CommittedWrite[];\n\tresult: Omit<CommitResult, \"stats\">;\n}\n\nexport interface CommitValidationState {\n\thasEntryOrUsageId(id: string): boolean;\n\thasEntryId(id: string): boolean;\n}\n\nexport function insertEntry(entry: NewEntry): EntryWrite {\n\treturn { kind: \"entry\", entry };\n}\n\nexport function insertUsage(row: Omit<UsageRow, \"seq\">): UsageWrite {\n\treturn { kind: \"usage\", row };\n}\n\nexport function commitWrite(write: Write, seq: number, timestamp: number): CommittedWrite {\n\tswitch (write.kind) {\n\t\tcase \"entry\":\n\t\t\treturn { kind: \"entry\", ...write.entry, seq, timestamp };\n\t\tcase \"usage\":\n\t\t\treturn { kind: \"usage\", ...write.row, seq };\n\t\tcase \"value\":\n\t\t\treturn write.op === \"set\"\n\t\t\t\t? { kind: \"value\", op: \"set\", seq, namespace: write.namespace, key: write.key, value: write.value }\n\t\t\t\t: { kind: \"value\", op: \"delete\", seq, namespace: write.namespace, key: write.key };\n\t\tcase \"list\":\n\t\t\treturn write.op === \"append\"\n\t\t\t\t? { kind: \"list\", op: \"append\", seq, namespace: write.namespace, key: write.key, value: write.value }\n\t\t\t\t: { kind: \"list\", op: \"delete\", seq, namespace: write.namespace, key: write.key };\n\t}\n}\n\nexport function materializeCommittedEntry(entry: NewEntry, seq: number, timestamp: number): Entry {\n\treturn { ...entry, seq, timestamp };\n}\n\nexport function prepareStorageCommit(writes: Write[], firstSeq: number, timestamp: number): PreparedCommit {\n\tconst committedWrites = writes.map((write, index) => commitWrite(write, firstSeq + index, timestamp));\n\treturn {\n\t\twrites: committedWrites,\n\t\tresult: { firstSeq, seqs: committedWrites.map((write) => write.seq), timestamp },\n\t};\n}\n\nexport function validateCommittedWrites(\n\twrites: readonly CommittedWrite[],\n\tfirstSeq: number,\n\tstate: CommitValidationState,\n): void {\n\tlet previousSeq = firstSeq - 1;\n\tconst transactionIds = new Set<string>();\n\tconst transactionEntryIds = new Set<string>();\n\tfor (const write of writes) {\n\t\tif (write.seq <= previousSeq) throw new Error(`Non-monotonic storage sequence: ${write.seq}`);\n\t\tpreviousSeq = write.seq;\n\t\tif (write.kind !== \"entry\" && write.kind !== \"usage\") continue;\n\t\tif (state.hasEntryOrUsageId(write.id) || transactionIds.has(write.id)) {\n\t\t\tthrow new Error(`Duplicate entry or usage id: ${write.id}`);\n\t\t}\n\t\tif (\n\t\t\twrite.kind === \"entry\" &&\n\t\t\twrite.parentId !== null &&\n\t\t\t!state.hasEntryId(write.parentId) &&\n\t\t\t!transactionEntryIds.has(write.parentId)\n\t\t) {\n\t\t\tthrow new Error(`Missing parent entry: ${write.parentId}`);\n\t\t}\n\t\ttransactionIds.add(write.id);\n\t\tif (write.kind === \"entry\") transactionEntryIds.add(write.id);\n\t}\n}\n"]}

package/dist/harness/session/context.d.ts

@@ -1,23 +1,10 @@
 import type { AgentMessage } from "../../types.ts";
-import type { ConfigurationUpdateEntry, CustomEntry, Entry } from "./types.ts";
-export interface SessionContext {
-    messages: AgentMessage[];
-    thinkingLevel: string;
-    configurationUpdate: ConfigurationUpdateEntry["reasoning"] | null;
-    model: {
-        provider: string;
-        modelId: string;
-    } | null;
-    activeToolNames: string[] | null;
-}
-export type ContextEntryTransform = (entries: readonly Entry[]) => readonly Entry[];
-export type CustomEntryContextMessageProjector = (entry: CustomEntry, index: number, entries: readonly Entry[]) => readonly AgentMessage[] | undefined;
+import type { Context } from "../context.ts";
+import type { Entry, EntryProjector } from "./types.ts";
 export interface SessionContextBuildOptions {
-    entryTransforms?: readonly ContextEntryTransform[];
-    entryProjectors?: Readonly<Record<string, CustomEntryContextMessageProjector>>;
+    entryProjectors?: Readonly<Record<string, EntryProjector>>;
 }
-export declare function defaultContextEntryTransform(pathEntries: readonly Entry[]): Entry[];
-export declare function buildContextEntries(pathEntries: readonly Entry[], options?: SessionContextBuildOptions): Entry[];
-export declare function sessionEntryToContextMessages(entry: Entry, index: number, entries: readonly Entry[], options?: SessionContextBuildOptions): AgentMessage[];
-export declare function buildSessionContext(pathEntries: readonly Entry[], options?: SessionContextBuildOptions): SessionContext;
+export declare function buildContextEntries(pathEntries: readonly Entry[]): Entry[];
+export declare function sessionEntryToContextMessages(entry: Entry): AgentMessage[];
+export declare function buildSessionContext(pathEntries: readonly Entry[], options: SessionContextBuildOptions | undefined, context: Context): Promise<AgentMessage[]>;
 //# sourceMappingURL=context.d.ts.map

package/dist/harness/session/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/harness/session/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAmB,wBAAwB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEhG,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,wBAAwB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAClE,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpD,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,KAAK,SAAS,KAAK,EAAE,CAAC;AAEpF,MAAM,MAAM,kCAAkC,GAAG,CAChD,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,KAAK,EAAE,KACrB,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;AAEzC,MAAM,WAAW,0BAA0B;IAC1C,eAAe,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC,CAAC;CAC/E;AAyBD,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAYnF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,GAAE,0BAA+B,GAAG,KAAK,EAAE,CAIpH;AAED,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,KAAK,EAAE,EACzB,OAAO,GAAE,0BAA+B,GACtC,YAAY,EAAE,CAkBhB;AAED,wBAAgB,mBAAmB,CAClC,WAAW,EAAE,SAAS,KAAK,EAAE,EAC7B,OAAO,GAAE,0BAA+B,GACtC,cAAc,CAOhB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/harness/session/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAmB,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IAC1C,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC3D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAY1E;AASD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,EAAE,CAc1E;AAED,wBAAsB,mBAAmB,CACxC,WAAW,EAAE,SAAS,KAAK,EAAE,EAC7B,OAAO,EAAE,0BAA0B,GAAG,SAAS,EAC/C,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB"}

package/dist/harness/session/context.js

@@ -1,34 +1,10 @@
 import { createBranchSummaryMessage, createCompactionSummaryMessage } from "../messages.js";
-function deriveSessionContextState(pathEntries) {
-    let thinkingLevel = "off";
-    let configurationUpdate = null;
-    let model = null;
-    let activeToolNames = null;
-    for (const entry of pathEntries) {
-        if (entry.type === "thinking_level_change") {
-            thinkingLevel = entry.thinkingLevel;
-        }
-        else if (entry.type === "configuration_update") {
-            configurationUpdate = { ...entry.reasoning };
-        }
-        else if (entry.type === "model_change") {
-            model = { provider: entry.provider, modelId: entry.modelId };
-        }
-        else if (entry.type === "message" && entry.message.role === "assistant") {
-            model = { provider: entry.message.provider, modelId: entry.message.model };
-        }
-        else if (entry.type === "active_tools_change") {
-            activeToolNames = [...entry.activeToolNames];
-        }
-    }
-    return { thinkingLevel, configurationUpdate, model, activeToolNames };
-}
-export function defaultContextEntryTransform(pathEntries) {
+export function buildContextEntries(pathEntries) {
     let compaction;
     let compactionIndex = -1;
     for (let index = pathEntries.length - 1; index >= 0; index--) {
         const entry = pathEntries[index];
-        if (entry.type === "compaction") {
+        if (entry?.type === "compaction") {
             compaction = entry;
             compactionIndex = index;
             break;
@@ -36,36 +12,38 @@ export function defaultContextEntryTransform(pathEntries) {
     }
     return compaction === undefined ? [...pathEntries] : [compaction, ...pathEntries.slice(compactionIndex + 1)];
 }
-export function buildContextEntries(pathEntries, options = {}) {
-    let entries = defaultContextEntryTransform(pathEntries);
-    for (const transform of options.entryTransforms ?? [])
-        entries = [...transform(entries)];
-    return entries;
+function isContextMessage(message) {
+    return (message.role !== "assistant" ||
+        (message.stopReason !== "error" && message.stopReason !== "aborted" && message.stopReason !== "deferred"));
 }
-export function sessionEntryToContextMessages(entry, index, entries, options = {}) {
-    if (entry.type === "message") {
-        if (entry.message.role === "assistant" && entry.message.stopReason === "deferred")
+export function sessionEntryToContextMessages(entry) {
+    switch (entry.type) {
+        case "message":
+            return isContextMessage(entry.message) ? [entry.message] : [];
+        case "compaction":
+            return [
+                createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),
+                ...entry.retainedTail.filter(isContextMessage),
+            ];
+        case "branch_summary":
+            return entry.summary ? [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)] : [];
+        case "custom":
             return [];
-        return [entry.message];
-    }
-    if (entry.type === "compaction") {
-        return [
-            createCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),
-            ...entry.retainedTail,
-        ];
-    }
-    if (entry.type === "branch_summary" && entry.summary) {
-        return [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];
     }
-    if (entry.type === "custom") {
-        return [...(options.entryProjectors?.[entry.customType]?.(entry, index, entries) ?? [])];
-    }
-    return [];
 }
-export function buildSessionContext(pathEntries, options = {}) {
-    const state = deriveSessionContextState(pathEntries);
-    const contextEntries = buildContextEntries(pathEntries, options);
-    const messages = contextEntries.flatMap((entry, index) => sessionEntryToContextMessages(entry, index, contextEntries, options));
-    return { ...state, messages };
+export async function buildSessionContext(pathEntries, options, context) {
+    options ??= {};
+    const entries = buildContextEntries(pathEntries);
+    const messages = [];
+    for (const entry of entries) {
+        if (entry.type !== "custom") {
+            messages.push(...sessionEntryToContextMessages(entry));
+            continue;
+        }
+        const projector = options.entryProjectors?.[entry.customType];
+        if (projector !== undefined)
+            messages.push(...((await projector(entry, context)) ?? []));
+    }
+    return messages;
 }
 //# sourceMappingURL=context.js.map

package/dist/harness/session/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/harness/session/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentMessage } from \"../../types.ts\";\nimport { createBranchSummaryMessage, createCompactionSummaryMessage } from \"../messages.ts\";\nimport type { CompactionEntry, ConfigurationUpdateEntry, CustomEntry, Entry } from \"./types.ts\";\n\nexport interface SessionContext {\n\tmessages: AgentMessage[];\n\tthinkingLevel: string;\n\tconfigurationUpdate: ConfigurationUpdateEntry[\"reasoning\"] | null;\n\tmodel: { provider: string; modelId: string } | null;\n\tactiveToolNames: string[] | null;\n}\n\nexport type ContextEntryTransform = (entries: readonly Entry[]) => readonly Entry[];\n\nexport type CustomEntryContextMessageProjector = (\n\tentry: CustomEntry,\n\tindex: number,\n\tentries: readonly Entry[],\n) => readonly AgentMessage[] | undefined;\n\nexport interface SessionContextBuildOptions {\n\tentryTransforms?: readonly ContextEntryTransform[];\n\tentryProjectors?: Readonly<Record<string, CustomEntryContextMessageProjector>>;\n}\n\nfunction deriveSessionContextState(pathEntries: readonly Entry[]): Omit<SessionContext, \"messages\"> {\n\tlet thinkingLevel = \"off\";\n\tlet configurationUpdate: ConfigurationUpdateEntry[\"reasoning\"] | null = null;\n\tlet model: { provider: string; modelId: string } | null = null;\n\tlet activeToolNames: string[] | null = null;\n\n\tfor (const entry of pathEntries) {\n\t\tif (entry.type === \"thinking_level_change\") {\n\t\t\tthinkingLevel = entry.thinkingLevel;\n\t\t} else if (entry.type === \"configuration_update\") {\n\t\t\tconfigurationUpdate = { ...entry.reasoning };\n\t\t} else if (entry.type === \"model_change\") {\n\t\t\tmodel = { provider: entry.provider, modelId: entry.modelId };\n\t\t} else if (entry.type === \"message\" && entry.message.role === \"assistant\") {\n\t\t\tmodel = { provider: entry.message.provider, modelId: entry.message.model };\n\t\t} else if (entry.type === \"active_tools_change\") {\n\t\t\tactiveToolNames = [...entry.activeToolNames];\n\t\t}\n\t}\n\n\treturn { thinkingLevel, configurationUpdate, model, activeToolNames };\n}\n\nexport function defaultContextEntryTransform(pathEntries: readonly Entry[]): Entry[] {\n\tlet compaction: CompactionEntry | undefined;\n\tlet compactionIndex = -1;\n\tfor (let index = pathEntries.length - 1; index >= 0; index--) {\n\t\tconst entry = pathEntries[index]!;\n\t\tif (entry.type === \"compaction\") {\n\t\t\tcompaction = entry;\n\t\t\tcompactionIndex = index;\n\t\t\tbreak;\n\t\t}\n\t}\n\treturn compaction === undefined ? [...pathEntries] : [compaction, ...pathEntries.slice(compactionIndex + 1)];\n}\n\nexport function buildContextEntries(pathEntries: readonly Entry[], options: SessionContextBuildOptions = {}): Entry[] {\n\tlet entries = defaultContextEntryTransform(pathEntries);\n\tfor (const transform of options.entryTransforms ?? []) entries = [...transform(entries)];\n\treturn entries;\n}\n\nexport function sessionEntryToContextMessages(\n\tentry: Entry,\n\tindex: number,\n\tentries: readonly Entry[],\n\toptions: SessionContextBuildOptions = {},\n): AgentMessage[] {\n\tif (entry.type === \"message\") {\n\t\tif (entry.message.role === \"assistant\" && entry.message.stopReason === \"deferred\") return [];\n\t\treturn [entry.message];\n\t}\n\tif (entry.type === \"compaction\") {\n\t\treturn [\n\t\t\tcreateCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),\n\t\t\t...entry.retainedTail,\n\t\t];\n\t}\n\tif (entry.type === \"branch_summary\" && entry.summary) {\n\t\treturn [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)];\n\t}\n\tif (entry.type === \"custom\") {\n\t\treturn [...(options.entryProjectors?.[entry.customType]?.(entry, index, entries) ?? [])];\n\t}\n\treturn [];\n}\n\nexport function buildSessionContext(\n\tpathEntries: readonly Entry[],\n\toptions: SessionContextBuildOptions = {},\n): SessionContext {\n\tconst state = deriveSessionContextState(pathEntries);\n\tconst contextEntries = buildContextEntries(pathEntries, options);\n\tconst messages = contextEntries.flatMap((entry, index) =>\n\t\tsessionEntryToContextMessages(entry, index, contextEntries, options),\n\t);\n\treturn { ...state, messages };\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/harness/session/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAO5F,MAAM,UAAU,mBAAmB,CAAC,WAA6B;IAChE,IAAI,UAAuC,CAAC;IAC5C,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,IAAI,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;YAClC,UAAU,GAAG,KAAK,CAAC;YACnB,eAAe,GAAG,KAAK,CAAC;YACxB,MAAM;QACP,CAAC;IACF,CAAC;IACD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAqB;IAC9C,OAAO,CACN,OAAO,CAAC,IAAI,KAAK,WAAW;QAC5B,CAAC,OAAO,CAAC,UAAU,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,UAAU,CAAC,CACzG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAY;IACzD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACb,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,KAAK,YAAY;YAChB,OAAO;gBACN,8BAA8B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;gBAClF,GAAG,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,gBAAgB,CAAC;aAC9C,CAAC;QACH,KAAK,gBAAgB;YACpB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,KAAK,QAAQ;YACZ,OAAO,EAAE,CAAC;IACZ,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,WAA6B,EAC7B,OAA+C,EAC/C,OAAgB;IAEhB,OAAO,KAAK,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC,CAAC;YACvD,SAAS;QACV,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC9D,IAAI,SAAS,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC","sourcesContent":["import type { AgentMessage } from \"../../types.ts\";\nimport type { Context } from \"../context.ts\";\nimport { createBranchSummaryMessage, createCompactionSummaryMessage } from \"../messages.ts\";\nimport type { CompactionEntry, Entry, EntryProjector } from \"./types.ts\";\n\nexport interface SessionContextBuildOptions {\n\tentryProjectors?: Readonly<Record<string, EntryProjector>>;\n}\n\nexport function buildContextEntries(pathEntries: readonly Entry[]): Entry[] {\n\tlet compaction: CompactionEntry | undefined;\n\tlet compactionIndex = -1;\n\tfor (let index = pathEntries.length - 1; index >= 0; index--) {\n\t\tconst entry = pathEntries[index];\n\t\tif (entry?.type === \"compaction\") {\n\t\t\tcompaction = entry;\n\t\t\tcompactionIndex = index;\n\t\t\tbreak;\n\t\t}\n\t}\n\treturn compaction === undefined ? [...pathEntries] : [compaction, ...pathEntries.slice(compactionIndex + 1)];\n}\n\nfunction isContextMessage(message: AgentMessage): boolean {\n\treturn (\n\t\tmessage.role !== \"assistant\" ||\n\t\t(message.stopReason !== \"error\" && message.stopReason !== \"aborted\" && message.stopReason !== \"deferred\")\n\t);\n}\n\nexport function sessionEntryToContextMessages(entry: Entry): AgentMessage[] {\n\tswitch (entry.type) {\n\t\tcase \"message\":\n\t\t\treturn isContextMessage(entry.message) ? [entry.message] : [];\n\t\tcase \"compaction\":\n\t\t\treturn [\n\t\t\t\tcreateCompactionSummaryMessage(entry.summary, entry.tokensBefore, entry.timestamp),\n\t\t\t\t...entry.retainedTail.filter(isContextMessage),\n\t\t\t];\n\t\tcase \"branch_summary\":\n\t\t\treturn entry.summary ? [createBranchSummaryMessage(entry.summary, entry.fromId, entry.timestamp)] : [];\n\t\tcase \"custom\":\n\t\t\treturn [];\n\t}\n}\n\nexport async function buildSessionContext(\n\tpathEntries: readonly Entry[],\n\toptions: SessionContextBuildOptions | undefined,\n\tcontext: Context,\n): Promise<AgentMessage[]> {\n\toptions ??= {};\n\tconst entries = buildContextEntries(pathEntries);\n\tconst messages: AgentMessage[] = [];\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"custom\") {\n\t\t\tmessages.push(...sessionEntryToContextMessages(entry));\n\t\t\tcontinue;\n\t\t}\n\t\tconst projector = options.entryProjectors?.[entry.customType];\n\t\tif (projector !== undefined) messages.push(...((await projector(entry, context)) ?? []));\n\t}\n\treturn messages;\n}\n"]}

package/dist/harness/session/fork-policy.d.ts

@@ -0,0 +1,21 @@
+import type { CommittedListAppendWrite, CommittedValueSetWrite } from "./commit.ts";
+import type { ForkOptions } from "./types.ts";
+export type ForkCurrentStatePlan = {
+    scope: "branch";
+    branch: string;
+    destinationTip: string | null;
+} | {
+    scope: "tree";
+};
+export declare function selectBranchFork(options: Extract<ForkOptions, {
+    scope: "branch";
+}>, source: {
+    tip: string | null | undefined;
+    getParent: (entryId: string) => string | null | undefined;
+    selectEntry: (entryId: string) => void;
+}): Extract<ForkCurrentStatePlan, {
+    scope: "branch";
+}>;
+/** Project one current scalar row or surviving list element into destination state. */
+export declare function projectForkCurrentStateWrite(write: CommittedValueSetWrite | CommittedListAppendWrite, plan: ForkCurrentStatePlan, isEntryCopied: (entryId: string) => boolean): CommittedValueSetWrite | CommittedListAppendWrite | undefined;
+//# sourceMappingURL=fork-policy.d.ts.map

package/dist/harness/session/fork-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-policy.d.ts","sourceRoot":"","sources":["../../../src/harness/session/fork-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,oBAAoB,GAC7B;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAClE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,EAClD,MAAM,EAAE;IACP,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1D,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,GACC,OAAO,CAAC,oBAAoB,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAsBpD;AAED,uFAAuF;AACvF,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,sBAAsB,GAAG,wBAAwB,EACxD,IAAI,EAAE,oBAAoB,EAC1B,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GACzC,sBAAsB,GAAG,wBAAwB,GAAG,SAAS,CAuB/D"}

package/dist/harness/session/fork-policy.js

@@ -0,0 +1,55 @@
+export function selectBranchFork(options, source) {
+    if (source.tip === undefined)
+        throw new Error(`Unknown source branch: ${options.branch}`);
+    const requested = options.entryId ?? source.tip;
+    let found = requested === null;
+    let destinationTip = null;
+    let entryId = source.tip;
+    while (entryId !== null) {
+        const parentId = source.getParent(entryId);
+        if (parentId === undefined)
+            throw new Error(`Corrupt source branch: missing parent ${entryId}`);
+        if (entryId === requested) {
+            found = true;
+            destinationTip = options.position === "before" ? parentId : entryId;
+            if (options.position !== "before")
+                source.selectEntry(entryId);
+        }
+        else if (found) {
+            source.selectEntry(entryId);
+        }
+        entryId = parentId;
+    }
+    if (!found) {
+        throw new Error(`Fork entry ${requested} is not on source branch ${JSON.stringify(options.branch)}`);
+    }
+    return { scope: "branch", branch: options.branch, destinationTip };
+}
+/** Project one current scalar row or surviving list element into destination state. */
+export function projectForkCurrentStateWrite(write, plan, isEntryCopied) {
+    switch (write.namespace) {
+        case "pi.session.name":
+            return write;
+        case "pi.entry.label":
+            return isEntryCopied(write.key) ? write : undefined;
+        case "pi.branch.tip":
+            if (plan.scope === "tree")
+                return write;
+            return write.key === plan.branch ? { ...write, value: plan.destinationTip } : undefined;
+        case "pi.lane.config":
+            return plan.scope === "tree" || write.key === plan.branch ? write : undefined;
+        case "pi.lane.state":
+            return plan.scope === "tree" || write.key === plan.branch
+                ? { ...write, value: { currentOperationId: null, lastOperationId: null, inbox: [] } }
+                : undefined;
+        case "pi.result":
+            return undefined;
+    }
+    if (write.namespace.startsWith("pi.op.") || write.namespace.startsWith("pi.pending."))
+        return undefined;
+    if (write.namespace === "pi" || write.namespace.startsWith("pi.")) {
+        throw new Error(`Unknown reserved fork namespace: ${write.namespace}`);
+    }
+    return plan.scope === "tree" ? write : undefined;
+}
+//# sourceMappingURL=fork-policy.js.map

package/dist/harness/session/fork-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-policy.js","sourceRoot":"","sources":["../../../src/harness/session/fork-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CommittedListAppendWrite, CommittedValueSetWrite } from \"./commit.ts\";\nimport type { ForkOptions } from \"./types.ts\";\n\nexport type ForkCurrentStatePlan =\n\t| { scope: \"branch\"; branch: string; destinationTip: string | null }\n\t| { scope: \"tree\" };\n\nexport function selectBranchFork(\n\toptions: Extract<ForkOptions, { scope: \"branch\" }>,\n\tsource: {\n\t\ttip: string | null | undefined;\n\t\tgetParent: (entryId: string) => string | null | undefined;\n\t\tselectEntry: (entryId: string) => void;\n\t},\n): Extract<ForkCurrentStatePlan, { scope: \"branch\" }> {\n\tif (source.tip === undefined) throw new Error(`Unknown source branch: ${options.branch}`);\n\tconst requested = options.entryId ?? source.tip;\n\tlet found = requested === null;\n\tlet destinationTip: string | null = null;\n\tlet entryId = source.tip;\n\twhile (entryId !== null) {\n\t\tconst parentId = source.getParent(entryId);\n\t\tif (parentId === undefined) throw new Error(`Corrupt source branch: missing parent ${entryId}`);\n\t\tif (entryId === requested) {\n\t\t\tfound = true;\n\t\t\tdestinationTip = options.position === \"before\" ? parentId : entryId;\n\t\t\tif (options.position !== \"before\") source.selectEntry(entryId);\n\t\t} else if (found) {\n\t\t\tsource.selectEntry(entryId);\n\t\t}\n\t\tentryId = parentId;\n\t}\n\tif (!found) {\n\t\tthrow new Error(`Fork entry ${requested} is not on source branch ${JSON.stringify(options.branch)}`);\n\t}\n\treturn { scope: \"branch\", branch: options.branch, destinationTip };\n}\n\n/** Project one current scalar row or surviving list element into destination state. */\nexport function projectForkCurrentStateWrite(\n\twrite: CommittedValueSetWrite | CommittedListAppendWrite,\n\tplan: ForkCurrentStatePlan,\n\tisEntryCopied: (entryId: string) => boolean,\n): CommittedValueSetWrite | CommittedListAppendWrite | undefined {\n\tswitch (write.namespace) {\n\t\tcase \"pi.session.name\":\n\t\t\treturn write;\n\t\tcase \"pi.entry.label\":\n\t\t\treturn isEntryCopied(write.key) ? write : undefined;\n\t\tcase \"pi.branch.tip\":\n\t\t\tif (plan.scope === \"tree\") return write;\n\t\t\treturn write.key === plan.branch ? { ...write, value: plan.destinationTip } : undefined;\n\t\tcase \"pi.lane.config\":\n\t\t\treturn plan.scope === \"tree\" || write.key === plan.branch ? write : undefined;\n\t\tcase \"pi.lane.state\":\n\t\t\treturn plan.scope === \"tree\" || write.key === plan.branch\n\t\t\t\t? { ...write, value: { currentOperationId: null, lastOperationId: null, inbox: [] } }\n\t\t\t\t: undefined;\n\t\tcase \"pi.result\":\n\t\t\treturn undefined;\n\t}\n\tif (write.namespace.startsWith(\"pi.op.\") || write.namespace.startsWith(\"pi.pending.\")) return undefined;\n\tif (write.namespace === \"pi\" || write.namespace.startsWith(\"pi.\")) {\n\t\tthrow new Error(`Unknown reserved fork namespace: ${write.namespace}`);\n\t}\n\treturn plan.scope === \"tree\" ? write : undefined;\n}\n"]}

package/dist/harness/session/fork.d.ts

@@ -0,0 +1,16 @@
+import type { Entry, ForkOptions } from "./types.ts";
+import { type StoredValue } from "./values.ts";
+export interface ForkSourceSnapshot {
+    entries: Entry[];
+    scalarValues: StoredValue<unknown>[];
+    /** False when a backend supplied only the requested branch rather than the full tree. */
+    entriesComplete?: boolean;
+}
+export interface ForkDestinationSnapshot {
+    entries: Map<string, Entry>;
+    scalarValues: StoredValue<unknown>[];
+    nextSeq: number;
+}
+/** Build the complete logical state for a forked destination session. */
+export declare function createForkSnapshot(source: ForkSourceSnapshot, options: ForkOptions): ForkDestinationSnapshot;
+//# sourceMappingURL=fork.d.ts.map

package/dist/harness/session/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../../src/harness/session/fork.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAoC,KAAK,WAAW,EAAqB,MAAM,aAAa,CAAC;AAEpG,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,yFAAyF;IACzF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACvC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CAChB;AAYD,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,GAAG,uBAAuB,CAkC5G"}