@agent-native/core 0.92.12 → 0.94.0

package/corpus/core/src/client/index.ts

@@ -487,6 +487,10 @@ export {
   AgentComposerFrame,
   type AgentComposerFrameProps,
   PromptComposer,
+  RealtimeVoiceModeBoundary,
+  RealtimeVoiceModeProvider,
+  RealtimeVoiceModeDock,
+  RealtimeVoiceModeEntry,
   TiptapComposer,
   AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES,
   AGENT_PROMPT_MAX_INLINE_TEXT_CHARS,
@@ -494,9 +498,23 @@ export {
   formatPromptWithAttachments,
   isInlineableAgentPromptFile,
   readAgentPromptAttachment,
+  createRealtimeVoiceSession,
+  executeRealtimeVoiceTool,
+  extractRealtimeVoiceFunctionCalls,
+  readRealtimeVoiceContext,
+  useRealtimeVoiceMode,
+  useRealtimeVoiceModeCopy,
+  useRealtimeVoiceModeOptional,
   type PromptComposerProps,
   type PromptComposerFile,
   type PromptComposerSubmitOptions,
+  type RealtimeVoiceModeCopy,
+  type RealtimeVoiceModeDockProps,
+  type RealtimeVoiceModeEntryProps,
+  type RealtimeVoiceModeState,
+  type RealtimeVoiceModeApi,
+  type RealtimeVoiceModeProviderProps,
+  type RealtimeVoiceToolResult,
   type ComposerSubmitIntent,
   type AgentPromptAttachment,
   type ReadAgentPromptAttachmentOptions,
@@ -895,6 +913,36 @@ export {
   type ProviderReadinessBadgeProps,
   type SetupConnectionsPageProps,
 } from "./setup-connections/index.js";
+export {
+  listIntegrationEnvStatuses,
+  listIntegrationStatuses,
+  saveIntegrationEnvVars,
+  setIntegrationEnabled,
+  setupIntegration,
+  disconnectManagedIntegrationInstallation,
+  listManagedIntegrationInstallations,
+  managedIntegrationOAuthUrl,
+  managedSlackAgentManifestUrl,
+  listManagedIntegrationScopes,
+  saveManagedIntegrationScope,
+  listManagedIntegrationBudgets,
+  listManagedIntegrationMemory,
+  forgetManagedIntegrationMemory,
+  saveManagedIntegrationBudget,
+  testManagedIntegrationInstallation,
+  IntegrationClientError,
+  type ClientIntegrationInstallation,
+  type ClientIntegrationScope,
+  type ClientIntegrationUsageBudget,
+  type ClientIntegrationMemory,
+  type ClientIntegrationStatus,
+  type IntegrationEnvStatus,
+  type SavedEnvVarsResult,
+} from "./integrations/index.js";
+export {
+  invokeConfiguredAutomationWorkflow,
+  type InvokeConfiguredAutomationWorkflowInput,
+} from "./automation.js";
 export {
   ChangelogDialog,
   ChangelogSettingsCard,

package/corpus/core/src/client/integrations/api.ts

@@ -0,0 +1,295 @@
+import { agentNativePath } from "../api-path.js";
+
+export interface IntegrationEnvStatus {
+  key: string;
+  label: string;
+  required: boolean;
+  configured: boolean;
+  helpText?: string;
+}
+
+export interface ClientIntegrationStatus {
+  platform: string;
+  label: string;
+  enabled: boolean;
+  configured: boolean;
+  details?: Record<string, unknown>;
+  error?: string;
+  webhookUrl?: string;
+  requiredEnvKeys?: IntegrationEnvStatus[];
+}
+
+export interface SavedEnvVarsResult {
+  saved: string[];
+  storage?: string;
+}
+
+export interface ClientIntegrationInstallation {
+  id: string;
+  platform: string;
+  installationKey: string;
+  teamId: string | null;
+  teamName: string | null;
+  enterpriseId: string | null;
+  enterpriseName: string | null;
+  scopes: string[];
+  ownerEmail: string;
+  orgId: string | null;
+  status: "connected" | "disconnected" | "revoked" | "error";
+  health: "unknown" | "healthy" | "degraded" | "revoked";
+  lastError: string | null;
+  healthCheckedAt: number | null;
+  tokenExpiresAt: number | null;
+  updatedAt: number;
+}
+
+export interface ClientIntegrationScope {
+  id: string;
+  platform: string;
+  tenantId: string;
+  conversationId: string;
+  conversationType: "channel" | "direct_message" | "group_direct_message";
+  trust: "trusted" | "guest" | "external_shared" | "unknown";
+  orgId: string | null;
+  serviceOwnerEmail: string;
+  defaultModel: string | null;
+  policy: {
+    requireMention: boolean;
+    allowDirectMessages: boolean;
+    allowGuests: boolean;
+    allowExternalShared: boolean;
+    allowUnknownTrust: boolean;
+  };
+  updatedAt: number;
+}
+
+export interface ClientIntegrationUsageBudget {
+  id: string;
+  subjectType: "org" | "user" | "scope";
+  subjectId: string;
+  period: "day" | "month";
+  limitMicros: number;
+  thresholdBps: number;
+  updatedAt: number;
+}
+
+export interface ClientIntegrationMemory {
+  name: string;
+  path: string;
+  updatedAt: number;
+  size: number;
+}
+
+export class IntegrationClientError extends Error {
+  constructor(
+    message: string,
+    readonly status: number,
+  ) {
+    super(message);
+    this.name = "IntegrationClientError";
+  }
+}
+
+async function readResponse<T>(response: Response): Promise<T> {
+  let payload: unknown;
+  try {
+    payload = await response.json();
+  } catch {
+    if (response.ok) {
+      throw new IntegrationClientError(
+        "Integration response was not valid JSON.",
+        response.status,
+      );
+    }
+    payload = null;
+  }
+  if (response.ok) return payload as T;
+
+  const error =
+    payload &&
+    typeof payload === "object" &&
+    typeof (payload as { error?: unknown }).error === "string"
+      ? (payload as { error: string }).error
+      : response.statusText || `Request failed (HTTP ${response.status})`;
+  throw new IntegrationClientError(error, response.status);
+}
+
+async function integrationRequest<T>(
+  path: string,
+  init?: RequestInit,
+): Promise<T> {
+  return readResponse<T>(await fetch(agentNativePath(path), init));
+}
+
+export async function listIntegrationStatuses(): Promise<
+  ClientIntegrationStatus[]
+> {
+  const result = await integrationRequest<unknown>(
+    "/_agent-native/integrations/status",
+  );
+  return Array.isArray(result) ? (result as ClientIntegrationStatus[]) : [];
+}
+
+export async function setIntegrationEnabled(
+  platform: string,
+  enabled: boolean,
+): Promise<unknown> {
+  return integrationRequest(
+    `/_agent-native/integrations/${encodeURIComponent(platform)}/${enabled ? "enable" : "disable"}`,
+    { method: "POST" },
+  );
+}
+
+export async function setupIntegration(platform: string): Promise<unknown> {
+  return integrationRequest(
+    `/_agent-native/integrations/${encodeURIComponent(platform)}/setup`,
+    { method: "POST" },
+  );
+}
+
+export function managedIntegrationOAuthUrl(
+  platform: string,
+  returnPath = "/messaging",
+): string {
+  const query = new URLSearchParams({ return: returnPath });
+  return agentNativePath(
+    `/_agent-native/integrations/${encodeURIComponent(platform)}/oauth/install?${query}`,
+  );
+}
+
+export function managedSlackAgentManifestUrl(): string {
+  return agentNativePath("/_agent-native/integrations/slack/manifest");
+}
+
+export async function listManagedIntegrationInstallations(
+  platform?: string,
+): Promise<ClientIntegrationInstallation[]> {
+  const query = platform
+    ? `?${new URLSearchParams({ platform }).toString()}`
+    : "";
+  const result = await integrationRequest<{
+    installations?: ClientIntegrationInstallation[];
+  }>(`/_agent-native/integrations/installations${query}`);
+  return Array.isArray(result.installations) ? result.installations : [];
+}
+
+export async function testManagedIntegrationInstallation(
+  id: string,
+): Promise<ClientIntegrationInstallation | null> {
+  const result = await integrationRequest<{
+    installation?: ClientIntegrationInstallation | null;
+  }>("/_agent-native/integrations/installations", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ id, action: "test" }),
+  });
+  return result.installation ?? null;
+}
+
+export async function disconnectManagedIntegrationInstallation(
+  id: string,
+): Promise<ClientIntegrationInstallation | null> {
+  const result = await integrationRequest<{
+    installation?: ClientIntegrationInstallation | null;
+  }>("/_agent-native/integrations/installations", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ id, action: "disconnect" }),
+  });
+  return result.installation ?? null;
+}
+
+export async function listManagedIntegrationScopes(
+  platform?: string,
+): Promise<ClientIntegrationScope[]> {
+  const query = platform
+    ? `?${new URLSearchParams({ platform }).toString()}`
+    : "";
+  const result = await integrationRequest<{
+    scopes?: ClientIntegrationScope[];
+  }>(`/_agent-native/integrations/scopes${query}`);
+  return Array.isArray(result.scopes) ? result.scopes : [];
+}
+
+export async function saveManagedIntegrationScope(
+  scope: Omit<ClientIntegrationScope, "id" | "updatedAt">,
+): Promise<ClientIntegrationScope> {
+  const result = await integrationRequest<{ scope: ClientIntegrationScope }>(
+    "/_agent-native/integrations/scopes",
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(scope),
+    },
+  );
+  return result.scope;
+}
+
+export async function listManagedIntegrationBudgets(): Promise<
+  ClientIntegrationUsageBudget[]
+> {
+  const result = await integrationRequest<{
+    budgets?: ClientIntegrationUsageBudget[];
+  }>("/_agent-native/integrations/budgets");
+  return Array.isArray(result.budgets) ? result.budgets : [];
+}
+
+export async function saveManagedIntegrationBudget(input: {
+  subject:
+    | { type: "org"; orgId: string }
+    | { type: "user"; userEmail: string }
+    | {
+        type: "scope";
+        scope: { platform: string; tenantId: string; conversationId: string };
+      };
+  period: "day" | "month";
+  limitMicros: number;
+  thresholdBps?: number;
+}): Promise<ClientIntegrationUsageBudget> {
+  const result = await integrationRequest<{
+    budget: ClientIntegrationUsageBudget;
+  }>("/_agent-native/integrations/budgets", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(input),
+  });
+  return result.budget;
+}
+
+export async function listManagedIntegrationMemory(
+  scopeId: string,
+): Promise<ClientIntegrationMemory[]> {
+  const query = new URLSearchParams({ scopeId });
+  const result = await integrationRequest<{
+    memories?: ClientIntegrationMemory[];
+  }>(`/_agent-native/integrations/memory?${query}`);
+  return Array.isArray(result.memories) ? result.memories : [];
+}
+
+export async function forgetManagedIntegrationMemory(
+  scopeId: string,
+  name: string,
+): Promise<void> {
+  await integrationRequest("/_agent-native/integrations/memory", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ action: "forget", scopeId, name }),
+  });
+}
+
+export async function listIntegrationEnvStatuses(): Promise<
+  IntegrationEnvStatus[]
+> {
+  const result = await integrationRequest<unknown>("/_agent-native/env-status");
+  return Array.isArray(result) ? (result as IntegrationEnvStatus[]) : [];
+}
+
+export async function saveIntegrationEnvVars(
+  vars: Array<{ key: string; value: string }>,
+): Promise<SavedEnvVarsResult> {
+  return integrationRequest<SavedEnvVarsResult>("/_agent-native/env-vars", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ vars }),
+  });
+}

package/corpus/core/src/client/integrations/index.ts

@@ -1,3 +1,29 @@
 export { IntegrationsPanel } from "./IntegrationsPanel.js";
 export { useIntegrationStatus } from "./useIntegrationStatus.js";
 export type { IntegrationStatus } from "./useIntegrationStatus.js";
+export {
+  listIntegrationEnvStatuses,
+  listIntegrationStatuses,
+  saveIntegrationEnvVars,
+  setIntegrationEnabled,
+  setupIntegration,
+  disconnectManagedIntegrationInstallation,
+  listManagedIntegrationInstallations,
+  managedIntegrationOAuthUrl,
+  managedSlackAgentManifestUrl,
+  listManagedIntegrationScopes,
+  saveManagedIntegrationScope,
+  listManagedIntegrationBudgets,
+  listManagedIntegrationMemory,
+  forgetManagedIntegrationMemory,
+  saveManagedIntegrationBudget,
+  testManagedIntegrationInstallation,
+  IntegrationClientError,
+  type ClientIntegrationInstallation,
+  type ClientIntegrationScope,
+  type ClientIntegrationUsageBudget,
+  type ClientIntegrationMemory,
+  type ClientIntegrationStatus,
+  type IntegrationEnvStatus,
+  type SavedEnvVarsResult,
+} from "./api.js";

package/corpus/core/src/client/settings/DemoModeSection.tsx

@@ -17,6 +17,7 @@ import { useQuery } from "@tanstack/react-query";
 import { useEffect, useState } from "react";
 
 import { agentNativePath } from "../api-path.js";
+import { useChangeVersion } from "../use-change-version.js";
 
 interface DemoStatus {
   enabled?: boolean;
@@ -30,9 +31,10 @@ const DEMO_MODE_WRITE_URL = agentNativePath(
 
 export function DemoModeSection() {
   const [enabled, setEnabled] = useState<boolean | null>(null);
+  const demoModeVersion = useChangeVersion("app-state:demo-mode");
 
   const { data } = useQuery({
-    queryKey: ["agent-native", "demo-mode"],
+    queryKey: ["agent-native", "demo-mode", demoModeVersion],
     queryFn: async () => {
       const res = await fetch(DEMO_STATUS_URL, {
         credentials: "same-origin",
@@ -40,8 +42,7 @@ export function DemoModeSection() {
       if (!res.ok) return null;
       return (await res.json()) as DemoStatus | null;
     },
-    refetchInterval: 4_000,
-    staleTime: 2_000,
+    staleTime: Infinity,
   });
 
   const serverEnabled = data?.enabled;

package/corpus/core/src/client/settings/SettingsPanel.tsx

@@ -3177,6 +3177,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "agent",
         label: "Agent",
         icon: IconBrain,
+        group: "agent",
         keywords: "agent model llm limits voice automations",
         searchEntries: buildSectionSearchEntries(AGENT_SETTINGS_SECTIONS),
         content: (
@@ -3193,6 +3194,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "connections",
         label: "Connections",
         icon: IconPlugConnected,
+        group: "agent",
         keywords: "connections secrets integrations email browser usage",
         searchEntries: buildSectionSearchEntries(CONNECTION_SETTINGS_SECTIONS),
         content: (
@@ -3209,6 +3211,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "organization",
         label: "Organization",
         icon: IconUsersGroup,
+        group: "workspace",
         keywords: "organization org team members invites collaborators",
         content: (
           <div className="mx-auto w-full max-w-2xl">
@@ -3220,6 +3223,7 @@ export function useAgentSettingsTabs(): SettingsTabItem[] {
         id: "workspace",
         label: "Workspace",
         icon: IconCloud,
+        group: "workspace",
         keywords: "workspace account hosting database uploads auth",
         searchEntries: buildSectionSearchEntries(WORKSPACE_SETTINGS_SECTIONS),
         content: (

package/corpus/core/src/client/settings/SettingsTabsPage.tsx

@@ -49,6 +49,12 @@ export interface SettingsTabItem {
   label: string;
   icon?: SettingsTabIcon;
   content: ReactNode;
+  /**
+   * Optional visual navigation group. Adjacent tabs with the same group render
+   * together; a quiet divider separates each group on desktop while mobile
+   * keeps the compact horizontal tab scroller unchanged.
+   */
+  group?: string;
   /** Extra space-separated terms so this tab is findable via search. */
   keywords?: string;
   /** Deep-link entries within this tab for the settings search. */
@@ -78,9 +84,10 @@ export interface SettingsTabsPageProps {
   generalSearchEntries?: SettingsSearchEntry[];
   /**
    * Controlled active tab id. When provided, the parent owns tab state (and is
-   * responsible for URL/app-state sync); the component skips its own hash-based
-   * tab tracking. Leave undefined for the default uncontrolled, hash-driven
-   * behavior.
+   * responsible for URL/app-state sync). Recognized top-level tab hashes still
+   * report through `onValueChange`, so shared links such as
+   * `/settings#organization` can select the matching controlled Team tab.
+   * Leave undefined for the default uncontrolled, hash-driven behavior.
    */
   value?: string;
   /**
@@ -186,6 +193,7 @@ export function SettingsTabsPage({
   const rootRef = useRef<HTMLDivElement | null>(null);
   const searchInputRef = useRef<HTMLInputElement | null>(null);
   const autoFocusedSearchRef = useRef(false);
+  const controlledHashRef = useRef<string | null>(null);
   const tabs = useMemo<SettingsTabItem[]>(() => {
     const hasOrganizationTab = extraTabs.some(
       (tab) => tab.id === "organization",
@@ -205,6 +213,7 @@ export function SettingsTabsPage({
         id: "team",
         label: teamLabel,
         icon: IconUsers,
+        group: "workspace",
         content: team,
       });
     }
@@ -213,6 +222,7 @@ export function SettingsTabsPage({
         id: "whats-new",
         label: whatsNewLabel,
         icon: IconHistory,
+        group: "updates",
         content: whatsNew,
       });
     }
@@ -231,6 +241,21 @@ export function SettingsTabsPage({
   const fallbackTab = tabs.some((tab) => tab.id === defaultTab)
     ? defaultTab
     : (tabs[0]?.id ?? "general");
+  const tabGroups = useMemo(() => {
+    const groups: Array<{ id: string; tabs: SettingsTabItem[] }> = [];
+
+    for (const tab of tabs) {
+      const groupId = tab.group ?? "app";
+      const previousGroup = groups.at(-1);
+      if (previousGroup?.id === groupId) {
+        previousGroup.tabs.push(tab);
+      } else {
+        groups.push({ id: groupId, tabs: [tab] });
+      }
+    }
+
+    return groups;
+  }, [tabs]);
   const isControlled = value !== undefined;
   const [internalTab, setInternalTab] = useState(() =>
     activeTabFromHash(tabs, fallbackTab),
@@ -269,6 +294,23 @@ export function SettingsTabsPage({
     return () => window.removeEventListener("hashchange", handleHashChange);
   }, [isControlled, tabs]);
 
+  useEffect(() => {
+    // Controlled pages retain ownership of their active state, but shared
+    // organization navigation uses a hash deep link. Report only recognized
+    // top-level tab hashes; section hashes remain available to inner panels.
+    if (!isControlled) return;
+    const syncControlledHash = () => {
+      const hash = window.location.hash;
+      const fromHash = resolveTabId(tabs, hash);
+      if (!fromHash || controlledHashRef.current === hash) return;
+      controlledHashRef.current = hash;
+      onValueChange?.(fromHash);
+    };
+    syncControlledHash();
+    window.addEventListener("hashchange", syncControlledHash);
+    return () => window.removeEventListener("hashchange", syncControlledHash);
+  }, [isControlled, onValueChange, tabs, value]);
+
   useEffect(() => {
     if (!enableSearch || autoFocusedSearchRef.current) return;
     if (
@@ -472,40 +514,56 @@ export function SettingsTabsPage({
             role="tablist"
             className="flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible"
           >
-            {tabs.map((tab) => {
-              const Icon = tab.icon;
-              const selected = tab.id === selectedTab?.id;
-              return (
-                <button
-                  key={tab.id}
-                  type="button"
-                  role="tab"
-                  aria-selected={selected}
-                  aria-controls={`settings-tabpanel-${tab.id}`}
-                  id={`settings-tab-${tab.id}`}
-                  onClick={() => {
-                    changeTab(tab.id);
-                    if (!isControlled) updateHashForTab(tab.id);
-                  }}
-                  className={cn(
-                    "flex min-h-9 shrink-0 items-center gap-2 rounded-md px-3 py-2 text-start text-sm font-medium transition-colors sm:w-full",
-                    selected
-                      ? "bg-accent text-foreground"
-                      : "text-muted-foreground hover:bg-accent/50 hover:text-foreground",
-                  )}
-                >
-                  {Icon ? (
-                    <Icon
-                      className={cn(
-                        "size-4 shrink-0",
-                        selected ? "text-foreground" : "text-muted-foreground",
-                      )}
-                    />
-                  ) : null}
-                  <span className="truncate">{tab.label}</span>
-                </button>
-              );
-            })}
+            {tabGroups.map((group, groupIndex) => (
+              <div
+                key={group.id}
+                data-settings-tab-group={group.id}
+                className={cn(
+                  "contents sm:block",
+                  groupIndex > 0 &&
+                    "sm:mt-2 sm:border-t sm:border-border/60 sm:pt-2",
+                )}
+              >
+                <div className="contents sm:flex sm:flex-col sm:gap-1">
+                  {group.tabs.map((tab) => {
+                    const Icon = tab.icon;
+                    const selected = tab.id === selectedTab?.id;
+                    return (
+                      <button
+                        key={tab.id}
+                        type="button"
+                        role="tab"
+                        aria-selected={selected}
+                        aria-controls={`settings-tabpanel-${tab.id}`}
+                        id={`settings-tab-${tab.id}`}
+                        onClick={() => {
+                          changeTab(tab.id);
+                          if (!isControlled) updateHashForTab(tab.id);
+                        }}
+                        className={cn(
+                          "flex min-h-9 shrink-0 items-center gap-2 rounded-md px-3 py-2 text-start text-sm font-medium transition-colors sm:w-full",
+                          selected
+                            ? "bg-accent text-foreground"
+                            : "text-muted-foreground hover:bg-accent/50 hover:text-foreground",
+                        )}
+                      >
+                        {Icon ? (
+                          <Icon
+                            className={cn(
+                              "size-4 shrink-0",
+                              selected
+                                ? "text-foreground"
+                                : "text-muted-foreground",
+                            )}
+                          />
+                        ) : null}
+                        <span className="truncate">{tab.label}</span>
+                      </button>
+                    );
+                  })}
+                </div>
+              </div>
+            ))}
           </nav>
         )}
       </div>