@relayhistory/provider-sources 0.18.2 → 0.18.8

package/dist/helper.d.ts

@@ -0,0 +1,12 @@
+import { type ChildProcess } from 'node:child_process';
+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>;
+//# 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,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"}

package/dist/helper.js

@@ -0,0 +1,143 @@
+/** Bounded, cancellable bridge to the optional provider-source 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 = 'history-provider-sources' + (process.platform === 'win32' ? '.exe' : '');
+    try {
+        return join(dirname(createRequire(import.meta.url).resolve('@relayhistory/provider-sources-' + 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('Provider source helper request exceeds 16 MiB', 'INVALID_ARGUMENT');
+    const executable = options.binaryPath ?? process.env.HISTORY_PROVIDER_SOURCES_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('Provider source helper operation cancelled', 'HISTORY_PLUGIN_CANCELLED'));
+        const timer = setTimeout(() => finish(new RelayHistoryError('Provider source helper operation timed out', 'HISTORY_PLUGIN_TIMEOUT')), options.timeoutMs ?? 60_000);
+        options.signal?.addEventListener('abort', abort, { once: true });
+        child.on('error', () => finish(new RelayHistoryError('Provider source helper is unavailable; install its matching platform artifact', 'HISTORY_PLUGIN_BINARY_MISSING')));
+        child.stdin.on('error', () => finish(new RelayHistoryError('Provider source 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('Provider source 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(`Provider source operation failed (${code})`, code));
+                }
+                else
+                    finish(undefined, envelope.value);
+            }
+            catch {
+                finish(new RelayHistoryError('Provider source helper returned an invalid response', 'HISTORY_PLUGIN_PROTOCOL_FAILED'));
+            }
+        });
+        child.stdin.end(body);
+    });
+}
+//# 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,10 @@
+import { type HistoryPlugin } from 'ai-hist';
+import { type HelperOptions } from './helper.js';
+export interface ProviderSourceOptions extends HelperOptions {
+    connectors?: Array<'claude-web' | 'codex-cloud'>;
+    instanceId?: string;
+}
+/** Registration is inert; provider credentials are read only by selected acquisitions. */
+export declare function createHistoryPlugin(options?: ProviderSourceOptions): HistoryPlugin;
+export type { HistorySource } from 'ai-hist';
+//# 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,OAAO,EAGL,KAAK,aAAa,EAInB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,UAAU,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,aAAa,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,0FAA0F;AAC1F,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa,CAkCtF;AACD,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { InvalidArgumentError, } from 'ai-hist';
+import { helperRequest } from './helper.js';
+/** Registration is inert; provider credentials are read only by selected acquisitions. */
+export function createHistoryPlugin(options = {}) {
+    const connectors = options.connectors ?? ['claude-web', 'codex-cloud'];
+    if (!Array.isArray(connectors) ||
+        connectors.some((id) => id !== 'claude-web' && id !== 'codex-cloud') ||
+        new Set(connectors).size !== connectors.length)
+        throw new InvalidArgumentError('Provider connectors must be unique claude-web or codex-cloud IDs', 'INVALID_ARGUMENT');
+    const sources = connectors.map((connectorId) => {
+        const source = connectorId === 'claude-web' ? 'claude' : 'codex';
+        const connectorInstance = options.instanceId ?? 'default';
+        return {
+            id: connectorId,
+            instanceId: connectorInstance,
+            location: 'remote',
+            supportedSources: [source],
+            discover: async (query) => helperRequest('discover', { connectorId, connectorInstance, source, limit: query.limit }, { ...options, signal: query.signal, timeoutMs: query.acquisitionTimeoutMs ?? options.timeoutMs }),
+            hydrate: async (observation, context) => helperRequest('hydrate', { connectorId, connectorInstance, observation }, { ...options, signal: context.signal, timeoutMs: context.acquisitionTimeoutMs ?? options.timeoutMs }),
+        };
+    });
+    return { sources };
+}
+//# 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,OAAO,EACL,oBAAoB,GAMrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAKhE,0FAA0F;AAC1F,MAAM,UAAU,mBAAmB,CAAC,UAAiC,EAAE;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACvE,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAC1B,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,YAAY,IAAI,EAAE,KAAK,aAAa,CAAC;QACpE,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM;QAE9C,MAAM,IAAI,oBAAoB,CAC5B,kEAAkE,EAClE,kBAAkB,CACnB,CAAC;IACJ,MAAM,OAAO,GAAoB,UAAU,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QAC9D,MAAM,MAAM,GAAkB,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;QAChF,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;QAC1D,OAAO;YACL,EAAE,EAAE,WAAW;YACf,UAAU,EAAE,iBAAiB;YAC7B,QAAQ,EAAE,QAAQ;YAClB,gBAAgB,EAAE,CAAC,MAAM,CAAC;YAC1B,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACxB,aAAa,CACX,UAAU,EACV,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,EAC9D,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,oBAAoB,IAAI,OAAO,CAAC,SAAS,EAAE,CACjG;YACH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CACtC,aAAa,CACX,SAAS,EACT,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,EAC/C,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,oBAAoB,IAAI,OAAO,CAAC,SAAS,EAAE,CACrG;SACJ,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,16 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { HistoryPluginRegistry, InvalidArgumentError } from 'ai-hist';
+import { createHistoryPlugin } from './index.js';
+import { helperRequest } from './helper.js';
+test('provider package registration is inert and connector IDs are selected explicitly', () => {
+    const registry = new HistoryPluginRegistry();
+    registry.register(createHistoryPlugin({ binaryPath: '/fixture/must-not-run' }));
+    assert.deepEqual(registry.sourceConnectors(['claude-web']).map((source) => source.id), ['claude-web']);
+    assert.deepEqual(registry.sourceConnectors([]), []);
+    assert.throws(() => createHistoryPlugin({ connectors: ['claude-web', 'claude-web'] }), InvalidArgumentError);
+});
+test('actual provider helper rejects invalid selector before provider credential access', async () => {
+    await assert.rejects(helperRequest('discover', { connectorId: 'fixture-not-a-provider' }), (error) => error instanceof InvalidArgumentError);
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,IAAI,CAAC,kFAAkF,EAAE,GAAG,EAAE;IAC5F,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;IAChF,MAAM,CAAC,SAAS,CACd,QAAQ,CAAC,gBAAgB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EACpE,CAAC,YAAY,CAAC,CACf,CAAC;IACF,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACpD,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,mBAAmB,CAAC,EAAE,UAAU,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC,EACvE,oBAAoB,CACrB,CAAC;AACJ,CAAC,CAAC,CAAC;AACH,IAAI,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;IACnG,MAAM,MAAM,CAAC,OAAO,CAClB,aAAa,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC,EACpE,CAAC,KAAc,EAAE,EAAE,CAAC,KAAK,YAAY,oBAAoB,CAC1D,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@relayhistory/provider-sources",
-  "version": "0.18.2",
+  "version": "0.18.8",
   "description": "Optional Claude web and Codex cloud source adapters for local ai-hist.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/relayhistory",
+    "directory": "plugins/provider-sources/sdk"
+  },
   "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +29,7 @@
     "test": "npm run build && node --test dist/*.test.js"
   },
   "peerDependencies": {
-    "ai-hist": "^0.18.2"
+    "ai-hist": "^0.18.8"
   },
   "devDependencies": {
     "ai-hist": "file:../../../sdk-ts",
@@ -35,13 +40,13 @@
     "node": ">=20"
   },
   "optionalDependencies": {
-    "@relayhistory/provider-sources-darwin-arm64": "0.18.2",
-    "@relayhistory/provider-sources-darwin-x64": "0.18.2",
-    "@relayhistory/provider-sources-linux-x64-gnu": "0.18.2",
-    "@relayhistory/provider-sources-linux-arm64-gnu": "0.18.2",
-    "@relayhistory/provider-sources-linux-x64-musl": "0.18.2",
-    "@relayhistory/provider-sources-linux-arm64-musl": "0.18.2",
-    "@relayhistory/provider-sources-win32-x64-msvc": "0.18.2"
+    "@relayhistory/provider-sources-darwin-arm64": "0.18.8",
+    "@relayhistory/provider-sources-darwin-x64": "0.18.8",
+    "@relayhistory/provider-sources-linux-x64-gnu": "0.18.8",
+    "@relayhistory/provider-sources-linux-arm64-gnu": "0.18.8",
+    "@relayhistory/provider-sources-linux-x64-musl": "0.18.8",
+    "@relayhistory/provider-sources-linux-arm64-musl": "0.18.8",
+    "@relayhistory/provider-sources-win32-x64-msvc": "0.18.8"
   },
   "publishConfig": {
     "access": "public"