@cosmoops/connect-sdk 0.7.0 → 0.9.0

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

@@ -1,7 +1,8 @@
 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 {
+export interface AppShellProps {
     /** This application's name, in the `cosmo·ops VOICE` lockup. See `ConnectLogo`. */
     name: string;
     /** This application's glyph, drawn on the CosmoOps badge. Falls back to the Connect rings. */
@@ -61,6 +62,21 @@ 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;
@@ -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/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/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/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/user-menu.d.ts

@@ -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

@@ -10,7 +10,7 @@
  * 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/provider.d.ts

@@ -1,10 +1,16 @@
 import type { ReactNode } from "react";
-import type { AddonUsageResponse, ConnectUser, IntegrationsListResponse, WorkspaceApp, PlansResponse, ReadinessResponse, ApplicationRole, 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;
     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,6 +64,22 @@ 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 {
     /**
@@ -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: {

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

@@ -86,4 +86,4 @@ export declare class ConnectClient {
     constructor(options: ConnectClientOptions);
 }
 /** Kept in step with `package.json` by `sdk.test.ts`. */
-export declare const SDK_VERSION = "0.7.0";
+export declare const SDK_VERSION = "0.9.0";

package/dist/types/server/http.d.ts

@@ -12,7 +12,12 @@ export interface RequestSpec {
     headers?: Record<string, string>;
     /** Bearer API key (default), or none - the `/sso/*` endpoints authenticate inside the form body instead. */
     auth?: "bearer" | "none";
-    /** Skip JSON parsing and hand back the raw `Response` - for streaming endpoints. */
+    /**
+     * Skip JSON parsing and hand back the raw `Response` - for streaming
+     * endpoints.
+     *
+     * Also stops `timeoutMs` from applying to the *body*: see `request`.
+     */
     raw?: boolean;
     signal?: AbortSignal;
 }

package/dist/types/server/resources/entitlements.d.ts

@@ -1,5 +1,5 @@
 import { type TransportOptions } from "../http.js";
-import type { ReadinessResponse, SubscriptionResponse } from "../../types.js";
+import type { ApplicationSubscriber, ReadinessResponse, SubscribersResponse, SubscriptionResponse } from "../../types.js";
 /**
  * The two checks worth making on every request: may this workspace be here at
  * all, and what is it paying for.
@@ -28,4 +28,36 @@ export declare class EntitlementsResource {
      * should not need a try/catch around it.
      */
     hasFeature(workspaceId: string, feature: string): Promise<boolean>;
+    /**
+     * One page of the workspaces subscribed to your application, newest first.
+     *
+     * The inverse of `getSubscription`, which asks about one workspace you
+     * already know. This asks who your subscribers *are* - what a partner
+     * dashboard, an MRR total or a churn report is built on.
+     *
+     * Rate-limited far more tightly than the per-workspace read (10/min per
+     * key, against 60): it walks your whole subscriber base and is a reporting
+     * call, not a per-request gate. Use `getSubscription` in a hot path.
+     *
+     * Your application is resolved from the API key, so there is no parameter
+     * for it and no way to ask about anyone else's.
+     */
+    listSubscribers(options?: {
+        status?: ApplicationSubscriber["status"];
+        /** Cursor from a previous page's `nextBefore`. */
+        before?: string;
+        /** 1..100, default 25. */
+        limit?: number;
+    }): Promise<SubscribersResponse>;
+    /**
+     * Every subscriber, paged through for you.
+     *
+     * An async generator rather than an array: a large subscriber base is
+     * exactly where an accidental full materialisation hurts, and `for await`
+     * reads the same as a loop over one page.
+     */
+    iterateSubscribers(options?: {
+        status?: ApplicationSubscriber["status"];
+        pageSize?: number;
+    }): AsyncGenerator<ApplicationSubscriber>;
 }

package/dist/types/types.d.ts

@@ -27,6 +27,54 @@ export interface ConnectUser {
     photoUrl: string | null;
     workspaceId: string;
     workspaceName: string;
+    /**
+     * Whether this is a one-seat personal account or a team.
+     *
+     * The one fact about the signed-in workspace you cannot look up yourself -
+     * the application API has no workspace read - so branch on it rather than
+     * inferring an account's shape from whether it happens to have a second
+     * member. An `"individual"` workspace has exactly one seat and can never
+     * have another, so a members table, an invite button or a seat-count meter
+     * is dead UI for it.
+     *
+     * Re-read it from `identity.getUser()`; do not cache it past the sign-in.
+     * An `"individual"` workspace can convert to `"business"` under a live
+     * session (the reverse never happens).
+     */
+    workspaceType: WorkspaceType;
+}
+export type WorkspaceType = "individual" | "business";
+export type ApplicationAudience = "b2b" | "b2c" | "both";
+/**
+ * Whether the signed-in workspace is inside your application's audience -
+ * returned alongside `user` by both `exchangeCode()` and `getUser()`.
+ *
+ * `user.workspaceType` answers what the account *is*; this answers what your
+ * application is *sold to*, and whether the two agree. Both ship together so
+ * the check stays `!audience.matches` rather than a hardcoded audience
+ * constant in your own code that goes stale the moment the catalogue entry
+ * changes.
+ *
+ * `matches: false` means readiness will report an `audience_mismatch` blocker
+ * and any attempt to subscribe will be refused, so treat it as a hard block:
+ * `<ConnectAccessGate>` already does. What it is NOT is a reason to sign the
+ * user out - they have a valid Connect account, just the wrong kind of one
+ * for this application.
+ */
+export interface SessionAudience {
+    /** Your catalogue entry's setting - `"both"` if you have never narrowed it. */
+    application: ApplicationAudience;
+    /** The single `workspaceType` `application` demands - `null` for `"both"`, which accepts either. */
+    requiredWorkspaceType: WorkspaceType | null;
+    /** `false` means this user is outside your audience. */
+    matches: boolean;
+    /**
+     * Whether Connect refuses the sign-in itself on a mismatch. When `true`,
+     * a `matches: false` can only reach you on a session minted before the
+     * setting was turned on. When `false`, gating is entirely yours to do -
+     * which is what `<ConnectAccessGate>` is for.
+     */
+    enforcedAtSignIn: boolean;
 }
 export type SubscriptionStatus = "created" | "authenticated" | "active" | "paused" | "cancelled";
 /** The compact subscription block returned alongside identity - `null` when the workspace has never subscribed to this application. */
@@ -58,11 +106,15 @@ export interface TokenResponse {
     user: ConnectUser;
     subscription: SessionSubscription | null;
     applicationRole: ApplicationRole;
+    /** Whether this account is the kind your application serves - see `SessionAudience`. */
+    audience: SessionAudience;
 }
 export interface UserResponse {
     user: ConnectUser;
     subscription: SessionSubscription | null;
     applicationRole: ApplicationRole;
+    /** Live, like `subscription` and `applicationRole` - a workspace that converted to a business since sign-in matches here without another sign-in. */
+    audience: SessionAudience;
     /** ISO 8601. Refresh proactively off this rather than waiting for a 401. */
     sessionExpiresAt: string;
 }
@@ -119,6 +171,8 @@ export interface ReadinessBlocker {
     resolveUrl: string | null;
     /** When this blocker resolves itself automatically - currently only set on `payment_retry_pending`, the deadline dunning suspends the subscription. `undefined`/`null` for every other code. */
     graceEndsAt?: string | null;
+    /** The account type this application requires - set only on `audience_mismatch`, `undefined`/`null` otherwise. Branch on this rather than reading it out of `message`. */
+    requiredWorkspaceType?: "individual" | "business" | null;
 }
 export interface ReadinessResponse {
     workspaceId: string;
@@ -261,6 +315,33 @@ export interface SubscriptionResponse {
     /** `null` exactly when `subscription` is. */
     plan: SubscribedPlan | null;
 }
+/** One row of `subscribers.list()` - a workspace subscribed to your application. */
+export interface ApplicationSubscriber {
+    subscriptionId: string;
+    workspaceId: string;
+    /** `null` when the workspace has been purged and only its tombstone remains. */
+    workspaceName: string | null;
+    /** `"active"`, `"suspended"`, `"pending_deletion"`, `"deleted"` - or `null` alongside a null `workspaceName`. */
+    workspaceStatus: string | null;
+    planId: string;
+    /** `null` if the plan was hard-deleted rather than archived. */
+    planName: string | null;
+    status: "created" | "authenticated" | "active" | "paused" | "cancelled";
+    seatCount: number;
+    /** ISO 8601. */
+    subscribedAt: string;
+    /** ISO 8601, or `null` for a cancelled/paused subscription. */
+    nextBillingDate: string | null;
+}
+export interface SubscribersResponse {
+    items: ApplicationSubscriber[];
+    /**
+     * Pass back as `before` for the next page. `null` on the last page - which
+     * is the only reliable end-of-list signal, since a full page can still be
+     * the last one.
+     */
+    nextBefore: string | null;
+}
 /** One consumable add-on's remaining balance on a workspace's subscription. */
 export interface AddonUsage {
     addonId: string;
@@ -613,3 +694,96 @@ export interface ConnectWebhookEnvelope<T extends ConnectWebhookEventType = Conn
     apiVersion: string;
     data: ConnectWebhookEventMap[T];
 }
+/** How a scalar should be presented. See `AiValue` for what each one expects. */
+export type AiValueFormat = "text" | "number"
+/** A number in rupees - `12500`, not paise and not a formatted string. */
+ | "currency"
+/** A fraction - `0.42` renders as 42%. */
+ | "percent"
+/** An ISO 8601 date string. */
+ | "date"
+/** An ISO 8601 datetime string. */
+ | "datetime"
+/** A number of seconds. */
+ | "duration"
+/** A number of bytes. */
+ | "bytes"
+/** A short state word, drawn as a chip. */
+ | "status";
+export type AiTone = "neutral" | "positive" | "warning" | "danger";
+/** One cell. `null` is "no value" and renders as an em dash. */
+export type AiValue = string | number | null;
+export interface AiTableInput {
+    title?: string;
+    columns: {
+        label: string;
+        format: AiValueFormat;
+    }[];
+    /** Positional: one array per row, values in the same order as `columns`. */
+    rows: AiValue[][];
+    caption?: string;
+}
+export interface AiChartInput {
+    title?: string;
+    kind: "bar" | "line" | "area" | "pie";
+    xLabel?: string;
+    yLabel?: string;
+    valueFormat: AiValueFormat;
+    /** Every series shares the same x values, in the same order. */
+    series: {
+        name: string;
+        points: {
+            x: string;
+            y: number | null;
+        }[];
+    }[];
+    caption?: string;
+}
+export interface AiMetricsInput {
+    title?: string;
+    metrics: {
+        label: string;
+        value: AiValue;
+        format: AiValueFormat;
+        /** Signed change against the previous period, as a fraction. */
+        delta?: number | null;
+        /** Whether a rise is good - churn is `"down-is-good"`. Colouring a delta by sign alone gets this wrong half the time. */
+        deltaMeaning: "up-is-good" | "down-is-good" | "neutral";
+        hint?: string;
+    }[];
+}
+export interface AiTimelineInput {
+    title?: string;
+    /** Oldest first. */
+    events: {
+        at: string;
+        title: string;
+        detail?: string;
+        tone: AiTone;
+    }[];
+}
+export interface AiDetailsInput {
+    title?: string;
+    fields: {
+        label: string;
+        value: AiValue;
+        format: AiValueFormat;
+        tone: AiTone;
+    }[];
+}
+export interface AiStepsInput {
+    title?: string;
+    steps: {
+        title: string;
+        detail?: string;
+    }[];
+}
+export interface AiSourcesInput {
+    sources: {
+        title: string;
+        uri?: string;
+        snippet?: string;
+    }[];
+}
+/** The tools this client knows how to draw. Anything else in the stream is ignored. */
+export type AiToolName = "showTable" | "showChart" | "showMetrics" | "showTimeline" | "showDetails" | "showSteps" | "showSources";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmoops/connect-sdk",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Official server-side SDK for the CosmoOps Connect platform API - Login with Connect, entitlements, billing and metering.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "commonjs",
@@ -73,6 +73,7 @@
     "build:storybook": "storybook build -o storybook-static"
   },
   "devDependencies": {
+    "@connect/ai": "workspace:*",
     "@connect/data": "workspace:*",
     "@heroui/react": "^3.2.2",
     "@heroui/styles": "^3.2.2",
@@ -87,6 +88,7 @@
     "react": "19.2.8",
     "react-dom": "19.2.8",
     "storybook": "^10.5.10",
+    "streamdown": "^2.5.0",
     "tailwindcss": "^4.3.3",
     "typedoc": "^0.28.20",
     "typedoc-plugin-markdown": "^4.12.0",
@@ -98,7 +100,8 @@
     "lucide-react": ">=0.400.0",
     "motion": ">=12",
     "react": ">=19",
-    "react-dom": ">=19"
+    "react-dom": ">=19",
+    "streamdown": ">=2.5.0"
   },
   "peerDependenciesMeta": {
     "@heroui/react": {
@@ -115,6 +118,9 @@
     },
     "react-dom": {
       "optional": true
+    },
+    "streamdown": {
+      "optional": true
     }
   }
 }