@xenosystem/agents-client 0.1.3

package/dist/modelCatalog.js

@@ -0,0 +1,137 @@
+const DEFAULT_DIRECT_API_BASE = 'https://api.xenostudio.ai';
+const DEFAULT_PLATFORM_MODELS_URL = 'https://xenostudio.ai/api/models';
+const DEFAULT_TIMEOUT_MS = 10_000;
+/**
+ * Loads only live, server-advertised model identifiers. There is deliberately
+ * no bundled model-family fallback: a failed catalog lookup leaves the
+ * provider unavailable instead of presenting stale or invented choices.
+ */
+export async function loadXenoCloudModelCatalog(options = {}) {
+    const apiKey = cleanSecret(options.apiKey);
+    const webToken = cleanSecret(options.webToken);
+    if (!apiKey && !webToken) {
+        return {
+            models: [],
+            error: 'Sign in to load the live XENO model catalog.',
+        };
+    }
+    const fetchImpl = options.fetchImpl || fetch;
+    const failures = [];
+    if (apiKey) {
+        try {
+            const response = await fetchImpl(`${normalizeBase(options.directApiBase || DEFAULT_DIRECT_API_BASE)}/v1/models`, {
+                headers: { Authorization: `Bearer ${apiKey}` },
+                signal: requestSignal(options.signal, options.timeoutMs),
+            });
+            if (!response.ok)
+                throw new Error(`Direct model catalog returned HTTP ${response.status}.`);
+            const payload = await response.json();
+            const models = decorateCloudModels(readModelRecords(payload), 'api', 'available', null);
+            if (models.length > 0)
+                return { models, error: null };
+            failures.push('The direct model catalog returned no chat models.');
+        }
+        catch (error) {
+            failures.push(safeError(error, 'The direct model catalog is unavailable.'));
+        }
+    }
+    if (webToken) {
+        try {
+            const response = await fetchImpl(options.platformModelsUrl || DEFAULT_PLATFORM_MODELS_URL, {
+                headers: { Authorization: `Bearer ${webToken}` },
+                signal: requestSignal(options.signal, options.timeoutMs),
+            });
+            if (!response.ok)
+                throw new Error(`Platform model catalog returned HTTP ${response.status}.`);
+            const payload = await response.json();
+            const models = decorateCloudModels(readModelRecords(payload), 'platform-auth', 'degraded', apiKey
+                ? 'The direct catalog was unavailable; these models came from the authenticated XENO platform catalog.'
+                : 'These models came from the authenticated XENO platform catalog.');
+            if (models.length > 0)
+                return { models, error: failures[0] || null };
+            failures.push('The authenticated platform catalog returned no chat models.');
+        }
+        catch (error) {
+            failures.push(safeError(error, 'The authenticated platform model catalog is unavailable.'));
+        }
+    }
+    return {
+        models: [],
+        error: failures.join(' ')
+            || 'The live XENO model catalog is unavailable.',
+    };
+}
+function readModelRecords(payload) {
+    if (!isRecord(payload))
+        return [];
+    if (Array.isArray(payload.data))
+        return payload.data.filter(isRecord);
+    if (!isRecord(payload.companies))
+        return [];
+    const records = [];
+    for (const entries of Object.values(payload.companies)) {
+        if (!Array.isArray(entries))
+            continue;
+        for (const entry of entries) {
+            if (isRecord(entry))
+                records.push(entry);
+        }
+    }
+    return records;
+}
+function decorateCloudModels(models, source, availability, availabilityReason) {
+    return normalizeCloudChatModels(models).map((model) => ({
+        ...model,
+        source,
+        availability,
+        availabilityReason,
+    }));
+}
+function normalizeCloudChatModels(models) {
+    const normalized = [];
+    const seen = new Set();
+    for (const model of models) {
+        const id = typeof model.id === 'string' ? model.id.trim() : '';
+        if (!id || seen.has(id) || !isCloudChatModelId(id))
+            continue;
+        const type = typeof model.type === 'string' ? model.type.toLowerCase() : '';
+        if (type && !['model', 'text', 'chat', 'llm'].includes(type))
+            continue;
+        seen.add(id);
+        normalized.push({
+            id,
+            object: typeof model.object === 'string' ? model.object : 'model',
+        });
+    }
+    return normalized;
+}
+function isCloudChatModelId(id) {
+    if (!/^[a-z0-9][a-z0-9._:/-]*$/i.test(id))
+        return false;
+    return !/(^|[/_-])(imagen|nano[_-]?banana|veo|lyria|tts|whisper|audio|image|video|embed|embedding|moderation|rerank|search)([/_.-]|$)/i.test(id);
+}
+function requestSignal(signal, timeoutMs) {
+    const timeout = AbortSignal.timeout(positiveTimeout(timeoutMs));
+    return signal ? AbortSignal.any([signal, timeout]) : timeout;
+}
+function positiveTimeout(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value > 0
+        ? Math.min(Math.floor(value), 60_000)
+        : DEFAULT_TIMEOUT_MS;
+}
+function normalizeBase(value) {
+    return value.trim().replace(/\/+$/, '');
+}
+function cleanSecret(value) {
+    const cleaned = typeof value === 'string' ? value.trim() : '';
+    return cleaned || undefined;
+}
+function safeError(error, fallback) {
+    if (error instanceof Error && error.message.trim())
+        return error.message.trim().slice(0, 500);
+    return fallback;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=modelCatalog.js.map

package/dist/modelCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelCatalog.js","sourceRoot":"","sources":["../src/modelCatalog.ts"],"names":[],"mappings":"AA2BA,MAAM,uBAAuB,GAAG,2BAA2B,CAAA;AAC3D,MAAM,2BAA2B,GAAG,kCAAkC,CAAA;AACtE,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAEjC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,UAA4C,EAAE;IAE9C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9C,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,OAAO;YACL,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,8CAA8C;SACtD,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;IAC5C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAC9B,GAAG,aAAa,CAAC,OAAO,CAAC,aAAa,IAAI,uBAAuB,CAAC,YAAY,EAC9E;gBACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;gBAC9C,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;aACzD,CACF,CAAA;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAC3F,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAa,CAAA;YAChD,MAAM,MAAM,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAA;YACvF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;YACrD,QAAQ,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAA;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,0CAA0C,CAAC,CAAC,CAAA;QAC7E,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAC9B,OAAO,CAAC,iBAAiB,IAAI,2BAA2B,EACxD;gBACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,EAAE,EAAE;gBAChD,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC;aACzD,CACF,CAAA;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAC7F,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAa,CAAA;YAChD,MAAM,MAAM,GAAG,mBAAmB,CAChC,gBAAgB,CAAC,OAAO,CAAC,EACzB,eAAe,EACf,UAAU,EACV,MAAM;gBACJ,CAAC,CAAC,qGAAqG;gBACvG,CAAC,CAAC,iEAAiE,CACtE,CAAA;YACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;YACpE,QAAQ,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAA;QAC9E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,0DAA0D,CAAC,CAAC,CAAA;QAC7F,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;eACpB,6CAA6C;KACnD,CAAA;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAgB;IACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAA;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACrE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAA;IAC3C,MAAM,OAAO,GAA8D,EAAE,CAAA;IAC7E,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,QAAQ,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAiE,EACjE,MAAwB,EACxB,YAAoC,EACpC,kBAAiC;IAEjC,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtD,GAAG,KAAK;QACR,MAAM;QACN,YAAY;QACZ,kBAAkB;KACnB,CAAC,CAAC,CAAA;AACL,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAAiE;IAEjE,MAAM,UAAU,GAA0C,EAAE,CAAA;IAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC9D,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAAE,SAAQ;QAC5D,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC3E,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAQ;QACtE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACZ,UAAU,CAAC,IAAI,CAAC;YACd,EAAE;YACF,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;SAClE,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAU;IACpC,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IACvD,OAAO,CAAC,+HAA+H,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAClJ,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B,EAAE,SAA6B;IACnF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;IAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;AAC9D,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACrC,CAAC,CAAC,kBAAkB,CAAA;AACxB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,KAAyB;IAC5C,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7D,OAAO,OAAO,IAAI,SAAS,CAAA;AAC7B,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,QAAgB;IACjD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC7F,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,45 @@
+import { type AgentsClient } from './index.js';
+import { type XenoCloudModelCatalog } from './modelCatalog.js';
+export * from './index.js';
+export interface XenoCloudCredentialSnapshot {
+    apiKey?: string;
+    webToken?: string;
+}
+export interface XenoCloudCredentialSourceOptions {
+    homeDirectory?: string;
+    credentialsFile?: string;
+    settingsFile?: string;
+}
+export interface XenoCloudNodeClientOptions extends XenoCloudCredentialSourceOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+export interface DiscoverXenoCloudNodeRuntimeOptions extends XenoCloudNodeClientOptions {
+    directApiBase?: string;
+    platformModelsUrl?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface XenoCloudHostedStatus {
+    authenticated: boolean;
+    ok: boolean;
+    capabilities: string[];
+    version?: string;
+    service?: string;
+    safeUnavailableReason?: string;
+}
+export interface XenoCloudNodeRuntimeDiscovery {
+    authenticated: boolean;
+    directCredentialAvailable: boolean;
+    hostedStatus: XenoCloudHostedStatus;
+    modelCatalog: XenoCloudModelCatalog;
+}
+export declare function readXenoCloudCredentials(options?: XenoCloudCredentialSourceOptions): XenoCloudCredentialSnapshot;
+/**
+ * Returns a main-process client whose token callback rereads the brokered
+ * credential snapshot for every request. Secrets never enter renderer state.
+ */
+export declare function createXenoCloudNodeAgentsClient(options?: XenoCloudNodeClientOptions): AgentsClient;
+export declare function discoverXenoCloudNodeRuntime(options?: DiscoverXenoCloudNodeRuntimeOptions): Promise<XenoCloudNodeRuntimeDiscovery>;
+export declare function probeXenoCloudHostedStatus(options?: DiscoverXenoCloudNodeRuntimeOptions): Promise<XenoCloudHostedStatus>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAA;AAE1B,cAAc,YAAY,CAAA;AAE1B,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gCAAgC;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,0BAA2B,SAAQ,gCAAgC;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,MAAM,WAAW,mCAAoC,SAAQ,0BAA0B;IACrF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,OAAO,CAAA;IACtB,EAAE,EAAE,OAAO,CAAA;IACX,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,OAAO,CAAA;IACtB,yBAAyB,EAAE,OAAO,CAAA;IAClC,YAAY,EAAE,qBAAqB,CAAA;IACnC,YAAY,EAAE,qBAAqB,CAAA;CACpC;AAED,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,gCAAqC,GAC7C,2BAA2B,CAc7B;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,0BAA+B,GACvC,YAAY,CAMd;AAED,wBAAsB,4BAA4B,CAChD,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,6BAA6B,CAAC,CAqBxC;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,qBAAqB,CAAC,CAEhC"}

package/dist/node.js

@@ -0,0 +1,106 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { createAgentsClient, } from './index.js';
+import { loadXenoCloudModelCatalog, } from './modelCatalog.js';
+export * from './index.js';
+export function readXenoCloudCredentials(options = {}) {
+    const homeDirectory = options.homeDirectory || homedir();
+    const credentials = readJsonRecord(options.credentialsFile || join(homeDirectory, '.xeno', 'credentials.json'));
+    const settings = readJsonRecord(options.settingsFile || join(homeDirectory, '.xeno', 'settings.json'));
+    const apiKey = cleanSecret(settings?.llmApiKey) || cleanSecret(credentials?.apiKey);
+    const webToken = cleanSecret(credentials?.webToken);
+    return {
+        ...(apiKey ? { apiKey } : {}),
+        ...(webToken ? { webToken } : {}),
+    };
+}
+/**
+ * Returns a main-process client whose token callback rereads the brokered
+ * credential snapshot for every request. Secrets never enter renderer state.
+ */
+export function createXenoCloudNodeAgentsClient(options = {}) {
+    return createAgentsClient({
+        ...(options.baseUrl ? { baseUrl: options.baseUrl } : {}),
+        token: () => readXenoCloudCredentials(options).webToken || '',
+        ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+    });
+}
+export async function discoverXenoCloudNodeRuntime(options = {}) {
+    const credentials = readXenoCloudCredentials(options);
+    const modelOptions = {
+        ...(credentials.apiKey ? { apiKey: credentials.apiKey } : {}),
+        ...(credentials.webToken ? { webToken: credentials.webToken } : {}),
+        ...(options.directApiBase ? { directApiBase: options.directApiBase } : {}),
+        ...(options.platformModelsUrl ? { platformModelsUrl: options.platformModelsUrl } : {}),
+        ...(options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}),
+        ...(options.signal ? { signal: options.signal } : {}),
+        ...(options.timeoutMs ? { timeoutMs: options.timeoutMs } : {}),
+    };
+    const [modelCatalog, hostedStatus] = await Promise.all([
+        loadXenoCloudModelCatalog(modelOptions),
+        loadHostedStatusWithToken(credentials.webToken, options),
+    ]);
+    return {
+        authenticated: Boolean(credentials.webToken),
+        directCredentialAvailable: Boolean(credentials.apiKey),
+        hostedStatus,
+        modelCatalog,
+    };
+}
+export async function probeXenoCloudHostedStatus(options = {}) {
+    return loadHostedStatusWithToken(readXenoCloudCredentials(options).webToken, options);
+}
+async function loadHostedStatusWithToken(webToken, options) {
+    if (!webToken) {
+        return {
+            authenticated: false,
+            ok: false,
+            capabilities: [],
+            safeUnavailableReason: 'Sign in to use hosted XENO Agent runs.',
+        };
+    }
+    try {
+        const status = await createXenoCloudNodeAgentsClient(options).status(options.signal ? { signal: options.signal } : undefined);
+        return {
+            authenticated: true,
+            ok: status.ok === true,
+            capabilities: Array.isArray(status.capabilities) ? [...status.capabilities] : [],
+            ...(status.version ? { version: status.version } : {}),
+            ...(status.service ? { service: status.service } : {}),
+            ...(status.ok === true ? {} : { safeUnavailableReason: 'The hosted XENO Agent service is unavailable.' }),
+        };
+    }
+    catch (error) {
+        return {
+            authenticated: true,
+            ok: false,
+            capabilities: [],
+            safeUnavailableReason: safeError(error),
+        };
+    }
+}
+function readJsonRecord(path) {
+    try {
+        if (!existsSync(path))
+            return undefined;
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        return isRecord(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function cleanSecret(value) {
+    const cleaned = typeof value === 'string' ? value.trim() : '';
+    return cleaned || undefined;
+}
+function safeError(error) {
+    if (error instanceof Error && error.message.trim())
+        return error.message.trim().slice(0, 500);
+    return 'The hosted XENO Agent service is unavailable.';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@xenosystem/agents-client",
+  "version": "0.1.3",
+  "license": "UNLICENSED",
+  "description": "Portable authenticated client for the hosted XENO Agents run API.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/XENO-CORPORATION/xeno-agent-interface.git",
+    "directory": "packages/cloud-client"
+  },
+  "scripts": {}
+}