@nervekit/agent 0.1.0

package/dist/harness/agent-harness.js

@@ -0,0 +1,474 @@
+import { streamSimple, } from "@earendil-works/pi-ai";
+import { runAgentLoop } from "../agent-loop.js";
+import { isAgentToolSuspension } from "../suspension.js";
+import { cloneHarnessResources, createToolMap, validateToolNames, } from "./configuration.js";
+import { flushPendingConversationWrites as flushHarnessPendingConversationWrites } from "./conversation-writes.js";
+import { AgentHarnessError } from "./errors.js";
+import { abortHarnessRun, getHarnessActiveTools, setHarnessActiveTools, setHarnessModel, setHarnessResources, setHarnessThinkingLevel, setHarnessTools, } from "./harness-configuration-methods.js";
+import { continueHarnessRun, } from "./harness-continuation.js";
+import { AgentHarnessEventHub, normalizeHarnessError, normalizeHookError, } from "./harness-events.js";
+import { invokePromptTemplate, invokeSkill, } from "./harness-invocations.js";
+import { compactHarnessConversation, navigateHarnessTree, } from "./harness-maintenance.js";
+import { appendExternalHarnessMessage, appendHarnessMessage, enqueueHarnessMessage as enqueueHarnessQueueMessage, enqueueNextTurn, steerHarness, } from "./harness-queue-methods.js";
+import { convertToLlm } from "./messages.js";
+import { toError } from "./result.js";
+import { createFailureMessage, createUserMessage } from "./run/messages.js";
+import { cloneStreamOptions, mergeHeaders } from "./stream-options.js";
+import { createTurnState as createAgentHarnessTurnState, } from "./turn-state.js";
+export class AgentHarness {
+    env;
+    conversation;
+    phase = "idle";
+    runAbortController;
+    runPromise;
+    pendingConversationWrites = [];
+    model;
+    thinkingLevel;
+    systemPrompt;
+    streamOptions;
+    getApiKeyAndHeaders;
+    resources;
+    tools = new Map();
+    activeToolNames;
+    steerQueue = [];
+    steeringQueueMode;
+    followUpQueue = [];
+    followUpQueueMode;
+    nextTurnQueue = [];
+    queuedMessageWrites = new WeakMap();
+    events = new AgentHarnessEventHub();
+    constructor(options) {
+        this.env = options.env;
+        this.conversation = options.conversation;
+        this.resources = options.resources ?? {};
+        this.streamOptions = cloneStreamOptions(options.streamOptions);
+        this.systemPrompt = options.systemPrompt;
+        this.getApiKeyAndHeaders = options.getApiKeyAndHeaders;
+        this.tools = createToolMap(options.tools ?? []);
+        this.model = options.model;
+        this.thinkingLevel = options.thinkingLevel ?? "off";
+        this.activeToolNames = options.activeToolNames
+            ? [...options.activeToolNames]
+            : [...this.tools.keys()];
+        this.validateToolNames(this.activeToolNames);
+        this.steeringQueueMode = options.steeringMode ?? "one-at-a-time";
+        this.followUpQueueMode = options.followUpMode ?? "one-at-a-time";
+    }
+    async emitOwn(event, signal) {
+        await this.events.emitOwn(event, signal);
+    }
+    async emitAny(event, signal) {
+        await this.events.emitAny(event, signal);
+    }
+    async emitHook(event) {
+        return this.events.emitHook(event);
+    }
+    async emitBeforeProviderRequest(model, conversationId, streamOptions) {
+        return this.events.emitBeforeProviderRequest(model, conversationId, streamOptions);
+    }
+    async emitBeforeProviderPayload(model, payload) {
+        return this.events.emitBeforeProviderPayload(model, payload);
+    }
+    async emitQueueUpdate() {
+        await this.emitOwn({
+            type: "queue_update",
+            steer: this.steerQueue.map((entry) => entry.message),
+            followUp: this.followUpQueue.map((entry) => entry.message),
+            nextTurn: [...this.nextTurnQueue],
+        });
+    }
+    startRunPromise() {
+        let finish = () => { };
+        this.runPromise = new Promise((resolve) => {
+            finish = resolve;
+        });
+        return () => {
+            this.runPromise = undefined;
+            finish();
+        };
+    }
+    async createTurnState() {
+        return createAgentHarnessTurnState({
+            env: this.env,
+            conversation: this.conversation,
+            resources: this.getResources(),
+            streamOptions: this.streamOptions,
+            systemPrompt: this.systemPrompt,
+            model: this.model,
+            thinkingLevel: this.thinkingLevel,
+            tools: this.tools,
+            activeToolNames: this.activeToolNames,
+        });
+    }
+    createContext(turnState, systemPrompt) {
+        return {
+            systemPrompt: systemPrompt ?? turnState.systemPrompt,
+            messages: turnState.messages.slice(),
+            tools: turnState.activeTools.slice(),
+        };
+    }
+    createStreamFn(getTurnState) {
+        return async (model, context, streamOptions) => {
+            const turnState = getTurnState();
+            const auth = await this.getApiKeyAndHeaders?.(model);
+            const snapshotOptions = {
+                ...turnState.streamOptions,
+                headers: mergeHeaders(turnState.streamOptions.headers, auth?.headers),
+            };
+            const requestOptions = await this.emitBeforeProviderRequest(model, turnState.conversationId, snapshotOptions);
+            return streamSimple(model, context, {
+                cacheRetention: requestOptions.cacheRetention,
+                headers: requestOptions.headers,
+                maxRetries: requestOptions.maxRetries,
+                maxRetryDelayMs: requestOptions.maxRetryDelayMs,
+                metadata: requestOptions.metadata,
+                onPayload: async (payload) => await this.emitBeforeProviderPayload(model, payload),
+                onResponse: async (response) => {
+                    const headers = { ...response.headers };
+                    await this.emitOwn({
+                        type: "after_provider_response",
+                        status: response.status,
+                        headers,
+                    }, streamOptions?.signal);
+                },
+                reasoning: streamOptions?.reasoning,
+                signal: streamOptions?.signal,
+                sessionId: turnState.conversationId,
+                timeoutMs: requestOptions.timeoutMs,
+                transport: requestOptions.transport,
+                apiKey: auth?.apiKey,
+            });
+        };
+    }
+    async drainQueuedMessages(queue, mode) {
+        const entries = mode === "all" ? queue.splice(0) : queue.splice(0, 1);
+        if (entries.length === 0)
+            return [];
+        try {
+            await this.emitQueueUpdate();
+            for (const entry of entries) {
+                if (entry.id || entry.timestamp) {
+                    this.queuedMessageWrites.set(entry.message, {
+                        id: entry.id,
+                        timestamp: entry.timestamp,
+                    });
+                }
+            }
+            return entries.map((entry) => entry.message);
+        }
+        catch (error) {
+            queue.unshift(...entries);
+            throw normalizeHookError(error);
+        }
+    }
+    createLoopConfig(getTurnState, setTurnState) {
+        const turnState = getTurnState();
+        return {
+            model: turnState.model,
+            reasoning: turnState.thinkingLevel === "off" ? undefined : turnState.thinkingLevel,
+            convertToLlm,
+            transformContext: async (messages) => {
+                const result = await this.emitHook({
+                    type: "context",
+                    messages: [...messages],
+                });
+                return result?.messages ?? messages;
+            },
+            beforeToolCall: async ({ toolCall, args }) => {
+                const result = await this.emitHook({
+                    type: "tool_call",
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    input: args,
+                });
+                return result
+                    ? { block: result.block, reason: result.reason }
+                    : undefined;
+            },
+            afterToolCall: async ({ toolCall, args, result, isError }) => {
+                const patch = await this.emitHook({
+                    type: "tool_result",
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    input: args,
+                    content: result.content,
+                    details: result.details,
+                    isError,
+                });
+                return patch
+                    ? {
+                        content: patch.content,
+                        details: patch.details,
+                        isError: patch.isError,
+                        terminate: patch.terminate,
+                    }
+                    : undefined;
+            },
+            prepareNextTurn: async () => {
+                await this.flushPendingConversationWrites();
+                const nextTurnState = await this.createTurnState();
+                setTurnState(nextTurnState);
+                return {
+                    context: this.createContext(nextTurnState),
+                    model: nextTurnState.model,
+                    thinkingLevel: nextTurnState.thinkingLevel,
+                };
+            },
+            getSteeringMessages: async () => this.drainQueuedMessages(this.steerQueue, this.steeringQueueMode),
+            getFollowUpMessages: async () => [],
+        };
+    }
+    validateToolNames(toolNames, tools = this.tools) {
+        validateToolNames(toolNames, tools);
+    }
+    async flushPendingConversationWrites() {
+        await flushHarnessPendingConversationWrites(this.conversation, this.pendingConversationWrites);
+    }
+    async handleAgentEvent(event, signal) {
+        if (event.type === "message_end") {
+            const queuedWrite = this.queuedMessageWrites.get(event.message);
+            this.queuedMessageWrites.delete(event.message);
+            if (queuedWrite?.id) {
+                await this.conversation.appendMessageWithId(queuedWrite.id, event.message, queuedWrite.timestamp);
+            }
+            else {
+                await this.conversation.appendMessage(event.message);
+            }
+            await this.emitAny(event, signal);
+            return;
+        }
+        if (event.type === "turn_end") {
+            let eventError;
+            try {
+                await this.emitAny(event, signal);
+            }
+            catch (error) {
+                eventError = error;
+            }
+            const hadPendingMutations = this.pendingConversationWrites.length > 0;
+            await this.flushPendingConversationWrites();
+            if (eventError)
+                throw eventError;
+            await this.emitOwn({ type: "save_point", hadPendingMutations });
+            return;
+        }
+        if (event.type === "agent_end") {
+            await this.flushPendingConversationWrites();
+            this.phase = "idle";
+            await this.emitAny(event, signal);
+            await this.emitOwn({ type: "settled", nextTurnCount: this.nextTurnQueue.length }, signal);
+            return;
+        }
+        await this.emitAny(event, signal);
+    }
+    async emitRunFailure(model, error, aborted, signal) {
+        const failureMessage = createFailureMessage(model, error, aborted);
+        await this.handleAgentEvent({ type: "message_start", message: failureMessage }, signal);
+        await this.handleAgentEvent({ type: "message_end", message: failureMessage }, signal);
+        await this.handleAgentEvent({ type: "turn_end", message: failureMessage, toolResults: [] }, signal);
+        await this.handleAgentEvent({ type: "agent_end", messages: [failureMessage] }, signal);
+        return [failureMessage];
+    }
+    async executeTurn(turnState, text, options) {
+        let activeTurnState = turnState;
+        const promptMessage = createUserMessage(text, options?.images);
+        let messages = [promptMessage];
+        if (this.nextTurnQueue.length > 0) {
+            const queuedMessages = this.nextTurnQueue.splice(0);
+            try {
+                await this.emitQueueUpdate();
+            }
+            catch (error) {
+                this.nextTurnQueue.unshift(...queuedMessages);
+                throw normalizeHookError(error);
+            }
+            messages = [...queuedMessages, promptMessage];
+        }
+        const beforeResult = await this.emitHook({
+            type: "before_agent_start",
+            prompt: text,
+            images: options?.images,
+            systemPrompt: turnState.systemPrompt,
+            resources: turnState.resources,
+        });
+        if (beforeResult?.messages)
+            messages = [...messages, ...beforeResult.messages];
+        const abortController = new AbortController();
+        const getTurnState = () => activeTurnState;
+        const setTurnState = (nextTurnState) => {
+            activeTurnState = nextTurnState;
+        };
+        this.runAbortController = abortController;
+        const runResultPromise = (async () => {
+            try {
+                return await runAgentLoop(messages, this.createContext(turnState, beforeResult?.systemPrompt), this.createLoopConfig(getTurnState, setTurnState), (event) => this.handleAgentEvent(event, abortController.signal), abortController.signal, this.createStreamFn(getTurnState));
+            }
+            catch (error) {
+                if (isAgentToolSuspension(error)) {
+                    this.phase = "idle";
+                    throw error;
+                }
+                try {
+                    return await this.emitRunFailure(activeTurnState.model, error, abortController.signal.aborted, abortController.signal);
+                }
+                catch (failureError) {
+                    const cause = new AggregateError([toError(error), toError(failureError)], "Agent run failed and failure reporting failed");
+                    throw new AgentHarnessError("unknown", cause.message, cause);
+                }
+            }
+        })();
+        try {
+            const newMessages = await runResultPromise;
+            for (const message of [...newMessages].reverse()) {
+                if (message.role === "assistant") {
+                    return message;
+                }
+            }
+            throw new AgentHarnessError("invalid_state", "AgentHarness prompt completed without an assistant message");
+        }
+        finally {
+            try {
+                await this.flushPendingConversationWrites();
+            }
+            finally {
+                this.runAbortController = undefined;
+            }
+        }
+    }
+    async runForegroundTurn(resolvePrompt) {
+        if (this.phase !== "idle") {
+            throw new AgentHarnessError("busy", "AgentHarness is busy");
+        }
+        this.phase = "turn";
+        const finishRunPromise = this.startRunPromise();
+        try {
+            const turnState = await this.createTurnState();
+            const prompt = await resolvePrompt(turnState);
+            return await this.executeTurn(turnState, prompt.text, prompt.options);
+        }
+        catch (error) {
+            this.phase = "idle";
+            throw normalizeHarnessError(error, "unknown");
+        }
+        finally {
+            finishRunPromise();
+        }
+    }
+    async prompt(text, options) {
+        return this.runForegroundTurn(() => ({ text, options }));
+    }
+    async continue() {
+        return continueHarnessRun(this);
+    }
+    async skill(name, additionalInstructions) {
+        return invokeSkill(this, name, additionalInstructions);
+    }
+    async promptFromTemplate(name, args = []) {
+        return invokePromptTemplate(this, name, args);
+    }
+    queueState() {
+        return this;
+    }
+    async steer(text, options) {
+        return steerHarness(this.queueState(), text, options);
+    }
+    async followUp(text, options) {
+        return this.steer(text, options);
+    }
+    async enqueueHarnessMessage(input) {
+        return enqueueHarnessQueueMessage(this.queueState(), input);
+    }
+    async nextTurn(text, options) {
+        return enqueueNextTurn(this.queueState(), text, options);
+    }
+    async appendMessage(message) {
+        return appendHarnessMessage(this.queueState(), message);
+    }
+    async appendExternalMessage(input) {
+        return appendExternalHarnessMessage(this.queueState(), input);
+    }
+    async compact(customInstructions) {
+        return compactHarnessConversation(this.maintenanceContext(), customInstructions);
+    }
+    async navigateTree(targetId, options) {
+        return navigateHarnessTree(this.maintenanceContext(), targetId, options);
+    }
+    maintenanceContext() {
+        return {
+            getPhase: () => this.phase,
+            setPhase: (phase) => {
+                this.phase = phase;
+            },
+            conversation: this.conversation,
+            getModel: () => this.model,
+            getThinkingLevel: () => this.thinkingLevel,
+            getApiKeyAndHeaders: this.getApiKeyAndHeaders,
+            emitHook: (event) => this.emitHook(event),
+            emitOwn: (event) => this.emitOwn(event),
+        };
+    }
+    configurationState() {
+        return this;
+    }
+    getModel() {
+        return this.model;
+    }
+    async setModel(model) {
+        return setHarnessModel(this.configurationState(), model);
+    }
+    getThinkingLevel() {
+        return this.thinkingLevel;
+    }
+    async setThinkingLevel(level) {
+        return setHarnessThinkingLevel(this.configurationState(), level);
+    }
+    getTools() {
+        return [...this.tools.values()];
+    }
+    async setTools(tools, activeToolNames) {
+        return setHarnessTools(this.configurationState(), tools, activeToolNames);
+    }
+    getActiveTools() {
+        return getHarnessActiveTools(this.configurationState());
+    }
+    async setActiveTools(toolNames) {
+        return setHarnessActiveTools(this.configurationState(), toolNames);
+    }
+    getSteeringMode() {
+        return this.steeringQueueMode;
+    }
+    async setSteeringMode(mode) {
+        this.steeringQueueMode = mode;
+    }
+    getFollowUpMode() {
+        return this.followUpQueueMode;
+    }
+    async setFollowUpMode(mode) {
+        this.followUpQueueMode = mode;
+    }
+    getResources() {
+        return cloneHarnessResources(this.resources);
+    }
+    async setResources(resources) {
+        return setHarnessResources(this.configurationState(), resources);
+    }
+    getStreamOptions() {
+        return cloneStreamOptions(this.streamOptions);
+    }
+    async setStreamOptions(streamOptions) {
+        this.streamOptions = cloneStreamOptions(streamOptions);
+    }
+    async abort() {
+        return abortHarnessRun(this.configurationState());
+    }
+    async waitForIdle() {
+        await this.runPromise;
+    }
+    subscribe(listener) {
+        return this.events.subscribe(listener);
+    }
+    on(type, handler) {
+        return this.events.on(type, handler);
+    }
+}
+//# sourceMappingURL=agent-harness.js.map

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

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

package/dist/harness/compaction/branch-summarization.d.ts

@@ -0,0 +1,54 @@
+import type { AgentMessage, AnyModel } from "../../types.js";
+import type { Conversation, ConversationTreeEntry } from "../conversation/entries.js";
+import { BranchSummaryError } from "../errors.js";
+import type { BranchSummaryResult } from "../events.js";
+import { type Result } from "../result.js";
+import { type FileOperations } from "./utils.js";
+/** File-operation details stored on generated branch summary entries. */
+export interface BranchSummaryDetails {
+    /** Files read while exploring the summarized branch. */
+    readFiles: string[];
+    /** Files modified while exploring the summarized branch. */
+    modifiedFiles: string[];
+}
+export type { FileOperations } from "./utils.js";
+/** Prepared branch content for summarization. */
+export interface BranchPreparation {
+    /** Messages selected for the branch summary. */
+    messages: AgentMessage[];
+    /** File operations extracted from the branch. */
+    fileOps: FileOperations;
+    /** Estimated token count for selected messages. */
+    totalTokens: number;
+}
+/** Entries selected for branch summarization. */
+export interface CollectEntriesResult {
+    /** Entries to summarize in chronological order. */
+    entries: ConversationTreeEntry[];
+    /** Deepest common ancestor between the previous leaf and target entry. */
+    commonAncestorId: string | null;
+}
+/** Options for generating a branch summary. */
+export interface GenerateBranchSummaryOptions {
+    /** Model used for summarization. */
+    model: AnyModel;
+    /** API key forwarded to the provider. */
+    apiKey: string;
+    /** Optional request headers forwarded to the provider. */
+    headers?: Record<string, string>;
+    /** Abort signal for the summarization request. */
+    signal: AbortSignal;
+    /** Optional instructions appended to or replacing the default prompt. */
+    customInstructions?: string;
+    /** Replace the default prompt with custom instructions instead of appending them. */
+    replaceInstructions?: boolean;
+    /** Tokens reserved for prompt and model output. Defaults to 16384. */
+    reserveTokens?: number;
+}
+/** Collect entries that should be summarized before navigating to a different conversation tree entry. */
+export declare function collectEntriesForBranchSummary(conversation: Conversation, oldLeafId: string | null, targetId: string): Promise<CollectEntriesResult>;
+/** Prepare branch entries for summarization within an optional token budget. */
+export declare function prepareBranchEntries(entries: ConversationTreeEntry[], tokenBudget?: number): BranchPreparation;
+/** Generate a summary for abandoned branch entries. */
+export declare function generateBranchSummary(entries: ConversationTreeEntry[], options: GenerateBranchSummaryOptions): Promise<Result<BranchSummaryResult, BranchSummaryError>>;
+//# sourceMappingURL=branch-summarization.d.ts.map

package/dist/harness/compaction/branch-summarization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-summarization.d.ts","sourceRoot":"","sources":["../../../src/harness/compaction/branch-summarization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAOxD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAIL,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAEpB,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4DAA4D;IAC5D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,iDAAiD;IACjD,OAAO,EAAE,cAAc,CAAC;IACxB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,4BAA4B;IAC3C,oCAAoC;IACpC,KAAK,EAAE,QAAQ,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kDAAkD;IAClD,MAAM,EAAE,WAAW,CAAC;IACpB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0GAA0G;AAC1G,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CA+B/B;AA0CD,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,EAAE,EAChC,WAAW,GAAE,MAAU,GACtB,iBAAiB,CAuCnB;AAoCD,uDAAuD;AACvD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAAE,EAChC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC,CA+E1D"}