@ai4b-team/fsaos-gateway-sdk 4.0.0 → 4.2.0

package/dist/index.d.cts

@@ -170,8 +170,16 @@ interface CreateParams {
     type_data?: Record<string, any>;
     [key: string]: unknown;
 }
+/**
+ * `type_data` MERGES at the top level: each key sent replaces that whole key,
+ * keys not sent are kept. `{ type_data: { ai_mode: 'strict' } }` changes the
+ * mode and nothing else; `{ type_data: { _remove_keys: ['x'] } }` deletes a
+ * key. A channel's `name` (its path) is governed and refused — change
+ * `type_data.display_name` instead.
+ */
 interface UpdateParams {
-    path: string;
+    path?: string;
+    id?: string;
     name?: string;
     type_data?: Record<string, any>;
     [key: string]: unknown;
@@ -191,6 +199,11 @@ interface LinkParams {
     target_id: string;
     edge_type?: string;
     weight?: number;
+    /**
+     * Edge context. For `has_member` (a seat on a chat or breakout) `context.role`
+     * is the member's ladder role on that chat — viewer, commenter, editor, admin
+     * or owner; absent reads as editor. There is no `metadata` field on an edge.
+     */
     context?: Record<string, any>;
     [key: string]: unknown;
 }
@@ -1185,7 +1198,14 @@ interface ChannelMessage {
     principal_id?: string;
     /** The sender's member item id, when the kernel recorded one (agent replies carry it). */
     member_id?: string;
+    /** Replies under this message. Above zero, a top-level message is a thread (a side conversation inside the chat). */
     reply_count: number;
+    /**
+     * Members of this message's own (has_member edges on the root). Above zero, the thread is a
+     * breakout: only those members (and the owners above it) read and post in it, and the kernel
+     * hides it from everyone else. Agent System Master Spec D21.
+     */
+    member_count: number;
     parent_message_id?: string;
     intent_card?: Record<string, unknown>;
     /** Full message metadata from type_data.metadata (launch cards, custom card payloads, etc.). */
@@ -2280,6 +2300,8 @@ declare function useChannelMessages(options: ChannelMessagesOptions): {
     /** Cards that are direct siblings of the channel (not nested under a message). */
     siblingCards: ChannelCard[];
     threads: ChannelMessage[];
+    /** Top-level messages with members of their own: breakouts (Agent System Master Spec D21). */
+    breakouts: ChannelMessage[];
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
@@ -2323,6 +2345,8 @@ declare function useInfiniteChannelMessages(options: InfiniteChannelMessagesOpti
     /** Cards that are direct siblings of the channel (not nested under a message). */
     siblingCards: ChannelCard[];
     threads: ChannelMessage[];
+    /** Top-level messages with members of their own: breakouts (Agent System Master Spec D21). */
+    breakouts: ChannelMessage[];
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
@@ -2835,6 +2859,177 @@ declare function useMintedAsset(params: {
     scopePath?: string | null;
 }): MintedAsset;
 
+/** The ladder: what a member may do in a scope or on a chat. */
+type MemberRole = 'viewer' | 'commenter' | 'editor' | 'admin' | 'owner';
+interface InviteMemberParams {
+    /** The person to invite. */
+    email: string;
+    /** The account (or space) they are invited into. */
+    target_scope_id: string;
+    /**
+     * Their standing in that scope — a ladder role, default `editor`. The kernel
+     * refuses `ROLE_ABOVE_INVITER` when it is above the inviter's own role.
+     */
+    role?: MemberRole;
+    [key: string]: unknown;
+}
+interface InviteMemberResult {
+    success: true;
+    /** The member item the invite minted — `pending` until the person accepts. */
+    member_id: string;
+    member_path?: string;
+    status: 'pending' | 'active';
+    role: MemberRole;
+    email: string;
+    /** `invited_to_scope` for an account, `invited_to_space` for a space. */
+    action: string;
+    /** True when the email already belongs to a principal (they are seated on accept all the same). */
+    principal_exists?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Invite a person into an account or space. Errors: `ROLE_ABOVE_INVITER`,
+ * `TARGET_SCOPE_NOT_FOUND`, `INVITE_TARGET_INVALID`.
+ */
+declare function inviteMember(params: InviteMemberParams): Promise<InviteMemberResult>;
+interface AcceptInviteParams {
+    /** The `member_id` the invite returned. */
+    member_id: string;
+    [key: string]: unknown;
+}
+interface AcceptInviteResult {
+    success: true;
+    action: 'accepted' | 'already_active';
+    member_id: string;
+    [key: string]: unknown;
+}
+/**
+ * Accept an invite as the signed-in person: the member item turns `active`
+ * and every seat already linked to it (see `seatMember`) opens at once —
+ * `can_do` on those chats is false before this call and true after it.
+ */
+declare function acceptInvite(params: AcceptInviteParams): Promise<AcceptInviteResult>;
+interface SeatMemberParams {
+    /** The chat (a channel) or the breakout (a thread root message) to seat them on. */
+    chat_id: string;
+    /** The member item: the invite's `member_id`, or any member of the account. */
+    member_id: string;
+    /**
+     * Their role on this one chat. Absent or off the ladder reads as `editor`.
+     * Separate from the invite's `role`, which is their standing in the account.
+     */
+    role?: MemberRole;
+}
+/**
+ * Seat a member on a chat: one `has_member` edge from the chat to the member
+ * item, the role in the edge context. Seat an invited member right after
+ * `inviteMember`; the seat shows on the roster as pending and opens on accept.
+ */
+declare function seatMember(params: SeatMemberParams): Promise<{
+    success: true;
+    edge_id: string;
+    [key: string]: unknown;
+}>;
+interface CreateAgentParams {
+    /** The agent's name, ≤80 characters. Its @handle is this, slugged, unique among your agents. */
+    display_name: string;
+    /** One line, ≤400 characters; rendered into its identity line. */
+    description?: string;
+    /**
+     * The path of a live `role` item the agent wears account-wide. It must
+     * already exist (`ROLE_NOT_FOUND` otherwise); nothing is created. Omit it
+     * for the declared user-default role.
+     */
+    role_path?: string;
+    /** Its face from the character registry. */
+    character?: {
+        character_id: string;
+        asset_version?: string;
+        configuration?: Record<string, unknown>;
+    };
+    /** Its face from an upload. */
+    upload?: {
+        upload_object_key: string;
+    };
+    /** One prompt block each, in the agent's own `instructions/`. */
+    instructions?: {
+        persona?: string;
+        purpose?: string;
+        responsibilities?: string;
+        examples?: string;
+    };
+    [key: string]: unknown;
+}
+interface CreateAgentResult {
+    success: true;
+    /** The agent's principal id — what `create-channel`'s `member_ids` takes. */
+    principal_id: string;
+    display_name: string;
+    /** The @handle people and agents mention it by. */
+    handle: string;
+    /** Its home member item in your account. */
+    member_id: string;
+    member_path: string;
+    account_id: string;
+    role_path: string;
+    instructions: Array<{
+        name: string;
+        id: string;
+        [key: string]: unknown;
+    }>;
+    /** The space seats it was given: every space its owner is seated in. */
+    seats: Array<{
+        [key: string]: unknown;
+    }>;
+    ms: number;
+}
+/**
+ * Make an agent of your own (one transaction: identity, home member item,
+ * instructions, account-wide role, seats). Only a person may call it. Errors:
+ * `DISPLAY_NAME_REQUIRED`, `DISPLAY_NAME_TOO_LONG`, `DESCRIPTION_TOO_LONG`,
+ * `INSTRUCTIONS_INVALID`, `OWNER_MUST_BE_A_PERSON`, `SCOPE_REQUIRED`,
+ * `ROLE_NOT_FOUND`.
+ *
+ * Creating an agent creates no chat. To talk to it, create one: `create-channel`
+ * with `member_ids: [principal_id]` births a DM (`auto_thread: false`) with you
+ * and the agent on the roster.
+ */
+declare function createAgent(params: CreateAgentParams): Promise<CreateAgentResult>;
+interface AnswerInputParams {
+    /** The step that is `awaiting_input`. */
+    step_id: string;
+    /** What the person answered, in their own words or the shape the request asked for. */
+    answer: unknown;
+    /** The id `await_input` returned (`step.type_data.input_request.request_id`) … */
+    input_request_id?: string;
+    /** … or the exact `input_request` object read from the step. One of the two is required. */
+    input_request?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Answer a step's input request. The kernel records the answer as
+ * `input_response`, returns the step to `pending` and wakes the assignee; the
+ * agent decides what to do next. Nothing mechanical reads the answer as yes
+ * or no. Errors: `TODO_INPUT_ID_REQUIRED`, `TODO_INPUT_CHANGED` (read the step again), `TODO_INPUT_ANSWER_REQUIRED`.
+ */
+declare function answerInput(params: AnswerInputParams): Promise<{
+    success: true;
+    [key: string]: unknown;
+}>;
+declare function useInviteMember(): _tanstack_react_query.UseMutationResult<InviteMemberResult, Error, InviteMemberParams, unknown>;
+declare function useAcceptInvite(): _tanstack_react_query.UseMutationResult<AcceptInviteResult, Error, AcceptInviteParams, unknown>;
+/** Seat a member on a chat; invalidates the edges of both ends (the roster reads them). */
+declare function useSeatMember(): _tanstack_react_query.UseMutationResult<{
+    [key: string]: unknown;
+    success: true;
+    edge_id: string;
+}, Error, SeatMemberParams, unknown>;
+declare function useCreateAgent(): _tanstack_react_query.UseMutationResult<CreateAgentResult, Error, CreateAgentParams, unknown>;
+declare function useAnswerInput(): _tanstack_react_query.UseMutationResult<{
+    [key: string]: unknown;
+    success: true;
+}, Error, AnswerInputParams, unknown>;
+
 /**
  * @fsaos/gateway — Schema Interpretation Utilities
  *
@@ -3456,4 +3651,4 @@ declare function usePersonalSections(contextId: string | null, collection: Secti
     contextKey: string;
 };
 
-export { type AccountInfo, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, CHANNEL_AI_MODES, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelAiMode, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayRequestOptions, type GatewayResponse, type IncrementalItemsOptions, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type LoadMountsOptions, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PersonalSection, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ReadPriority, type ReadTiming, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SectionChange, type SectionCollection, type SectionDestination, type SectionSnapshot, type SectionTarget, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type SwitcherAccount, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type VfsItemChange, type WorkCorrelation, type WorkspaceOptions, type WorkspaceSession, assignPersonalSection, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, configureGatewayReads, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, initializeWorkspace, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, loadMounts, mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, personalSectionsKey, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, replaceMounts, resetAllSdkState, resolvePrincipalId, resubscribePath, selectMount, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAccounts, useAgentTimeline, useAllChannels, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useIncrementalItems, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePersonalSections, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };
+export { type AcceptInviteParams, type AcceptInviteResult, type AccountInfo, type AnswerInputParams, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, CHANNEL_AI_MODES, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelAiMode, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateAgentParams, type CreateAgentResult, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayRequestOptions, type GatewayResponse, type IncrementalItemsOptions, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type InviteMemberParams, type InviteMemberResult, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type LoadMountsOptions, type MemberRole, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PersonalSection, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ReadPriority, type ReadTiming, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SeatMemberParams, type SectionChange, type SectionCollection, type SectionDestination, type SectionSnapshot, type SectionTarget, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type SwitcherAccount, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type VfsItemChange, type WorkCorrelation, type WorkspaceOptions, type WorkspaceSession, acceptInvite, answerInput, assignPersonalSection, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, configureGatewayReads, createAgent, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, initializeWorkspace, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, inviteMember, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, loadMounts, mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, personalSectionsKey, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, replaceMounts, resetAllSdkState, resolvePrincipalId, resubscribePath, seatMember, selectMount, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAcceptInvite, useAccounts, useAgentTimeline, useAllChannels, useAnswerInput, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useCreateAgent, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useIncrementalItems, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useInviteMember, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePersonalSections, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useSeatMember, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };

package/dist/index.d.ts

@@ -170,8 +170,16 @@ interface CreateParams {
     type_data?: Record<string, any>;
     [key: string]: unknown;
 }
+/**
+ * `type_data` MERGES at the top level: each key sent replaces that whole key,
+ * keys not sent are kept. `{ type_data: { ai_mode: 'strict' } }` changes the
+ * mode and nothing else; `{ type_data: { _remove_keys: ['x'] } }` deletes a
+ * key. A channel's `name` (its path) is governed and refused — change
+ * `type_data.display_name` instead.
+ */
 interface UpdateParams {
-    path: string;
+    path?: string;
+    id?: string;
     name?: string;
     type_data?: Record<string, any>;
     [key: string]: unknown;
@@ -191,6 +199,11 @@ interface LinkParams {
     target_id: string;
     edge_type?: string;
     weight?: number;
+    /**
+     * Edge context. For `has_member` (a seat on a chat or breakout) `context.role`
+     * is the member's ladder role on that chat — viewer, commenter, editor, admin
+     * or owner; absent reads as editor. There is no `metadata` field on an edge.
+     */
     context?: Record<string, any>;
     [key: string]: unknown;
 }
@@ -1185,7 +1198,14 @@ interface ChannelMessage {
     principal_id?: string;
     /** The sender's member item id, when the kernel recorded one (agent replies carry it). */
     member_id?: string;
+    /** Replies under this message. Above zero, a top-level message is a thread (a side conversation inside the chat). */
     reply_count: number;
+    /**
+     * Members of this message's own (has_member edges on the root). Above zero, the thread is a
+     * breakout: only those members (and the owners above it) read and post in it, and the kernel
+     * hides it from everyone else. Agent System Master Spec D21.
+     */
+    member_count: number;
     parent_message_id?: string;
     intent_card?: Record<string, unknown>;
     /** Full message metadata from type_data.metadata (launch cards, custom card payloads, etc.). */
@@ -2280,6 +2300,8 @@ declare function useChannelMessages(options: ChannelMessagesOptions): {
     /** Cards that are direct siblings of the channel (not nested under a message). */
     siblingCards: ChannelCard[];
     threads: ChannelMessage[];
+    /** Top-level messages with members of their own: breakouts (Agent System Master Spec D21). */
+    breakouts: ChannelMessage[];
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
@@ -2323,6 +2345,8 @@ declare function useInfiniteChannelMessages(options: InfiniteChannelMessagesOpti
     /** Cards that are direct siblings of the channel (not nested under a message). */
     siblingCards: ChannelCard[];
     threads: ChannelMessage[];
+    /** Top-level messages with members of their own: breakouts (Agent System Master Spec D21). */
+    breakouts: ChannelMessage[];
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
@@ -2835,6 +2859,177 @@ declare function useMintedAsset(params: {
     scopePath?: string | null;
 }): MintedAsset;
 
+/** The ladder: what a member may do in a scope or on a chat. */
+type MemberRole = 'viewer' | 'commenter' | 'editor' | 'admin' | 'owner';
+interface InviteMemberParams {
+    /** The person to invite. */
+    email: string;
+    /** The account (or space) they are invited into. */
+    target_scope_id: string;
+    /**
+     * Their standing in that scope — a ladder role, default `editor`. The kernel
+     * refuses `ROLE_ABOVE_INVITER` when it is above the inviter's own role.
+     */
+    role?: MemberRole;
+    [key: string]: unknown;
+}
+interface InviteMemberResult {
+    success: true;
+    /** The member item the invite minted — `pending` until the person accepts. */
+    member_id: string;
+    member_path?: string;
+    status: 'pending' | 'active';
+    role: MemberRole;
+    email: string;
+    /** `invited_to_scope` for an account, `invited_to_space` for a space. */
+    action: string;
+    /** True when the email already belongs to a principal (they are seated on accept all the same). */
+    principal_exists?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Invite a person into an account or space. Errors: `ROLE_ABOVE_INVITER`,
+ * `TARGET_SCOPE_NOT_FOUND`, `INVITE_TARGET_INVALID`.
+ */
+declare function inviteMember(params: InviteMemberParams): Promise<InviteMemberResult>;
+interface AcceptInviteParams {
+    /** The `member_id` the invite returned. */
+    member_id: string;
+    [key: string]: unknown;
+}
+interface AcceptInviteResult {
+    success: true;
+    action: 'accepted' | 'already_active';
+    member_id: string;
+    [key: string]: unknown;
+}
+/**
+ * Accept an invite as the signed-in person: the member item turns `active`
+ * and every seat already linked to it (see `seatMember`) opens at once —
+ * `can_do` on those chats is false before this call and true after it.
+ */
+declare function acceptInvite(params: AcceptInviteParams): Promise<AcceptInviteResult>;
+interface SeatMemberParams {
+    /** The chat (a channel) or the breakout (a thread root message) to seat them on. */
+    chat_id: string;
+    /** The member item: the invite's `member_id`, or any member of the account. */
+    member_id: string;
+    /**
+     * Their role on this one chat. Absent or off the ladder reads as `editor`.
+     * Separate from the invite's `role`, which is their standing in the account.
+     */
+    role?: MemberRole;
+}
+/**
+ * Seat a member on a chat: one `has_member` edge from the chat to the member
+ * item, the role in the edge context. Seat an invited member right after
+ * `inviteMember`; the seat shows on the roster as pending and opens on accept.
+ */
+declare function seatMember(params: SeatMemberParams): Promise<{
+    success: true;
+    edge_id: string;
+    [key: string]: unknown;
+}>;
+interface CreateAgentParams {
+    /** The agent's name, ≤80 characters. Its @handle is this, slugged, unique among your agents. */
+    display_name: string;
+    /** One line, ≤400 characters; rendered into its identity line. */
+    description?: string;
+    /**
+     * The path of a live `role` item the agent wears account-wide. It must
+     * already exist (`ROLE_NOT_FOUND` otherwise); nothing is created. Omit it
+     * for the declared user-default role.
+     */
+    role_path?: string;
+    /** Its face from the character registry. */
+    character?: {
+        character_id: string;
+        asset_version?: string;
+        configuration?: Record<string, unknown>;
+    };
+    /** Its face from an upload. */
+    upload?: {
+        upload_object_key: string;
+    };
+    /** One prompt block each, in the agent's own `instructions/`. */
+    instructions?: {
+        persona?: string;
+        purpose?: string;
+        responsibilities?: string;
+        examples?: string;
+    };
+    [key: string]: unknown;
+}
+interface CreateAgentResult {
+    success: true;
+    /** The agent's principal id — what `create-channel`'s `member_ids` takes. */
+    principal_id: string;
+    display_name: string;
+    /** The @handle people and agents mention it by. */
+    handle: string;
+    /** Its home member item in your account. */
+    member_id: string;
+    member_path: string;
+    account_id: string;
+    role_path: string;
+    instructions: Array<{
+        name: string;
+        id: string;
+        [key: string]: unknown;
+    }>;
+    /** The space seats it was given: every space its owner is seated in. */
+    seats: Array<{
+        [key: string]: unknown;
+    }>;
+    ms: number;
+}
+/**
+ * Make an agent of your own (one transaction: identity, home member item,
+ * instructions, account-wide role, seats). Only a person may call it. Errors:
+ * `DISPLAY_NAME_REQUIRED`, `DISPLAY_NAME_TOO_LONG`, `DESCRIPTION_TOO_LONG`,
+ * `INSTRUCTIONS_INVALID`, `OWNER_MUST_BE_A_PERSON`, `SCOPE_REQUIRED`,
+ * `ROLE_NOT_FOUND`.
+ *
+ * Creating an agent creates no chat. To talk to it, create one: `create-channel`
+ * with `member_ids: [principal_id]` births a DM (`auto_thread: false`) with you
+ * and the agent on the roster.
+ */
+declare function createAgent(params: CreateAgentParams): Promise<CreateAgentResult>;
+interface AnswerInputParams {
+    /** The step that is `awaiting_input`. */
+    step_id: string;
+    /** What the person answered, in their own words or the shape the request asked for. */
+    answer: unknown;
+    /** The id `await_input` returned (`step.type_data.input_request.request_id`) … */
+    input_request_id?: string;
+    /** … or the exact `input_request` object read from the step. One of the two is required. */
+    input_request?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+/**
+ * Answer a step's input request. The kernel records the answer as
+ * `input_response`, returns the step to `pending` and wakes the assignee; the
+ * agent decides what to do next. Nothing mechanical reads the answer as yes
+ * or no. Errors: `TODO_INPUT_ID_REQUIRED`, `TODO_INPUT_CHANGED` (read the step again), `TODO_INPUT_ANSWER_REQUIRED`.
+ */
+declare function answerInput(params: AnswerInputParams): Promise<{
+    success: true;
+    [key: string]: unknown;
+}>;
+declare function useInviteMember(): _tanstack_react_query.UseMutationResult<InviteMemberResult, Error, InviteMemberParams, unknown>;
+declare function useAcceptInvite(): _tanstack_react_query.UseMutationResult<AcceptInviteResult, Error, AcceptInviteParams, unknown>;
+/** Seat a member on a chat; invalidates the edges of both ends (the roster reads them). */
+declare function useSeatMember(): _tanstack_react_query.UseMutationResult<{
+    [key: string]: unknown;
+    success: true;
+    edge_id: string;
+}, Error, SeatMemberParams, unknown>;
+declare function useCreateAgent(): _tanstack_react_query.UseMutationResult<CreateAgentResult, Error, CreateAgentParams, unknown>;
+declare function useAnswerInput(): _tanstack_react_query.UseMutationResult<{
+    [key: string]: unknown;
+    success: true;
+}, Error, AnswerInputParams, unknown>;
+
 /**
  * @fsaos/gateway — Schema Interpretation Utilities
  *
@@ -3456,4 +3651,4 @@ declare function usePersonalSections(contextId: string | null, collection: Secti
     contextKey: string;
 };
 
-export { type AccountInfo, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, CHANNEL_AI_MODES, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelAiMode, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayRequestOptions, type GatewayResponse, type IncrementalItemsOptions, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type LoadMountsOptions, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PersonalSection, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ReadPriority, type ReadTiming, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SectionChange, type SectionCollection, type SectionDestination, type SectionSnapshot, type SectionTarget, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type SwitcherAccount, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type VfsItemChange, type WorkCorrelation, type WorkspaceOptions, type WorkspaceSession, assignPersonalSection, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, configureGatewayReads, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, initializeWorkspace, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, loadMounts, mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, personalSectionsKey, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, replaceMounts, resetAllSdkState, resolvePrincipalId, resubscribePath, selectMount, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAccounts, useAgentTimeline, useAllChannels, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useIncrementalItems, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePersonalSections, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };
+export { type AcceptInviteParams, type AcceptInviteResult, type AccountInfo, type AnswerInputParams, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, CHANNEL_AI_MODES, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelAiMode, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateAgentParams, type CreateAgentResult, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayRequestOptions, type GatewayResponse, type IncrementalItemsOptions, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type InviteMemberParams, type InviteMemberResult, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type LoadMountsOptions, type MemberRole, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PersonalSection, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ReadPriority, type ReadTiming, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SeatMemberParams, type SectionChange, type SectionCollection, type SectionDestination, type SectionSnapshot, type SectionTarget, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type SwitcherAccount, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type VfsItemChange, type WorkCorrelation, type WorkspaceOptions, type WorkspaceSession, acceptInvite, answerInput, assignPersonalSection, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, configureGatewayReads, createAgent, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, initializeWorkspace, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, inviteMember, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, loadMounts, mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, personalSectionsKey, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, replaceMounts, resetAllSdkState, resolvePrincipalId, resubscribePath, seatMember, selectMount, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAcceptInvite, useAccounts, useAgentTimeline, useAllChannels, useAnswerInput, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useCreateAgent, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useIncrementalItems, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useInviteMember, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePersonalSections, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useSeatMember, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };