@athenaintel/react 0.43.0 → 0.50.0

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

@@ -0,0 +1,49 @@
+import type { PickupSurface } from './thread-handoff-protocol';
+/**
+ * The app a person is driving a conversation from: the surface of their newest
+ * send, or the device holding the live call. The host projects it as
+ * `state.driver` (agora `client_surface.py`); every attached surface shows it
+ * ("Driving on your phone") so the person always knows where the conversation
+ * is moving. A display hint for the person's own devices, never a permission.
+ */
+export type ThreadDriverSurface = PickupSurface | 'office';
+export interface ThreadDriver {
+    surface: ThreadDriverSurface;
+    mode: 'text' | 'voice';
+    /** Epoch ms of the person's newest action there (server clock). */
+    since: number;
+}
+/** How long after the newest action the chip still says "Driving on …". */
+export declare const THREAD_DRIVER_FRESH_MS: number;
+/** The wire `driver` as a {@link ThreadDriver}; `null` for absent or malformed. */
+export declare const parseThreadDriver: (value: unknown) => ThreadDriver | null;
+export interface DrivingOn {
+    surface: ThreadDriverSurface;
+    /** "Driving on your phone". */
+    label: string;
+}
+/**
+ * What a surface shows about the driver: "Driving on your phone" while another
+ * surface is the driver and acted recently; `null` when this surface drives,
+ * the driver is stale or unknown, or the driver holds a live call (the call
+ * banner — "Live call on your phone · Move here" — already says where it is).
+ */
+export declare const drivingOnFromDriver: ({ driver, here, now, freshMs, }: {
+    driver: ThreadDriver | null;
+    here: ThreadDriverSurface;
+    now?: number;
+    freshMs?: number;
+}) => DrivingOn | null;
+/**
+ * The thread's driver as the host projects it; `null` until hydrated, when
+ * absent, and outside a statewire thread (a read-only transcript, a legacy
+ * thread), so a chip can mount anywhere.
+ */
+export declare const useThreadDriver: () => ThreadDriver | null;
+/**
+ * "Driving on …" for the surface `here`. It goes away by itself once the
+ * other surface has been quiet for {@link THREAD_DRIVER_FRESH_MS}: one timer
+ * set for that moment, and only while the chip shows, so nothing ticks during
+ * a call, on the driving surface, or on a backgrounded phone with no chip.
+ */
+export declare const useDrivingOn: (here: ThreadDriverSurface) => DrivingOn | null;

package/dist/agent-runtime/src/thread-driver.js

@@ -0,0 +1,67 @@
+import { useAuiState } from "@assistant-ui/store";
+import { useReducer, useEffect, useMemo } from "react";
+import { isDeepAgentStateHydrated } from "./statewire-state.js";
+import { hasStatewireThreadExtras } from "./thread-extras.js";
+const WIRE_SURFACES = {
+  web: "spaces",
+  mobile: "mobile",
+  chrome: "chrome",
+  desktop: "desktop",
+  office: "office"
+};
+const SURFACE_LABELS = {
+  spaces: "Spaces",
+  mobile: "your phone",
+  chrome: "Chrome",
+  desktop: "Athena Desktop",
+  office: "Office"
+};
+const THREAD_DRIVER_FRESH_MS = 15 * 6e4;
+const parseThreadDriver = (value) => {
+  if (value === null || typeof value !== "object") return null;
+  const record = value;
+  const surface = typeof record.surface === "string" ? WIRE_SURFACES[record.surface] : void 0;
+  const mode = record.mode === "voice" ? "voice" : record.mode === "text" ? "text" : null;
+  const since = typeof record.since === "number" && Number.isFinite(record.since) ? record.since : null;
+  if (!surface || !mode || since === null) return null;
+  return { surface, mode, since };
+};
+const drivingOnFromDriver = ({
+  driver,
+  here,
+  now = Date.now(),
+  freshMs = THREAD_DRIVER_FRESH_MS
+}) => {
+  if (!driver || driver.surface === here || driver.mode === "voice") return null;
+  if (now - driver.since > freshMs) return null;
+  return { surface: driver.surface, label: `Driving on ${SURFACE_LABELS[driver.surface]}` };
+};
+const useThreadDriver = () => {
+  const raw = useAuiState((s) => {
+    const extras = s.thread.extras;
+    if (!hasStatewireThreadExtras(extras)) return null;
+    const state = extras.state;
+    return isDeepAgentStateHydrated(state) ? state.driver ?? null : null;
+  });
+  return useMemo(() => parseThreadDriver(raw), [raw]);
+};
+const useDrivingOn = (here) => {
+  const driver = useThreadDriver();
+  const [, rerenderAtExpiry] = useReducer((renders) => renders + 1, 0);
+  const drivingOn = drivingOnFromDriver({ driver, here, now: Date.now() });
+  const expiresAt = drivingOn && driver ? driver.since + THREAD_DRIVER_FRESH_MS : null;
+  useEffect(() => {
+    if (expiresAt === null) return;
+    const timer = setTimeout(rerenderAtExpiry, Math.max(0, expiresAt - Date.now()) + 1);
+    return () => clearTimeout(timer);
+  }, [expiresAt]);
+  return drivingOn;
+};
+export {
+  THREAD_DRIVER_FRESH_MS,
+  drivingOnFromDriver,
+  parseThreadDriver,
+  useDrivingOn,
+  useThreadDriver
+};
+//# sourceMappingURL=thread-driver.js.map

package/dist/agent-runtime/src/thread-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-driver.js","sources":["../../../../agent-runtime/src/thread-driver.ts"],"sourcesContent":["import { useAuiState } from '@assistant-ui/store';\nimport { useEffect, useMemo, useReducer } from 'react';\nimport { isDeepAgentStateHydrated } from './statewire-state';\nimport { hasStatewireThreadExtras } from './thread-extras';\nimport type { PickupSurface } from './thread-handoff-protocol';\n\n/**\n * The app a person is driving a conversation from: the surface of their newest\n * send, or the device holding the live call. The host projects it as\n * `state.driver` (agora `client_surface.py`); every attached surface shows it\n * (\"Driving on your phone\") so the person always knows where the conversation\n * is moving. A display hint for the person's own devices, never a permission.\n */\nexport type ThreadDriverSurface = PickupSurface | 'office';\n\nexport interface ThreadDriver {\n  surface: ThreadDriverSurface;\n  mode: 'text' | 'voice';\n  /** Epoch ms of the person's newest action there (server clock). */\n  since: number;\n}\n\n// The host names Spaces `web`; every other surface by its own name.\nconst WIRE_SURFACES: Record<string, ThreadDriverSurface> = {\n  web: 'spaces',\n  mobile: 'mobile',\n  chrome: 'chrome',\n  desktop: 'desktop',\n  office: 'office',\n};\n\nconst SURFACE_LABELS: Record<ThreadDriverSurface, string> = {\n  spaces: 'Spaces',\n  mobile: 'your phone',\n  chrome: 'Chrome',\n  desktop: 'Athena Desktop',\n  office: 'Office',\n};\n\n/** How long after the newest action the chip still says \"Driving on …\". */\nexport const THREAD_DRIVER_FRESH_MS = 15 * 60_000;\n\n/** The wire `driver` as a {@link ThreadDriver}; `null` for absent or malformed. */\nexport const parseThreadDriver = (value: unknown): ThreadDriver | null => {\n  if (value === null || typeof value !== 'object') return null;\n  const record = value as Record<string, unknown>;\n  const surface = typeof record.surface === 'string' ? WIRE_SURFACES[record.surface] : undefined;\n  const mode = record.mode === 'voice' ? 'voice' : record.mode === 'text' ? 'text' : null;\n  const since = typeof record.since === 'number' && Number.isFinite(record.since) ? record.since : null;\n  if (!surface || !mode || since === null) return null;\n  return { surface, mode, since };\n};\n\nexport interface DrivingOn {\n  surface: ThreadDriverSurface;\n  /** \"Driving on your phone\". */\n  label: string;\n}\n\n/**\n * What a surface shows about the driver: \"Driving on your phone\" while another\n * surface is the driver and acted recently; `null` when this surface drives,\n * the driver is stale or unknown, or the driver holds a live call (the call\n * banner — \"Live call on your phone · Move here\" — already says where it is).\n */\nexport const drivingOnFromDriver = ({\n  driver,\n  here,\n  now = Date.now(),\n  freshMs = THREAD_DRIVER_FRESH_MS,\n}: {\n  driver: ThreadDriver | null;\n  here: ThreadDriverSurface;\n  now?: number;\n  freshMs?: number;\n}): DrivingOn | null => {\n  if (!driver || driver.surface === here || driver.mode === 'voice') return null;\n  if (now - driver.since > freshMs) return null;\n  return { surface: driver.surface, label: `Driving on ${SURFACE_LABELS[driver.surface]}` };\n};\n\n/**\n * The thread's driver as the host projects it; `null` until hydrated, when\n * absent, and outside a statewire thread (a read-only transcript, a legacy\n * thread), so a chip can mount anywhere.\n */\nexport const useThreadDriver = (): ThreadDriver | null => {\n  // The raw wire object is referentially stable between updates of that key.\n  const raw = useAuiState((s) => {\n    const extras = s.thread.extras;\n    if (!hasStatewireThreadExtras(extras)) return null;\n    const state = (extras as { state?: unknown }).state;\n    return isDeepAgentStateHydrated(state)\n      ? ((state as Record<string, unknown>).driver ?? null)\n      : null;\n  });\n  return useMemo(() => parseThreadDriver(raw), [raw]);\n};\n\n/**\n * \"Driving on …\" for the surface `here`. It goes away by itself once the\n * other surface has been quiet for {@link THREAD_DRIVER_FRESH_MS}: one timer\n * set for that moment, and only while the chip shows, so nothing ticks during\n * a call, on the driving surface, or on a backgrounded phone with no chip.\n */\nexport const useDrivingOn = (here: ThreadDriverSurface): DrivingOn | null => {\n  const driver = useThreadDriver();\n  const [, rerenderAtExpiry] = useReducer((renders: number) => renders + 1, 0);\n  const drivingOn = drivingOnFromDriver({ driver, here, now: Date.now() });\n  const expiresAt = drivingOn && driver ? driver.since + THREAD_DRIVER_FRESH_MS : null;\n  useEffect(() => {\n    if (expiresAt === null) return;\n    const timer = setTimeout(rerenderAtExpiry, Math.max(0, expiresAt - Date.now()) + 1);\n    return () => clearTimeout(timer);\n  }, [expiresAt]);\n  return drivingOn;\n};\n"],"names":[],"mappings":";;;;AAuBA,MAAM,gBAAqD;AAAA,EACzD,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AACV;AAEA,MAAM,iBAAsD;AAAA,EAC1D,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,QAAQ;AACV;AAGO,MAAM,yBAAyB,KAAK;AAGpC,MAAM,oBAAoB,CAAC,UAAwC;AACxE,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU,QAAO;AACxD,QAAM,SAAS;AACf,QAAM,UAAU,OAAO,OAAO,YAAY,WAAW,cAAc,OAAO,OAAO,IAAI;AACrF,QAAM,OAAO,OAAO,SAAS,UAAU,UAAU,OAAO,SAAS,SAAS,SAAS;AACnF,QAAM,QAAQ,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,OAAO,KAAK,IAAI,OAAO,QAAQ;AACjG,MAAI,CAAC,WAAW,CAAC,QAAQ,UAAU,KAAM,QAAO;AAChD,SAAO,EAAE,SAAS,MAAM,MAAA;AAC1B;AAcO,MAAM,sBAAsB,CAAC;AAAA,EAClC;AAAA,EACA;AAAA,EACA,MAAM,KAAK,IAAA;AAAA,EACX,UAAU;AACZ,MAKwB;AACtB,MAAI,CAAC,UAAU,OAAO,YAAY,QAAQ,OAAO,SAAS,QAAS,QAAO;AAC1E,MAAI,MAAM,OAAO,QAAQ,QAAS,QAAO;AACzC,SAAO,EAAE,SAAS,OAAO,SAAS,OAAO,cAAc,eAAe,OAAO,OAAO,CAAC,GAAA;AACvF;AAOO,MAAM,kBAAkB,MAA2B;AAExD,QAAM,MAAM,YAAY,CAAC,MAAM;AAC7B,UAAM,SAAS,EAAE,OAAO;AACxB,QAAI,CAAC,yBAAyB,MAAM,EAAG,QAAO;AAC9C,UAAM,QAAS,OAA+B;AAC9C,WAAO,yBAAyB,KAAK,IAC/B,MAAkC,UAAU,OAC9C;AAAA,EACN,CAAC;AACD,SAAO,QAAQ,MAAM,kBAAkB,GAAG,GAAG,CAAC,GAAG,CAAC;AACpD;AAQO,MAAM,eAAe,CAAC,SAAgD;AAC3E,QAAM,SAAS,gBAAA;AACf,QAAM,CAAA,EAAG,gBAAgB,IAAI,WAAW,CAAC,YAAoB,UAAU,GAAG,CAAC;AAC3E,QAAM,YAAY,oBAAoB,EAAE,QAAQ,MAAM,KAAK,KAAK,IAAA,GAAO;AACvE,QAAM,YAAY,aAAa,SAAS,OAAO,QAAQ,yBAAyB;AAChF,YAAU,MAAM;AACd,QAAI,cAAc,KAAM;AACxB,UAAM,QAAQ,WAAW,kBAAkB,KAAK,IAAI,GAAG,YAAY,KAAK,IAAA,CAAK,IAAI,CAAC;AAClF,WAAO,MAAM,aAAa,KAAK;AAAA,EACjC,GAAG,CAAC,SAAS,CAAC;AACd,SAAO;AACT;"}

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

@@ -0,0 +1,172 @@
+import type { CreateThreadHandoffResponse, HandoffOutcome, ThreadHandoffDestination, ThreadHandoffView } from './thread-handoff-protocol';
+type SettledOutcome = Exclude<HandoffOutcome, {
+    status: 'cancelled';
+}>;
+export interface ThreadHandoffRun {
+    id: number;
+    threadId: string;
+    destination: ThreadHandoffDestination;
+    create: (signal: AbortSignal) => Promise<CreateThreadHandoffResponse>;
+    wait: (options: {
+        created: CreateThreadHandoffResponse;
+        signal: AbortSignal;
+        onUpdate: (view: ThreadHandoffView) => void;
+    }) => Promise<HandoffOutcome>;
+    complete: () => void;
+    settle: (outcome: SettledOutcome) => void;
+}
+interface HandoffContext {
+    run: ThreadHandoffRun | null;
+    created: CreateThreadHandoffResponse | null;
+    view: ThreadHandoffView | null;
+    startedAt: number;
+    outcome: SettledOutcome | null;
+    reason: string;
+}
+export declare const threadHandoffFlowMachine: import("xstate").StateMachine<HandoffContext, {
+    type: 'START';
+    run: ThreadHandoffRun;
+} | {
+    type: 'POLL';
+    runId: number;
+    view: ThreadHandoffView;
+} | {
+    type: 'CANCEL';
+} | {
+    type: 'RESET';
+}, {
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<{
+        handoff: {
+            handoff_id: string;
+            thread_id: string;
+            session_asset_id: string | null;
+            source: string;
+            destination: "chrome" | "desktop" | "excel" | "mobile" | "next" | "powerpoint" | "spaces" | "word";
+            office_launch_mode?: "invitation" | "new_document" | null | undefined;
+            environment: "localhost" | "production" | "staging";
+            state: "acknowledged" | "claimed" | "failed" | "issued" | "launched";
+            issued_at: string;
+            expires_at: string;
+            claimed_at: string | null;
+            acknowledged_at: string | null;
+            failure_reason: string | null;
+            push_delivered: boolean | null;
+            claimed_surface?: "chrome" | "desktop" | "mobile" | "spaces" | null | undefined;
+            mode?: "text" | "voice" | undefined;
+            draft?: string | null | undefined;
+        };
+        launch: {
+            kind: "mobile";
+            push_attempted: boolean;
+            push_delivered: boolean;
+            device_count: number;
+            link_url: string;
+            scheme_url: string;
+        } | {
+            kind: "office";
+            host: "excel" | "powerpoint" | "word";
+            desktop_url: string;
+            template_url: string;
+            web_url: string;
+            marketplace_url: string | null;
+        } | {
+            kind: "office_invitation";
+            host: "excel" | "powerpoint" | "word";
+        } | {
+            kind: "chrome";
+        } | {
+            kind: "spaces";
+            url: string;
+        } | {
+            kind: "next";
+        } | {
+            kind: "desktop";
+            scheme_url: string;
+            download_url: string;
+            deployment_url: string;
+            protocol_version: 1;
+        };
+    }, {
+        run: ThreadHandoffRun;
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<HandoffOutcome, {
+        run: ThreadHandoffRun;
+        created: CreateThreadHandoffResponse;
+        onUpdate: (view: ThreadHandoffView) => void;
+    }, import("xstate").EventObject>> | undefined;
+}, {
+    src: "create";
+    logic: import("xstate").PromiseActorLogic<{
+        handoff: {
+            handoff_id: string;
+            thread_id: string;
+            session_asset_id: string | null;
+            source: string;
+            destination: "chrome" | "desktop" | "excel" | "mobile" | "next" | "powerpoint" | "spaces" | "word";
+            office_launch_mode?: "invitation" | "new_document" | null | undefined;
+            environment: "localhost" | "production" | "staging";
+            state: "acknowledged" | "claimed" | "failed" | "issued" | "launched";
+            issued_at: string;
+            expires_at: string;
+            claimed_at: string | null;
+            acknowledged_at: string | null;
+            failure_reason: string | null;
+            push_delivered: boolean | null;
+            claimed_surface?: "chrome" | "desktop" | "mobile" | "spaces" | null | undefined;
+            mode?: "text" | "voice" | undefined;
+            draft?: string | null | undefined;
+        };
+        launch: {
+            kind: "mobile";
+            push_attempted: boolean;
+            push_delivered: boolean;
+            device_count: number;
+            link_url: string;
+            scheme_url: string;
+        } | {
+            kind: "office";
+            host: "excel" | "powerpoint" | "word";
+            desktop_url: string;
+            template_url: string;
+            web_url: string;
+            marketplace_url: string | null;
+        } | {
+            kind: "office_invitation";
+            host: "excel" | "powerpoint" | "word";
+        } | {
+            kind: "chrome";
+        } | {
+            kind: "spaces";
+            url: string;
+        } | {
+            kind: "next";
+        } | {
+            kind: "desktop";
+            scheme_url: string;
+            download_url: string;
+            deployment_url: string;
+            protocol_version: 1;
+        };
+    }, {
+        run: ThreadHandoffRun;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+} | {
+    src: "wait";
+    logic: import("xstate").PromiseActorLogic<HandoffOutcome, {
+        run: ThreadHandoffRun;
+        created: CreateThreadHandoffResponse;
+        onUpdate: (view: ThreadHandoffView) => void;
+    }, import("xstate").EventObject>;
+    id: string | undefined;
+}, never, never, never, "acknowledged" | "creating" | "failed" | "idle" | "timeout" | "waiting", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+    id: "thread-handoff";
+    states: {
+        readonly idle: {};
+        readonly creating: {};
+        readonly waiting: {};
+        readonly acknowledged: {};
+        readonly failed: {};
+        readonly timeout: {};
+    };
+}>;
+export {};