@axiom-lattice/client-sdk 4.3.2 → 4.3.4

package/dist/__tests__/runtime-client.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * RuntimeAxiomClient transport tests.
+ *
+ * Asserts the reuse-first transport: the Console client's own `/api/...`
+ * paths land on the gateway's `/runtime/api` console mirror, baseURL points
+ * at the web app runtime, and the web-app identity (verified bearer or
+ * unverified external-user header) is injected per request.
+ */
+export {};
+//# sourceMappingURL=runtime-client.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runtime-client.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/runtime-client.test.js

@@ -0,0 +1,113 @@
+/**
+ * RuntimeAxiomClient transport tests.
+ *
+ * Asserts the reuse-first transport: the Console client's own `/api/...`
+ * paths land on the gateway's `/runtime/api` console mirror, baseURL points
+ * at the web app runtime, and the web-app identity (verified bearer or
+ * unverified external-user header) is injected per request.
+ */
+import { RuntimeAxiomClient } from "../runtime-client";
+const mockFetch = jest.fn();
+global.fetch = mockFetch;
+function mockJsonResponse(body, status = 200) {
+    mockFetch.mockResolvedValue({
+        ok: status < 400,
+        status,
+        json: async () => body,
+    });
+}
+function makeVerifiedClient(token = "tok-1") {
+    return new RuntimeAxiomClient({
+        gatewayUrl: "http://gw.test",
+        webAppId: "webapp_1",
+        assistantId: "asst-1",
+        transport: "sse",
+        identity: { mode: "verified", tokenProvider: async () => token },
+    });
+}
+function makeUnverifiedClient() {
+    return new RuntimeAxiomClient({
+        gatewayUrl: "http://gw.test/",
+        webAppId: "webapp_1",
+        assistantId: "asst-1",
+        transport: "sse",
+        identity: { mode: "unverified", userId: "vendor-user-42" },
+    });
+}
+/** Drive the transport exactly like the chat stack's threads.list does. */
+async function listThreads(client) {
+    return client.listThreads();
+}
+function lastRequest() {
+    const [url, init] = mockFetch.mock.calls[0];
+    return [url, init];
+}
+describe("RuntimeAxiomClient", () => {
+    afterEach(() => mockFetch.mockClear());
+    it("points every Console /api path at the /runtime/api mirror", async () => {
+        const client = makeVerifiedClient();
+        mockJsonResponse({ success: true, data: { records: [] } });
+        await listThreads(client);
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        const [url] = lastRequest();
+        expect(url).toBe("http://gw.test/api/web-apps/webapp_1/runtime/api/assistants/asst-1/threads");
+    });
+    it("resolves and injects the bearer lazily (no explicit primeToken call)", async () => {
+        const client = makeVerifiedClient("tok-1");
+        mockJsonResponse({ success: true, data: { records: [] } });
+        await listThreads(client);
+        expect(new Headers(lastRequest()[1].headers).get("Authorization")).toBe("Bearer tok-1");
+    });
+    it("single-flights the token provider across concurrent requests", async () => {
+        const provider = jest.fn().mockResolvedValue("tok-2");
+        const client = new RuntimeAxiomClient({
+            gatewayUrl: "http://gw.test",
+            webAppId: "webapp_1",
+            assistantId: "asst-1",
+            transport: "sse",
+            identity: { mode: "verified", tokenProvider: provider },
+        });
+        mockJsonResponse({ success: true, data: { records: [] } });
+        await Promise.all([listThreads(client), listThreads(client)]);
+        expect(provider).toHaveBeenCalledTimes(1);
+    });
+    it("injects X-Axiom-External-User-Id in unverified mode (no Authorization)", async () => {
+        const client = makeUnverifiedClient();
+        mockJsonResponse({ success: true, data: { records: [] } });
+        await listThreads(client);
+        const headers = new Headers(lastRequest()[1].headers);
+        expect(headers.get("X-Axiom-External-User-Id")).toBe("vendor-user-42");
+        expect(headers.get("Authorization")).toBeNull();
+    });
+    it("trims a trailing slash from the gateway URL", async () => {
+        const client = makeUnverifiedClient();
+        mockJsonResponse({ success: true, data: { records: [] } });
+        await listThreads(client);
+        expect(lastRequest()[0]).toContain("/api/web-apps/webapp_1/runtime/api/");
+    });
+    it("rejects an unverified identity with an empty userId", () => {
+        expect(() => new RuntimeAxiomClient({
+            gatewayUrl: "http://gw.test",
+            webAppId: "webapp_1",
+            assistantId: "asst-1",
+            transport: "sse",
+            identity: { mode: "unverified", userId: "" },
+        })).toThrow(/non-empty userId/);
+    });
+    it("rethrows non-ok responses with a status-carrying error", async () => {
+        const client = makeVerifiedClient();
+        mockJsonResponse({ error: "nope" }, 401);
+        await expect(listThreads(client)).rejects.toMatchObject({ status: 401 });
+    });
+    it("clones into a sibling runtime client scoped to the cloned assistant", async () => {
+        const client = makeVerifiedClient("tok-1");
+        mockJsonResponse({ success: true, data: { records: [] } });
+        const clone = client.clone({ assistantId: "asst-2" });
+        expect(clone).not.toBe(client);
+        await listThreads(clone);
+        const [url, init] = lastRequest();
+        expect(url).toContain("/runtime/api/assistants/asst-2/threads");
+        expect(new Headers(init.headers).get("Authorization")).toBe("Bearer tok-1");
+    });
+});
+//# sourceMappingURL=runtime-client.test.js.map

package/dist/__tests__/runtime-client.test.js.map

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

package/dist/index.d.ts

@@ -2118,6 +2118,70 @@ declare class Client extends AbstractClient {
     private streamRun;
 }
 
+/**
+ * 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.
+ */
+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.
+ */
+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;
+}
+
 /**
  * WeChat Mini Program client for interacting with the Axiom Lattice Agent Service API
  */
@@ -2288,4 +2352,4 @@ declare function createSimpleMessageMerger(): {
     reset: () => void;
 };
 
-export { A2AKeyListItem, A2AKeysListResponse, AbortAgentParams, AbstractClient, AddProjectBotMembershipInput, AddProjectMembershipInput, AgentState, AgentWebAppsListResponse, ApiError, ArchiveInput, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, CapabilityBundleListResponse, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CompleteTaskInput, CompleteTaskResponse, CreateA2AKeyInput, CreateAssistantOptions, CreateProjectRequest, CreateThreadOptions, CreateWorkspaceRequest, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportBundle, ExportConfigResult, ExportConfirmationRequired, ExportDownload, ExportEntityIds, ExportEntityPreview, ExportEntityPreviewMap, ExportImportClient, ExportJobResult, ExportableEntity, ExportableTypeInfo, FileItem, GetMessagesOptions, GetScheduledTasksOptions, HydratedProjectRoomBusinessEvent, ImportApplyResult, ImportConflict, ImportEntityResult, ImportInsertion, ImportPreviewError, ImportPreviewResult, ImportResolution, ImportResolutions, ImportSource, InvalidCapabilityBundleSummary, ListAgentWebAppsParams, ListProjectRoomMessagesOptions, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, MetricsConfigResponse, MetricsConfigsListResponse, MutationExpectedUpdatedAt, NetworkError, PendingMessage, Project, ProjectCapabilitiesResponse, ProjectKind, ProjectRoomBotRecord, ProjectRoomClientError, ProjectRoomDispatchErrorCode, ProjectRoomDispatchResult, ProjectRoomEventConnection, ProjectRoomMembershipRecord, ProjectRoomMessageRecord, ProjectRoomPublicBotRecord, ProjectRoomPublicMembershipRecord, ProjectRoomRecord, ProjectRoomSendResult, ProjectRoomSseFrame, ProjectRoomsClient, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeStreamOptions, RetryConfig, RunOptions, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, SendProjectRoomMessageInput, StorageType, StreamCallbacks, StreamEvent, TaskLifecycleWarning, TaskResponse, TasksListResponse, TestConnectionResponse, TestMcpServerResponse, Thread, ThreadListResponse, ThreadResponse, Tool, ToolResponse, ToolsListResponse, Transport, UpdateAssistantOptions, UpdateProjectBotMembershipInput, UpdateProjectMembershipInput, UpdateProjectRequest, UpdateThreadOptions, UpdateWorkspaceRequest, WeChatClient, Workspace, WorkspaceClient, createSimpleMessageMerger };
+export { A2AKeyListItem, A2AKeysListResponse, AbortAgentParams, AbstractClient, AddProjectBotMembershipInput, AddProjectMembershipInput, AgentState, AgentWebAppsListResponse, ApiError, ArchiveInput, Assistant, AssistantListResponse, AssistantResponse, AuthenticationError, CapabilityBundleListResponse, ChatResponse, ChatSendOptions, ChatStreamOptions, Client, ClientConfig, CompleteTaskInput, CompleteTaskResponse, CreateA2AKeyInput, CreateAssistantOptions, CreateProjectRequest, CreateThreadOptions, CreateWorkspaceRequest, DatabaseConfigResponse, DatabaseConfigsListResponse, DatasourcesListResponse, ExportBundle, ExportConfigResult, ExportConfirmationRequired, ExportDownload, ExportEntityIds, ExportEntityPreview, ExportEntityPreviewMap, ExportImportClient, ExportJobResult, ExportableEntity, ExportableTypeInfo, FileItem, GetMessagesOptions, GetScheduledTasksOptions, HydratedProjectRoomBusinessEvent, ImportApplyResult, ImportConflict, ImportEntityResult, ImportInsertion, ImportPreviewError, ImportPreviewResult, ImportResolution, ImportResolutions, ImportSource, InvalidCapabilityBundleSummary, ListAgentWebAppsParams, ListProjectRoomMessagesOptions, ListThreadsOptions, LocalA2ATemplatesListResponse, McpServerResponse, McpServersListResponse, MetricsConfigResponse, MetricsConfigsListResponse, MutationExpectedUpdatedAt, NetworkError, PendingMessage, Project, ProjectCapabilitiesResponse, ProjectKind, ProjectRoomBotRecord, ProjectRoomClientError, ProjectRoomDispatchErrorCode, ProjectRoomDispatchResult, ProjectRoomEventConnection, ProjectRoomMembershipRecord, ProjectRoomMessageRecord, ProjectRoomPublicBotRecord, ProjectRoomPublicMembershipRecord, ProjectRoomRecord, ProjectRoomSendResult, ProjectRoomSseFrame, ProjectRoomsClient, RegisterToolOptions, RemovePendingMessageOptions, ResourcesClient, ResumeStreamOptions, RetryConfig, RunOptions, RuntimeAxiomClient, RuntimeAxiomIdentity, ScheduleExecutionType, ScheduledTask, ScheduledTaskStatus, ScheduledTasksListResponse, SendProjectRoomMessageInput, StorageType, StreamCallbacks, StreamEvent, TaskLifecycleWarning, TaskResponse, TasksListResponse, TestConnectionResponse, TestMcpServerResponse, Thread, ThreadListResponse, ThreadResponse, Tool, ToolResponse, ToolsListResponse, Transport, UpdateAssistantOptions, UpdateProjectBotMembershipInput, UpdateProjectMembershipInput, UpdateProjectRequest, UpdateThreadOptions, UpdateWorkspaceRequest, WeChatClient, Workspace, WorkspaceClient, createSimpleMessageMerger };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1837,6 +1837,7 @@ __export(src_exports, {
   ProjectRoomClientError: () => ProjectRoomClientError,
   ProjectRoomsClient: () => ProjectRoomsClient,
   ResourcesClient: () => ResourcesClient,
+  RuntimeAxiomClient: () => RuntimeAxiomClient,
   ScheduleExecutionType: () => ScheduleExecutionType,
   ScheduledTaskStatus: () => ScheduledTaskStatus,
   WeChatClient: () => WeChatClient,
@@ -4189,6 +4190,115 @@ var _Client = class extends AbstractClient {
 var Client = _Client;
 Client.globalWorkspaceHeaders = {};
 
+// src/runtime-client.ts
+var RuntimeAxiomClient = class 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 !== void 0) {
+      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 {
+      }
+      const error = new Error(message);
+      error.status = response.status;
+      throw error;
+    }
+    if (response.status === 204)
+      return void 0;
+    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 !== void 0 ? { timeout: config.timeout } : {},
+      ...config.headers !== void 0 ? { headers: config.headers } : {},
+      ...config.retry !== void 0 ? { retry: config.retry } : {}
+    });
+  }
+  streamRequest(_options, _onEvent, _onComplete, _onError) {
+    throw new Error("RuntimeAxiomClient uses resumeStream; chat.stream is unsupported");
+  }
+};
+
 // src/wechat-client.ts
 var import_encoding = __toESM(require_encoding());
 var WeChatClient = class extends AbstractClient {
@@ -4934,6 +5044,7 @@ function createSimpleMessageMerger() {
   ProjectRoomClientError,
   ProjectRoomsClient,
   ResourcesClient,
+  RuntimeAxiomClient,
   ScheduleExecutionType,
   ScheduledTaskStatus,
   WeChatClient,