@invergent/website-widget 2.7.5 → 2.7.7

package/dist/index.d.ts

@@ -1,176 +1,7 @@
-import { AbstractAgent, AgentConfig, RunAgentInput, BaseEvent } from '@ag-ui/client';
+export { W as WebsiteAgent, a as WebsiteAgentConfig } from './agent-ia0JiKMG.js';
+import { BaseEvent } from '@ag-ui/client';
 export { AbstractAgent, EventType } from '@ag-ui/client';
-import { Observable } from 'rxjs';
-
-/**
- * HTTP + SSE wire layer.
- *
- * Pure functions that talk to the website channel's three endpoints,
- * isolated here so :class:`WebsiteAgentClient` can stay focused on
- * state-machine orchestration.  All fetches use ``credentials:
- * 'include'`` so the browser sends the HttpOnly session cookie that
- * ``bootstrap`` set -- without it the message/SSE/end routes return
- * 401 and the whole channel falls apart.
- *
- * SSE is handled by the native ``EventSource`` rather than a custom
- * fetch-based parser because the native implementation is zero bytes,
- * auto-reconnects on network drops, and respects browser-internal
- * backoff heuristics.  The one thing it can't do is resume with a
- * server-side cursor, so we manage the ``?after=N`` reopen logic
- * explicitly in :class:`WebsiteAgentClient`.
- */
-interface BootstrapResult {
-    sessionId: string;
-    csrfToken: string;
-    expiresAt: number;
-    agentName: string;
-}
-
-/**
- * AG-UI ``AbstractAgent`` implementation for the Surogates public-website channel.
- *
- * A ``WebsiteAgent`` bridges the channel-specific HTTP protocol
- * (publishable-key bootstrap, HttpOnly cookie, CSRF double-submit,
- * ``/v1/website/sessions/{id}/events`` SSE) onto AG-UI's standard
- * ``run()`` contract so any AG-UI-aware host app -- CopilotKit,
- * custom chat UIs, LangGraph-style clients -- can talk to a Surogates
- * backend with no custom glue beyond instantiation.
- *
- * Responsibilities
- * ----------------
- * * **Lazy bootstrap.**  The first ``runAgent`` call POSTs to
- *   ``/v1/website/sessions`` to exchange the publishable key for a
- *   session cookie + CSRF token; subsequent calls reuse them.  A cookie
- *   expiry (HTTP 401) triggers a transparent re-bootstrap so the host
- *   app never has to manage auth state.
- *
- * * **Message → POST.**  On each ``runAgent`` call the agent finds the
- *   latest user message in ``input.messages`` and posts its content to
- *   ``/v1/website/sessions/{id}/messages`` with the CSRF header.
- *
- * * **SSE → AG-UI.**  The channel's native event stream is converted
- *   to AG-UI events by :class:`Translator` frame-by-frame.  The agent
- *   opens a fresh EventSource per run (with ``?after=<cursor>`` to
- *   skip already-processed frames) and closes it after a short grace
- *   drain on turn completion so trailing server frames (late
- *   ``memory.update``, ``session.done``) advance the cursor rather
- *   than replaying on the next run.
- *
- * * **RUN lifecycle.**  AG-UI requires every run to be bracketed by
- *   ``RUN_STARTED`` and exactly one of ``RUN_FINISHED`` / ``RUN_ERROR``.
- *   Surogates has no such sentinel on the wire, so the agent emits
- *   them itself; a per-run ``terminated`` flag guarantees at most one
- *   terminal event even under concurrent SSE ``onerror`` + translator
- *   end-of-turn detection.
- */
-
-/**
- * Constructor config for :class:`WebsiteAgent`.  Extends AG-UI's
- * base ``AgentConfig`` with the two Surogates-specific fields the
- * bootstrap needs; everything else (``agentId``, ``threadId``,
- * ``initialMessages``, ``initialState``, ``debug``) is inherited
- * unchanged so consumers reuse the AG-UI patterns they already know.
- */
-interface WebsiteAgentConfig extends AgentConfig {
-    /** Base URL of the Surogates API, e.g. ``https://agent.acme.com``. */
-    apiUrl: string;
-    /** Publishable key issued by ops (``surg_wk_...``). */
-    publishableKey: string;
-}
-declare class WebsiteAgent extends AbstractAgent {
-    readonly apiUrl: string;
-    readonly publishableKey: string;
-    /** Cached bootstrap result.  ``undefined`` until the first ``run()``. */
-    private bootstrapResult;
-    /** Monotonic cursor across runs.  Passed to the SSE ``?after=`` param. */
-    private cursor;
-    constructor(config: WebsiteAgentConfig);
-    /**
-     * Ensure we have a live session cookie + CSRF token.
-     *
-     * Idempotent; returns the cached result when one already exists.
-     * ``bootstrap()`` is the only call that requires the publishable
-     * key to travel in an Authorization header, so callers that want
-     * to eagerly validate their configuration (e.g. to surface a
-     * setup error at widget-load time) can invoke this directly.
-     */
-    ensureBootstrapped(): Promise<BootstrapResult>;
-    /**
-     * Close the current session on the server side and drop local state.
-     *
-     * Callers should invoke this when the visitor closes the chat UI
-     * so the server can mark the session complete instead of waiting
-     * for the idle-reset timer.  Safe to call when no session has been
-     * bootstrapped yet.
-     */
-    end(): Promise<void>;
-    /**
-     * Implementation of the AG-UI ``run()`` contract.
-     *
-     * Returns a cold observable: one subscription per run.  AG-UI's
-     * ``runAgent`` pipeline pipes this through chunk transformation,
-     * verification, and subscriber notifications before updating
-     * ``this.messages``.
-     */
-    run(input: RunAgentInput): Observable<BaseEvent>;
-    /**
-     * Async body of the observable factory.
-     *
-     * Emits ``RUN_STARTED`` up front so every downstream failure is
-     * well-bracketed by the AG-UI lifecycle.  ``RUN_FINISHED`` is
-     * emitted by the SSE listeners when the translator detects end-of-
-     * turn; ``RUN_ERROR`` is emitted from the catch below when bootstrap
-     * or message-send fails before the SSE has any chance to close out.
-     *
-     * The ``ctx.terminated`` guard is the single enforcement point for
-     * AG-UI's "exactly one terminal event" invariant.  Every emission
-     * site checks it before calling ``subscriber.next`` with RUN_FINISHED
-     * or RUN_ERROR, and every terminal call sets it to true first.
-     */
-    private driveRun;
-    /**
-     * Tear down whatever EventSource is currently live on ``ctx`` and
-     * open a fresh one against *sessionId* starting at *after*.  Called
-     * both for the initial stream and after cookie recovery.  Always
-     * clears the stale ``onerror`` first so the old source can't race
-     * a ``RUN_ERROR`` into the subscriber after it's been replaced.
-     */
-    private replaceStreamSource;
-    /**
-     * Try ``sendMessage``; on auth failure re-bootstrap once and retry.
-     *
-     * The re-bootstrap mints a new session id, so the caller passes an
-     * ``onRebootstrap`` callback that reopens the SSE stream against the
-     * fresh session before the retry.  Visitor continuity across
-     * bootstraps is a deliberate non-feature for v1; the new session
-     * starts empty.  Only frames emitted on the OLD session between
-     * SSE-open and send-failure are lost -- and those are always
-     * previous-turn events, since the current turn's ``sendMessage`` is
-     * what 401-ed.
-     */
-    private sendWithCookieRecovery;
-    /**
-     * Wire up the EventSource to translate and forward every frame,
-     * and terminate the observable when the translator flags
-     * end-of-turn or a transport failure occurs.
-     *
-     * After the translator flips end-of-turn we emit ``RUN_FINISHED``
-     * immediately, then keep the stream open for ``DRAIN_WINDOW_MS``
-     * so trailing frames (late ``memory.update``, the sentinel
-     * ``session.done``) advance ``this.cursor`` rather than arriving
-     * on the next run.  The ``ctx.terminated`` gate stops additional
-     * subscriber emissions during the drain.
-     */
-    private attachStreamListeners;
-    /**
-     * Find the last user-authored message body to post.  AG-UI supports
-     * multimodal content arrays; this v1 only handles string content
-     * (the website channel's ``POST /messages`` endpoint accepts plain
-     * text).  Multimodal support lands once the server grows a media
-     * upload path.
-     */
-    private extractUserText;
-}
+import 'rxjs';
 
 /**
  * Pure event translation: Surogates wire events → AG-UI ``BaseEvent``\ s.
@@ -403,4 +234,4 @@ declare const SURG_EVENT: {
     readonly HARNESS_CRASH: "harness.crash";
 };
 
-export { PROTOCOL_VERSION, SDK_VERSION, SURG_EVENT, SurogatesAuthError, SurogatesError, type SurogatesFrame, SurogatesNetworkError, SurogatesProtocolError, SurogatesRateLimitError, Translator, WebsiteAgent, type WebsiteAgentConfig };
+export { PROTOCOL_VERSION, SDK_VERSION, SURG_EVENT, SurogatesAuthError, SurogatesError, type SurogatesFrame, SurogatesNetworkError, SurogatesProtocolError, SurogatesRateLimitError, Translator };