@agents24/client 0.1.0 → 0.2.1

package/dist/bff.d.ts

@@ -0,0 +1,10 @@
+import type { AgentClient, FetchLike, MultipartEncoder, TextDecoderLike, TextEncoderLike } from "./types.js";
+export interface Agents24BffClientOptions {
+    basePath?: string;
+    fetch?: FetchLike;
+    decoder?: () => TextDecoderLike;
+    encoder?: TextEncoderLike;
+    multipart?: MultipartEncoder;
+    maxReconnectAttempts?: number;
+}
+export declare function createBffAgentClient(options?: Agents24BffClientOptions): AgentClient;

package/dist/bff.js

@@ -0,0 +1,282 @@
+import { resolveFetch, resolveDecoderFactory, resolveEncoder, defaultIds, encodePath, createByteMultipartEncoder, appendQuery, consumeThreadSummaryStream, Agents24ClientError, responseError, responseJson, consumeRuntimeStream } from './chunk-GXISGBVW.js';
+import './chunk-IOVCURGW.js';
+
+// src/bff.ts
+function normalizeBasePath(value) {
+  const path = String(value || "/api/agents24").trim();
+  if (!path.startsWith("/") || /[\r\n\0?#]/.test(path)) {
+    throw new Agents24ClientError("basePath must be a same-origin absolute path.", {
+      kind: "configuration",
+      code: "INVALID_BFF_BASE_PATH"
+    });
+  }
+  return path.replace(/\/+$/, "");
+}
+function objectResult(value, operation) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Agents24ClientError(`${operation} returned an invalid response.`, {
+      kind: "protocol",
+      code: "INVALID_JSON_RESPONSE"
+    });
+  }
+  return value;
+}
+function shouldReconnect(error) {
+  return error instanceof Agents24ClientError && error.kind === "network" && error.retryable;
+}
+function createBffAgentClient(options = {}) {
+  const basePath = normalizeBasePath(options.basePath);
+  const fetch = resolveFetch(options.fetch);
+  const decoder = resolveDecoderFactory(options.decoder);
+  const encoder = resolveEncoder(options.encoder);
+  const ids = defaultIds();
+  const maxReconnectAttempts = Math.max(0, Math.min(options.maxReconnectAttempts ?? 3, 10));
+  const request = async (method, path, init = {}) => {
+    let response;
+    try {
+      response = await fetch(`${basePath}${path}`, {
+        method,
+        headers: {
+          Accept: init.accept || "application/json",
+          ...init.contentType ? { "Content-Type": init.contentType } : {},
+          ...init.idempotencyKey ? { "Idempotency-Key": init.idempotencyKey } : {}
+        },
+        ...init.body === void 0 ? {} : { body: init.body },
+        ...init.signal ? { signal: init.signal } : {},
+        credentials: "same-origin",
+        redirect: "error",
+        cache: "no-store"
+      });
+    } catch (cause) {
+      throw new Agents24ClientError("The Agents24 BFF could not be reached.", {
+        kind: init.signal?.aborted ? "aborted" : "network",
+        code: init.signal?.aborted ? "ABORTED" : "NETWORK_ERROR",
+        retryable: !init.signal?.aborted,
+        cause
+      });
+    }
+    if (!response.ok) throw await responseError(response);
+    return response;
+  };
+  const json = async (method, path, init = {}) => {
+    const body = init.body === void 0 || init.contentType ? init.body : JSON.stringify(init.body);
+    const response = await request(method, path, {
+      ...init,
+      ...body === void 0 ? {} : { body },
+      ...init.body === void 0 || init.contentType ? {} : { contentType: "application/json" }
+    });
+    return objectResult(await responseJson(response), path);
+  };
+  const attachOnce = async (runId, cursor, signal, onEvent) => {
+    const response = await request("POST", `/runs/${encodePath(runId)}/attach`, {
+      accept: "text/event-stream",
+      body: JSON.stringify(cursor === void 0 ? {} : { cursor }),
+      contentType: "application/json",
+      ...signal ? { signal } : {}
+    });
+    return consumeRuntimeStream({
+      response,
+      decoder: decoder(),
+      onEvent,
+      ...signal ? { signal } : {},
+      ...cursor === void 0 ? {} : { afterCursor: cursor }
+    });
+  };
+  const withReconnect = async (initial, signal, onEvent) => {
+    let state;
+    let attempts = 0;
+    while (true) {
+      try {
+        state = state?.runId ? await attachOnce(state.runId, state.cursor ?? void 0, signal, onEvent) : await initial();
+      } catch (error) {
+        if (signal?.aborted || !shouldReconnect(error) || attempts >= maxReconnectAttempts) throw error;
+        attempts += 1;
+        continue;
+      }
+      if (!state.detached || signal?.aborted || attempts >= maxReconnectAttempts) return state;
+      attempts += 1;
+    }
+  };
+  return {
+    async bootstrap(input) {
+      return json("GET", "/bootstrap", input?.signal ? { signal: input.signal } : {});
+    },
+    resourcePolicies: {
+      getEffective(input) {
+        return json("GET", "/resource-policy", input?.signal ? { signal: input.signal } : {});
+      }
+    },
+    chat: {
+      async stream(input, onEvent) {
+        const initial = async () => consumeRuntimeStream({
+          response: await request("POST", "/chat/stream", {
+            accept: "text/event-stream",
+            body: JSON.stringify({
+              input: input.input,
+              attachmentIds: [...input.attachmentIds ?? []],
+              ...input.threadId ? { threadId: input.threadId } : {},
+              ...input.requestedModelId ? { requestedModelId: input.requestedModelId } : {},
+              toolInputs: input.toolInputs ?? {},
+              metadata: input.metadata ?? {},
+              client: input.client ?? { sdk_name: "@agents24/client/bff", sdk_version: "0.2.1" }
+            }),
+            contentType: "application/json",
+            idempotencyKey: input.idempotencyKey,
+            ...input.signal ? { signal: input.signal } : {}
+          }),
+          decoder: decoder(),
+          onEvent,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+        return withReconnect(initial, input.signal, onEvent);
+      }
+    },
+    runs: {
+      attach(input, onEvent) {
+        return withReconnect(
+          () => attachOnce(input.runId, input.cursor, input.signal, onEvent),
+          input.signal,
+          onEvent
+        );
+      },
+      cancel(input) {
+        return json("POST", `/runs/${encodePath(input.runId)}/cancel`, {
+          body: {},
+          idempotencyKey: input.idempotencyKey,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+      },
+      setFeedback(input) {
+        return json(
+          "PUT",
+          `/runs/${encodePath(input.runId)}/feedback`,
+          {
+            body: {
+              rating: input.rating,
+              ...input.reason ? { reason: input.reason } : {},
+              ...input.comment ? { comment: input.comment } : {}
+            },
+            ...input.signal ? { signal: input.signal } : {}
+          }
+        );
+      }
+    },
+    threads: {
+      list(input) {
+        return json("GET", appendQuery("/threads", {
+          skip: input?.skip,
+          limit: input?.limit
+        }), input?.signal ? { signal: input.signal } : {});
+      },
+      get(input) {
+        return json("GET", appendQuery(`/threads/${encodePath(input.threadId)}`, {
+          limit: input.limit,
+          before_turn_index: input.beforeTurnIndex
+        }), input.signal ? { signal: input.signal } : {});
+      },
+      async events(input, onEvent) {
+        let cursor = input.cursor;
+        let attempts = 0;
+        while (!input.signal?.aborted) {
+          try {
+            const response = await request("GET", appendQuery("/threads/events", { cursor }), {
+              accept: "text/event-stream",
+              ...input.signal ? { signal: input.signal } : {}
+            });
+            cursor = await consumeThreadSummaryStream({
+              response,
+              decoder: decoder(),
+              onEvent,
+              ...input.signal ? { signal: input.signal } : {},
+              ...cursor === void 0 ? {} : { afterCursor: cursor }
+            }) ?? void 0;
+            return;
+          } catch (error) {
+            if (input.signal?.aborted || !shouldReconnect(error) || attempts >= maxReconnectAttempts) throw error;
+            attempts += 1;
+          }
+        }
+      },
+      delete(input) {
+        return json("DELETE", `/threads/${encodePath(input.threadId)}`, {
+          idempotencyKey: input.idempotencyKey,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+      }
+    },
+    attachments: {
+      async uploadBatch(input) {
+        const multipart = options.multipart ?? createByteMultipartEncoder(encoder);
+        const encoded = await multipart.encode([
+          ...input.threadId ? [{ field: "thread_id", value: input.threadId }] : [],
+          ...input.uploads.map((upload) => ({ field: "files", value: upload }))
+        ]);
+        const body = await json("POST", "/attachments/upload", {
+          body: encoded.body,
+          contentType: encoded.contentType,
+          idempotencyKey: input.idempotencyKey,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+        if (!Array.isArray(body.items)) throw new Error("Attachment upload returned an invalid batch");
+        return body.items.map((item) => objectResult(item, "Attachment upload"));
+      },
+      createContentAccess(input) {
+        return json(
+          "POST",
+          `/attachments/${encodePath(input.attachmentId)}/content-access`,
+          {
+            body: { disposition: input.disposition },
+            ...input.signal ? { signal: input.signal } : {}
+          }
+        );
+      }
+    },
+    hitl: {
+      resume(input) {
+        return json("POST", `/runs/${encodePath(input.runId)}/hitl/${encodePath(input.interruptId)}/resume`, {
+          body: {
+            interruptId: input.interruptId,
+            action: input.action,
+            ...input.comment ? { comment: input.comment } : {},
+            ...input.answers ? { answers: input.answers } : {}
+          },
+          idempotencyKey: input.idempotencyKey,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+      }
+    },
+    mcp: {
+      startAuthorization(input) {
+        return json("POST", `/runs/${encodePath(input.runId)}/mcp/servers/${encodePath(input.serverId)}/auth/start`, {
+          body: {
+            interruptId: input.interruptId,
+            redirectUri: input.redirectUri,
+            popupNonce: input.popupNonce,
+            codeChallenge: input.codeChallenge
+          },
+          idempotencyKey: input.idempotencyKey,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+      },
+      redeemCallback(input) {
+        return json("POST", "/mcp/callback/redeem", {
+          body: { code: input.code, codeVerifier: input.codeVerifier },
+          idempotencyKey: input.idempotencyKey,
+          ...input.signal ? { signal: input.signal } : {}
+        });
+      }
+    },
+    sessions: {
+      async revoke(input) {
+        await request("POST", "/session/revoke", {
+          idempotencyKey: input?.idempotencyKey ?? ids.createId(),
+          ...input?.signal ? { signal: input.signal } : {}
+        });
+      }
+    }
+  };
+}
+
+export { createBffAgentClient };
+//# sourceMappingURL=bff.js.map
+//# sourceMappingURL=bff.js.map

package/dist/bff.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bff.ts"],"names":[],"mappings":"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","file":"bff.js","sourcesContent":["import { defaultIds, resolveDecoderFactory, resolveEncoder, resolveFetch } from \"./capabilities.js\";\nimport { Agents24ClientError } from \"./errors.js\";\nimport { responseError, responseJson } from \"./http.js\";\nimport { createByteMultipartEncoder } from \"./multipart.js\";\nimport { consumeRuntimeStream, consumeThreadSummaryStream, type RuntimeStreamState } from \"./stream.js\";\nimport { appendQuery, encodePath } from \"./url.js\";\nimport type {\n  AgentClient,\n  AbortSignalLike,\n  AttachmentResult,\n  EffectiveResourcePolicy,\n  FetchLike,\n  MultipartEncoder,\n  RuntimeEventHandler,\n  ResponseFeedbackResult,\n  StreamResult,\n  TextDecoderLike,\n  TextEncoderLike,\n  ThreadDetail,\n  ThreadListResult,\n  ThreadSummaryEventHandler,\n} from \"./types.js\";\nimport type { AttachmentContentAccess } from \"./runtime-types.js\";\n\nexport interface Agents24BffClientOptions {\n  basePath?: string;\n  fetch?: FetchLike;\n  decoder?: () => TextDecoderLike;\n  encoder?: TextEncoderLike;\n  multipart?: MultipartEncoder;\n  maxReconnectAttempts?: number;\n}\n\nfunction normalizeBasePath(value: string | undefined): string {\n  const path = String(value || \"/api/agents24\").trim();\n  if (!path.startsWith(\"/\") || /[\\r\\n\\0?#]/.test(path)) {\n    throw new Agents24ClientError(\"basePath must be a same-origin absolute path.\", {\n      kind: \"configuration\",\n      code: \"INVALID_BFF_BASE_PATH\",\n    });\n  }\n  return path.replace(/\\/+$/, \"\");\n}\n\nfunction objectResult<T extends object>(value: unknown, operation: string): T {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new Agents24ClientError(`${operation} returned an invalid response.`, {\n      kind: \"protocol\",\n      code: \"INVALID_JSON_RESPONSE\",\n    });\n  }\n  return value as T;\n}\n\nfunction shouldReconnect(error: unknown): boolean {\n  return error instanceof Agents24ClientError && error.kind === \"network\" && error.retryable;\n}\n\nexport function createBffAgentClient(options: Agents24BffClientOptions = {}): AgentClient {\n  const basePath = normalizeBasePath(options.basePath);\n  const fetch = resolveFetch(options.fetch);\n  const decoder = resolveDecoderFactory(options.decoder);\n  const encoder = resolveEncoder(options.encoder);\n  const ids = defaultIds();\n  const maxReconnectAttempts = Math.max(0, Math.min(options.maxReconnectAttempts ?? 3, 10));\n\n  const request = async (method: string, path: string, init: {\n    accept?: string;\n    body?: unknown;\n    contentType?: string;\n    idempotencyKey?: string;\n    signal?: AbortSignalLike;\n  } = {}) => {\n    let response;\n    try {\n      response = await fetch(`${basePath}${path}`, {\n        method,\n        headers: {\n          Accept: init.accept || \"application/json\",\n          ...(init.contentType ? { \"Content-Type\": init.contentType } : {}),\n          ...(init.idempotencyKey ? { \"Idempotency-Key\": init.idempotencyKey } : {}),\n        },\n        ...(init.body === undefined ? {} : { body: init.body }),\n        ...(init.signal ? { signal: init.signal } : {}),\n        credentials: \"same-origin\",\n        redirect: \"error\",\n        cache: \"no-store\",\n      });\n    } catch (cause) {\n      throw new Agents24ClientError(\"The Agents24 BFF could not be reached.\", {\n        kind: init.signal?.aborted ? \"aborted\" : \"network\",\n        code: init.signal?.aborted ? \"ABORTED\" : \"NETWORK_ERROR\",\n        retryable: !init.signal?.aborted,\n        cause,\n      });\n    }\n    if (!response.ok) throw await responseError(response);\n    return response;\n  };\n\n  const json = async <T extends object>(method: string, path: string, init: Parameters<typeof request>[2] = {}): Promise<T> => {\n    const body = init.body === undefined || init.contentType\n      ? init.body\n      : JSON.stringify(init.body);\n    const response = await request(method, path, {\n      ...init,\n      ...(body === undefined ? {} : { body }),\n      ...(init.body === undefined || init.contentType ? {} : { contentType: \"application/json\" }),\n    });\n    return objectResult<T>(await responseJson(response), path);\n  };\n\n  const attachOnce = async (\n    runId: string,\n    cursor: number | undefined,\n    signal: Parameters<AgentClient[\"runs\"][\"attach\"]>[0][\"signal\"],\n    onEvent: RuntimeEventHandler,\n  ): Promise<RuntimeStreamState> => {\n    const response = await request(\"POST\", `/runs/${encodePath(runId)}/attach`, {\n      accept: \"text/event-stream\",\n      body: JSON.stringify(cursor === undefined ? {} : { cursor }),\n      contentType: \"application/json\",\n      ...(signal ? { signal } : {}),\n    });\n    return consumeRuntimeStream({\n      response,\n      decoder: decoder(),\n      onEvent,\n      ...(signal ? { signal } : {}),\n      ...(cursor === undefined ? {} : { afterCursor: cursor }),\n    });\n  };\n\n  const withReconnect = async (\n    initial: () => Promise<RuntimeStreamState>,\n    signal: Parameters<AgentClient[\"runs\"][\"attach\"]>[0][\"signal\"],\n    onEvent: RuntimeEventHandler,\n  ): Promise<StreamResult> => {\n    let state: RuntimeStreamState | undefined;\n    let attempts = 0;\n    while (true) {\n      try {\n        state = state?.runId\n          ? await attachOnce(state.runId, state.cursor ?? undefined, signal, onEvent)\n          : await initial();\n      } catch (error) {\n        if (signal?.aborted || !shouldReconnect(error) || attempts >= maxReconnectAttempts) throw error;\n        attempts += 1;\n        continue;\n      }\n      if (!state.detached || signal?.aborted || attempts >= maxReconnectAttempts) return state;\n      attempts += 1;\n    }\n  };\n\n  return {\n    async bootstrap(input) {\n      return json(\"GET\", \"/bootstrap\", input?.signal ? { signal: input.signal } : {});\n    },\n    resourcePolicies: {\n      getEffective(input) {\n        return json<EffectiveResourcePolicy>(\"GET\", \"/resource-policy\", input?.signal ? { signal: input.signal } : {});\n      },\n    },\n    chat: {\n      async stream(input, onEvent) {\n        const initial = async () => consumeRuntimeStream({\n          response: await request(\"POST\", \"/chat/stream\", {\n            accept: \"text/event-stream\",\n            body: JSON.stringify({\n              input: input.input,\n              attachmentIds: [...(input.attachmentIds ?? [])],\n              ...(input.threadId ? { threadId: input.threadId } : {}),\n              ...(input.requestedModelId ? { requestedModelId: input.requestedModelId } : {}),\n              toolInputs: input.toolInputs ?? {},\n              metadata: input.metadata ?? {},\n              client: input.client ?? { sdk_name: \"@agents24/client/bff\", sdk_version: \"0.2.1\" },\n            }),\n            contentType: \"application/json\",\n            idempotencyKey: input.idempotencyKey,\n            ...(input.signal ? { signal: input.signal } : {}),\n          }),\n          decoder: decoder(),\n          onEvent,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n        return withReconnect(initial, input.signal, onEvent);\n      },\n    },\n    runs: {\n      attach(input, onEvent) {\n        return withReconnect(\n          () => attachOnce(input.runId, input.cursor, input.signal, onEvent),\n          input.signal,\n          onEvent,\n        );\n      },\n      cancel(input) {\n        return json(\"POST\", `/runs/${encodePath(input.runId)}/cancel`, {\n          body: {},\n          idempotencyKey: input.idempotencyKey,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n      },\n      setFeedback(input) {\n        return json<ResponseFeedbackResult>(\n          \"PUT\",\n          `/runs/${encodePath(input.runId)}/feedback`,\n          {\n            body: {\n              rating: input.rating,\n              ...(input.reason ? { reason: input.reason } : {}),\n              ...(input.comment ? { comment: input.comment } : {}),\n            },\n            ...(input.signal ? { signal: input.signal } : {}),\n          },\n        );\n      },\n    },\n    threads: {\n      list(input) {\n        return json<ThreadListResult>(\"GET\", appendQuery(\"/threads\", {\n          skip: input?.skip,\n          limit: input?.limit,\n        }), input?.signal ? { signal: input.signal } : {});\n      },\n      get(input) {\n        return json<ThreadDetail>(\"GET\", appendQuery(`/threads/${encodePath(input.threadId)}`, {\n          limit: input.limit,\n          before_turn_index: input.beforeTurnIndex,\n        }), input.signal ? { signal: input.signal } : {});\n      },\n      async events(input, onEvent: ThreadSummaryEventHandler) {\n        let cursor = input.cursor;\n        let attempts = 0;\n        while (!input.signal?.aborted) {\n          try {\n            const response = await request(\"GET\", appendQuery(\"/threads/events\", { cursor }), {\n              accept: \"text/event-stream\",\n              ...(input.signal ? { signal: input.signal } : {}),\n            });\n            cursor = (await consumeThreadSummaryStream({\n              response,\n              decoder: decoder(),\n              onEvent,\n              ...(input.signal ? { signal: input.signal } : {}),\n              ...(cursor === undefined ? {} : { afterCursor: cursor }),\n            })) ?? undefined;\n            return;\n          } catch (error) {\n            if (input.signal?.aborted || !shouldReconnect(error) || attempts >= maxReconnectAttempts) throw error;\n            attempts += 1;\n          }\n        }\n      },\n      delete(input) {\n        return json(\"DELETE\", `/threads/${encodePath(input.threadId)}`, {\n          idempotencyKey: input.idempotencyKey,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n      },\n    },\n    attachments: {\n      async uploadBatch(input) {\n        const multipart = options.multipart ?? createByteMultipartEncoder(encoder);\n        const encoded = await multipart.encode([\n          ...(input.threadId ? [{ field: \"thread_id\", value: input.threadId }] : []),\n          ...input.uploads.map((upload) => ({ field: \"files\", value: upload })),\n        ]);\n        const body = await json<Record<string, unknown>>(\"POST\", \"/attachments/upload\", {\n          body: encoded.body,\n          contentType: encoded.contentType,\n          idempotencyKey: input.idempotencyKey,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n        if (!Array.isArray(body.items)) throw new Error(\"Attachment upload returned an invalid batch\");\n        return body.items.map((item) => objectResult<AttachmentResult>(item, \"Attachment upload\"));\n      },\n      createContentAccess(input) {\n        return json<AttachmentContentAccess>(\n          \"POST\",\n          `/attachments/${encodePath(input.attachmentId)}/content-access`,\n          {\n            body: { disposition: input.disposition },\n            ...(input.signal ? { signal: input.signal } : {}),\n          },\n        );\n      },\n    },\n    hitl: {\n      resume(input) {\n        return json(\"POST\", `/runs/${encodePath(input.runId)}/hitl/${encodePath(input.interruptId)}/resume`, {\n          body: {\n            interruptId: input.interruptId,\n            action: input.action,\n            ...(input.comment ? { comment: input.comment } : {}),\n            ...(input.answers ? { answers: input.answers } : {}),\n          },\n          idempotencyKey: input.idempotencyKey,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n      },\n    },\n    mcp: {\n      startAuthorization(input) {\n        return json(\"POST\", `/runs/${encodePath(input.runId)}/mcp/servers/${encodePath(input.serverId)}/auth/start`, {\n          body: {\n            interruptId: input.interruptId,\n            redirectUri: input.redirectUri,\n            popupNonce: input.popupNonce,\n            codeChallenge: input.codeChallenge,\n          },\n          idempotencyKey: input.idempotencyKey,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n      },\n      redeemCallback(input) {\n        return json(\"POST\", \"/mcp/callback/redeem\", {\n          body: { code: input.code, codeVerifier: input.codeVerifier },\n          idempotencyKey: input.idempotencyKey,\n          ...(input.signal ? { signal: input.signal } : {}),\n        });\n      },\n    },\n    sessions: {\n      async revoke(input) {\n        await request(\"POST\", \"/session/revoke\", {\n          idempotencyKey: input?.idempotencyKey ?? ids.createId(),\n          ...(input?.signal ? { signal: input.signal } : {}),\n        });\n      },\n    },\n  };\n}\n"]}