@nervekit/agent 0.1.0

package/dist/harness/harness-continuation.js

@@ -0,0 +1,56 @@
+import { runAgentLoopContinue } from "../agent-loop.js";
+import { isAgentToolSuspension } from "../suspension.js";
+import { AgentHarnessError } from "./errors.js";
+import { normalizeHarnessError } from "./harness-events.js";
+import { toError } from "./result.js";
+export async function continueHarnessRun(state) {
+    if (state.phase !== "idle") {
+        throw new AgentHarnessError("busy", "AgentHarness is busy");
+    }
+    state.phase = "turn";
+    const finishRunPromise = state.startRunPromise();
+    let activeTurnState = await state.createTurnState();
+    const abortController = new AbortController();
+    const getTurnState = () => activeTurnState;
+    const setTurnState = (nextTurnState) => {
+        activeTurnState = nextTurnState;
+    };
+    state.runAbortController = abortController;
+    try {
+        const newMessages = await runAgentLoopContinue(state.createContext(activeTurnState), state.createLoopConfig(getTurnState, setTurnState), (event) => state.handleAgentEvent(event, abortController.signal), abortController.signal, state.createStreamFn(getTurnState));
+        for (const message of [...newMessages].reverse()) {
+            if (message.role === "assistant")
+                return message;
+        }
+        throw new AgentHarnessError("invalid_state", "AgentHarness continue completed without an assistant message");
+    }
+    catch (error) {
+        if (isAgentToolSuspension(error)) {
+            state.phase = "idle";
+            throw error;
+        }
+        try {
+            const failureMessages = await state.emitRunFailure(activeTurnState.model, error, abortController.signal.aborted, abortController.signal);
+            const assistant = [...failureMessages]
+                .reverse()
+                .find((message) => message.role === "assistant");
+            if (assistant)
+                return assistant;
+        }
+        catch (failureError) {
+            const cause = new AggregateError([toError(error), toError(failureError)], "Agent continuation failed and failure reporting failed");
+            throw new AgentHarnessError("unknown", cause.message, cause);
+        }
+        throw normalizeHarnessError(error, "unknown");
+    }
+    finally {
+        try {
+            await state.flushPendingConversationWrites();
+        }
+        finally {
+            state.runAbortController = undefined;
+            finishRunPromise();
+        }
+    }
+}
+//# sourceMappingURL=harness-continuation.js.map

package/dist/harness/harness-continuation.js.map

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

package/dist/harness/harness-events.d.ts

@@ -0,0 +1,23 @@
+import type { AnyModel } from "../types.js";
+import { AgentHarnessError } from "./errors.js";
+import type { AgentHarnessEvent, AgentHarnessEventResultMap, AgentHarnessOwnEvent } from "./events.js";
+import type { AgentHarnessStreamOptions, PromptTemplate, Skill } from "./options.js";
+export type AgentHarnessHandler = (event: unknown, signal?: AbortSignal) => Promise<unknown> | unknown;
+export declare function normalizeHarnessError(error: unknown, fallbackCode: AgentHarnessError["code"]): AgentHarnessError;
+export declare function normalizeHookError(error: unknown): AgentHarnessError;
+export declare class AgentHarnessEventHub<TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate> {
+    private handlers;
+    private getHandlers;
+    emitOwn(event: AgentHarnessOwnEvent<TSkill, TPromptTemplate>, signal?: AbortSignal): Promise<void>;
+    emitAny(event: AgentHarnessEvent<TSkill, TPromptTemplate>, signal?: AbortSignal): Promise<void>;
+    emitHook<TType extends keyof AgentHarnessEventResultMap>(event: Extract<AgentHarnessOwnEvent, {
+        type: TType;
+    }>): Promise<AgentHarnessEventResultMap[TType] | undefined>;
+    emitBeforeProviderRequest(model: AnyModel, conversationId: string, streamOptions: AgentHarnessStreamOptions): Promise<AgentHarnessStreamOptions>;
+    emitBeforeProviderPayload(model: AnyModel, payload: unknown): Promise<unknown>;
+    subscribe(listener: (event: AgentHarnessEvent<TSkill, TPromptTemplate>, signal?: AbortSignal) => Promise<void> | void): () => void;
+    on<TType extends keyof AgentHarnessEventResultMap>(type: TType, handler: (event: Extract<AgentHarnessOwnEvent, {
+        type: TType;
+    }>) => Promise<AgentHarnessEventResultMap[TType]> | AgentHarnessEventResultMap[TType]): () => void;
+}
+//# sourceMappingURL=harness-events.d.ts.map

package/dist/harness/harness-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-events.d.ts","sourceRoot":"","sources":["../../src/harness/harness-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,iBAAiB,EAIlB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,yBAAyB,EACzB,cAAc,EACd,KAAK,EACN,MAAM,cAAc,CAAC;AAStB,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,GACtC,iBAAiB,CAUnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAEpE;AAED,qBAAa,oBAAoB,CAC/B,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5B,eAAe,SAAS,cAAc,GAAG,cAAc;IAEvD,OAAO,CAAC,QAAQ,CAA+C;IAE/D,OAAO,CAAC,WAAW;IAIb,OAAO,CACX,KAAK,EAAE,oBAAoB,CAAC,MAAM,EAAE,eAAe,CAAC,EACpD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAUV,OAAO,CACX,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAUV,QAAQ,CAAC,KAAK,SAAS,MAAM,0BAA0B,EAC3D,KAAK,EAAE,OAAO,CAAC,oBAAoB,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC,GACpD,OAAO,CAAC,0BAA0B,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IAmBnD,yBAAyB,CAC7B,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,yBAAyB,GACvC,OAAO,CAAC,yBAAyB,CAAC;IAsB/B,yBAAyB,CAC7B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,OAAO,CAAC;IAqBnB,SAAS,CACP,QAAQ,EAAE,CACR,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACxB,MAAM,IAAI;IAWb,EAAE,CAAC,KAAK,SAAS,MAAM,0BAA0B,EAC/C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,CACP,KAAK,EAAE,OAAO,CAAC,oBAAoB,EAAE;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAC,KAEnD,OAAO,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,GAC1C,0BAA0B,CAAC,KAAK,CAAC,GACpC,MAAM,IAAI;CAUd"}

package/dist/harness/harness-events.js

@@ -0,0 +1,129 @@
+import { AgentHarnessError, BranchSummaryError, CompactionError, ConversationError, } from "./errors.js";
+import { toError } from "./result.js";
+import { applyStreamOptionsPatch, cloneStreamOptions, } from "./stream-options.js";
+const SUBSCRIBER_EVENT_TYPE = "*";
+export function normalizeHarnessError(error, fallbackCode) {
+    if (error instanceof AgentHarnessError)
+        return error;
+    const cause = toError(error);
+    if (cause instanceof ConversationError)
+        return new AgentHarnessError("conversation", cause.message, cause);
+    if (cause instanceof CompactionError)
+        return new AgentHarnessError("compaction", cause.message, cause);
+    if (cause instanceof BranchSummaryError)
+        return new AgentHarnessError("branch_summary", cause.message, cause);
+    return new AgentHarnessError(fallbackCode, cause.message, cause);
+}
+export function normalizeHookError(error) {
+    return normalizeHarnessError(error, "hook");
+}
+export class AgentHarnessEventHub {
+    handlers = new Map();
+    getHandlers(type) {
+        return this.handlers.get(type);
+    }
+    async emitOwn(event, signal) {
+        for (const listener of this.getHandlers(SUBSCRIBER_EVENT_TYPE) ?? []) {
+            try {
+                await listener(event, signal);
+            }
+            catch (error) {
+                throw normalizeHookError(error);
+            }
+        }
+    }
+    async emitAny(event, signal) {
+        for (const listener of this.getHandlers(SUBSCRIBER_EVENT_TYPE) ?? []) {
+            try {
+                await listener(event, signal);
+            }
+            catch (error) {
+                throw normalizeHookError(error);
+            }
+        }
+    }
+    async emitHook(event) {
+        const handlers = this.getHandlers(event.type);
+        if (!handlers || handlers.size === 0)
+            return undefined;
+        let lastResult;
+        for (const handler of handlers) {
+            try {
+                const result = (await handler(event));
+                if (result !== undefined) {
+                    lastResult = result;
+                }
+            }
+            catch (error) {
+                throw normalizeHookError(error);
+            }
+        }
+        return lastResult;
+    }
+    async emitBeforeProviderRequest(model, conversationId, streamOptions) {
+        const handlers = this.getHandlers("before_provider_request");
+        let current = cloneStreamOptions(streamOptions);
+        if (!handlers || handlers.size === 0)
+            return current;
+        for (const handler of handlers) {
+            try {
+                const result = (await handler({
+                    type: "before_provider_request",
+                    model,
+                    conversationId,
+                    streamOptions: cloneStreamOptions(current),
+                }));
+                if (result?.streamOptions) {
+                    current = applyStreamOptionsPatch(current, result.streamOptions);
+                }
+            }
+            catch (error) {
+                throw normalizeHookError(error);
+            }
+        }
+        return current;
+    }
+    async emitBeforeProviderPayload(model, payload) {
+        const handlers = this.getHandlers("before_provider_payload");
+        let current = payload;
+        if (!handlers || handlers.size === 0)
+            return current;
+        for (const handler of handlers) {
+            try {
+                const result = (await handler({
+                    type: "before_provider_payload",
+                    model,
+                    payload: current,
+                }));
+                if (result !== undefined) {
+                    current = result.payload;
+                }
+            }
+            catch (error) {
+                throw normalizeHookError(error);
+            }
+        }
+        return current;
+    }
+    subscribe(listener) {
+        let handlers = this.handlers.get(SUBSCRIBER_EVENT_TYPE);
+        if (!handlers) {
+            handlers = new Set();
+            this.handlers.set(SUBSCRIBER_EVENT_TYPE, handlers);
+        }
+        const activeHandlers = handlers;
+        activeHandlers.add(listener);
+        return () => activeHandlers.delete(listener);
+    }
+    on(type, handler) {
+        let handlers = this.handlers.get(type);
+        if (!handlers) {
+            handlers = new Set();
+            this.handlers.set(type, handlers);
+        }
+        const activeHandlers = handlers;
+        activeHandlers.add(handler);
+        return () => activeHandlers.delete(handler);
+    }
+}
+//# sourceMappingURL=harness-events.js.map

package/dist/harness/harness-events.js.map

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

package/dist/harness/harness-invocations.d.ts

@@ -0,0 +1,20 @@
+import type { AssistantMessage, ImageContent } from "@earendil-works/pi-ai";
+import type { AgentTool } from "../types.js";
+import type { PromptTemplate, Skill } from "./options.js";
+import type { AgentHarnessTurnState } from "./turn-state.js";
+export type HarnessInvocationState<TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentTool> = {
+    runForegroundTurn(resolvePrompt: (turnState: AgentHarnessTurnState<TSkill, TPromptTemplate, TTool>) => {
+        text: string;
+        options?: {
+            images?: ImageContent[];
+        };
+    } | Promise<{
+        text: string;
+        options?: {
+            images?: ImageContent[];
+        };
+    }>): Promise<AssistantMessage>;
+};
+export declare function invokeSkill<TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentTool>(state: HarnessInvocationState<TSkill, TPromptTemplate, TTool>, name: string, additionalInstructions?: string): Promise<AssistantMessage>;
+export declare function invokePromptTemplate<TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentTool>(state: HarnessInvocationState<TSkill, TPromptTemplate, TTool>, name: string, args: string[]): Promise<AssistantMessage>;
+//# sourceMappingURL=harness-invocations.d.ts.map

package/dist/harness/harness-invocations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-invocations.d.ts","sourceRoot":"","sources":["../../src/harness/harness-invocations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,MAAM,sBAAsB,CAChC,MAAM,SAAS,KAAK,EACpB,eAAe,SAAS,cAAc,EACtC,KAAK,SAAS,SAAS,IACrB;IACF,iBAAiB,CACf,aAAa,EAAE,CACb,SAAS,EAAE,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,KAE9D;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;SAAE,CAAA;KAAE,GACvD,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;SAAE,CAAA;KAAE,CAAC,GACnE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9B,CAAC;AAEF,wBAAgB,WAAW,CACzB,MAAM,SAAS,KAAK,EACpB,eAAe,SAAS,cAAc,EACtC,KAAK,SAAS,SAAS,EAEvB,KAAK,EAAE,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,EAC7D,IAAI,EAAE,MAAM,EACZ,sBAAsB,CAAC,EAAE,MAAM,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAU3B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,KAAK,EACpB,eAAe,SAAS,cAAc,EACtC,KAAK,SAAS,SAAS,EAEvB,KAAK,EAAE,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,EAC7D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,gBAAgB,CAAC,CAa3B"}

package/dist/harness/harness-invocations.js

@@ -0,0 +1,22 @@
+import { AgentHarnessError } from "./errors.js";
+import { formatPromptTemplateInvocation } from "./prompt-templates.js";
+import { formatSkillInvocation } from "./skills.js";
+export function invokeSkill(state, name, additionalInstructions) {
+    return state.runForegroundTurn((turnState) => {
+        const skill = (turnState.resources.skills ?? []).find((candidate) => candidate.name === name);
+        if (!skill) {
+            throw new AgentHarnessError("invalid_argument", `Unknown skill: ${name}`);
+        }
+        return { text: formatSkillInvocation(skill, additionalInstructions) };
+    });
+}
+export function invokePromptTemplate(state, name, args) {
+    return state.runForegroundTurn((turnState) => {
+        const template = (turnState.resources.promptTemplates ?? []).find((candidate) => candidate.name === name);
+        if (!template) {
+            throw new AgentHarnessError("invalid_argument", `Unknown prompt template: ${name}`);
+        }
+        return { text: formatPromptTemplateInvocation(template, args) };
+    });
+}
+//# sourceMappingURL=harness-invocations.js.map

package/dist/harness/harness-invocations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-invocations.js","sourceRoot":"","sources":["../../src/harness/harness-invocations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAiBpD,MAAM,UAAU,WAAW,CAKzB,KAA6D,EAC7D,IAAY,EACZ,sBAA+B;IAE/B,OAAO,KAAK,CAAC,iBAAiB,CAAC,CAAC,SAAS,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CACvC,CAAC;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,iBAAiB,CAAC,kBAAkB,EAAE,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAKlC,KAA6D,EAC7D,IAAY,EACZ,IAAc;IAEd,OAAO,KAAK,CAAC,iBAAiB,CAAC,CAAC,SAAS,EAAE,EAAE;QAC3C,MAAM,QAAQ,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,CAC/D,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CACvC,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,iBAAiB,CACzB,kBAAkB,EAClB,4BAA4B,IAAI,EAAE,CACnC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,8BAA8B,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/harness/harness-maintenance.d.ts

@@ -0,0 +1,30 @@
+import type { AgentTool, AnyModel, ThinkingLevel } from "../types.js";
+import type { Conversation } from "./conversation/conversation.js";
+import type { AgentHarnessOwnEvent, AgentHarnessPhase, NavigateTreeResult } from "./events.js";
+import type { AgentHarnessOptions, PromptTemplate, Skill } from "./options.js";
+type EmitHook = (event: AgentHarnessOwnEvent) => Promise<unknown>;
+type EmitOwn = (event: AgentHarnessOwnEvent) => Promise<void>;
+export type HarnessMaintenanceContext<TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentTool> = {
+    getPhase(): AgentHarnessPhase;
+    setPhase(phase: AgentHarnessPhase): void;
+    conversation: Conversation;
+    getModel(): AnyModel;
+    getThinkingLevel(): ThinkingLevel;
+    getApiKeyAndHeaders?: AgentHarnessOptions<TSkill, TPromptTemplate, TTool>["getApiKeyAndHeaders"];
+    emitHook: EmitHook;
+    emitOwn: EmitOwn;
+};
+export declare function compactHarnessConversation<TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentTool>(context: HarnessMaintenanceContext<TSkill, TPromptTemplate, TTool>, customInstructions?: string): Promise<{
+    summary: string;
+    firstKeptEntryId: string;
+    tokensBefore: number;
+    details?: unknown;
+}>;
+export declare function navigateHarnessTree<TSkill extends Skill, TPromptTemplate extends PromptTemplate, TTool extends AgentTool>(context: HarnessMaintenanceContext<TSkill, TPromptTemplate, TTool>, targetId: string, options?: {
+    summarize?: boolean;
+    customInstructions?: string;
+    replaceInstructions?: boolean;
+    label?: string;
+}): Promise<NavigateTreeResult>;
+export {};
+//# sourceMappingURL=harness-maintenance.d.ts.map

package/dist/harness/harness-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-maintenance.d.ts","sourceRoot":"","sources":["../../src/harness/harness-maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE/E,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAClE,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9D,MAAM,MAAM,yBAAyB,CACnC,MAAM,SAAS,KAAK,EACpB,eAAe,SAAS,cAAc,EACtC,KAAK,SAAS,SAAS,IACrB;IACF,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACzC,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,IAAI,QAAQ,CAAC;IACrB,gBAAgB,IAAI,aAAa,CAAC;IAClC,mBAAmB,CAAC,EAAE,mBAAmB,CACvC,MAAM,EACN,eAAe,EACf,KAAK,CACN,CAAC,qBAAqB,CAAC,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAmBF,wBAAsB,0BAA0B,CAC9C,MAAM,SAAS,KAAK,EACpB,eAAe,SAAS,cAAc,EACtC,KAAK,SAAS,SAAS,EAEvB,OAAO,EAAE,yBAAyB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,EAClE,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAwED;AAED,wBAAsB,mBAAmB,CACvC,MAAM,SAAS,KAAK,EACpB,eAAe,SAAS,cAAc,EACtC,KAAK,SAAS,SAAS,EAEvB,OAAO,EAAE,yBAAyB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,EAClE,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,kBAAkB,CAAC,CA8G7B"}

package/dist/harness/harness-maintenance.js

@@ -0,0 +1,155 @@
+import { collectEntriesForBranchSummary, generateBranchSummary, } from "./compaction/branch-summarization.js";
+import { compact, DEFAULT_COMPACTION_SETTINGS, prepareCompaction, } from "./compaction/compaction.js";
+import { editorTextForNavigatedEntry } from "./conversation/text-extraction.js";
+import { AgentHarnessError } from "./errors.js";
+import { normalizeHarnessError } from "./harness-events.js";
+export async function compactHarnessConversation(context, customInstructions) {
+    if (context.getPhase() !== "idle") {
+        throw new AgentHarnessError("busy", "compact() requires idle harness");
+    }
+    context.setPhase("compaction");
+    try {
+        const model = context.getModel();
+        if (!model) {
+            throw new AgentHarnessError("invalid_state", "No model set for compaction");
+        }
+        const auth = await context.getApiKeyAndHeaders?.(model);
+        if (!auth) {
+            throw new AgentHarnessError("auth", "No auth available for compaction");
+        }
+        const branchEntries = await context.conversation.getBranch();
+        const preparationResult = prepareCompaction(branchEntries, DEFAULT_COMPACTION_SETTINGS);
+        if (!preparationResult.ok)
+            throw preparationResult.error;
+        const preparation = preparationResult.value;
+        if (!preparation) {
+            throw new AgentHarnessError("compaction", "Nothing to compact");
+        }
+        const hookResult = (await context.emitHook({
+            type: "conversation_before_compact",
+            preparation,
+            branchEntries,
+            customInstructions,
+            signal: new AbortController().signal,
+        }));
+        if (hookResult?.cancel) {
+            throw new AgentHarnessError("compaction", "Compaction cancelled");
+        }
+        const provided = hookResult?.compaction;
+        const compactResult = provided
+            ? { ok: true, value: provided }
+            : await compact(preparation, model, auth.apiKey, auth.headers, customInstructions, undefined, context.getThinkingLevel());
+        if (!compactResult.ok)
+            throw compactResult.error;
+        const result = compactResult.value;
+        const entryId = await context.conversation.appendCompaction(result.summary, result.firstKeptEntryId, result.tokensBefore, result.details, provided !== undefined);
+        const entry = await context.conversation.getEntry(entryId);
+        if (entry?.type === "compaction") {
+            await context.emitOwn({
+                type: "conversation_compact",
+                compactionEntry: entry,
+                fromHook: provided !== undefined,
+            });
+        }
+        return result;
+    }
+    catch (error) {
+        throw normalizeHarnessError(error, "compaction");
+    }
+    finally {
+        context.setPhase("idle");
+    }
+}
+export async function navigateHarnessTree(context, targetId, options) {
+    if (context.getPhase() !== "idle") {
+        throw new AgentHarnessError("busy", "navigateTree() requires idle harness");
+    }
+    context.setPhase("branch_summary");
+    try {
+        const oldLeafId = await context.conversation.getLeafId();
+        if (oldLeafId === targetId)
+            return { cancelled: false };
+        const targetEntry = await context.conversation.getEntry(targetId);
+        if (!targetEntry) {
+            throw new AgentHarnessError("invalid_argument", `Entry ${targetId} not found`);
+        }
+        const { entries, commonAncestorId } = await collectEntriesForBranchSummary(context.conversation, oldLeafId, targetId);
+        const preparation = {
+            targetId,
+            oldLeafId,
+            commonAncestorId,
+            entriesToSummarize: entries,
+            userWantsSummary: options?.summarize ?? false,
+            customInstructions: options?.customInstructions,
+            replaceInstructions: options?.replaceInstructions,
+            label: options?.label,
+        };
+        const signal = new AbortController().signal;
+        const hookResult = (await context.emitHook({
+            type: "conversation_before_tree",
+            preparation,
+            signal,
+        }));
+        if (hookResult?.cancel)
+            return { cancelled: true };
+        let summaryEntry;
+        let summaryText = hookResult?.summary?.summary;
+        let summaryDetails = hookResult?.summary?.details;
+        if (!summaryText && options?.summarize && entries.length > 0) {
+            const model = context.getModel();
+            if (!model) {
+                throw new AgentHarnessError("invalid_state", "No model set for branch summary");
+            }
+            const auth = await context.getApiKeyAndHeaders?.(model);
+            if (!auth) {
+                throw new AgentHarnessError("auth", "No auth available for branch summary");
+            }
+            const branchSummary = await generateBranchSummary(entries, {
+                model,
+                apiKey: auth.apiKey,
+                headers: auth.headers,
+                signal: new AbortController().signal,
+                customInstructions: hookResult?.customInstructions ?? options?.customInstructions,
+                replaceInstructions: hookResult?.replaceInstructions ?? options?.replaceInstructions,
+            });
+            if (!branchSummary.ok) {
+                if (branchSummary.error.code === "aborted")
+                    return { cancelled: true };
+                throw new AgentHarnessError("branch_summary", branchSummary.error.message, branchSummary.error);
+            }
+            summaryText = branchSummary.value.summary;
+            summaryDetails = {
+                readFiles: branchSummary.value.readFiles,
+                modifiedFiles: branchSummary.value.modifiedFiles,
+            };
+        }
+        const { newLeafId, editorText } = editorTextForNavigatedEntry(targetEntry, targetId);
+        const summaryId = await context.conversation.moveTo(newLeafId, summaryText
+            ? {
+                summary: summaryText,
+                details: summaryDetails,
+                fromHook: hookResult?.summary !== undefined,
+            }
+            : undefined);
+        if (summaryId) {
+            const entry = await context.conversation.getEntry(summaryId);
+            if (entry?.type === "branch_summary")
+                summaryEntry = entry;
+        }
+        await context.emitOwn({
+            type: "conversation_tree",
+            newLeafId: await context.conversation.getLeafId(),
+            oldLeafId,
+            summaryEntry,
+            fromHook: hookResult?.summary !== undefined,
+        });
+        return { cancelled: false, editorText, summaryEntry };
+    }
+    catch (error) {
+        throw normalizeHarnessError(error, "branch_summary");
+    }
+    finally {
+        context.setPhase("idle");
+    }
+}
+//# sourceMappingURL=harness-maintenance.js.map

package/dist/harness/harness-maintenance.js.map

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

package/dist/harness/harness-queue-methods.d.ts

@@ -0,0 +1,45 @@
+import type { ImageContent } from "@earendil-works/pi-ai";
+import type { AgentMessage } from "../types.js";
+import type { Conversation } from "./conversation/conversation.js";
+import type { AgentHarnessPhase, PendingConversationWrite } from "./events.js";
+export type InboundQueuedMessage = {
+    id?: string;
+    source: "user" | "harness";
+    message: AgentMessage;
+    enqueuedAt: string;
+    timestamp?: string;
+    priority?: "normal" | "high";
+    delivery?: {
+        taskId?: string;
+        event?: string;
+        pendingNotificationId?: string;
+    };
+};
+export type HarnessQueueState = {
+    phase: AgentHarnessPhase;
+    steerQueue: InboundQueuedMessage[];
+    nextTurnQueue: AgentMessage[];
+    pendingConversationWrites: PendingConversationWrite[];
+    conversation: Conversation;
+    emitQueueUpdate(): Promise<void>;
+};
+export declare function steerHarness(state: HarnessQueueState, text: string, options?: {
+    images?: ImageContent[];
+}): Promise<void>;
+export declare function enqueueHarnessMessage(state: HarnessQueueState, input: {
+    id?: string;
+    message: AgentMessage;
+    timestamp?: string;
+    delivery?: InboundQueuedMessage["delivery"];
+    priority?: InboundQueuedMessage["priority"];
+}): Promise<void>;
+export declare function enqueueNextTurn(state: HarnessQueueState, text: string, options?: {
+    images?: ImageContent[];
+}): Promise<void>;
+export declare function appendHarnessMessage(state: HarnessQueueState, message: AgentMessage): Promise<void>;
+export declare function appendExternalHarnessMessage(state: HarnessQueueState, input: {
+    id: string;
+    message: AgentMessage;
+    timestamp?: string;
+}): Promise<void>;
+//# sourceMappingURL=harness-queue-methods.d.ts.map

package/dist/harness/harness-queue-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-queue-methods.d.ts","sourceRoot":"","sources":["../../src/harness/harness-queue-methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAI/E,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;IACtD,YAAY,EAAE,YAAY,CAAC;IAC3B,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CAUf;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE;IACL,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC;CAC7C,GACA,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;CAAE,GACpC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/harness/harness-queue-methods.js

@@ -0,0 +1,51 @@
+import { queueOrWriteMessage } from "./conversation-writes.js";
+import { AgentHarnessError } from "./errors.js";
+import { normalizeHarnessError } from "./harness-events.js";
+import { createUserMessage } from "./run/messages.js";
+export async function steerHarness(state, text, options) {
+    if (state.phase === "idle") {
+        throw new AgentHarnessError("invalid_state", "Cannot steer while idle");
+    }
+    state.steerQueue.push({
+        source: "user",
+        message: createUserMessage(text, options?.images),
+        enqueuedAt: new Date().toISOString(),
+    });
+    await state.emitQueueUpdate();
+}
+export async function enqueueHarnessMessage(state, input) {
+    if (state.phase === "idle") {
+        throw new AgentHarnessError("invalid_state", "Cannot enqueue harness message while idle");
+    }
+    state.steerQueue.push({
+        id: input.id,
+        source: "harness",
+        message: input.message,
+        timestamp: input.timestamp,
+        enqueuedAt: new Date().toISOString(),
+        delivery: input.delivery,
+        priority: input.priority,
+    });
+    await state.emitQueueUpdate();
+}
+export async function enqueueNextTurn(state, text, options) {
+    state.nextTurnQueue.push(createUserMessage(text, options?.images));
+    await state.emitQueueUpdate();
+}
+export async function appendHarnessMessage(state, message) {
+    try {
+        await queueOrWriteMessage(state.phase, state.pendingConversationWrites, state.conversation, message);
+    }
+    catch (error) {
+        throw normalizeHarnessError(error, "conversation");
+    }
+}
+export async function appendExternalHarnessMessage(state, input) {
+    try {
+        await queueOrWriteMessage(state.phase, state.pendingConversationWrites, state.conversation, input.message, { id: input.id, timestamp: input.timestamp });
+    }
+    catch (error) {
+        throw normalizeHarnessError(error, "conversation");
+    }
+}
+//# sourceMappingURL=harness-queue-methods.js.map

package/dist/harness/harness-queue-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-queue-methods.js","sourceRoot":"","sources":["../../src/harness/harness-queue-methods.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAyBtD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB,EACxB,IAAY,EACZ,OAAqC;IAErC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,iBAAiB,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAAC;IAC1E,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;QACjD,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACrC,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAwB,EACxB,KAMC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,iBAAiB,CACzB,eAAe,EACf,2CAA2C,CAC5C,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACpB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAwB,EACxB,IAAY,EACZ,OAAqC;IAErC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAwB,EACxB,OAAqB;IAErB,IAAI,CAAC;QACH,MAAM,mBAAmB,CACvB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,yBAAyB,EAC/B,KAAK,CAAC,YAAY,EAClB,OAAO,CACR,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,qBAAqB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,KAAwB,EACxB,KAAgE;IAEhE,IAAI,CAAC;QACH,MAAM,mBAAmB,CACvB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,yBAAyB,EAC/B,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,OAAO,EACb,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAC7C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,qBAAqB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}