tracegrove 0.0.0-stage → 0.3.0

package/dist/adapters/http/driver.js.map

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

package/dist/adapters/job/capabilities.d.ts

@@ -0,0 +1,45 @@
+export declare const NATIVE_JOB_RUNNER_CAPABILITIES: {
+    ref: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    };
+    operations: string[];
+    oracles: string[];
+    fixtureOperations: string[];
+    faultOperations: string[];
+    variableCaptureFormats: string[];
+    cleanupOperations: string[];
+    maxStepsPerCase: number;
+    environmentClasses: ("isolated_candidate" | "deployed_preview" | "deployed_canary" | "production_observation")[];
+    captureFormats: string[];
+    surfacePackRefs: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    }[];
+    hostConstraintRef: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    } | null;
+    cancellation: "confirmed" | "best_effort";
+    protocol: "native_job" | "http" | "integration" | "mcp" | "mcp_widget" | "playwright" | "cdp" | "computer_use" | "mobile";
+    conformanceReceiptRef: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    } | null;
+};

package/dist/adapters/job/capabilities.js

@@ -0,0 +1,8 @@
+import { RunnerCapabilities, digestOfValue, parseAs } from "../../protocol/index.js";
+import { HTTP_RUNNER_CAPABILITIES } from "../http/capabilities.js";
+const ref = { id: 'tracegrove.runner.native-job', revision: '0.1.0' };
+const capabilities = { ...HTTP_RUNNER_CAPABILITIES,
+    operations: [...HTTP_RUNNER_CAPABILITIES.operations, 'job.submit', 'job.observe', 'job.cancel'],
+    oracles: [...HTTP_RUNNER_CAPABILITIES.oracles, 'job.observation/1'], protocol: 'native_job' };
+export const NATIVE_JOB_RUNNER_CAPABILITIES = parseAs(RunnerCapabilities, { ...capabilities, ref: { ...ref, digest: digestOfValue({ ...capabilities, ref }) } }, 'native job runner');
+//# sourceMappingURL=capabilities.js.map

package/dist/adapters/job/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/adapters/job/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,8BAA8B,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACtE,MAAM,YAAY,GAAG,EAAE,GAAG,wBAAwB;IAChD,UAAU,EAAE,CAAC,GAAG,wBAAwB,CAAC,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC;IAC/F,OAAO,EAAE,CAAC,GAAG,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,QAAQ,EAAE,YAAqB,EAAE,CAAC;AACzG,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,mBAAmB,CAAC,CAAC"}

package/dist/adapters/job/driver.d.ts

@@ -0,0 +1,26 @@
+import type { ChildProcess } from 'node:child_process';
+import { NativeJobObservation, type NativeJobAction, type PredicateT } from '../../protocol/index.ts';
+import { Deadline } from '../../core/deadline.ts';
+import type { NativeJobSession } from './types.ts';
+export declare class NativeJobError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/** One attempt's bounded native channel. Credentials never enter an observation or log. */
+export declare class NativeJobDriver implements NativeJobSession {
+    private readonly channel;
+    private queues;
+    private pending;
+    private ready;
+    private markReady;
+    private failReady;
+    constructor(channel: ChildProcess);
+    private onMessage;
+    private onExit;
+    waitReady(deadline: Deadline, signal: AbortSignal): Promise<void>;
+    private bounded;
+    request(command: NativeJobAction, credential: string | null, deadline: Deadline, signal: AbortSignal): Promise<NativeJobObservation>;
+    observe(command: Extract<NativeJobAction, {
+        action: 'read';
+    }>, credential: string | null, predicate: PredicateT, pollIntervalMs: number, deadline: Deadline, signal: AbortSignal): Promise<NativeJobObservation>;
+}

package/dist/adapters/job/driver.js

@@ -0,0 +1,110 @@
+import { randomUUID } from 'node:crypto';
+import { NativeJobObservation, NativeJobReady, NativeJobRequest, NativeJobResponse, NativeJobResult, MAX_NATIVE_JOB_MESSAGE_BYTES } from "../../protocol/index.js";
+import { Deadline } from "../../core/deadline.js";
+import { pollObservation } from "../poll.js";
+import { monotonicMs } from "../../core/clock.js";
+import { evaluatePredicate } from "../../core/reducer.js";
+export class NativeJobError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'NativeJobError';
+    }
+}
+/** One attempt's bounded native channel. Credentials never enter an observation or log. */
+export class NativeJobDriver {
+    channel;
+    queues = new Set();
+    pending = new Map();
+    ready;
+    markReady;
+    failReady;
+    constructor(channel) {
+        this.channel = channel;
+        this.ready = new Promise((done, fail) => { this.markReady = done; this.failReady = fail; });
+        void this.ready.catch(() => undefined);
+        channel.on('message', this.onMessage);
+        channel.once('exit', this.onExit);
+        channel.once('error', this.onExit);
+    }
+    onMessage = (message) => {
+        if (!message || typeof message !== 'object')
+            return;
+        const wrapper = message;
+        if (wrapper.kind !== 'host.job')
+            return;
+        if (Buffer.byteLength(JSON.stringify(wrapper.message) ?? '') > MAX_NATIVE_JOB_MESSAGE_BYTES)
+            return;
+        const ready = NativeJobReady.safeParse(wrapper.message);
+        if (ready.success) {
+            this.queues = new Set(ready.data.queues);
+            this.markReady();
+            return;
+        }
+        const response = NativeJobResponse.safeParse(wrapper.message);
+        const id = wrapper.message?.id;
+        if (typeof id !== 'string')
+            return;
+        const pending = this.pending.get(id);
+        if (!pending)
+            return;
+        if (response.success)
+            pending.done(response.data.result);
+        else
+            pending.fail(new NativeJobError('native_job_response_invalid', 'Native job response did not match the admitted protocol'));
+    };
+    onExit = () => {
+        const error = new NativeJobError('transport_failure', 'Native job owner exited');
+        this.failReady(error);
+        for (const pending of this.pending.values())
+            pending.fail(error);
+        this.channel.off('message', this.onMessage);
+    };
+    async waitReady(deadline, signal) {
+        await this.bounded(this.ready, deadline, signal);
+    }
+    async bounded(operation, deadline, signal) {
+        const combined = deadline.signal(signal);
+        return new Promise((done, fail) => {
+            const abort = () => fail(new NativeJobError(signal.aborted ? 'cancelled' : 'deadline_exceeded', 'Native job operation interrupted'));
+            operation.then(done, fail).finally(() => combined.removeEventListener('abort', abort));
+            if (combined.aborted)
+                return abort();
+            combined.addEventListener('abort', abort, { once: true });
+        });
+    }
+    async request(command, credential, deadline, signal) {
+        if (signal.aborted || deadline.expired())
+            throw new NativeJobError(signal.aborted ? 'cancelled' : 'deadline_exceeded', 'Native job operation interrupted');
+        if (!this.queues.has(command.queue))
+            throw new NativeJobError('native_job_queue_unavailable', 'Native queue was not advertised by the application');
+        const request = NativeJobRequest.parse({ kind: 'tracegrove.job.request', id: randomUUID(), credential, command });
+        if (Buffer.byteLength(JSON.stringify(request)) > MAX_NATIVE_JOB_MESSAGE_BYTES)
+            throw new NativeJobError('native_job_request_too_large', 'Native job request exceeds the protocol limit');
+        const started = monotonicMs();
+        const response = new Promise((done, fail) => {
+            this.pending.set(request.id, { done, fail });
+            this.channel.send({ kind: 'host.job_request', request }, error => { if (error)
+                fail(new NativeJobError('transport_failure', 'Native job channel closed')); });
+        });
+        try {
+            const result = NativeJobResult.parse(await this.bounded(response, deadline, signal));
+            if (credential && JSON.stringify(result).includes(credential))
+                throw new NativeJobError('native_job_secret_echo', 'Native response echoed an issued credential; observation withheld');
+            if (result.jobId !== null && (command.action === 'submit' ? result.requestKey !== command.requestKey : result.jobId !== command.jobId))
+                throw new NativeJobError('native_job_identity_mismatch', 'Native job readback belongs to another request');
+            if (result.jobId === null && !['missing', 'forbidden', 'conflict'].includes(result.status))
+                throw new NativeJobError('native_job_identity_missing', 'Native job state has no resource identity');
+            return NativeJobObservation.parse({ ...result, kind: 'native_job', queue: command.queue, action: command.action, durationMs: Math.round(monotonicMs() - started), attempts: 1 });
+        }
+        finally {
+            this.pending.delete(request.id);
+        }
+    }
+    async observe(command, credential, predicate, pollIntervalMs, deadline, signal) {
+        return pollObservation({ read: () => this.request(command, credential, deadline, signal), accepts: observation => evaluatePredicate(predicate, { body: observation }).pass,
+            deadline, pollIntervalMs, signal, cancelled: () => new NativeJobError('cancelled', 'native job observation cancelled') });
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/adapters/job/driver.js.map

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

package/dist/adapters/job/types.d.ts

@@ -0,0 +1,9 @@
+import type { NativeJobAction, NativeJobObservation, PredicateT } from '../../protocol/index.ts';
+import type { Deadline } from '../../core/deadline.ts';
+/** Provider-neutral attempt port; transports own admission, correlation and cancellation. */
+export interface NativeJobSession {
+    request(command: NativeJobAction, credential: string | null, deadline: Deadline, signal: AbortSignal): Promise<NativeJobObservation>;
+    observe(command: Extract<NativeJobAction, {
+        action: 'read';
+    }>, credential: string | null, predicate: PredicateT, pollIntervalMs: number, deadline: Deadline, signal: AbortSignal): Promise<NativeJobObservation>;
+}

package/dist/adapters/job/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/job/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/job/types.ts"],"names":[],"mappings":""}

package/dist/adapters/mcp/capabilities.d.ts

@@ -0,0 +1,46 @@
+export declare function mcpSdkAvailable(): boolean;
+export declare const MCP_RUNNER_CAPABILITIES: {
+    ref: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    };
+    operations: string[];
+    oracles: string[];
+    fixtureOperations: string[];
+    faultOperations: string[];
+    variableCaptureFormats: string[];
+    cleanupOperations: string[];
+    maxStepsPerCase: number;
+    environmentClasses: ("isolated_candidate" | "deployed_preview" | "deployed_canary" | "production_observation")[];
+    captureFormats: string[];
+    surfacePackRefs: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    }[];
+    hostConstraintRef: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    } | null;
+    cancellation: "confirmed" | "best_effort";
+    protocol: "native_job" | "http" | "integration" | "mcp" | "mcp_widget" | "playwright" | "cdp" | "computer_use" | "mobile";
+    conformanceReceiptRef: {
+        id: string;
+        revision: string;
+        digest: {
+            algorithm: "sha256";
+            hex: string;
+        };
+    } | null;
+};

package/dist/adapters/mcp/capabilities.js

@@ -0,0 +1,17 @@
+import { RunnerCapabilities, digestOfValue, parseAs } from "../../protocol/index.js";
+import { HTTP_RUNNER_CAPABILITIES } from "../http/capabilities.js";
+import { createRequire } from 'node:module';
+export function mcpSdkAvailable() {
+    try {
+        createRequire(import.meta.url).resolve('@modelcontextprotocol/sdk/client/streamableHttp.js');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const ref = { id: 'tracegrove.runner.mcp', revision: '0.1.0' };
+const capabilities = { ...HTTP_RUNNER_CAPABILITIES, operations: [...HTTP_RUNNER_CAPABILITIES.operations, 'mcp.call'],
+    oracles: [...HTTP_RUNNER_CAPABILITIES.oracles, 'mcp.observation/1'], protocol: 'mcp' };
+export const MCP_RUNNER_CAPABILITIES = parseAs(RunnerCapabilities, { ...capabilities, ref: { ...ref, digest: digestOfValue({ ...capabilities, ref }) } }, 'MCP runner');
+//# sourceMappingURL=capabilities.js.map

package/dist/adapters/mcp/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/adapters/mcp/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,oDAAoD,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAClH,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACzB,CAAC;AAED,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,uBAAuB,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/D,MAAM,YAAY,GAAG,EAAE,GAAG,wBAAwB,EAAE,UAAU,EAAE,CAAC,GAAG,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC;IAClH,OAAO,EAAE,CAAC,GAAG,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,EAAE,QAAQ,EAAE,KAAc,EAAE,CAAC;AAClG,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,EAC/D,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC"}

package/dist/adapters/mcp/driver.d.ts

@@ -0,0 +1,10 @@
+import { McpToolCall, McpToolObservation } from '../../protocol/index.ts';
+import type { Deadline } from '../../core/deadline.ts';
+export declare const MAX_MCP_BYTES = 65536;
+/** One admitted call, no discovery effects, fallback transport, OAuth flow or retry. */
+export declare class McpDriver {
+    private readonly origin;
+    private readonly fetcher;
+    constructor(origin: string, fetcher?: typeof fetch);
+    call(raw: McpToolCall, credential: string | null, deadline: Deadline, parent: AbortSignal): Promise<McpToolObservation>;
+}

package/dist/adapters/mcp/driver.js

@@ -0,0 +1,83 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { McpToolCall, McpToolObservation } from "../../protocol/index.js";
+import { monotonicMs } from "../../core/clock.js";
+import { HttpStepError } from "../http/driver.js";
+export const MAX_MCP_BYTES = 65_536;
+/** One admitted call, no discovery effects, fallback transport, OAuth flow or retry. */
+export class McpDriver {
+    origin;
+    fetcher;
+    constructor(origin, fetcher = fetch) {
+        this.origin = origin;
+        this.fetcher = fetcher;
+    }
+    async call(raw, credential, deadline, parent) {
+        const command = McpToolCall.parse(raw);
+        const endpoint = new URL(command.endpoint, this.origin);
+        if (endpoint.origin !== this.origin || endpoint.pathname !== command.endpoint)
+            throw new HttpStepError('mcp_endpoint_invalid', 'MCP endpoint must stay on the admitted application origin');
+        if (Buffer.byteLength(JSON.stringify(command.arguments)) > MAX_MCP_BYTES)
+            throw new HttpStepError('mcp_request_too_large', 'MCP arguments exceed the admitted protocol limit');
+        const signal = deadline.signal(parent);
+        const started = monotonicMs();
+        const client = new Client({ name: 'tracegrove', version: '0.2.0' }, { capabilities: {} });
+        let exceeded = false;
+        const transport = new StreamableHTTPClientTransport(endpoint, {
+            requestInit: { ...(credential ? { headers: { authorization: `Bearer ${credential}` } } : {}), redirect: 'error' },
+            reconnectionOptions: { maxRetries: 0, initialReconnectionDelay: 1, maxReconnectionDelay: 1, reconnectionDelayGrowFactor: 1 },
+            fetch: async (url, init) => {
+                if (new URL(String(url)).href !== endpoint.href)
+                    throw new Error('MCP request left its endpoint');
+                if (typeof init?.body === 'string' && Buffer.byteLength(init.body) > MAX_MCP_BYTES)
+                    throw new HttpStepError('mcp_request_too_large', 'MCP wire request exceeds the protocol limit');
+                const response = await this.fetcher(url, { ...init, redirect: 'error', signal: init?.signal ? AbortSignal.any([signal, init.signal]) : signal });
+                if (!response.body)
+                    return response;
+                let bytes = 0;
+                const body = response.body.pipeThrough(new TransformStream({ transform(chunk, controller) {
+                        bytes += chunk.byteLength;
+                        if (bytes > MAX_MCP_BYTES) {
+                            exceeded = true;
+                            throw new Error('MCP response exceeds limit');
+                        }
+                        controller.enqueue(chunk);
+                    } }));
+                return new Response(body, { status: response.status, statusText: response.statusText, headers: response.headers });
+            },
+        });
+        try {
+            const options = { signal, timeout: Math.max(1, deadline.remainingMs()) };
+            // SDK 1.32's sessionId getter includes undefined; its Transport declaration omits it.
+            await client.connect(transport, options);
+            const server = client.getServerVersion();
+            if (!client.getServerCapabilities()?.tools || !server || !transport.protocolVersion)
+                throw new HttpStepError('mcp_capability_missing', 'Server did not establish tool capability and protocol identity');
+            const result = await client.callTool({ name: command.tool, arguments: command.arguments }, undefined, { signal, timeout: Math.max(1, deadline.remainingMs()) });
+            const observation = McpToolObservation.parse({ kind: 'mcp_tool', endpoint: command.endpoint, tool: command.tool,
+                protocolVersion: transport.protocolVersion, server: { name: server.name, version: server.version },
+                isError: result.isError ?? false, content: result.content, structuredContent: result.structuredContent ?? null,
+                durationMs: Math.round(monotonicMs() - started), attempts: 1 });
+            const serialized = JSON.stringify(observation);
+            if (Buffer.byteLength(serialized) > MAX_MCP_BYTES)
+                throw new HttpStepError('mcp_response_invalid', 'MCP observation exceeds the protocol limit');
+            if (credential && serialized.includes(JSON.stringify(credential).slice(1, -1)))
+                throw new HttpStepError('mcp_secret_echo', 'MCP response echoed an issued credential; observation withheld');
+            return observation;
+        }
+        catch (error) {
+            if (parent.aborted)
+                throw new HttpStepError('cancelled', 'MCP call cancelled; remote side effects remain unknown');
+            if (signal.aborted || deadline.expired() || (error instanceof McpError && error.code === ErrorCode.RequestTimeout))
+                throw new HttpStepError('deadline_exceeded', 'MCP call exceeded its deadline; remote side effects remain unknown');
+            if (error instanceof HttpStepError)
+                throw error;
+            throw new HttpStepError(exceeded ? 'mcp_response_invalid' : 'mcp_protocol_failure', 'MCP protocol failed; no tool retry was attempted and remote side effects remain unknown');
+        }
+        finally {
+            await client.close().catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/adapters/mcp/driver.js.map

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

package/dist/adapters/poll.d.ts

@@ -0,0 +1,12 @@
+import { Deadline } from '../core/deadline.ts';
+/** A timeout cannot erase a completed readback; transport errors and cancellation stay failures. */
+export declare function pollObservation<T extends {
+    attempts: number;
+}>(options: {
+    read: () => Promise<T>;
+    accepts: (observation: T) => boolean;
+    deadline: Deadline;
+    pollIntervalMs: number;
+    signal?: AbortSignal | undefined;
+    cancelled: () => Error;
+}): Promise<T>;

package/dist/adapters/poll.js

@@ -0,0 +1,31 @@
+import { Deadline, sleep } from "../core/deadline.js";
+/** A timeout cannot erase a completed readback; transport errors and cancellation stay failures. */
+export async function pollObservation(options) {
+    let attempts = 0;
+    let last = null;
+    while (true) {
+        if (options.signal?.aborted)
+            throw options.cancelled();
+        if (last && options.deadline.expired())
+            return last;
+        try {
+            attempts++;
+            last = await options.read();
+            last.attempts = attempts;
+            if (options.accepts(last) || options.deadline.remainingMs() <= options.pollIntervalMs)
+                return last;
+            await sleep(options.pollIntervalMs, options.deadline.signal(options.signal));
+        }
+        catch (error) {
+            if (options.signal?.aborted)
+                throw options.cancelled();
+            const timeout = error instanceof Error && (error.name === 'TimeoutError' || error.code === 'deadline_exceeded');
+            if (last && timeout && options.deadline.expired()) {
+                last.attempts = attempts;
+                return last;
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=poll.js.map

package/dist/adapters/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../../src/adapters/poll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEtD,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,eAAe,CAAiC,OAGrE;IACC,IAAI,QAAQ,GAAG,CAAC,CAAC;IAAC,IAAI,IAAI,GAAa,IAAI,CAAC;IAC5C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;QACvD,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE;YAAE,OAAO,IAAI,CAAC;QACpD,IAAI,CAAC;YACH,QAAQ,EAAE,CAAC;YAAC,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAClE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,cAAc;gBAAE,OAAO,IAAI,CAAC;YACnG,MAAM,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;gBAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAK,KAAmC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;YAC/I,IAAI,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YAC7F,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/authoring/activity.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { StepEvent } from '../protocol/index.ts';
+/** Local progress is an observation, never execution or qualification evidence. */
+export declare const RunActivity: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        running: "running";
+        idle: "idle";
+        finished: "finished";
+    }>;
+    event: z.ZodNullable<z.ZodString>;
+    stepId: z.ZodNullable<z.ZodString>;
+    label: z.ZodString;
+    observedAt: z.ZodString;
+}, z.core.$strict>;
+export type RunActivity = z.infer<typeof RunActivity>;
+export declare function runActivity(event: Pick<StepEvent, 'kind' | 'stepId' | 'at'>): RunActivity;

package/dist/authoring/activity.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+/** Local progress is an observation, never execution or qualification evidence. */
+export const RunActivity = z.object({
+    status: z.enum(['idle', 'running', 'finished', 'failed']),
+    event: z.string().nullable(), stepId: z.string().nullable(),
+    label: z.string(), observedAt: z.string().datetime(),
+}).strict();
+export function runActivity(event) {
+    const label = event.kind.startsWith('cleanup.') ? 'Cleaning up owned resources'
+        : event.kind.startsWith('fixture.') ? 'Preparing and checking fixtures'
+            : event.kind.startsWith('step.') ? `Running scenarios${event.stepId ? ` · ${event.stepId}` : ''}`
+                : event.kind === 'cell.finalized' ? 'Finalizing and checking evidence'
+                    : event.kind === 'host.started' ? 'Checking application identity'
+                        : event.kind === 'host.failed' ? 'Application startup failed; cleanup continues'
+                            : 'Running verification';
+    return RunActivity.parse({ status: 'running', event: event.kind, stepId: event.stepId, label, observedAt: event.at });
+}
+//# sourceMappingURL=activity.js.map

package/dist/authoring/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/authoring/activity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,MAAM,UAAU,WAAW,CAAC,KAAgD;IAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,6BAA6B;QAC7E,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,iCAAiC;YACvE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,oBAAoB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;gBACjG,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,kCAAkC;oBACtE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,+BAA+B;wBACjE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,+CAA+C;4BAChF,CAAC,CAAC,sBAAsB,CAAC;IAC3B,OAAO,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AACxH,CAAC"}

package/dist/authoring/agent.d.ts

@@ -0,0 +1,70 @@
+import { type AgentProvider, type AuthoringConfig } from './schema.ts';
+import type { Discovery } from './discover.ts';
+export { SETTINGS_FILE, LocalSettings, settingsPath, readLocalSettings, writeLocalSettings } from './localSettings.ts';
+/** Explicit low-cost defaults from workspace policy; never inherit the CLI's production model. */
+export declare const DEFAULT_MODELS: Record<AgentProvider, string | null>;
+/** Claude Code takes dashed ids (claude-haiku-5-5); a dotted version is a common typo, not a different model. */
+export declare function normalizeModel(provider: AgentProvider, model: string | null): string | null;
+export type AgentSettings = {
+    provider: AgentProvider;
+    model: string | null;
+    maxBudgetUsd: number | null;
+    source: Record<'provider' | 'model', 'flag' | 'settings' | 'config' | 'default'>;
+};
+export type AgentOverrides = {
+    provider?: string | null | undefined;
+    model?: string | null | undefined;
+};
+/** Precedence: CLI flag, then .tracegrove/settings.json (per developer), then the config, then defaults. */
+export declare function resolveAgentSettings(root: string, config: AuthoringConfig | null, overrides?: AgentOverrides): AgentSettings;
+/** Which agent CLIs are on PATH. */
+export declare function detectAgents(pathEnv?: string): Record<'claude' | 'codex', string | null>;
+/** The JSON Schemas shipped with this tracegrove build (dist/authoring or src/authoring → ../../schema). */
+export declare function schemaDir(): string;
+/** How the agent should invoke this same tracegrove build. */
+export declare function tracegroveCommand(): string[];
+export type AgentCommand = {
+    bin: string;
+    args: string[];
+};
+export declare function buildAgentCommand(settings: AgentSettings, prompt: string, tracegrove?: string[]): AgentCommand;
+export declare function buildDraftPrompt(input: {
+    root: string;
+    testDir: string;
+    discovery: Discovery;
+    intent: string | null;
+    config: AuthoringConfig | null;
+    tracegrove?: string[];
+}): string;
+export type AgentRunResult = {
+    provider: AgentProvider;
+    model: string | null;
+    modelFallback?: {
+        from: string | null;
+        to: string;
+    };
+    exitCode: number;
+    files: string[];
+    output: string;
+    command: string[];
+};
+/** The final answer from Claude Code output: one JSON object, or the `result` event of stream-json. */
+export declare function claudeResult(output: string): string | null;
+/** Human-sized lines for live progress: what the agent is reading, editing, running or saying. */
+export declare function describeAgentLine(line: string): string[];
+/**
+ * The agent runs as its own session in `root`. When tracegrove itself is driven from inside a
+ * Claude Code session, the inherited session ids would attach the child to the parent's session
+ * and its working folder, so those are dropped; credentials and proxy settings are kept.
+ */
+export declare function agentEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** Run the agent in `root`, then report which flow files it created or changed. */
+export declare function runAgent(input: {
+    root: string;
+    testDir: string;
+    settings: AgentSettings;
+    prompt: string;
+    onOutput?: (chunk: string) => void;
+    onActivity?: (line: string) => void;
+    signal?: AbortSignal;
+}): Promise<AgentRunResult>;