@cosmoops/connect-sdk 0.6.0 → 0.9.0

package/dist/types/client/components/ai-format.d.ts

@@ -0,0 +1,24 @@
+import type { AiValue, AiValueFormat } from "../../types.js";
+/**
+ * The one place a model-supplied value becomes a string.
+ *
+ * Ask AI's presentation tools send raw values with a `format` tag beside them
+ * rather than pre-formatted strings (see `AiValueFormat`), and this is the half
+ * that makes that worth doing: an amount renders in the viewer's own locale, a
+ * table sorts numerically, and the same figure reads identically on a chart
+ * axis, in a tooltip and in a metric tile.
+ *
+ * Every branch is total. A value that cannot be formatted the way it was
+ * tagged - a `date` that is not a date, a `currency` that is not a number -
+ * falls back to its plain string rather than throwing inside a render.
+ */
+/** Renders in place of a missing value - an em dash, not the word "null". */
+export declare const AI_EMPTY_VALUE = "\u2014";
+export declare function formatAiValue(value: AiValue, format?: AiValueFormat): string;
+/** Numeric columns read far better right-aligned; everything else stays with the text. */
+export declare function isNumericAiFormat(format?: AiValueFormat): boolean;
+export type AiStatusTone = "neutral" | "positive" | "warning" | "danger";
+export declare function aiStatusTone(value: AiValue): AiStatusTone;
+/** HeroUI semantic tokens only, so these inherit whatever theme the host defined. */
+export declare const AI_TONE_CHIP: Record<AiStatusTone, string>;
+export declare const AI_TONE_DOT: Record<AiStatusTone, string>;

package/dist/types/client/components/ai-widgets.d.ts

@@ -0,0 +1,42 @@
+import { type ReactNode } from "react";
+import type { AiChartInput, AiDetailsInput, AiMetricsInput, AiSourcesInput, AiStepsInput, AiTableInput, AiTimelineInput } from "../../types.js";
+/**
+ * `showTable`. Sorting and CSV are what a table is *for* - once an answer is
+ * tabular the next thing anyone wants is to reorder it or take it elsewhere,
+ * and a markdown table can do neither. Both work off the raw values, so
+ * "₹12,500" sorts as 12500 and the export carries numbers a spreadsheet can add.
+ */
+export declare function AiTable({ title, columns, rows, caption }: Readonly<AiTableInput>): import("react").JSX.Element;
+/**
+ * `showChart`. Cartesian kinds are drawn as SVG against a fixed viewBox and
+ * scaled by the browser, which is why there is no resize observer here: the
+ * chart is resolution-independent, so "responsive" costs nothing at runtime.
+ *
+ * `pie` is deliberately *not* a pie. In a 400px column a pie plus its legend
+ * is smaller than the labels it needs, and reading angles is worse than
+ * reading lengths at any size - so proportions render as a labelled bar list,
+ * which answers the same question and stays legible.
+ */
+export declare function AiChart({ title, kind, xLabel, yLabel, valueFormat, series, caption }: Readonly<AiChartInput>): import("react").JSX.Element;
+/**
+ * `showMetrics`. A delta is coloured by `deltaMeaning`, not by its sign -
+ * churn rising is bad and revenue rising is good, and painting both green
+ * because the arrow points up is exactly the confidently-wrong signal a
+ * dashboard must never send. The arrow still shows direction, so meaning and
+ * direction stay two separate channels.
+ */
+export declare function AiMetrics({ title, metrics }: Readonly<AiMetricsInput>): import("react").JSX.Element;
+/** `showTimeline`: dated events, oldest first, on a single rail. */
+export declare function AiTimeline({ title, events }: Readonly<AiTimelineInput>): import("react").JSX.Element;
+/** `showDetails`: one entity's fields, as a definition list rather than a one-row table. */
+export declare function AiDetails({ title, fields }: Readonly<AiDetailsInput>): import("react").JSX.Element;
+/** `showSteps`: an ordered procedure. `renderDetail` is how the panel feeds each step back through its markdown renderer. */
+export declare function AiSteps({ title, steps, renderDetail, }: Readonly<AiStepsInput & {
+    renderDetail?: (markdown: string) => ReactNode;
+}>): import("react").JSX.Element;
+/**
+ * `showSources`: what a grounded answer actually rested on. The point of a
+ * citation is that it can be opened, so a source with a `uri` is a link and one
+ * without is still a named row - never a marker with nothing behind it.
+ */
+export declare function AiSources({ sources }: Readonly<AiSourcesInput>): import("react").JSX.Element;

package/dist/types/client/components/app-shell.d.ts

@@ -1,10 +1,11 @@
 import { type ReactNode } from "react";
+import { type ConnectAskAiProps } from "./ask-ai.js";
 import { type ConnectLinkRenderer, type ConnectNav } from "./nav.js";
 import type { ThemeMode } from "../../types.js";
-export interface ConnectAppShellProps {
-    /** This service's name, in the `cosmo·ops VOICE` lockup. See `ConnectLogo`. */
+export interface AppShellProps {
+    /** This application's name, in the `cosmo·ops VOICE` lockup. See `ConnectLogo`. */
     name: string;
-    /** This service's glyph, drawn on the CosmoOps badge. Falls back to the Connect rings. */
+    /** This application's glyph, drawn on the CosmoOps badge. Falls back to the Connect rings. */
     icon?: ReactNode;
     /** Where the lockup links. Defaults to `/`. */
     homeHref?: string;
@@ -61,18 +62,33 @@ export interface ConnectAppShellProps {
      * say. Prefix-matched, same as the nav's active resolution.
      */
     gateExemptRoutes?: string[];
+    /**
+     * Mount `ConnectAskAi` - a chat panel grounded in the signed-in workspace's
+     * Context Index, streamed through your own bridge. Pass an object to
+     * override its heading, copy or markdown plugins.
+     *
+     * **On by default**, like `gate`, and for the same reason: a family of
+     * application platforms should answer questions the same way, and a feature
+     * every partner has to remember to switch on is a feature most of them do
+     * not have. It stays inert until it can actually work - the trigger renders
+     * nothing for a signed-out visitor, and a workspace whose Context Index is
+     * off gets a message in the panel rather than a broken answer.
+     *
+     * Set `false` for an application that should not offer it at all.
+     */
+    askAi?: boolean | ConnectAskAiProps;
     className?: string;
     /** Classes on the scrolling content pane - override the default max-width and padding here. */
     contentClassName?: string;
     children: ReactNode;
 }
 /**
- * The application frame every CosmoOps service platform runs inside: a
+ * The application frame every CosmoOps application platform runs inside: a
  * collapsible sidebar, a top bar carrying the app launcher and the account
  * menu, and your pages in the middle.
  *
  * This is the piece each partner was otherwise writing by hand, and writing
- * slightly differently - which is how a family of services stops looking like
+ * slightly differently - which is how a family of applications stops looking like
  * one product. Everything that should be identical across platforms (the
  * lockup, the rail geometry, the active-route treatment, the launcher, the
  * account menu, the access gate) lives here; everything that genuinely
@@ -82,12 +98,12 @@ export interface ConnectAppShellProps {
  * "use client";
  * import Link from "next/link";
  * import { usePathname } from "next/navigation";
- * import { ConnectAppShell } from "@cosmoops/connect-sdk/client";
+ * import { AppShell } from "@cosmoops/connect-sdk/client";
  * import { LayoutDashboard, Truck } from "lucide-react";
  *
  * export function Shell({ children }: { children: React.ReactNode }) {
  *   return (
- *     <ConnectAppShell
+ *     <AppShell
  *       name="Dispatch"
  *       icon={<Truck />}
  *       activePath={usePathname()}
@@ -98,7 +114,7 @@ export interface ConnectAppShellProps {
  *       ]}
  *     >
  *       {children}
- *     </ConnectAppShell>
+ *     </AppShell>
  *   );
  * }
  * ```
@@ -112,4 +128,4 @@ export interface ConnectAppShellProps {
  * so a page with a shell, a plan table and a usage meter still makes one
  * session read.
  */
-export declare function ConnectAppShell({ name, icon, homeHref, nav, activePath, renderLink, title, headerActions, sidebarFooter, footer, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, collapsible, showAppsGrid, showAuthButtons, theme, onThemeChange, gate, gateExemptRoutes, className, contentClassName, children, }: ConnectAppShellProps): import("react").JSX.Element;
+export declare function AppShell({ name, icon, homeHref, nav, activePath, renderLink, title, headerActions, sidebarFooter, footer, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, collapsible, showAppsGrid, showAuthButtons, theme, onThemeChange, gate, gateExemptRoutes, askAi, className, contentClassName, children, }: AppShellProps): import("react").JSX.Element;

package/dist/types/client/components/apps-grid.d.ts

@@ -6,7 +6,7 @@ export interface ConnectAppsGridProps {
 }
 /**
  * The Google-style app launcher: a grid icon in your top bar that opens a
- * modal of every Connect service this organization can actually open.
+ * modal of every Connect application this workspace can actually open.
  *
  * Only launchable apps appear, so no tile is a dead end - a paused
  * subscription still shows, badged, because a dunning cycle should not make a

package/dist/types/client/components/ask-ai.d.ts

@@ -0,0 +1,73 @@
+import { type StreamdownProps } from "streamdown";
+export interface ConnectAskAiProps {
+    /** Panel heading. Defaults to `"Ask AI"`. */
+    title?: string;
+    /** Byline over each assistant turn. Defaults to `"Assistant"`. */
+    assistantName?: string;
+    /** Composer placeholder. */
+    placeholder?: string;
+    /** Shown once, above an empty conversation. */
+    hint?: string;
+    /** Start open. The panel owns its state after that. */
+    defaultOpen?: boolean;
+    /**
+     * Streamdown plugins - syntax highlighting, KaTeX, Mermaid, CJK.
+     *
+     * Off unless you pass them, because each is a package of its own and several
+     * are large (Mermaid alone dwarfs this SDK). Prose, GFM tables, task lists
+     * and plain code fences all render without any of them.
+     *
+     * ```tsx
+     * import { code } from "@streamdown/code";
+     * import { mermaid } from "@streamdown/mermaid";
+     *
+     * <ConnectAskAi markdownPlugins={{ code, mermaid }} />
+     * ```
+     *
+     * Hoist the object to module scope: Streamdown compares this prop by
+     * reference, so an inline literal defeats its block memoisation.
+     */
+    markdownPlugins?: StreamdownProps["plugins"];
+}
+/**
+ * Ask AI - a chat panel grounded in the signed-in workspace's Context Index,
+ * streamed through your own bridge.
+ *
+ * Answers are not only prose. Connect's model can call a small set of
+ * presentation tools - `showTable`, `showChart`, `showMetrics`, `showTimeline`,
+ * `showDetails`, `showSteps`, `showSources` - and this panel renders each one
+ * natively: a sortable table with a CSV download, a chart, a row of metric
+ * tiles. Values arrive raw with a format tag, so they are formatted here rather
+ * than by the model, which is what lets a column sort numerically.
+ *
+ * Nothing here holds a credential: it POSTs to `${basePath}/ai/chat` on your
+ * own origin, and `createConnectHandler` is what reaches Connect. The workspace
+ * is resolved from the caller's session there, never sent from the browser - so
+ * a user can only ever ask about the workspace they are signed into.
+ *
+ * ```tsx
+ * <AppShell name="Dispatch" nav={nav}>
+ *   {children}
+ * </AppShell>
+ * ```
+ *
+ * `AppShell` mounts it by default. Mount it directly only when you are not
+ * using the shell: it renders a fixed corner trigger plus a panel that is an
+ * *in-flow flex sibling* at `lg` and up, so opening it pushes your content
+ * aside rather than covering it. That requires it to be the last child of a
+ * `flex` row owning the viewport height - which is exactly what `AppShell` is.
+ * Below `lg` it is a full-screen sheet with a backdrop instead; there is no
+ * room to push anything on a phone.
+ *
+ * **Host setup:** markdown rendering needs `streamdown` installed, one Tailwind
+ * `@source "…/node_modules/streamdown/dist/*.js"` line so its utility classes
+ * are generated, and `import "streamdown/styles.css"` for the streaming
+ * animation. The colour tokens Streamdown expects are already mapped in this
+ * SDK's `theme.css`.
+ *
+ * Answers require the workspace's Context Index to be turned on (a workspace
+ * admin toggle in Connect) and your API key to carry the `ai:chat` scope.
+ * Neither is something the browser can discover, so both surface as a message
+ * in the panel rather than as a hidden button.
+ */
+export declare function ConnectAskAi({ title, assistantName, placeholder, hint, defaultOpen, markdownPlugins, }: ConnectAskAiProps): import("react").JSX.Element | null;

package/dist/types/client/components/feature-gate.d.ts

@@ -48,7 +48,7 @@ export interface ConnectFeatureGateProps {
  *
  * Like every gate in this package, it is a **UX gate, not a security
  * boundary**: the entitlement is read through your own origin and the browser
- * can ignore it. Check `client.entitlements.hasFeature(orgId, feature)` on the
+ * can ignore it. Check `client.entitlements.hasFeature(workspaceId, feature)` on the
  * server before doing the thing the feature unlocks.
  *
  * Renders `loading` - not `fallback` - while the answer is unknown, so a paying

package/dist/types/client/components/integrations-modal.d.ts

@@ -5,7 +5,7 @@ export interface ConnectIntegrationsModalProps {
     label?: string;
 }
 /**
- * A grid of every Composio-hosted toolkit this organization can connect -
+ * A grid of every Composio-hosted toolkit this workspace can connect -
  * Google Calendar, Slack, Twitter/X, whatever a platform admin enabled in
  * Connect's own Console. Each tile carries its own connect/reconnect/
  * disconnect action and its own pending state, independent of every other

package/dist/types/client/components/logo.d.ts

@@ -1,12 +1,12 @@
 import type { ReactNode } from "react";
 export interface ConnectLogoProps {
     /**
-     * This service's name - rendered as the sub-brand beneath the `cosmo·ops`
+     * This application's name - rendered as the sub-brand beneath the `cosmo·ops`
      * wordmark, in the house `cosmo·ops VOICE` treatment.
      */
     name: string;
     /**
-     * This service's own glyph, drawn inside the accent badge. Any node - a
+     * This application's own glyph, drawn inside the accent badge. Any node - a
      * `lucide-react` icon, an `<img>`, an inline `<svg>`. Paint it with
      * `currentColor` and it inherits `--accent-foreground` from the badge, so it
      * stays legible when a host app changes the accent.
@@ -19,10 +19,10 @@ export interface ConnectLogoProps {
     className?: string;
 }
 /**
- * The shared platform lockup: a service's own glyph on the CosmoOps badge,
- * `cosmo·ops` beside it, and the service name underneath.
+ * The shared platform lockup: an application's own glyph on the CosmoOps badge,
+ * `cosmo·ops` beside it, and the application name underneath.
  *
- * This is what makes a family of service platforms look like one product. Each
+ * This is what makes a family of application platforms look like one product. Each
  * platform passes only what differs - its `name` and its `icon` - and inherits
  * the mark geometry, the wordmark treatment, the separator, and the accent from
  * one place. Change the lockup here and every platform follows.

package/dist/types/client/components/nav.d.ts

@@ -28,7 +28,7 @@ export interface ConnectNavItem {
     items?: ConnectNavItem[];
     /**
      * Leave this route *outside* `ConnectAccessGate` - see
-     * `ConnectAppShellProps.gate`. Declared here, next to the route it applies
+     * `AppShellProps.gate`. Declared here, next to the route it applies
      * to, rather than as a second list somewhere else that has to be kept in
      * step with this one.
      */
@@ -40,7 +40,7 @@ export interface ConnectNavSection {
     items: ConnectNavItem[];
 }
 /**
- * What `ConnectAppShell`/`ConnectSideNav` accept for `nav`: a flat list of
+ * What `AppShell`/`ConnectSideNav` accept for `nav`: a flat list of
  * items, a list of sections, or a mix. Consecutive bare items fold into one
  * untitled section, so the common case is just an array of items.
  */
@@ -106,5 +106,5 @@ export declare function resolveActivePath(pathname: string, nav: ConnectNav): st
  * lights up on every app's home route. External items are never active.
  */
 export declare function isNavItemActive(item: ConnectNavItem, activeHref: string | null): boolean;
-/** Hrefs declared `gateExempt` - the routes `ConnectAppShell` renders outside its `ConnectAccessGate`. */
+/** Hrefs declared `gateExempt` - the routes `AppShell` renders outside its `ConnectAccessGate`. */
 export declare function gateExemptPaths(nav: ConnectNav): string[];

package/dist/types/client/components/plan-pricing.d.ts

@@ -4,7 +4,7 @@
  * an upgrade while the card behind it said downgrade would be worse than
  * either label being wrong on its own.
  *
- * Mirrors `packages/data/src/services/catalog.ts` and
+ * Mirrors `packages/data/src/applications/catalog.ts` and
  * `packages/data/src/payments/plan-change.ts`, which are the copies Connect's
  * own UI uses and which decide which use-case actually runs. The duplication
  * is deliberate and load-bearing: this package carries no dependency on
@@ -81,7 +81,7 @@ export declare function groupPlansByTier(plans: readonly Plan[]): PlanTier[];
  */
 export declare function annualSaving(monthly: Plan | null | undefined, annual: Plan | null | undefined): number | null;
 /**
- * What moving to `plan` would be, given what the org is on today.
+ * What moving to `plan` would be, given what the workspace is on today.
  *
  * `switch-to-annual`/`switch-to-monthly` exist because a change of *cadence*
  * is neither an upgrade nor a downgrade, and calling it one is not a wording

package/dist/types/client/components/readiness.d.ts

@@ -6,7 +6,7 @@ export interface ConnectReadinessBannerProps {
     className?: string;
 }
 /**
- * Every gate between this workspace and your service, with the way out of each.
+ * Every gate between this workspace and your application, with the way out of each.
  *
  * This is the component that keeps a blocked customer from staring at a broken
  * app. `getReadiness` resolves subscription state, KYC/KYB, a chargeable
@@ -14,7 +14,7 @@ export interface ConnectReadinessBannerProps {
  * `resolveUrl` into the exact Connect screen that fixes it** - so being blocked
  * comes with somewhere to go rather than a refusal.
  *
- * Render it high on any page your service gates. It draws nothing at all when
+ * Render it high on any page your application gates. It draws nothing at all when
  * the workspace is ready, so it is safe to leave mounted permanently.
  *
  * Two deliberate refusals:

package/dist/types/client/components/side-nav.d.ts

@@ -23,7 +23,7 @@ export interface ConnectSideNavProps {
  * The sidebar's nav column on its own - sections, items, one level of
  * children, and the active highlight.
  *
- * `ConnectAppShell` renders this inside its rail and its mobile drawer, and it
+ * `AppShell` renders this inside its rail and its mobile drawer, and it
  * is exported for a host that wants the shell's navigation without its
  * chrome: the same items, the same active resolution, dropped into a layout
  * you already have.

package/dist/types/client/components/subscribe-dialog.d.ts

@@ -5,11 +5,11 @@ export interface ConnectSubscribeDialogProps {
     plan: Plan | null;
     /** Which of subscribe / upgrade / downgrade this is - decides the headline and what the notice says about money. */
     action: PlanAction;
-    /** The org's live subscription, for the "from" side of a plan change. */
+    /** The workspace's live subscription, for the "from" side of a plan change. */
     current: SubscriptionResponse | null;
     /** Coupon typed into the plan grid, echoed here so it is visible before the hand-off carries it. */
     coupon?: string;
-    /** Whether this org's `plan.trialDays` still applies is Connect's call, not this component's - see the notice below. */
+    /** Whether this workspace's `plan.trialDays` still applies is Connect's call, not this component's - see the notice below. */
     onClose(): void;
     onConfirm(): void;
 }
@@ -26,7 +26,7 @@ export interface ConnectSubscribeDialogProps {
  * The authoritative price is computed by Connect against the real cart:
  * proration is priced against the actual cycle, a coupon is validated
  * against the plan it is being applied to, trial eligibility depends on
- * whether this organization has ever subscribed to this service before, and
+ * whether this workspace has ever subscribed to this application before, and
  * an accumulated credit is deducted. None of that is knowable from the
  * partner's origin, so this component states the list price and says where
  * the final figure comes from rather than quietly guessing at one.

package/dist/types/client/components/usage-meter.d.ts

@@ -11,7 +11,7 @@ export interface ConnectUsageMeterProps {
  *
  * Reads the balance Connect actually debits, so the number here and the number
  * `consumeAddon` enforces cannot disagree. Before the `addons:read` endpoint
- * existed this component was impossible to write honestly: a service could
+ * existed this component was impossible to write honestly: an application could
  * spend an allowance down on every request and the only thing the API exposed
  * was the list of add-on *ids* on the subscription.
  *

package/dist/types/client/components/user-menu.d.ts

@@ -26,7 +26,7 @@ export interface ConnectUserMenuProps {
  * in place, which is why it sits alone in the footer rather than as a fourth
  * item in the same list as three navigations.
  *
- * The session list is account-wide, not scoped to this service - see
+ * The session list is account-wide, not scoped to this application - see
  * `ConnectUserSession`'s doc comment in `types.ts`. Appearance only renders
  * when both `theme` and `onThemeChange` are supplied.
  *
@@ -55,7 +55,7 @@ export declare function ConnectManageSubscriptionButton({ className }: Readonly<
  * Invoices and payment history, on Connect.
  *
  * A deep link rather than a component that lists them, and that is not a
- * placeholder: nothing in `/api/v1/service/*` exposes invoices, so an SDK-side
+ * placeholder: nothing in `/api/v1/application/*` exposes invoices, so an SDK-side
  * list would have nothing to read. It is also the right answer regardless -
  * a GST tax invoice is a legal document with a fixed format, downloadable and
  * emailed from one place, and a partner-rendered copy of one would be a second
@@ -70,7 +70,8 @@ export declare function ConnectInvoicesButton({ className }: Readonly<{
  * `ConnectHomeButton`.
  *
  * It was reachable only from inside `ConnectUserMenu`, which meant an app that
- * builds its own account menu had to hardcode `${appUrl}/profile` to offer it.
+ * builds its own account menu had to hardcode `${appUrl}/profile` to offer it -
+ * and got no `return_to`, so the user had no way back.
  */
 export declare function ConnectProfileButton({ className }: Readonly<{
     className?: string;

package/dist/types/client/components/workspace-type-gate.d.ts

@@ -0,0 +1,48 @@
+import type { ReactNode } from "react";
+import type { WorkspaceType } from "../../types.js";
+export interface ConnectWorkspaceTypeGateProps {
+    /**
+     * The workspace type this subtree is for. Pass an array to accept either -
+     * which is the same as not using the gate at all, so it exists only to keep
+     * a `type={someVariable}` call site from having to special-case "both".
+     */
+    type: WorkspaceType | WorkspaceType[];
+    children: ReactNode;
+    /**
+     * Rendered for a workspace of the other type. Defaults to `null` - hiding
+     * the subtree, which is what this gate is normally for.
+     */
+    fallback?: ReactNode;
+    /** Shown until the session read settles. Defaults to nothing. */
+    loading?: ReactNode;
+}
+/**
+ * Renders `children` only for a workspace of the given type.
+ *
+ * ```tsx
+ * <ConnectWorkspaceTypeGate type="business">
+ *   <TeamMembersTable />
+ * </ConnectWorkspaceTypeGate>
+ * ```
+ *
+ * The point is dead controls, not access: an `"individual"` workspace has
+ * exactly one seat and can never have another, so a members table, an invite
+ * button and a seat meter are all things that can only ever fail there.
+ * Hiding them is a better answer than letting someone press one and read an
+ * error about an account shape they did not choose.
+ *
+ * This is emphatically **not** the audience gate. It does not know what your
+ * application is sold to and will happily render a business-only subtree to a
+ * business workspace that has no business being in your application at all -
+ * that is `<ConnectAccessGate>`'s job, off the `audience_mismatch` readiness
+ * blocker. Use this one *inside* an application both audiences can reach, to
+ * vary what each sees.
+ *
+ * Like every gate in this package it is a **UX gate, not a security
+ * boundary**: the browser can ignore it. Anything that must not happen for an
+ * individual workspace has to be refused on your server too.
+ *
+ * Renders `loading` - not `fallback` - while the session is unknown, so a
+ * business account never flickers through the individual-account layout.
+ */
+export declare function ConnectWorkspaceTypeGate({ type, children, fallback, loading, }: ConnectWorkspaceTypeGateProps): import("react").JSX.Element;

package/dist/types/client/index.d.ts

@@ -7,10 +7,10 @@
  *
  * Styling is HeroUI v3 semantic tokens only (`accent`, `muted`, `surface`,
  * `separator`, ...), never a hardcoded colour - so these components inherit
- * whatever theme the host service platform already configured, and one theme
+ * whatever theme the host application platform already configured, and one theme
  * change lands identically in all of them.
  */
-export { ConnectProvider, useConnect, useConnectUser, useConnectEntitlements, useConnectPlans, useConnectApps, useConnectAddonUsage, useConnectSessions, useConnectIntegrations, useConnectResource, CONNECT_APP_URL, } from "./provider.js";
+export { ConnectProvider, useConnect, useConnectUser, useConnectWorkspaceType, useConnectAudience, useConnectEntitlements, useConnectPlans, useConnectApps, useConnectAddonUsage, useConnectSessions, useConnectIntegrations, useConnectResource, CONNECT_APP_URL, } from "./provider.js";
 export type { ConnectProviderProps, ConnectContextValue, ConnectSession } from "./provider.js";
 export { blockingBlockers, normalizePlanFeatures } from "../helpers.js";
 export type { WirePlanFeature } from "../helpers.js";
@@ -25,8 +25,8 @@ export { ConnectUserMenu, ConnectManageSubscriptionButton, ConnectInvoicesButton
 export { ConnectAccountSessions } from "./components/account-sessions.js";
 export type { ConnectAccountSessionsProps } from "./components/account-sessions.js";
 export type { ConnectUserMenuProps } from "./components/user-menu.js";
-export { ConnectAppShell } from "./components/app-shell.js";
-export type { ConnectAppShellProps } from "./components/app-shell.js";
+export { AppShell } from "./components/app-shell.js";
+export type { AppShellProps } from "./components/app-shell.js";
 export { ConnectSideNav } from "./components/side-nav.js";
 export type { ConnectSideNavProps } from "./components/side-nav.js";
 export { useActivePath } from "./use-active-path.js";
@@ -34,6 +34,11 @@ export { normalizeNav, flattenNav, normalizePath, resolveActivePath, isNavItemAc
 export type { ConnectNav, ConnectNavItem, ConnectNavSection, ConnectNavLinkProps, ConnectLinkRenderer, } from "./components/nav.js";
 export { ConnectAppsGrid } from "./components/apps-grid.js";
 export type { ConnectAppsGridProps } from "./components/apps-grid.js";
+export { ConnectAskAi } from "./components/ask-ai.js";
+export type { ConnectAskAiProps } from "./components/ask-ai.js";
+export { AiTable, AiChart, AiMetrics, AiTimeline, AiDetails, AiSteps, AiSources, } from "./components/ai-widgets.js";
+export { formatAiValue, isNumericAiFormat, aiStatusTone, AI_EMPTY_VALUE, AI_TONE_CHIP, AI_TONE_DOT, } from "./components/ai-format.js";
+export type { AiStatusTone } from "./components/ai-format.js";
 export { ConnectIntegrationsModal } from "./components/integrations-modal.js";
 export type { ConnectIntegrationsModalProps } from "./components/integrations-modal.js";
 export { ConnectPlans } from "./components/plans.js";
@@ -48,6 +53,8 @@ export { ConnectAccessGate, useConnectAccessGate } from "./components/access-gat
 export type { ConnectAccessGateProps, ConnectAccessGateState, ConnectAccessGateResult, } from "./components/access-gate.js";
 export { ConnectFeatureGate, useConnectFeature } from "./components/feature-gate.js";
 export type { ConnectFeatureGateProps } from "./components/feature-gate.js";
+export { ConnectWorkspaceTypeGate } from "./components/workspace-type-gate.js";
+export type { ConnectWorkspaceTypeGateProps } from "./components/workspace-type-gate.js";
 export { ConnectUsageMeter } from "./components/usage-meter.js";
 export type { ConnectUsageMeterProps } from "./components/usage-meter.js";
 export { ConnectPlansPage } from "./components/plans-page.js";

package/dist/types/client/mark.d.ts

@@ -2,7 +2,7 @@
  * The Connect mark - concentric rings on a solid accent badge.
  *
  * Painted from `--accent` / `--accent-foreground`, the same HeroUI tokens the
- * host app themes, so the badge tracks whatever palette a service platform has
+ * host app themes, so the badge tracks whatever palette an application platform has
  * configured rather than carrying a hardcoded CosmoOps green into someone
  * else's brand.
  */

package/dist/types/client/provider.d.ts

@@ -1,10 +1,16 @@
 import type { ReactNode } from "react";
-import type { AddonUsageResponse, ConnectUser, IntegrationsListResponse, OrganizationApp, PlansResponse, ReadinessResponse, ServiceRole, SessionsListResponse, SessionSubscription, SubscriptionResponse } from "../types.js";
+import type { AddonUsageResponse, ConnectUser, IntegrationsListResponse, WorkspaceApp, PlansResponse, ReadinessResponse, ApplicationRole, SessionsListResponse, SessionSubscription, SessionAudience, SubscriptionResponse, WorkspaceType } from "../types.js";
 export declare const CONNECT_APP_URL = "https://connect.cosmoops.com";
 export interface ConnectSession {
     user: ConnectUser | null;
     subscription: SessionSubscription | null;
-    serviceRole: ServiceRole | null;
+    applicationRole: ApplicationRole | null;
+    /**
+     * `null` when signed out, for the same reason the three above are: there is
+     * no workspace to compare an audience against yet. Never `null` on a
+     * signed-in session.
+     */
+    audience: SessionAudience | null;
 }
 export interface ConnectContextValue {
     /**
@@ -58,10 +64,26 @@ export interface ConnectContextValue {
      * page.
      */
     invalidateResource(path: string): void;
+    /**
+     * POST through the bridge and hand back the raw `Response`, unread and
+     * uncached - the seam `<ConnectAskAi>` streams server-sent events over.
+     *
+     * Separate from `mutateResource` rather than a flag on it, because the two
+     * differ in every respect that matters: this one must not `await
+     * response.json()` (that buffers the whole stream and defeats the point),
+     * must not touch the resource cache (a conversation is not a resource), and
+     * takes an `AbortSignal` so a "Stop" button can actually stop generation.
+     *
+     * Throws on a non-2xx, having read the error envelope - which is safe,
+     * because a failure never has a stream behind it.
+     */
+    streamResource(path: string, body: unknown, options?: {
+        signal?: AbortSignal;
+    }): Promise<Response>;
 }
 export interface ConnectProviderProps {
     /**
-     * This service's public `client_id`, from its Integration tab in Connect.
+     * This application's public `client_id`, from its Integration tab in Connect.
      *
      * Not needed for the default sign-in flow: `signIn()` with no `redirectUri`
      * bounces the browser to your own `/signin` route, which already knows
@@ -128,6 +150,27 @@ export declare function ConnectProvider({ clientId, basePath, redirectUri, appUr
 export declare function useConnect(): ConnectContextValue;
 /** The signed-in user, or `null`. Sugar over `useConnect().session`. */
 export declare function useConnectUser(): ConnectUser | null;
+/**
+ * Whether the signed-in workspace is a one-seat personal account or a team -
+ * `null` while the session is loading or signed out.
+ *
+ * Branch on this to stop rendering team UI at a solo account: a members
+ * table, an invite button and a seat meter are all dead controls on an
+ * `"individual"` workspace, which has exactly one seat and cannot gain
+ * another. `<ConnectWorkspaceTypeGate>` is the declarative form.
+ */
+export declare function useConnectWorkspaceType(): WorkspaceType | null;
+/**
+ * Whether this account is the kind your application is sold to - `null` while
+ * the session is loading or signed out.
+ *
+ * `audience.matches === false` is a hard block, not a hint: readiness reports
+ * `audience_mismatch` and subscribing is refused. `<ConnectAccessGate>`
+ * already blocks the shell on it, so reach for this only when you need the
+ * verdict somewhere the gate does not run - a marketing page, say, or a
+ * sign-up CTA you would rather not show to an account that cannot complete it.
+ */
+export declare function useConnectAudience(): SessionAudience | null;
 /** Readiness gates and the live subscription, fetched on first use. */
 export declare function useConnectEntitlements(): {
     data: {
@@ -148,7 +191,7 @@ export declare function useConnectEntitlements(): {
 /**
  * What is left of every consumable add-on on this workspace's subscription.
  *
- * The read half of `client.billing.consumeAddon` - a service that meters its
+ * The read half of `client.billing.consumeAddon` - an application that meters its
  * own end users had no way to show them what remained until this existed.
  * Empty `addons` means there is nothing to meter, which is not an error.
  */
@@ -165,7 +208,7 @@ export declare function useConnectAddonUsage(): {
      */
     refetch(): void;
 };
-/** This service's plan catalog. */
+/** This application's plan catalog. */
 export declare function useConnectPlans(): {
     data: PlansResponse | null;
     isLoading: boolean;
@@ -179,10 +222,10 @@ export declare function useConnectPlans(): {
      */
     refetch(): void;
 };
-/** The apps this organization can open. */
+/** The apps this workspace can open. */
 export declare function useConnectApps(): {
     data: {
-        apps: OrganizationApp[];
+        apps: WorkspaceApp[];
     } | null;
     isLoading: boolean;
     error: string | null;
@@ -195,7 +238,7 @@ export declare function useConnectApps(): {
      */
     refetch(): void;
 };
-/** Enabled Composio-hosted toolkits and this organization's connection status for each. */
+/** Enabled Composio-hosted toolkits and this workspace's connection status for each. */
 export declare function useConnectIntegrations(): {
     data: IntegrationsListResponse | null;
     isLoading: boolean;
@@ -211,7 +254,7 @@ export declare function useConnectIntegrations(): {
 };
 /**
  * This Connect account's own login sessions - account-wide, not scoped to
- * this service, see `SessionsListResponse`'s doc comment. The component
+ * this application, see `SessionsListResponse`'s doc comment. The component
  * that calls this is also the one that must own any revoke actions and call
  * the returned `refetch()` afterward - see `mutateResource`'s doc comment
  * for why nothing does that automatically.