@athenaintel/react 0.18.0 → 0.20.0

package/dist/packages/agent-runtime/src/statewire-attach-observer.cjs

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const MAX_RETRY_AFTER_MS = 3e4;
+const clampRetryAfter = (ms) => {
+  if (!Number.isFinite(ms)) return null;
+  return Math.min(Math.max(0, Math.round(ms)), MAX_RETRY_AFTER_MS);
+};
+function parseRetryAfterHeaderMs(value, now = () => Date.now()) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed === "") return null;
+  if (/^\d+$/.test(trimmed)) return clampRetryAfter(Number(trimmed) * 1e3);
+  if (!/[A-Za-z]/.test(trimmed)) return null;
+  const at = Date.parse(trimmed);
+  if (Number.isNaN(at)) return null;
+  return clampRetryAfter(at - now());
+}
+function parseRetryAfterFromCloseReason(reason) {
+  if (typeof reason !== "string" || reason === "") return null;
+  const match = /retry-after(-ms)?\s*[=:]\s*(\d+)/i.exec(reason);
+  if (!match) return null;
+  const amount = Number(match[2]);
+  return clampRetryAfter(match[1] ? amount : amount * 1e3);
+}
+function createAttachRetryGate({
+  now = () => Date.now(),
+  wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+} = {}) {
+  const floors = /* @__PURE__ */ new Map();
+  const remainingMs = (key) => {
+    const until = floors.get(key);
+    if (until === void 0) return 0;
+    const remaining = until - now();
+    if (remaining <= 0) {
+      floors.delete(key);
+      return 0;
+    }
+    return remaining;
+  };
+  return {
+    noteRetryAfter(key, delayMs) {
+      const clamped = clampRetryAfter(delayMs);
+      if (clamped === null || clamped === 0) return;
+      const until = now() + clamped;
+      const existing = floors.get(key);
+      if (existing === void 0 || existing < until) floors.set(key, until);
+    },
+    async waitForDial(key) {
+      for (let remaining = remainingMs(key); remaining > 0; remaining = remainingMs(key)) {
+        await wait(remaining);
+      }
+    },
+    remainingMs,
+    reset(key) {
+      if (key === void 0) floors.clear();
+      else floors.delete(key);
+    }
+  };
+}
+const attachRetryGate = createAttachRetryGate();
+const defaultNow = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+const isHeartbeatFrame = (data) => {
+  const text = String(data);
+  return text === "" || text === "{}";
+};
+function instrumentAttachSocket({
+  socket,
+  url,
+  onEvent,
+  now = defaultNow
+}) {
+  const createdAt = now();
+  let openedAt = null;
+  let helloSeen = false;
+  const emit = (event) => {
+    try {
+      onEvent(event);
+    } catch {
+    }
+  };
+  let openHandler = null;
+  let messageHandler = null;
+  let closeHandler = null;
+  socket.onopen = (event) => {
+    openedAt = now();
+    emit({ type: "socket-open", url, openMs: openedAt - createdAt });
+    openHandler == null ? void 0 : openHandler(event);
+  };
+  socket.onmessage = (event) => {
+    if (helloSeen || isHeartbeatFrame(event.data)) {
+      messageHandler == null ? void 0 : messageHandler(event);
+      return;
+    }
+    helloSeen = true;
+    const startedAt = now();
+    try {
+      messageHandler == null ? void 0 : messageHandler(event);
+    } finally {
+      const finishedAt = now();
+      emit({
+        type: "hello",
+        url,
+        bytes: String(event.data).length,
+        handlerMs: finishedAt - startedAt,
+        sinceOpenMs: openedAt === null ? null : startedAt - openedAt
+      });
+    }
+  };
+  socket.onclose = (event) => {
+    const closedAt = now();
+    emit({
+      type: "socket-close",
+      url,
+      code: event == null ? void 0 : event.code,
+      reason: event == null ? void 0 : event.reason,
+      sinceOpenMs: openedAt === null ? null : closedAt - openedAt
+    });
+    const retryAfter = parseRetryAfterFromCloseReason(event == null ? void 0 : event.reason);
+    if (retryAfter !== null) {
+      emit({
+        type: "retry-after",
+        url,
+        delayMs: retryAfter,
+        source: "ws-close"
+      });
+    }
+    closeHandler == null ? void 0 : closeHandler(event);
+  };
+  return {
+    get protocol() {
+      return socket.protocol;
+    },
+    get readyState() {
+      return socket.readyState;
+    },
+    get onopen() {
+      return openHandler;
+    },
+    set onopen(handler) {
+      openHandler = handler;
+    },
+    get onmessage() {
+      return messageHandler;
+    },
+    set onmessage(handler) {
+      messageHandler = handler;
+    },
+    get onclose() {
+      return closeHandler;
+    },
+    set onclose(handler) {
+      closeHandler = handler;
+    },
+    get onerror() {
+      return socket.onerror;
+    },
+    set onerror(handler) {
+      socket.onerror = handler;
+    },
+    send: (data) => socket.send(data),
+    close: (code, reason) => socket.close(code, reason)
+  };
+}
+function instrumentedWebSocketConstructor({
+  Base,
+  url,
+  onEvent,
+  now
+}) {
+  function InstrumentedWebSocket(socketUrl, protocols) {
+    return instrumentAttachSocket({
+      socket: new Base(socketUrl, protocols),
+      url,
+      onEvent,
+      ...now && { now }
+    });
+  }
+  return InstrumentedWebSocket;
+}
+function instrumentedAttachFetch({
+  baseFetch,
+  url,
+  onEvent,
+  now
+}) {
+  const wrapped = async (input, init) => {
+    const response = await baseFetch(input, init);
+    if (!response.ok && (response.status === 503 || response.status === 429)) {
+      const delayMs = parseRetryAfterHeaderMs(
+        response.headers.get("retry-after"),
+        now
+      );
+      if (delayMs !== null) {
+        try {
+          onEvent({ type: "retry-after", url, delayMs, source: "http-header" });
+        } catch {
+        }
+      }
+    }
+    return response;
+  };
+  return wrapped;
+}
+function createAttachInstrumentation({
+  url,
+  sse,
+  onEvent,
+  retryGate = attachRetryGate,
+  now
+}) {
+  const globals = globalThis;
+  const observe = (event) => {
+    if (event.type === "retry-after")
+      retryGate.noteRetryAfter(url, event.delayMs);
+    onEvent == null ? void 0 : onEvent(event);
+  };
+  if (sse) {
+    const baseFetch = globals.fetch;
+    if (typeof baseFetch !== "function") return {};
+    return {
+      fetch: instrumentedAttachFetch({
+        baseFetch: (input, init) => baseFetch(input, init),
+        url,
+        onEvent: observe,
+        ...now && { now }
+      })
+    };
+  }
+  const Base = globals.WebSocket;
+  if (typeof Base !== "function") return {};
+  return {
+    webSocket: instrumentedWebSocketConstructor({
+      Base,
+      url,
+      onEvent: observe,
+      ...now && { now }
+    })
+  };
+}
+exports.MAX_RETRY_AFTER_MS = MAX_RETRY_AFTER_MS;
+exports.attachRetryGate = attachRetryGate;
+exports.createAttachInstrumentation = createAttachInstrumentation;
+exports.createAttachRetryGate = createAttachRetryGate;
+exports.instrumentAttachSocket = instrumentAttachSocket;
+exports.instrumentedAttachFetch = instrumentedAttachFetch;
+exports.instrumentedWebSocketConstructor = instrumentedWebSocketConstructor;
+exports.parseRetryAfterFromCloseReason = parseRetryAfterFromCloseReason;
+exports.parseRetryAfterHeaderMs = parseRetryAfterHeaderMs;
+//# sourceMappingURL=statewire-attach-observer.cjs.map

package/dist/packages/agent-runtime/src/statewire-attach-observer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-attach-observer.cjs","sources":["../../../../../agent-runtime/src/statewire-attach-observer.ts"],"sourcesContent":["/**\n * Attach-path instrumentation for the deep-agent statewire transport, wired\n * through the two injection points statewire already exposes — the\n * `webSocket` constructor (`StatewireClient.WebsocketOptions`) and `fetch`\n * (`StatewireClient.HttpOptions`) — so the runtime can observe what the library\n * does not surface:\n *\n * - socket open latency (`ws_open_ms`), the hello frame's size and its\n *   synchronous handler cost (`hello_bytes`, `hello_handler_ms`), and close\n *   codes/reasons, for the thread-switch telemetry;\n * - a server `Retry-After` hint, honoured as a floor under the next dial.\n *\n * Retry-After today: statewire honours `retry-after` only on 429 command-frame\n * refusals (folded into the refusal `syn.retry`); its attach paths treat a 503\n * as a generic `HTTP 503` / `network` failure and back off exponentially with\n * no server input. Browsers never expose the response headers of a refused\n * WebSocket upgrade at all, so for the WS transport the hint can only ride\n * something the client can read: the close frame. The contract this module\n * reads is a close `reason` carrying `retry-after=<seconds>` (or\n * `retry-after-ms=<ms>`) — the pinboard half of that contract is a separate\n * change; until it lands the WS path simply sees no hint. The SSE attach\n * (`POST …/stream`) is a plain fetch, so its `Retry-After` header is read here\n * directly.\n *\n * This package compiles without the DOM lib (React Native honesty), so the\n * browser surface is typed structurally and resolved through `globalThis`.\n */\n\n/**\n * Who refused a wake (503/429), read off the response body against the two\n * refusal vocabularies the iris scaler also classifies data-plane 503s by\n * (`iris/scaler/src/v2AccessLog.ts`):\n *\n * - `\"placement\"` — the pinboard's own refusal, `{\"error\": …}` with one of its\n *   known strings (\"no live workers for hostname\", \"registry cold start,\n *   retry\", \"takeover in progress, retry\", …): the thread has no worker to\n *   dial right now.\n * - `\"worker\"` — a pinned instance-lifecycle refusal, `{\"detail\": …}` with one\n *   of its known strings (\"instance closing; retry\", \"activation queue full;\n *   retry\", \"host draining; retry\", …): one instance on the worker the thread\n *   is already placed on, cleared in the time a teardown takes.\n * - `\"unknown\"` — any other 503/429 body (unreadable, an unfamiliar string, a\n *   real worker failure such as \"Thread history load failed\"): treated\n *   conservatively — the full `Retry-After`, no dial dropped.\n * - `null` — not a refusal status.\n */\nexport type DeepAgentWakeRefusal = \"placement\" | \"worker\" | \"unknown\" | null;\n\nexport type DeepAgentAttachTimingEvent =\n  | { type: \"socket-open\"; url: string; openMs: number }\n  | {\n      type: \"hello\";\n      url: string;\n      /** UTF-16 length of the hello frame — bytes for the ASCII JSON the wire carries. */\n      bytes: number;\n      /** Synchronous cost of statewire's message handler for the hello (parse + apply + flush). */\n      handlerMs: number;\n      /** Hello arrival relative to the socket open; `null` when the open was not observed. */\n      sinceOpenMs: number | null;\n    }\n  | {\n      type: \"socket-close\";\n      url: string;\n      code: number | undefined;\n      reason: string | undefined;\n      sinceOpenMs: number | null;\n    }\n  | {\n      type: \"retry-after\";\n      url: string;\n      delayMs: number;\n      source: \"ws-close\" | \"http-header\";\n    }\n  | {\n      /** `POST …/prewarm` answered (see `wakeDeepAgentThread`). */\n      type: \"wake\";\n      url: string;\n      status: number;\n      durationMs: number;\n      /** How the host sourced the history: already resident (`warm`) or loaded by this call. */\n      history: \"fresh_load\" | \"warm\" | null;\n      /** Who refused a 503/429 (see {@link DeepAgentWakeRefusal}); `null` otherwise. */\n      refusal: DeepAgentWakeRefusal;\n    };\n\n/** Longest server hint honoured — a buggy or hostile hint must not park a client. */\nexport const MAX_RETRY_AFTER_MS = 30_000;\n\nconst clampRetryAfter = (ms: number): number | null => {\n  if (!Number.isFinite(ms)) return null;\n  return Math.min(Math.max(0, Math.round(ms)), MAX_RETRY_AFTER_MS);\n};\n\n/**\n * Parse an HTTP `Retry-After` header value: delta-seconds or an HTTP-date.\n * Returns the delay in ms clamped to {@link MAX_RETRY_AFTER_MS}, or `null` when\n * the value is absent or unparseable.\n */\nexport function parseRetryAfterHeaderMs(\n  value: string | null | undefined,\n  now: () => number = () => Date.now(),\n): number | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed === \"\") return null;\n  if (/^\\d+$/.test(trimmed)) return clampRetryAfter(Number(trimmed) * 1000);\n  // An HTTP-date always names a weekday/month; anything else numeric-looking\n  // (\"1.5\") would otherwise parse as some far-off calendar date.\n  if (!/[A-Za-z]/.test(trimmed)) return null;\n  const at = Date.parse(trimmed);\n  if (Number.isNaN(at)) return null;\n  return clampRetryAfter(at - now());\n}\n\n/**\n * Parse a retry hint off a WebSocket close reason: `retry-after=<seconds>` or\n * `retry-after-ms=<ms>` anywhere in the reason text (case-insensitive, `=` or\n * `:`). Returns ms clamped to {@link MAX_RETRY_AFTER_MS}, or `null`.\n */\nexport function parseRetryAfterFromCloseReason(\n  reason: string | undefined,\n): number | null {\n  if (typeof reason !== \"string\" || reason === \"\") return null;\n  const match = /retry-after(-ms)?\\s*[=:]\\s*(\\d+)/i.exec(reason);\n  if (!match) return null;\n  const amount = Number(match[2]);\n  return clampRetryAfter(match[1] ? amount : amount * 1000);\n}\n\nexport interface AttachRetryGate {\n  /** Record a hint: no dial for `key` before `now + delayMs` (clamped). */\n  noteRetryAfter(key: string, delayMs: number): void;\n  /** Resolves once the recorded floor for `key` has passed (immediately when none). */\n  waitForDial(key: string): Promise<void>;\n  /** Remaining floor for `key` in ms (0 when none). */\n  remainingMs(key: string): number;\n  /** Drop one key's floor, or every floor. */\n  reset(key?: string): void;\n}\n\n/**\n * Per-key dial floors. Keyed by the thread's attach URL so a hint delivered\n * for one thread never delays another. The floor is a minimum under\n * statewire's own backoff, never a replacement for it: the transport still\n * schedules its retry, and the dial simply waits out the remainder inside the\n * headers resolve (both attach paths resolve headers before they dial).\n */\nexport function createAttachRetryGate({\n  now = () => Date.now(),\n  wait = (ms: number) =>\n    new Promise<void>((resolve) => setTimeout(resolve, ms)),\n}: {\n  now?: () => number;\n  wait?: (ms: number) => Promise<void>;\n} = {}): AttachRetryGate {\n  const floors = new Map<string, number>();\n  const remainingMs = (key: string): number => {\n    const until = floors.get(key);\n    if (until === undefined) return 0;\n    const remaining = until - now();\n    if (remaining <= 0) {\n      floors.delete(key);\n      return 0;\n    }\n    return remaining;\n  };\n  return {\n    noteRetryAfter(key, delayMs) {\n      const clamped = clampRetryAfter(delayMs);\n      if (clamped === null || clamped === 0) return;\n      const until = now() + clamped;\n      const existing = floors.get(key);\n      if (existing === undefined || existing < until) floors.set(key, until);\n    },\n    async waitForDial(key) {\n      // A hint that arrives while the dial sleeps extends the floor; re-check\n      // after every wait rather than trusting the deadline the sleep began with.\n      for (\n        let remaining = remainingMs(key);\n        remaining > 0;\n        remaining = remainingMs(key)\n      ) {\n        await wait(remaining);\n      }\n    },\n    remainingMs,\n    reset(key) {\n      if (key === undefined) floors.clear();\n      else floors.delete(key);\n    },\n  };\n}\n\n/** Process-wide gate shared by every deep-agent transport in the host. */\nexport const attachRetryGate: AttachRetryGate = createAttachRetryGate();\n\n/** Structural subset of the browser `WebSocket` that statewire's WS transport touches. */\nexport interface AttachSocketLike {\n  readonly readyState: number;\n  readonly protocol: string;\n  onopen: ((event: unknown) => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onclose: ((event: { code?: number; reason?: string }) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n}\n\nexport type AttachWebSocketConstructor = new (\n  url: string,\n  protocols?: string | string[],\n) => AttachSocketLike;\n\nconst defaultNow = (): number =>\n  typeof performance !== \"undefined\" && typeof performance.now === \"function\"\n    ? performance.now()\n    : Date.now();\n\n/** Statewire's keep-alive frame — never the hello. */\nconst isHeartbeatFrame = (data: unknown): boolean => {\n  const text = String(data);\n  return text === \"\" || text === \"{}\";\n};\n\n/**\n * Wrap a socket in a forwarding facade whose handler setters time the events\n * statewire attaches to (`onopen`, `onmessage`, `onclose`). A facade rather\n * than a subclass so the same instrumentation works over any host `WebSocket`\n * implementation, including test fakes.\n */\nexport function instrumentAttachSocket({\n  socket,\n  url,\n  onEvent,\n  now = defaultNow,\n}: {\n  socket: AttachSocketLike;\n  /** The thread attach URL the events are attributed to (not the socket URL). */\n  url: string;\n  onEvent: (event: DeepAgentAttachTimingEvent) => void;\n  now?: () => number;\n}): AttachSocketLike {\n  const createdAt = now();\n  let openedAt: number | null = null;\n  let helloSeen = false;\n  const emit = (event: DeepAgentAttachTimingEvent): void => {\n    try {\n      onEvent(event);\n    } catch {\n      // Observers are best-effort; the wire must never fail on telemetry.\n    }\n  };\n  let openHandler: AttachSocketLike[\"onopen\"] = null;\n  let messageHandler: AttachSocketLike[\"onmessage\"] = null;\n  let closeHandler: AttachSocketLike[\"onclose\"] = null;\n  socket.onopen = (event) => {\n    openedAt = now();\n    emit({ type: \"socket-open\", url, openMs: openedAt - createdAt });\n    openHandler?.(event);\n  };\n  socket.onmessage = (event) => {\n    if (helloSeen || isHeartbeatFrame(event.data)) {\n      messageHandler?.(event);\n      return;\n    }\n    helloSeen = true;\n    const startedAt = now();\n    try {\n      messageHandler?.(event);\n    } finally {\n      const finishedAt = now();\n      emit({\n        type: \"hello\",\n        url,\n        bytes: String(event.data).length,\n        handlerMs: finishedAt - startedAt,\n        sinceOpenMs: openedAt === null ? null : startedAt - openedAt,\n      });\n    }\n  };\n  socket.onclose = (event) => {\n    const closedAt = now();\n    emit({\n      type: \"socket-close\",\n      url,\n      code: event?.code,\n      reason: event?.reason,\n      sinceOpenMs: openedAt === null ? null : closedAt - openedAt,\n    });\n    const retryAfter = parseRetryAfterFromCloseReason(event?.reason);\n    if (retryAfter !== null) {\n      emit({\n        type: \"retry-after\",\n        url,\n        delayMs: retryAfter,\n        source: \"ws-close\",\n      });\n    }\n    closeHandler?.(event);\n  };\n  return {\n    get protocol() {\n      return socket.protocol;\n    },\n    get readyState() {\n      return socket.readyState;\n    },\n    get onopen() {\n      return openHandler;\n    },\n    set onopen(handler) {\n      openHandler = handler;\n    },\n    get onmessage() {\n      return messageHandler;\n    },\n    set onmessage(handler) {\n      messageHandler = handler;\n    },\n    get onclose() {\n      return closeHandler;\n    },\n    set onclose(handler) {\n      closeHandler = handler;\n    },\n    get onerror() {\n      return socket.onerror;\n    },\n    set onerror(handler) {\n      socket.onerror = handler;\n    },\n    send: (data) => socket.send(data),\n    close: (code, reason) => socket.close(code, reason),\n  };\n}\n\n/**\n * A `WebSocket`-shaped constructor that dials through `Base` and reports the\n * attach events for `url`. Constructor semantics (`new` returns the facade)\n * match what statewire's `webSocket` option expects.\n */\nexport function instrumentedWebSocketConstructor({\n  Base,\n  url,\n  onEvent,\n  now,\n}: {\n  Base: AttachWebSocketConstructor;\n  url: string;\n  onEvent: (event: DeepAgentAttachTimingEvent) => void;\n  now?: () => number;\n}): AttachWebSocketConstructor {\n  function InstrumentedWebSocket(\n    socketUrl: string,\n    protocols?: string | string[],\n  ) {\n    return instrumentAttachSocket({\n      socket: new Base(socketUrl, protocols),\n      url,\n      onEvent,\n      ...(now && { now }),\n    });\n  }\n  return InstrumentedWebSocket as unknown as AttachWebSocketConstructor;\n}\n\n/** Structural `fetch` — what statewire's SSE transport calls. */\nexport type AttachFetch = (\n  input: string | URL,\n  init?: unknown,\n) => Promise<{\n  ok: boolean;\n  status: number;\n  headers: { get(name: string): string | null };\n}>;\n\n/**\n * A `fetch` that reports a `Retry-After` header on refused attach requests\n * (the SSE `POST …/stream`) before handing the response back untouched.\n */\nexport function instrumentedAttachFetch<TFetch extends AttachFetch>({\n  baseFetch,\n  url,\n  onEvent,\n  now,\n}: {\n  baseFetch: TFetch;\n  url: string;\n  onEvent: (event: DeepAgentAttachTimingEvent) => void;\n  now?: () => number;\n}): TFetch {\n  const wrapped: AttachFetch = async (input, init) => {\n    const response = await baseFetch(input, init);\n    if (!response.ok && (response.status === 503 || response.status === 429)) {\n      const delayMs = parseRetryAfterHeaderMs(\n        response.headers.get(\"retry-after\"),\n        now,\n      );\n      if (delayMs !== null) {\n        try {\n          onEvent({ type: \"retry-after\", url, delayMs, source: \"http-header\" });\n        } catch {\n          // Observers are best-effort.\n        }\n      }\n    }\n    return response;\n  };\n  return wrapped as TFetch;\n}\n\n/** Structural view of the host globals the instrumentation resolves. */\ntype AttachGlobals = {\n  WebSocket?: AttachWebSocketConstructor;\n  fetch?: AttachFetch;\n};\n\n/**\n * The transport option overrides for one attach: an instrumented `webSocket`\n * (WS) or `fetch` (SSE) that reports attach events for `url` and feeds\n * `Retry-After` hints into the gate. Returns `{}` where the host has no such\n * global (a server render, a non-browser runtime) so the transport keeps its\n * defaults.\n */\nexport function createAttachInstrumentation({\n  url,\n  sse,\n  onEvent,\n  retryGate = attachRetryGate,\n  now,\n}: {\n  url: string;\n  sse: boolean;\n  onEvent?: ((event: DeepAgentAttachTimingEvent) => void) | undefined;\n  retryGate?: AttachRetryGate;\n  now?: () => number;\n}): { webSocket?: AttachWebSocketConstructor; fetch?: AttachFetch } {\n  const globals = globalThis as AttachGlobals;\n  const observe = (event: DeepAgentAttachTimingEvent): void => {\n    if (event.type === \"retry-after\")\n      retryGate.noteRetryAfter(url, event.delayMs);\n    onEvent?.(event);\n  };\n  if (sse) {\n    const baseFetch = globals.fetch;\n    if (typeof baseFetch !== \"function\") return {};\n    return {\n      fetch: instrumentedAttachFetch({\n        baseFetch: (input, init) => baseFetch(input, init),\n        url,\n        onEvent: observe,\n        ...(now && { now }),\n      }),\n    };\n  }\n  const Base = globals.WebSocket;\n  if (typeof Base !== \"function\") return {};\n  return {\n    webSocket: instrumentedWebSocketConstructor({\n      Base,\n      url,\n      onEvent: observe,\n      ...(now && { now }),\n    }),\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/packages/agent-runtime/src/statewire-attach-observer.js

@@ -0,0 +1,249 @@
+const MAX_RETRY_AFTER_MS = 3e4;
+const clampRetryAfter = (ms) => {
+  if (!Number.isFinite(ms)) return null;
+  return Math.min(Math.max(0, Math.round(ms)), MAX_RETRY_AFTER_MS);
+};
+function parseRetryAfterHeaderMs(value, now = () => Date.now()) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  if (trimmed === "") return null;
+  if (/^\d+$/.test(trimmed)) return clampRetryAfter(Number(trimmed) * 1e3);
+  if (!/[A-Za-z]/.test(trimmed)) return null;
+  const at = Date.parse(trimmed);
+  if (Number.isNaN(at)) return null;
+  return clampRetryAfter(at - now());
+}
+function parseRetryAfterFromCloseReason(reason) {
+  if (typeof reason !== "string" || reason === "") return null;
+  const match = /retry-after(-ms)?\s*[=:]\s*(\d+)/i.exec(reason);
+  if (!match) return null;
+  const amount = Number(match[2]);
+  return clampRetryAfter(match[1] ? amount : amount * 1e3);
+}
+function createAttachRetryGate({
+  now = () => Date.now(),
+  wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+} = {}) {
+  const floors = /* @__PURE__ */ new Map();
+  const remainingMs = (key) => {
+    const until = floors.get(key);
+    if (until === void 0) return 0;
+    const remaining = until - now();
+    if (remaining <= 0) {
+      floors.delete(key);
+      return 0;
+    }
+    return remaining;
+  };
+  return {
+    noteRetryAfter(key, delayMs) {
+      const clamped = clampRetryAfter(delayMs);
+      if (clamped === null || clamped === 0) return;
+      const until = now() + clamped;
+      const existing = floors.get(key);
+      if (existing === void 0 || existing < until) floors.set(key, until);
+    },
+    async waitForDial(key) {
+      for (let remaining = remainingMs(key); remaining > 0; remaining = remainingMs(key)) {
+        await wait(remaining);
+      }
+    },
+    remainingMs,
+    reset(key) {
+      if (key === void 0) floors.clear();
+      else floors.delete(key);
+    }
+  };
+}
+const attachRetryGate = createAttachRetryGate();
+const defaultNow = () => typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+const isHeartbeatFrame = (data) => {
+  const text = String(data);
+  return text === "" || text === "{}";
+};
+function instrumentAttachSocket({
+  socket,
+  url,
+  onEvent,
+  now = defaultNow
+}) {
+  const createdAt = now();
+  let openedAt = null;
+  let helloSeen = false;
+  const emit = (event) => {
+    try {
+      onEvent(event);
+    } catch {
+    }
+  };
+  let openHandler = null;
+  let messageHandler = null;
+  let closeHandler = null;
+  socket.onopen = (event) => {
+    openedAt = now();
+    emit({ type: "socket-open", url, openMs: openedAt - createdAt });
+    openHandler == null ? void 0 : openHandler(event);
+  };
+  socket.onmessage = (event) => {
+    if (helloSeen || isHeartbeatFrame(event.data)) {
+      messageHandler == null ? void 0 : messageHandler(event);
+      return;
+    }
+    helloSeen = true;
+    const startedAt = now();
+    try {
+      messageHandler == null ? void 0 : messageHandler(event);
+    } finally {
+      const finishedAt = now();
+      emit({
+        type: "hello",
+        url,
+        bytes: String(event.data).length,
+        handlerMs: finishedAt - startedAt,
+        sinceOpenMs: openedAt === null ? null : startedAt - openedAt
+      });
+    }
+  };
+  socket.onclose = (event) => {
+    const closedAt = now();
+    emit({
+      type: "socket-close",
+      url,
+      code: event == null ? void 0 : event.code,
+      reason: event == null ? void 0 : event.reason,
+      sinceOpenMs: openedAt === null ? null : closedAt - openedAt
+    });
+    const retryAfter = parseRetryAfterFromCloseReason(event == null ? void 0 : event.reason);
+    if (retryAfter !== null) {
+      emit({
+        type: "retry-after",
+        url,
+        delayMs: retryAfter,
+        source: "ws-close"
+      });
+    }
+    closeHandler == null ? void 0 : closeHandler(event);
+  };
+  return {
+    get protocol() {
+      return socket.protocol;
+    },
+    get readyState() {
+      return socket.readyState;
+    },
+    get onopen() {
+      return openHandler;
+    },
+    set onopen(handler) {
+      openHandler = handler;
+    },
+    get onmessage() {
+      return messageHandler;
+    },
+    set onmessage(handler) {
+      messageHandler = handler;
+    },
+    get onclose() {
+      return closeHandler;
+    },
+    set onclose(handler) {
+      closeHandler = handler;
+    },
+    get onerror() {
+      return socket.onerror;
+    },
+    set onerror(handler) {
+      socket.onerror = handler;
+    },
+    send: (data) => socket.send(data),
+    close: (code, reason) => socket.close(code, reason)
+  };
+}
+function instrumentedWebSocketConstructor({
+  Base,
+  url,
+  onEvent,
+  now
+}) {
+  function InstrumentedWebSocket(socketUrl, protocols) {
+    return instrumentAttachSocket({
+      socket: new Base(socketUrl, protocols),
+      url,
+      onEvent,
+      ...now && { now }
+    });
+  }
+  return InstrumentedWebSocket;
+}
+function instrumentedAttachFetch({
+  baseFetch,
+  url,
+  onEvent,
+  now
+}) {
+  const wrapped = async (input, init) => {
+    const response = await baseFetch(input, init);
+    if (!response.ok && (response.status === 503 || response.status === 429)) {
+      const delayMs = parseRetryAfterHeaderMs(
+        response.headers.get("retry-after"),
+        now
+      );
+      if (delayMs !== null) {
+        try {
+          onEvent({ type: "retry-after", url, delayMs, source: "http-header" });
+        } catch {
+        }
+      }
+    }
+    return response;
+  };
+  return wrapped;
+}
+function createAttachInstrumentation({
+  url,
+  sse,
+  onEvent,
+  retryGate = attachRetryGate,
+  now
+}) {
+  const globals = globalThis;
+  const observe = (event) => {
+    if (event.type === "retry-after")
+      retryGate.noteRetryAfter(url, event.delayMs);
+    onEvent == null ? void 0 : onEvent(event);
+  };
+  if (sse) {
+    const baseFetch = globals.fetch;
+    if (typeof baseFetch !== "function") return {};
+    return {
+      fetch: instrumentedAttachFetch({
+        baseFetch: (input, init) => baseFetch(input, init),
+        url,
+        onEvent: observe,
+        ...now && { now }
+      })
+    };
+  }
+  const Base = globals.WebSocket;
+  if (typeof Base !== "function") return {};
+  return {
+    webSocket: instrumentedWebSocketConstructor({
+      Base,
+      url,
+      onEvent: observe,
+      ...now && { now }
+    })
+  };
+}
+export {
+  MAX_RETRY_AFTER_MS,
+  attachRetryGate,
+  createAttachInstrumentation,
+  createAttachRetryGate,
+  instrumentAttachSocket,
+  instrumentedAttachFetch,
+  instrumentedWebSocketConstructor,
+  parseRetryAfterFromCloseReason,
+  parseRetryAfterHeaderMs
+};
+//# sourceMappingURL=statewire-attach-observer.js.map

package/dist/packages/agent-runtime/src/statewire-attach-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-attach-observer.js","sources":["../../../../../agent-runtime/src/statewire-attach-observer.ts"],"sourcesContent":["/**\n * Attach-path instrumentation for the deep-agent statewire transport, wired\n * through the two injection points statewire already exposes — the\n * `webSocket` constructor (`StatewireClient.WebsocketOptions`) and `fetch`\n * (`StatewireClient.HttpOptions`) — so the runtime can observe what the library\n * does not surface:\n *\n * - socket open latency (`ws_open_ms`), the hello frame's size and its\n *   synchronous handler cost (`hello_bytes`, `hello_handler_ms`), and close\n *   codes/reasons, for the thread-switch telemetry;\n * - a server `Retry-After` hint, honoured as a floor under the next dial.\n *\n * Retry-After today: statewire honours `retry-after` only on 429 command-frame\n * refusals (folded into the refusal `syn.retry`); its attach paths treat a 503\n * as a generic `HTTP 503` / `network` failure and back off exponentially with\n * no server input. Browsers never expose the response headers of a refused\n * WebSocket upgrade at all, so for the WS transport the hint can only ride\n * something the client can read: the close frame. The contract this module\n * reads is a close `reason` carrying `retry-after=<seconds>` (or\n * `retry-after-ms=<ms>`) — the pinboard half of that contract is a separate\n * change; until it lands the WS path simply sees no hint. The SSE attach\n * (`POST …/stream`) is a plain fetch, so its `Retry-After` header is read here\n * directly.\n *\n * This package compiles without the DOM lib (React Native honesty), so the\n * browser surface is typed structurally and resolved through `globalThis`.\n */\n\n/**\n * Who refused a wake (503/429), read off the response body against the two\n * refusal vocabularies the iris scaler also classifies data-plane 503s by\n * (`iris/scaler/src/v2AccessLog.ts`):\n *\n * - `\"placement\"` — the pinboard's own refusal, `{\"error\": …}` with one of its\n *   known strings (\"no live workers for hostname\", \"registry cold start,\n *   retry\", \"takeover in progress, retry\", …): the thread has no worker to\n *   dial right now.\n * - `\"worker\"` — a pinned instance-lifecycle refusal, `{\"detail\": …}` with one\n *   of its known strings (\"instance closing; retry\", \"activation queue full;\n *   retry\", \"host draining; retry\", …): one instance on the worker the thread\n *   is already placed on, cleared in the time a teardown takes.\n * - `\"unknown\"` — any other 503/429 body (unreadable, an unfamiliar string, a\n *   real worker failure such as \"Thread history load failed\"): treated\n *   conservatively — the full `Retry-After`, no dial dropped.\n * - `null` — not a refusal status.\n */\nexport type DeepAgentWakeRefusal = \"placement\" | \"worker\" | \"unknown\" | null;\n\nexport type DeepAgentAttachTimingEvent =\n  | { type: \"socket-open\"; url: string; openMs: number }\n  | {\n      type: \"hello\";\n      url: string;\n      /** UTF-16 length of the hello frame — bytes for the ASCII JSON the wire carries. */\n      bytes: number;\n      /** Synchronous cost of statewire's message handler for the hello (parse + apply + flush). */\n      handlerMs: number;\n      /** Hello arrival relative to the socket open; `null` when the open was not observed. */\n      sinceOpenMs: number | null;\n    }\n  | {\n      type: \"socket-close\";\n      url: string;\n      code: number | undefined;\n      reason: string | undefined;\n      sinceOpenMs: number | null;\n    }\n  | {\n      type: \"retry-after\";\n      url: string;\n      delayMs: number;\n      source: \"ws-close\" | \"http-header\";\n    }\n  | {\n      /** `POST …/prewarm` answered (see `wakeDeepAgentThread`). */\n      type: \"wake\";\n      url: string;\n      status: number;\n      durationMs: number;\n      /** How the host sourced the history: already resident (`warm`) or loaded by this call. */\n      history: \"fresh_load\" | \"warm\" | null;\n      /** Who refused a 503/429 (see {@link DeepAgentWakeRefusal}); `null` otherwise. */\n      refusal: DeepAgentWakeRefusal;\n    };\n\n/** Longest server hint honoured — a buggy or hostile hint must not park a client. */\nexport const MAX_RETRY_AFTER_MS = 30_000;\n\nconst clampRetryAfter = (ms: number): number | null => {\n  if (!Number.isFinite(ms)) return null;\n  return Math.min(Math.max(0, Math.round(ms)), MAX_RETRY_AFTER_MS);\n};\n\n/**\n * Parse an HTTP `Retry-After` header value: delta-seconds or an HTTP-date.\n * Returns the delay in ms clamped to {@link MAX_RETRY_AFTER_MS}, or `null` when\n * the value is absent or unparseable.\n */\nexport function parseRetryAfterHeaderMs(\n  value: string | null | undefined,\n  now: () => number = () => Date.now(),\n): number | null {\n  if (typeof value !== \"string\") return null;\n  const trimmed = value.trim();\n  if (trimmed === \"\") return null;\n  if (/^\\d+$/.test(trimmed)) return clampRetryAfter(Number(trimmed) * 1000);\n  // An HTTP-date always names a weekday/month; anything else numeric-looking\n  // (\"1.5\") would otherwise parse as some far-off calendar date.\n  if (!/[A-Za-z]/.test(trimmed)) return null;\n  const at = Date.parse(trimmed);\n  if (Number.isNaN(at)) return null;\n  return clampRetryAfter(at - now());\n}\n\n/**\n * Parse a retry hint off a WebSocket close reason: `retry-after=<seconds>` or\n * `retry-after-ms=<ms>` anywhere in the reason text (case-insensitive, `=` or\n * `:`). Returns ms clamped to {@link MAX_RETRY_AFTER_MS}, or `null`.\n */\nexport function parseRetryAfterFromCloseReason(\n  reason: string | undefined,\n): number | null {\n  if (typeof reason !== \"string\" || reason === \"\") return null;\n  const match = /retry-after(-ms)?\\s*[=:]\\s*(\\d+)/i.exec(reason);\n  if (!match) return null;\n  const amount = Number(match[2]);\n  return clampRetryAfter(match[1] ? amount : amount * 1000);\n}\n\nexport interface AttachRetryGate {\n  /** Record a hint: no dial for `key` before `now + delayMs` (clamped). */\n  noteRetryAfter(key: string, delayMs: number): void;\n  /** Resolves once the recorded floor for `key` has passed (immediately when none). */\n  waitForDial(key: string): Promise<void>;\n  /** Remaining floor for `key` in ms (0 when none). */\n  remainingMs(key: string): number;\n  /** Drop one key's floor, or every floor. */\n  reset(key?: string): void;\n}\n\n/**\n * Per-key dial floors. Keyed by the thread's attach URL so a hint delivered\n * for one thread never delays another. The floor is a minimum under\n * statewire's own backoff, never a replacement for it: the transport still\n * schedules its retry, and the dial simply waits out the remainder inside the\n * headers resolve (both attach paths resolve headers before they dial).\n */\nexport function createAttachRetryGate({\n  now = () => Date.now(),\n  wait = (ms: number) =>\n    new Promise<void>((resolve) => setTimeout(resolve, ms)),\n}: {\n  now?: () => number;\n  wait?: (ms: number) => Promise<void>;\n} = {}): AttachRetryGate {\n  const floors = new Map<string, number>();\n  const remainingMs = (key: string): number => {\n    const until = floors.get(key);\n    if (until === undefined) return 0;\n    const remaining = until - now();\n    if (remaining <= 0) {\n      floors.delete(key);\n      return 0;\n    }\n    return remaining;\n  };\n  return {\n    noteRetryAfter(key, delayMs) {\n      const clamped = clampRetryAfter(delayMs);\n      if (clamped === null || clamped === 0) return;\n      const until = now() + clamped;\n      const existing = floors.get(key);\n      if (existing === undefined || existing < until) floors.set(key, until);\n    },\n    async waitForDial(key) {\n      // A hint that arrives while the dial sleeps extends the floor; re-check\n      // after every wait rather than trusting the deadline the sleep began with.\n      for (\n        let remaining = remainingMs(key);\n        remaining > 0;\n        remaining = remainingMs(key)\n      ) {\n        await wait(remaining);\n      }\n    },\n    remainingMs,\n    reset(key) {\n      if (key === undefined) floors.clear();\n      else floors.delete(key);\n    },\n  };\n}\n\n/** Process-wide gate shared by every deep-agent transport in the host. */\nexport const attachRetryGate: AttachRetryGate = createAttachRetryGate();\n\n/** Structural subset of the browser `WebSocket` that statewire's WS transport touches. */\nexport interface AttachSocketLike {\n  readonly readyState: number;\n  readonly protocol: string;\n  onopen: ((event: unknown) => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n  onclose: ((event: { code?: number; reason?: string }) => void) | null;\n  onerror: ((event: unknown) => void) | null;\n  send(data: string): void;\n  close(code?: number, reason?: string): void;\n}\n\nexport type AttachWebSocketConstructor = new (\n  url: string,\n  protocols?: string | string[],\n) => AttachSocketLike;\n\nconst defaultNow = (): number =>\n  typeof performance !== \"undefined\" && typeof performance.now === \"function\"\n    ? performance.now()\n    : Date.now();\n\n/** Statewire's keep-alive frame — never the hello. */\nconst isHeartbeatFrame = (data: unknown): boolean => {\n  const text = String(data);\n  return text === \"\" || text === \"{}\";\n};\n\n/**\n * Wrap a socket in a forwarding facade whose handler setters time the events\n * statewire attaches to (`onopen`, `onmessage`, `onclose`). A facade rather\n * than a subclass so the same instrumentation works over any host `WebSocket`\n * implementation, including test fakes.\n */\nexport function instrumentAttachSocket({\n  socket,\n  url,\n  onEvent,\n  now = defaultNow,\n}: {\n  socket: AttachSocketLike;\n  /** The thread attach URL the events are attributed to (not the socket URL). */\n  url: string;\n  onEvent: (event: DeepAgentAttachTimingEvent) => void;\n  now?: () => number;\n}): AttachSocketLike {\n  const createdAt = now();\n  let openedAt: number | null = null;\n  let helloSeen = false;\n  const emit = (event: DeepAgentAttachTimingEvent): void => {\n    try {\n      onEvent(event);\n    } catch {\n      // Observers are best-effort; the wire must never fail on telemetry.\n    }\n  };\n  let openHandler: AttachSocketLike[\"onopen\"] = null;\n  let messageHandler: AttachSocketLike[\"onmessage\"] = null;\n  let closeHandler: AttachSocketLike[\"onclose\"] = null;\n  socket.onopen = (event) => {\n    openedAt = now();\n    emit({ type: \"socket-open\", url, openMs: openedAt - createdAt });\n    openHandler?.(event);\n  };\n  socket.onmessage = (event) => {\n    if (helloSeen || isHeartbeatFrame(event.data)) {\n      messageHandler?.(event);\n      return;\n    }\n    helloSeen = true;\n    const startedAt = now();\n    try {\n      messageHandler?.(event);\n    } finally {\n      const finishedAt = now();\n      emit({\n        type: \"hello\",\n        url,\n        bytes: String(event.data).length,\n        handlerMs: finishedAt - startedAt,\n        sinceOpenMs: openedAt === null ? null : startedAt - openedAt,\n      });\n    }\n  };\n  socket.onclose = (event) => {\n    const closedAt = now();\n    emit({\n      type: \"socket-close\",\n      url,\n      code: event?.code,\n      reason: event?.reason,\n      sinceOpenMs: openedAt === null ? null : closedAt - openedAt,\n    });\n    const retryAfter = parseRetryAfterFromCloseReason(event?.reason);\n    if (retryAfter !== null) {\n      emit({\n        type: \"retry-after\",\n        url,\n        delayMs: retryAfter,\n        source: \"ws-close\",\n      });\n    }\n    closeHandler?.(event);\n  };\n  return {\n    get protocol() {\n      return socket.protocol;\n    },\n    get readyState() {\n      return socket.readyState;\n    },\n    get onopen() {\n      return openHandler;\n    },\n    set onopen(handler) {\n      openHandler = handler;\n    },\n    get onmessage() {\n      return messageHandler;\n    },\n    set onmessage(handler) {\n      messageHandler = handler;\n    },\n    get onclose() {\n      return closeHandler;\n    },\n    set onclose(handler) {\n      closeHandler = handler;\n    },\n    get onerror() {\n      return socket.onerror;\n    },\n    set onerror(handler) {\n      socket.onerror = handler;\n    },\n    send: (data) => socket.send(data),\n    close: (code, reason) => socket.close(code, reason),\n  };\n}\n\n/**\n * A `WebSocket`-shaped constructor that dials through `Base` and reports the\n * attach events for `url`. Constructor semantics (`new` returns the facade)\n * match what statewire's `webSocket` option expects.\n */\nexport function instrumentedWebSocketConstructor({\n  Base,\n  url,\n  onEvent,\n  now,\n}: {\n  Base: AttachWebSocketConstructor;\n  url: string;\n  onEvent: (event: DeepAgentAttachTimingEvent) => void;\n  now?: () => number;\n}): AttachWebSocketConstructor {\n  function InstrumentedWebSocket(\n    socketUrl: string,\n    protocols?: string | string[],\n  ) {\n    return instrumentAttachSocket({\n      socket: new Base(socketUrl, protocols),\n      url,\n      onEvent,\n      ...(now && { now }),\n    });\n  }\n  return InstrumentedWebSocket as unknown as AttachWebSocketConstructor;\n}\n\n/** Structural `fetch` — what statewire's SSE transport calls. */\nexport type AttachFetch = (\n  input: string | URL,\n  init?: unknown,\n) => Promise<{\n  ok: boolean;\n  status: number;\n  headers: { get(name: string): string | null };\n}>;\n\n/**\n * A `fetch` that reports a `Retry-After` header on refused attach requests\n * (the SSE `POST …/stream`) before handing the response back untouched.\n */\nexport function instrumentedAttachFetch<TFetch extends AttachFetch>({\n  baseFetch,\n  url,\n  onEvent,\n  now,\n}: {\n  baseFetch: TFetch;\n  url: string;\n  onEvent: (event: DeepAgentAttachTimingEvent) => void;\n  now?: () => number;\n}): TFetch {\n  const wrapped: AttachFetch = async (input, init) => {\n    const response = await baseFetch(input, init);\n    if (!response.ok && (response.status === 503 || response.status === 429)) {\n      const delayMs = parseRetryAfterHeaderMs(\n        response.headers.get(\"retry-after\"),\n        now,\n      );\n      if (delayMs !== null) {\n        try {\n          onEvent({ type: \"retry-after\", url, delayMs, source: \"http-header\" });\n        } catch {\n          // Observers are best-effort.\n        }\n      }\n    }\n    return response;\n  };\n  return wrapped as TFetch;\n}\n\n/** Structural view of the host globals the instrumentation resolves. */\ntype AttachGlobals = {\n  WebSocket?: AttachWebSocketConstructor;\n  fetch?: AttachFetch;\n};\n\n/**\n * The transport option overrides for one attach: an instrumented `webSocket`\n * (WS) or `fetch` (SSE) that reports attach events for `url` and feeds\n * `Retry-After` hints into the gate. Returns `{}` where the host has no such\n * global (a server render, a non-browser runtime) so the transport keeps its\n * defaults.\n */\nexport function createAttachInstrumentation({\n  url,\n  sse,\n  onEvent,\n  retryGate = attachRetryGate,\n  now,\n}: {\n  url: string;\n  sse: boolean;\n  onEvent?: ((event: DeepAgentAttachTimingEvent) => void) | undefined;\n  retryGate?: AttachRetryGate;\n  now?: () => number;\n}): { webSocket?: AttachWebSocketConstructor; fetch?: AttachFetch } {\n  const globals = globalThis as AttachGlobals;\n  const observe = (event: DeepAgentAttachTimingEvent): void => {\n    if (event.type === \"retry-after\")\n      retryGate.noteRetryAfter(url, event.delayMs);\n    onEvent?.(event);\n  };\n  if (sse) {\n    const baseFetch = globals.fetch;\n    if (typeof baseFetch !== \"function\") return {};\n    return {\n      fetch: instrumentedAttachFetch({\n        baseFetch: (input, init) => baseFetch(input, init),\n        url,\n        onEvent: observe,\n        ...(now && { now }),\n      }),\n    };\n  }\n  const Base = globals.WebSocket;\n  if (typeof Base !== \"function\") return {};\n  return {\n    webSocket: instrumentedWebSocketConstructor({\n      Base,\n      url,\n      onEvent: observe,\n      ...(now && { now }),\n    }),\n  };\n}\n"],"names":[],"mappings":"AAsFO,MAAM,qBAAqB;AAElC,MAAM,kBAAkB,CAAC,OAA8B;AACrD,MAAI,CAAC,OAAO,SAAS,EAAE,EAAG,QAAO;AACjC,SAAO,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC,GAAG,kBAAkB;AACjE;AAOO,SAAS,wBACd,OACA,MAAoB,MAAM,KAAK,OAChB;AACf,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,MAAM,KAAA;AACtB,MAAI,YAAY,GAAI,QAAO;AAC3B,MAAI,QAAQ,KAAK,OAAO,UAAU,gBAAgB,OAAO,OAAO,IAAI,GAAI;AAGxE,MAAI,CAAC,WAAW,KAAK,OAAO,EAAG,QAAO;AACtC,QAAM,KAAK,KAAK,MAAM,OAAO;AAC7B,MAAI,OAAO,MAAM,EAAE,EAAG,QAAO;AAC7B,SAAO,gBAAgB,KAAK,KAAK;AACnC;AAOO,SAAS,+BACd,QACe;AACf,MAAI,OAAO,WAAW,YAAY,WAAW,GAAI,QAAO;AACxD,QAAM,QAAQ,oCAAoC,KAAK,MAAM;AAC7D,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,SAAS,OAAO,MAAM,CAAC,CAAC;AAC9B,SAAO,gBAAgB,MAAM,CAAC,IAAI,SAAS,SAAS,GAAI;AAC1D;AAoBO,SAAS,sBAAsB;AAAA,EACpC,MAAM,MAAM,KAAK,IAAA;AAAA,EACjB,OAAO,CAAC,OACN,IAAI,QAAc,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAC1D,IAGI,IAAqB;AACvB,QAAM,6BAAa,IAAA;AACnB,QAAM,cAAc,CAAC,QAAwB;AAC3C,UAAM,QAAQ,OAAO,IAAI,GAAG;AAC5B,QAAI,UAAU,OAAW,QAAO;AAChC,UAAM,YAAY,QAAQ,IAAA;AAC1B,QAAI,aAAa,GAAG;AAClB,aAAO,OAAO,GAAG;AACjB,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,eAAe,KAAK,SAAS;AAC3B,YAAM,UAAU,gBAAgB,OAAO;AACvC,UAAI,YAAY,QAAQ,YAAY,EAAG;AACvC,YAAM,QAAQ,QAAQ;AACtB,YAAM,WAAW,OAAO,IAAI,GAAG;AAC/B,UAAI,aAAa,UAAa,WAAW,MAAO,QAAO,IAAI,KAAK,KAAK;AAAA,IACvE;AAAA,IACA,MAAM,YAAY,KAAK;AAGrB,eACM,YAAY,YAAY,GAAG,GAC/B,YAAY,GACZ,YAAY,YAAY,GAAG,GAC3B;AACA,cAAM,KAAK,SAAS;AAAA,MACtB;AAAA,IACF;AAAA,IACA;AAAA,IACA,MAAM,KAAK;AACT,UAAI,QAAQ,OAAW,QAAO,MAAA;AAAA,UACzB,QAAO,OAAO,GAAG;AAAA,IACxB;AAAA,EAAA;AAEJ;AAGO,MAAM,kBAAmC,sBAAA;AAmBhD,MAAM,aAAa,MACjB,OAAO,gBAAgB,eAAe,OAAO,YAAY,QAAQ,aAC7D,YAAY,QACZ,KAAK,IAAA;AAGX,MAAM,mBAAmB,CAAC,SAA2B;AACnD,QAAM,OAAO,OAAO,IAAI;AACxB,SAAO,SAAS,MAAM,SAAS;AACjC;AAQO,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA,MAAM;AACR,GAMqB;AACnB,QAAM,YAAY,IAAA;AAClB,MAAI,WAA0B;AAC9B,MAAI,YAAY;AAChB,QAAM,OAAO,CAAC,UAA4C;AACxD,QAAI;AACF,cAAQ,KAAK;AAAA,IACf,QAAQ;AAAA,IAER;AAAA,EACF;AACA,MAAI,cAA0C;AAC9C,MAAI,iBAAgD;AACpD,MAAI,eAA4C;AAChD,SAAO,SAAS,CAAC,UAAU;AACzB,eAAW,IAAA;AACX,SAAK,EAAE,MAAM,eAAe,KAAK,QAAQ,WAAW,WAAW;AAC/D,+CAAc;AAAA,EAChB;AACA,SAAO,YAAY,CAAC,UAAU;AAC5B,QAAI,aAAa,iBAAiB,MAAM,IAAI,GAAG;AAC7C,uDAAiB;AACjB;AAAA,IACF;AACA,gBAAY;AACZ,UAAM,YAAY,IAAA;AAClB,QAAI;AACF,uDAAiB;AAAA,IACnB,UAAA;AACE,YAAM,aAAa,IAAA;AACnB,WAAK;AAAA,QACH,MAAM;AAAA,QACN;AAAA,QACA,OAAO,OAAO,MAAM,IAAI,EAAE;AAAA,QAC1B,WAAW,aAAa;AAAA,QACxB,aAAa,aAAa,OAAO,OAAO,YAAY;AAAA,MAAA,CACrD;AAAA,IACH;AAAA,EACF;AACA,SAAO,UAAU,CAAC,UAAU;AAC1B,UAAM,WAAW,IAAA;AACjB,SAAK;AAAA,MACH,MAAM;AAAA,MACN;AAAA,MACA,MAAM,+BAAO;AAAA,MACb,QAAQ,+BAAO;AAAA,MACf,aAAa,aAAa,OAAO,OAAO,WAAW;AAAA,IAAA,CACpD;AACD,UAAM,aAAa,+BAA+B,+BAAO,MAAM;AAC/D,QAAI,eAAe,MAAM;AACvB,WAAK;AAAA,QACH,MAAM;AAAA,QACN;AAAA,QACA,SAAS;AAAA,QACT,QAAQ;AAAA,MAAA,CACT;AAAA,IACH;AACA,iDAAe;AAAA,EACjB;AACA,SAAO;AAAA,IACL,IAAI,WAAW;AACb,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,IAAI,aAAa;AACf,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,IAAI,SAAS;AACX,aAAO;AAAA,IACT;AAAA,IACA,IAAI,OAAO,SAAS;AAClB,oBAAc;AAAA,IAChB;AAAA,IACA,IAAI,YAAY;AACd,aAAO;AAAA,IACT;AAAA,IACA,IAAI,UAAU,SAAS;AACrB,uBAAiB;AAAA,IACnB;AAAA,IACA,IAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAAA,IACA,IAAI,QAAQ,SAAS;AACnB,qBAAe;AAAA,IACjB;AAAA,IACA,IAAI,UAAU;AACZ,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,IAAI,QAAQ,SAAS;AACnB,aAAO,UAAU;AAAA,IACnB;AAAA,IACA,MAAM,CAAC,SAAS,OAAO,KAAK,IAAI;AAAA,IAChC,OAAO,CAAC,MAAM,WAAW,OAAO,MAAM,MAAM,MAAM;AAAA,EAAA;AAEtD;AAOO,SAAS,iCAAiC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAK+B;AAC7B,WAAS,sBACP,WACA,WACA;AACA,WAAO,uBAAuB;AAAA,MAC5B,QAAQ,IAAI,KAAK,WAAW,SAAS;AAAA,MACrC;AAAA,MACA;AAAA,MACA,GAAI,OAAO,EAAE,IAAA;AAAA,IAAI,CAClB;AAAA,EACH;AACA,SAAO;AACT;AAgBO,SAAS,wBAAoD;AAAA,EAClE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKW;AACT,QAAM,UAAuB,OAAO,OAAO,SAAS;AAClD,UAAM,WAAW,MAAM,UAAU,OAAO,IAAI;AAC5C,QAAI,CAAC,SAAS,OAAO,SAAS,WAAW,OAAO,SAAS,WAAW,MAAM;AACxE,YAAM,UAAU;AAAA,QACd,SAAS,QAAQ,IAAI,aAAa;AAAA,QAClC;AAAA,MAAA;AAEF,UAAI,YAAY,MAAM;AACpB,YAAI;AACF,kBAAQ,EAAE,MAAM,eAAe,KAAK,SAAS,QAAQ,eAAe;AAAA,QACtE,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAeO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AAAA,EACZ;AACF,GAMoE;AAClE,QAAM,UAAU;AAChB,QAAM,UAAU,CAAC,UAA4C;AAC3D,QAAI,MAAM,SAAS;AACjB,gBAAU,eAAe,KAAK,MAAM,OAAO;AAC7C,uCAAU;AAAA,EACZ;AACA,MAAI,KAAK;AACP,UAAM,YAAY,QAAQ;AAC1B,QAAI,OAAO,cAAc,WAAY,QAAO,CAAA;AAC5C,WAAO;AAAA,MACL,OAAO,wBAAwB;AAAA,QAC7B,WAAW,CAAC,OAAO,SAAS,UAAU,OAAO,IAAI;AAAA,QACjD;AAAA,QACA,SAAS;AAAA,QACT,GAAI,OAAO,EAAE,IAAA;AAAA,MAAI,CAClB;AAAA,IAAA;AAAA,EAEL;AACA,QAAM,OAAO,QAAQ;AACrB,MAAI,OAAO,SAAS,WAAY,QAAO,CAAA;AACvC,SAAO;AAAA,IACL,WAAW,iCAAiC;AAAA,MAC1C;AAAA,MACA;AAAA,MACA,SAAS;AAAA,MACT,GAAI,OAAO,EAAE,IAAA;AAAA,IAAI,CAClB;AAAA,EAAA;AAEL;"}

package/dist/packages/agent-runtime/src/statewire-state.cjs

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const preStreamState = { messages: [], todos: [] };
+Object.freeze(preStreamState.messages);
+Object.freeze(preStreamState.todos);
+const DEEP_AGENT_PRE_STREAM_STATE = Object.freeze(preStreamState);
+function readDeepAgentStreamValues(state) {
+  return typeof state === "object" && state !== null ? state : DEEP_AGENT_PRE_STREAM_STATE;
+}
+function isDeepAgentStateHydrated(state) {
+  return typeof state === "object" && state !== null && state !== DEEP_AGENT_PRE_STREAM_STATE;
+}
+exports.DEEP_AGENT_PRE_STREAM_STATE = DEEP_AGENT_PRE_STREAM_STATE;
+exports.isDeepAgentStateHydrated = isDeepAgentStateHydrated;
+exports.readDeepAgentStreamValues = readDeepAgentStreamValues;
+//# sourceMappingURL=statewire-state.cjs.map

package/dist/packages/agent-runtime/src/statewire-state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-state.cjs","sources":["../../../../../agent-runtime/src/statewire-state.ts"],"sourcesContent":["import type { DeepAgentStreamValues } from './types';\n\n/**\n * Typed pre-stream default for the deep-agent statewire state.\n *\n * The statewire client's replicated state is `undefined` (and can transiently\n * be `null`/non-object on a replay boundary) until an attach snapshot applies —\n * `@assistant-ui/react-statewire` derives its `\"loading\"` thread status from\n * exactly that absence, so the raw wire value must keep carrying it. Consumers\n * of OUR conversion layer, however, should never have to null-check the whole\n * state: they read through {@link readDeepAgentStreamValues}, which substitutes\n * this constant while the state is not hydrated.\n *\n * Module-level constant on purpose: selector fallbacks must be referentially\n * stable (`useStatewireState` compares selector results with `Object.is`, so a\n * fresh `[]`/`{}` per call re-renders forever). Frozen so a consumer cannot\n * mutate the shared default.\n */\nconst preStreamState: DeepAgentStreamValues = { messages: [], todos: [] };\nObject.freeze(preStreamState.messages);\nObject.freeze(preStreamState.todos);\nexport const DEEP_AGENT_PRE_STREAM_STATE: DeepAgentStreamValues = Object.freeze(preStreamState);\n\n/**\n * Read the deep-agent stream values off a raw statewire state, substituting\n * {@link DEEP_AGENT_PRE_STREAM_STATE} while the state is not an object yet\n * (pre-attach, or a replay boundary republishing `undefined`).\n *\n * Identity-preserving: a hydrated state returns the same object reference it\n * was given and the pre-stream branch always returns the same module constant,\n * so this is safe to call inside `useStatewireState` selectors.\n */\nexport function readDeepAgentStreamValues(state: unknown): DeepAgentStreamValues {\n  return typeof state === 'object' && state !== null\n    ? (state as DeepAgentStreamValues)\n    : DEEP_AGENT_PRE_STREAM_STATE;\n}\n\n/**\n * Whether a state (raw, or already normalized through\n * {@link readDeepAgentStreamValues}) carries a real wire payload. `false`\n * exactly while the pre-stream default stands in — the explicit signal for\n * code that must distinguish \"empty thread\" from \"no snapshot yet\".\n */\nexport function isDeepAgentStateHydrated(state: unknown): boolean {\n  return typeof state === 'object' && state !== null && state !== DEEP_AGENT_PRE_STREAM_STATE;\n}\n"],"names":[],"mappings":";;AAkBA,MAAM,iBAAwC,EAAE,UAAU,IAAI,OAAO,CAAA,EAAC;AACtE,OAAO,OAAO,eAAe,QAAQ;AACrC,OAAO,OAAO,eAAe,KAAK;AAC3B,MAAM,8BAAqD,OAAO,OAAO,cAAc;AAWvF,SAAS,0BAA0B,OAAuC;AAC/E,SAAO,OAAO,UAAU,YAAY,UAAU,OACzC,QACD;AACN;AAQO,SAAS,yBAAyB,OAAyB;AAChE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU;AAClE;;;;"}

package/dist/packages/agent-runtime/src/statewire-state.js

@@ -0,0 +1,16 @@
+const preStreamState = { messages: [], todos: [] };
+Object.freeze(preStreamState.messages);
+Object.freeze(preStreamState.todos);
+const DEEP_AGENT_PRE_STREAM_STATE = Object.freeze(preStreamState);
+function readDeepAgentStreamValues(state) {
+  return typeof state === "object" && state !== null ? state : DEEP_AGENT_PRE_STREAM_STATE;
+}
+function isDeepAgentStateHydrated(state) {
+  return typeof state === "object" && state !== null && state !== DEEP_AGENT_PRE_STREAM_STATE;
+}
+export {
+  DEEP_AGENT_PRE_STREAM_STATE,
+  isDeepAgentStateHydrated,
+  readDeepAgentStreamValues
+};
+//# sourceMappingURL=statewire-state.js.map

package/dist/packages/agent-runtime/src/statewire-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statewire-state.js","sources":["../../../../../agent-runtime/src/statewire-state.ts"],"sourcesContent":["import type { DeepAgentStreamValues } from './types';\n\n/**\n * Typed pre-stream default for the deep-agent statewire state.\n *\n * The statewire client's replicated state is `undefined` (and can transiently\n * be `null`/non-object on a replay boundary) until an attach snapshot applies —\n * `@assistant-ui/react-statewire` derives its `\"loading\"` thread status from\n * exactly that absence, so the raw wire value must keep carrying it. Consumers\n * of OUR conversion layer, however, should never have to null-check the whole\n * state: they read through {@link readDeepAgentStreamValues}, which substitutes\n * this constant while the state is not hydrated.\n *\n * Module-level constant on purpose: selector fallbacks must be referentially\n * stable (`useStatewireState` compares selector results with `Object.is`, so a\n * fresh `[]`/`{}` per call re-renders forever). Frozen so a consumer cannot\n * mutate the shared default.\n */\nconst preStreamState: DeepAgentStreamValues = { messages: [], todos: [] };\nObject.freeze(preStreamState.messages);\nObject.freeze(preStreamState.todos);\nexport const DEEP_AGENT_PRE_STREAM_STATE: DeepAgentStreamValues = Object.freeze(preStreamState);\n\n/**\n * Read the deep-agent stream values off a raw statewire state, substituting\n * {@link DEEP_AGENT_PRE_STREAM_STATE} while the state is not an object yet\n * (pre-attach, or a replay boundary republishing `undefined`).\n *\n * Identity-preserving: a hydrated state returns the same object reference it\n * was given and the pre-stream branch always returns the same module constant,\n * so this is safe to call inside `useStatewireState` selectors.\n */\nexport function readDeepAgentStreamValues(state: unknown): DeepAgentStreamValues {\n  return typeof state === 'object' && state !== null\n    ? (state as DeepAgentStreamValues)\n    : DEEP_AGENT_PRE_STREAM_STATE;\n}\n\n/**\n * Whether a state (raw, or already normalized through\n * {@link readDeepAgentStreamValues}) carries a real wire payload. `false`\n * exactly while the pre-stream default stands in — the explicit signal for\n * code that must distinguish \"empty thread\" from \"no snapshot yet\".\n */\nexport function isDeepAgentStateHydrated(state: unknown): boolean {\n  return typeof state === 'object' && state !== null && state !== DEEP_AGENT_PRE_STREAM_STATE;\n}\n"],"names":[],"mappings":"AAkBA,MAAM,iBAAwC,EAAE,UAAU,IAAI,OAAO,CAAA,EAAC;AACtE,OAAO,OAAO,eAAe,QAAQ;AACrC,OAAO,OAAO,eAAe,KAAK;AAC3B,MAAM,8BAAqD,OAAO,OAAO,cAAc;AAWvF,SAAS,0BAA0B,OAAuC;AAC/E,SAAO,OAAO,UAAU,YAAY,UAAU,OACzC,QACD;AACN;AAQO,SAAS,yBAAyB,OAAyB;AAChE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU;AAClE;"}