akribes 0.21.17

package/dist/sub/executions.d.ts

@@ -0,0 +1,255 @@
+import type { HttpClient } from '../http';
+import type { ContractState } from './clients';
+import type { RunResult, ExecutionStatus, ExecutionOutput, ExecutionEvents, S3DocumentRef, ScriptGraph, ScriptCost, ProjectCost } from '../types';
+import { type RunStream, type RunStreamEventsSource, type RunStreamOptions } from '../runStream';
+/** Summary of a child execution spawned via the `spawn_child_execution`
+ *  callback. Returned by `GET /executions/:id/children`. For v1 the parent
+ *  linkage columns are typically NULL; this type is forward-looking. */
+export type ExecutionChildSummary = {
+    id: string;
+    parent_node_id: string | null;
+    status: string;
+    started_at: string | null;
+    finished_at: string | null;
+    script_name: string;
+};
+/** Per-task cost / token breakdown row returned by
+ *  `GET /executions/:id/tasks`. Mirrors the shape produced by
+ *  `get_execution_tasks` in akribes-server: one row per `execution_tasks`
+ *  entry, populated as `TaskEnd` events arrive. */
+export type ExecutionTaskSummary = {
+    task_name: string;
+    model: string | null;
+    provider: string | null;
+    input_tokens: number;
+    output_tokens: number;
+    cached_input_tokens: number;
+    cache_write_input_tokens: number;
+    cost_usd: number | null;
+    duration_ms: number | null;
+    attempt: number;
+    finished_at: string;
+};
+/** Envelope returned by `GET /executions/:id/tasks`. */
+export type ExecutionTasksResponse = {
+    execution_id: string;
+    tasks: ExecutionTaskSummary[];
+};
+export declare class ExecutionsClient {
+    private http;
+    private projectId;
+    private defaultTriggeredBy;
+    private contractState?;
+    /** Lazy getter for the SSE source. Called on each `runStream()` call so
+     *  `AkribesClient` can instantiate both sub-clients without a circular init. */
+    private eventsSourceFactory?;
+    constructor(http: HttpClient, projectId: number, defaultTriggeredBy: string | undefined, contractState?: ContractState | undefined, 
+    /** Lazy getter for the SSE source. Called on each `runStream()` call so
+     *  `AkribesClient` can instantiate both sub-clients without a circular init. */
+    eventsSourceFactory?: (() => RunStreamEventsSource) | undefined);
+    private path;
+    /** Pre-dispatch validation: check contract state before sending the request.
+     *  Server is authoritative for per-input type checking; the client only
+     *  short-circuits on a known schema break. */
+    private validateContract;
+    run(scriptName: string, opts?: {
+        inputs?: Record<string, unknown>;
+        channel?: string;
+        triggeredBy?: string;
+        signal?: AbortSignal;
+        breakpointLines?: number[];
+        /** When true, MCP tool calls execute in dry-run mode (no side effects).
+         *  Server-side enforcement lands in Phase 4 (Task 38) — flag passes through today. */
+        dryRunTools?: boolean;
+    }): Promise<RunResult>;
+    /** Run a script with files uploaded via multipart form data. */
+    runWithUpload(scriptName: string, files: Record<string, {
+        filename: string;
+        data: Blob | File;
+    }>, opts?: {
+        channel?: string;
+        triggeredBy?: string;
+        signal?: AbortSignal;
+    }): Promise<RunResult>;
+    /** Run a script with documents referenced from S3. */
+    runWithS3(scriptName: string, inputs: Record<string, S3DocumentRef>, opts?: {
+        channel?: string;
+        triggeredBy?: string;
+        signal?: AbortSignal;
+    }): Promise<RunResult>;
+    get(executionId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ExecutionStatus | null>;
+    getOutput(executionId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ExecutionOutput | null>;
+    getEvents(executionId: string, opts?: {
+        afterId?: number;
+        limit?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecutionEvents | null>;
+    list(scriptName: string, options?: {
+        status?: string;
+        channel?: string;
+        limit?: number;
+        offset?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecutionStatus[]>;
+    /** List child executions spawned by this execution via the engine's
+     *  spawn_child_execution callback. Returns an empty array when no children
+     *  exist (the common case for v1 where parent linkage isn't yet wired). */
+    children(executionId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ExecutionChildSummary[]>;
+    /** Per-task cost / token / duration breakdown for an execution. Reads from
+     *  the `execution_tasks` table populated as `TaskEnd` events arrive. Useful
+     *  for monolith workflows where there are no spawned children — every
+     *  agent invocation lives in `execution_tasks` keyed by `task_name`. */
+    tasks(executionId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<ExecutionTasksResponse>;
+    cancel(executionId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    cancelRun(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** Cross-SDK naming alias for {@link cancelRun}. Mirrors the Python SDK's
+     *  `cancel_all`. Refs #109 (item 3: method-naming consistency). */
+    cancelAll(scriptName: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /**
+     * Resume a suspended checkpoint.
+     *
+     * For plain `checkpoint` resumes pass `data` (the payload that satisfies
+     * the checkpoint's schema). For tool-approval gates pass
+     * `{ approve: true|false, args_override? }`; the server builds the
+     * `{approve, args}` payload the engine's approval gate expects. (#729)
+     */
+    resume(executionId: string, token: string, data: unknown, opts?: {
+        signal?: AbortSignal;
+        approve?: boolean;
+        args_override?: unknown;
+    }): Promise<void>;
+    /** Poll until execution reaches a terminal state. */
+    waitFor(executionId: string, options?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecutionOutput>;
+    /**
+     * Poll an execution to completion and return its final output.
+     *
+     * Mirrors the Rust SDK's `await_execution`. Unlike {@link RunStream.output}
+     * (which only resolves for streams the caller initiated), this works for any
+     * `executionId` — including ones discovered via {@link list} or surfaced by
+     * another process.
+     *
+     * Defaults: 5-minute timeout. Pass `timeout: 0` to wait indefinitely. The
+     * optional `AbortSignal` short-circuits the poll loop and is forwarded to
+     * the underlying HTTP request.
+     *
+     * Throws {@link AkribesTransientError} on retryable failures (`RateLimit`,
+     * `ServerError`, `NetworkError`), {@link AkribesFatalError} on `AuthError` /
+     * `TokenLimit`, and {@link AkribesScriptError} for everything else (including
+     * cancellation).
+     */
+    await(executionId: string, opts?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecutionOutput>;
+    /** Cross-SDK naming alias for {@link await}. Mirrors the Rust SDK's
+     *  `await_execution`. Refs #109 (item 3: method-naming consistency). */
+    awaitExecution(executionId: string, opts?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecutionOutput>;
+    /** Cross-SDK naming alias for {@link await}. Mirrors the Python SDK's
+     *  `await_result`. Refs #109 (item 3: method-naming consistency). */
+    awaitResult(executionId: string, opts?: {
+        timeout?: number;
+        signal?: AbortSignal;
+    }): Promise<ExecutionOutput>;
+    /** Run a script from a specific point, with pre-seeded environment values.
+     * Skips nodes whose outputs are provided in seedEnv.
+     */
+    runFrom(scriptName: string, opts: {
+        seedEnv: Record<string, unknown>;
+        skipNodeIds: number[];
+        inputs?: Record<string, unknown>;
+        channel?: string;
+        triggeredBy?: string;
+        signal?: AbortSignal;
+    }): Promise<RunResult>;
+    /** Get the compiled execution DAG for a script. If versionId is omitted, uses the draft. */
+    getGraph(scriptName: string, opts?: {
+        versionId?: number;
+        signal?: AbortSignal;
+    }): Promise<ScriptGraph>;
+    /** Get cost aggregation for the entire project, optionally filtered by date range.
+     *  Rolls up: per-script totals, per-channel totals, and overall totals.
+     *  `unknown_cost_executions` counts runs whose model wasn't in the pricing
+     *  table; their tokens are still included, but they contribute `0` to cost.
+     */
+    getProjectCost(opts?: {
+        since?: string;
+        until?: string;
+        signal?: AbortSignal;
+    }): Promise<ProjectCost>;
+    /** Get cost aggregation for a script (total, avg, per-version, per-channel). */
+    getCost(scriptName: string, opts?: {
+        since?: string;
+        until?: string;
+        signal?: AbortSignal;
+    }): Promise<ScriptCost>;
+    /** Run a script and wait for the result. Returns [execution_id, output]. */
+    runAndAwait(scriptName: string, opts?: {
+        inputs?: Record<string, unknown>;
+        channel?: string;
+        triggeredBy?: string;
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+        signal?: AbortSignal;
+    }): Promise<[string, ExecutionOutput]>;
+    /**
+     * Start a run and return a {@link RunStream} lifecycle handle. The stream
+     * subscribes to events BEFORE issuing the run POST so no early events are
+     * missed. It's async-iterable, exposes `.output` / `.executionId` promises,
+     * and offers category-based `.on.<cat>()` callback registration.
+     *
+     * Requires the client was constructed with a `projectId` so the events
+     * sub-client is available.
+     */
+    runStream(scriptName: string, opts?: RunStreamOptions): RunStream;
+    /** Get document metadata by ID. */
+    getDocument(documentId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        id: string;
+        filename: string;
+        content_type: string;
+        size_bytes: number;
+        content_hash: string;
+        conversion_status: string;
+        conversion_error: string | null;
+        created_at: string;
+    } | null>;
+    /** Get converted markdown for a document. */
+    getDocumentMarkdown(documentId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        markdown: string;
+    }>;
+    /** Get a presigned download URL for the original document file. */
+    getDocumentUrl(documentId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
+    /** Retry conversion on a failed document. */
+    reconvertDocument(documentId: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        status: string;
+    }>;
+}
+//# sourceMappingURL=executions.d.ts.map

package/dist/sub/executions.d.ts.map

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

package/dist/sub/executions.js

@@ -0,0 +1,322 @@
+import { nullOn404 } from '../http';
+import { AkribesTransientError, AkribesFatalError, AkribesScriptError, AkribesTimeoutError, ScriptSchemaChangedError } from '../errors';
+import { createRunStream } from '../runStream';
+/** Default timeout for {@link ExecutionsClient.await} — 5 minutes. */
+const DEFAULT_AWAIT_TIMEOUT_MS = 5 * 60 * 1000;
+/** Sleep for `ms`, returning early if `signal` aborts. */
+function sleepUntilAborted(ms, signal) {
+    if (signal?.aborted)
+        return Promise.resolve();
+    return new Promise((resolve) => {
+        const t = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => { clearTimeout(t); resolve(); };
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+export class ExecutionsClient {
+    http;
+    projectId;
+    defaultTriggeredBy;
+    contractState;
+    eventsSourceFactory;
+    constructor(http, projectId, defaultTriggeredBy, contractState, 
+    /** Lazy getter for the SSE source. Called on each `runStream()` call so
+     *  `AkribesClient` can instantiate both sub-clients without a circular init. */
+    eventsSourceFactory) {
+        this.http = http;
+        this.projectId = projectId;
+        this.defaultTriggeredBy = defaultTriggeredBy;
+        this.contractState = contractState;
+        this.eventsSourceFactory = eventsSourceFactory;
+    }
+    path(scriptName, ...segments) {
+        return this.http.scriptPath(this.projectId, scriptName, ...segments);
+    }
+    /** Pre-dispatch validation: check contract state before sending the request.
+     *  Server is authoritative for per-input type checking; the client only
+     *  short-circuits on a known schema break. */
+    validateContract(scriptName) {
+        if (!this.contractState)
+            return;
+        if (this.contractState.brokenScripts.has(scriptName)) {
+            throw new ScriptSchemaChangedError(scriptName);
+        }
+    }
+    async run(scriptName, opts) {
+        this.validateContract(scriptName);
+        const channel = opts?.channel ?? 'production';
+        const url = `${this.path(scriptName, 'run')}?channel=${encodeURIComponent(channel)}`;
+        return (await this.http.fetchOk(url, {
+            method: 'POST', headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                inputs: opts?.inputs,
+                triggered_by: opts?.triggeredBy ?? this.defaultTriggeredBy,
+                breakpoint_lines: opts?.breakpointLines,
+                dry_run_tools: opts?.dryRunTools,
+            }),
+            signal: opts?.signal,
+        })).json();
+    }
+    /** Run a script with files uploaded via multipart form data. */
+    async runWithUpload(scriptName, files, opts) {
+        const channel = opts?.channel ?? 'production';
+        const url = `${this.path(scriptName, 'run', 'upload')}?channel=${encodeURIComponent(channel)}`;
+        const form = new FormData();
+        for (const [name, file] of Object.entries(files)) {
+            form.append(name, file.data, file.filename);
+        }
+        if (opts?.triggeredBy ?? this.defaultTriggeredBy) {
+            form.append('_meta', JSON.stringify({ triggered_by: opts?.triggeredBy ?? this.defaultTriggeredBy }));
+        }
+        return (await this.http.fetchOk(url, { method: 'POST', body: form, signal: opts?.signal })).json();
+    }
+    /** Run a script with documents referenced from S3. */
+    async runWithS3(scriptName, inputs, opts) {
+        const url = this.path(scriptName, 'run', 's3');
+        return (await this.http.fetchOk(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                inputs,
+                channel: opts?.channel ?? 'production',
+                triggered_by: opts?.triggeredBy ?? this.defaultTriggeredBy,
+            }),
+            signal: opts?.signal,
+        })).json();
+    }
+    async get(executionId, opts) {
+        return nullOn404(async () => (await this.http.fetchOk(`${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}`, opts)).json());
+    }
+    async getOutput(executionId, opts) {
+        return nullOn404(async () => (await this.http.fetchOk(`${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}/output`, opts)).json());
+    }
+    async getEvents(executionId, opts) {
+        const params = new URLSearchParams();
+        if (opts?.afterId != null)
+            params.set('after_id', String(opts.afterId));
+        if (opts?.limit != null)
+            params.set('limit', String(opts.limit));
+        const qs = params.toString();
+        const url = `${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}/events${qs ? `?${qs}` : ''}`;
+        return nullOn404(async () => (await this.http.fetchOk(url, { signal: opts?.signal })).json());
+    }
+    async list(scriptName, options) {
+        const params = new URLSearchParams();
+        if (options?.status)
+            params.set('status', options.status);
+        if (options?.channel)
+            params.set('channel', options.channel);
+        if (options?.limit != null)
+            params.set('limit', String(options.limit));
+        if (options?.offset != null)
+            params.set('offset', String(options.offset));
+        const qs = params.toString();
+        const url = `${this.path(scriptName, 'executions')}${qs ? '?' + qs : ''}`;
+        return (await this.http.fetchOk(url, { signal: options?.signal })).json();
+    }
+    /** List child executions spawned by this execution via the engine's
+     *  spawn_child_execution callback. Returns an empty array when no children
+     *  exist (the common case for v1 where parent linkage isn't yet wired). */
+    async children(executionId, opts) {
+        return (await this.http.fetchOk(`${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}/children`, opts)).json();
+    }
+    /** Per-task cost / token / duration breakdown for an execution. Reads from
+     *  the `execution_tasks` table populated as `TaskEnd` events arrive. Useful
+     *  for monolith workflows where there are no spawned children — every
+     *  agent invocation lives in `execution_tasks` keyed by `task_name`. */
+    async tasks(executionId, opts) {
+        return (await this.http.fetchOk(`${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}/tasks`, opts)).json();
+    }
+    async cancel(executionId, opts) {
+        await this.http.fetchOk(`${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}`, {
+            method: 'DELETE', signal: opts?.signal,
+        });
+    }
+    async cancelRun(scriptName, opts) {
+        await this.http.fetchOk(this.path(scriptName, 'run'), { method: 'DELETE', signal: opts?.signal });
+    }
+    /** Cross-SDK naming alias for {@link cancelRun}. Mirrors the Python SDK's
+     *  `cancel_all`. Refs #109 (item 3: method-naming consistency). */
+    async cancelAll(scriptName, opts) {
+        return this.cancelRun(scriptName, opts);
+    }
+    /**
+     * Resume a suspended checkpoint.
+     *
+     * For plain `checkpoint` resumes pass `data` (the payload that satisfies
+     * the checkpoint's schema). For tool-approval gates pass
+     * `{ approve: true|false, args_override? }`; the server builds the
+     * `{approve, args}` payload the engine's approval gate expects. (#729)
+     */
+    async resume(executionId, token, data, opts) {
+        const body = { token, data };
+        if (opts?.approve !== undefined)
+            body.approve = opts.approve;
+        if (opts?.args_override !== undefined)
+            body.args_override = opts.args_override;
+        await this.http.fetchOk(`${this.http.getBaseUrl()}/executions/${encodeURIComponent(executionId)}/resume`, {
+            method: 'POST', headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body), signal: opts?.signal,
+        });
+    }
+    /** Poll until execution reaches a terminal state. */
+    async waitFor(executionId, options) {
+        const timeout = options?.timeoutMs ?? 0;
+        const interval = options?.pollIntervalMs ?? 500;
+        const start = Date.now();
+        while (true) {
+            if (options?.signal?.aborted) {
+                throw new Error(`Execution ${executionId} await aborted`);
+            }
+            const output = await this.getOutput(executionId, { signal: options?.signal });
+            const terminalStates = ['completed', 'failed', 'cancelled'];
+            if (output && terminalStates.includes(output.status)) {
+                if (output.status === 'failed') {
+                    const msg = output.error || 'Execution failed';
+                    const kind = output.error_kind;
+                    if (kind === 'RateLimit' || kind === 'ServerError' || kind === 'NetworkError') {
+                        throw new AkribesTransientError(msg, executionId);
+                    }
+                    else if (kind === 'AuthError' || kind === 'TokenLimit') {
+                        throw new AkribesFatalError(msg, executionId);
+                    }
+                    else {
+                        throw new AkribesScriptError(msg, executionId);
+                    }
+                }
+                return output;
+            }
+            if (timeout > 0 && Date.now() - start > timeout) {
+                throw new AkribesTimeoutError(`Execution ${executionId} timed out after ${timeout}ms`, executionId, timeout);
+            }
+            await sleepUntilAborted(interval, options?.signal);
+        }
+    }
+    /**
+     * Poll an execution to completion and return its final output.
+     *
+     * Mirrors the Rust SDK's `await_execution`. Unlike {@link RunStream.output}
+     * (which only resolves for streams the caller initiated), this works for any
+     * `executionId` — including ones discovered via {@link list} or surfaced by
+     * another process.
+     *
+     * Defaults: 5-minute timeout. Pass `timeout: 0` to wait indefinitely. The
+     * optional `AbortSignal` short-circuits the poll loop and is forwarded to
+     * the underlying HTTP request.
+     *
+     * Throws {@link AkribesTransientError} on retryable failures (`RateLimit`,
+     * `ServerError`, `NetworkError`), {@link AkribesFatalError} on `AuthError` /
+     * `TokenLimit`, and {@link AkribesScriptError} for everything else (including
+     * cancellation).
+     */
+    async await(executionId, opts) {
+        return this.waitFor(executionId, {
+            timeoutMs: opts?.timeout ?? DEFAULT_AWAIT_TIMEOUT_MS,
+            signal: opts?.signal,
+        });
+    }
+    /** Cross-SDK naming alias for {@link await}. Mirrors the Rust SDK's
+     *  `await_execution`. Refs #109 (item 3: method-naming consistency). */
+    async awaitExecution(executionId, opts) {
+        return this.await(executionId, opts);
+    }
+    /** Cross-SDK naming alias for {@link await}. Mirrors the Python SDK's
+     *  `await_result`. Refs #109 (item 3: method-naming consistency). */
+    async awaitResult(executionId, opts) {
+        return this.await(executionId, opts);
+    }
+    /** Run a script from a specific point, with pre-seeded environment values.
+     * Skips nodes whose outputs are provided in seedEnv.
+     */
+    async runFrom(scriptName, opts) {
+        const channel = opts.channel ?? 'draft';
+        const url = `${this.path(scriptName, 'run', 'from')}?channel=${encodeURIComponent(channel)}`;
+        return (await this.http.fetchOk(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                inputs: opts.inputs,
+                seed_env: opts.seedEnv,
+                skip_node_ids: opts.skipNodeIds,
+                triggered_by: opts.triggeredBy ?? this.defaultTriggeredBy,
+            }),
+            signal: opts.signal,
+        })).json();
+    }
+    /** Get the compiled execution DAG for a script. If versionId is omitted, uses the draft. */
+    async getGraph(scriptName, opts) {
+        const params = new URLSearchParams();
+        if (opts?.versionId != null)
+            params.set('version', String(opts.versionId));
+        const qs = params.toString();
+        return (await this.http.fetchOk(`${this.path(scriptName, 'graph')}${qs ? `?${qs}` : ''}`, { signal: opts?.signal })).json();
+    }
+    /** Get cost aggregation for the entire project, optionally filtered by date range.
+     *  Rolls up: per-script totals, per-channel totals, and overall totals.
+     *  `unknown_cost_executions` counts runs whose model wasn't in the pricing
+     *  table; their tokens are still included, but they contribute `0` to cost.
+     */
+    async getProjectCost(opts) {
+        const params = new URLSearchParams();
+        if (opts?.since)
+            params.set('since', opts.since);
+        if (opts?.until)
+            params.set('until', opts.until);
+        const qs = params.toString();
+        return (await this.http.fetchOk(`${this.http.getBaseUrl()}/projects/${this.projectId}/cost${qs ? `?${qs}` : ''}`, { signal: opts?.signal })).json();
+    }
+    /** Get cost aggregation for a script (total, avg, per-version, per-channel). */
+    async getCost(scriptName, opts) {
+        const params = new URLSearchParams();
+        if (opts?.since)
+            params.set('since', opts.since);
+        if (opts?.until)
+            params.set('until', opts.until);
+        const qs = params.toString();
+        return (await this.http.fetchOk(`${this.path(scriptName, 'cost')}${qs ? `?${qs}` : ''}`, { signal: opts?.signal })).json();
+    }
+    /** Run a script and wait for the result. Returns [execution_id, output]. */
+    async runAndAwait(scriptName, opts) {
+        const { execution_id } = await this.run(scriptName, opts);
+        const output = await this.waitFor(execution_id, opts);
+        return [execution_id, output];
+    }
+    /**
+     * Start a run and return a {@link RunStream} lifecycle handle. The stream
+     * subscribes to events BEFORE issuing the run POST so no early events are
+     * missed. It's async-iterable, exposes `.output` / `.executionId` promises,
+     * and offers category-based `.on.<cat>()` callback registration.
+     *
+     * Requires the client was constructed with a `projectId` so the events
+     * sub-client is available.
+     */
+    runStream(scriptName, opts) {
+        if (!this.eventsSourceFactory) {
+            throw new Error('runStream() requires the EventsClient to be wired. Construct AkribesClient with a projectId.');
+        }
+        this.validateContract(scriptName);
+        return createRunStream(scriptName, opts, this.eventsSourceFactory(), (name, o) => this.run(name, o));
+    }
+    // ── Document helpers ──────────────────────────────────────────────────
+    /** Get document metadata by ID. */
+    async getDocument(documentId, opts) {
+        return nullOn404(async () => (await this.http.fetchOk(`${this.http.getBaseUrl()}/documents/${encodeURIComponent(documentId)}`, opts)).json());
+    }
+    /** Get converted markdown for a document. */
+    async getDocumentMarkdown(documentId, opts) {
+        return (await this.http.fetchOk(`${this.http.getBaseUrl()}/documents/${encodeURIComponent(documentId)}/markdown`, opts)).json();
+    }
+    /** Get a presigned download URL for the original document file. */
+    async getDocumentUrl(documentId, opts) {
+        const resp = await this.http.fetchOk(`${this.http.getBaseUrl()}/documents/${encodeURIComponent(documentId)}/content`, { ...opts, redirect: 'manual' });
+        return resp.headers.get('location') || resp.url;
+    }
+    /** Retry conversion on a failed document. */
+    async reconvertDocument(documentId, opts) {
+        return (await this.http.fetchOk(`${this.http.getBaseUrl()}/documents/${encodeURIComponent(documentId)}/convert`, { method: 'POST', signal: opts?.signal })).json();
+    }
+}
+//# sourceMappingURL=executions.js.map

package/dist/sub/executions.js.map

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

package/dist/sub/mcp.d.ts

@@ -0,0 +1,51 @@
+import type { HttpClient } from '../http';
+import type { McpServerSummary, McpToolSummary } from '../types';
+export type McpHealth = {
+    status: 'connected' | 'degraded' | 'offline' | 'pinned_offline';
+    last_error?: string;
+    last_check_at?: string;
+};
+/** Response from `POST /projects/{id}/mcp/servers/{alias}/refresh`. */
+export type McpRefreshResult = {
+    refreshed: boolean;
+    alias: string;
+    tool_count: number;
+};
+/** Response from `GET /projects/{id}/mcp/servers/{alias}/drift`. */
+export type McpDriftResult = {
+    drifted: boolean;
+    added: string[];
+    removed: string[];
+    reason?: string;
+};
+export declare class McpClient {
+    private http;
+    private projectId;
+    constructor(http: HttpClient, projectId: number);
+    private base;
+    listServers(opts?: {
+        signal?: AbortSignal;
+    }): Promise<McpServerSummary[]>;
+    listTools(opts?: {
+        signal?: AbortSignal;
+    }): Promise<McpToolSummary[]>;
+    health(alias: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<McpHealth>;
+    /**
+     * Force a fresh `tools/list` against the remote MCP server and update the
+     * pinned schema in the DB. Returns the new tool count.
+     */
+    refresh(alias: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<McpRefreshResult>;
+    /**
+     * Compare the pinned schema against the remote server's live `tools/list`
+     * and report added/removed tool names. The server populates `added` and
+     * `removed` arrays even when nothing has drifted (both empty in that case).
+     */
+    drift(alias: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<McpDriftResult>;
+}
+//# sourceMappingURL=mcp.d.ts.map