@webless/agent 0.2.0

package/dist/index.cjs

@@ -0,0 +1,368 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_RUNTIME_ORIGIN: () => DEFAULT_RUNTIME_ORIGIN,
+  agentHealthUrl: () => agentHealthUrl,
+  buildAgentStorageKeyPrefix: () => buildAgentStorageKeyPrefix,
+  buildEveHost: () => buildEveHost,
+  clearPersistedAgentSession: () => clearPersistedAgentSession,
+  clearVisitorSessionId: () => clearVisitorSessionId,
+  createAgentClient: () => createAgentClient,
+  formatAgentError: () => formatAgentError,
+  getOrCreateVisitorSessionId: () => getOrCreateVisitorSessionId,
+  loadPersistedAgentSession: () => loadPersistedAgentSession,
+  pingAgentHealth: () => pingAgentHealth,
+  resolveAgentRuntimeConfig: () => resolveAgentRuntimeConfig,
+  savePersistedAgentSession: () => savePersistedAgentSession
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/runtime/client.ts
+var import_client = require("eve/client");
+
+// src/runtime/config.ts
+var DEFAULT_RUNTIME_ORIGIN = "https://runtime.staging.webless.ai";
+var trimTrailingSlash = (value) => value.replace(/\/+$/, "");
+function buildEveHost(origin, indexId) {
+  const base = trimTrailingSlash(origin);
+  return `${base}?indexId=${encodeURIComponent(indexId.trim())}`;
+}
+function resolveAgentRuntimeConfig(input) {
+  const origin = trimTrailingSlash(input.runtimeOrigin?.trim() || DEFAULT_RUNTIME_ORIGIN);
+  const resolvedIndexId = input.indexId.trim();
+  return {
+    origin,
+    indexId: resolvedIndexId,
+    host: resolvedIndexId ? buildEveHost(origin, resolvedIndexId) : origin
+  };
+}
+function agentHealthUrl(runtimeOrigin) {
+  const origin = trimTrailingSlash(runtimeOrigin?.trim() || DEFAULT_RUNTIME_ORIGIN);
+  return `${origin}/eve/v1/health`;
+}
+
+// src/runtime/session-store.ts
+var DEFAULT_STORAGE_KEY_PREFIX = "webless:agent";
+function normalizeRuntimeOrigin(runtimeOrigin) {
+  const trimmed = runtimeOrigin?.trim();
+  if (!trimmed) return "_";
+  return trimmed.replace(/\/+$/, "");
+}
+function buildAgentStorageKeyPrefix(input) {
+  const customerId = input.customerId?.trim() || "_";
+  const indexId = input.indexId.trim();
+  if (!indexId) {
+    throw new Error("indexId is required to build agent storage keys.");
+  }
+  return `${DEFAULT_STORAGE_KEY_PREFIX}:${customerId}:${indexId}:${normalizeRuntimeOrigin(input.runtimeOrigin)}`;
+}
+function createSessionId() {
+  if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+  return `sess_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
+}
+function resolvePrefix(options) {
+  return options?.storageKeyPrefix?.trim() || DEFAULT_STORAGE_KEY_PREFIX;
+}
+function getOrCreateVisitorSessionId(options) {
+  const prefix = resolvePrefix(options);
+  const visitorKey = `${prefix}:visitorSessionId`;
+  if (typeof sessionStorage === "undefined") {
+    return createSessionId();
+  }
+  const existing = sessionStorage.getItem(visitorKey)?.trim();
+  if (existing) return existing;
+  const next = createSessionId();
+  sessionStorage.setItem(visitorKey, next);
+  return next;
+}
+function clearVisitorSessionId(options) {
+  if (typeof sessionStorage === "undefined") return;
+  const prefix = resolvePrefix(options);
+  sessionStorage.removeItem(`${prefix}:visitorSessionId`);
+}
+function runtimeSessionIdKey(visitorSessionId, prefix) {
+  return `${prefix}:eve:${visitorSessionId}:sessionId`;
+}
+function runtimeStreamIndexKey(visitorSessionId, prefix) {
+  return `${prefix}:eve:${visitorSessionId}:streamIndex`;
+}
+function loadPersistedAgentSession(visitorSessionId, options) {
+  if (typeof sessionStorage === "undefined" || !visitorSessionId.trim()) return null;
+  const prefix = resolvePrefix(options);
+  const sessionId = sessionStorage.getItem(runtimeSessionIdKey(visitorSessionId, prefix))?.trim();
+  if (!sessionId) return null;
+  const rawIndex = sessionStorage.getItem(runtimeStreamIndexKey(visitorSessionId, prefix));
+  const streamIndex = rawIndex ? Number.parseInt(rawIndex, 10) : 0;
+  return {
+    sessionId,
+    streamIndex: Number.isFinite(streamIndex) && streamIndex >= 0 ? streamIndex : 0
+  };
+}
+function savePersistedAgentSession(visitorSessionId, sessionId, streamIndex, options) {
+  if (typeof sessionStorage === "undefined" || !visitorSessionId.trim() || !sessionId.trim()) {
+    return;
+  }
+  const prefix = resolvePrefix(options);
+  sessionStorage.setItem(runtimeSessionIdKey(visitorSessionId, prefix), sessionId);
+  sessionStorage.setItem(
+    runtimeStreamIndexKey(visitorSessionId, prefix),
+    String(Math.max(0, streamIndex))
+  );
+}
+function clearPersistedAgentSession(visitorSessionId, options) {
+  if (typeof sessionStorage === "undefined" || !visitorSessionId.trim()) return;
+  const prefix = resolvePrefix(options);
+  sessionStorage.removeItem(runtimeSessionIdKey(visitorSessionId, prefix));
+  sessionStorage.removeItem(runtimeStreamIndexKey(visitorSessionId, prefix));
+}
+
+// src/runtime/client.ts
+function mapStepLabel(event) {
+  if (event.type !== "step.started") return null;
+  const stepIndex = event.data.stepIndex;
+  return {
+    label: "Model step running",
+    detail: typeof stepIndex === "number" ? `Step ${stepIndex + 1}` : void 0
+  };
+}
+var AgentSession = class {
+  constructor(indexId, runtimeOrigin, visitorSessionId, storeOptions) {
+    this.indexId = indexId;
+    this.runtimeOrigin = runtimeOrigin;
+    this.visitorSessionId = visitorSessionId;
+    this.storeOptions = storeOptions;
+  }
+  indexId;
+  runtimeOrigin;
+  visitorSessionId;
+  storeOptions;
+  client;
+  clientHost;
+  session;
+  activeResponse;
+  renderedPrefix = "";
+  getActiveSessionId() {
+    return this.session?.state.sessionId ?? loadPersistedAgentSession(this.visitorSessionId, this.storeOptions)?.sessionId;
+  }
+  reset() {
+    void this.activeResponse?.cancel().catch(() => {
+    });
+    this.activeResponse = void 0;
+    this.session = void 0;
+    this.renderedPrefix = "";
+    clearPersistedAgentSession(this.visitorSessionId, this.storeOptions);
+  }
+  persistSessionCursor(session) {
+    savePersistedAgentSession(
+      this.visitorSessionId,
+      session.state.sessionId,
+      session.state.streamIndex,
+      this.storeOptions
+    );
+  }
+  ensureClient() {
+    const config = resolveAgentRuntimeConfig({
+      indexId: this.indexId,
+      runtimeOrigin: this.runtimeOrigin
+    });
+    if (!config.indexId) {
+      throw new Error("indexId is required.");
+    }
+    if (this.client && this.clientHost === config.host) {
+      return this.client;
+    }
+    this.reset();
+    this.client = new import_client.Client({ host: config.host });
+    this.clientHost = config.host;
+    return this.client;
+  }
+  attachPersistedSession(client) {
+    const persisted = loadPersistedAgentSession(this.visitorSessionId, this.storeOptions);
+    if (!persisted?.sessionId) return void 0;
+    this.renderedPrefix = "";
+    return client.sessions.attach(persisted.sessionId, {
+      streamIndex: persisted.streamIndex
+    });
+  }
+  async sendTurn(message, signal, handlers) {
+    const client = this.ensureClient();
+    let response;
+    let session = this.session ?? this.attachPersistedSession(client);
+    if (session) {
+      this.session = session;
+      try {
+        response = await session.send(message, { signal });
+      } catch (error) {
+        if (error instanceof import_client.ClientError && error.status === 409 && error.code === "session_not_active") {
+          clearPersistedAgentSession(this.visitorSessionId, this.storeOptions);
+          this.session = void 0;
+          session = void 0;
+        } else {
+          throw error;
+        }
+      }
+    }
+    if (!response) {
+      const created = await client.sessions.create({ message, signal });
+      response = created.response;
+      session = created.session;
+      this.session = session;
+      this.renderedPrefix = "";
+      this.persistSessionCursor(session);
+    }
+    this.activeResponse = response;
+    let rendered = this.renderedPrefix;
+    try {
+      for await (const event of response) {
+        if (signal.aborted) break;
+        const step = mapStepLabel(event);
+        if (step) handlers.onStep?.(step.label, step.detail);
+        if (event.type === "message.appended") {
+          const { messageDelta, messageSoFar } = event.data;
+          let delta = messageDelta;
+          if (messageSoFar.startsWith(rendered)) {
+            delta = messageSoFar.slice(rendered.length);
+            rendered = messageSoFar;
+          } else if (messageDelta) {
+            rendered += messageDelta;
+          }
+          if (delta) handlers.onDelta(delta);
+        }
+        if (event.type === "message.completed") {
+          handlers.onComplete?.();
+        }
+        if (event.type === "session.failed") {
+          throw new Error(event.data.message || event.data.code);
+        }
+      }
+    } finally {
+      this.activeResponse = void 0;
+      this.renderedPrefix = rendered;
+      if (session) {
+        this.persistSessionCursor(session);
+      }
+    }
+    if (!rendered.trim() && !signal.aborted) {
+      throw new Error("Empty response from runtime");
+    }
+    if (signal.aborted) {
+      await response.cancel().catch(() => {
+      });
+    }
+    return rendered.trim();
+  }
+  cancelActive() {
+    this.activeResponse?.cancel().catch(() => {
+    });
+  }
+};
+function createAgentClient(options) {
+  const indexId = options.indexId.trim();
+  if (!indexId) {
+    throw new Error("indexId is required.");
+  }
+  const runtimeOrigin = options.runtimeOrigin?.trim() || resolveAgentRuntimeConfig({ indexId }).origin;
+  const storeOptions = {
+    storageKeyPrefix: options.storageKeyPrefix?.trim() || buildAgentStorageKeyPrefix({
+      customerId: options.customerId,
+      indexId,
+      runtimeOrigin
+    })
+  };
+  const visitorSessionId = options.visitorSessionId?.trim() || getOrCreateVisitorSessionId(storeOptions);
+  const session = new AgentSession(indexId, runtimeOrigin, visitorSessionId, storeOptions);
+  return {
+    indexId,
+    runtimeOrigin,
+    visitorSessionId,
+    sendTurn: (message, sendOptions) => session.sendTurn(
+      message,
+      sendOptions.signal ?? new AbortController().signal,
+      sendOptions.handlers
+    ),
+    reset: () => session.reset(),
+    cancelActive: () => session.cancelActive(),
+    getActiveSessionId: () => session.getActiveSessionId()
+  };
+}
+
+// src/runtime/errors.ts
+var import_client2 = require("eve/client");
+function formatAgentError(error) {
+  if (error instanceof import_client2.ClientError) {
+    if (error.status === 401 && error.code === "index_required") {
+      return "Missing indexId \u2014 pass a published index id to createAgentClient().";
+    }
+    if (error.status === 403 && error.code === "agent_unavailable") {
+      return "Agent unavailable for this index (disabled or unpublished).";
+    }
+    if (error.status === 409 && error.code === "session_not_active") {
+      return "Session expired \u2014 send a new message to start again.";
+    }
+    return error.message || `Runtime error (${error.status})`;
+  }
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return "";
+  }
+  if (error instanceof Error) return error.message;
+  return "Runtime request failed";
+}
+
+// src/runtime/health.ts
+async function pingAgentHealth(runtimeOrigin, fetchImpl = fetch) {
+  const healthUrl = agentHealthUrl(runtimeOrigin);
+  try {
+    const response = await fetchImpl(healthUrl, {
+      headers: { Accept: "application/json" },
+      cache: "no-store"
+    });
+    if (!response.ok) {
+      return { ok: false, detail: `Health check failed (${response.status})` };
+    }
+    const payload = await response.json();
+    if (payload.ok === true) {
+      return { ok: true, detail: payload.status ?? "ready" };
+    }
+    return { ok: false, detail: "Runtime health response was not ok" };
+  } catch (error) {
+    return { ok: false, detail: formatAgentError(error) || "Health check failed" };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_RUNTIME_ORIGIN,
+  agentHealthUrl,
+  buildAgentStorageKeyPrefix,
+  buildEveHost,
+  clearPersistedAgentSession,
+  clearVisitorSessionId,
+  createAgentClient,
+  formatAgentError,
+  getOrCreateVisitorSessionId,
+  loadPersistedAgentSession,
+  pingAgentHealth,
+  resolveAgentRuntimeConfig,
+  savePersistedAgentSession
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/runtime/client.ts","../src/runtime/config.ts","../src/runtime/session-store.ts","../src/runtime/errors.ts","../src/runtime/health.ts"],"sourcesContent":["export { createAgentClient } from \"./runtime/client\";\nexport {\n  DEFAULT_RUNTIME_ORIGIN,\n  agentHealthUrl,\n  buildEveHost,\n  resolveAgentRuntimeConfig,\n} from \"./runtime/config\";\nexport { formatAgentError } from \"./runtime/errors\";\nexport { pingAgentHealth } from \"./runtime/health\";\nexport {\n  buildAgentStorageKeyPrefix,\n  clearPersistedAgentSession,\n  clearVisitorSessionId,\n  getOrCreateVisitorSessionId,\n  loadPersistedAgentSession,\n  savePersistedAgentSession,\n} from \"./runtime/session-store\";\nexport type { SessionStoreOptions } from \"./runtime/session-store\";\nexport type {\n  AgentClient,\n  AgentClientOptions,\n  AgentHealthResult,\n  AgentRuntimeConfig,\n  AgentSendTurnOptions,\n  AgentStreamHandlers,\n  PersistedAgentSession,\n} from \"./runtime/types\";\n","import {\n  Client,\n  ClientError,\n  type ClientSession,\n  type MessageResponse,\n  type MessageStreamEvent,\n} from \"eve/client\";\nimport { resolveAgentRuntimeConfig } from \"./config\";\nimport {\n  buildAgentStorageKeyPrefix,\n  clearPersistedAgentSession,\n  getOrCreateVisitorSessionId,\n  loadPersistedAgentSession,\n  savePersistedAgentSession,\n  type SessionStoreOptions,\n} from \"./session-store\";\nimport type {\n  AgentClient,\n  AgentClientOptions,\n  AgentSendTurnOptions,\n  AgentStreamHandlers,\n} from \"./types\";\n\nfunction mapStepLabel(event: MessageStreamEvent): { label: string; detail?: string } | null {\n  if (event.type !== \"step.started\") return null;\n  const stepIndex = event.data.stepIndex;\n  return {\n    label: \"Model step running\",\n    detail: typeof stepIndex === \"number\" ? `Step ${stepIndex + 1}` : undefined,\n  };\n}\n\nclass AgentSession {\n  private client: Client | undefined;\n  private clientHost: string | undefined;\n  private session: ClientSession | undefined;\n  private activeResponse: MessageResponse | undefined;\n  private renderedPrefix = \"\";\n\n  constructor(\n    private readonly indexId: string,\n    private readonly runtimeOrigin: string,\n    private readonly visitorSessionId: string,\n    private readonly storeOptions: SessionStoreOptions,\n  ) {}\n\n  getActiveSessionId(): string | undefined {\n    return (\n      this.session?.state.sessionId ??\n      loadPersistedAgentSession(this.visitorSessionId, this.storeOptions)?.sessionId\n    );\n  }\n\n  reset() {\n    void this.activeResponse?.cancel().catch(() => {});\n    this.activeResponse = undefined;\n    this.session = undefined;\n    this.renderedPrefix = \"\";\n    clearPersistedAgentSession(this.visitorSessionId, this.storeOptions);\n  }\n\n  private persistSessionCursor(session: ClientSession) {\n    savePersistedAgentSession(\n      this.visitorSessionId,\n      session.state.sessionId,\n      session.state.streamIndex,\n      this.storeOptions,\n    );\n  }\n\n  private ensureClient(): Client {\n    const config = resolveAgentRuntimeConfig({\n      indexId: this.indexId,\n      runtimeOrigin: this.runtimeOrigin,\n    });\n    if (!config.indexId) {\n      throw new Error(\"indexId is required.\");\n    }\n\n    if (this.client && this.clientHost === config.host) {\n      return this.client;\n    }\n\n    this.reset();\n    this.client = new Client({ host: config.host });\n    this.clientHost = config.host;\n    return this.client;\n  }\n\n  private attachPersistedSession(client: Client): ClientSession | undefined {\n    const persisted = loadPersistedAgentSession(this.visitorSessionId, this.storeOptions);\n    if (!persisted?.sessionId) return undefined;\n\n    this.renderedPrefix = \"\";\n    return client.sessions.attach(persisted.sessionId, {\n      streamIndex: persisted.streamIndex,\n    });\n  }\n\n  async sendTurn(\n    message: string,\n    signal: AbortSignal,\n    handlers: AgentStreamHandlers,\n  ): Promise<string> {\n    const client = this.ensureClient();\n    let response: MessageResponse | undefined;\n    let session = this.session ?? this.attachPersistedSession(client);\n\n    if (session) {\n      this.session = session;\n      try {\n        response = await session.send(message, { signal });\n      } catch (error) {\n        if (\n          error instanceof ClientError &&\n          error.status === 409 &&\n          error.code === \"session_not_active\"\n        ) {\n          clearPersistedAgentSession(this.visitorSessionId, this.storeOptions);\n          this.session = undefined;\n          session = undefined;\n        } else {\n          throw error;\n        }\n      }\n    }\n\n    if (!response) {\n      const created = await client.sessions.create({ message, signal });\n      response = created.response;\n      session = created.session;\n      this.session = session;\n      this.renderedPrefix = \"\";\n      this.persistSessionCursor(session);\n    }\n\n    this.activeResponse = response;\n    let rendered = this.renderedPrefix;\n\n    try {\n      for await (const event of response) {\n        if (signal.aborted) break;\n\n        const step = mapStepLabel(event);\n        if (step) handlers.onStep?.(step.label, step.detail);\n\n        if (event.type === \"message.appended\") {\n          const { messageDelta, messageSoFar } = event.data;\n          let delta = messageDelta;\n          if (messageSoFar.startsWith(rendered)) {\n            delta = messageSoFar.slice(rendered.length);\n            rendered = messageSoFar;\n          } else if (messageDelta) {\n            rendered += messageDelta;\n          }\n          if (delta) handlers.onDelta(delta);\n        }\n\n        if (event.type === \"message.completed\") {\n          handlers.onComplete?.();\n        }\n\n        if (event.type === \"session.failed\") {\n          throw new Error(event.data.message || event.data.code);\n        }\n      }\n    } finally {\n      this.activeResponse = undefined;\n      this.renderedPrefix = rendered;\n      if (session) {\n        this.persistSessionCursor(session);\n      }\n    }\n\n    if (!rendered.trim() && !signal.aborted) {\n      throw new Error(\"Empty response from runtime\");\n    }\n\n    if (signal.aborted) {\n      await response.cancel().catch(() => {});\n    }\n\n    return rendered.trim();\n  }\n\n  cancelActive() {\n    this.activeResponse?.cancel().catch(() => {});\n  }\n}\n\nexport function createAgentClient(options: AgentClientOptions): AgentClient {\n  const indexId = options.indexId.trim();\n  if (!indexId) {\n    throw new Error(\"indexId is required.\");\n  }\n\n  const runtimeOrigin = options.runtimeOrigin?.trim() || resolveAgentRuntimeConfig({ indexId }).origin;\n  const storeOptions: SessionStoreOptions = {\n    storageKeyPrefix:\n      options.storageKeyPrefix?.trim() ||\n      buildAgentStorageKeyPrefix({\n        customerId: options.customerId,\n        indexId,\n        runtimeOrigin,\n      }),\n  };\n  const visitorSessionId =\n    options.visitorSessionId?.trim() || getOrCreateVisitorSessionId(storeOptions);\n\n  const session = new AgentSession(indexId, runtimeOrigin, visitorSessionId, storeOptions);\n\n  return {\n    indexId,\n    runtimeOrigin,\n    visitorSessionId,\n    sendTurn: (message, sendOptions: AgentSendTurnOptions) =>\n      session.sendTurn(\n        message,\n        sendOptions.signal ?? new AbortController().signal,\n        sendOptions.handlers,\n      ),\n    reset: () => session.reset(),\n    cancelActive: () => session.cancelActive(),\n    getActiveSessionId: () => session.getActiveSessionId(),\n  };\n}\n","import type { AgentRuntimeConfig } from \"./types\";\n\nexport const DEFAULT_RUNTIME_ORIGIN = \"https://runtime.staging.webless.ai\";\n\nconst trimTrailingSlash = (value: string) => value.replace(/\\/+$/, \"\");\n\nexport function buildEveHost(origin: string, indexId: string): string {\n  const base = trimTrailingSlash(origin);\n  return `${base}?indexId=${encodeURIComponent(indexId.trim())}`;\n}\n\nexport function resolveAgentRuntimeConfig(input: {\n  indexId: string;\n  runtimeOrigin?: string;\n}): AgentRuntimeConfig {\n  const origin = trimTrailingSlash(input.runtimeOrigin?.trim() || DEFAULT_RUNTIME_ORIGIN);\n  const resolvedIndexId = input.indexId.trim();\n\n  return {\n    origin,\n    indexId: resolvedIndexId,\n    host: resolvedIndexId ? buildEveHost(origin, resolvedIndexId) : origin,\n  };\n}\n\nexport function agentHealthUrl(runtimeOrigin?: string): string {\n  const origin = trimTrailingSlash(runtimeOrigin?.trim() || DEFAULT_RUNTIME_ORIGIN);\n  return `${origin}/eve/v1/health`;\n}\n","import type { PersistedAgentSession } from \"./types\";\n\nconst DEFAULT_STORAGE_KEY_PREFIX = \"webless:agent\";\n\nexport type SessionStoreOptions = {\n  storageKeyPrefix?: string;\n};\n\nfunction normalizeRuntimeOrigin(runtimeOrigin?: string) {\n  const trimmed = runtimeOrigin?.trim();\n  if (!trimmed) return \"_\";\n  return trimmed.replace(/\\/+$/, \"\");\n}\n\nexport function buildAgentStorageKeyPrefix(input: {\n  customerId?: string;\n  indexId: string;\n  runtimeOrigin?: string;\n}) {\n  const customerId = input.customerId?.trim() || \"_\";\n  const indexId = input.indexId.trim();\n  if (!indexId) {\n    throw new Error(\"indexId is required to build agent storage keys.\");\n  }\n\n  return `${DEFAULT_STORAGE_KEY_PREFIX}:${customerId}:${indexId}:${normalizeRuntimeOrigin(input.runtimeOrigin)}`;\n}\n\nfunction createSessionId(): string {\n  if (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") {\n    return crypto.randomUUID();\n  }\n  return `sess_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;\n}\n\nfunction resolvePrefix(options?: SessionStoreOptions) {\n  return options?.storageKeyPrefix?.trim() || DEFAULT_STORAGE_KEY_PREFIX;\n}\n\nexport function getOrCreateVisitorSessionId(options?: SessionStoreOptions): string {\n  const prefix = resolvePrefix(options);\n  const visitorKey = `${prefix}:visitorSessionId`;\n\n  if (typeof sessionStorage === \"undefined\") {\n    return createSessionId();\n  }\n\n  const existing = sessionStorage.getItem(visitorKey)?.trim();\n  if (existing) return existing;\n\n  const next = createSessionId();\n  sessionStorage.setItem(visitorKey, next);\n  return next;\n}\n\nexport function clearVisitorSessionId(options?: SessionStoreOptions) {\n  if (typeof sessionStorage === \"undefined\") return;\n\n  const prefix = resolvePrefix(options);\n  sessionStorage.removeItem(`${prefix}:visitorSessionId`);\n}\n\nfunction runtimeSessionIdKey(visitorSessionId: string, prefix: string) {\n  return `${prefix}:eve:${visitorSessionId}:sessionId`;\n}\n\nfunction runtimeStreamIndexKey(visitorSessionId: string, prefix: string) {\n  return `${prefix}:eve:${visitorSessionId}:streamIndex`;\n}\n\nexport function loadPersistedAgentSession(\n  visitorSessionId: string,\n  options?: SessionStoreOptions,\n): PersistedAgentSession | null {\n  if (typeof sessionStorage === \"undefined\" || !visitorSessionId.trim()) return null;\n\n  const prefix = resolvePrefix(options);\n  const sessionId = sessionStorage.getItem(runtimeSessionIdKey(visitorSessionId, prefix))?.trim();\n  if (!sessionId) return null;\n\n  const rawIndex = sessionStorage.getItem(runtimeStreamIndexKey(visitorSessionId, prefix));\n  const streamIndex = rawIndex ? Number.parseInt(rawIndex, 10) : 0;\n\n  return {\n    sessionId,\n    streamIndex: Number.isFinite(streamIndex) && streamIndex >= 0 ? streamIndex : 0,\n  };\n}\n\nexport function savePersistedAgentSession(\n  visitorSessionId: string,\n  sessionId: string,\n  streamIndex: number,\n  options?: SessionStoreOptions,\n) {\n  if (typeof sessionStorage === \"undefined\" || !visitorSessionId.trim() || !sessionId.trim()) {\n    return;\n  }\n\n  const prefix = resolvePrefix(options);\n  sessionStorage.setItem(runtimeSessionIdKey(visitorSessionId, prefix), sessionId);\n  sessionStorage.setItem(\n    runtimeStreamIndexKey(visitorSessionId, prefix),\n    String(Math.max(0, streamIndex)),\n  );\n}\n\nexport function clearPersistedAgentSession(\n  visitorSessionId: string,\n  options?: SessionStoreOptions,\n) {\n  if (typeof sessionStorage === \"undefined\" || !visitorSessionId.trim()) return;\n  const prefix = resolvePrefix(options);\n  sessionStorage.removeItem(runtimeSessionIdKey(visitorSessionId, prefix));\n  sessionStorage.removeItem(runtimeStreamIndexKey(visitorSessionId, prefix));\n}\n","import { ClientError } from \"eve/client\";\n\nexport function formatAgentError(error: unknown): string {\n  if (error instanceof ClientError) {\n    if (error.status === 401 && error.code === \"index_required\") {\n      return \"Missing indexId — pass a published index id to createAgentClient().\";\n    }\n    if (error.status === 403 && error.code === \"agent_unavailable\") {\n      return \"Agent unavailable for this index (disabled or unpublished).\";\n    }\n    if (error.status === 409 && error.code === \"session_not_active\") {\n      return \"Session expired — send a new message to start again.\";\n    }\n    return error.message || `Runtime error (${error.status})`;\n  }\n  if (error instanceof DOMException && error.name === \"AbortError\") {\n    return \"\";\n  }\n  if (error instanceof Error) return error.message;\n  return \"Runtime request failed\";\n}\n","import { formatAgentError } from \"./errors\";\nimport { agentHealthUrl } from \"./config\";\nimport type { AgentHealthResult } from \"./types\";\n\nexport async function pingAgentHealth(\n  runtimeOrigin?: string,\n  fetchImpl: typeof fetch = fetch,\n): Promise<AgentHealthResult> {\n  const healthUrl = agentHealthUrl(runtimeOrigin);\n\n  try {\n    const response = await fetchImpl(healthUrl, {\n      headers: { Accept: \"application/json\" },\n      cache: \"no-store\",\n    });\n    if (!response.ok) {\n      return { ok: false, detail: `Health check failed (${response.status})` };\n    }\n    const payload = (await response.json()) as { status?: string; ok?: boolean };\n    if (payload.ok === true) {\n      return { ok: true, detail: payload.status ?? \"ready\" };\n    }\n    return { ok: false, detail: \"Runtime health response was not ok\" };\n  } catch (error) {\n    return { ok: false, detail: formatAgentError(error) || \"Health check failed\" };\n  }\n}\n"],"mappings":"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","names":["import_client"]}

package/dist/index.d.cts

@@ -0,0 +1,73 @@
+type AgentRuntimeConfig = {
+    origin: string;
+    indexId: string;
+    host: string;
+};
+type AgentStreamHandlers = {
+    onStep?: (label: string, detail?: string) => void;
+    onDelta: (delta: string) => void;
+    onComplete?: () => void;
+};
+type AgentSendTurnOptions = {
+    signal?: AbortSignal;
+    handlers: AgentStreamHandlers;
+};
+type PersistedAgentSession = {
+    sessionId: string;
+    streamIndex: number;
+};
+type AgentClientOptions = {
+    /** Published index id sent as `indexId` query param to the runtime. */
+    indexId: string;
+    /** Customer id used to isolate browser session storage when omitted from storageKeyPrefix. */
+    customerId?: string;
+    /** Agent runtime origin, e.g. `https://runtime.staging.webless.ai`. */
+    runtimeOrigin?: string;
+    /** Stable browser conversation id; generated and stored when omitted. */
+    visitorSessionId?: string;
+    /** Override sessionStorage key prefix (derived from agent identity when omitted). */
+    storageKeyPrefix?: string;
+};
+type AgentClient = {
+    readonly indexId: string;
+    readonly runtimeOrigin: string;
+    readonly visitorSessionId: string;
+    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    reset: () => void;
+    cancelActive: () => void;
+    getActiveSessionId: () => string | undefined;
+};
+type AgentHealthResult = {
+    ok: boolean;
+    detail: string;
+};
+
+declare function createAgentClient(options: AgentClientOptions): AgentClient;
+
+declare const DEFAULT_RUNTIME_ORIGIN = "https://runtime.staging.webless.ai";
+declare function buildEveHost(origin: string, indexId: string): string;
+declare function resolveAgentRuntimeConfig(input: {
+    indexId: string;
+    runtimeOrigin?: string;
+}): AgentRuntimeConfig;
+declare function agentHealthUrl(runtimeOrigin?: string): string;
+
+declare function formatAgentError(error: unknown): string;
+
+declare function pingAgentHealth(runtimeOrigin?: string, fetchImpl?: typeof fetch): Promise<AgentHealthResult>;
+
+type SessionStoreOptions = {
+    storageKeyPrefix?: string;
+};
+declare function buildAgentStorageKeyPrefix(input: {
+    customerId?: string;
+    indexId: string;
+    runtimeOrigin?: string;
+}): string;
+declare function getOrCreateVisitorSessionId(options?: SessionStoreOptions): string;
+declare function clearVisitorSessionId(options?: SessionStoreOptions): void;
+declare function loadPersistedAgentSession(visitorSessionId: string, options?: SessionStoreOptions): PersistedAgentSession | null;
+declare function savePersistedAgentSession(visitorSessionId: string, sessionId: string, streamIndex: number, options?: SessionStoreOptions): void;
+declare function clearPersistedAgentSession(visitorSessionId: string, options?: SessionStoreOptions): void;
+
+export { type AgentClient, type AgentClientOptions, type AgentHealthResult, type AgentRuntimeConfig, type AgentSendTurnOptions, type AgentStreamHandlers, DEFAULT_RUNTIME_ORIGIN, type PersistedAgentSession, type SessionStoreOptions, agentHealthUrl, buildAgentStorageKeyPrefix, buildEveHost, clearPersistedAgentSession, clearVisitorSessionId, createAgentClient, formatAgentError, getOrCreateVisitorSessionId, loadPersistedAgentSession, pingAgentHealth, resolveAgentRuntimeConfig, savePersistedAgentSession };

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+type AgentRuntimeConfig = {
+    origin: string;
+    indexId: string;
+    host: string;
+};
+type AgentStreamHandlers = {
+    onStep?: (label: string, detail?: string) => void;
+    onDelta: (delta: string) => void;
+    onComplete?: () => void;
+};
+type AgentSendTurnOptions = {
+    signal?: AbortSignal;
+    handlers: AgentStreamHandlers;
+};
+type PersistedAgentSession = {
+    sessionId: string;
+    streamIndex: number;
+};
+type AgentClientOptions = {
+    /** Published index id sent as `indexId` query param to the runtime. */
+    indexId: string;
+    /** Customer id used to isolate browser session storage when omitted from storageKeyPrefix. */
+    customerId?: string;
+    /** Agent runtime origin, e.g. `https://runtime.staging.webless.ai`. */
+    runtimeOrigin?: string;
+    /** Stable browser conversation id; generated and stored when omitted. */
+    visitorSessionId?: string;
+    /** Override sessionStorage key prefix (derived from agent identity when omitted). */
+    storageKeyPrefix?: string;
+};
+type AgentClient = {
+    readonly indexId: string;
+    readonly runtimeOrigin: string;
+    readonly visitorSessionId: string;
+    sendTurn: (message: string, options: AgentSendTurnOptions) => Promise<string>;
+    reset: () => void;
+    cancelActive: () => void;
+    getActiveSessionId: () => string | undefined;
+};
+type AgentHealthResult = {
+    ok: boolean;
+    detail: string;
+};
+
+declare function createAgentClient(options: AgentClientOptions): AgentClient;
+
+declare const DEFAULT_RUNTIME_ORIGIN = "https://runtime.staging.webless.ai";
+declare function buildEveHost(origin: string, indexId: string): string;
+declare function resolveAgentRuntimeConfig(input: {
+    indexId: string;
+    runtimeOrigin?: string;
+}): AgentRuntimeConfig;
+declare function agentHealthUrl(runtimeOrigin?: string): string;
+
+declare function formatAgentError(error: unknown): string;
+
+declare function pingAgentHealth(runtimeOrigin?: string, fetchImpl?: typeof fetch): Promise<AgentHealthResult>;
+
+type SessionStoreOptions = {
+    storageKeyPrefix?: string;
+};
+declare function buildAgentStorageKeyPrefix(input: {
+    customerId?: string;
+    indexId: string;
+    runtimeOrigin?: string;
+}): string;
+declare function getOrCreateVisitorSessionId(options?: SessionStoreOptions): string;
+declare function clearVisitorSessionId(options?: SessionStoreOptions): void;
+declare function loadPersistedAgentSession(visitorSessionId: string, options?: SessionStoreOptions): PersistedAgentSession | null;
+declare function savePersistedAgentSession(visitorSessionId: string, sessionId: string, streamIndex: number, options?: SessionStoreOptions): void;
+declare function clearPersistedAgentSession(visitorSessionId: string, options?: SessionStoreOptions): void;
+
+export { type AgentClient, type AgentClientOptions, type AgentHealthResult, type AgentRuntimeConfig, type AgentSendTurnOptions, type AgentStreamHandlers, DEFAULT_RUNTIME_ORIGIN, type PersistedAgentSession, type SessionStoreOptions, agentHealthUrl, buildAgentStorageKeyPrefix, buildEveHost, clearPersistedAgentSession, clearVisitorSessionId, createAgentClient, formatAgentError, getOrCreateVisitorSessionId, loadPersistedAgentSession, pingAgentHealth, resolveAgentRuntimeConfig, savePersistedAgentSession };