@relayhistory/capture 0.0.0 → 0.18.8

package/dist/cloud-client.js

@@ -0,0 +1,276 @@
+/** Cloud API wrappers over the shared Rust engine. */
+import { AuthenticationExpiredError, ConnectorFailureError, InvalidArgumentError, SOURCES, UnsupportedOperationError, isSource, } from 'ai-hist';
+import { helperCall } from './helper.js';
+/** Return a secret service token with at least 60 seconds of validity. Rust
+ * selects the stage, refreshes if needed and atomically saves rotated tokens. */
+export async function accessToken(options = {}) {
+    return helperCall((native) => native.accessToken(options.baseUrl));
+}
+/** Fetch a cloud transcript without opening or importing into the local DB. */
+export async function replay(sessionId, options = {}) {
+    for (const key of ['limit', 'maxContent']) {
+        const value = options[key];
+        if (value !== undefined && (!Number.isSafeInteger(value) || value < 0 || value > 0xffff_ffff)) {
+            throw new InvalidArgumentError(`${key} must be an integer between 0 and 4294967295`, 'INVALID_ARGUMENT');
+        }
+    }
+    const result = await helperCall((native) => native.replay(sessionId, options));
+    return { eventCount: result.eventCount, transcript: result.transcript ?? null, outputPath: result.outputPath ?? null };
+}
+/** Both SDK consumers and the engine use the same stage-scoped Rust auth store. */
+export async function loadStoredRelayhistoryAuth(baseUrl) {
+    return helperCall((native) => native.cloudLoadAuth(baseUrl));
+}
+/** Read-only connector probe; stage selection and eligibility belong to Rust. */
+export async function resolveCloudSession(baseUrl, now = Date.now()) {
+    const result = await helperCall((native) => native.cloudResolveSession(baseUrl, now));
+    return result.auth
+        ? { auth: result.auth, session: true }
+        : { auth: null, detail: result.detail ?? 'no stored relayhistory session (run `ai-hist login`)' };
+}
+/** Rotate a rejected stored bearer under the native stage lock. */
+export async function refreshCloudSession(baseUrl, rejectedToken) {
+    return helperCall((native) => native.cloudRefreshSession(baseUrl, rejectedToken));
+}
+/**
+ * Exchange an Agent Relay Cloud bearer for a RelayHistory session.
+ *
+ * Sign-in itself lives in the Rust helper: this passes the request through and
+ * never obtains, stores or inspects a Cloud credential in JavaScript.
+ */
+export async function login(options = {}) {
+    return helperCall((native) => native.cloudLogin({
+        baseUrl: options.baseUrl,
+        relayAccessToken: options.relayAccessToken,
+        label: options.label,
+        interactive: options.interactive,
+        workspace: options.workspace,
+    }));
+}
+export async function loginCloud(relayAccessToken, options = {}) {
+    try {
+        const auth = await login({ ...options, relayAccessToken });
+        return { ok: true, auth };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+export async function pushCloud(options = {}) {
+    return helperCall((native) => native.pushCloud(options));
+}
+/** Device login, service-token exchange and first push run in Rust. The optional
+ * loop is host orchestration only: no token, refresh, stage or cursor logic in JS.
+ * The loop remains in this process; await stop() before shutdown. */
+export async function enableCloud(options = {}) {
+    const intervalMs = options.intervalMs ?? 60_000;
+    if (!Number.isSafeInteger(intervalMs) || intervalMs < 1_000 || intervalMs > 2_147_483_647) {
+        throw new InvalidArgumentError('intervalMs must be an integer between 1000 and 2147483647', 'INVALID_ARGUMENT');
+    }
+    const first = await helperCall((native) => native.enableCloud(options));
+    let stopped = false;
+    let timer;
+    let pending = Promise.resolve();
+    const schedule = () => {
+        if (stopped || options.watch === false)
+            return;
+        timer = setTimeout(() => {
+            pending = (async () => {
+                try {
+                    const result = await pushCloud({ dbPath: options.dbPath, baseUrl: first.baseUrl });
+                    options.onPush?.(result);
+                }
+                catch (error) {
+                    if (options.onError)
+                        options.onError(error);
+                    else
+                        process.stderr.write(`ai-hist cloud push failed: ${error instanceof Error ? error.message : String(error)}\n`);
+                }
+                finally {
+                    schedule();
+                }
+            })();
+        }, intervalMs);
+    };
+    schedule();
+    return { ...first, async stop() { stopped = true; clearTimeout(timer); await pending; } };
+}
+/** Share the already-pushed, frozen server snapshot of a session. */
+export async function createShareableTrace(sessionId, options) {
+    return helperCall(async (native) => JSON.parse(await native.createShareableTrace(sessionId, options.visibility, options.source, options.baseUrl)));
+}
+// ---------------------------------------------------------------------------
+// Session thread (SPEC §3.4 / §3.5)
+//
+// `get_session_thread` is the *lifecycle* fan-out for one session — the PRs,
+// reviews, commits, incidents, tickets, Slack threads, hotfixes and follow-up
+// sessions the cloud has stitched to it. It is cloud-only on purpose: a thread
+// exists only once the cloud has ingested lens events, so there is no local
+// fallback and no local cache. Threads change as PRs and incidents land, so
+// every call fetches.
+// ---------------------------------------------------------------------------
+/** The operation name the unsupported-operation message is phrased around. */
+const THREAD_OPERATION = 'thread';
+/**
+ * Query parameters that select tenancy. Tenancy is derived from the bearer
+ * token server-side; sending one of these would be a client asserting its own
+ * scope. Mirrors the guard in the Rust transport (`cloud::recall_page`).
+ */
+const TENANCY_PARAMS = new Set([
+    'org_id', 'orgId', 'workspace_id', 'workspaceId',
+]);
+const DEFAULT_CLOUD_BASE_URL = 'https://history.agentrelay.com';
+/**
+ * A base URL reduced to the identity of its stage, so two spellings of one
+ * stage compare equal. Mirrors `cloud::normalized_stage`.
+ *
+ * Scheme and host are case-insensitive per RFC 3986 and are lowercased; the
+ * path is not, and is preserved exactly. A stage mounted under a case-sensitive
+ * prefix (`https://host/Recall`) must keep it or the request goes elsewhere.
+ */
+function normalizeStage(baseUrl) {
+    const trimmed = baseUrl.trim().replace(/\/+$/, '');
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        // Not a URL this build can parse: compare it verbatim rather than
+        // inventing an origin for it.
+        return trimmed;
+    }
+    return `${parsed.protocol.toLowerCase()}//${parsed.host.toLowerCase()}${parsed.pathname}`
+        .replace(/\/+$/, '');
+}
+/**
+ * The unsupported-operation message, in the shape the sibling remote
+ * connectors use.
+ *
+ * The leading phrase `no remote provider connectors are configured` is an
+ * explicit compatibility contract that callers and tests match on — see
+ * `crates/ai-hist/src/remote.rs::unconfigured_message`, whose format this
+ * reproduces for the one connector a thread can be served by (`cloud`).
+ */
+export function cloudUnconfiguredMessage(operation, detail) {
+    return `no remote provider connectors are configured: remote session ${operation} is not available (cloud: ${detail})`;
+}
+/** Most `link_kind` values the recall route accepts in one `kinds` filter. */
+const MAX_THREAD_KINDS = 50;
+/** The `limit` range the recall route accepts before clamping. */
+const MIN_THREAD_LIMIT = 1;
+const MAX_THREAD_LIMIT = 500;
+function requireSecureTransport(baseUrl) {
+    if (baseUrl.startsWith('https://'))
+        return;
+    const authority = baseUrl.startsWith('http://') ? baseUrl.slice('http://'.length) : null;
+    const hostPort = authority?.split('/')[0];
+    // An IPv6 literal is bracketed and full of colons, so the port cannot be
+    // split off before the brackets are removed.
+    const host = hostPort?.startsWith('[')
+        ? hostPort.slice(1, hostPort.indexOf(']')).toLowerCase()
+        : hostPort?.split(':')[0]?.toLowerCase();
+    if (host === 'localhost' || host === '127.0.0.1' || host === '::1')
+        return;
+    throw new ConnectorFailureError(`refusing to send the relayhistory bearer token in cleartext to \`${baseUrl}\` — use an `
+        + 'https:// endpoint. Plain http:// is accepted only for loopback.', 'CONNECTOR_FAILURE');
+}
+/**
+ * Fetch one page of a session's lifecycle thread from the recall API.
+ *
+ * Cloud-only. When no RelayHistory session is stored the `cloud` connector is
+ * unconfigured and this throws {@link UnsupportedOperationError} *without
+ * performing a network call* — the same classification the native engine gives
+ * a remote-only request no connector can serve.
+ */
+export async function getSessionThread(query, opts = {}) {
+    // A misspelled source is an invalid argument, not an unsupported remote
+    // request — reject it with the engine's own message before classifying
+    // anything, exactly as `ensure_remote_connectors_configured_for_at` does.
+    if (!isSource(query.source)) {
+        throw new InvalidArgumentError(`invalid source '${query.source}' (choose from ${SOURCES.join(', ')})`, 'INVALID_ARGUMENT');
+    }
+    if (typeof query.sessionId !== 'string' || query.sessionId.length === 0) {
+        throw new InvalidArgumentError('session_id must be a non-empty string', 'INVALID_ARGUMENT');
+    }
+    if (query.kinds && query.kinds.length > MAX_THREAD_KINDS) {
+        throw new InvalidArgumentError(`kinds accepts at most ${MAX_THREAD_KINDS} values (got ${query.kinds.length})`, 'INVALID_ARGUMENT');
+    }
+    if (query.limit !== undefined
+        && (!Number.isInteger(query.limit)
+            || query.limit < MIN_THREAD_LIMIT || query.limit > MAX_THREAD_LIMIT)) {
+        // Rejected here rather than sent to be clamped, so a caller asking for 5000
+        // learns it is getting 500 instead of silently believing it got 5000.
+        throw new InvalidArgumentError(`limit must be an integer in ${MIN_THREAD_LIMIT}..${MAX_THREAD_LIMIT} (got ${query.limit})`, 'INVALID_ARGUMENT');
+    }
+    // A stored session belongs to one stage, so naming a stage selects it rather
+    // than redirecting it: sending this stage's bearer token to another host is
+    // what `cloud::load_auth`'s `same_stage` check refuses. A stage no stored
+    // session can serve is an unconfigured connector, not a request to attempt.
+    const resolve = opts.resolveSession ?? resolveCloudSession;
+    const resolved = await resolve(opts.baseUrl);
+    if (!resolved.auth) {
+        throw new UnsupportedOperationError(cloudUnconfiguredMessage(THREAD_OPERATION, resolved.detail), 'UNSUPPORTED_OPERATION');
+    }
+    const auth = resolved.auth;
+    const baseUrl = normalizeStage(auth.baseUrl || DEFAULT_CLOUD_BASE_URL);
+    requireSecureTransport(baseUrl);
+    const params = new URLSearchParams();
+    params.set('source', query.source);
+    if (query.kinds?.length)
+        params.set('kinds', query.kinds.join(','));
+    if (query.since)
+        params.set('since', query.since);
+    if (query.cursor)
+        params.set('cursor', query.cursor);
+    if (query.limit !== undefined)
+        params.set('limit', String(query.limit));
+    for (const key of params.keys()) {
+        // Defence in depth: tenancy comes from the token, never a query parameter.
+        if (TENANCY_PARAMS.has(key)) {
+            throw new InvalidArgumentError('recall tenancy comes from the token, not query parameters', 'INVALID_ARGUMENT');
+        }
+    }
+    const url = `${baseUrl}/v1/sessions/${encodeURIComponent(query.sessionId)}/thread?${params}`;
+    const doFetch = opts.fetchImpl ?? fetch;
+    const send = async (bearer) => {
+        try {
+            return await doFetch(url, {
+                headers: { Authorization: `Bearer ${bearer}`, Accept: 'application/json' },
+                // A redirect would carry the bearer token to whatever the hop names.
+                redirect: 'error',
+                signal: AbortSignal.timeout(30_000),
+            });
+        }
+        catch (cause) {
+            throw new ConnectorFailureError(`cloud thread request failed: ${cause instanceof Error ? cause.message : String(cause)}`, 'CONNECTOR_FAILURE', { cause });
+        }
+    };
+    let resp = await send(auth.accessToken);
+    // Only sessions resolved from the canonical store can spend a refresh token.
+    // Rust serializes rotation with the same stage lock used by native requests.
+    if (resp.status === 401 && resolved.session) {
+        const refreshed = await refreshCloudSession(auth.baseUrl, auth.accessToken);
+        if (refreshed)
+            resp = await send(refreshed.accessToken);
+    }
+    if (resp.status === 401) {
+        throw new AuthenticationExpiredError('the stored relayhistory session was rejected (HTTP 401); run `ai-hist login`', 'AUTHENTICATION_EXPIRED');
+    }
+    if (resp.status === 403) {
+        // Authenticated but not permitted: a different session, and a different fix.
+        throw new ConnectorFailureError('the stored relayhistory session is not permitted to read this thread (HTTP 403); '
+            + 'it needs the `rth:read` scope', 'CONNECTOR_FAILURE');
+    }
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => '');
+        throw new ConnectorFailureError(`cloud thread request failed (HTTP ${resp.status}): ${text.slice(0, 200)}`, 'CONNECTOR_FAILURE');
+    }
+    try {
+        // Passed through unchanged: the recall API owns this shape.
+        return (await resp.json());
+    }
+    catch (cause) {
+        throw new ConnectorFailureError('cloud thread response was not valid JSON', 'CONNECTOR_FAILURE', { cause });
+    }
+}
+//# sourceMappingURL=cloud-client.js.map

package/dist/cloud-client.js.map

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

package/dist/helper.d.ts

@@ -0,0 +1,29 @@
+import { type ChildProcess } from 'node:child_process';
+import type { CloudPushResult, RelayhistoryAuth, ReplayOptions, ReplayResult } from './cloud-client.js';
+export interface HelperOptions {
+    binaryPath?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+/** Only terminate the process tree rooted at the helper we created. POSIX
+ * helpers lead a fresh process group; Windows uses taskkill's PID-scoped tree.
+ * Cancellation is not complete until the helper's stdio/process is reaped. */
+export declare function terminateHelperTree(child: ChildProcess, closed: Promise<void>, isClosed: () => boolean): Promise<void>;
+export declare function helperRequest<T>(operation: string, args?: Record<string, unknown>, options?: HelperOptions): Promise<T>;
+interface HelperBinding {
+    accessToken(baseUrl?: string): Promise<string>;
+    replay(sessionId: string, options: ReplayOptions): Promise<ReplayResult>;
+    createShareableTrace(sessionId: string, visibility: string, source?: string, baseUrl?: string): Promise<string>;
+    cloudLoadAuth(baseUrl?: string): Promise<RelayhistoryAuth | null>;
+    cloudResolveSession(baseUrl: string | undefined, now: number): Promise<{
+        auth?: RelayhistoryAuth | null;
+        detail?: string;
+    }>;
+    cloudRefreshSession(baseUrl: string, rejectedToken: string): Promise<RelayhistoryAuth | null>;
+    cloudLogin(options: object): Promise<RelayhistoryAuth>;
+    enableCloud(options: object): Promise<CloudPushResult>;
+    pushCloud(options: object): Promise<CloudPushResult>;
+}
+export declare function helperCall<T>(call: (helper: HelperBinding) => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=helper.d.ts.map

package/dist/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK9D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxG,MAAM,WAAW,aAAa;IAAG,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAMhG;;8EAE8E;AAC9E,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC5H;AACD,wBAAsB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkDrI;AACD,UAAU,aAAa;IACrB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzE,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChH,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAClE,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,EAAC,gBAAgB,GAAC,IAAI,CAAC;QAAA,MAAM,CAAC,EAAC,MAAM,CAAA;KAAC,CAAC,CAAC;IACrH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAC,IAAI,CAAC,CAAC;IAC5F,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACvD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACtD;AAgBD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAyB"}

package/dist/helper.js

@@ -0,0 +1,159 @@
+/** Bounded, cancellable bridge to the optional RelayHistory Rust executable. */
+import { StringDecoder } from 'node:string_decoder';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { RelayHistoryError, InvalidArgumentError, UnsupportedOperationError, AuthenticationExpiredError, ConnectorFailureError, runtimePlatform } from 'ai-hist';
+function packagedBinary() {
+    const binary = 'relayhistory-plugin' + (process.platform === 'win32' ? '.exe' : '');
+    try {
+        return join(dirname(createRequire(import.meta.url).resolve('@relayhistory/capture-' + runtimePlatform() + '/package.json')), binary);
+    }
+    catch {
+        return fileURLToPath(new URL('../bin/' + runtimePlatform() + '/' + binary, import.meta.url));
+    }
+}
+/** Only terminate the process tree rooted at the helper we created. POSIX
+ * helpers lead a fresh process group; Windows uses taskkill's PID-scoped tree.
+ * Cancellation is not complete until the helper's stdio/process is reaped. */
+export async function terminateHelperTree(child, closed, isClosed) {
+    if (isClosed())
+        return;
+    let deadline;
+    try {
+        await Promise.race([
+            (async () => {
+                if (child.pid !== undefined) {
+                    if (process.platform === 'win32') {
+                        // Do not target a potentially reused PID after observing its exit.
+                        if (child.exitCode !== null || child.signalCode !== null)
+                            throw new Error('Helper exited before tree cleanup');
+                        await new Promise((resolve, reject) => {
+                            const killer = spawn(join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'taskkill.exe'), ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+                            const limit = setTimeout(() => { killer.kill(); reject(new Error('Tree cleanup timed out')); }, 2000);
+                            killer.once('error', () => { clearTimeout(limit); reject(new Error('Tree cleanup unavailable')); });
+                            killer.once('close', code => { clearTimeout(limit); if (code === 0)
+                                resolve();
+                            else
+                                reject(new Error('Tree cleanup failed')); });
+                        });
+                    }
+                    else {
+                        try {
+                            process.kill(-child.pid, 'SIGKILL');
+                        }
+                        catch (error) {
+                            if (error.code !== 'ESRCH')
+                                throw error;
+                        }
+                    }
+                }
+                await closed;
+            })(),
+            new Promise((_resolve, reject) => { deadline = setTimeout(() => reject(new Error('Helper cleanup timed out')), 3000); }),
+        ]);
+    }
+    catch {
+        // Release our handles even if a broken/escaping subprocess does not close
+        // inherited pipes. Report failed cleanup instead of promising cancellation.
+        if (child.exitCode === null && child.signalCode === null)
+            child.kill('SIGKILL');
+        child.stdin?.destroy();
+        child.stdout?.destroy();
+        child.stderr?.destroy();
+        child.unref();
+        throw new RelayHistoryError('Helper process tree cleanup failed', 'HISTORY_PLUGIN_CLEANUP_FAILED');
+    }
+    finally {
+        if (deadline !== undefined)
+            clearTimeout(deadline);
+    }
+}
+export async function helperRequest(operation, args = {}, options = {}) {
+    options.signal?.throwIfAborted();
+    const body = JSON.stringify({ version: 1, operation, args });
+    if (Buffer.byteLength(body) > 16 * 1_048_576)
+        throw new InvalidArgumentError('RelayHistory helper request exceeds 16 MiB', 'INVALID_ARGUMENT');
+    const executable = options.binaryPath ?? process.env.RELAYHISTORY_PLUGIN_BIN
+        ?? packagedBinary();
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, [], { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true, detached: process.platform !== 'win32' });
+        const decoder = new StringDecoder('utf8');
+        let output = '';
+        let bytes = 0;
+        let settled = false;
+        let closed = false;
+        const childClosed = new Promise(resolve => child.once('close', () => { closed = true; resolve(); }));
+        const finish = (error, value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', abort);
+            if (error) {
+                void terminateHelperTree(child, childClosed, () => closed).then(() => reject(error), reject);
+            }
+            else
+                resolve(value);
+        };
+        const abort = () => finish(new RelayHistoryError('RelayHistory helper operation cancelled', 'HISTORY_PLUGIN_CANCELLED'));
+        const timer = setTimeout(() => finish(new RelayHistoryError('RelayHistory helper operation timed out', 'HISTORY_PLUGIN_TIMEOUT')), options.timeoutMs ?? 60_000);
+        options.signal?.addEventListener('abort', abort, { once: true });
+        child.on('error', () => finish(new RelayHistoryError('RelayHistory helper is unavailable; install its matching platform artifact', 'HISTORY_PLUGIN_BINARY_MISSING')));
+        child.stdin.on('error', () => finish(new RelayHistoryError('RelayHistory helper input failed', 'HISTORY_PLUGIN_PROTOCOL_FAILED')));
+        // Never forward arbitrary stderr, which could contain auth or history.
+        child.stderr.resume();
+        child.stdout.on('data', (chunk) => {
+            bytes += chunk.length;
+            if (bytes > 32 * 1_048_576)
+                return finish(new RelayHistoryError('RelayHistory helper response exceeds 32 MiB', 'HISTORY_PLUGIN_PROTOCOL_FAILED'));
+            output += decoder.write(chunk);
+        });
+        child.on('close', code => {
+            if (settled)
+                return;
+            try {
+                if (code !== 0)
+                    throw new Error();
+                const envelope = JSON.parse(output + decoder.end());
+                if (envelope.version !== 1 || typeof envelope.ok !== 'boolean')
+                    throw new Error();
+                if (!envelope.ok) {
+                    const code = envelope.error?.code;
+                    if (typeof code !== 'string' || !/^[A-Z_]{1,100}$/.test(code))
+                        throw new Error();
+                    // Stable public classes come from the installed local SDK instance.
+                    const ErrorType = code === 'INVALID_ARGUMENT' ? InvalidArgumentError
+                        : code === 'UNSUPPORTED_OPERATION' ? UnsupportedOperationError
+                            : code === 'AUTHENTICATION_EXPIRED' ? AuthenticationExpiredError
+                                : code === 'CONNECTOR_FAILURE' ? ConnectorFailureError : RelayHistoryError;
+                    finish(new ErrorType(`RelayHistory operation failed (${code})`, code));
+                }
+                else
+                    finish(undefined, envelope.value);
+            }
+            catch {
+                finish(new RelayHistoryError('RelayHistory helper returned an invalid response', 'HISTORY_PLUGIN_PROTOCOL_FAILED'));
+            }
+        });
+        child.stdin.end(body);
+    });
+}
+function cloudOptions(value) {
+    const options = value;
+    return Object.fromEntries(['baseUrl', 'dbPath', 'relayAccessToken', 'label', 'interactive', 'workspace'].map(key => [key, options[key]]));
+}
+const bridge = {
+    accessToken: baseUrl => helperRequest('accessToken', { baseUrl }),
+    replay: (sessionId, options) => helperRequest('replay', { sessionId, ...options }),
+    createShareableTrace: (sessionId, visibility, source, baseUrl) => helperRequest('createShareableTrace', { sessionId, visibility, source, baseUrl }),
+    cloudLoadAuth: baseUrl => helperRequest('cloudLoadAuth', { baseUrl }),
+    cloudResolveSession: (baseUrl, now) => helperRequest('cloudResolveSession', { baseUrl, now }),
+    cloudRefreshSession: (baseUrl, rejectedToken) => helperRequest('cloudRefreshSession', { baseUrl, rejectedToken }),
+    cloudLogin: options => helperRequest('cloudLogin', { ...options }, { timeoutMs: 300_000 }),
+    enableCloud: options => helperRequest('enableCloud', cloudOptions(options), { timeoutMs: 300_000 }),
+    pushCloud: options => helperRequest('pushCloud', cloudOptions(options), { timeoutMs: 300_000 }),
+};
+export function helperCall(call) { return call(bridge); }
+//# sourceMappingURL=helper.js.map

package/dist/helper.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from 'ai-hist';
+export * from './cloud-client.js';
+export * from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from 'ai-hist';
+export * from './cloud-client.js';
+export * from './plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,100 @@
+import { type HistoryDestination, type HistoryExportRecord, type HistoryPlugin, type HistorySource } from 'ai-hist';
+import { type HelperOptions } from './helper.js';
+import { type SessionThreadQuery, type SessionThreadOptions } from './cloud-client.js';
+export interface RelayHistoryPluginOptions extends HelperOptions {
+    baseUrl?: string;
+    instanceId?: string;
+    expectedAccount?: string;
+    acknowledgeUninspectedLegacySchedules?: boolean;
+}
+export interface DeliveryReadOptions {
+    expectedAccount: string;
+    kind?: string;
+    source?: string;
+    sessionId?: string;
+    cursor?: string;
+    includeDeleted?: boolean;
+    limit?: number;
+}
+export interface DeliveryReadPage {
+    protocolVersion: 1;
+    listing: 'live';
+    records: HistoryExportRecord[];
+    nextCursor: string | null;
+}
+export declare function deliveryAccount(options?: RelayHistoryPluginOptions): Promise<string>;
+export declare function readDeliveredHistory(query: DeliveryReadOptions, options?: RelayHistoryPluginOptions): Promise<DeliveryReadPage>;
+/** Restart each traversal from the beginning: the live listing is not a change feed. */
+export declare function deliveredHistory(query: Omit<DeliveryReadOptions, 'cursor'>, options?: RelayHistoryPluginOptions): AsyncGenerator<HistoryExportRecord>;
+export declare function projectDeliveredTranscript(records: readonly HistoryExportRecord[]): {
+    originId: string;
+    recordId: string;
+    revisionId: string;
+    eventId: string | null;
+    timestampMs: number | null;
+    role: string;
+    text: string;
+    representation: import("ai-hist").HistoryEvidenceKind;
+}[];
+export declare function getDeliveredSession(query: {
+    source: string;
+    sessionId: string;
+}, options?: RelayHistoryPluginOptions): Promise<{
+    records: HistoryExportRecord[];
+    transcript: {
+        originId: string;
+        recordId: string;
+        revisionId: string;
+        eventId: string | null;
+        timestampMs: number | null;
+        role: string;
+        text: string;
+        representation: import("ai-hist").HistoryEvidenceKind;
+    }[];
+    listing: "live";
+}>;
+/** Both components use one pinned account. Legacy reads cannot rotate credentials. */
+export declare function getSessionThreadWithHistory(query: SessionThreadQuery, options?: RelayHistoryPluginOptions & SessionThreadOptions): Promise<{
+    legacyStatus: {
+        available: boolean;
+        code?: string;
+    };
+    deliveredHistory: HistoryExportRecord[];
+    transcript: {
+        originId: string;
+        recordId: string;
+        revisionId: string;
+        eventId: string | null;
+        timestampMs: number | null;
+        role: string;
+        text: string;
+        representation: import("ai-hist").HistoryEvidenceKind;
+    }[];
+    historyListing: "live";
+    session: {
+        source: string;
+        sessionId: string;
+        orgId: string;
+        workspaceId: string;
+        firstEventAt: string | null;
+        lastEventAt: string | null;
+    } | null;
+    outcomes: import("./cloud-client.js").SessionThreadOutcome[];
+    links: import("./cloud-client.js").SessionThreadLink[];
+    nextCursor: string | null;
+}>;
+/** Read-only migration check. Loading the module never inspects or changes services. */
+export interface LegacyScheduleStatus {
+    state: 'clear' | 'active' | 'unknown';
+    jobs: string[];
+}
+export declare function legacySchedules(options?: HelperOptions): Promise<LegacyScheduleStatus>;
+export declare function relayHistoryInstance(options?: RelayHistoryPluginOptions): string;
+export declare function relayHistoryDestination(options?: RelayHistoryPluginOptions): HistoryDestination;
+/** Cross-origin revisions are incomparable. Pick a stable origin/record winner
+ * for each canonical identity; readback still exposes every original record. */
+export declare function canonicalDeliveredEvidence(rows: readonly HistoryExportRecord[]): HistoryExportRecord[];
+export declare function relayHistorySource(options?: RelayHistoryPluginOptions): HistorySource;
+/** Inert registration. Network/auth/service checks occur only in invoked operations. */
+export declare function createHistoryPlugin(options?: RelayHistoryPluginOptions): HistoryPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAExB,KAAK,aAAa,EAElB,KAAK,aAAa,EAGnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,yBAA0B,SAAQ,aAAa;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC,CAAC,EAAE,OAAO,CAAC;CACjD;AACD,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,CAAC,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AACD,wBAAgB,eAAe,CAAC,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,MAAM,CAAC,CAExF;AACD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAE3B;AACD,wFAAwF;AACxF,wBAAuB,gBAAgB,CACrC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,EAC1C,OAAO,GAAE,yBAA8B,GACtC,cAAc,CAAC,mBAAmB,CAAC,CAmBrC;AACD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE;;;;;;;;;IA2CjF;AACD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC5C,OAAO,GAAE,yBAA8B;;;;;;;;;;;;;GAOxC;AACD,sFAAsF;AACtF,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,yBAAyB,GAAG,oBAAyB;;mBAmB/B,OAAO;eAAS,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;GAmBtD;AACD,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AACD,wBAAgB,eAAe,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAE1F;AAoCD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,yBAA8B,GAAG,MAAM,CAMpF;AAUD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAgDpB;AACD;gFACgF;AAChF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,SAAS,mBAAmB,EAAE,GACnC,mBAAmB,EAAE,CA4BvB;AACD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,aAAa,CA+IzF;AAiBD,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,yBAA8B,GAAG,aAAa,CAkH1F"}