@esankhan3/anvil-agent-core 0.1.0

package/dist/agent/session/collect-trajectory.js

@@ -0,0 +1,193 @@
+/**
+ * `collectTrajectory` — eval-facing entry point. Spawns an `AgentProcess`,
+ * listens to its 5-event surface, and aggregates an Inspect-AI-shaped
+ * `AgentTrajectory`.
+ *
+ * Replaces the headless `runAgent` entry. Same trajectory contract, but
+ * routed through the production execution path (`AgentProcess` +
+ * `defaultAdapterFactory`) so eval runs exercise the same code the
+ * dashboard and cli do — including skills + MCP discovery via
+ * `workspace.rootDir`.
+ *
+ * Per AGENT-PROCESS-CONSOLIDATION-ADR §C1.
+ */
+import { randomBytes } from 'node:crypto';
+import { AgentProcess } from './session.js';
+import { defaultAdapterFactory } from './default-adapter-factory.js';
+const DEFAULT_TIMEOUT_MS = 600_000;
+const ANSWER_PLACEHOLDER = '';
+/**
+ * Run a task to completion and return its Inspect-AI-shaped trajectory.
+ *
+ * Listener-first ordering: every event handler is attached BEFORE
+ * `proc.start()` so the first `content` chunk doesn't slip through.
+ */
+export async function collectTrajectory(task, workspace, opts = {}) {
+    const startedAt = Date.now();
+    const spec = taskToSpawnConfig(task, workspace);
+    const processOpts = {
+        adapterFactory: defaultAdapterFactory,
+        ...opts.processOpts,
+    };
+    const proc = new AgentProcess(spec, processOpts);
+    const messages = [];
+    if (task.systemPrompt) {
+        messages.push({ role: 'system', content: task.systemPrompt });
+    }
+    messages.push({ role: 'user', content: task.prompt });
+    const toolCalls = [];
+    const toolCallByName = new Map();
+    let assistantBuffer = '';
+    let finalAnswer = ANSWER_PLACEHOLDER;
+    let cost = null;
+    let resolvedSessionId = spec.runId ?? proc.id;
+    let errorText = '';
+    const flushAssistantBuffer = () => {
+        if (!assistantBuffer)
+            return;
+        messages.push({ role: 'assistant', content: assistantBuffer });
+        assistantBuffer = '';
+    };
+    return new Promise((resolve) => {
+        let settled = false;
+        let timeoutHandle = null;
+        const finish = (finishReason, errorOverride) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            flushAssistantBuffer();
+            const durationMs = Date.now() - startedAt;
+            const usage = cost
+                ? {
+                    inputTokens: cost.inputTokens,
+                    outputTokens: cost.outputTokens,
+                    ...(cost.cacheReadTokens
+                        ? { cacheReadTokens: cost.cacheReadTokens }
+                        : {}),
+                    ...(cost.cacheWriteTokens
+                        ? { cacheWriteTokens: cost.cacheWriteTokens }
+                        : {}),
+                }
+                : { inputTokens: 0, outputTokens: 0 };
+            const finalErrorText = errorOverride ?? errorText.trim();
+            const trajectory = {
+                messages,
+                toolCalls,
+                model: spec.model,
+                usage,
+                costUsd: cost?.totalUsd ?? 0,
+                finalAnswer: finalAnswer || assistantBuffer,
+                finishReason,
+                durationMs,
+                ...(finishReason === 'error' && finalErrorText
+                    ? { error: finalErrorText }
+                    : {}),
+            };
+            resolve(trajectory);
+        };
+        // ── Listener wiring (before start) ─────────────────────────────────
+        proc.on('content', (chunk) => {
+            assistantBuffer += chunk;
+        });
+        proc.on('activity', (activity) => {
+            if (activity.kind !== 'tool_use' || !activity.tool)
+                return;
+            // Flush any accumulated assistant text BEFORE the tool message so
+            // ordering reflects the run.
+            flushAssistantBuffer();
+            let parsedArgs = {};
+            if (typeof activity.content === 'string' && activity.content.trim()) {
+                try {
+                    parsedArgs = JSON.parse(activity.content);
+                }
+                catch {
+                    parsedArgs = { _raw: activity.content };
+                }
+            }
+            const call = {
+                callId: activity.id,
+                name: activity.tool,
+                arguments: parsedArgs,
+                durationMs: 0,
+            };
+            toolCalls.push(call);
+            toolCallByName.set(activity.id, call);
+            messages.push({
+                role: 'tool',
+                content: '',
+                name: activity.tool,
+                toolCallId: activity.id,
+            });
+        });
+        proc.on('result', (data) => {
+            cost = data.cost;
+            finalAnswer = data.result || assistantBuffer;
+            resolvedSessionId = data.sessionId;
+            // Don't finish here — wait for `exit` so adapters that emit result
+            // before exit (the common case) and after exit (sub-second races)
+            // both settle deterministically on the exit event.
+        });
+        proc.on('error-output', (text) => {
+            errorText += text;
+        });
+        proc.on('exit', (code) => {
+            // Surface the resolvedSessionId on the last assistant message via a
+            // suffix is unnecessary; the trajectory shape doesn't carry session
+            // id today. Reserved here so future schema bumps can grab it.
+            void resolvedSessionId;
+            if (code === null) {
+                finish('error', 'killed');
+            }
+            else if (code !== 0) {
+                finish('error');
+            }
+            else {
+                finish(cost ? 'end' : 'error', cost ? undefined : errorText.trim() || 'no result');
+            }
+        });
+        // ── Abort + timeout ────────────────────────────────────────────────
+        if (opts.signal) {
+            if (opts.signal.aborted) {
+                proc.kill();
+                finish('error', 'aborted');
+                return;
+            }
+            opts.signal.addEventListener('abort', () => {
+                proc.kill();
+                finish('error', 'aborted');
+            }, { once: true });
+        }
+        const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        timeoutHandle = setTimeout(() => {
+            proc.kill();
+            finish('error', 'timeout');
+        }, timeoutMs);
+        // ── Start ──────────────────────────────────────────────────────────
+        proc.start();
+    });
+}
+/**
+ * Map an `AgentTask` + `WorkspaceConfig` to a `SpawnConfig`. Internal
+ * helper — eval consumers stay on the `(task, workspace)` shape.
+ */
+function taskToSpawnConfig(task, workspace) {
+    const runId = task.taskId ?? `eval-${randomBytes(4).toString('hex')}`;
+    return {
+        name: task.taskId ?? 'eval-task',
+        persona: 'eval',
+        project: 'eval',
+        stage: 'eval',
+        prompt: task.prompt,
+        model: task.model,
+        cwd: workspace.rootDir,
+        workspaceDir: workspace.rootDir,
+        projectPrompt: task.systemPrompt,
+        allowedTools: task.allowedTools,
+        maxOutputTokens: task.maxTokens,
+        runId,
+        runFamily: runId,
+    };
+}
+//# sourceMappingURL=collect-trajectory.js.map

package/dist/agent/session/collect-trajectory.js.map

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

package/dist/agent/session/default-adapter-factory.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Default `AgentAdapterFactory` for `AgentManager`.
+ *
+ * Resolves a `SpawnConfig`'s model field to an `@esankhan3/anvil-agent-core`
+ * `ModelAdapter` via `ProviderRegistry`, then wraps it in a
+ * `LanguageModelBridge` so `AgentProcess` can drive it through the 5-event
+ * `AgentAdapter` surface.
+ *
+ * Provider resolution heuristic:
+ *   - `gemini-*` prefers the Gemini CLI when the binary is on PATH; if not,
+ *     falls back to the HTTP API adapter (`gemini`).
+ *   - Model ids containing `/` route to OpenRouter.
+ *   - Otherwise we delegate to `ProviderRegistry.resolveFromModelId` which
+ *     covers Claude / OpenAI / Gemini-API.
+ */
+import type { ProviderName } from '../../types.js';
+import type { AdapterRequest, AgentAdapter, AgentAdapterFactory } from './adapter.js';
+export declare function resolveProvider(modelId: string): ProviderName;
+/**
+ * Default factory used by `AgentManager` when no `adapterFactory` is
+ * passed to its constructor. Resolves a `LanguageModelBridge` for the
+ * given request via `ProviderRegistry`.
+ *
+ * Returned adapter is always a `LanguageModelBridge` — `AgentProcess`
+ * sees the 5-event `AgentAdapter` surface; agent-core handles the actual
+ * call via the registered `ModelAdapter`.
+ */
+export declare function defaultAdapterFactory(request: AdapterRequest): AgentAdapter;
+/**
+ * When `request.workspaceDir` is set, enrich the request with workspace-
+ * rooted artefacts:
+ *   - Non-Claude paths: compose skill context (system prompt + allowed-
+ *     tools narrowing) into the request's `projectPrompt` / `allowedTools`.
+ *   - Claude path: resolve the canonical `mcp.json` path so the adapter
+ *     can pass `--mcp-config <path>` to claude-cli.
+ *
+ * Skills are NOT injected into the system prompt for the Claude path
+ * because claude-cli auto-loads `.claude/skills/` itself; double-loading
+ * would duplicate the bullet list. Per AGENT-PROCESS-CONSOLIDATION-ADR
+ * §C5.
+ *
+ * Pure: returns a new `AdapterRequest` (or the original when no enrichment
+ * applies).
+ */
+export declare function enrichRequestWithWorkspace(request: AdapterRequest, provider: ProviderName): AdapterRequest;
+/** Type alias matching `AgentAdapterFactory` — exported for explicit typing. */
+export declare const defaultAdapterFactoryFn: AgentAdapterFactory;
+//# sourceMappingURL=default-adapter-factory.d.ts.map

package/dist/agent/session/default-adapter-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-adapter-factory.d.ts","sourceRoot":"","sources":["../../../src/agent/session/default-adapter-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAOtB,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA0D7D;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAc3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,YAAY,GACrB,cAAc,CAgChB;AAoCD,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,EAAE,mBAA2C,CAAC"}

package/dist/agent/session/default-adapter-factory.js

@@ -0,0 +1,227 @@
+/**
+ * Default `AgentAdapterFactory` for `AgentManager`.
+ *
+ * Resolves a `SpawnConfig`'s model field to an `@esankhan3/anvil-agent-core`
+ * `ModelAdapter` via `ProviderRegistry`, then wraps it in a
+ * `LanguageModelBridge` so `AgentProcess` can drive it through the 5-event
+ * `AgentAdapter` surface.
+ *
+ * Provider resolution heuristic:
+ *   - `gemini-*` prefers the Gemini CLI when the binary is on PATH; if not,
+ *     falls back to the HTTP API adapter (`gemini`).
+ *   - Model ids containing `/` route to OpenRouter.
+ *   - Otherwise we delegate to `ProviderRegistry.resolveFromModelId` which
+ *     covers Claude / OpenAI / Gemini-API.
+ */
+import { execSync } from 'node:child_process';
+import { trace } from '@opentelemetry/api';
+import { ProviderRegistry } from '../../registry.js';
+import { loadModelRegistry } from '../../router/model-registry.js';
+import { LanguageModelBridge } from './language-model-bridge.js';
+import { composeSkillContext } from '../../skills/index.js';
+import { findMcpConfigPath, loadMcpServers } from '../../mcp/index.js';
+// ── Provider resolution ──────────────────────────────────────────────────
+export function resolveProvider(modelId) {
+    // User registry wins over heuristics. If models.yaml declares
+    // `provider: gemini` for `gemini-2.5-flash`, honor that — don't
+    // silently route to gemini-cli just because the binary is on PATH.
+    const declared = lookupDeclaredProvider(modelId);
+    if (declared)
+        return declared;
+    const id = modelId.toLowerCase();
+    // Ollama: explicit `ollama:` prefix or `:tag` suffix common to local models
+    // (e.g. `qwen2.5-coder:7b`, `llama3.1:8b`).
+    if (id.startsWith('ollama:'))
+        return 'ollama';
+    // Gemini: route to the CLI when the binary is on PATH (matches user
+    // intent of running `gemini` interactively). Otherwise fall through to
+    // the registry's claude default — the bare HTTP `gemini` adapter is
+    // `tier: function-calling` (no agentic loop) so callers must opt in
+    // explicitly via `adk:gemini-…` for agentic Gemini, or use
+    // `single-shot.runGemini` for the CLI single-shot path.
+    if (id.startsWith('gemini-')) {
+        if (geminiCliAvailable())
+            return 'gemini-cli';
+        // No silent fallback to non-agentic gemini HTTP — fall through.
+    }
+    // OpenAI patterns
+    if (id.startsWith('gpt-') ||
+        id.startsWith('o1') ||
+        id.startsWith('o3') ||
+        id.startsWith('o4') ||
+        id.startsWith('chatgpt-')) {
+        return 'openai';
+    }
+    // OpenCode Go: registry uses `opencode/<model>` to disambiguate from
+    // OpenRouter's slug format. Must come BEFORE the generic slash-check.
+    if (id.startsWith('opencode/'))
+        return 'opencode';
+    // Google ADK: explicit `adk:<model>` prefix (e.g. `adk:claude-sonnet-4-6`,
+    // `adk:gemini-2.5-flash`). The adapter strips the prefix before
+    // handing the bare model id to ADK's LLMRegistry.
+    if (id.startsWith('adk:'))
+        return 'adk';
+    // OpenRouter uses `org/model` format
+    if (id.includes('/')) {
+        return 'openrouter';
+    }
+    // Local Ollama models often look like `<family>:<size>` (no slash, with tag).
+    // Route through Ollama only when the daemon is reachable; otherwise fall
+    // back to Claude so misconfigured runs don't break.
+    if (/^[a-z0-9_.-]+:[a-z0-9_.-]+$/.test(id) && id !== 'claude' && !id.startsWith('claude-')) {
+        return 'ollama';
+    }
+    // Claude (default)
+    return 'claude';
+}
+// Cache the parsed user registry so repeated factory calls don't re-read +
+// re-parse models.yaml from disk. Set ANVIL_MODELS_RELOAD=1 in the env to
+// bypass the cache (useful when iterating on the yaml during a long-lived
+// dashboard session).
+let modelRegistryCache = null;
+function lookupDeclaredProvider(modelId) {
+    if (process.env.ANVIL_MODELS_RELOAD === '1')
+        modelRegistryCache = null;
+    if (modelRegistryCache === null) {
+        try {
+            modelRegistryCache = loadModelRegistry();
+        }
+        catch {
+            modelRegistryCache = { models: [], walker: { liveness_ttl_ms: 30000, max_attempts: 5 } };
+        }
+    }
+    const match = modelRegistryCache.models.find((m) => m.id === modelId);
+    return match?.provider ?? null;
+}
+// Cache the CLI probe so repeated factory calls don't fork a shell each time.
+let geminiCliCached = null;
+function geminiCliAvailable() {
+    if (geminiCliCached !== null)
+        return geminiCliCached;
+    try {
+        execSync('which gemini', { stdio: 'pipe', timeout: 2000 });
+        geminiCliCached = true;
+    }
+    catch {
+        geminiCliCached = false;
+    }
+    return geminiCliCached;
+}
+// ── Factory ──────────────────────────────────────────────────────────────
+/**
+ * Default factory used by `AgentManager` when no `adapterFactory` is
+ * passed to its constructor. Resolves a `LanguageModelBridge` for the
+ * given request via `ProviderRegistry`.
+ *
+ * Returned adapter is always a `LanguageModelBridge` — `AgentProcess`
+ * sees the 5-event `AgentAdapter` surface; agent-core handles the actual
+ * call via the registered `ModelAdapter`.
+ */
+export function defaultAdapterFactory(request) {
+    const registry = ProviderRegistry.getInstance();
+    const provider = resolveProvider(request.model);
+    const resolved = resolveAdapterOrFallback(registry, provider);
+    // Default workspaceDir to cwd when the spawn caller didn't set one. This
+    // makes skills + MCP first-class for every spawn site — dashboard, cli,
+    // eval — without each caller having to opt in. Per AGENT-PROCESS-
+    // CONSOLIDATION-ADR §C4 + Phase 4. Callers can explicitly pass
+    // `workspaceDir: ''` (empty string is falsy) to opt out, e.g. from tests.
+    const requestWithDefaults = request.workspaceDir === undefined
+        ? { ...request, workspaceDir: request.cwd }
+        : request;
+    const enriched = enrichRequestWithWorkspace(requestWithDefaults, resolved.provider);
+    return new LanguageModelBridge(enriched, resolved.adapter, resolved.provider);
+}
+/**
+ * When `request.workspaceDir` is set, enrich the request with workspace-
+ * rooted artefacts:
+ *   - Non-Claude paths: compose skill context (system prompt + allowed-
+ *     tools narrowing) into the request's `projectPrompt` / `allowedTools`.
+ *   - Claude path: resolve the canonical `mcp.json` path so the adapter
+ *     can pass `--mcp-config <path>` to claude-cli.
+ *
+ * Skills are NOT injected into the system prompt for the Claude path
+ * because claude-cli auto-loads `.claude/skills/` itself; double-loading
+ * would duplicate the bullet list. Per AGENT-PROCESS-CONSOLIDATION-ADR
+ * §C5.
+ *
+ * Pure: returns a new `AdapterRequest` (or the original when no enrichment
+ * applies).
+ */
+export function enrichRequestWithWorkspace(request, provider) {
+    if (!request.workspaceDir)
+        return request;
+    if (provider === 'claude') {
+        const mcpPath = findMcpConfigPath({ workspaceRoot: request.workspaceDir });
+        if (!mcpPath)
+            return request;
+        // Phase 6: surface MCP discovery on the active session span. claude-cli
+        // owns the actual server connections, so we only know servers exist —
+        // not how many tools they advertise.
+        annotateSpanWithMcp(request.workspaceDir, { tools: undefined });
+        return { ...request, claudeMcpConfigPath: mcpPath };
+    }
+    // Non-Claude path: inject skill block into projectPrompt + reconcile
+    // allowed-tools. composeSkillContext is a no-op when no skills exist.
+    const ctx = composeSkillContext(request.projectPrompt ?? '', {
+        workspaceRoot: request.workspaceDir,
+        allowedTools: request.allowedTools,
+    });
+    // Phase 6: surface skill + MCP discovery on the active session span.
+    annotateSpanWithSkills(ctx.activated.skills.map((s) => s.frontmatter.name));
+    annotateSpanWithMcp(request.workspaceDir, { tools: undefined });
+    if (ctx.activated.skills.length === 0 && !ctx.toolsConstrained) {
+        return request;
+    }
+    return {
+        ...request,
+        projectPrompt: ctx.systemPrompt || undefined,
+        allowedTools: ctx.allowedTools,
+    };
+}
+/**
+ * Set `anvil.skills.activated.count` + `anvil.skills.activated.names` on
+ * the active OTel span (the `anvil.agent.session` span when called from
+ * inside `AgentProcess.start()`'s session context). Absence-stays-absent
+ * per observability ADR §O7: when no skills load, no attribute is emitted.
+ */
+function annotateSpanWithSkills(activatedNames) {
+    if (activatedNames.length === 0)
+        return;
+    const span = trace.getActiveSpan();
+    if (!span)
+        return;
+    span.setAttribute('anvil.skills.activated.count', activatedNames.length);
+    span.setAttribute('anvil.skills.activated.names', activatedNames.join(','));
+}
+/**
+ * Set `anvil.mcp.servers.count` (and `anvil.mcp.tools.count` when known)
+ * on the active OTel span. We resolve mcp.json once here — the file read
+ * is cheap, and this is the only place that knows whether MCP discovery
+ * found anything for the workspace.
+ */
+function annotateSpanWithMcp(workspaceDir, meta) {
+    const servers = loadMcpServers({ workspaceRoot: workspaceDir });
+    if (servers.length === 0)
+        return;
+    const span = trace.getActiveSpan();
+    if (!span)
+        return;
+    span.setAttribute('anvil.mcp.servers.count', servers.length);
+    if (typeof meta.tools === 'number') {
+        span.setAttribute('anvil.mcp.tools.count', meta.tools);
+    }
+}
+/** Type alias matching `AgentAdapterFactory` — exported for explicit typing. */
+export const defaultAdapterFactoryFn = defaultAdapterFactory;
+function resolveAdapterOrFallback(registry, provider) {
+    const direct = registry.get(provider);
+    if (direct)
+        return { adapter: direct, provider };
+    // Claude is always registered by registerDefaults; treat as the safe fallback.
+    const claude = registry.get('claude');
+    if (claude)
+        return { adapter: claude, provider: 'claude' };
+    throw new Error(`No agent-core adapter available for provider "${provider}" and no "claude" fallback registered.`);
+}
+//# sourceMappingURL=default-adapter-factory.js.map

package/dist/agent/session/default-adapter-factory.js.map

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

package/dist/agent/session/headless-types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Inspect-AI-compatible types for `collectTrajectory` (and previously
+ * `runAgent`).
+ *
+ * Schema is locked. External eval harnesses (Inspect AI, SWE-bench
+ * runners, custom benchmark scripts) consume `AgentTrajectory` directly
+ * without conversion. If their contract drifts, write an adapter — don't
+ * refactor this shape.
+ *
+ * Per AGENT-PROCESS-CONSOLIDATION-ADR §C2 these moved from `src/headless/
+ * types.ts` to live alongside `AgentProcess`. The `src/headless/types.ts`
+ * module still re-exports them as a thin shim until Phase 5 deletes the
+ * `headless/` directory.
+ */
+export interface WorkspaceConfig {
+    /** Absolute path to the project workspace (where `mcp.json` + `.claude/skills/` live). */
+    rootDir: string;
+    /** Optional override for `factory.yaml` path (forwarded to subprocess adapters). */
+    factoryYamlPath?: string;
+    /** Extra env vars passed to subprocess adapters (CLI providers). */
+    env?: Record<string, string>;
+}
+export interface AgentTask {
+    /** Human-readable task statement. Becomes the first user message. */
+    prompt: string;
+    /** Optional system-prompt prefix (rendered before the skills block). */
+    systemPrompt?: string;
+    /**
+     * Allowed built-in tools. Intersected with skill `allowed-tools`
+     * constraints. MCP-discovered tools are added unconditionally.
+     */
+    allowedTools?: string[];
+    /** Model identifier (e.g. 'claude-sonnet-4-6', 'gpt-4o', 'gemini-2.5-pro'). */
+    model: string;
+    /** Provider hint: 'anthropic-cli' | 'anthropic-api' | 'openai-api' | ... */
+    provider?: string;
+    /** Max tokens per assistant turn. */
+    maxTokens?: number;
+    /** Sampling temperature. */
+    temperature?: number;
+    /**
+     * Optional task ID for trace correlation — surfaced as `anvil.task_id`
+     * on every `gen_ai.invoke` span emitted within this run.
+     */
+    taskId?: string;
+}
+export interface TrajectoryMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    /** Tool name when role === 'tool'. */
+    name?: string;
+    /** Originating assistant tool_call id when role === 'tool'. */
+    toolCallId?: string;
+}
+export interface TrajectoryToolCall {
+    callId: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    durationMs: number;
+}
+export interface TrajectoryUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface AgentTrajectory {
+    messages: TrajectoryMessage[];
+    toolCalls: TrajectoryToolCall[];
+    /** Concrete model the run resolved to (post-fallback). */
+    model: string;
+    /** Aggregated across every LLM call in the run. */
+    usage: TrajectoryUsage;
+    /** Aggregated USD cost across every LLM call. */
+    costUsd: number;
+    /** Final assistant text (after the last non-tool turn). */
+    finalAnswer: string;
+    finishReason: 'end' | 'tool-use' | 'length' | 'error';
+    /** Populated only when finishReason === 'error'. */
+    error?: string;
+    durationMs: number;
+}
+//# sourceMappingURL=headless-types.d.ts.map

package/dist/agent/session/headless-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-types.d.ts","sourceRoot":"","sources":["../../../src/agent/session/headless-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IAEf,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IAEd,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,KAAK,EAAE,eAAe,CAAC;IACvB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtD,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/agent/session/headless-types.js

@@ -0,0 +1,16 @@
+/**
+ * Inspect-AI-compatible types for `collectTrajectory` (and previously
+ * `runAgent`).
+ *
+ * Schema is locked. External eval harnesses (Inspect AI, SWE-bench
+ * runners, custom benchmark scripts) consume `AgentTrajectory` directly
+ * without conversion. If their contract drifts, write an adapter — don't
+ * refactor this shape.
+ *
+ * Per AGENT-PROCESS-CONSOLIDATION-ADR §C2 these moved from `src/headless/
+ * types.ts` to live alongside `AgentProcess`. The `src/headless/types.ts`
+ * module still re-exports them as a thin shim until Phase 5 deletes the
+ * `headless/` directory.
+ */
+export {};
+//# sourceMappingURL=headless-types.js.map

package/dist/agent/session/headless-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-types.js","sourceRoot":"","sources":["../../../src/agent/session/headless-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/agent/session/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `@esankhan3/anvil-agent-core/agent/session` — barrel exports for the agent-lifecycle
+ * layer. agent-core is the canonical source of truth for `AgentManager`
+ * (registry of many) and `AgentProcess` (one logical agent).
+ */
+export { AgentProcess, emptyCost, generateSessionId, appendOutput, pushActivity, accumulateCost, type AgentProcessOpts, } from './session.js';
+export { AgentManager, type AgentManagerOpts, } from './session-registry.js';
+export type { AgentAdapter, AgentAdapterEvents, AgentAdapterFactory, AdapterRequest, } from './adapter.js';
+export { buildAdapterRequest } from './adapter.js';
+export { LanguageModelBridge } from './language-model-bridge.js';
+export { defaultAdapterFactory, defaultAdapterFactoryFn, resolveProvider, } from './default-adapter-factory.js';
+export type { AdapterCapabilities, AdapterCostInfo, PromptAwareAdapter, } from './legacy-adapter-types.js';
+export { runWithAgent, type RunWithAgentOptions, type RunWithAgentResult, } from './run-with-agent.js';
+export { collectTrajectory, type CollectTrajectoryOptions, } from './collect-trajectory.js';
+export type { AgentTask, AgentTrajectory, TrajectoryMessage, TrajectoryToolCall, TrajectoryUsage, WorkspaceConfig, } from './headless-types.js';
+export type { AgentActivity, AgentCheckpointHook, AgentCostHook, AgentManagerEvents, AgentProcessEvents, AgentState, AgentStatus, CostInfo, SpawnConfig, } from './types.js';
+export { AgentNotFoundError, SessionResumeNotSupportedError, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,kBAAkB,EAClB,8BAA8B,GAC/B,MAAM,YAAY,CAAC"}

package/dist/agent/session/index.js

@@ -0,0 +1,20 @@
+/**
+ * `@esankhan3/anvil-agent-core/agent/session` — barrel exports for the agent-lifecycle
+ * layer. agent-core is the canonical source of truth for `AgentManager`
+ * (registry of many) and `AgentProcess` (one logical agent).
+ */
+export { AgentProcess, emptyCost, generateSessionId, appendOutput, pushActivity, accumulateCost, } from './session.js';
+export { AgentManager, } from './session-registry.js';
+export { buildAdapterRequest } from './adapter.js';
+// Default factory + bridge (the concrete production adapter resolution path).
+export { LanguageModelBridge } from './language-model-bridge.js';
+export { defaultAdapterFactory, defaultAdapterFactoryFn, resolveProvider, } from './default-adapter-factory.js';
+// Single-shot helper for callers that don't need the full AgentManager
+// registry (cli commands like diff, learn, migrate, test-gen).
+export { runWithAgent, } from './run-with-agent.js';
+// Eval-facing trajectory collector. Wraps an `AgentProcess` and aggregates
+// an Inspect-AI-shaped `AgentTrajectory`. Replaces the headless `runAgent`
+// per AGENT-PROCESS-CONSOLIDATION-ADR §C1.
+export { collectTrajectory, } from './collect-trajectory.js';
+export { AgentNotFoundError, SessionResumeNotSupportedError, } from './types.js';
+//# sourceMappingURL=index.js.map