@earendil-works/pi-agent-core 0.84.4 → 0.85.0

package/dist/harness/runtime/harness.js

@@ -0,0 +1,311 @@
+import { DEFAULT_COMPACTION_SETTINGS } from "../compaction/compaction.js";
+import { DEFAULT_RETRY_POLICY, validateCompactionSettings, validateRetryPolicy, validateToolNames } from "../config.js";
+import { HarnessEventBus } from "../events.js";
+import { HookRegistry } from "../hooks.js";
+import { convertToLlm } from "../messages.js";
+import { HarnessClosed, HarnessFault, InvalidLane, UnknownTarget } from "../result.js";
+import { SessionInvariantError } from "../session/session.js";
+import { branchTip, deleteValue, entryLabel, laneConfig, laneState, sessionName, setValue } from "../session/values.js";
+import { Lane } from "./lane.js";
+import { readLaneStorage, restoreLaneState, restoreSession } from "./restore.js";
+import { SliceNotImplemented } from "./types.js";
+/** Runtime implementation of AgentHarness. The harness manages lanes but is not itself a lane. */
+export class Harness {
+    session;
+    models;
+    hooks;
+    events;
+    lanesByName = new Map();
+    seed;
+    configStore;
+    closePromise;
+    closedError;
+    faultError;
+    constructor(options, seed, restored) {
+        this.session = options.session;
+        this.models = options.models;
+        this.seed = seed;
+        this.events = new HarnessEventBus();
+        this.hooks = new HookRegistry((error, hook, lane, context) => this.events.emit({
+            type: "handler_error",
+            kind: "hook",
+            hook,
+            error: error.message,
+            ...(error.stack === undefined ? {} : { stack: error.stack }),
+            lane,
+        }, context));
+        this.configStore = {
+            value: {
+                tools: options.tools ?? [],
+                resources: options.resources ?? {},
+                streamOptions: options.streamOptions ?? {},
+                retryPolicy: options.retry ?? DEFAULT_RETRY_POLICY,
+                compaction: options.compaction ?? DEFAULT_COMPACTION_SETTINGS,
+                steeringMode: options.steeringMode ?? "all",
+                followUpMode: options.followUpMode ?? "all",
+                toolExecution: options.toolExecution ?? "parallel",
+                toolContext: options.toolContext,
+                systemPrompt: options.systemPrompt,
+                toProviderMessages: options.toProviderMessages ?? ((messages) => convertToLlm(messages)),
+                entryProjectors: options.entryProjectors ?? {},
+            },
+        };
+        for (const [name, state] of restored)
+            this.lanesByName.set(name, this.buildLane(name, state));
+    }
+    async lane(name, optionsOrContext, maybeContext) {
+        this.assertOpen();
+        if (name.length === 0 || name.includes("\u0000")) {
+            const reason = name.length === 0 ? "lane name must not be empty" : "lane name must not contain \\u0000";
+            throw new InvalidLane({
+                lane: name,
+                reason,
+                message: `Invalid lane ${JSON.stringify(name)}: ${reason}`,
+            });
+        }
+        const options = maybeContext === undefined ? {} : optionsOrContext;
+        const context = maybeContext ?? optionsOrContext;
+        let lane;
+        let delivery;
+        try {
+            await this.session.mutate(async (mutator) => {
+                this.assertOpen();
+                lane = this.lanesByName.get(name);
+                if (lane !== undefined)
+                    return;
+                const stored = await readLaneStorage(mutator, name, context);
+                if (stored.kind === "lane") {
+                    const restored = await restoreLaneState(mutator, name, stored, context);
+                    lane = this.buildLane(name, restored);
+                    this.lanesByName.set(name, lane);
+                    return;
+                }
+                const tipId = stored.kind === "branch" ? stored.tip.value : (options.createAt ?? null);
+                if (stored.kind === "absent" &&
+                    tipId !== null &&
+                    !(await mutator.getEntries([tipId], context)).has(tipId)) {
+                    throw new UnknownTarget({
+                        targetId: tipId,
+                        message: `Unknown target: ${tipId}`,
+                    });
+                }
+                const attachedConfiguration = {
+                    model: { ...this.seed.model },
+                    thinkingLevel: this.seed.thinkingLevel,
+                    activeToolNames: [...this.seed.activeToolNames],
+                };
+                const state = {
+                    tipId,
+                    configuration: attachedConfiguration,
+                    inbox: [],
+                    lastOperationId: null,
+                    operation: null,
+                };
+                const writes = [
+                    ...(stored.kind === "absent" ? [setValue(branchTip(name), tipId)] : []),
+                    setValue(laneConfig(name), attachedConfiguration),
+                    setValue(laneState(name), {
+                        currentOperationId: null,
+                        lastOperationId: null,
+                        inbox: [],
+                    }),
+                ];
+                await mutator.commit(writes, context);
+                lane = this.buildLane(name, state);
+                this.lanesByName.set(name, lane);
+                delivery = this.events.emitBatch([{ type: "lane_created", lane: name, at: tipId }], context);
+            }, context);
+        }
+        catch (error) {
+            if (this.closedError !== undefined)
+                throw this.closedError;
+            if (error instanceof InvalidLane || error instanceof UnknownTarget)
+                throw error;
+            throw this.fault(error, context);
+        }
+        await delivery;
+        if (lane === undefined)
+            throw this.fault(new SessionInvariantError(`Lane ${JSON.stringify(name)} was not published`), context);
+        return lane;
+    }
+    async lanes(context) {
+        this.assertOpen();
+        const executions = await Promise.all([...this.lanesByName.values()].map((lane) => lane.inspectExecution(context)));
+        return executions.map((execution) => ({
+            name: execution.lane,
+            tipId: execution.tipId,
+            operation: execution.current,
+        }));
+    }
+    getName(context) {
+        this.assertOpen();
+        return this.session.getName(context);
+    }
+    async setName(name, context) {
+        this.assertOpen();
+        let delivery;
+        try {
+            await this.session.mutate(async (mutator) => {
+                this.assertOpen();
+                await mutator.commit([name === undefined ? deleteValue(sessionName) : setValue(sessionName, name)], context);
+                delivery = this.events.emitBatch([{ type: "value_update", value: "session_name", name }], context);
+            }, context);
+        }
+        catch (error) {
+            if (this.closedError !== undefined)
+                throw this.closedError;
+            throw this.fault(error, context);
+        }
+        await delivery;
+    }
+    getLabel(targetId, context) {
+        this.assertOpen();
+        return this.session.getLabel(targetId, context);
+    }
+    async setLabel(targetId, label, context) {
+        this.assertOpen();
+        let delivery;
+        try {
+            await this.session.mutate(async (mutator) => {
+                this.assertOpen();
+                const address = entryLabel(targetId);
+                await mutator.commit([label === undefined ? deleteValue(address) : setValue(address, label)], context);
+                delivery = this.events.emitBatch([{ type: "value_update", value: "entry_label", targetId, label }], context);
+            }, context);
+        }
+        catch (error) {
+            if (this.closedError !== undefined)
+                throw this.closedError;
+            throw this.fault(error, context);
+        }
+        await delivery;
+    }
+    getTools(context) {
+        return this.getConfig("tools", context);
+    }
+    setTools(tools, context) {
+        validateToolNames(tools);
+        return this.setConfig("tools", tools, () => ({ type: "config_update", property: "tools" }), context);
+    }
+    getResources(context) {
+        return this.getConfig("resources", context);
+    }
+    setResources(resources, context) {
+        return this.setConfig("resources", resources, () => ({ type: "config_update", property: "resources" }), context);
+    }
+    getStreamOptions(context) {
+        return this.getConfig("streamOptions", context);
+    }
+    setStreamOptions(options, context) {
+        return this.setConfig("streamOptions", options, (previous, value) => ({ type: "config_update", property: "streamOptions", previous, value }), context);
+    }
+    getRetryPolicy(context) {
+        return this.getConfig("retryPolicy", context);
+    }
+    setRetryPolicy(policy, context) {
+        validateRetryPolicy(policy);
+        return this.setConfig("retryPolicy", policy, (previous, value) => ({ type: "config_update", property: "retryPolicy", previous, value }), context);
+    }
+    getCompactionSettings(context) {
+        return this.getConfig("compaction", context);
+    }
+    setCompactionSettings(compaction, context) {
+        validateCompactionSettings(compaction);
+        return this.setConfig("compaction", compaction, (previous, value) => ({ type: "config_update", property: "compactionSettings", previous, value }), context);
+    }
+    getSteeringMode(context) {
+        return this.getConfig("steeringMode", context);
+    }
+    setSteeringMode(steeringMode, context) {
+        return this.setConfig("steeringMode", steeringMode, (previous, value) => ({ type: "config_update", property: "steeringMode", previous, value }), context);
+    }
+    getFollowUpMode(context) {
+        return this.getConfig("followUpMode", context);
+    }
+    setFollowUpMode(followUpMode, context) {
+        return this.setConfig("followUpMode", followUpMode, (previous, value) => ({ type: "config_update", property: "followUpMode", previous, value }), context);
+    }
+    async watchSession(_context) {
+        throw new SliceNotImplemented("watchSession");
+    }
+    fault(cause, context) {
+        if (this.faultError !== undefined)
+            return this.faultError;
+        if (this.closedError !== undefined)
+            return this.closedError;
+        const normalized = cause instanceof Error ? cause : new Error(String(cause));
+        const fault = new HarnessFault("AgentHarness storage or invariant fault", normalized);
+        this.faultError = fault;
+        for (const lane of this.lanesByName.values())
+            lane.seal(fault);
+        this.hooks.close(fault);
+        void this.events.emit({ type: "fault", code: "harness_fault", message: fault.message }, context);
+        this.events.close(fault);
+        return fault;
+    }
+    close(context) {
+        if (this.closePromise !== undefined)
+            return this.closePromise;
+        const error = new HarnessClosed();
+        this.closedError = error;
+        const idleCallbacks = [...this.lanesByName.values()].map((lane) => lane.seal(error));
+        this.hooks.close(error);
+        this.events.close(error);
+        const sessionClose = this.session.close(context);
+        this.closePromise = Promise.all([sessionClose, ...idleCallbacks]).then(() => undefined);
+        return this.closePromise;
+    }
+    buildLane(name, state) {
+        return new Lane(name, this.session, this.models, this.hooks, state, (cause, context) => this.fault(cause, context), (events, context) => this.events.emitBatch(events, context), (snapshot, filter, context, resnapshot) => this.events.watch(snapshot, filter, context, resnapshot), () => this.configStore.value);
+    }
+    async getConfig(key, _context) {
+        this.assertOpen();
+        return this.configStore.value[key];
+    }
+    async setConfig(key, value, event, context) {
+        this.assertOpen();
+        const previous = this.configStore.value[key];
+        this.configStore.value = { ...this.configStore.value, [key]: value };
+        await this.events.emit(event(previous, value), context);
+    }
+    assertOpen() {
+        if (this.faultError !== undefined)
+            throw this.faultError;
+        if (this.closedError !== undefined)
+            throw this.closedError;
+    }
+}
+/** Attach runtime without starting provider, tool, hook, or timer effects. */
+export async function createAgentHarness(options, context) {
+    const tools = options.tools ?? [];
+    validateToolNames(tools);
+    validateRetryPolicy(options.retry ?? DEFAULT_RETRY_POLICY);
+    validateCompactionSettings(options.compaction ?? DEFAULT_COMPACTION_SETTINGS);
+    const seed = {
+        model: { provider: options.model.provider, modelId: options.model.id },
+        thinkingLevel: options.thinkingLevel ?? "off",
+        activeToolNames: [...(options.activeToolNames ?? tools.map((tool) => tool.name))],
+    };
+    try {
+        const restored = await restoreSession(options.session, context);
+        const open = [...restored].flatMap(([lane, state]) => {
+            const operation = state.operation;
+            return operation === null
+                ? []
+                : [
+                    {
+                        lane,
+                        operationId: operation.meta.operationId,
+                        kind: operation.meta.intent.kind,
+                        startedAt: operation.meta.startedAt,
+                        ...(operation.state.control.status === "cancel_requested" ? { aborting: true } : {}),
+                    },
+                ];
+        });
+        return { harness: new Harness(options, seed, restored), open };
+    }
+    catch (error) {
+        throw new HarnessFault("AgentHarness storage or invariant fault", error);
+    }
+}
+//# sourceMappingURL=harness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../src/harness/runtime/harness.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Models, RetryPolicy } from \"@earendil-works/pi-ai\";\nimport type { QueueMode } from \"../../types.ts\";\nimport type {\n\tAcquireLaneOptions,\n\tAgentHarness,\n\tAgentHarnessOptions,\n\tAgentLane,\n\tGlobalConfigEventPayload,\n\tLaneInfo,\n\tOpenOperation,\n\tResources,\n} from \"../agent-harness.ts\";\nimport { type CompactionSettings, DEFAULT_COMPACTION_SETTINGS } from \"../compaction/compaction.ts\";\nimport { DEFAULT_RETRY_POLICY, validateCompactionSettings, validateRetryPolicy, validateToolNames } from \"../config.ts\";\nimport type { Context } from \"../context.ts\";\nimport { HarnessEventBus } from \"../events.ts\";\nimport { HookRegistry } from \"../hooks.ts\";\nimport { convertToLlm } from \"../messages.ts\";\nimport { HarnessClosed, HarnessFault, InvalidLane, UnknownTarget } from \"../result.ts\";\nimport { SessionInvariantError } from \"../session/session.ts\";\nimport type { LaneConfiguration, Session } from \"../session/types.ts\";\nimport { branchTip, deleteValue, entryLabel, laneConfig, laneState, sessionName, setValue } from \"../session/values.ts\";\nimport type { AgentHarnessStreamOptions, AgentHarnessTool } from \"../types.ts\";\nimport { Lane } from \"./lane.ts\";\nimport { readLaneStorage, restoreLaneState, restoreSession } from \"./restore.ts\";\nimport { type Config, type LaneState, SliceNotImplemented } from \"./types.ts\";\n\n/** Runtime implementation of AgentHarness. The harness manages lanes but is not itself a lane. */\nexport class Harness<TContext extends object | undefined> implements AgentHarness<TContext> {\n\treadonly session: Session;\n\treadonly models: Models;\n\treadonly hooks: HookRegistry;\n\treadonly events: HarnessEventBus;\n\treadonly lanesByName = new Map<string, Lane<TContext>>();\n\tprivate readonly seed: LaneConfiguration;\n\tprivate readonly configStore: { value: Config<TContext> };\n\tprivate closePromise: Promise<void> | undefined;\n\tprivate closedError: Error | undefined;\n\tprivate faultError: HarnessFault | undefined;\n\n\tconstructor(options: AgentHarnessOptions<TContext>, seed: LaneConfiguration, restored: Map<string, LaneState>) {\n\t\tthis.session = options.session;\n\t\tthis.models = options.models;\n\t\tthis.seed = seed;\n\t\tthis.events = new HarnessEventBus();\n\t\tthis.hooks = new HookRegistry((error, hook, lane, context) =>\n\t\t\tthis.events.emit(\n\t\t\t\t{\n\t\t\t\t\ttype: \"handler_error\",\n\t\t\t\t\tkind: \"hook\",\n\t\t\t\t\thook,\n\t\t\t\t\terror: error.message,\n\t\t\t\t\t...(error.stack === undefined ? {} : { stack: error.stack }),\n\t\t\t\t\tlane,\n\t\t\t\t},\n\t\t\t\tcontext,\n\t\t\t),\n\t\t);\n\t\tthis.configStore = {\n\t\t\tvalue: {\n\t\t\t\ttools: options.tools ?? [],\n\t\t\t\tresources: options.resources ?? {},\n\t\t\t\tstreamOptions: options.streamOptions ?? {},\n\t\t\t\tretryPolicy: options.retry ?? DEFAULT_RETRY_POLICY,\n\t\t\t\tcompaction: options.compaction ?? DEFAULT_COMPACTION_SETTINGS,\n\t\t\t\tsteeringMode: options.steeringMode ?? \"all\",\n\t\t\t\tfollowUpMode: options.followUpMode ?? \"all\",\n\t\t\t\ttoolExecution: options.toolExecution ?? \"parallel\",\n\t\t\t\ttoolContext: options.toolContext,\n\t\t\t\tsystemPrompt: options.systemPrompt,\n\t\t\t\ttoProviderMessages: options.toProviderMessages ?? ((messages) => convertToLlm(messages)),\n\t\t\t\tentryProjectors: options.entryProjectors ?? {},\n\t\t\t},\n\t\t};\n\t\tfor (const [name, state] of restored) this.lanesByName.set(name, this.buildLane(name, state));\n\t}\n\n\tlane(name: string, context: Context): Promise<AgentLane>;\n\tlane(name: string, options: AcquireLaneOptions, context: Context): Promise<AgentLane>;\n\tasync lane(\n\t\tname: string,\n\t\toptionsOrContext: AcquireLaneOptions | Context,\n\t\tmaybeContext?: Context,\n\t): Promise<AgentLane> {\n\t\tthis.assertOpen();\n\t\tif (name.length === 0 || name.includes(\"\\u0000\")) {\n\t\t\tconst reason = name.length === 0 ? \"lane name must not be empty\" : \"lane name must not contain \\\\u0000\";\n\t\t\tthrow new InvalidLane({\n\t\t\t\tlane: name,\n\t\t\t\treason,\n\t\t\t\tmessage: `Invalid lane ${JSON.stringify(name)}: ${reason}`,\n\t\t\t});\n\t\t}\n\t\tconst options = maybeContext === undefined ? {} : (optionsOrContext as AcquireLaneOptions);\n\t\tconst context = maybeContext ?? (optionsOrContext as Context);\n\t\tlet lane: Lane<TContext> | undefined;\n\t\tlet delivery: Promise<void> | undefined;\n\t\ttry {\n\t\t\tawait this.session.mutate(async (mutator) => {\n\t\t\t\tthis.assertOpen();\n\t\t\t\tlane = this.lanesByName.get(name);\n\t\t\t\tif (lane !== undefined) return;\n\n\t\t\t\tconst stored = await readLaneStorage(mutator, name, context);\n\t\t\t\tif (stored.kind === \"lane\") {\n\t\t\t\t\tconst restored = await restoreLaneState(mutator, name, stored, context);\n\t\t\t\t\tlane = this.buildLane(name, restored);\n\t\t\t\t\tthis.lanesByName.set(name, lane);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst tipId = stored.kind === \"branch\" ? stored.tip.value : (options.createAt ?? null);\n\t\t\t\tif (\n\t\t\t\t\tstored.kind === \"absent\" &&\n\t\t\t\t\ttipId !== null &&\n\t\t\t\t\t!(await mutator.getEntries([tipId], context)).has(tipId)\n\t\t\t\t) {\n\t\t\t\t\tthrow new UnknownTarget({\n\t\t\t\t\t\ttargetId: tipId,\n\t\t\t\t\t\tmessage: `Unknown target: ${tipId}`,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tconst attachedConfiguration: LaneConfiguration = {\n\t\t\t\t\tmodel: { ...this.seed.model },\n\t\t\t\t\tthinkingLevel: this.seed.thinkingLevel,\n\t\t\t\t\tactiveToolNames: [...this.seed.activeToolNames],\n\t\t\t\t};\n\t\t\t\tconst state: LaneState = {\n\t\t\t\t\ttipId,\n\t\t\t\t\tconfiguration: attachedConfiguration,\n\t\t\t\t\tinbox: [],\n\t\t\t\t\tlastOperationId: null,\n\t\t\t\t\toperation: null,\n\t\t\t\t};\n\t\t\t\tconst writes = [\n\t\t\t\t\t...(stored.kind === \"absent\" ? [setValue(branchTip(name), tipId)] : []),\n\t\t\t\t\tsetValue(laneConfig(name), attachedConfiguration),\n\t\t\t\t\tsetValue(laneState(name), {\n\t\t\t\t\t\tcurrentOperationId: null,\n\t\t\t\t\t\tlastOperationId: null,\n\t\t\t\t\t\tinbox: [],\n\t\t\t\t\t}),\n\t\t\t\t];\n\t\t\t\tawait mutator.commit(writes, context);\n\t\t\t\tlane = this.buildLane(name, state);\n\t\t\t\tthis.lanesByName.set(name, lane);\n\t\t\t\tdelivery = this.events.emitBatch([{ type: \"lane_created\", lane: name, at: tipId }], context);\n\t\t\t}, context);\n\t\t} catch (error) {\n\t\t\tif (this.closedError !== undefined) throw this.closedError;\n\t\t\tif (error instanceof InvalidLane || error instanceof UnknownTarget) throw error;\n\t\t\tthrow this.fault(error, context);\n\t\t}\n\t\tawait delivery;\n\t\tif (lane === undefined)\n\t\t\tthrow this.fault(new SessionInvariantError(`Lane ${JSON.stringify(name)} was not published`), context);\n\t\treturn lane;\n\t}\n\n\tasync lanes(context: Context): Promise<LaneInfo[]> {\n\t\tthis.assertOpen();\n\t\tconst executions = await Promise.all(\n\t\t\t[...this.lanesByName.values()].map((lane) => lane.inspectExecution(context)),\n\t\t);\n\t\treturn executions.map((execution) => ({\n\t\t\tname: execution.lane,\n\t\t\ttipId: execution.tipId,\n\t\t\toperation: execution.current,\n\t\t}));\n\t}\n\n\tgetName(context: Context): Promise<string | undefined> {\n\t\tthis.assertOpen();\n\t\treturn this.session.getName(context);\n\t}\n\n\tasync setName(name: string | undefined, context: Context): Promise<void> {\n\t\tthis.assertOpen();\n\t\tlet delivery: Promise<void> | undefined;\n\t\ttry {\n\t\t\tawait this.session.mutate(async (mutator) => {\n\t\t\t\tthis.assertOpen();\n\t\t\t\tawait mutator.commit(\n\t\t\t\t\t[name === undefined ? deleteValue(sessionName) : setValue(sessionName, name)],\n\t\t\t\t\tcontext,\n\t\t\t\t);\n\t\t\t\tdelivery = this.events.emitBatch([{ type: \"value_update\", value: \"session_name\", name }], context);\n\t\t\t}, context);\n\t\t} catch (error) {\n\t\t\tif (this.closedError !== undefined) throw this.closedError;\n\t\t\tthrow this.fault(error, context);\n\t\t}\n\t\tawait delivery;\n\t}\n\n\tgetLabel(targetId: string, context: Context): Promise<string | undefined> {\n\t\tthis.assertOpen();\n\t\treturn this.session.getLabel(targetId, context);\n\t}\n\n\tasync setLabel(targetId: string, label: string | undefined, context: Context): Promise<void> {\n\t\tthis.assertOpen();\n\t\tlet delivery: Promise<void> | undefined;\n\t\ttry {\n\t\t\tawait this.session.mutate(async (mutator) => {\n\t\t\t\tthis.assertOpen();\n\t\t\t\tconst address = entryLabel(targetId);\n\t\t\t\tawait mutator.commit([label === undefined ? deleteValue(address) : setValue(address, label)], context);\n\t\t\t\tdelivery = this.events.emitBatch(\n\t\t\t\t\t[{ type: \"value_update\", value: \"entry_label\", targetId, label }],\n\t\t\t\t\tcontext,\n\t\t\t\t);\n\t\t\t}, context);\n\t\t} catch (error) {\n\t\t\tif (this.closedError !== undefined) throw this.closedError;\n\t\t\tthrow this.fault(error, context);\n\t\t}\n\t\tawait delivery;\n\t}\n\n\tgetTools(context: Context): Promise<AgentHarnessTool<TContext>[]> {\n\t\treturn this.getConfig(\"tools\", context);\n\t}\n\n\tsetTools(tools: AgentHarnessTool<TContext>[], context: Context): Promise<void> {\n\t\tvalidateToolNames(tools);\n\t\treturn this.setConfig(\"tools\", tools, () => ({ type: \"config_update\", property: \"tools\" }), context);\n\t}\n\n\tgetResources(context: Context): Promise<Resources> {\n\t\treturn this.getConfig(\"resources\", context);\n\t}\n\n\tsetResources(resources: Resources, context: Context): Promise<void> {\n\t\treturn this.setConfig(\"resources\", resources, () => ({ type: \"config_update\", property: \"resources\" }), context);\n\t}\n\n\tgetStreamOptions(context: Context): Promise<AgentHarnessStreamOptions> {\n\t\treturn this.getConfig(\"streamOptions\", context);\n\t}\n\n\tsetStreamOptions(options: AgentHarnessStreamOptions, context: Context): Promise<void> {\n\t\treturn this.setConfig(\n\t\t\t\"streamOptions\",\n\t\t\toptions,\n\t\t\t(previous, value) => ({ type: \"config_update\", property: \"streamOptions\", previous, value }),\n\t\t\tcontext,\n\t\t);\n\t}\n\n\tgetRetryPolicy(context: Context): Promise<RetryPolicy> {\n\t\treturn this.getConfig(\"retryPolicy\", context);\n\t}\n\n\tsetRetryPolicy(policy: RetryPolicy, context: Context): Promise<void> {\n\t\tvalidateRetryPolicy(policy);\n\t\treturn this.setConfig(\n\t\t\t\"retryPolicy\",\n\t\t\tpolicy,\n\t\t\t(previous, value) => ({ type: \"config_update\", property: \"retryPolicy\", previous, value }),\n\t\t\tcontext,\n\t\t);\n\t}\n\n\tgetCompactionSettings(context: Context): Promise<CompactionSettings> {\n\t\treturn this.getConfig(\"compaction\", context);\n\t}\n\n\tsetCompactionSettings(compaction: CompactionSettings, context: Context): Promise<void> {\n\t\tvalidateCompactionSettings(compaction);\n\t\treturn this.setConfig(\n\t\t\t\"compaction\",\n\t\t\tcompaction,\n\t\t\t(previous, value) => ({ type: \"config_update\", property: \"compactionSettings\", previous, value }),\n\t\t\tcontext,\n\t\t);\n\t}\n\n\tgetSteeringMode(context: Context): Promise<QueueMode> {\n\t\treturn this.getConfig(\"steeringMode\", context);\n\t}\n\n\tsetSteeringMode(steeringMode: QueueMode, context: Context): Promise<void> {\n\t\treturn this.setConfig(\n\t\t\t\"steeringMode\",\n\t\t\tsteeringMode,\n\t\t\t(previous, value) => ({ type: \"config_update\", property: \"steeringMode\", previous, value }),\n\t\t\tcontext,\n\t\t);\n\t}\n\n\tgetFollowUpMode(context: Context): Promise<QueueMode> {\n\t\treturn this.getConfig(\"followUpMode\", context);\n\t}\n\n\tsetFollowUpMode(followUpMode: QueueMode, context: Context): Promise<void> {\n\t\treturn this.setConfig(\n\t\t\t\"followUpMode\",\n\t\t\tfollowUpMode,\n\t\t\t(previous, value) => ({ type: \"config_update\", property: \"followUpMode\", previous, value }),\n\t\t\tcontext,\n\t\t);\n\t}\n\n\tasync watchSession(_context: Context): Promise<never> {\n\t\tthrow new SliceNotImplemented(\"watchSession\");\n\t}\n\n\tfault(cause: unknown, context: Context): Error {\n\t\tif (this.faultError !== undefined) return this.faultError;\n\t\tif (this.closedError !== undefined) return this.closedError;\n\t\tconst normalized = cause instanceof Error ? cause : new Error(String(cause));\n\t\tconst fault = new HarnessFault(\"AgentHarness storage or invariant fault\", normalized);\n\t\tthis.faultError = fault;\n\t\tfor (const lane of this.lanesByName.values()) lane.seal(fault);\n\t\tthis.hooks.close(fault);\n\t\tvoid this.events.emit({ type: \"fault\", code: \"harness_fault\", message: fault.message }, context);\n\t\tthis.events.close(fault);\n\t\treturn fault;\n\t}\n\n\tclose(context: Context): Promise<void> {\n\t\tif (this.closePromise !== undefined) return this.closePromise;\n\t\tconst error = new HarnessClosed();\n\t\tthis.closedError = error;\n\t\tconst idleCallbacks = [...this.lanesByName.values()].map((lane) => lane.seal(error));\n\t\tthis.hooks.close(error);\n\t\tthis.events.close(error);\n\t\tconst sessionClose = this.session.close(context);\n\t\tthis.closePromise = Promise.all([sessionClose, ...idleCallbacks]).then(() => undefined);\n\t\treturn this.closePromise;\n\t}\n\n\tprivate buildLane(name: string, state: LaneState): Lane<TContext> {\n\t\treturn new Lane<TContext>(\n\t\t\tname,\n\t\t\tthis.session,\n\t\t\tthis.models,\n\t\t\tthis.hooks,\n\t\t\tstate,\n\t\t\t(cause, context) => this.fault(cause, context),\n\t\t\t(events, context) => this.events.emitBatch(events, context),\n\t\t\t(snapshot, filter, context, resnapshot) => this.events.watch(snapshot, filter, context, resnapshot),\n\t\t\t() => this.configStore.value,\n\t\t);\n\t}\n\n\tprivate async getConfig<TKey extends keyof Config<TContext>>(\n\t\tkey: TKey,\n\t\t_context: Context,\n\t): Promise<Config<TContext>[TKey]> {\n\t\tthis.assertOpen();\n\t\treturn this.configStore.value[key];\n\t}\n\n\tprivate async setConfig<TKey extends keyof Config<TContext>>(\n\t\tkey: TKey,\n\t\tvalue: Config<TContext>[TKey],\n\t\tevent: (previous: Config<TContext>[TKey], value: Config<TContext>[TKey]) => GlobalConfigEventPayload,\n\t\tcontext: Context,\n\t): Promise<void> {\n\t\tthis.assertOpen();\n\t\tconst previous = this.configStore.value[key];\n\t\tthis.configStore.value = { ...this.configStore.value, [key]: value };\n\t\tawait this.events.emit(event(previous, value), context);\n\t}\n\n\tprivate assertOpen(): void {\n\t\tif (this.faultError !== undefined) throw this.faultError;\n\t\tif (this.closedError !== undefined) throw this.closedError;\n\t}\n}\n\n/** Attach runtime without starting provider, tool, hook, or timer effects. */\nexport async function createAgentHarness<TContext extends object | undefined = object | undefined>(\n\toptions: AgentHarnessOptions<TContext>,\n\tcontext: Context,\n): Promise<{ harness: AgentHarness<TContext>; open: OpenOperation[] }> {\n\tconst tools = options.tools ?? [];\n\tvalidateToolNames(tools);\n\tvalidateRetryPolicy(options.retry ?? DEFAULT_RETRY_POLICY);\n\tvalidateCompactionSettings(options.compaction ?? DEFAULT_COMPACTION_SETTINGS);\n\tconst seed: LaneConfiguration = {\n\t\tmodel: { provider: options.model.provider, modelId: options.model.id },\n\t\tthinkingLevel: options.thinkingLevel ?? \"off\",\n\t\tactiveToolNames: [...(options.activeToolNames ?? tools.map((tool) => tool.name))],\n\t};\n\ttry {\n\t\tconst restored = await restoreSession(options.session, context);\n\t\tconst open = [...restored].flatMap(([lane, state]): OpenOperation[] => {\n\t\t\tconst operation = state.operation;\n\t\t\treturn operation === null\n\t\t\t\t? []\n\t\t\t\t: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tlane,\n\t\t\t\t\t\t\toperationId: operation.meta.operationId,\n\t\t\t\t\t\t\tkind: operation.meta.intent.kind,\n\t\t\t\t\t\t\tstartedAt: operation.meta.startedAt,\n\t\t\t\t\t\t\t...(operation.state.control.status === \"cancel_requested\" ? { aborting: true as const } : {}),\n\t\t\t\t\t\t},\n\t\t\t\t\t];\n\t\t});\n\t\treturn { harness: new Harness(options, seed, restored), open };\n\t} catch (error) {\n\t\tthrow new HarnessFault(\"AgentHarness storage or invariant fault\", error);\n\t}\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { createAgentHarness } from "./harness.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { createAgentHarness } from \"./harness.ts\";\n"]}

package/dist/harness/runtime/index.js

@@ -0,0 +1,2 @@
+export { createAgentHarness } from "./harness.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { createAgentHarness } from \"./harness.ts\";\n"]}

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

@@ -0,0 +1,101 @@
+import { type Api, type ImageContent, type Model, type Models, type Usage } from "@earendil-works/pi-ai";
+import type { AgentMessage, ThinkingLevel } from "../../types.ts";
+import type { AbortRequestResult, AbortResult, AgentLane, CancelQueuedResult, CompactionResult, DriveOptions, DriveResult, HarnessEvent, LaneExecutionInfo, LaneSnapshot, ModelIdentity, NavigationResult, OperationAdmissionResult, OperationRequest, QueueResult, RecordUsageResult, ResumeResult, RunResult, WatchHandle } from "../agent-harness.ts";
+import { type Context } from "../context.ts";
+import type { HookRegistry } from "../hooks.ts";
+import { OperationMismatch } from "../result.ts";
+import type { BranchScan, Entry, JsonValue, OperationMeta, OperationResultRecord, OperationState, Session, SessionReader } from "../session/types.ts";
+import { type Config, type ContinueOperationResult, Drive, type LaneCommand, type LaneState, type OperationCommand } from "./types.ts";
+type EmitBatch = (events: readonly HarnessEvent[], context: Context) => Promise<void>;
+type WatchHandler = <T>(snapshot: T, filter: (event: HarnessEvent) => boolean, context: Context, resnapshot: (context: Context, markBoundary: () => void) => Promise<T>) => WatchHandle<T>;
+type FaultHandler = (cause: unknown, context: Context) => Error;
+/** Runtime implementation of one configured lane. */
+export declare class Lane<TContext extends object | undefined> implements AgentLane {
+    readonly name: string;
+    readonly session: Session;
+    readonly models: Models;
+    readonly hooks: HookRegistry;
+    readonly emitBatch: EmitBatch;
+    private readonly onFault;
+    private readonly installWatch;
+    private readonly config;
+    private stateChange;
+    private resolveStateChange;
+    private idleOwner;
+    /** Package-internal drive owner. Public only because deterministic procedure tests install exact owners directly. */
+    activeDrive: Drive | undefined;
+    /** Authoritative live control projection while this harness owns the Session. */
+    state: LaneState;
+    closedError: Error | undefined;
+    constructor(name: string, session: Session, models: Models, hooks: HookRegistry, state: LaneState, onFault: FaultHandler, emitBatch: EmitBatch, installWatch: WatchHandler, readConfig: () => Config<TContext>);
+    getTipId(_context: Context): Promise<string | null>;
+    getResult(operationId: string, context: Context): Promise<OperationResultRecord | undefined>;
+    readConfig(): Config<TContext>;
+    mismatch(expected: string, currentOperationId: string | null, lastOperationId: string | null): OperationMismatch;
+    private readLane;
+    command<TResult>(plan: (state: LaneState, reader: SessionReader) => LaneCommand<TResult> | Promise<LaneCommand<TResult>>, context: Context): Promise<TResult>;
+    /**
+     * Run a command against the current operation even after cancellation is requested. Use this to settle admitted
+     * effects, finish the operation, or update concurrent child state. The capability narrows the planner's state type;
+     * the Drive continuation remains the sole top-level state writer.
+     */
+    settleOperation<TState extends OperationState, TResult>(_capability: TState, plan: (state: LaneState, current: TState, meta: OperationMeta, reader: SessionReader) => OperationCommand<TResult> | Promise<OperationCommand<TResult>>, context: Context): Promise<TResult>;
+    /**
+     * Run an ordinary operation command only while durable control is running. Use this before starting new hooks,
+     * effects, or forward progress. Returns `cancel_requested` without invoking the planner once cancellation is requested.
+     */
+    continueOperation<TState extends OperationState, TResult>(capability: TState, plan: (state: LaneState, current: TState, meta: OperationMeta, reader: SessionReader) => OperationCommand<TResult> | Promise<OperationCommand<TResult>>, context: Context): Promise<ContinueOperationResult<TResult>>;
+    accept(request: OperationRequest, context: Context): Promise<OperationAdmissionResult>;
+    private acceptRun;
+    private acceptCompaction;
+    private acceptNavigation;
+    drive(options: DriveOptions, context: Context): Promise<DriveResult>;
+    /** Package-private durable cancellation primitive. Public exposure remains guarded until M8. */
+    requestOperationAbort(operationId: string, context: Context): Promise<AbortRequestResult>;
+    requestAbort(operationId: string, context: Context): Promise<AbortRequestResult>;
+    inspectExecution(context: Context): Promise<LaneExecutionInfo>;
+    prompt(...args: [text: string, images: ImageContent[] | undefined, context: Context] | [message: AgentMessage | AgentMessage[], context: Context]): Promise<RunResult>;
+    skill(name: string, additionalInstructions: string | undefined, context: Context): Promise<RunResult>;
+    promptFromTemplate(name: string, args: string[] | undefined, context: Context): Promise<RunResult>;
+    private driveRunRequest;
+    compact(options: {
+        customInstructions?: string;
+    } | undefined, context: Context): Promise<CompactionResult>;
+    navigateTree(targetId: string | null, options: Extract<OperationRequest, {
+        kind: "navigation";
+    }>["options"], context: Context): Promise<NavigationResult>;
+    private driveStructuralAdmission;
+    private continueAfterStructural;
+    resume(context: Context): Promise<ResumeResult>;
+    abort(context: Context): Promise<AbortResult>;
+    steer(message: string | AgentMessage, images: ImageContent[] | undefined, context: Context): Promise<QueueResult>;
+    followUp(message: string | AgentMessage, images: ImageContent[] | undefined, context: Context): Promise<QueueResult>;
+    nextRun(message: string | AgentMessage, images: ImageContent[] | undefined, context: Context): Promise<QueueResult>;
+    private enqueue;
+    cancelQueued(entryId: string, context: Context): Promise<CancelQueuedResult>;
+    recordUsage(usage: Usage, options: {
+        entryId?: string;
+        details?: JsonValue;
+    } | undefined, context: Context): Promise<RecordUsageResult>;
+    waitForIdle(context: Context): Promise<void>;
+    runWhenIdle(callback: (context: Context) => void | Promise<void>, context: Context): Promise<void>;
+    getModel(_context: Context): Promise<Model<Api> | undefined>;
+    setModel(model: ModelIdentity, context: Context): Promise<void>;
+    getThinkingLevel(_context: Context): Promise<ThinkingLevel>;
+    setThinkingLevel(thinkingLevel: ThinkingLevel, context: Context): Promise<void>;
+    getActiveTools(_context: Context): Promise<string[]>;
+    setActiveTools(activeToolNames: string[], context: Context): Promise<void>;
+    watch(context: Context): Promise<WatchHandle<LaneSnapshot>>;
+    private captureLaneSnapshot;
+    private setConfiguration;
+    findEntries(query: BranchScan | undefined, context: Context): Promise<Entry[]>;
+    findEntry(query: BranchScan | undefined, context: Context): Promise<Entry | undefined>;
+    appendMessage(message: AgentMessage, context: Context): Promise<string>;
+    appendCustomEntry(customType: string, data: JsonValue | undefined, context: Context): Promise<string>;
+    private append;
+    seal(error: Error): Promise<void>;
+    private signalStateChange;
+    assertOpen(): void;
+}
+export {};
+//# sourceMappingURL=lane.d.ts.map