@axiom-lattice/client-sdk 4.3.2 → 4.3.4

package/dist/runtime-client.d.ts

@@ -0,0 +1,67 @@
+import { Client } from "./client";
+import type { MessageChunk } from "@axiom-lattice/protocols";
+import type { AgentState, ClientConfig, RunOptions } from "./types";
+/**
+ * Identity presented to an Agent Web App runtime by {@link RuntimeAxiomClient}.
+ *
+ * Mirrors the web-app SDK identity union: `verified` sessions authenticate
+ * with a short-lived `Authorization: Bearer` token resolved (and refreshed)
+ * per transport use, while `unverified` sessions identify through the stable
+ * `X-Axiom-External-User-Id` header the gateway accepts without a token.
+ */
+export type RuntimeAxiomIdentity = {
+    mode: "verified";
+    tokenProvider: () => Promise<string>;
+} | {
+    mode: "unverified";
+    userId: string;
+};
+/**
+ * AxiomClient transport wired to an Agent Web App runtime instead of the
+ * Console. Reuse-first: only the transport differs. `baseURL` points at
+ * `<gateway>/api/web-apps/:webAppId/runtime`, every Console `/api/...` path
+ * the chat stack produces lands on the gateway's `/runtime/api` console
+ * mirror, and the web-app identity (bearer or external-user header) is
+ * injected fresh per request.
+ *
+ * The chat stack (AgentThreadContext + Chating) therefore runs unmodified.
+ */
+export declare class RuntimeAxiomClient extends Client {
+    private readonly gatewayUrl;
+    private readonly webAppId;
+    private readonly identity;
+    private token;
+    private tokenPromise;
+    constructor(config: Omit<ClientConfig, "apiKey" | "baseURL"> & {
+        gatewayUrl: string;
+        webAppId: string;
+        identity: RuntimeAxiomIdentity;
+    });
+    /**
+     * Resolve (and cache) the current identity credential.
+     *
+     * - `verified`: resolves the bearer token from the provider (single-flight;
+     *   call again later to force a refresh, or pass through a fresh provider).
+     * - `unverified`: no credential is needed; returns `""`.
+     *
+     * Transport methods resolve this lazily, so the chat stack needs no explicit
+     * priming — the first request triggers the token provider.
+     */
+    primeToken(): Promise<string>;
+    private identityHeaders;
+    protected getAllHeaders(): Record<string, string>;
+    protected makeRequest<T>(url: string, options?: {
+        method?: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    private getBaseUrl;
+    /**
+     * Clone into a real sibling instance sharing the runtime identity so the
+     * `AxiomLatticeProvider` per-assistant `clone({ assistantId })` cache keeps
+     * working (each clone carries its own resolved credential cache).
+     */
+    protected createInstance(config: ClientConfig): Client;
+    protected streamRequest(_options: RunOptions, _onEvent: (event: MessageChunk) => void, _onComplete?: (state?: AgentState) => void, _onError?: (error: Error) => void): () => void;
+}
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../src/runtime-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;;;;;;;;GASG;AACH,qBAAa,kBAAmB,SAAQ,MAAM;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAAgC;gBAExC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG;QAC7D,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,oBAAoB,CAAC;KAChC;IAcD;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWnC,OAAO,CAAC,eAAe;IAOvB,SAAS,CAAC,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAQjC,WAAW,CAAC,CAAC,EAC3B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC9E,OAAO,CAAC,CAAC,CAAC;IAkCb,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAatD,SAAS,CAAC,aAAa,CACrB,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,EACvC,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,UAAU,KAAK,IAAI,EAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAChC,MAAM,IAAI;CAGd"}

package/dist/runtime-client.js

@@ -0,0 +1,122 @@
+import { Client } from "./client";
+/**
+ * AxiomClient transport wired to an Agent Web App runtime instead of the
+ * Console. Reuse-first: only the transport differs. `baseURL` points at
+ * `<gateway>/api/web-apps/:webAppId/runtime`, every Console `/api/...` path
+ * the chat stack produces lands on the gateway's `/runtime/api` console
+ * mirror, and the web-app identity (bearer or external-user header) is
+ * injected fresh per request.
+ *
+ * The chat stack (AgentThreadContext + Chating) therefore runs unmodified.
+ */
+export class RuntimeAxiomClient extends Client {
+    constructor(config) {
+        super({
+            ...config,
+            baseURL: `${config.gatewayUrl.replace(/\/$/, "")}/api/web-apps/${config.webAppId}/runtime`,
+            apiKey: "runtime-bearer",
+        });
+        this.token = null;
+        this.tokenPromise = null;
+        this.gatewayUrl = config.gatewayUrl.replace(/\/$/, "");
+        this.webAppId = config.webAppId;
+        this.identity = config.identity;
+        if (config.identity.mode === "unverified" && config.identity.userId.length === 0) {
+            throw new Error("RuntimeAxiomClient requires a non-empty userId in unverified mode");
+        }
+    }
+    /**
+     * Resolve (and cache) the current identity credential.
+     *
+     * - `verified`: resolves the bearer token from the provider (single-flight;
+     *   call again later to force a refresh, or pass through a fresh provider).
+     * - `unverified`: no credential is needed; returns `""`.
+     *
+     * Transport methods resolve this lazily, so the chat stack needs no explicit
+     * priming — the first request triggers the token provider.
+     */
+    async primeToken() {
+        if (this.identity.mode !== "verified")
+            return "";
+        if (!this.tokenPromise) {
+            this.tokenPromise = this.identity.tokenProvider().then((token) => {
+                this.token = token;
+                return token;
+            });
+        }
+        return this.tokenPromise;
+    }
+    identityHeaders() {
+        if (this.identity.mode === "verified") {
+            return { Authorization: `Bearer ${this.token ?? ""}` };
+        }
+        return { "X-Axiom-External-User-Id": this.identity.userId };
+    }
+    getAllHeaders() {
+        const workspace = this.getWorkspaceHeaders();
+        return {
+            ...this.identityHeaders(),
+            ...workspace,
+        };
+    }
+    async makeRequest(url, options) {
+        await this.primeToken();
+        const method = options?.method ?? "GET";
+        const headers = {
+            "Content-Type": "application/json",
+            ...this.identityHeaders(),
+            ...(options?.headers ?? {}),
+        };
+        const requestOptions = { method, headers };
+        if (options?.body !== undefined) {
+            if (options.body instanceof FormData) {
+                requestOptions.body = options.body;
+                delete headers["Content-Type"];
+            }
+            else {
+                requestOptions.body = JSON.stringify(options.body);
+            }
+        }
+        const response = await fetch(`${this.getBaseUrl()}${url}`, requestOptions);
+        if (!response.ok) {
+            let message = `HTTP ${response.status}`;
+            try {
+                const body = (await response.json());
+                message = body.error ?? body.message ?? message;
+            }
+            catch {
+                /* keep the status message */
+            }
+            const error = new Error(message);
+            error.status = response.status;
+            throw error;
+        }
+        if (response.status === 204)
+            return undefined;
+        return (await response.json());
+    }
+    getBaseUrl() {
+        return this.config.baseURL;
+    }
+    /**
+     * Clone into a real sibling instance sharing the runtime identity so the
+     * `AxiomLatticeProvider` per-assistant `clone({ assistantId })` cache keeps
+     * working (each clone carries its own resolved credential cache).
+     */
+    createInstance(config) {
+        return new RuntimeAxiomClient({
+            gatewayUrl: this.gatewayUrl,
+            webAppId: this.webAppId,
+            identity: this.identity,
+            assistantId: config.assistantId,
+            transport: config.transport,
+            ...(config.timeout !== undefined ? { timeout: config.timeout } : {}),
+            ...(config.headers !== undefined ? { headers: config.headers } : {}),
+            ...(config.retry !== undefined ? { retry: config.retry } : {}),
+        });
+    }
+    streamRequest(_options, _onEvent, _onComplete, _onError) {
+        throw new Error("RuntimeAxiomClient uses resumeStream; chat.stream is unsupported");
+    }
+}
+//# sourceMappingURL=runtime-client.js.map

package/dist/runtime-client.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiom-lattice/client-sdk",
-  "version": "4.3.2",
+  "version": "4.3.4",
   "description": "TypeScript client SDK for interacting with the Agent Service API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "best-effort-json-parser": "^1.2.1",
-    "@axiom-lattice/protocols": "4.1.3"
+    "@axiom-lattice/protocols": "4.1.4"
   },
   "scripts": {
     "build": "tsc &&tsup src/index.ts --format cjs,esm --dts --sourcemap",