@opengeni/react 1.0.1 → 1.0.2-canary.37202341988001

package/dist/diffs.js

@@ -0,0 +1,14 @@
+import {
+  registerPierreDiffs
+} from "./chunk-A2PI6UMY.js";
+
+// src/diffs.ts
+function enablePierreDiffs() {
+  registerPierreDiffs(loadPierreDiffsModule);
+}
+var loadPierreDiffsModule = () => import("@pierre/diffs/react");
+export {
+  enablePierreDiffs,
+  registerPierreDiffs
+};
+//# sourceMappingURL=diffs.js.map

package/dist/diffs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/diffs.ts"],"sourcesContent":["import { registerPierreDiffs } from \"./lib/pierre-diffs-loader\";\n\nexport { registerPierreDiffs, type PierreDiffsLoader } from \"./lib/pierre-diffs-loader\";\n\n/**\n * Enable Shiki-highlighted diffs and file views from the optional\n * `@pierre/diffs` peer. Call once at startup, only when the host installs it.\n * This is the only module in the package that names the peer, so hosts that\n * skip it build without `@pierre/diffs` and render plain-text diffs.\n */\nexport function enablePierreDiffs(): void {\n  registerPierreDiffs(loadPierreDiffsModule);\n}\n\n// One stable loader identity, so repeated enable calls are no-ops.\nconst loadPierreDiffsModule = () => import(\"@pierre/diffs/react\");\n"],"mappings":";;;;;AAUO,SAAS,oBAA0B;AACxC,sBAAoB,qBAAqB;AAC3C;AAGA,IAAM,wBAAwB,MAAM,OAAO,qBAAqB;","names":[]}

package/dist/discovery-cache.d.ts

@@ -0,0 +1,5 @@
+/** Short-lived presentation data only. Never cache installation or authorization state. */
+export declare function createDiscoveryCache<T>(ttlMs?: number, capacity?: number): {
+    peek(client: object, key: string): T | undefined;
+    read(client: object, key: string, fetch: () => Promise<T>): Promise<T>;
+};

package/dist/editor.d.ts

@@ -0,0 +1,7 @@
+import { type CodeEditorLanguages } from "./lib/workbench-peers.js";
+export { CodeEditor, languageForPath } from "./components/code-editor.js";
+export type { CodeEditorProps } from "./components/code-editor.js";
+export { registerCodeEditor } from "./lib/workbench-peers.js";
+export type { CodeEditorLanguage, CodeEditorLanguages } from "./lib/workbench-peers.js";
+/** Only name installed grammar peers in host-supplied language loaders. */
+export declare function enableCodeEditor(languages?: CodeEditorLanguages): void;

package/dist/editor.js

@@ -0,0 +1,21 @@
+import {
+  CodeEditor,
+  languageForPath
+} from "./chunk-4RVYOY4O.js";
+import {
+  registerCodeEditor
+} from "./chunk-JT4JW7BC.js";
+import "./chunk-22KP6LR5.js";
+
+// src/editor.ts
+var loadEditor = async () => ({ module: await import("@uiw/react-codemirror") });
+function enableCodeEditor(languages) {
+  registerCodeEditor(languages ? async () => ({ ...await loadEditor(), languages }) : loadEditor);
+}
+export {
+  CodeEditor,
+  enableCodeEditor,
+  languageForPath,
+  registerCodeEditor
+};
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/editor.ts"],"sourcesContent":["import { registerCodeEditor, type CodeEditorLanguages } from \"./lib/workbench-peers\";\n\nexport { CodeEditor, languageForPath } from \"./components/code-editor\";\nexport type { CodeEditorProps } from \"./components/code-editor\";\nexport { registerCodeEditor } from \"./lib/workbench-peers\";\nexport type { CodeEditorLanguage, CodeEditorLanguages } from \"./lib/workbench-peers\";\n\nconst loadEditor = async () => ({ module: await import(\"@uiw/react-codemirror\") });\n\n/** Only name installed grammar peers in host-supplied language loaders. */\nexport function enableCodeEditor(languages?: CodeEditorLanguages): void {\n  registerCodeEditor(languages ? async () => ({ ...(await loadEditor()), languages }) : loadEditor);\n}\n"],"mappings":";;;;;;;;;;AAOA,IAAM,aAAa,aAAa,EAAE,QAAQ,MAAM,OAAO,uBAAuB,EAAE;AAGzE,SAAS,iBAAiB,WAAuC;AACtE,qBAAmB,YAAY,aAAa,EAAE,GAAI,MAAM,WAAW,GAAI,UAAU,KAAK,UAAU;AAClG;","names":[]}

package/dist/embedded-session-client.d.ts

@@ -0,0 +1,23 @@
+import type { ComposerDraft } from "@opengeni/sdk";
+import type { EmbeddedSessionClientLike } from "./client.js";
+export type ComposerDraftMapContext = {
+    operation: "read" | "save" | "submit";
+    workspaceId: string;
+    sessionId: string;
+};
+export type CreateEmbeddedSessionClientOptions = {
+    /**
+     * Explicit host-owned method replacements. Methods inherited from `base`
+     * retain `base` as their receiver; overrides retain this object as theirs.
+     */
+    overrides?: Partial<EmbeddedSessionClientLike> | undefined;
+    /** Presentation/policy projection for every draft entering the React layer. */
+    mapComposerDraft?: ((draft: ComposerDraft, context: ComposerDraftMapContext) => ComposerDraft) | undefined;
+};
+/**
+ * Build the exact client required by `@opengeni/react/session` from a full SDK
+ * client or host proxy. The constructor binds every delegated method once,
+ * supports a host-owned atomic composer-submit override, and fails at creation
+ * time instead of waiting for a missing method to be exercised by a hook.
+ */
+export declare function createEmbeddedSessionClient(base: EmbeddedSessionClientLike, options?: CreateEmbeddedSessionClientOptions): EmbeddedSessionClientLike;

package/dist/file-node-visibility.d.ts

@@ -0,0 +1,15 @@
+import type { FileTreeNode } from "./hooks/use-sandbox-files.js";
+export type FileNodeVisibilityContext = {
+    depth: number;
+    parent: FileTreeNode | null;
+};
+/** Presentation-only predicate. It never changes filesystem authorization. */
+export type FileNodeVisibilityPredicate = (node: FileTreeNode, context: FileNodeVisibilityContext) => boolean;
+export type FilePathVisibility = "visible" | "hidden" | "unknown";
+/**
+ * Filter an authoritative tree without promoting children of a hidden parent.
+ * Undefined children stay undefined so lazy-loading semantics are preserved.
+ */
+export declare function visibleFileTree(nodes: FileTreeNode[], predicate?: FileNodeVisibilityPredicate, parent?: FileTreeNode | null, depth?: number): FileTreeNode[];
+/** Resolve only what the currently loaded tree can prove. */
+export declare function filePathVisibility(nodes: FileTreeNode[], path: string, predicate?: FileNodeVisibilityPredicate, parent?: FileTreeNode | null, depth?: number): FilePathVisibility;

package/dist/{fleet-decision-row-GGCAT4E4.js → fleet-decision-row-YZ3ZKWMM.js}

@@ -23,6 +23,7 @@ var FLEET_ACTUAL_REASON_LABEL = {
   rotation: "Rotated for capacity",
   active: "Used the active subscription",
   all_capped: "All observed subscriptions were capped",
+  allocator_disabled: "The policy-selected subscription was disabled for new allocations",
   none: "No production candidate was selected"
 };
 var FLEET_SHADOW_REASON_LABEL = {
@@ -348,4 +349,4 @@ function formatFleetScore(value) {
 export {
   FleetDecisionRow as default
 };
-//# sourceMappingURL=fleet-decision-row-GGCAT4E4.js.map
+//# sourceMappingURL=fleet-decision-row-YZ3ZKWMM.js.map

package/dist/fleet-decision-row-YZ3ZKWMM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timeline/fleet-decision-row.tsx"],"sourcesContent":["import type { FleetDecisionItem } from \"./types\";\n\ntype RowJsx = typeof import(\"react/jsx-runtime\").jsx;\ntype RowJsxs = typeof import(\"react/jsx-runtime\").jsxs;\n\nfunction GaugeMark({ className, j, s }: { className: string; j: RowJsx; s: RowJsxs }) {\n  return s(\"svg\", {\n    \"aria-hidden\": \"true\",\n    className,\n    fill: \"none\",\n    height: \"24\",\n    stroke: \"currentColor\",\n    strokeLinecap: \"round\",\n    strokeLinejoin: \"round\",\n    strokeWidth: \"2\",\n    viewBox: \"0 0 24 24\",\n    width: \"24\",\n    children: [\n      j(\"path\", { d: \"m 12 14 4-4\" }, \"needle\"),\n      j(\"path\", { d: \"M3.34 19a10 10 0 1 1 17.32 0\" }, \"arc\"),\n    ],\n  });\n}\n\nconst FLEET_ACTUAL_REASON_LABEL: Record<FleetDecisionItem[\"actualReason\"], string> = {\n  lease_reused: \"Reused the fenced lease\",\n  pin: \"Kept the session pin\",\n  rotation: \"Rotated for capacity\",\n  active: \"Used the active subscription\",\n  all_capped: \"All observed subscriptions were capped\",\n  allocator_disabled: \"The policy-selected subscription was disabled for new allocations\",\n  none: \"No production candidate was selected\",\n};\n\nconst FLEET_SHADOW_REASON_LABEL: Record<FleetDecisionItem[\"shadowReason\"], string> = {\n  fenced_in_flight: \"Kept the fenced in-flight assignment\",\n  fenced_candidate_missing: \"The fenced assignment was missing from the snapshot\",\n  admission_paced: \"Admission would have been paced\",\n  no_eligible_candidate: \"No candidate passed the policy checks\",\n  overlay_isolated_empty: \"Explicit isolation left no eligible candidate\",\n  best_score: \"Selected the lowest-pressure candidate\",\n  affinity_best: \"Session affinity was already best\",\n  hysteresis_hold: \"Hysteresis avoided a low-value switch\",\n};\n\nconst FLEET_COMPARISON_LABEL: Record<FleetDecisionItem[\"comparison\"], string> = {\n  match: \"Production and shadow matched\",\n  different_candidate: \"Shadow preferred another candidate\",\n  different_outcome: \"Production and shadow outcomes differed\",\n  not_comparable_truncated: \"Comparison limited by bounded candidate data\",\n};\n\nconst FLEET_ADMISSION_REASON_LABEL: Record<FleetDecisionItem[\"admissionReason\"], string> = {\n  fenced_in_flight: \"In-flight assignment was fenced\",\n  pacing_disabled: \"Admission pacing was disabled\",\n  capacity_unknown: \"Capacity was unknown, so work remained admissible\",\n  capacity_available: \"Observed capacity was available\",\n  work_conserving_borrow: \"Idle capacity was borrowed for standard work\",\n  manager_priority: \"Standard work was paced for queued manager demand\",\n  standard_starvation_bound: \"The standard-work starvation bound was reached\",\n  capacity_saturated: \"Observed dynamic capacity was saturated\",\n  emergency_fuse: \"The emergency fuse blocked new work\",\n};\n\nconst FLEET_REJECTION_LABEL: Record<\n  Exclude<FleetDecisionItem[\"scores\"][number][\"rejectionReason\"], null>,\n  string\n> = {\n  allocator_disabled: \"Allocator disabled\",\n  unavailable: \"Unavailable\",\n  cooling: \"Cooling down\",\n  quota_ceiling: \"Quota ceiling reached\",\n  overlay_isolation: \"Outside explicit isolation\",\n};\n\nconst FLEET_CONFIDENCE_LABEL: Record<FleetDecisionItem[\"confidence\"], string> = {\n  unknown: \"Unknown confidence\",\n  low: \"Low confidence\",\n  medium: \"Medium confidence\",\n  high: \"High confidence\",\n};\n\nexport default function FleetDecisionRow({\n  item,\n  d: ActivityDisclosure,\n  b: BodyNote,\n  j,\n  s,\n}: {\n  item: FleetDecisionItem;\n  d: typeof import(\"./shared\").ActivityDisclosure;\n  b: typeof import(\"./shared\").BodyNote;\n  j: RowJsx;\n  s: RowJsxs;\n}) {\n  const scoreRowsHidden = item.scoreRowsTruncatedCount > 0;\n  const scores =\n    item.scores.length > 0\n      ? j(\n          \"div\",\n          {\n            className: \"min-w-0\",\n            children: [\n              j(\n                \"h4\",\n                {\n                  className: \"text-og-sm font-medium text-og-fg\",\n                  children: \"Bounded candidate scores\",\n                },\n                \"heading\",\n              ),\n              j(\n                \"p\",\n                {\n                  className: \"mt-0.5 text-og-xs leading-5 text-og-fg-subtle\",\n                  children:\n                    \"Lower scores rank first. Candidate aliases are temporary and local to this event.\",\n                },\n                \"description\",\n              ),\n              j(\n                \"ul\",\n                {\n                  className: \"mt-2 flex min-w-0 flex-col gap-1.5\",\n                  \"aria-label\": \"Candidate scores\",\n                  children: item.scores.map((score) =>\n                    s(\n                      \"li\",\n                      {\n                        className:\n                          \"flex min-w-0 flex-col gap-1 rounded-og-sm bg-og-surface-1 px-2.5 py-2 text-og-sm sm:flex-row sm:items-center sm:gap-3\",\n                        children: [\n                          j(\n                            \"span\",\n                            {\n                              className: \"font-og-mono text-og-fg\",\n                              children: score.candidateKey,\n                            },\n                            \"candidate\",\n                          ),\n                          j(\n                            \"span\",\n                            {\n                              className: \"min-w-0 text-og-fg-muted sm:flex-1\",\n                              children: score.eligible\n                                ? \"Eligible\"\n                                : score.rejectionReason\n                                  ? FLEET_REJECTION_LABEL[score.rejectionReason]\n                                  : \"Unavailable\",\n                            },\n                            \"eligibility\",\n                          ),\n                          s(\n                            \"span\",\n                            {\n                              className: \"font-og-mono text-og-fg-subtle\",\n                              children: [\n                                \"score \",\n                                formatFleetScore(score.total),\n                                \" ·\",\n                                \" \",\n                                FLEET_CONFIDENCE_LABEL[score.confidence],\n                              ],\n                            },\n                            \"score\",\n                          ),\n                        ],\n                      },\n                      score.candidateKey,\n                    ),\n                  ),\n                },\n                \"rows\",\n              ),\n            ],\n          },\n          \"score-list\",\n        )\n      : null;\n  const truncated =\n    item.truncatedCandidateCount > 0\n      ? j(\n          BodyNote,\n          {\n            tone: \"muted\",\n            children: [\n              item.truncatedCandidateCount,\n              \" additional \",\n              item.truncatedCandidateCount === 1 ? \"candidate was\" : \"candidates were\",\n              \" excluded from this bounded replay record.\",\n            ],\n          },\n          \"truncated\",\n        )\n      : null;\n  const hidden = scoreRowsHidden\n    ? j(\n        BodyNote,\n        {\n          tone: \"muted\",\n          children: [\n            item.scoreRowsTruncatedCount,\n            \" additional \",\n            item.scoreRowsTruncatedCount === 1 ? \"score row was\" : \"score rows were\",\n            \" hidden by this view’s safety limit.\",\n          ],\n        },\n        \"hidden\",\n      )\n    : null;\n  return j(ActivityDisclosure, {\n    icon: j(GaugeMark, { className: \"size-3.5\", j, s }),\n    iconTone: \"muted\",\n    title: \"Fleet policy shadow\",\n    preview: FLEET_COMPARISON_LABEL[item.comparison],\n    chip: {\n      tone: \"muted\",\n      text:\n        item.comparison === \"match\"\n          ? \"matched\"\n          : item.comparison === \"not_comparable_truncated\"\n            ? \"limited\"\n            : \"different\",\n    },\n    children: s(\"section\", {\n      \"aria-label\": \"Fleet policy shadow details\",\n      className: \"flex min-w-0 flex-col gap-3\",\n      children: [\n        j(\n          BodyNote,\n          {\n            tone: \"muted\",\n            children:\n              \"Shadow observation only — it did not change the subscription serving this turn.\",\n          },\n          \"observation\",\n        ),\n        j(\n          \"dl\",\n          {\n            className: \"grid min-w-0 grid-cols-1 gap-x-5 gap-y-3 sm:grid-cols-2\",\n            children: [\n              j(\n                FleetDetail,\n                {\n                  term: \"Production\",\n                  value: fleetOutcomeLabel(item.actualOutcome, item.actualCandidateKey),\n                  note: FLEET_ACTUAL_REASON_LABEL[item.actualReason],\n                  j,\n                  s,\n                },\n                \"production\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Shadow policy\",\n                  value: fleetOutcomeLabel(item.shadowOutcome, item.shadowCandidateKey),\n                  note: FLEET_SHADOW_REASON_LABEL[item.shadowReason],\n                  j,\n                  s,\n                },\n                \"shadow\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Comparison\",\n                  value: FLEET_COMPARISON_LABEL[item.comparison],\n                  j,\n                  s,\n                },\n                \"comparison\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Decision confidence\",\n                  value: FLEET_CONFIDENCE_LABEL[item.confidence],\n                  j,\n                  s,\n                },\n                \"confidence\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Admission\",\n                  value:\n                    item.admissionOutcome === \"admit\"\n                      ? \"Would admit new work\"\n                      : \"Would pace new work\",\n                  note: FLEET_ADMISSION_REASON_LABEL[item.admissionReason],\n                  j,\n                  s,\n                },\n                \"admission\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Observed candidates\",\n                  value: `${item.candidateCount} in the bounded replay`,\n                  j,\n                  s,\n                },\n                \"candidate-count\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Idle-capacity borrowing\",\n                  value: item.borrowedIdleCapacity ? \"Borrowed for standard work\" : \"Not borrowed\",\n                  j,\n                  s,\n                },\n                \"idle-capacity\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Named-policy borrowing\",\n                  value: item.borrowedOverlayCapacity\n                    ? \"Borrowed outside the preferred group\"\n                    : \"Not borrowed\",\n                  j,\n                  s,\n                },\n                \"named-policy\",\n              ),\n              j(\n                FleetDetail,\n                {\n                  term: \"Stranded capacity\",\n                  value:\n                    item.strandedEligibleCount === 0\n                      ? \"None\"\n                      : `${item.strandedEligibleCount} eligible ${item.strandedEligibleCount === 1 ? \"candidate\" : \"candidates\"}`,\n                  note:\n                    item.strandedEligibleCount > 0\n                      ? \"Capacity excluded by explicit isolation; existing fenced turns are unchanged.\"\n                      : undefined,\n                  j,\n                  s,\n                },\n                \"stranded-capacity\",\n              ),\n            ],\n          },\n          \"details\",\n        ),\n        scores,\n        truncated,\n        hidden,\n      ],\n    }),\n  });\n}\n\nfunction FleetDetail({\n  term,\n  value,\n  note,\n  j,\n  s,\n}: {\n  term: string;\n  value: string;\n  note?: string | undefined;\n  j: RowJsx;\n  s: RowJsxs;\n}) {\n  return j(\"div\", {\n    className: \"min-w-0\",\n    children: [\n      j(\n        \"dt\",\n        {\n          className: \"text-og-xs font-medium uppercase tracking-wide text-og-fg-subtle\",\n          children: term,\n        },\n        \"term\",\n      ),\n      s(\n        \"dd\",\n        {\n          className: \"mt-0.5 break-words text-og-sm text-og-fg-muted\",\n          children: [\n            j(\"span\", { className: \"text-og-fg\", children: value }, \"value\"),\n            note\n              ? j(\"span\", { className: \"mt-0.5 block leading-5\", children: note }, \"note\")\n              : null,\n          ],\n        },\n        \"description\",\n      ),\n    ],\n  });\n}\n\nfunction fleetOutcomeLabel(\n  outcome: FleetDecisionItem[\"actualOutcome\"] | FleetDecisionItem[\"shadowOutcome\"],\n  candidateKey: string | null,\n): string {\n  if (outcome === \"selected\" && candidateKey) return `Selected ${candidateKey}`;\n  if (outcome === \"waiting\") return \"Waiting for capacity\";\n  if (outcome === \"paced\") return \"Paced before placement\";\n  return \"No candidate selected\";\n}\n\nfunction formatFleetScore(value: number): string {\n  return new Intl.NumberFormat(\"en-US\", { maximumFractionDigits: 2 }).format(value);\n}\n"],"mappings":"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","names":[]}

package/dist/hooks/channel-cache.d.ts

@@ -0,0 +1,23 @@
+import type { Channel } from "@opengeni/sdk";
+import type { SessionClientLike } from "../client.js";
+export type ChannelCacheSnapshot = Readonly<{
+    channels: readonly Channel[];
+    ready: boolean;
+}>;
+export type ChannelCacheStore = Readonly<{
+    getSnapshot: () => ChannelCacheSnapshot;
+    subscribe: (listener: () => void) => () => void;
+    beginLoad: () => number;
+    acceptLoad: (ticket: number, channels: readonly Channel[]) => void;
+    publishCreated: (channel: Channel) => void;
+}>;
+/**
+ * One client/workspace cache shared by every useChannels consumer.
+ *
+ * List reads are ticketed so an older request cannot erase a newer result.
+ * A successful create remains layered over the latest server snapshot until a
+ * list request that started after that success reconciles it. Requests already
+ * in flight cannot make the project disappear between create and session start.
+ */
+export declare function createChannelCacheStore(): ChannelCacheStore;
+export declare function channelCacheFor(client: SessionClientLike, workspaceId: string): ChannelCacheStore;

package/dist/hooks/latest-question.d.ts

@@ -0,0 +1,25 @@
+import { type SessionEvent, type SessionTurn } from "@opengeni/sdk";
+import type { EmbeddedSessionClientLike } from "../client.js";
+export type LatestQuestionOptions = {
+    /** Check navigation.isCurrent() after awaits and immediately before UI effects. */
+    onQueuedQuestion?: (turn: SessionTurn, navigation: {
+        isCurrent: () => boolean;
+    }) => void | Promise<void>;
+};
+/** Include every canonical execution fallback, not just turn.started. Derive
+ * this optional navigation index only when the user requests Latest question. */
+export declare const TIMELINE_TURN_ANCHOR_EVENT_TYPES: ("agent.message.completed" | "agent.message.delta" | "agent.model.request" | "agent.model.usage" | "agent.reasoning.delta" | "agent.toolCall.created" | "agent.toolCall.output" | "agent.updated" | "artifact.created" | "codex.account.selection.changed" | "codex.account.switched" | "codex.capacity.resumed" | "codex.capacity.superseded" | "codex.capacity.waiting" | "codex.credential.selected" | "codex.fleet.decision" | "credential.auth_needed" | "fs.changed" | "git.changed" | "goal.cleared" | "goal.completed" | "goal.continuation" | "goal.held" | "goal.paused" | "goal.progress" | "goal.resumed" | "goal.rewrite.proposed" | "goal.rewrite.rejected" | "goal.set" | "goal.updated" | "instruction.confirmation.recovered" | "knowledge.confirmation.recovered" | "knowledge.source.failed" | "knowledge.source.prepared" | "machine.link.lost" | "machine.link.restored" | "machine.op.failed" | "machine.op.recovered" | "machine.runner.restarted" | "memory.corrected" | "memory.saved" | "recording.available" | "recording.failed" | "recording.started" | "rig.setup.completed" | "rig.setup.failed" | "rig.setup.skipped" | "rig.setup.started" | "sandbox.box.created" | "sandbox.box.lost" | "sandbox.box.snapshot" | "sandbox.box.terminated" | "sandbox.command.output.delta" | "sandbox.env.drift" | "sandbox.operation.completed" | "sandbox.operation.failed" | "sandbox.operation.started" | "session.agent.updated" | "session.command.backgrounded" | "session.command.finished" | "session.context.cleared" | "session.context.compacted" | "session.context.compaction.requested" | "session.context.compaction.skipped" | "session.context.compaction.started" | "session.control.paused" | "session.control.resumed" | "session.control.steer_requested" | "session.created" | "session.event.envelope_omitted" | "session.humanInput.requested" | "session.mcp.approval_policy.updated" | "session.model_settings.updated" | "session.personal_resources.attached" | "session.queue.changed" | "session.queue.history" | "session.queue.prompt.cancelled" | "session.realtime.ended" | "session.realtime.started" | "session.requiresAction" | "session.route.reconciled" | "session.runtime.configured" | "session.status.changed" | "session.title_set" | "session.tool_policy.updated" | "session.variable_sets.updated" | "session.visibility.changed" | "session.wait.finished" | "session.wait.started" | "stream.closed" | "stream.opened" | "stream.revoked" | "stream.url.rotated" | "system.update.cancelled" | "system.update.delivered" | "system.update.pending" | "system.update.settled" | "system.update.superseded" | "terminal.pty.exited" | "terminal.pty.output.delta" | "terminal.pty.started" | "tool.auth_needed" | "turn.cancelled" | "turn.capacity_waiting" | "turn.completed" | "turn.dispatch.expired" | "turn.event.rejected_late" | "turn.failed" | "turn.queued" | "turn.recovery.requested" | "turn.started" | "turn.startup.phase.completed" | "turn.startup.phase.failed" | "turn.startup.phase.started" | "turn.superseded" | "usage.exhausted" | "usage.period_reset" | "usage.threshold_reached" | "user.approvalDecision" | "user.humanInputResponse" | "user.message" | "user.pause" | "workspace.inference.paused" | "workspace.inference.resumed" | "workspace.revision.captured" | "workspace.revision.degraded")[];
+/** Resolve an optional navigation destination without owning the hook's window
+ * or React state. The caller guards errors and applies only a current result. */
+export declare function resolveLatestQuestion({ client, workspaceId, sessionId, isCurrent, resumeSequence, options, }: {
+    client: EmbeddedSessionClientLike;
+    workspaceId: string;
+    sessionId: string;
+    isCurrent: () => boolean;
+    resumeSequence: (events: readonly SessionEvent[]) => number;
+    options?: LatestQuestionOptions | undefined;
+}): Promise<{
+    questionSequence: number;
+    anchor: number;
+    events: SessionEvent[];
+} | null>;

package/dist/hooks/shared-machines-list.d.ts

@@ -0,0 +1,14 @@
+import type { MachinesResponse } from "../types/machines.js";
+export declare const EMPTY_MACHINES: MachinesResponse;
+export type SharedMachinesSnapshot = {
+    data: MachinesResponse | null;
+    loading: boolean;
+    error: Error | null;
+};
+export declare function refreshSharedMachinesList(shareKey: string): Promise<void>;
+export declare function useSharedMachinesList(shareKey: string, load: (signal?: AbortSignal) => Promise<MachinesResponse>, options?: {
+    pollIntervalMs?: number | undefined;
+    enabled?: boolean | undefined;
+}): SharedMachinesSnapshot & {
+    refresh: () => Promise<void>;
+};

package/dist/hooks/use-attached-browsers.d.ts

@@ -1,4 +1,4 @@
-import type { AttachedBrowserDevice } from "@opengeni/sdk/interaction";
+import type { AttachedBrowserBridge, AttachedBrowserDevice } from "@opengeni/sdk/interaction";
 import type { EmbeddedBrowserInteractionClientLike } from "../client.js";
 import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
 export type UseAttachedBrowsersOptions = EmbeddedBrowserInteractionClientOverride & {
@@ -8,6 +8,7 @@ export type UseAttachedBrowsersOptions = EmbeddedBrowserInteractionClientOverrid
 };
 export type UseAttachedBrowsersResult = {
     revision: number;
+    bridges: AttachedBrowserBridge[];
     devices: AttachedBrowserDevice[];
     loading: boolean;
     refreshing: boolean;

package/dist/hooks/use-browser-frame-stream.d.ts

@@ -15,7 +15,7 @@ export type UseBrowserFrameStreamOptions = EmbeddedBrowserInteractionClientOverr
 export type UseBrowserFrameStreamResult = {
     state: BrowserFrameConnectionState;
     frame: BrowserFrame | null;
-    attachment: Pick<BrowserSessionAttachment, "browserSessionId" | "controllerGeneration" | "targetId" | "expiresAt"> | null;
+    attachment: Pick<BrowserSessionAttachment, "browserSessionId" | "controllerGeneration" | "targetId" | "expiresAt" | "fencedInputBatches" | "focusedInputObservations"> | null;
     error: Error | null;
     reconnect: () => void;
 };

package/dist/hooks/use-browser-session.d.ts

@@ -1,9 +1,17 @@
 import type { BrowserAction, BrowserActionBatch, BrowserActionReceipt, BrowserClipboard, BrowserDiagnosticBatch, BrowserDiagnosticsOptions, BrowserFrame, BrowserObservation, BrowserSession, BrowserTarget } from "@opengeni/sdk/interaction";
 import { type EmbeddedBrowserInteractionClientOverride } from "../session-context.js";
+/** Immutable input fence; queued actions never need the encoded screenshot. */
+export type BrowserFrameInputFence = Pick<BrowserFrame, "browserSessionId" | "controllerGeneration" | "targetId" | "targetGeneration" | "documentGeneration" | "frameId">;
+export type BrowserInputFailure = Pick<BrowserActionReceipt, "operationId" | "error"> & {
+    state: Exclude<BrowserActionReceipt["state"], "completed">;
+};
 export type UseBrowserSessionOptions = EmbeddedBrowserInteractionClientOverride & {
     browserSessionId: string | null;
     enabled?: boolean | undefined;
     pollIntervalMs?: number | undefined;
+    /** Keep session/tab inventory current without repeatedly fetching the full
+     * accessibility tree while a live frame is available or the viewer is hidden. */
+    semanticObservationEnabled?: boolean | undefined;
 };
 export type UseBrowserSessionResult = {
     session: BrowserSession | null;
@@ -13,14 +21,17 @@ export type UseBrowserSessionResult = {
     loading: boolean;
     mutating: boolean;
     error: Error | null;
+    inputFailure: BrowserInputFailure | null;
     refresh: () => Promise<void>;
+    observeForInput: () => Promise<BrowserObservation>;
+    actFromObservation: (action: BrowserAction, observation: BrowserObservation) => Promise<BrowserActionReceipt>;
     selectTarget: (targetId: string) => Promise<BrowserTarget>;
     openTarget: (url?: string) => Promise<BrowserTarget>;
     closeTarget: (targetId: string) => Promise<void>;
     act: (action: BrowserAction | BrowserActionBatch, operationId?: string) => Promise<BrowserActionReceipt>;
     /** Dispatch input against the exact image a human saw. Stale images fail at
      *  the controller fence instead of targeting a newer page. */
-    actFromFrame: (action: BrowserAction | BrowserActionBatch, frame: BrowserFrame, operationId?: string) => Promise<BrowserActionReceipt>;
+    actFromFrame: (action: BrowserAction | BrowserActionBatch, frame: BrowserFrameInputFence, operationId?: string, observationMode?: "none" | "input") => Promise<BrowserActionReceipt>;
     readClipboard: () => Promise<BrowserClipboard>;
     diagnostics: (options?: BrowserDiagnosticsOptions) => Promise<BrowserDiagnosticBatch>;
 };

package/dist/hooks/use-channels.d.ts

@@ -11,6 +11,7 @@ export type UseChannelsResult = {
     refresh: () => Promise<void>;
     create: (request: CreateChannelRequest) => Promise<Channel | null>;
     update: (channelId: string, request: UpdateChannelRequest) => Promise<Channel | null>;
+    reorder: (channelIds: string[]) => Promise<Channel[] | null>;
     remove: (channelId: string) => Promise<boolean>;
     /** Re-file a session into a channel; null moves it back to the inbox. */
     moveSession: (sessionId: string, channelId: string | null) => Promise<Session | null>;

package/dist/hooks/use-codex-accounts.d.ts

@@ -1,4 +1,4 @@
-import type { CodexAccount, CodexAccountsResponse, CodexRotationSettings, SessionEvent } from "@opengeni/sdk";
+import type { CodexAccount, CodexAccountsResponse, CodexRotationSettings, CodexUsageMap, SessionCodexAccountsResponse, SessionEvent } from "@opengeni/sdk";
 import { type ClientOverride } from "../provider.js";
 import { type SessionEventFeedOptions } from "./internal.js";
 /** Events that change which Codex account a session runs on (or just ran). */
@@ -7,21 +7,29 @@ export declare function isCodexAccountEvent(event: Pick<SessionEvent, "type">):
  * The structural slice of the SDK client the Codex-accounts surface needs. Method
  * NAMES + SIGNATURES match `OpenGeniClient` so the real client satisfies it
  * directly; declared structurally (not a hard Pick) so a test/Geni client can
- * stand in. `getSession` reads the session's pin/last; `pinSessionCodexAccount`
+ * stand in. `listSessionCodexAccounts` reads the accepted selection and choices
+ * atomically; `pinSessionCodexAccount`
  * is the optional mutation (absent ⇒ the indicator hides the switch affordance).
  */
 export type CodexAccountsClientLike = {
     listCodexAccounts: (workspaceId: string) => Promise<CodexAccountsResponse>;
+    /** Required for session-scoped use; never fall back to another pool. */
+    listSessionCodexAccounts?: (workspaceId: string, sessionId: string) => Promise<SessionCodexAccountsResponse>;
     getSession?: (workspaceId: string, sessionId: string) => Promise<{
         codexPinnedCredentialId?: string | null;
         codexLastCredentialId?: string | null;
+        codexCurrentSelection?: {
+            credentialId: string | null;
+            waiting: boolean;
+        } | null;
     }>;
     pinSessionCodexAccount?: (workspaceId: string, sessionId: string, target: string) => Promise<{
         pinned: string;
+        appliedTo?: "waiting_turn" | "next_turn";
     }>;
     /** Optional (absent ⇒ the card hides live refresh): batched live /wham/usage refresh. */
     refreshCodexUsage?: (workspaceId: string) => Promise<{
-        usage: Record<string, unknown>;
+        usage: CodexUsageMap;
     }>;
 };
 export type UseCodexAccountsOptions = ClientOverride & SessionEventFeedOptions & {
@@ -33,16 +41,24 @@ export type UseCodexAccountsOptions = ClientOverride & SessionEventFeedOptions &
 };
 export type UseCodexAccountsResult = {
     accounts: CodexAccount[];
-    /** The workspace ACTIVE account (used when a session is unpinned). */
+    /** The ACTIVE account for the retry pool, or current workspace pool for new work. */
     activeAccountId: string | null;
     /** The session's PINNED account (null ⇒ following workspace active). */
     pinnedAccountId: string | null;
-    /** The account the next turn will run on: pin > workspace active. */
+    /** Current preference only; automatic allocation can choose another account. */
     effectiveAccountId: string | null;
+    currentSelection: {
+        credentialId: string | null;
+        waiting: boolean;
+    } | null;
+    /** The accepted account can differ from the choices for the next turn. */
+    currentAccount: CodexAccount | null;
+    switchAppliedTo: "waiting_turn" | "next_turn" | null;
     /** The account the session's last turn ACTUALLY ran on (the "Running on:" source). */
     lastAccountId: string | null;
     settings: CodexRotationSettings;
     loading: boolean;
+    error: Error | null;
     refresh: () => Promise<void>;
     /**
      * Trigger a LIVE batched /wham/usage refresh across all accounts, then re-read
@@ -50,6 +66,8 @@ export type UseCodexAccountsResult = {
      * No-op (resolves false) when the client can't refresh usage.
      */
     refreshUsage: () => Promise<boolean>;
+    /** Live provider readings override stale cached labels after refreshUsage. */
+    liveUsage: CodexUsageMap;
     /** True while a live usage refresh is in flight (drives the bar skeleton). */
     refreshingUsage: boolean;
     /** Pin (or unpin via "auto") the session's account; returns true on success. */
@@ -60,8 +78,8 @@ export type UseCodexAccountsResult = {
     mutationError: Error | null;
 };
 /**
- * The workspace's Codex accounts + the per-workspace active pointer + (when
- * session-scoped) the session pin and last-ran-on account. Composed like
+ * The workspace's Codex accounts, or session-authorized retry/next-turn choices
+ * and accepted current account. Composed like
  * `useMachines`: slow polling (the realtime work is done by the
  * `codex.account.switched` event trigger) + a `pin` mutation.
  * Dual-consumer safe via the structural `CodexAccountsClientLike` surface.

package/dist/hooks/use-composer.d.ts

@@ -1,16 +1,22 @@
-import { type ComposerDraft, type DraftTimelineAnnotation, type EffectiveControlResumeOption, type EffectiveSessionControl, type ResourceRef, type SendMessageInput, type SessionEvent } from "@opengeni/sdk";
+import { type ComposerDraft, type DraftTimelineAnnotation, type EffectiveControlResumeOption, type EffectiveSessionControl, type LatencyMode, type ReasoningEffort, type ResourceRef, type SendMessageInput, type SessionEvent } from "@opengeni/sdk";
 import { type EmbeddedSessionClientOverride } from "../session-context.js";
 import { type SessionEventFeedOptions } from "./internal.js";
-export type ComposerSendExtras = Omit<SendMessageInput, "text" | "clientEventId" | "annotations">;
+export type ComposerPolicy = {
+    model: string;
+    reasoningEffort: ReasoningEffort;
+    latencyMode: LatencyMode;
+};
+export type ComposerSendExtras = Omit<SendMessageInput, "text" | "clientEventId" | "annotations" | "model" | "reasoningEffort" | "latencyMode">;
 export type UseComposerOptions = EmbeddedSessionClientOverride & SessionEventFeedOptions & {
     /** Called synchronously after an ordinary Send is accepted by the local UI. */
     onSubmitted?: ((text: string, input: SendMessageInput) => void) | undefined;
     /** Called with the exact accepted wire input after a successful send. */
     onSent?: ((text: string, input: SendMessageInput) => void) | undefined;
+    /** Called with the exact wire input after a delivery failure. */
+    onDeliveryError?: ((error: Error, input: SendMessageInput, delivery: "send" | "steer") => void) | undefined;
     /**
-     * Extra message fields (resources, tools, model, reasoningEffort, latencyMode) merged
-     * into every send. A function is evaluated at send time so it can read the
-     * surrounding UI state (attachment pickers, model selectors, ...).
+     * Non-policy message fields merged into every send. Durable policy belongs
+     * to this composer draft; attachments and credentials may remain host-owned.
      */
     sendExtras?: ComposerSendExtras | (() => ComposerSendExtras) | undefined;
     /**
@@ -21,19 +27,30 @@ export type UseComposerOptions = EmbeddedSessionClientOverride & SessionEventFee
     sendBlocked?: (() => boolean) | undefined;
     /** Latest server-derived workstream control; bound into Send/Steer OCC. */
     effectiveControl?: EffectiveSessionControl | null | undefined;
-    /** Apply durable model/tool/reasoning settings in the host's controlled UI. */
-    onDraftApplied?: ((draft: ComposerDraft) => void) | undefined;
+    /** Immediate user-visible destination for an ordinary Send before admission replies. */
+    sendDestination?: (() => "chat" | "queue") | undefined;
     /** Disable remote composer-draft reads and writes for embedded hosts. */
     draftPersistence?: "durable" | "disabled" | undefined;
+    /** Required explicit authority when durable draft persistence is disabled. */
+    initialPolicy?: ComposerPolicy | undefined;
 };
 export type ComposerOptimisticMessage = {
     clientEventId: string;
+    delivery: "send" | "steer";
+    destination: "chat" | "queue";
     text: string;
     annotations: DraftTimelineAnnotation[];
     resources: ResourceRef[];
     occurredAt: string;
     state: "sending" | "queued" | "failed";
+    turnId?: string | null | undefined;
+    triggerEventId?: string | null | undefined;
+    appliedQueueVersion?: number | null | undefined;
     error?: string | undefined;
+    /** Bounded support reference retained independently of display copy across remounts. */
+    correlationId?: string | undefined;
+    /** False for a definitive refusal that requires changing payment or allowance settings. */
+    retryable?: boolean | undefined;
     outcomeUnknown?: boolean | undefined;
 };
 export type ComposerState = {
@@ -46,6 +63,8 @@ export type ComposerState = {
     /** Newly captured annotation the review surface should focus. */
     annotationReviewTargetId?: string | null | undefined;
     clearAnnotationReviewTarget?: (() => void) | undefined;
+    /** Focus an annotation, or the first incomplete note when omitted. */
+    requestAnnotationReview?: ((id?: string) => void) | undefined;
     /** Read the current draft synchronously before a destructive replacement. */
     hasDraftContent: () => boolean;
     /** Append the draft behind prompts already visible in the queue. */
@@ -53,6 +72,8 @@ export type ComposerState = {
     /** Locally acknowledged ordinary sends awaiting durable timeline reconciliation. */
     optimisticMessages?: ComposerOptimisticMessage[] | undefined;
     retryOptimisticMessage?: ((clientEventId: string) => void) | undefined;
+    /** Move a definitively refused message into an empty composer without resending it. */
+    restoreOptimisticMessage?: ((clientEventId: string) => void) | undefined;
     removeOptimisticMessage?: ((clientEventId: string) => void) | undefined;
     /** Supersede current direction with the draft. */
     steer: (text?: string) => Promise<boolean>;
@@ -68,11 +89,18 @@ export type ComposerState = {
     resume: (reason?: string) => Promise<void>;
     resumeScope: (option: EffectiveControlResumeOption) => Promise<void>;
     resuming: boolean;
+    /** Mutation-confirmed control while the streamed queue projection catches up. */
+    effectiveControl?: EffectiveSessionControl | null | undefined;
     draft: ComposerDraft | null;
     draftRevision: number;
     draftLoading: boolean;
     draftSaving: boolean;
     draftConflict: Error | null;
+    /** Exact policy owned by this actor/session composer. Null while hydrating. */
+    policy?: ComposerPolicy | null | undefined;
+    setModel?: ((model: string) => void) | undefined;
+    setReasoningEffort?: ((effort: ReasoningEffort) => void) | undefined;
+    setLatencyMode?: ((mode: LatencyMode) => void) | undefined;
     /** Whether this controller owns a durable server-side draft. */
     draftPersistence?: "durable" | "disabled" | undefined;
     /** Apply an atomic queue Edit checkout without a second read. */
@@ -84,14 +112,22 @@ export type ComposerState = {
     error: Error | null;
     clearError: () => void;
 };
+export type ComposerControllerState = ComposerState & {
+    policy: ComposerPolicy | null;
+    setModel: (model: string) => void;
+    setReasoningEffort: (effort: ReasoningEffort) => void;
+    setLatencyMode: (mode: LatencyMode) => void;
+};
 export type ComposerSteeringState = {
-    phase: "submitting" | "accepted";
+    phase: "submitting" | "accepted" | "failed";
     text: string;
     clientEventId: string | null;
     triggerEventId: string | null;
     turnId: string | null;
     /** True only when the accepted Steer durably interrupted a live attempt. */
     stoppingPreviousAttempt?: boolean | undefined;
+    error?: string | undefined;
+    outcomeUnknown?: boolean | undefined;
 };
 /**
  * Draft + send + Pause/Resume state for the chat composer — the only
@@ -99,7 +135,7 @@ export type ComposerSteeringState = {
  * more hostile than losing a typed message); each send carries a generated
  * `clientEventId` so retries stay idempotent server-side.
  */
-export declare function useComposer(sessionId: string | null | undefined, options?: UseComposerOptions): ComposerState;
+export declare function useComposer(sessionId: string | null | undefined, options?: UseComposerOptions): ComposerControllerState;
 /** Events that can atomically replace or clear this subject's durable draft. */
 export declare function isComposerDraftEvent(event: Pick<SessionEvent, "type">): boolean;
 /**

package/dist/hooks/use-computer-frame-stream.d.ts

@@ -15,7 +15,7 @@ export type UseComputerFrameStreamOptions = EmbeddedComputerInteractionClientOve
 export type UseComputerFrameStreamResult = {
     state: ComputerFrameConnectionState;
     frame: ComputerFrame | null;
-    attachment: Pick<ComputerSessionAttachment, "computerSessionId" | "controllerGeneration" | "targetId" | "stream" | "expiresAt"> | null;
+    attachment: Pick<ComputerSessionAttachment, "computerSessionId" | "controllerGeneration" | "targetId" | "inputAllowed" | "stream" | "expiresAt"> | null;
     error: Error | null;
     reconnect: () => void;
 };

package/dist/hooks/use-computer-input-posture.d.ts

@@ -0,0 +1,13 @@
+import { type EmbeddedComputerInteractionClientOverride } from "../session-context.js";
+/** Semantic-only targets need caller authority without opening a pixel stream.
+ * A source change synchronously discards the previous posture. */
+export declare function useComputerInputPosture(options: EmbeddedComputerInteractionClientOverride & {
+    computerSessionId: string | null;
+    controllerGeneration: string | null;
+    enabled: boolean;
+}): {
+    inputAllowed: boolean | null;
+    pending: boolean;
+    error: Error | null;
+    refresh: () => void;
+};

package/dist/hooks/use-computer-session.d.ts

@@ -13,6 +13,8 @@ export type UseComputerSessionResult = {
     loading: boolean;
     mutating: boolean;
     error: Error | null;
+    /** Control service loss, independent of target accessibility inspection and media. */
+    controlError: Error | null;
     refresh: () => Promise<void>;
     readClipboard: () => Promise<ComputerClipboard>;
     /** Changes only this viewer's target cursor; it never takes ownership or

package/dist/hooks/use-connect.d.ts

@@ -0,0 +1,22 @@
+import type { ConnectController } from "@opengeni/connect";
+/** Internal consumers import the hook directly so setup surfaces stay lazy. */
+export declare function useConnect(controller: ConnectController): {
+    attempt: import("@opengeni/connect").ConnectAttempt | null;
+    busy: boolean;
+    error: Error | null;
+    begin: (input: {
+        providerId: string;
+        ownership: import("@opengeni/connect").ConnectOwnership;
+        returnUrl: string;
+        idempotencyKey: string;
+        reconnectAccountId?: string;
+        installationTarget?: import("@opengeni/connect").ConnectInstallationTarget;
+    }) => Promise<import("@opengeni/connect").ConnectAttempt>;
+    recover: (attemptId: string) => Promise<import("@opengeni/connect").ConnectAttempt>;
+    refresh: () => Promise<import("@opengeni/connect").ConnectAttempt>;
+    waitForAction: (options?: {
+        timeoutMs?: number;
+    }) => Promise<import("@opengeni/connect").ConnectAttempt>;
+    advance: (action: import("@opengeni/connect").ConnectAdvance, idempotencyKey: string) => Promise<import("@opengeni/connect").ConnectAttempt>;
+    cancel: (idempotencyKey: string) => Promise<import("@opengeni/connect").ConnectAttempt>;
+};

package/dist/hooks/use-desktop-stream.d.ts

@@ -9,7 +9,7 @@ export type UseDesktopStreamOptions = {
     /** Read-only by default (v1 ruling H). interactive only when cap.mode allows. */
     interactive?: boolean | undefined;
     scaleViewport?: boolean | undefined;
-    /** Custom RFB factory (tests / a WebRTC swap). Defaults to a lazy @novnc/novnc. */
+    /** Custom RFB factory. Otherwise call enableDesktopViewer() on the desktop subpath. */
     rfbFactory?: DesktopRfbFactory | undefined;
     /** Additional WebSocket protocols for an authenticated placement proxy. */
     webSocketProtocols?: string[] | undefined;