@arbidocs/blocks 0.4.2 → 0.4.4

package/README.md

@@ -92,6 +92,27 @@ import { PassagePill } from '@arbidocs/blocks/citations'
   through `testId` / `testIds`.
 - Parts are not polymorphic: `asChild` exists only where a part documents it.
 
+## Assistant chat page
+
+`ChatPage` (`@arbidocs/blocks/chat`) is a whole assistant chat: conversations with auto-titles, markdown
+answers, composer with a document chip and upload, empty, error and retry states, plus `header` and `aside`
+(workflow launcher) slots. It sizes to its container, so it holds up beside an open dock. Bind it with the
+`@arbidocs/react` hook:
+
+```tsx
+import { ChatPage, useChatSurface } from '@arbidocs/blocks/chat'
+import { useConnectedChat } from '@arbidocs/blocks/connect' // or useArbiChat({ workspaceId }) from @arbidocs/react
+
+const chat = useConnectedChat()
+<ChatPage chat={chat} header={<h2>Assistant</h2>} aside={<WorkflowLauncher … />} />
+
+// The dock yields to a mounted page chat:
+const { isDockAvailable } = useChatSurface()
+{isDockAvailable && <MyDock />}
+```
+
+Theme the user bubble with `--chat-user-bubble` and `--chat-user-bubble-foreground` (HSL triplets).
+
 ## Editorial site parts
 
 `@arbidocs/blocks/site` (and the root) carry the layout parts for static marketing pages:
@@ -114,6 +135,27 @@ import { EditorialHero, EditorialSection, PanelGrid, CtaBand } from '@arbidocs/b
 See `examples/custom-ui/MarketingPage.tsx` for a full page and `docs/design/blocks-package.md` for
 the part table.
 
+## Workspaces: gallery and switcher in a few lines
+
+```tsx
+import { WorkspaceGallery } from '@arbidocs/blocks/workspaces'
+import { WorkspaceSwitcher } from '@arbidocs/blocks'
+import { useConnectedShellWorkspaces } from '@arbidocs/blocks/connect'
+
+const { items, active, recent, open, openingId } = useConnectedShellWorkspaces({
+  seed: { workspaces: demoWorkspaces, activeId: 'demo-1' }, // host data, shown only if the account has none
+  onOpened: () => navigate('/app/documents'),                // runs after the workspace is selected
+})
+
+<WorkspaceSwitcher workspace={active} recent={recent} onSwitch={open} /* ... */ />
+<WorkspaceGallery workspaces={items} currentId={active?.id} openingId={openingId} onOpen={open} />
+```
+
+Clicking any card, the current one too, selects the workspace and then navigates. Without a
+connection layer use `useShellWorkspaces` from `@arbidocs/react` and pass your own list and `select`.
+Small helpers for host copy: `formatCount(1, { one: 'document', other: 'documents' })` and
+`displayName(user)` for greetings. See `examples/custom-ui/HomePage.tsx`.
+
 ## Workspace isolation
 
 Blocks hold no keys and do no crypto. Parts take the data of one workspace and never merge data

package/dist/agents/definitions/AgentCreator.d.ts

@@ -52,6 +52,8 @@ export interface AgentCreatorLabels {
     workspaceAccess: string;
     workspaceAccessHint: string;
     workspaceAlready: string;
+    /** Accessible name of the revoke button next to an already-granted workspace. */
+    revokeWorkspace: (workspaceName: string) => string;
     noWorkspacesToGrant: string;
     name: string;
     nameHint: string;
@@ -94,8 +96,15 @@ export interface AgentCreatorProps {
         id: string;
         name: string;
     }>;
-    /** Workspaces the agent can already read: shown ticked and fixed (revoking is not available). */
+    /**
+     * Workspaces the agent can already read: shown ticked and fixed. Without `onRevokeWorkspace`
+     * they cannot be undone here; with it each gets a remove button.
+     */
     grantedWorkspaceIds?: string[];
+    /** Take back a granted workspace (the host revokes, then refreshes `grantedWorkspaceIds`). */
+    onRevokeWorkspace?: (workspaceId: string) => void;
+    /** The workspace whose revoke is in flight; its button is disabled. */
+    revokingWorkspaceId?: string;
     /** One-click avatar (or anything that sits beside the name). */
     avatar?: ReactNode | ((values: AgentCreatorValues) => ReactNode);
     types?: AgentTypeOption<string>[];
@@ -115,4 +124,4 @@ export interface AgentCreatorProps {
  * capabilities, a live sentence says what the agent can and cannot do, and the knobs (capability
  * toggles, model, type, avatar, pickers) are folded under Advanced.
  */
-export declare function AgentCreator({ open, onOpenChange, isEdit, agentName, capabilities, templates, models, workspaces, grantedWorkspaceIds, avatar, types, values: valuesProp, initialValues, onValuesChange, advanced, isSaving, onSubmit, labels, testId, }: AgentCreatorProps): import("react").JSX.Element;
+export declare function AgentCreator({ open, onOpenChange, isEdit, agentName, capabilities, templates, models, workspaces, grantedWorkspaceIds, onRevokeWorkspace, revokingWorkspaceId, avatar, types, values: valuesProp, initialValues, onValuesChange, advanced, isSaving, onSubmit, labels, testId, }: AgentCreatorProps): import("react").JSX.Element;

package/dist/agents/definitions/index.d.ts

@@ -2,3 +2,4 @@ export { AgentCard, DEFAULT_AGENT_CARD_LABELS, type AgentCardProps, type AgentCa
 export { AgentGallery, DEFAULT_AGENT_GALLERY_LABELS, type AgentGalleryProps, type AgentGalleryLabels, type AgentGalleryTestIds, } from './AgentGallery';
 export { CapabilityTile, CapabilityGrid, AgentTypeSelector, AgentAvatarField, DEFAULT_AGENT_TYPE_SELECTOR_LABELS, DEFAULT_AGENT_AVATAR_FIELD_LABELS, type AgentTypeSelectorLabels, type AgentAvatarFieldLabels, type AgentAvatarFieldTestIds, type CapabilityTileProps, type AgentTypeOption, type AgentTypeSelectorProps, type AgentAvatarFieldProps, } from './AgentEditorParts';
 export { AgentCreator, DEFAULT_AGENT_CREATOR_LABELS, deriveAgentName, isValidAgentName, summarizeCapabilities, summarizeAgent, type AgentCreatorProps, type AgentCreatorLabels, type AgentCreatorValues, type AgentCapability, type AgentTemplate, } from './AgentCreator';
+export { composePersona, stripPersonaPreamble, agentCreatorToConfigSection, agentConfigSectionToValues, } from './persona';

package/dist/agents/definitions/persona.d.ts

@@ -0,0 +1,16 @@
+import type { AgentCreatorValues } from './AgentCreator';
+/**
+ * The saved persona tells the agent its own name: "You are Reviewer, an AI agent. <description>".
+ * {@link stripPersonaPreamble} takes the preamble off again so the editor shows only what the user wrote.
+ */
+export declare function composePersona(name: string, description: string): string;
+/** The description the user wrote, without the preamble {@link composePersona} adds. */
+export declare function stripPersonaPreamble(persona: string): string;
+/**
+ * The `Agents` config section an {@link AgentCreatorValues} form stands for: the persona, the model
+ * when one is picked, and one boolean per capability key. Pass it as `sections.Agents` to
+ * `useSaveAgentConfig` from `@arbidocs/react`.
+ */
+export declare function agentCreatorToConfigSection(values: Pick<AgentCreatorValues, 'name' | 'persona' | 'modelName' | 'capabilities'>, capabilityKeys: string[]): Record<string, unknown>;
+/** The form values an existing agent's `Agents` config section opens as (edit mode). */
+export declare function agentConfigSectionToValues(section: Record<string, unknown> | undefined, capabilityKeys: string[]): Pick<AgentCreatorValues, 'persona' | 'modelName' | 'capabilities'>;