@nervekit/orchestrator 0.1.0

package/dist/domains/agents/run/agent-runner-shared.js

@@ -0,0 +1,58 @@
+export function recordFromUnknown(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+export function errorTextFromToolResult(result, toolName) {
+    const record = recordFromUnknown(result);
+    const content = Array.isArray(record.content) ? record.content : [];
+    const text = content
+        .map((part) => {
+        const partRecord = recordFromUnknown(part);
+        return partRecord.type === "text" && typeof partRecord.text === "string"
+            ? partRecord.text
+            : "";
+    })
+        .filter(Boolean)
+        .join("\n");
+    return text.trim() || `Tool ${toolName} failed before execution.`;
+}
+export function isRetryableAssistantError(message) {
+    if (message.stopReason !== "error" || !message.errorMessage)
+        return false;
+    const error = message.errorMessage;
+    if (/GoUsageLimitError|FreeUsageLimitError|Monthly usage limit reached|available balance|insufficient_quota|out of budget|quota exceeded|billing|context.?length|context.?window|maximum context|too many tokens/i.test(error)) {
+        return false;
+    }
+    return /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|websocket.?closed|websocket.?error|other side closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|stream ended before message_stop|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i.test(error);
+}
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export function sameStringList(left, right) {
+    return (left.length === right.length &&
+        left.every((value, index) => value === right[index]));
+}
+export function assistantContentRedacted(message, contentIndex) {
+    const block = message.content[contentIndex];
+    return block?.type === "thinking" ? block.redacted : undefined;
+}
+export function assistantToolCallDraft(message, contentIndex) {
+    const block = message.content[contentIndex];
+    return block?.type === "toolCall"
+        ? { id: block.id, name: block.name }
+        : undefined;
+}
+export function assistantToolCallSnapshots(message) {
+    return message.content.flatMap((block, contentIndex) => block.type === "toolCall"
+        ? [
+            {
+                contentIndex,
+                id: block.id,
+                name: block.name,
+                arguments: recordFromUnknown(block.arguments),
+            },
+        ]
+        : []);
+}
+//# sourceMappingURL=agent-runner-shared.js.map

package/dist/domains/agents/run/agent-runner-shared.js.map

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

package/dist/domains/agents/run/agent-runner.d.ts

@@ -0,0 +1,119 @@
+import type { AssistantMessage } from "@earendil-works/pi-ai";
+import { type AgentHarness, AgentToolSuspension, Conversation } from "@nervekit/agent";
+import type { AgentRecord, ContextUsage, ConversationEntry, ConversationRecord, ConversationRunRetryExhaustedData, CreateAgentRequest, PromptRequest, ToolName } from "@nervekit/shared";
+import type { AuthManager } from "../../../auth.js";
+import type { EventBus } from "../../../infrastructure/events/index.js";
+import type { InitializedStorage } from "../../../infrastructure/storage/index.js";
+import type { ApplicationLogger } from "../../../logging.js";
+import type { RuntimeState } from "../../../runtime/runtime-state.js";
+import type { ConversationService } from "../../conversations/conversation-service.js";
+import type { HarnessManager } from "../../conversations/harness-manager.js";
+import type { CompactionService } from "../../conversations/operations/index.js";
+import type { PythonRuntimeService } from "../../runtime/python-runtime-service.js";
+import type { ExploreProgressUpdate, ToolService } from "../../tools/tool-service.js";
+import type { SubscriptionUsageService } from "../../usage/subscription-usage-service.js";
+import type { AgentSuspensionService } from "../agent-suspension.service.js";
+import type { PromptQueueRepository } from "../prompt-queue.repository.js";
+import type { AppendEntryFn, MessageMirror } from "./message-mirror.js";
+import { type ExploreReport, SubagentRunner } from "./subagent-runner.js";
+export interface AgentRunnerDeps {
+    storage: InitializedStorage;
+    events: EventBus;
+    auth: AuthManager;
+    tools: ToolService;
+    pythonRuntime: PythonRuntimeService;
+    suspensions: AgentSuspensionService;
+    harnessManager: HarnessManager;
+    conversationService: ConversationService;
+    compactionService: CompactionService;
+    state: RuntimeState;
+    createAgent: (request: CreateAgentRequest, options?: {
+        allowChildAuthorityExceed?: boolean;
+    }) => Promise<AgentRecord>;
+    setAgentStatus: (agent: AgentRecord, status: AgentRecord["status"]) => Promise<void>;
+    appendEntry: AppendEntryFn;
+    updateConversation: (conversation: ConversationRecord) => Promise<void>;
+    messageMirror: MessageMirror;
+    subscriptionUsage: SubscriptionUsageService;
+    logger: ApplicationLogger;
+    promptQueue: PromptQueueRepository;
+}
+export declare class AgentRunner {
+    readonly deps: AgentRunnerDeps;
+    readonly subagents: SubagentRunner;
+    readonly autoContinuationCounts: Map<string, number>;
+    constructor(deps: AgentRunnerDeps);
+    activeToolNamesFor(agent: AgentRecord): Promise<ToolName[]>;
+    promptAgent(agentId: string, request: PromptRequest): Promise<void>;
+    continueAgent(agentId: string): Promise<void>;
+    continueFromFailedTurn(agentId: string, failedEntryId: string): Promise<void>;
+    /**
+     * Resume a run that ended without a clean stop (interruption or a loop exception with
+     * no re-runnable failed model turn). Inspects the conversation leaf: if it is an
+     * assistant message, rewind to its parent and re-run that turn; otherwise (a user or
+     * tool-result leaf) continue forward from the current leaf.
+     */
+    resumeRun(agentId: string): Promise<void>;
+    abortAgent(agentId: string): Promise<void>;
+    runExplore(parent: AgentRecord, args: Record<string, unknown>, options?: {
+        onProgress?: (update: ExploreProgressUpdate) => void;
+        signal?: AbortSignal;
+    }): Promise<{
+        reports: ExploreReport[];
+        contentBlocks: [{
+            type: "text";
+            text: string;
+        }];
+    }>;
+    runAgentPrompt(agent: AgentRecord, request: PromptRequest, options?: {
+        continue?: boolean;
+    }): Promise<ConversationEntry>;
+    terminateRunToolCalls(runId: string, message?: string): Promise<void>;
+    /**
+     * Append a durable `run_status` entry for a non-clean run ending and publish the
+     * corresponding `conversation.entry.appended` event. The entry is orchestrator-only
+     * (`mirrorToHarness: false`) so it is never sent to the model. When `parentEntryId`
+     * is omitted the entry is parented at the conversation's current leaf and becomes the
+     * new active tail.
+     */
+    private appendRunStatusEntry;
+    /**
+     * Append a continuable status entry for a failed assistant turn. Emits a
+     * `retry_exhausted` status when the failure is a retryable model error and retries
+     * are enabled (preserving existing wording), otherwise a generic `failed` status.
+     */
+    appendRunFailureStatus(agent: AgentRecord, runId: string, assistantEntry: ConversationEntry, assistant: AssistantMessage): Promise<ConversationRunRetryExhaustedData>;
+    /**
+     * Append a continuable `failed` status entry for an exception thrown inside the run
+     * loop. When a failed assistant entry exists it is referenced (and hidden) so Continue
+     * rewinds and re-runs that turn; otherwise the card is appended at the current leaf and
+     * Continue resumes forward.
+     */
+    appendRunErrorStatus(agent: AgentRecord, runId: string, message: string, lastAssistantEntry?: ConversationEntry): Promise<ConversationRunRetryExhaustedData>;
+    runHarnessWithRetries(input: {
+        harness: AgentHarness;
+        conversation: Conversation;
+        request: PromptRequest;
+        continue: boolean;
+        runId: string;
+        agent: AgentRecord;
+    }): Promise<AssistantMessage>;
+    tryOverflowCompactionRecovery(input: {
+        conversation: Conversation;
+        runId: string;
+        agent: AgentRecord;
+    }, assistant: AssistantMessage, contextWindow: number): Promise<boolean>;
+    maybeMarkQueuedPromptDelivered(agent: AgentRecord, runId: string, entry: ConversationEntry): Promise<void>;
+    suspensionFromWaitingToolCall(agent: AgentRecord, runId: string, error: unknown): AgentToolSuspension | undefined;
+    /** Compute compaction-aware context-window usage for a conversation. */
+    getContextUsage(conversationId: string): Promise<ContextUsage>;
+    publishContextUsage(conversationId: string, agentId: string, runId: string): Promise<void>;
+    maybeAutoCompact(conversationId: string, agentId?: string, runId?: string): Promise<void>;
+    /**
+     * Push a normal handover user message and start a continuation run after an
+     * automatic compaction, bounded by a per-conversation runaway guard.
+     */
+    continueAfterAutoCompaction(agent: AgentRecord): Promise<void>;
+    appendAutoContinueMessage(agent: AgentRecord, text: string): Promise<ConversationEntry>;
+}
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/domains/agents/run/agent-runner.d.ts.map

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