@esankhan3/anvil-agent-core 0.1.0

package/dist/agent/session/__tests__/spawn-telemetry.test.js

@@ -0,0 +1,135 @@
+/**
+ * Phase 6 of AGENT-PROCESS-CONSOLIDATION — verify `defaultAdapterFactory`
+ * surfaces skill + MCP discovery as attributes on the active session span.
+ *
+ * Three cases:
+ *   1. workspace with .claude/skills/foo/SKILL.md → session span carries
+ *      anvil.skills.activated.count + .names.
+ *   2. workspace with no skills + no mcp.json → no attrs (absence-stays-
+ *      absent per observability ADR §O7).
+ *   3. workspace with mcp.json → anvil.mcp.servers.count set.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtempSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { trace, context as otelContext } from '@opentelemetry/api';
+import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
+import { InMemorySpanExporter, SimpleSpanProcessor, } from '@opentelemetry/sdk-trace-base';
+import { resourceFromAttributes } from '@opentelemetry/resources';
+import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+import { resetTracer, getTracer } from '../../../telemetry/tracer.js';
+import { enrichRequestWithWorkspace } from '../default-adapter-factory.js';
+let exporter;
+let provider;
+async function installInMemoryExporter() {
+    await resetTracer();
+    exporter = new InMemorySpanExporter();
+    provider = new NodeTracerProvider({
+        resource: resourceFromAttributes({ [ATTR_SERVICE_NAME]: 'anvil-spawn-telemetry-test' }),
+        spanProcessors: [new SimpleSpanProcessor(exporter)],
+    });
+    provider.register();
+}
+async function uninstallInMemoryExporter() {
+    try {
+        await provider.forceFlush();
+        await provider.shutdown();
+    }
+    catch {
+        /* best-effort */
+    }
+    exporter.reset();
+    trace.disable();
+}
+function makeRequest(overrides = {}) {
+    return {
+        prompt: 'do thing',
+        model: 'qwen2.5-coder:7b',
+        sessionId: 'sess-test',
+        cwd: '/tmp',
+        ...overrides,
+    };
+}
+function makeWorkspaceWithSkill() {
+    const dir = mkdtempSync(join(tmpdir(), 'anvil-skill-tel-'));
+    const skillDir = join(dir, '.claude', 'skills', 'tel-skill');
+    mkdirSync(skillDir, { recursive: true });
+    writeFileSync(join(skillDir, 'SKILL.md'), '---\nname: tel-skill\ndescription: Telemetry test skill.\n---\n\n# Body\n');
+    return { dir, cleanup: () => rmSync(dir, { recursive: true, force: true }) };
+}
+function makeWorkspaceWithMcp() {
+    const dir = mkdtempSync(join(tmpdir(), 'anvil-mcp-tel-'));
+    writeFileSync(join(dir, 'mcp.json'), JSON.stringify({ mcpServers: { tel: { command: 'echo', args: ['hi'] } } }));
+    return { dir, cleanup: () => rmSync(dir, { recursive: true, force: true }) };
+}
+function makeEmptyWorkspace() {
+    const dir = mkdtempSync(join(tmpdir(), 'anvil-empty-tel-'));
+    return { dir, cleanup: () => rmSync(dir, { recursive: true, force: true }) };
+}
+/**
+ * Run `enrichRequestWithWorkspace` inside a parent span so the factory can
+ * observe an active span via `trace.getActiveSpan()`. Returns the recorded
+ * span by name.
+ */
+function runUnderParentSpan(name, fn) {
+    const tracer = getTracer();
+    const span = tracer.startSpan(name);
+    const ctx = trace.setSpan(otelContext.active(), span);
+    otelContext.with(ctx, fn);
+    span.end();
+    const found = exporter.getFinishedSpans().find((s) => s.name === name);
+    if (!found) {
+        throw new Error(`Expected to find span "${name}"; got ${exporter.getFinishedSpans().map((s) => s.name).join(', ')}`);
+    }
+    return found;
+}
+describe('defaultAdapterFactory telemetry', () => {
+    beforeEach(installInMemoryExporter);
+    afterEach(uninstallInMemoryExporter);
+    it('skills present: anvil.skills.activated.count + .names on active span', () => {
+        const ws = makeWorkspaceWithSkill();
+        try {
+            const span = runUnderParentSpan('test.session', () => {
+                enrichRequestWithWorkspace(makeRequest({ workspaceDir: ws.dir, model: 'qwen2.5-coder:7b' }), 'ollama');
+            });
+            assert.equal(span.attributes['anvil.skills.activated.count'], 1);
+            const names = span.attributes['anvil.skills.activated.names'];
+            assert.ok(names && names.includes('tel-skill'), `expected names attr to include 'tel-skill', got "${names}"`);
+        }
+        finally {
+            ws.cleanup();
+        }
+    });
+    it('empty workspace: no skill attrs (absence stays absent)', () => {
+        const ws = makeEmptyWorkspace();
+        try {
+            const span = runUnderParentSpan('test.session', () => {
+                enrichRequestWithWorkspace(makeRequest({ workspaceDir: ws.dir, model: 'qwen2.5-coder:7b' }), 'ollama');
+            });
+            assert.equal(span.attributes['anvil.skills.activated.count'], undefined);
+            assert.equal(span.attributes['anvil.skills.activated.names'], undefined);
+            // Note: anvil.mcp.servers.count may still appear if the user has a
+            // global ~/.claude/mcp.json (rank-5 fallback in findMcpConfigPath).
+            // We assert only on per-workspace skill-absence to keep the test
+            // robust across machines.
+        }
+        finally {
+            ws.cleanup();
+        }
+    });
+    it('mcp present: anvil.mcp.servers.count surfaces on active span', () => {
+        const ws = makeWorkspaceWithMcp();
+        try {
+            const span = runUnderParentSpan('test.session', () => {
+                enrichRequestWithWorkspace(makeRequest({ workspaceDir: ws.dir, model: 'claude-sonnet-4-6' }), 'claude');
+            });
+            assert.equal(span.attributes['anvil.mcp.servers.count'], 1);
+        }
+        finally {
+            ws.cleanup();
+        }
+    });
+});
+//# sourceMappingURL=spawn-telemetry.test.js.map

package/dist/agent/session/__tests__/spawn-telemetry.test.js.map

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

package/dist/agent/session/__tests__/types.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type-shape lock for agent-core's canonical agent-lifecycle surface.
+ *
+ * Asserts (compile time + a thin runtime shim) that the public types match
+ * the dashboard's pre-Phase-4 shapes — every legacy field has a destination
+ * — so dashboard's call sites compile after dropping their re-export shims.
+ */
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/agent/session/__tests__/types.test.d.ts.map

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

package/dist/agent/session/__tests__/types.test.js

@@ -0,0 +1,220 @@
+/**
+ * Type-shape lock for agent-core's canonical agent-lifecycle surface.
+ *
+ * Asserts (compile time + a thin runtime shim) that the public types match
+ * the dashboard's pre-Phase-4 shapes — every legacy field has a destination
+ * — so dashboard's call sites compile after dropping their re-export shims.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { EventEmitter } from 'node:events';
+import { AgentManager, AgentNotFoundError, AgentProcess, SessionResumeNotSupportedError, emptyCost, } from '../index.js';
+// Minimal fake adapter for the type-shape locks. Not exercised; only
+// satisfies the `adapterFactory` constructor argument.
+class NoopAdapter extends EventEmitter {
+    start() { }
+    kill() { }
+}
+const noopFactory = () => new NoopAdapter();
+// ── 1. SpawnConfig parity ───────────────────────────────────────────────
+describe('SpawnConfig — dashboard parity', () => {
+    it('accepts every field dashboard sets today', () => {
+        const spec = {
+            name: 'engineer-build-backend',
+            persona: 'engineer',
+            project: 'demo',
+            stage: 'build',
+            prompt: 'Implement the new auth flow',
+            model: 'claude-3-5-sonnet',
+            cwd: '/tmp/workspace',
+            projectPrompt: 'You are working on Anvil.',
+            permissionMode: 'auto',
+            disallowedTools: ['Write', 'Edit'],
+            allowedTools: ['Read', 'Grep'],
+            maxOutputTokens: 16000,
+            runId: 'run-123',
+            runFamily: 'run-123',
+        };
+        assert.equal(spec.name, 'engineer-build-backend');
+        assert.equal(spec.cwd, '/tmp/workspace');
+        assert.equal(spec.maxOutputTokens, 16000);
+    });
+    it('accepts cli-shape options (restart + timeout + binaryPath)', () => {
+        const spec = {
+            name: 'cli-stage',
+            persona: 'cli',
+            project: '',
+            stage: 'build',
+            prompt: '...',
+            model: 'gpt-4',
+            cwd: '/tmp',
+            restart: { maxAttempts: 2 },
+            timeoutMs: 600_000,
+            binaryPath: '/usr/local/bin/claude',
+            args: ['-p', 'extra'],
+        };
+        assert.equal(spec.restart?.maxAttempts, 2);
+        assert.equal(spec.timeoutMs, 600_000);
+    });
+});
+// ── 2. AgentState parity ────────────────────────────────────────────────
+describe('AgentState — dashboard parity', () => {
+    it('exposes the same 5-state status union', () => {
+        const states = [
+            'pending',
+            'running',
+            'done',
+            'error',
+            'killed',
+        ];
+        assert.equal(states.length, 5);
+    });
+    it('shape matches dashboard AgentState field-for-field', () => {
+        const state = {
+            id: 'a',
+            name: 'b',
+            persona: 'c',
+            sessionId: 'd',
+            model: 'e',
+            status: 'pending',
+            cost: emptyCost(),
+            output: '',
+            activities: [],
+            startedAt: null,
+            finishedAt: null,
+            error: null,
+        };
+        assert.equal(state.status, 'pending');
+        assert.equal(state.cost.totalUsd, 0);
+    });
+});
+// ── 3. Hooks accept the dashboard's existing hook shapes ────────────────
+describe('AgentCostHook + AgentCheckpointHook — dashboard parity', () => {
+    it('accepts dashboard-shaped cost hook', () => {
+        const hook = (info) => {
+            assert.ok(typeof info.usd === 'number');
+        };
+        hook({
+            runId: 'r',
+            project: 'p',
+            stage: 's',
+            agent: 'a',
+            persona: 'pe',
+            model: 'm',
+            tokensIn: 1,
+            tokensOut: 2,
+            cacheReadTokens: 0,
+            cacheWriteTokens: 0,
+            usd: 0.01,
+        });
+    });
+    it('accepts dashboard-shaped checkpoint hook', () => {
+        const hook = {
+            lookup() {
+                return { hit: false };
+            },
+        };
+        const result = hook.lookup({
+            project: 'p',
+            stage: 's',
+            persona: 'pe',
+            model: 'm',
+            prompt: 'hi',
+        });
+        assert.equal(result.hit, false);
+    });
+});
+// ── 4. Activity + cost types ────────────────────────────────────────────
+describe('AgentActivity + CostInfo', () => {
+    it('AgentActivity matches the dashboard shape', () => {
+        const activity = {
+            id: 'x',
+            kind: 'tool_use',
+            tool: 'Read',
+            summary: 'Read foo.ts',
+            timestamp: Date.now(),
+        };
+        assert.equal(activity.kind, 'tool_use');
+    });
+    it('emptyCost() returns zeroed CostInfo', () => {
+        const c = emptyCost();
+        assert.equal(c.totalUsd, 0);
+        assert.equal(c.inputTokens, 0);
+        assert.equal(c.outputTokens, 0);
+        assert.equal(c.cacheReadTokens, 0);
+        assert.equal(c.cacheWriteTokens, 0);
+        assert.equal(c.durationMs, 0);
+    });
+});
+// ── 5. Event shapes ─────────────────────────────────────────────────────
+describe('Event shapes', () => {
+    it('AgentProcessEvents has the 5 dashboard AgentProcessEvents', () => {
+        const events = [
+            'content',
+            'activity',
+            'result',
+            'error-output',
+            'exit',
+        ];
+        assert.equal(events.length, 5);
+    });
+    it('AgentManagerEvents has the 4 dashboard AgentManagerEvents', () => {
+        const events = [
+            'agent-output',
+            'agent-activity',
+            'agent-done',
+            'agent-error',
+        ];
+        assert.equal(events.length, 4);
+    });
+});
+// ── 6. Class construction ───────────────────────────────────────────────
+describe('AgentProcess construction', () => {
+    const spec = {
+        name: 't',
+        persona: 'p',
+        project: 'pr',
+        stage: 's',
+        prompt: '',
+        model: 'm',
+        cwd: '/tmp',
+    };
+    it('constructs with a pending state', () => {
+        const proc = new AgentProcess(spec, { adapterFactory: noopFactory });
+        assert.equal(proc.status, 'pending');
+        assert.equal(proc.output, '');
+    });
+    it('honors id override', () => {
+        const proc = new AgentProcess(spec, { adapterFactory: noopFactory, id: 'custom-id' });
+        assert.equal(proc.id, 'custom-id');
+        assert.equal(proc.sessionId, 'custom-id');
+    });
+    it('id defaults to a UUID v4', () => {
+        const proc = new AgentProcess(spec, { adapterFactory: noopFactory });
+        assert.match(proc.id, /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/);
+    });
+});
+describe('AgentManager construction', () => {
+    it('constructs and accepts hook setters', () => {
+        const mgr = new AgentManager({ adapterFactory: noopFactory });
+        mgr.setCostHook(() => { });
+        mgr.setCheckpointHook({ lookup: () => ({ hit: false }) });
+        assert.equal(mgr.getAgent('missing'), undefined);
+    });
+});
+// ── 7. Errors carry the right metadata ──────────────────────────────────
+describe('Errors', () => {
+    it('SessionResumeNotSupportedError carries provider + model', () => {
+        const err = new SessionResumeNotSupportedError('openai', 'gpt-4');
+        assert.equal(err.provider, 'openai');
+        assert.equal(err.model, 'gpt-4');
+        assert.match(err.message, /openai/);
+        assert.match(err.message, /gpt-4/);
+    });
+    it('AgentNotFoundError carries the agentId', () => {
+        const err = new AgentNotFoundError('agent-xyz');
+        assert.equal(err.agentId, 'agent-xyz');
+        assert.match(err.message, /agent-xyz/);
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/agent/session/__tests__/types.test.js.map

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

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

@@ -0,0 +1,108 @@
+/**
+ * `AgentAdapter` — minimal adapter contract `AgentSession` consumes.
+ *
+ * Mirrors the public surface of dashboard's `BaseAdapter` (EventEmitter +
+ * `start()` / `kill()` / `setMaxOutputTokens()`). Defining it in agent-core
+ * lets both consumers wire their own adapters:
+ *
+ *   - Dashboard injects its existing `BaseAdapter`-derived adapters
+ *     (claude / openai / etc.) which already satisfy this shape.
+ *   - cli (Phase 5) injects a thin wrapper that drives agent-core's
+ *     `LanguageModel.invokeStream()` and re-emits the same 5 events.
+ *
+ * The structural interface (vs a class) avoids forcing consumers to inherit
+ * from agent-core just to plug in.
+ */
+import type { EventEmitter } from 'node:events';
+import type { AgentActivity, CostInfo, SpawnConfig } from './types.js';
+/**
+ * The 5 events an adapter emits during a run. Same shape as dashboard's
+ * `AdapterEvents` (and dashboard's `AgentProcessEvents`).
+ */
+export interface AgentAdapterEvents {
+    content: (text: string) => void;
+    activity: (activity: AgentActivity) => void;
+    result: (data: {
+        result: string;
+        cost: CostInfo;
+        sessionId: string;
+    }) => void;
+    'error-output': (text: string) => void;
+    exit: (code: number | null) => void;
+}
+/**
+ * Public surface of an adapter `AgentSession` knows how to drive. We depend
+ * structurally on `EventEmitter` so consumers can subclass `EventEmitter`
+ * directly (the dashboard already does).
+ */
+export interface AgentAdapter extends EventEmitter {
+    /** Begin running. May spawn a subprocess, open a stream, etc. */
+    start(): void;
+    /** Stop running and release resources. Idempotent. */
+    kill(signal?: string): void;
+    /** Optional output-token ceiling. Adapters that don't honor it ignore it. */
+    setMaxOutputTokens?(n: number): void;
+    readonly pid?: number;
+    readonly killed?: boolean;
+}
+/**
+ * Options forwarded to the adapter factory when `AgentSession` builds its
+ * underlying adapter. Mirrors dashboard's `AgentProcessConfig` — a flattened
+ * subset of `SpawnConfig` plus a `resume` flag.
+ */
+export interface AdapterRequest {
+    prompt: string;
+    model: string;
+    sessionId: string;
+    cwd: string;
+    /** When true, the adapter resumes the prior session rather than starting fresh. */
+    resume?: boolean;
+    projectPrompt?: string;
+    permissionMode?: string;
+    disallowedTools?: string[];
+    allowedTools?: string[];
+    maxOutputTokens?: number;
+    /** Pipeline stage (e.g. 'requirements', 'build', 'spike'). Surfaces on
+     *  every span and metric so dashboards can slice by stage. */
+    stage?: string;
+    /** Agent persona (e.g. 'analyst', 'engineer'). Same. */
+    persona?: string;
+    /** Project the spawn belongs to. */
+    project?: string;
+    /** Run id grouping multiple spawns into one logical pipeline run. */
+    runId?: string;
+    /** When true, the adapter routes the call through the LocalExecutor's
+     *  single-slot FIFO. Set automatically by the SpawnConfig→AdapterRequest
+     *  mapping when the resolved model has `exclusive_slot:true` in
+     *  `~/.anvil/models.yaml`. */
+    exclusiveSlot?: boolean;
+    /** Workspace root forwarded from `SpawnConfig.workspaceDir`. Used by
+     *  `defaultAdapterFactory` to discover skills + MCP. Per AGENT-PROCESS-
+     *  CONSOLIDATION-ADR §C4. */
+    workspaceDir?: string;
+    /** Internal — populated by `defaultAdapterFactory` for the Claude path
+     *  when an `mcp.json` is discovered under `workspaceDir`. The bridge
+     *  forwards it to `ModelAdapterConfig.mcpConfigPath` so claude-cli
+     *  reads it via `--mcp-config <path>`. Not user-facing. */
+    claudeMcpConfigPath?: string;
+}
+/**
+ * Factory the registry uses to construct adapters per spawn. Keeps the
+ * adapter family out of agent-core's dependency graph.
+ *
+ * Consumers wire this once when constructing the registry:
+ *
+ *   const registry = new AgentSessionRegistry({
+ *     adapterFactory: (req) => createAdapter(req),
+ *   });
+ */
+export type AgentAdapterFactory = (req: AdapterRequest) => AgentAdapter;
+/**
+ * Convenience helper — constructs an `AdapterRequest` from a `SpawnConfig`
+ * plus a generated session id.
+ */
+export declare function buildAdapterRequest(spec: SpawnConfig, sessionId: string, opts?: {
+    resume?: boolean;
+    cwdOverride?: string;
+}): AdapterRequest;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/agent/session/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9E,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,iEAAiE;IACjE,KAAK,IAAI,IAAI,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6EAA6E;IAC7E,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;kEAC8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;kCAG8B;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;iCAE6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;+DAG2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,YAAY,CAAC;AAExE;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,cAAc,CAkBhB"}

package/dist/agent/session/adapter.js

@@ -0,0 +1,39 @@
+/**
+ * `AgentAdapter` — minimal adapter contract `AgentSession` consumes.
+ *
+ * Mirrors the public surface of dashboard's `BaseAdapter` (EventEmitter +
+ * `start()` / `kill()` / `setMaxOutputTokens()`). Defining it in agent-core
+ * lets both consumers wire their own adapters:
+ *
+ *   - Dashboard injects its existing `BaseAdapter`-derived adapters
+ *     (claude / openai / etc.) which already satisfy this shape.
+ *   - cli (Phase 5) injects a thin wrapper that drives agent-core's
+ *     `LanguageModel.invokeStream()` and re-emits the same 5 events.
+ *
+ * The structural interface (vs a class) avoids forcing consumers to inherit
+ * from agent-core just to plug in.
+ */
+/**
+ * Convenience helper — constructs an `AdapterRequest` from a `SpawnConfig`
+ * plus a generated session id.
+ */
+export function buildAdapterRequest(spec, sessionId, opts) {
+    return {
+        prompt: spec.prompt,
+        model: spec.model,
+        sessionId,
+        cwd: opts?.cwdOverride ?? spec.cwd,
+        resume: opts?.resume,
+        projectPrompt: spec.projectPrompt,
+        permissionMode: spec.permissionMode,
+        disallowedTools: spec.disallowedTools,
+        allowedTools: spec.allowedTools,
+        maxOutputTokens: spec.maxOutputTokens,
+        stage: spec.stage,
+        persona: spec.persona,
+        project: spec.project,
+        runId: spec.runId,
+        workspaceDir: spec.workspaceDir,
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/agent/session/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/agent/session/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuFH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAiB,EACjB,SAAiB,EACjB,IAAiD;IAEjD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS;QACT,GAAG,EAAE,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,GAAG;QAClC,MAAM,EAAE,IAAI,EAAE,MAAM;QACpB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC;AACJ,CAAC"}

package/dist/agent/session/collect-trajectory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `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 { type AgentProcessOpts } from './session.js';
+import type { AgentTask, AgentTrajectory, WorkspaceConfig } from './headless-types.js';
+export interface CollectTrajectoryOptions {
+    /** Abort-by-signal. When fired, calls `proc.kill()` and resolves with
+     *  `finishReason: 'error'`, `error: 'aborted'`. */
+    signal?: AbortSignal;
+    /** Wall-clock timeout in ms (default 600_000 — 10 minutes). */
+    timeoutMs?: number;
+    /**
+     * Optional override for the `AgentProcess` opts (factory injection,
+     * test seams). Production callers omit; tests use to inject scripted
+     * adapters.
+     */
+    processOpts?: Partial<AgentProcessOpts>;
+}
+/**
+ * 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 declare function collectTrajectory(task: AgentTask, workspace: WorkspaceConfig, opts?: CollectTrajectoryOptions): Promise<AgentTrajectory>;
+//# sourceMappingURL=collect-trajectory.d.ts.map

package/dist/agent/session/collect-trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-trajectory.d.ts","sourceRoot":"","sources":["../../../src/agent/session/collect-trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EAGf,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,wBAAwB;IACvC;uDACmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACzC;AAKD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,eAAe,EAC1B,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,eAAe,CAAC,CAmK1B"}