@jini-ai/agent-runtime 0.1.0

package/dist/agent-protocol/pi-rpc/session.js

@@ -0,0 +1,371 @@
+/** @module agent-protocol/pi-rpc/session
+ * Attaches a pi `--mode rpc` session to an already-spawned child process.
+ * Owns prompt delivery, session-file capture, image forwarding (with count and
+ * byte budgets), extension-UI auto-resolution, and abort signalling.
+ * Consumes `createJsonLineStream` from core/ and `mapPiRpcEvent` from pi-rpc/events.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createJsonLineStream } from '../core/index.js';
+import { mapPiRpcEvent } from './events.js';
+import { isRecord, errorMessage, errorCode, getRecord } from './internal.js';
+// Image forwarding budgets to prevent large synchronous base64 work.
+/** Maximum number of images forwarded per prompt turn. */
+export const MAX_IMAGE_COUNT = 10;
+/** Total byte ceiling for all images forwarded in one prompt turn. */
+export const MAX_TOTAL_IMAGE_BYTES = 20 * 1024 * 1024; // 20 MB
+/** File extensions accepted in pi's `images` RPC field. */
+export const ALLOWED_IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp']);
+/** Extension UI methods that expect no response — silently consumed without reply. */
+export const FIRE_AND_FORGET_METHODS = new Set([
+    'setStatus',
+    'setWidget',
+    'notify',
+    'setTitle',
+    'set_editor_text',
+]);
+/**
+ * Writes a JSON-RPC response to pi's stdin for an `extension_ui_request` event,
+ * keeping pi unblocked without surfacing an interactive dialog to the daemon caller.
+ * Fire-and-forget methods are silently consumed. Dialog methods are auto-resolved:
+ * `confirm` → `{ confirmed: true }`; select/input/editor → first option or cancelled.
+ *
+ * @param writable - The child process stdin stream.
+ * @param raw      - The parsed `extension_ui_request` RPC object from pi's stdout.
+ */
+export function replyExtensionUi(writable, raw) {
+    if (raw?.id == null)
+        return;
+    // Fire-and-forget: no response expected. Silently consume.
+    if (typeof raw.method === 'string' && FIRE_AND_FORGET_METHODS.has(raw.method))
+        return;
+    // Dialog methods: auto-resolve to keep pi unblocked.
+    // confirm → true, select/input/editor → empty-ish default
+    let result;
+    if (raw.method === 'confirm') {
+        result = { confirmed: true };
+    }
+    else {
+        // select: pick first option if available, else cancel
+        const params = getRecord(raw.params);
+        const opts = params?.options ?? raw.options;
+        if (Array.isArray(opts) && opts.length > 0) {
+            const first = opts[0];
+            result =
+                typeof first === 'string'
+                    ? { value: first }
+                    : { value: getRecord(first)?.label ?? getRecord(first)?.value ?? '' };
+        }
+        else {
+            result = { cancelled: true };
+        }
+    }
+    writable.write(`${JSON.stringify({ type: 'extension_ui_response', id: raw.id, ...result })}\n`);
+}
+/**
+ * Reads `.pi/sessions/*.jsonl` entries from the given working directory,
+ * returning file paths with their mtime and size. Returns an empty array
+ * when the directory is absent, empty, or unreadable.
+ *
+ * @param cwd - Absolute path to the pi working directory; may be undefined.
+ */
+export function readPiSessionFiles(cwd) {
+    if (typeof cwd !== 'string' || cwd.length === 0)
+        return [];
+    const sessionsDir = path.join(cwd, '.pi', 'sessions');
+    let entries;
+    try {
+        entries = fs.readdirSync(sessionsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const files = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.jsonl'))
+            continue;
+        try {
+            const full = path.join(sessionsDir, entry.name);
+            const stat = fs.statSync(full);
+            files.push({ path: full, mtimeMs: stat.mtimeMs, size: stat.size });
+        }
+        catch {
+            // Skip unreadable entries.
+        }
+    }
+    return files;
+}
+/**
+ * Takes a before-snapshot of `.pi/sessions/` to enable changed-file detection
+ * after the prompt completes.
+ *
+ * @param cwd - Absolute path to the pi working directory; may be undefined.
+ */
+export function snapshotPiSessionFiles(cwd) {
+    const snapshot = new Map();
+    for (const file of readPiSessionFiles(cwd)) {
+        snapshot.set(file.path, { mtimeMs: file.mtimeMs, size: file.size });
+    }
+    return snapshot;
+}
+/**
+ * Compares the current `.pi/sessions/` directory against a before-snapshot
+ * and returns the path of the single changed file. Returns `null` when zero
+ * or more than one file changed — concurrent pi processes are detected this
+ * way to avoid associating the wrong session with this run.
+ *
+ * @param cwd    - Absolute path to the pi working directory; may be undefined.
+ * @param before - Snapshot taken before the prompt was sent.
+ * @returns Absolute path of the changed session file, or `null`.
+ */
+export function resolveSessionPathChangedSince(cwd, before) {
+    const changed = readPiSessionFiles(cwd).filter((file) => {
+        const previous = before.get(file.path);
+        return !previous || file.mtimeMs > previous.mtimeMs || file.size !== previous.size;
+    });
+    // `changed.length === 1` guarantees `changed[0]` is defined; the non-null
+    // assertion documents that instead of a `?? null` fallback that could
+    // never actually be exercised.
+    return changed.length === 1 ? changed[0].path : null;
+}
+/**
+ * Attaches the daemon's run lifecycle to an already-spawned `pi --mode rpc` child process.
+ *
+ * Responsibilities:
+ * - Sends a `new_session` RPC command (with `parentSession`) before the prompt when
+ *   resuming a prior conversation, waiting for acknowledgement before the prompt is sent.
+ *   This preserves conversation history across edit rounds; if the parent session is
+ *   rejected, the run is failed immediately rather than continuing without prior context.
+ * - Encodes and forwards `imagePaths` as base64 in the `prompt` RPC command, subject to
+ *   `MAX_IMAGE_COUNT` and `MAX_TOTAL_IMAGE_BYTES` budgets. Symlinks are resolved via
+ *   `realpathSync` and re-verified against `uploadRoot` to prevent path-escape attacks.
+ * - Streams pi's stdout through `createJsonLineStream`, delegating each parsed object to
+ *   `mapPiRpcEvent` for typed SSE event dispatch, and auto-resolving extension-UI requests
+ *   via `replyExtensionUi` so pi does not block waiting for interactive dialogs.
+ * - On `agent_end`, captures the changed `.pi/sessions/` file path for conversational
+ *   resume, closes stdin, and schedules a SIGTERM fallback after
+ *   `PI_GRACEFUL_SHUTDOWN_MS` ms (default 5000).
+ *
+ * @param options - Session parameters: child process, prompt string, optional model,
+ *                  image paths, upload root for symlink verification, and optional
+ *                  parent session path for conversation resume.
+ * @returns A `PiRpcSession` handle with `hasFatalError`, `getLastSessionPath`, and `abort`.
+ */
+export function attachPiRpcSession({ child, prompt, cwd, model, send, imagePaths, uploadRoot, parentSession, }) {
+    const stdin = child.stdin;
+    const stdout = child.stdout;
+    if (stdin === null) {
+        throw new Error('pi RPC child process is missing stdin');
+    }
+    if (stdout === null) {
+        throw new Error('pi RPC child process is missing stdout');
+    }
+    const runStartedAt = Date.now();
+    const sessionFilesBeforePrompt = snapshotPiSessionFiles(cwd);
+    let finished = false;
+    let fatal = false;
+    const sentFirstToken = { value: false };
+    let capturedSessionPath = null;
+    let nextRpcId = 1;
+    let stdinOpen = true;
+    function sendCommand(writable, type, params = {}) {
+        if (!stdinOpen)
+            return null;
+        const id = nextRpcId++;
+        writable.write(`${JSON.stringify({ id, type, ...params })}\n`);
+        return id;
+    }
+    // Track RPC ids so resume and prompt failures are attributed to the right
+    // request. A resumed turn must not send the trimmed prompt until pi confirms
+    // it loaded the parent session.
+    let parentSessionRpcId = null;
+    let promptRpcId = null;
+    const fail = (message, code) => {
+        if (finished)
+            return;
+        finished = true;
+        fatal = true;
+        send('error', { message, ...(code ? { code } : {}) });
+        if (!child.killed)
+            child.kill('SIGTERM');
+    };
+    // Emit initial status with model name immediately — before pi even
+    // responds — so the UI header shows the model name at session start.
+    send('agent', {
+        type: 'status',
+        label: 'initializing',
+        model: typeof model === 'string' && model ? model : null,
+    });
+    // ---- Outbound: send new_session (if parentSession provided) then prompt via RPC ----
+    stdin.on('error', (err) => {
+        if (errorCode(err) !== 'EPIPE') {
+            fail(`stdin: ${errorMessage(err)}`);
+        }
+    });
+    stdin.on('close', () => {
+        stdinOpen = false;
+    });
+    // If a prior session file path is provided, send new_session with
+    // parentSession so pi loads the prior conversation history into the
+    // new session, enabling conversational continuity across edit rounds.
+    // Build the images array for pi's prompt command. pi's RPC protocol
+    // accepts `images` as an array of {type, data, mimeType} objects where
+    // `data` is base64-encoded file contents. The daemon's safeImages guard
+    // already validated that each path exists under UPLOAD_DIR.
+    //
+    // Security: realpath resolves symlinks so we re-check that the resolved
+    // path is still a regular file (no /proc/self/mem or symlink escape).
+    // We also enforce a count and total-byte budget to prevent large
+    // synchronous base64 reads from blocking the event loop.
+    const images = [];
+    if (Array.isArray(imagePaths) && imagePaths.length > 0) {
+        let totalBytes = 0;
+        for (const imgPath of imagePaths) {
+            if (images.length >= MAX_IMAGE_COUNT)
+                break;
+            if (typeof imgPath !== 'string' || !imgPath.length)
+                continue;
+            try {
+                // Resolve symlinks and verify it's a regular file.
+                const realPath = fs.realpathSync(imgPath);
+                const stat = fs.statSync(realPath);
+                if (!stat.isFile())
+                    continue;
+                // Re-verify the resolved path stays inside the upload root.
+                // Without this, a path that passed server.ts's safeImages prefix
+                // check (under UPLOAD_DIR) could be a symlink pointing to a file
+                // outside UPLOAD_DIR, and we'd read/base64-forward it to pi.
+                if (uploadRoot) {
+                    const resolvedRoot = fs.realpathSync(uploadRoot);
+                    if (realPath !== resolvedRoot && !realPath.startsWith(resolvedRoot + path.sep))
+                        continue;
+                }
+                const ext = path.extname(realPath).toLowerCase();
+                if (!ALLOWED_IMAGE_EXTENSIONS.has(ext))
+                    continue;
+                // Enforce total byte budget.
+                if (totalBytes + stat.size > MAX_TOTAL_IMAGE_BYTES)
+                    continue;
+                const buf = fs.readFileSync(realPath);
+                const mimeType = ext === '.png' ? 'image/png' :
+                    ext === '.gif' ? 'image/gif' :
+                        ext === '.webp' ? 'image/webp' :
+                            'image/jpeg'; // .jpg, .jpeg, and unknown
+                images.push({
+                    type: 'image',
+                    data: buf.toString('base64'),
+                    mimeType,
+                });
+                totalBytes += stat.size;
+            }
+            catch (_err) {
+                // Skip unreadable images rather than failing the entire run.
+            }
+        }
+    }
+    const sendPromptCommand = () => {
+        promptRpcId = sendCommand(stdin, 'prompt', {
+            message: prompt,
+            ...(images.length > 0 ? { images } : {}),
+        });
+    };
+    // If a prior session file path is provided, send new_session with
+    // parentSession so pi loads the prior conversation history into the
+    // new session, enabling conversational continuity across edit rounds.
+    // Do not send the prompt until pi acknowledges this RPC: resumed prompts
+    // intentionally contain only the latest user turn, so continuing after a
+    // failed parent load would silently drop prior conversation context.
+    if (parentSession) {
+        parentSessionRpcId = sendCommand(stdin, 'new_session', { parentSession });
+    }
+    else {
+        sendPromptCommand();
+    }
+    // ---- Inbound: parse stdout events ----
+    const parser = createJsonLineStream((raw) => {
+        if (!isRecord(raw))
+            return;
+        // Once finished (agent_end or abort), stop processing — the run is
+        // over, so no more agent events should be emitted. We still drain
+        // stdout via parser.feed() so the pipe doesn't break; we just skip
+        // acting on the parsed objects.
+        if (finished)
+            return;
+        // Extension UI requests: auto-resolve to keep pi unblocked.
+        if (raw.type === 'extension_ui_request') {
+            replyExtensionUi(stdin, raw);
+            return;
+        }
+        // RPC responses (prompt accepted, set_model ack, etc.) — not
+        // agent events. Log the prompt acceptance, ignore the rest.
+        if (raw.type === 'response') {
+            if (raw.id === parentSessionRpcId) {
+                if (raw.success === false) {
+                    fail(`parent session rejected: ${String(raw.error ?? 'unknown')}`, 'PI_PARENT_SESSION_FAILED');
+                    return;
+                }
+                sendPromptCommand();
+                return;
+            }
+            if (raw.id === promptRpcId && raw.success === false) {
+                fail(`prompt rejected: ${String(raw.error ?? 'unknown')}`);
+            }
+            return;
+        }
+        // Agent events: delegate to the pure mapper.
+        const result = mapPiRpcEvent(raw, send, { runStartedAt, sentFirstToken });
+        if (result === 'agent_end') {
+            finished = true;
+            // Capture only the session file changed by this run. If another pi
+            // process wrote to the shared session directory concurrently, the
+            // resolver returns null instead of risking cross-conversation resume.
+            capturedSessionPath = resolveSessionPathChangedSince(cwd, sessionFilesBeforePrompt);
+            // pi's RPC process stays alive after agent_end (designed for
+            // multi-prompt sessions). The daemon's /api/chat is single-shot,
+            // so close stdin and let the process exit naturally, or kill it
+            // after a grace period.
+            try {
+                stdin.end();
+            }
+            catch (err) {
+                fail(`stdin close: ${errorMessage(err)}`);
+            }
+            // Grace period before SIGTERM. Configurable via PI_GRACEFUL_SHUTDOWN_MS
+            // for resource-constrained machines where the event loop drains slowly.
+            const shutdownMs = Number(process.env.PI_GRACEFUL_SHUTDOWN_MS) || 5000;
+            setTimeout(() => {
+                if (!child.killed)
+                    child.kill('SIGTERM');
+            }, shutdownMs);
+        }
+    });
+    stdout.on('data', (chunk) => {
+        try {
+            parser.feed(typeof chunk === 'string' ? chunk : chunk.toString('utf8'));
+        }
+        catch (err) {
+            fail(`parser: ${errorMessage(err)}`);
+        }
+    });
+    stdout.on('close', () => parser.flush());
+    child.on('error', (err) => fail(errorMessage(err)));
+    return {
+        hasFatalError() {
+            return fatal;
+        },
+        getLastSessionPath() {
+            return capturedSessionPath;
+        },
+        abort() {
+            // Send RPC abort so pi can clean up gracefully (flush logs,
+            // finalize session files, etc.). The termination guarantee
+            // (SIGTERM fallback) is owned by the caller (runs.cancel()),
+            // not by this method.
+            if (finished || child.killed)
+                return;
+            finished = true;
+            sendCommand(stdin, 'abort');
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/agent-protocol/pi-rpc/session.js.map

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

package/dist/amr-model-cache.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module amr-model-cache
+ *
+ * A live-model-catalog cache that returns a cached remote list instantly
+ * while refreshing in the background, falling back to a static preset
+ * list on cold start. Ported verbatim from OD's
+ * `apps/daemon/src/runtimes/amr/amr-model-cache.ts` with one change: the
+ * `AmrModelsResponse` return type is now vendored locally (a small,
+ * self-contained shape) instead of imported from OD's contracts workspace
+ * package.
+ *
+ * Named for its origin use (the AMR/vela agent's live model list), but the
+ * caching pattern itself is generic to any agent with a similarly-shaped
+ * "cheap static preset + slower authoritative remote list" catalog.
+ */
+import type { RuntimeModelOption } from './types.js';
+export type AmrModelsResponse = {
+    source: 'remote' | 'preset';
+    models: RuntimeModelOption[];
+    refreshing: boolean;
+    stale?: boolean;
+    remoteError?: string;
+};
+type Fetchers = {
+    fetchPreset: () => Promise<RuntimeModelOption[]>;
+    fetchRemote: () => Promise<RuntimeModelOption[]>;
+};
+export declare class AmrModelLoadingCache {
+    private readonly refreshIntervalMs;
+    private readonly states;
+    constructor(refreshIntervalMs?: number);
+    get(cacheKey: string, fetchers: Fetchers): Promise<AmrModelsResponse>;
+    warm(cacheKey: string, fetchRemote: () => Promise<RuntimeModelOption[]>): void;
+    resetForTests(): void;
+    private stateFor;
+    private startRefresh;
+}
+export declare const amrModelLoadingCache: AmrModelLoadingCache;
+export {};
+//# sourceMappingURL=amr-model-cache.d.ts.map

package/dist/amr-model-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amr-model-cache.d.ts","sourceRoot":"","sources":["../src/amr-model-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAOF,KAAK,QAAQ,GAAG;IACd,WAAW,EAAE,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;CAClD,CAAC;AAsBF,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAF9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;gBAE3B,iBAAiB,SAAqC;IAE7E,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyB3E,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,GAAG,IAAI;IAI9E,aAAa,IAAI,IAAI;IAIrB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,YAAY;CAiBrB;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/amr-model-cache.js

@@ -0,0 +1,79 @@
+// The AMR model catalog changes rarely (new models land on the order of
+// days), and a cached remote list is returned immediately while a refresh
+// runs in the background — `get()` never blocks on the network when a
+// cached entry exists. The per-run preflight also reads this cache, so a
+// tight interval would spawn `vela model list` far more often than the
+// catalog actually changes. Refresh at most once every 10 minutes per
+// cache key; callers always get the last-known catalog instantly in
+// between.
+const DEFAULT_REMOTE_REFRESH_INTERVAL_MS = 10 * 60_000;
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error ?? 'unknown error');
+}
+export class AmrModelLoadingCache {
+    refreshIntervalMs;
+    states = new Map();
+    constructor(refreshIntervalMs = DEFAULT_REMOTE_REFRESH_INTERVAL_MS) {
+        this.refreshIntervalMs = refreshIntervalMs;
+    }
+    async get(cacheKey, fetchers) {
+        const state = this.stateFor(cacheKey);
+        const now = Date.now();
+        if (state.remote) {
+            const staleByAge = now - state.remote.fetchedAt >= this.refreshIntervalMs;
+            if (staleByAge)
+                this.startRefresh(state, fetchers.fetchRemote);
+            return {
+                source: 'remote',
+                models: state.remote.models,
+                refreshing: state.inFlight !== null,
+                ...(state.inFlight || state.lastRemoteError ? { stale: true } : {}),
+                ...(state.lastRemoteError ? { remoteError: state.lastRemoteError } : {}),
+            };
+        }
+        const preset = await fetchers.fetchPreset();
+        this.startRefresh(state, fetchers.fetchRemote);
+        return {
+            source: 'preset',
+            models: preset,
+            refreshing: state.inFlight !== null,
+            ...(state.lastRemoteError ? { remoteError: state.lastRemoteError } : {}),
+        };
+    }
+    warm(cacheKey, fetchRemote) {
+        this.startRefresh(this.stateFor(cacheKey), fetchRemote);
+    }
+    resetForTests() {
+        this.states.clear();
+    }
+    stateFor(cacheKey) {
+        const existing = this.states.get(cacheKey);
+        if (existing)
+            return existing;
+        const created = { remote: null, inFlight: null, lastRemoteError: null };
+        this.states.set(cacheKey, created);
+        return created;
+    }
+    startRefresh(state, fetchRemote) {
+        if (state.inFlight)
+            return;
+        state.inFlight = (async () => {
+            try {
+                const models = await fetchRemote();
+                if (models.length === 0) {
+                    throw new Error('AMR remote model list returned no chat models');
+                }
+                state.remote = { models, fetchedAt: Date.now() };
+                state.lastRemoteError = null;
+            }
+            catch (error) {
+                state.lastRemoteError = errorMessage(error);
+            }
+            finally {
+                state.inFlight = null;
+            }
+        })();
+    }
+}
+export const amrModelLoadingCache = new AmrModelLoadingCache();
+//# sourceMappingURL=amr-model-cache.js.map

package/dist/amr-model-cache.js.map

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

package/dist/amr-profile-resolver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @module amr-profile-resolver
+ *
+ * Port replacing OD's `resolveAmrProfile` import
+ * (`apps/daemon/src/integrations/vela.js`) inside `detection.ts`. OD uses
+ * this to scope the remembered-live-models cache for the `amr` agent id by
+ * "profile" — an AMR/vela-vendor concept (which OpenRouter-compatible
+ * account/link config is active) that has no generic runtime meaning.
+ *
+ * `detection.ts` accepts an `AmrProfileResolver` and calls it only for the
+ * `amr` def id; every other agent's scoping is unaffected. The default
+ * no-op resolver returns a constant scope (equivalent to "no profile
+ * scoping"), so a non-OD consumer's AMR-model cache degrades gracefully —
+ * it just doesn't split by profile — until it supplies a real resolver.
+ */
+export interface AmrProfileResolver {
+    /** Return a scope key for the `amr` agent's remembered-live-models cache, derived from the spawn env. */
+    resolveProfile(env: NodeJS.ProcessEnv): string;
+}
+export declare const noopAmrProfileResolver: AmrProfileResolver;
+//# sourceMappingURL=amr-profile-resolver.d.ts.map

package/dist/amr-profile-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"amr-profile-resolver.d.ts","sourceRoot":"","sources":["../src/amr-profile-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kBAAkB;IACjC,yGAAyG;IACzG,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;CAChD;AAED,eAAO,MAAM,sBAAsB,EAAE,kBAEpC,CAAC"}

package/dist/amr-profile-resolver.js

@@ -0,0 +1,4 @@
+export const noopAmrProfileResolver = {
+    resolveProfile: () => 'default',
+};
+//# sourceMappingURL=amr-profile-resolver.js.map

package/dist/amr-profile-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amr-profile-resolver.js","sourceRoot":"","sources":["../src/amr-profile-resolver.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,sBAAsB,GAAuB;IACxD,cAAc,EAAE,GAAG,EAAE,CAAC,SAAS;CAChC,CAAC"}

package/dist/artifact-taxonomy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module artifact-taxonomy
+ *
+ * Port replacing the classification half of OD's
+ * `runtimes/runs/run-artifacts.ts` (`isArtifactPath`, `isDesignSystemFile`,
+ * `isPreviewModulePath`, `didRunCreateDesignSystemFile`,
+ * `countDesignSystemPreviewModules`). That file's real behavior is entirely
+ * OD-product classification (HTML-prototype/SVG/design-system-file
+ * taxonomy feeding PostHog `run_finished.artifact_count` /
+ * `design_system_created` analytics) plus OD-specific imports into OD's own
+ * analytics-contracts and question-form-detection modules — none of it is
+ * ported.
+ *
+ * Per r1b §1b, only the taxonomy/classification *interface* belongs to
+ * this package. `ArtifactTaxonomy`'s companion `ArtifactStore` (actual
+ * read/write persistence) is explicitly a later storage/sqlite task's
+ * concern — not defined here.
+ */
+export interface ArtifactTaxonomy {
+    /** Does this file path count as a user-facing artifact? (OD: html/svg/prototype/live-artifact.) */
+    isArtifact(path: string): boolean;
+    /** Optional finer buckets a host tracks for analytics; the engine treats all buckets as opaque. */
+    classify?(path: string): string | null;
+}
+/** Classifies nothing as an artifact and provides no finer buckets — a safe default until a host supplies its own taxonomy. */
+export declare const noopArtifactTaxonomy: ArtifactTaxonomy;
+//# sourceMappingURL=artifact-taxonomy.d.ts.map

package/dist/artifact-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-taxonomy.d.ts","sourceRoot":"","sources":["../src/artifact-taxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mGAAmG;IACnG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,mGAAmG;IACnG,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,+HAA+H;AAC/H,eAAO,MAAM,oBAAoB,EAAE,gBAElC,CAAC"}

package/dist/artifact-taxonomy.js

@@ -0,0 +1,5 @@
+/** Classifies nothing as an artifact and provides no finer buckets — a safe default until a host supplies its own taxonomy. */
+export const noopArtifactTaxonomy = {
+    isArtifact: () => false,
+};
+//# sourceMappingURL=artifact-taxonomy.js.map

package/dist/artifact-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-taxonomy.js","sourceRoot":"","sources":["../src/artifact-taxonomy.ts"],"names":[],"mappings":"AAyBA,+HAA+H;AAC/H,MAAM,CAAC,MAAM,oBAAoB,GAAqB;IACpD,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK;CACxB,CAAC"}

package/dist/auth.d.ts

@@ -0,0 +1,25 @@
+import type { RuntimeAgentDef, RuntimeEnv } from './types.js';
+export type AgentAuthProbeResult = {
+    status: 'ok' | 'missing' | 'unknown';
+    message?: string;
+    stdoutTail?: string;
+    stderrTail?: string;
+    exitCode?: number | null;
+    signal?: string | null;
+};
+export declare function cursorAuthGuidance(hostName?: string): string;
+export declare function deepseekAuthGuidance(hostName?: string): string;
+export declare function antigravityAuthGuidance(hostName?: string): string;
+export declare function antigravityQuotaGuidance(): string;
+export declare function reasonixAuthGuidance(hostName?: string): string;
+export declare function claudeAuthGuidance(hostName?: string): string;
+export declare function isCursorAuthFailureText(text: string): boolean;
+export declare function isAntigravityAuthFailureText(text: string): boolean;
+export declare function isDeepSeekAuthFailureText(text: string): boolean;
+export declare function isReasonixAuthFailureText(text: string): boolean;
+export declare function isClaudeAuthFailureText(text: string): boolean;
+export declare function classifyAgentAuthFailure(agentId: string, text: string, hostName?: string): AgentAuthProbeResult | null;
+export type AgentServiceFailureCode = 'AGENT_AUTH_REQUIRED' | 'RATE_LIMITED' | 'UPSTREAM_UNAVAILABLE';
+export declare function classifyAgentServiceFailure(text: string): AgentServiceFailureCode | null;
+export declare function probeAgentAuthStatus(def: Pick<RuntimeAgentDef, 'id' | 'name' | 'authProbe'>, resolvedBin: string, env: RuntimeEnv, hostName?: string): Promise<AgentAuthProbeResult | null>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAMjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AA6CF,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAE/E;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAEpF;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAEjF;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAE/E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAW7D;AAWD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASlE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAU/D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS/D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAqB7D;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAA0B,GACnC,oBAAoB,GAAG,IAAI,CAsB7B;AAQD,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GAAG,cAAc,GAAG,sBAAsB,CAAC;AA0CtG,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAOxF;AAqFD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,MAAM,GAAG,WAAW,CAAC,EACvD,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,UAAU,EACf,QAAQ,GAAE,MAA0B,GACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAiDtC"}