@athenaintel/react 0.43.0 → 0.50.0

package/dist/agent-runtime/src/thread-handoff-qr.d.ts

@@ -0,0 +1,11 @@
+/**
+ * QR symbol for a handoff link as a single SVG path in module units, so any
+ * surface can render `<svg viewBox="0 0 {size} {size}"><path d={path} /></svg>`
+ * without a canvas or an image request.
+ */
+export declare const buildHandoffQrSvg: ({ text }: {
+    text: string;
+}) => {
+    size: number;
+    path: string;
+};

package/dist/agent-runtime/src/thread-handoff.d.ts

@@ -1,364 +1,3 @@
-import { z } from 'zod';
-export declare const HANDOFF_DESTINATIONS: readonly ['chrome', 'mobile', 'word', 'powerpoint', 'excel'];
-export type HandoffDestination = (typeof HANDOFF_DESTINATIONS)[number];
-export declare const OFFICE_HANDOFF_DESTINATIONS: readonly ['word', 'powerpoint', 'excel'];
-export type OfficeHandoffDestination = (typeof OFFICE_HANDOFF_DESTINATIONS)[number];
-/** Destinations agora brokers; Chrome is launched page-side by the extension. */
-export declare const SERVER_HANDOFF_DESTINATIONS: readonly ["mobile", "word", "powerpoint", "excel"];
-export type ServerHandoffDestination = (typeof SERVER_HANDOFF_DESTINATIONS)[number];
-export type HandoffSource = 'spaces' | 'chrome' | 'mobile' | 'word' | 'powerpoint' | 'excel';
-export declare const handoffEnvironmentSchema: z.ZodEnum<{
-    localhost: "localhost";
-    production: "production";
-    staging: "staging";
-}>;
-export type HandoffEnvironment = z.infer<typeof handoffEnvironmentSchema>;
-export declare const handoffStateSchema: z.ZodEnum<{
-    acknowledged: "acknowledged";
-    claimed: "claimed";
-    failed: "failed";
-    issued: "issued";
-    launched: "launched";
-}>;
-export type HandoffState = z.infer<typeof handoffStateSchema>;
-export declare const handoffReadinessStateSchema: z.ZodEnum<{
-    not_registered: "not_registered";
-    registered: "registered";
-    stale: "stale";
-    unknown: "unknown";
-    unsupported: "unsupported";
-}>;
-export type HandoffReadinessState = z.infer<typeof handoffReadinessStateSchema>;
-export declare const destinationReadinessSchema: z.ZodObject<{
-    destination: z.ZodEnum<{
-        chrome: "chrome";
-        excel: "excel";
-        mobile: "mobile";
-        powerpoint: "powerpoint";
-        word: "word";
-    }>;
-    state: z.ZodEnum<{
-        not_registered: "not_registered";
-        registered: "registered";
-        stale: "stale";
-        unknown: "unknown";
-        unsupported: "unsupported";
-    }>;
-    last_seen_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    marketplace_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type DestinationReadiness = z.infer<typeof destinationReadinessSchema>;
-export declare const handoffReadinessResponseSchema: z.ZodObject<{
-    environment: z.ZodEnum<{
-        localhost: "localhost";
-        production: "production";
-        staging: "staging";
-    }>;
-    destinations: z.ZodArray<z.ZodObject<{
-        destination: z.ZodEnum<{
-            chrome: "chrome";
-            excel: "excel";
-            mobile: "mobile";
-            powerpoint: "powerpoint";
-            word: "word";
-        }>;
-        state: z.ZodEnum<{
-            not_registered: "not_registered";
-            registered: "registered";
-            stale: "stale";
-            unknown: "unknown";
-            unsupported: "unsupported";
-        }>;
-        last_seen_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        marketplace_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type HandoffReadinessResponse = z.infer<typeof handoffReadinessResponseSchema>;
-export declare const threadHandoffViewSchema: z.ZodObject<{
-    handoff_id: z.ZodString;
-    thread_id: z.ZodString;
-    session_asset_id: z.ZodNullable<z.ZodString>;
-    source: z.ZodString;
-    destination: z.ZodEnum<{
-        chrome: "chrome";
-        excel: "excel";
-        mobile: "mobile";
-        powerpoint: "powerpoint";
-        word: "word";
-    }>;
-    environment: z.ZodEnum<{
-        localhost: "localhost";
-        production: "production";
-        staging: "staging";
-    }>;
-    state: z.ZodEnum<{
-        acknowledged: "acknowledged";
-        claimed: "claimed";
-        failed: "failed";
-        issued: "issued";
-        launched: "launched";
-    }>;
-    issued_at: z.ZodString;
-    expires_at: z.ZodString;
-    claimed_at: z.ZodNullable<z.ZodString>;
-    acknowledged_at: z.ZodNullable<z.ZodString>;
-    failure_reason: z.ZodNullable<z.ZodString>;
-    push_delivered: z.ZodNullable<z.ZodBoolean>;
-}, z.core.$strip>;
-export type ThreadHandoffView = z.infer<typeof threadHandoffViewSchema>;
-export declare const mobileHandoffLaunchSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"mobile">;
-    push_attempted: z.ZodBoolean;
-    push_delivered: z.ZodBoolean;
-    device_count: z.ZodNumber;
-    link_url: z.ZodString;
-    scheme_url: z.ZodString;
-}, z.core.$strip>;
-export type MobileHandoffLaunch = z.infer<typeof mobileHandoffLaunchSchema>;
-export declare const officeHandoffLaunchSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"office">;
-    host: z.ZodEnum<{
-        excel: "excel";
-        powerpoint: "powerpoint";
-        word: "word";
-    }>;
-    desktop_url: z.ZodString;
-    template_url: z.ZodString;
-    web_url: z.ZodString;
-    marketplace_url: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-export type OfficeHandoffLaunch = z.infer<typeof officeHandoffLaunchSchema>;
-export declare const chromeHandoffLaunchSchema: z.ZodObject<{
-    kind: z.ZodLiteral<"chrome">;
-}, z.core.$strip>;
-export declare const handoffLaunchSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"mobile">;
-    push_attempted: z.ZodBoolean;
-    push_delivered: z.ZodBoolean;
-    device_count: z.ZodNumber;
-    link_url: z.ZodString;
-    scheme_url: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"office">;
-    host: z.ZodEnum<{
-        excel: "excel";
-        powerpoint: "powerpoint";
-        word: "word";
-    }>;
-    desktop_url: z.ZodString;
-    template_url: z.ZodString;
-    web_url: z.ZodString;
-    marketplace_url: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"chrome">;
-}, z.core.$strip>], "kind">;
-export type HandoffLaunch = z.infer<typeof handoffLaunchSchema>;
-export declare const createThreadHandoffResponseSchema: z.ZodObject<{
-    handoff: z.ZodObject<{
-        handoff_id: z.ZodString;
-        thread_id: z.ZodString;
-        session_asset_id: z.ZodNullable<z.ZodString>;
-        source: z.ZodString;
-        destination: z.ZodEnum<{
-            chrome: "chrome";
-            excel: "excel";
-            mobile: "mobile";
-            powerpoint: "powerpoint";
-            word: "word";
-        }>;
-        environment: z.ZodEnum<{
-            localhost: "localhost";
-            production: "production";
-            staging: "staging";
-        }>;
-        state: z.ZodEnum<{
-            acknowledged: "acknowledged";
-            claimed: "claimed";
-            failed: "failed";
-            issued: "issued";
-            launched: "launched";
-        }>;
-        issued_at: z.ZodString;
-        expires_at: z.ZodString;
-        claimed_at: z.ZodNullable<z.ZodString>;
-        acknowledged_at: z.ZodNullable<z.ZodString>;
-        failure_reason: z.ZodNullable<z.ZodString>;
-        push_delivered: z.ZodNullable<z.ZodBoolean>;
-    }, z.core.$strip>;
-    launch: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"mobile">;
-        push_attempted: z.ZodBoolean;
-        push_delivered: z.ZodBoolean;
-        device_count: z.ZodNumber;
-        link_url: z.ZodString;
-        scheme_url: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"office">;
-        host: z.ZodEnum<{
-            excel: "excel";
-            powerpoint: "powerpoint";
-            word: "word";
-        }>;
-        desktop_url: z.ZodString;
-        template_url: z.ZodString;
-        web_url: z.ZodString;
-        marketplace_url: z.ZodNullable<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"chrome">;
-    }, z.core.$strip>], "kind">;
-}, z.core.$strip>;
-export type CreateThreadHandoffResponse = z.infer<typeof createThreadHandoffResponseSchema>;
-export interface CreateThreadHandoffInput {
-    threadId: string;
-    destination: ServerHandoffDestination;
-    source: HandoffSource;
-}
-/**
- * Surface-specific HTTP adapter. Olympus binds it to `apiClient`; the
- * extension binds it to its authenticated fetch. Both must resolve (not
- * reject) with parsed responses so the flow can attribute failures.
- */
-export interface ThreadHandoffTransport {
-    getReadiness: (options: {
-        signal?: AbortSignal;
-    }) => Promise<HandoffReadinessResponse>;
-    createHandoff: (input: CreateThreadHandoffInput) => Promise<CreateThreadHandoffResponse>;
-    getHandoff: (options: {
-        handoffId: string;
-        signal?: AbortSignal;
-    }) => Promise<ThreadHandoffView>;
-}
-export declare const HANDOFF_DESTINATION_LABELS: Record<HandoffDestination, string>;
-export declare const isOfficeHandoffDestination: (destination: HandoffDestination) => destination is OfficeHandoffDestination;
-export declare const isServerHandoffDestination: (destination: HandoffDestination) => destination is ServerHandoffDestination;
-/** Index a readiness response by destination; missing rows read as `unknown`. */
-export declare const readinessByDestination: (response: HandoffReadinessResponse | null | undefined) => Record<HandoffDestination, DestinationReadiness>;
-/**
- * How a mobile handoff should be presented before the phone answers.
- *
- * - `app`: a fresh push token exists — the phone gets a notification and the
- *   QR is only offered as a secondary path.
- * - `qr`: no usable device is known — lead with the QR / link.
- */
-export type MobileLaunchMode = 'app' | 'qr';
-export declare const selectMobileLaunchMode: (readiness: DestinationReadiness | null | undefined) => MobileLaunchMode;
-/**
- * What a "Continue in…" row should say for a destination given its readiness.
- * Shared so Spaces and the extension render identical copy.
- */
-export interface HandoffDestinationPresentation {
-    destination: HandoffDestination;
-    label: string;
-    /** Secondary line under the label; `null` when the row needs no caveat. */
-    detail: string | null;
-    /**
-     * `install` rows do not create a handoff — they point at install help;
-     * `unavailable` rows are disabled.
-     */
-    action: 'handoff' | 'install' | 'unavailable';
-}
-export declare const presentHandoffDestination: ({ destination, readiness, }: {
-    destination: HandoffDestination;
-    readiness: DestinationReadiness | null | undefined;
-}) => HandoffDestinationPresentation;
-/**
- * QR symbol for a handoff link as a single SVG path in module units, so any
- * surface can render `<svg viewBox="0 0 {size} {size}"><path d={path} /></svg>`
- * without a canvas or an image request.
- */
-export declare const buildHandoffQrSvg: ({ text }: {
-    text: string;
-}) => {
-    size: number;
-    path: string;
-};
-export type HandoffOutcome = {
-    status: 'acknowledged';
-    handoff: ThreadHandoffView;
-} | {
-    status: 'failed';
-    handoff: ThreadHandoffView | null;
-    reason: string;
-} | {
-    status: 'timeout';
-    handoff: ThreadHandoffView | null;
-} | {
-    status: 'cancelled';
-    handoff: ThreadHandoffView | null;
-};
-export declare const isTerminalHandoffState: (state: HandoffState) => boolean;
-export interface WaitForHandoffOutcomeOptions {
-    transport: Pick<ThreadHandoffTransport, 'getHandoff'>;
-    handoffId: string;
-    /** Wall-clock budget; mobile pushes typically land in seconds, Office launches in tens of seconds. */
-    timeoutMs: number;
-    pollIntervalMs?: number;
-    signal?: AbortSignal;
-    onUpdate?: (handoff: ThreadHandoffView) => void;
-    /** Injected for tests. */
-    now?: () => number;
-    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
-}
-/**
- * Poll one handoff until the destination acknowledges, the server marks it
- * failed, the budget elapses, or the caller aborts. Each request is bound to
- * the remaining budget so a stalled response cannot outlive the deadline.
- * Retryable transport errors are retried within the budget; permanent ones
- * (auth, wrong deployment, malformed payload) fail immediately with their
- * actionable message. The last known view is reported.
- */
-export declare function waitForHandoffOutcome({ transport, handoffId, timeoutMs, pollIntervalMs, signal, onUpdate, now, sleep, }: WaitForHandoffOutcomeOptions): Promise<HandoffOutcome>;
-/** Error raised by a transport when the server no longer knows the handoff (404). */
-export declare class HandoffGoneError extends Error {
-    constructor(handoffId: string);
-}
-export declare const isHandoffGoneError: (error: unknown) => error is HandoffGoneError;
-/**
- * Transport failure that polling the same handoff can never recover from:
- * the session is signed out, the token belongs to another deployment, the
- * server rejected the request, or the payload did not match the schema.
- */
-export declare class HandoffPermanentError extends Error {
-    constructor(message: string, options?: {
-        cause?: unknown;
-    });
-}
-export declare const isHandoffPermanentError: (error: unknown) => error is HandoffPermanentError;
-export type HandoffTransportErrorKind = 'gone' | 'permanent' | 'retryable';
-/**
- * Shared classification for both transports: only network failures and
- * retryable server statuses keep the poll alive. Schema mismatches surface as
- * `ZodError` from either adapter and are permanent.
- */
-export declare const classifyHandoffTransportError: (error: unknown) => HandoffTransportErrorKind;
-/** 5xx, timeouts and rate limits may clear on the next poll; any other 4xx will not. */
-export declare const isRetryableHandoffHttpStatus: (status: number) => boolean;
-/**
- * Map a non-2xx status to the transport error the poll loop understands.
- * `detail` is the server's actionable message when it sent one.
- */
-export declare const handoffHttpError: ({ handoffId, status, detail, }: {
-    handoffId: string;
-    status: number;
-    detail: string | null;
-}) => Error;
-export declare const describeHandoffTransportError: (error: unknown) => string;
-/** `?handoff=<id>` — the query parameter mobile-web and QR links carry. */
-export declare const HANDOFF_URL_PARAM = "handoff";
-/**
- * Read a handoff id from a URL. Ids are server-issued, URL-safe tokens; anything
- * else is rejected so a tampered link never reaches the claim path.
- */
-export declare const parseHandoffIdParam: (value: string | null | undefined) => string | null;
-/** Athena Mobile's custom URL scheme (`mobile-app-react-native/app.json` → `scheme`). */
-export declare const MOBILE_APP_SCHEME = "athenavisionapplication";
-/**
- * Custom-scheme launch for a handoff — what a phone's browser opens when the
- * Universal/App Link landed on mobile web instead of in the app. Mirrors
- * agora's `_mobile_scheme_url`; carries only the opaque handoff id.
- */
-export declare const buildMobileHandoffSchemeUrl: ({ handoffId }: {
-    handoffId: string;
-}) => string;
+/** Backward-compatible entrypoint. Use the protocol entrypoint without QR rendering. */
+export { type CreateThreadHandoffInput, type CreateThreadHandoffResponse, type DestinationReadiness, HANDOFF_DESTINATIONS, HANDOFF_DESTINATION_LABELS, HANDOFF_URL_PARAM, type HandoffDestination, type HandoffDestinationPresentation, type HandoffEnvironment, HandoffGoneError, type HandoffLaunch, type HandoffOutcome, HandoffPermanentError, type HandoffReadinessResponse, type HandoffReadinessState, type HandoffSource, type HandoffState, type HandoffTransportErrorKind, MOBILE_APP_SCHEME, type MobileHandoffLaunch, type MobileLaunchMode, OFFICE_HANDOFF_DESTINATIONS, type OfficeHandoffDestination, type OfficeHandoffLaunch, type OfficeInvitationLaunch, type OfficeLaunchMode, SERVER_HANDOFF_DESTINATIONS, type ServerHandoffDestination, type ThreadHandoffTransport, type ThreadHandoffView, type WaitForHandoffOutcomeOptions, buildMobileHandoffSchemeUrl, chromeHandoffLaunchSchema, classifyHandoffTransportError, createThreadHandoffResponseSchema, describeHandoffTransportError, destinationReadinessSchema, handoffEnvironmentSchema, handoffHttpError, handoffLaunchSchema, handoffReadinessResponseSchema, handoffReadinessStateSchema, handoffStateSchema, isHandoffGoneError, isHandoffPermanentError, isOfficeHandoffDestination, isRetryableHandoffHttpStatus, isServerHandoffDestination, isTerminalHandoffState, mobileHandoffLaunchSchema, officeHandoffLaunchSchema, officeInvitationLaunchSchema, officeLaunchModeSchema, parseHandoffIdParam, presentHandoffDestination, readinessByDestination, resolveOfficeHandoffLaunchMode, selectMobileLaunchMode, supportsDesktopHandoffSource, threadHandoffCreateBody, threadHandoffViewSchema, waitForHandoffOutcome, type ClaimThreadHandoffResponse, claimThreadHandoffResponseSchema, clampHandoffDraft, handoffDraftToCarry, continuedFromLabel, pickUpFromLabel, pickUpOfferLabel, type DesktopThreadHandoffLaunch, desktopThreadHandoffLaunchSchema, driverSurfaceForChannel, drivingOnLabel, type HandoffLanding, handoffLandingFromView, isPickupSurface, MAX_HANDOFF_DRAFT_LENGTH, nextHandoffLaunchSchema, parseThreadHandoffCreateResponse, pendingThreadHandoffResponseSchema, pickedUpOnLabel, PICKUP_SURFACES, type PickupSurface, shouldOfferPendingHandoff, SPACES_HANDOFF_URL_PARAM, type SpacesHandoffLaunch, spacesHandoffLaunchSchema, SURFACE_HANDOFF_DESTINATIONS, type SurfaceHandoffDestination, supportsSurfaceHandoffDestinations, THREAD_HANDOFF_DESTINATION_LABELS, THREAD_HANDOFF_DESTINATIONS, threadHandoffClaimBody, threadHandoffCreateRequest, type ThreadHandoffDestination, type ThreadHandoffReceiverTransport, MAX_PENDING_EXCLUDE, pendingExcludeIds, pickupExcludeIds, pendingHandoffPath, type HandoffMode, handoffModeSchema, isVoiceHandoffDestination, livenessAgo, presentSurfaceLiveness, type SurfaceLiveness, type SurfaceLivenessBasis, surfaceLivenessBasisSchema, surfaceLivenessBySurface, type SurfaceLivenessPresentation, surfaceLivenessSchema, type SurfaceLivenessState, surfaceLivenessStateSchema, type SurfaceLivenessTone, supportsSurfaceLiveness, } from './thread-handoff-protocol';
+export { buildHandoffQrSvg } from './thread-handoff-qr';

package/dist/agent-runtime/src/thread-status.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const store = require("@assistant-ui/store");
-const react = require("react");
+const require$$0 = require("react");
 function useDeepAgentThreadStatus() {
   return store.useAuiState((s) => {
     var _a;
@@ -36,9 +36,9 @@ function readRunLive(thread, connection) {
   const status = (_a = thread.extras) == null ? void 0 : _a.status;
   return status === void 0 ? thread.isRunning : resolveRunLive({ status, connection });
 }
-const DeepAgentConnectionContext = react.createContext(null);
+const DeepAgentConnectionContext = require$$0.createContext(null);
 function useDeepAgentConnection() {
-  return react.useContext(DeepAgentConnectionContext);
+  return require$$0.useContext(DeepAgentConnectionContext);
 }
 exports.DeepAgentConnectionContext = DeepAgentConnectionContext;
 exports.readRunLive = readRunLive;

package/dist/agent-runtime/src/thread-status.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"thread-status.cjs","sources":["../../../../agent-runtime/src/thread-status.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { createContext, useContext } from 'react';\nimport type { DeepAgentConnectionState } from './types';\n\nexport type DeepAgentThreadStatus = StatewireThread.ThreadStatus;\n\n/**\n * Runtime-scoped thread status, as the library presents it: `\"loading\"` /\n * `\"ready\"` / the run's status replicated by the host, with a mid-run\n * connection loss presented as `\"evicted\"` (server-update pod drain) or\n * `\"disconnected\"` instead of `\"running\"`. Throws outside a statewire aui\n * provider, matching react-statewire 0.13's removed `useStatewireThreadStatus`.\n */\nexport function useDeepAgentThreadStatus(): DeepAgentThreadStatus {\n  return useAuiState((s) => {\n    const status = (s.thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n    if (status === undefined) {\n      throw new Error('useDeepAgentThreadStatus requires a statewire thread');\n    }\n    return status;\n  });\n}\n\n/** The two presented statuses that hide a live run behind a channel problem. */\nexport type DeepAgentStaleRunReason = Extract<DeepAgentThreadStatus, 'disconnected' | 'evicted'>;\n\n/** A first connection attempt can present an optimistic run without a stale warning. */\nexport function resolveStaleRunReason({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): DeepAgentStaleRunReason | null {\n  if (status === 'evicted') return 'evicted';\n  if (status !== 'disconnected') return null;\n  if (connection?.status === 'connecting') {\n    return null;\n  }\n  return 'disconnected';\n}\n\n/**\n * Whether the thread has a live run to present — the composer's Running bar\n * and its Stop/Queue slot.\n *\n * The library derives `thread.isRunning` from the PRESENTED status, so a run\n * that is live on the host but sits behind a channel that has not connected\n * yet reads as not running. Behind a first dial that is exactly the run the\n * client just seeded — switching back to a thread that was running when you\n * left, or a brand-new chat's optimistic first send — and nothing is stale:\n * the channel is still attaching. Hiding the run for that round-trip flashes\n * Ready and a Send button before Running comes back. A run behind a reconnect\n * or an eviction is presented by the stale treatment (`resolveStaleRunReason`),\n * never as live.\n */\nexport function resolveRunLive({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): boolean {\n  if (status === 'running') return true;\n  if (status !== 'disconnected') return false;\n  return resolveStaleRunReason({ status, connection }) === null;\n}\n\n/**\n * `thread.isRunning` for a `useAuiState` selector, folded through\n * `resolveRunLive` when the thread is a statewire thread. A thread without a\n * statewire status (another runtime, a test stub) keeps the library's answer.\n */\nexport function readRunLive(\n  thread: { isRunning: boolean; extras?: unknown },\n  connection: DeepAgentConnectionState | null,\n): boolean {\n  const status = (thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n  return status === undefined ? thread.isRunning : resolveRunLive({ status, connection });\n}\n\n/**\n * The active thread's channel, for `readRunLive`'s first-dial verdict. Each\n * host provides it from its own lifecycle state (`AthenaProvider`, the\n * Chrome extension's lifecycle provider); `null` means \"no channel known\",\n * which folds a `disconnected` status as stale.\n */\nexport const DeepAgentConnectionContext = createContext<DeepAgentConnectionState | null>(null);\n\nexport function useDeepAgentConnection(): DeepAgentConnectionState | null {\n  return useContext(DeepAgentConnectionContext);\n}\n"],"names":["useAuiState","createContext","useContext"],"mappings":";;;;AAcO,SAAS,2BAAkD;AAChE,SAAOA,MAAAA,YAAY,CAAC,MAAM;;AACxB,UAAM,UAAU,OAAE,OAAO,WAAT,mBAAiE;AACjF,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AACF,GAGmC;AACjC,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,OAAI,yCAAY,YAAW,cAAc;AACvC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,SAAO,sBAAsB,EAAE,QAAQ,WAAA,CAAY,MAAM;AAC3D;AAOO,SAAS,YACd,QACA,YACS;;AACT,QAAM,UAAU,YAAO,WAAP,mBAA+D;AAC/E,SAAO,WAAW,SAAY,OAAO,YAAY,eAAe,EAAE,QAAQ,YAAY;AACxF;AAQO,MAAM,6BAA6BC,MAAAA,cAA+C,IAAI;AAEtF,SAAS,yBAA0D;AACxE,SAAOC,MAAAA,WAAW,0BAA0B;AAC9C;;;;;;;"}
+{"version":3,"file":"thread-status.cjs","sources":["../../../../agent-runtime/src/thread-status.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { createContext, useContext } from 'react';\nimport type { DeepAgentConnectionState } from './types';\n\nexport type DeepAgentThreadStatus = StatewireThread.ThreadStatus;\n\n/**\n * Runtime-scoped thread status, as the library presents it: `\"loading\"` /\n * `\"ready\"` / the run's status replicated by the host, with a mid-run\n * connection loss presented as `\"evicted\"` (server-update pod drain) or\n * `\"disconnected\"` instead of `\"running\"`. Throws outside a statewire aui\n * provider, matching react-statewire 0.13's removed `useStatewireThreadStatus`.\n */\nexport function useDeepAgentThreadStatus(): DeepAgentThreadStatus {\n  return useAuiState((s) => {\n    const status = (s.thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n    if (status === undefined) {\n      throw new Error('useDeepAgentThreadStatus requires a statewire thread');\n    }\n    return status;\n  });\n}\n\n/** The two presented statuses that hide a live run behind a channel problem. */\nexport type DeepAgentStaleRunReason = Extract<DeepAgentThreadStatus, 'disconnected' | 'evicted'>;\n\n/** A first connection attempt can present an optimistic run without a stale warning. */\nexport function resolveStaleRunReason({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): DeepAgentStaleRunReason | null {\n  if (status === 'evicted') return 'evicted';\n  if (status !== 'disconnected') return null;\n  if (connection?.status === 'connecting') {\n    return null;\n  }\n  return 'disconnected';\n}\n\n/**\n * Whether the thread has a live run to present — the composer's Running bar\n * and its Stop/Queue slot.\n *\n * The library derives `thread.isRunning` from the PRESENTED status, so a run\n * that is live on the host but sits behind a channel that has not connected\n * yet reads as not running. Behind a first dial that is exactly the run the\n * client just seeded — switching back to a thread that was running when you\n * left, or a brand-new chat's optimistic first send — and nothing is stale:\n * the channel is still attaching. Hiding the run for that round-trip flashes\n * Ready and a Send button before Running comes back. A run behind a reconnect\n * or an eviction is presented by the stale treatment (`resolveStaleRunReason`),\n * never as live.\n */\nexport function resolveRunLive({\n  status,\n  connection,\n}: {\n  status: DeepAgentThreadStatus;\n  connection?: DeepAgentConnectionState | null;\n}): boolean {\n  if (status === 'running') return true;\n  if (status !== 'disconnected') return false;\n  return resolveStaleRunReason({ status, connection }) === null;\n}\n\n/**\n * `thread.isRunning` for a `useAuiState` selector, folded through\n * `resolveRunLive` when the thread is a statewire thread. A thread without a\n * statewire status (another runtime, a test stub) keeps the library's answer.\n */\nexport function readRunLive(\n  thread: { isRunning: boolean; extras?: unknown },\n  connection: DeepAgentConnectionState | null,\n): boolean {\n  const status = (thread.extras as Partial<StatewireThread.Extras> | undefined)?.status;\n  return status === undefined ? thread.isRunning : resolveRunLive({ status, connection });\n}\n\n/**\n * The active thread's channel, for `readRunLive`'s first-dial verdict. Each\n * host provides it from its own lifecycle state (`AthenaProvider`, the\n * Chrome extension's lifecycle provider); `null` means \"no channel known\",\n * which folds a `disconnected` status as stale.\n */\nexport const DeepAgentConnectionContext = createContext<DeepAgentConnectionState | null>(null);\n\nexport function useDeepAgentConnection(): DeepAgentConnectionState | null {\n  return useContext(DeepAgentConnectionContext);\n}\n"],"names":["useAuiState","createContext","useContext"],"mappings":";;;;AAcO,SAAS,2BAAkD;AAChE,SAAOA,MAAAA,YAAY,CAAC,MAAM;;AACxB,UAAM,UAAU,OAAE,OAAO,WAAT,mBAAiE;AACjF,QAAI,WAAW,QAAW;AACxB,YAAM,IAAI,MAAM,sDAAsD;AAAA,IACxE;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAMO,SAAS,sBAAsB;AAAA,EACpC;AAAA,EACA;AACF,GAGmC;AACjC,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,OAAI,yCAAY,YAAW,cAAc;AACvC,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAgBO,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGY;AACV,MAAI,WAAW,UAAW,QAAO;AACjC,MAAI,WAAW,eAAgB,QAAO;AACtC,SAAO,sBAAsB,EAAE,QAAQ,WAAA,CAAY,MAAM;AAC3D;AAOO,SAAS,YACd,QACA,YACS;;AACT,QAAM,UAAU,YAAO,WAAP,mBAA+D;AAC/E,SAAO,WAAW,SAAY,OAAO,YAAY,eAAe,EAAE,QAAQ,YAAY;AACxF;AAQO,MAAM,6BAA6BC,WAAAA,cAA+C,IAAI;AAEtF,SAAS,yBAA0D;AACxE,SAAOC,WAAAA,WAAW,0BAA0B;AAC9C;;;;;;;"}