cccc-sdk 0.4.3 → 0.4.40

package/dist/types.d.ts

@@ -9,7 +9,7 @@ export interface DaemonRequest {
 }
 /** IPC response envelope */
 export interface DaemonResponse {
-    v?: 1;
+    v: number;
     ok: boolean;
     result?: Record<string, unknown>;
     error?: DaemonErrorPayload;
@@ -38,25 +38,120 @@ export interface AddressDescriptor {
     version?: string;
     ts?: string;
 }
-/** Event stream item */
-export type EventStreamItem = {
+/** Event stream item: event */
+export interface EventStreamEvent {
     t: 'event';
     event: CCCSEvent;
-} | {
+}
+/** Event stream item: heartbeat */
+export interface EventStreamHeartbeat {
     t: 'heartbeat';
     ts: string;
-} | {
+}
+/** Event stream item: unknown type (forward-compatible) */
+export interface EventStreamUnknown {
     t: string;
     [key: string]: unknown;
-};
+}
+/** Event stream item (discriminated on `t`) */
+export type EventStreamItem = EventStreamEvent | EventStreamHeartbeat | EventStreamUnknown;
 /** CCCS event */
 export interface CCCSEvent {
     id: string;
     ts: string;
     kind: string;
     group_id: string;
+    scope_key?: string;
+    by?: string;
     data: Record<string, unknown>;
 }
+/** Data payload for `chat.message` events */
+export interface ChatMessageEventData {
+    text: string;
+    insight?: string | null;
+    format?: string;
+    /** Absent only on immutable messages written before the current contract. */
+    message_mode?: MessageMode;
+    to?: string[];
+    reply_to?: string | null;
+    quote_text?: string | null;
+    source_platform?: string | null;
+    source_user_name?: string | null;
+    source_user_id?: string | null;
+    mention_user_ids?: string[] | null;
+    sender_title?: string | null;
+    sender_runtime?: string | null;
+    sender_avatar_path?: string | null;
+    src_instance_id?: string | null;
+    src_instance_name?: string | null;
+    src_group_title?: string | null;
+    src_group_id?: string | null;
+    src_event_id?: string | null;
+    src_by?: string | null;
+    remote_reply_to?: string[] | null;
+    dst_instance_id?: string | null;
+    dst_instance_name?: string | null;
+    dst_group_title?: string | null;
+    dst_actor_titles?: Record<string, string>;
+    dst_group_id?: string | null;
+    dst_to?: string[] | null;
+    dst_message_mode?: MessageMode | null;
+    refs?: unknown[];
+    attachments?: unknown[];
+    thread?: string;
+    stream_id?: string | null;
+    pending_event_id?: string | null;
+    client_id?: string | null;
+    suggested_user_message?: string | null;
+}
+/** Data payload for `mail.read` events */
+export interface MailReadEventData {
+    actor_id: string;
+    event_id: string;
+}
+/** Data payload for `chat.cross_group_receipt` events. */
+export interface ChatCrossGroupReceiptEventData {
+    source_event_id: string;
+    dst_group_id: string;
+    dst_event_id?: string;
+    remote_event_id?: string;
+    registration_id?: string;
+    idempotency_key?: string;
+    status?: string;
+}
+/** Data payload for `notify.reminder` events */
+export interface NotifyReminderEventData {
+    rule_id: string;
+    title?: string;
+    message?: string;
+    snippet?: string;
+    priority?: string;
+}
+/** A chat.message event with strongly-typed data */
+export interface ChatMessageEvent extends CCCSEvent {
+    kind: 'chat.message';
+    data: ChatMessageEventData & Record<string, unknown>;
+}
+/** A mail.read event with strongly-typed data */
+export interface MailReadEvent extends CCCSEvent {
+    kind: 'mail.read';
+    data: MailReadEventData & Record<string, unknown>;
+}
+/** A cross-group delivery receipt with strongly-typed data. */
+export interface ChatCrossGroupReceiptEvent extends CCCSEvent {
+    kind: 'chat.cross_group_receipt';
+    data: ChatCrossGroupReceiptEventData & Record<string, unknown>;
+}
+/** Type guard: is this event a chat.message? */
+export declare function isChatMessageEvent(event: CCCSEvent): event is ChatMessageEvent;
+/** Type guard: is this event a mail.read? */
+export declare function isMailReadEvent(event: CCCSEvent): event is MailReadEvent;
+/** Type guard: is this event a chat.cross_group_receipt? */
+export declare function isChatCrossGroupReceiptEvent(event: CCCSEvent): event is ChatCrossGroupReceiptEvent;
+/** Type guard: is this stream item an event? */
+export declare function isStreamEvent(item: EventStreamItem): item is EventStreamEvent;
+/** Type guard: is this stream item a heartbeat? */
+export declare function isStreamHeartbeat(item: EventStreamItem): item is EventStreamHeartbeat;
 /** Client initialization options */
 export interface CCCCClientOptions {
     ccccHome?: string;
@@ -69,50 +164,185 @@ export interface CompatibilityOptions {
     requireCapabilities?: Record<string, boolean>;
     requireOps?: string[];
 }
+/**
+ * Structured chat-message reference (task_ref, presentation_ref, file/url/commit/text).
+ * Daemon accepts arbitrary `kind` values; the typed forms are the most common.
+ */
+export type MessageRef = ConnectGroupRef | {
+    kind: 'file';
+    path: string;
+    title?: string;
+    sha?: string;
+    bytes?: number;
+    [extra: string]: unknown;
+} | {
+    kind: 'url';
+    url: string;
+    title?: string;
+    [extra: string]: unknown;
+} | {
+    kind: 'commit';
+    sha: string;
+    title?: string;
+    [extra: string]: unknown;
+} | {
+    kind: 'text';
+    title?: string;
+    [extra: string]: unknown;
+} | {
+    kind: 'task_ref';
+    task_id: string;
+    title?: string;
+    status?: string;
+    waiting_on?: string;
+    handoff_to?: string;
+    [extra: string]: unknown;
+} | {
+    kind: 'presentation_ref';
+    slot_id?: string;
+    title?: string;
+    source_label?: string;
+    source_ref?: string;
+    [extra: string]: unknown;
+} | {
+    kind: string;
+    [extra: string]: unknown;
+};
+/** Chat-message attachment metadata (payload stored under blobs/) */
+export interface MessageAttachment {
+    kind?: 'text' | 'image' | 'file';
+    path?: string;
+    title?: string;
+    mime_type?: string;
+    bytes?: number;
+    sha256?: string;
+    [extra: string]: unknown;
+}
 /** Send message options */
+export type MessageMode = 'send' | 'request_reply' | 'mail';
+export type ReplyMessageMode = 'send' | 'mail';
 export interface SendOptions {
     groupId: string;
     text: string;
+    mode: MessageMode;
+    insight?: string;
+    suggestedUserMessage?: string;
     by?: string;
     to?: string[];
-    priority?: 'normal' | 'attention';
-    replyRequired?: boolean;
     path?: string;
+    refs?: MessageRef[];
+    attachments?: MessageAttachment[];
+    clientId?: string;
+    requirePeerInsight?: boolean;
+}
+/** Upload active-scope files and send them in one chat message. */
+export interface SendFilesOptions {
+    groupId: string;
+    paths: string[];
+    mode: MessageMode;
+    text?: string;
+    insight?: string;
+    by?: string;
+    to?: string[];
+    clientId?: string;
 }
 /** Send-cross-group options */
 export interface SendCrossGroupOptions {
     groupId: string;
     dstGroupId: string;
     text: string;
+    mode: MessageMode;
+    insight?: string;
     by?: string;
     to?: string[];
-    priority?: 'normal' | 'attention';
-    replyRequired?: boolean;
+    requirePeerInsight?: boolean;
 }
 /** Reply message options */
 export interface ReplyOptions {
     groupId: string;
     replyTo: string;
     text: string;
+    /** Defaults to Send. Mail is valid only when every reply recipient is an agent. */
+    mode?: ReplyMessageMode;
+    insight?: string;
+    suggestedUserMessage?: string;
     by?: string;
     to?: string[];
-    priority?: 'normal' | 'attention';
-    replyRequired?: boolean;
+    refs?: MessageRef[];
+    attachments?: MessageAttachment[];
+    clientId?: string;
+    requirePeerInsight?: boolean;
 }
+/**
+ * Tracked-delegation: atomically create a task and send the linked chat message.
+ * Daemon ensures task.create + send happen as one unit with idempotency replay.
+ */
+export interface TrackedSendOptions {
+    groupId: string;
+    text: string;
+    insight?: string;
+    /** Falls back to a compact derivation from text if omitted. */
+    title?: string;
+    by?: string;
+    to?: string[];
+    path?: string;
+    /** Task-domain priority. The linked visible message always uses Send. */
+    taskPriority?: string;
+    /** Used to dedupe retries. Daemon caches the result of the first successful call. */
+    idempotencyKey?: string;
+    outcome?: string;
+    /** Initial task status. Default 'planned'. */
+    status?: string;
+    /** What the task is waiting on. Default 'actor' when assignee is set, else 'none'. */
+    waitingOn?: string;
+    /** 'free' | 'standard' | 'optimization'. Default 'standard'. */
+    taskType?: string;
+    checklist?: Array<Record<string, unknown>>;
+    notes?: string;
+    blockedBy?: string[];
+    handoffTo?: string;
+    assignee?: string;
+    refs?: MessageRef[];
+    requirePeerInsight?: boolean;
+}
+/** Task list (returns either all tasks or one task plus its children). */
+export interface TaskListOptions {
+    groupId: string;
+    taskId?: string;
+    taskIds?: string[];
+    status?: 'planned' | 'active' | 'done' | 'archived';
+    statuses?: Array<'planned' | 'active' | 'done' | 'archived'>;
+    query?: string;
+    /** Use `__unassigned__` for tasks without an assignee. */
+    assignee?: string;
+    attention?: 'blocked' | 'waiting_user' | 'handoff' | 'unassigned';
+    offset?: number;
+    /** Page size from 1 through 100. */
+    limit?: number;
+    includeIndex?: boolean;
+}
+/** Built-in actor kind flag. */
+export type ActorInternalKind = 'voice_secretary';
+/** Source of runtime activity state for an actor. */
+export type ActorRuntimeStateSource = 'terminal' | 'app_server';
+/** Known agent runtimes. Allow string for forward compatibility. */
+export type AgentRuntime = 'amp' | 'antigravity' | 'auggie' | 'claude' | 'cline' | 'codex' | 'copilot' | 'cursor' | 'devin' | 'kiro' | 'kilo' | 'droid' | 'grok' | 'hermes' | 'kimi' | 'opencode' | 'web_model' | 'custom' | (string & {});
 /** Add actor options */
 export interface ActorAddOptions {
     groupId: string;
     actorId?: string;
     title?: string;
-    runtime?: string;
-    runner?: string;
+    runtime?: AgentRuntime;
     command?: string[];
     env?: Record<string, string>;
     envPrivate?: Record<string, string>;
     capabilityAutoload?: string[];
+    capabilityHidden?: string[];
     profileId?: string;
+    profileScope?: 'global' | 'user';
+    profileOwner?: string;
     defaultScopeKey?: string;
-    submit?: string;
+    submit?: 'enter' | 'newline' | 'none' | (string & {});
     by?: string;
 }
 /** Update actor options */
@@ -124,6 +354,341 @@ export interface ActorUpdateOptions {
     profileAction?: 'convert_to_custom';
     by?: string;
 }
+/** Destructive clean replacement of a group; confirmation must equal groupId. */
+export interface GroupResetOptions {
+    groupId: string;
+    confirmGroupId: string;
+    by?: string;
+}
+/** Create or replace a non-empty group startup preamble override. */
+export interface GroupPreambleSetOptions {
+    groupId: string;
+    content: string;
+    by?: string;
+}
+/** Delete the group startup preamble override and restore the built-in body. */
+export interface GroupPreambleResetOptions {
+    groupId: string;
+    confirm: 'preamble';
+    by?: string;
+}
+/** Headless-actor runtime status. */
+export type HeadlessStatus = 'idle' | 'working' | 'waiting' | 'stopped';
+/** Headless status read options */
+export interface HeadlessStatusOptions {
+    groupId: string;
+    actorId: string;
+}
+/** Headless set-status options */
+export interface HeadlessSetStatusOptions {
+    groupId: string;
+    actorId: string;
+    status: HeadlessStatus;
+    taskId?: string;
+}
+/** Group copy: export the current group as a portable package. */
+export interface GroupCopyExportOptions {
+    groupId: string;
+    by?: string;
+}
+export interface RemoteAccessOptions {
+    by?: string;
+}
+export interface RemoteAccessConfigureOptions extends RemoteAccessOptions {
+    provider?: 'off' | 'manual' | 'tailscale';
+    mode?: string;
+    requireAccessToken?: boolean;
+    webHost?: string;
+    webPort?: number;
+    webPublicUrl?: string;
+}
+/** Group copy: preview what would be imported from a package. */
+export type GroupCopyPackageInput = {
+    packageB64: string;
+    packagePath?: never;
+} | {
+    packageB64?: never;
+    packagePath: string;
+};
+export type GroupCopyPreviewImportOptions = GroupCopyPackageInput;
+/** Group copy: apply a previously exported package as a new group. */
+export type GroupCopyImportOptions = GroupCopyPackageInput & {
+    workspaceRoot?: string;
+    title?: string;
+};
+/** Capability visibility (per-actor hide/show). */
+export interface CapabilityVisibilityOptions {
+    groupId: string;
+    capabilityId: string;
+    hidden?: boolean;
+    actorId?: string;
+    reason?: string;
+    by?: string;
+}
+/** Capability install target — accepts capability_id or a remote source URI. */
+export interface CapabilityInstallTargetOptions {
+    groupId: string;
+    target: string;
+    actorId?: string;
+    scope?: 'actor' | 'group' | 'session';
+    ttlSeconds?: number;
+    reason?: string;
+    by?: string;
+}
+/** Capability source delete. */
+export interface CapabilitySourceDeleteOptions {
+    groupId: string;
+    sourceId: 'manual_import' | 'agent_self_proposed' | 'github_import' | 'url_import' | 'local_import';
+    reason?: string;
+    actorId?: string;
+    by?: string;
+}
+/** Presentation table content. */
+export interface PresentationTableData {
+    columns: string[];
+    rows: string[][];
+}
+/** Presentation card types supported by the daemon. */
+export type PresentationCardType = 'markdown' | 'table' | 'image' | 'pdf' | 'file' | 'web_preview';
+/** Presentation get. */
+export interface PresentationGetOptions {
+    groupId: string;
+}
+/** Presentation publish options. Pick one content source. */
+export interface PresentationPublishOptions {
+    groupId: string;
+    by?: string;
+    slot?: string;
+    title?: string;
+    summary?: string;
+    sourceLabel?: string;
+    sourceRef?: string;
+    cardType?: PresentationCardType;
+    content?: string;
+    path?: string;
+    url?: string;
+    blobRelPath?: string;
+    table?: PresentationTableData;
+}
+/** Presentation clear options. */
+export interface PresentationClearOptions {
+    groupId: string;
+    slot?: string;
+    by?: string;
+}
+/** Open a browser-backed presentation surface. */
+export interface PresentationBrowserOpenOptions {
+    groupId: string;
+    slot: string;
+    url: string;
+    width?: number;
+    height?: number;
+    by?: string;
+}
+export interface PresentationBrowserInfoOptions {
+    groupId: string;
+    slot?: string;
+}
+export interface PresentationBrowserCloseOptions {
+    groupId: string;
+    slot?: string;
+    by?: string;
+}
+/** Built-in assistant lifecycle. */
+export type AssistantLifecycle = 'disabled' | 'idle' | 'running' | 'working' | 'waiting' | 'failed';
+/** Built-in assistant id supported by CCCC v0.4.32. */
+export type AssistantId = 'voice_secretary';
+/** Read assistant state. */
+export interface AssistantStateOptions {
+    groupId: string;
+    assistantId?: AssistantId;
+    promptRequestId?: string;
+}
+export type AssistantVoiceRecordingLeaseAction = 'acquire' | 'heartbeat' | 'release' | 'status';
+/** Acquire, refresh, release, or inspect the daemon-owned Voice Secretary recording lease. */
+export interface AssistantVoiceRecordingLeaseOptions {
+    groupId: string;
+    action: AssistantVoiceRecordingLeaseAction;
+    by?: string;
+    ownerId?: string;
+    leaseId?: string;
+    ttlSeconds?: number;
+    captureMode?: string;
+    recognitionBackend?: string;
+}
+/** Update assistant settings (patch). */
+export interface AssistantSettingsUpdateOptions {
+    groupId: string;
+    assistantId: AssistantId;
+    patch: Record<string, unknown>;
+    by?: string;
+}
+/** Update assistant runtime status. */
+export interface AssistantStatusUpdateOptions {
+    groupId: string;
+    assistantId: AssistantId;
+    lifecycle: AssistantLifecycle;
+    health?: Record<string, unknown>;
+    by?: string;
+}
+/** Global observability settings update. */
+export interface ObservabilityUpdateOptions {
+    patch: Record<string, unknown>;
+    by?: string;
+}
+/** Branding settings update. */
+export interface BrandingUpdateOptions {
+    patch: Record<string, unknown>;
+    by?: string;
+}
+/** Daemon-wide diagnostics snapshot. */
+export interface DebugSnapshotOptions {
+    groupId: string;
+    by?: string;
+}
+/** Tail logs from a daemon component. */
+export interface DebugTailLogsOptions {
+    component: string;
+    groupId?: string;
+    lines?: number;
+    by?: string;
+}
+/** Clear logs for a daemon component. */
+export interface DebugClearLogsOptions {
+    component: string;
+    groupId?: string;
+    by?: string;
+}
+/** Read PTY transcript tail. */
+export interface TerminalTailOptions {
+    groupId: string;
+    actorId: string;
+    maxChars?: number;
+    stripAnsi?: boolean;
+    compact?: boolean;
+    by?: string;
+}
+/** Read a cursor-paginated PTY transcript page. */
+export interface TerminalHistoryOptions {
+    renderBefore?: number;
+    groupId: string;
+    actorId: string;
+    before?: number;
+    limitBytes?: number;
+    stripAnsi?: boolean;
+    compact?: boolean;
+    by?: string;
+}
+/** Read raw terminal output produced after a cursor. */
+export interface TerminalSinceOptions {
+    groupId: string;
+    actorId: string;
+    after: number;
+    limitBytes?: number;
+    by?: string;
+}
+/** Capture the bounded ANSI screen and its raw cursor boundary. */
+export interface TerminalSnapshotOptions {
+    groupId: string;
+    actorId: string;
+    limitBytes?: number;
+    by?: string;
+}
+export type WebModelDeliveryMode = 'standard' | 'image_compat';
+export interface WebModelDeliveryPreferencesGetOptions {
+    groupId: string;
+    actorId: string;
+}
+export interface WebModelDeliveryPreferencesUpdateOptions extends WebModelDeliveryPreferencesGetOptions {
+    mode: WebModelDeliveryMode;
+    by?: 'user';
+}
+export interface WebModelRuntimeRecoverTurnOptions extends WebModelDeliveryPreferencesGetOptions {
+    eventIds: string[];
+}
+/** Clear PTY backlog. */
+export interface TerminalClearOptions {
+    groupId: string;
+    actorId: string;
+    by?: string;
+}
+/** Ledger snapshot (durable point-in-time). */
+export interface LedgerSnapshotOptions {
+    groupId: string;
+    by?: string;
+    reason?: string;
+}
+/** Ledger compaction. */
+export interface LedgerCompactOptions {
+    groupId: string;
+    by?: string;
+    reason?: string;
+    force?: boolean;
+}
+/** Emit a chat.stream event (start/update/end). */
+export interface StreamEmitOptions {
+    groupId: string;
+    op: 'start' | 'update' | 'end';
+    by: string;
+    streamId?: string;
+    text?: string;
+    format?: 'plain' | 'markdown';
+    seq?: number;
+    to?: string[];
+    replyTo?: string;
+    clientId?: string;
+}
+/** Write a system.notify event directly. */
+export interface SystemNotifyOptions {
+    groupId: string;
+    message?: string;
+    title?: string;
+    kind?: string;
+    priority?: 'low' | 'normal' | 'high' | 'urgent';
+    targetActorId?: string;
+    imVisibility?: 'internal' | 'public';
+    context?: Record<string, unknown>;
+    by?: string;
+}
+/** Reconcile the group registry against on-disk state. */
+export interface RegistryReconcileOptions {
+    removeMissing?: boolean;
+}
+/** Detach a scope from a group. */
+export interface GroupDetachScopeOptions {
+    groupId: string;
+    scopeKey: string;
+    by?: string;
+}
+/** Prepare the selected Hermes profile with the CCCC MCP server. */
+export interface RuntimeHermesPrepareOptions {
+    cwd?: string;
+    autoEnableTools?: boolean;
+    forceMcp?: boolean;
+}
+/** Run Hermes' MCP probe for the configured CCCC server. */
+export interface RuntimeHermesMcpTestOptions {
+    cwd?: string;
+    groupId?: string;
+    actorId?: string;
+}
+/**
+ * Async-result envelope merged into many long-running ops' results.
+ *
+ * Consumers typically check `completed`; if `false`, the operation was accepted
+ * and clients should subscribe to `events_stream` for `completion_signal` rather
+ * than poll. See `spec/CCCC_DAEMON_IPC_V1.md` for details.
+ */
+export interface AsyncResultEnvelope {
+    accepted: boolean;
+    completed: boolean;
+    queued?: boolean;
+    background?: boolean;
+    completion_signal?: string;
+    recommended_next_action?: string;
+    polling_discouraged?: boolean;
+    wait_guidance?: string;
+}
 /** Actor private env vars (secrets, runtime-only) */
 export interface ActorEnvPrivateUpdateOptions {
     groupId: string;
@@ -206,7 +771,7 @@ export interface CapabilityOverviewOptions {
 }
 /** Capability search options */
 export interface CapabilitySearchOptions {
-    groupId: string;
+    groupId?: string;
     actorId?: string;
     by?: string;
     query?: string;
@@ -219,7 +784,7 @@ export interface CapabilitySearchOptions {
 }
 /** Capability enable/disable options */
 export interface CapabilityEnableOptions {
-    groupId: string;
+    groupId?: string;
     capabilityId: string;
     scope?: 'group' | 'actor' | 'session';
     enabled?: boolean;
@@ -242,7 +807,7 @@ export interface CapabilityBlockOptions {
 }
 /** Capability state options */
 export interface CapabilityStateOptions {
-    groupId: string;
+    groupId?: string;
     actorId?: string;
     by?: string;
 }
@@ -365,7 +930,7 @@ export interface GroupSpaceArtifactOptions {
     wait?: boolean;
     saveToSpace?: boolean;
     outputPath?: string;
-    outputFormat?: 'json' | 'markdown' | 'html';
+    outputFormat?: 'json' | 'markdown' | 'html' | 'pdf' | 'pptx' | 'csv';
     artifactId?: string;
     timeoutSeconds?: number;
     initialInterval?: number;
@@ -388,8 +953,6 @@ export interface GroupSpaceJobsOptions {
 export interface GroupSpaceSyncOptions {
     groupId: string;
     lane: GroupSpaceLane;
-    action?: 'status' | 'run';
-    force?: boolean;
     provider?: GroupSpaceProvider;
     by?: string;
 }
@@ -409,12 +972,14 @@ export interface GroupSpaceProviderCredentialUpdateOptions {
 export interface GroupSpaceProviderHealthCheckOptions {
     provider?: GroupSpaceProvider;
     by?: string;
+    authJson?: string;
 }
 /** Provider auth flow options */
 export interface GroupSpaceProviderAuthOptions {
     provider?: GroupSpaceProvider;
-    action?: 'status' | 'start' | 'cancel';
+    action?: 'status' | 'start' | 'cancel' | 'disconnect';
     timeoutSeconds?: number;
+    projected?: boolean;
     by?: string;
 }
 /** Automation notify priority */
@@ -444,7 +1009,6 @@ export interface AutomationActionNotify {
     snippet_ref?: string | null;
     message?: string;
     priority?: AutomationNotifyPriority;
-    requires_ack?: boolean;
 }
 /** Automation action (group state) */
 export interface AutomationActionGroupState {
@@ -522,21 +1086,125 @@ export interface GroupAutomationResetBaselineOptions {
     by?: string;
     expectedVersion?: number;
 }
-/** Inbox list options */
-export interface InboxListOptions {
+/** Read or peek at an actor Inbox. Reading advances the read cursor. */
+export interface InboxOptions {
     groupId: string;
     actorId: string;
     by?: string;
     limit?: number;
-    kindFilter?: string;
+}
+/** Inspect actor-visible chat history without consuming Mail. */
+export interface MessageHistoryOptions extends InboxOptions {
+    mode?: 'all' | MessageMode;
+    query?: string;
+    beforeEventId?: string;
+}
+export interface ReplyRequestCancelOptions {
+    groupId: string;
+    sourceEventId: string;
+    by?: string;
+}
+export interface MessageDeliverOptions {
+    groupId: string;
+    sourceEventId: string;
+    actorIds: string[];
+    by?: string;
+    forceAmbiguous?: boolean;
 }
 /** Context sync options */
 export interface ContextSyncOptions {
+    ifVersion?: string;
     groupId: string;
     ops: Record<string, unknown>[];
     by?: string;
     dryRun?: boolean;
 }
+/** Common context_sync wrapper options. */
+export interface ContextWrapperOptions {
+    groupId: string;
+    by?: string;
+    dryRun?: boolean;
+}
+/** Update the shared coordination brief (Context Ops v3). */
+export interface CoordinationBriefUpdateOptions extends ContextWrapperOptions {
+    objective?: string;
+    currentFocus?: string;
+    constraints?: string[];
+    projectBrief?: string;
+    projectBriefStale?: boolean;
+}
+/** Add a compact coordination note. */
+export interface CoordinationNoteAddOptions extends ContextWrapperOptions {
+    kind: 'decision' | 'handoff';
+    summary: string;
+    taskId?: string | null;
+}
+/** Create/update/move/restore task options for Context Ops v3. */
+export interface TaskCreateOptions extends ContextWrapperOptions {
+    title: string;
+    outcome?: string;
+    status?: 'planned' | 'active' | 'done' | 'archived';
+    parentId?: string | null;
+    assignee?: string | null;
+    priority?: string;
+    blockedBy?: string[];
+    waitingOn?: 'none' | 'user' | 'actor' | 'external';
+    handoffTo?: string | null;
+    taskType?: 'free' | 'standard' | 'optimization';
+    notes?: string;
+    checklist?: Array<{
+        id?: string;
+        text: string;
+        status?: 'pending' | 'in_progress' | 'done';
+    }>;
+}
+export interface TaskUpdateOptions extends ContextWrapperOptions {
+    taskId: string;
+    title?: string;
+    outcome?: string;
+    status?: 'planned' | 'active' | 'done' | 'archived';
+    assignee?: string | null;
+    priority?: string;
+    blockedBy?: string[];
+    waitingOn?: 'none' | 'user' | 'actor' | 'external';
+    handoffTo?: string | null;
+    notes?: string;
+    checklist?: Array<{
+        id?: string;
+        text: string;
+        status?: 'pending' | 'in_progress' | 'done';
+    }>;
+}
+export interface TaskMoveOptions extends ContextWrapperOptions {
+    taskId: string;
+    status: 'planned' | 'active' | 'done' | 'archived';
+}
+export interface TaskRestoreOptions extends ContextWrapperOptions {
+    taskId: string;
+}
+export interface TaskDeleteOptions extends ContextWrapperOptions {
+    taskId: string;
+}
+/** Update or clear per-actor working memory. */
+export interface AgentStateUpdateOptions extends ContextWrapperOptions {
+    actorId: string;
+    activeTaskId?: string;
+    focus?: string;
+    nextAction?: string;
+    whatChanged?: string;
+    blockers?: string[];
+    openLoops?: string[];
+    commitments?: string[];
+    environmentSummary?: string;
+    userModel?: string;
+    personaNotes?: string;
+}
+export interface AgentStateClearOptions extends ContextWrapperOptions {
+    actorId: string;
+}
+export interface MetaMergeOptions extends ContextWrapperOptions {
+    data: Record<string, unknown>;
+}
 /** Event stream options */
 export interface EventsStreamOptions {
     groupId: string;
@@ -545,5 +1213,326 @@ export interface EventsStreamOptions {
     sinceEventId?: string;
     sinceTs?: string;
     timeoutMs?: number;
+    /** AbortSignal to tear down the stream. When aborted the async generator returns. */
+    signal?: AbortSignal;
+}
+/** Result of send, sendFiles, or reply. */
+export interface SendResult {
+    event: CCCSEvent;
+    /** Canonical mode stored on the event; replies always return `send`. */
+    message_mode: MessageMode;
+}
+/** Options for sendAndWaitForReply */
+export type SendAndWaitOptions = Omit<SendOptions, 'mode'> & {
+    /** Actor ID that will listen for the reply (used to open events stream). */
+    listenAs: string;
+    /** Timeout in ms to wait for a reply (default 60_000). */
+    waitTimeoutMs?: number;
+    /** AbortSignal to cancel the wait. */
+    signal?: AbortSignal;
+};
+/** Actor descriptor returned by daemon */
+export interface ActorInfo {
+    id: string;
+    role?: string;
+    title?: string;
+    enabled?: boolean;
+    running?: boolean;
+    runner?: string;
+    runtime?: string;
+    submit?: string;
+    unread_count?: number;
+    updated_at?: string;
+    created_at?: string;
+}
+/** Scope descriptor */
+export interface ScopeInfo {
+    scope_key: string;
+    url: string;
+    label?: string;
+    git_remote?: string;
+}
+/** Group descriptor returned by daemon */
+export interface GroupInfo {
+    group_id: string;
+    title?: string;
+    topic?: string;
+    state?: string;
+    running?: boolean;
+    active_scope_key?: string;
+    created_at?: string;
+    updated_at?: string;
+    scopes?: ScopeInfo[];
+}
+/** Result of ping */
+export interface PingResult {
+    version: string;
+    implementation: string;
+    pid: number;
+    ts: string;
+    ipc_v: number;
+    capabilities: Record<string, unknown>;
+    compatibility?: string;
+    [key: string]: unknown;
+}
+/** Result of groups list */
+export interface GroupsResult {
+    groups: GroupInfo[];
+}
+/** Result of group_show */
+export interface GroupShowResult {
+    group: GroupInfo;
+    actors?: ActorInfo[];
+}
+/** Result of group_create */
+export interface GroupCreateResult {
+    group: GroupInfo;
+}
+/** Result of actor_list */
+export interface ActorListResult {
+    actors: ActorInfo[];
+}
+/** Result of actor_add */
+export interface ActorAddResult {
+    actor_id: string;
+}
+/** Result of inbox_peek */
+export interface InboxPeekResult {
+    messages: CCCSEvent[];
+    cursor: {
+        event_id: string;
+        ts: string;
+    };
+}
+/** Result of inbox_read */
+export interface InboxReadResult extends InboxPeekResult {
+    event: CCCSEvent | null;
+    cursor: InboxPeekResult['cursor'] & {
+        updated_at?: string;
+    };
+}
+/** Result of message_history. */
+export interface MessageHistoryResult {
+    messages: CCCSEvent[];
+    has_more: boolean;
+}
+export interface TerminalSnapshotResult {
+    data: string;
+    start_cursor: number;
+    end_cursor: number;
+}
+export interface WebModelDeliveryPreferencesResult {
+    group_id: string;
+    actor_id: string;
+    preference: {
+        mode: WebModelDeliveryMode;
+        updated_at: string;
+        updated_by: string;
+    };
+}
+export interface WebModelRuntimeRecoverTurnResult {
+    status: 'recovered';
+    turn: {
+        turn_id: string;
+        group_id: string;
+        actor_id: string;
+        event_ids: string[];
+        latest_event_id: string;
+        latest_ts: string;
+        messages: CCCSEvent[];
+        coalesced_text: string;
+        system_prompt: string;
+        delivery: {
+            mode: 'recovery_no_cursor_mutation';
+            cursor_committed: true;
+            web_model_mode: WebModelDeliveryMode;
+        };
+    };
+}
+export interface CapabilityUseOptions extends CapabilityEnableOptions {
+    toolName?: string;
+    toolArguments?: Record<string, unknown>;
+}
+/** Local CCCC memory operation options. */
+export interface MemorySearchOptions {
+    groupId: string;
+    actorId?: string;
+    query: string;
+    limit?: number;
+    maxResults?: number;
+    vectorWeight?: number;
+    candidateMultiplier?: number;
+    minScore?: number;
+    tags?: string[];
+    target?: 'memory' | 'daily';
+}
+export interface MemoryWriteOptions {
+    groupId: string;
+    actorId?: string;
+    target: 'memory' | 'daily';
+    content: string;
+    tags?: string[];
+    sourceRefs?: string[];
+    idempotencyKey?: string;
+    dedupIntent?: 'new' | 'update' | 'supersede' | 'silent';
+    dedupQuery?: string;
+}
+export interface MemoryGetOptions {
+    groupId: string;
+    actorId?: string;
+    path?: string;
+    target?: 'memory' | 'daily';
+    date?: string;
+    offset?: number;
+    limit?: number;
+}
+export interface MemoryHealthOptions {
+    groupId: string;
+}
+export interface MemoryProfileGetOptions {
+    groupId: string;
+    actorId?: string;
+    userId?: string;
+    tags?: string[];
+}
+export interface MemoryRemeMessage {
+    role: string;
+    name?: string;
+    content: string;
+}
+export interface MemoryRemeLayoutGetOptions {
+    groupId: string;
+}
+export interface MemoryRemeIndexSyncOptions {
+    groupId: string;
+    mode?: 'scan' | 'rebuild';
+}
+/** Lower-level ReMe options retained for callers that need source controls. */
+export interface MemoryRemeSearchOptions {
+    groupId: string;
+    query: string;
+    maxResults?: number;
+    minScore?: number;
+    sources?: string[];
+    vectorWeight?: number;
+    candidateMultiplier?: number;
+}
+export interface MemoryRemeGetOptions {
+    groupId: string;
+    path: string;
+    offset?: number;
+    limit?: number;
+}
+export interface MemoryRemeContextCheckOptions {
+    groupId: string;
+    messages: MemoryRemeMessage[];
+    contextWindowTokens?: number;
+    reserveTokens?: number;
+    keepRecentTokens?: number;
+}
+export interface MemoryRemeCompactOptions {
+    groupId: string;
+    messagesToSummarize: MemoryRemeMessage[];
+    turnPrefixMessages?: MemoryRemeMessage[];
+    previousSummary?: string;
+    language?: string;
+    returnPrompt?: boolean;
+}
+export type MemoryRemeDedupIntent = 'new' | 'update' | 'supersede' | 'silent';
+export interface MemoryRemeDailyFlushOptions {
+    groupId: string;
+    messages: MemoryRemeMessage[];
+    date?: string;
+    version?: string;
+    language?: string;
+    returnPrompt?: boolean;
+    signalPack?: Record<string, unknown>;
+    signalPackTokenBudget?: number;
+    dedupIntent?: MemoryRemeDedupIntent;
+    dedupQuery?: string;
+}
+export interface MemoryRemeWriteOptions {
+    groupId: string;
+    target: 'memory' | 'daily';
+    content: string;
+    date?: string;
+    mode?: 'append' | 'replace';
+    idempotencyKey?: string;
+    actorId?: string;
+    sourceRefs?: string[];
+    tags?: string[];
+    supersedes?: string[];
+    dedupIntent?: MemoryRemeDedupIntent;
+    dedupQuery?: string;
+}
+export type ContextDetail = 'overview' | 'summary' | 'full';
+/** Result of context_get; omitted projections depend on the requested detail. */
+export interface ContextGetResult {
+    version: string;
+    tasks_version: string;
+    coordination: {
+        brief: {
+            objective: string;
+            current_focus: string;
+            constraints: string[];
+            project_brief: string;
+            project_brief_stale: boolean;
+            updated_by: string;
+            updated_at: string;
+        };
+        tasks?: Array<Record<string, unknown>>;
+        recent_decisions?: Array<Record<string, unknown>>;
+        recent_handoffs?: Array<Record<string, unknown>>;
+    };
+    agent_states: Array<Record<string, unknown>>;
+    actors_runtime?: Array<Record<string, unknown>>;
+    tasks_summary?: {
+        total: number;
+        done: number;
+        active: number;
+        planned: number;
+        archived: number;
+        root_count?: number;
+    };
+    attention?: Record<string, unknown>;
+    board?: Record<string, Array<Record<string, unknown>>>;
+    meta?: Record<string, unknown>;
+}
+/** Read cached authorized peers; never refreshes peers or starts Actors. */
+export interface ConnectCatalogOptions {
+    groupId: string;
+    instanceId?: string;
+    targetGroupId?: string;
+    by?: string;
+    after?: string;
+    limit?: number;
+}
+/** Remote acceptance is durable queueing, not proof of delivery. */
+export interface ConnectSendOptions {
+    groupId: string;
+    instanceId: string;
+    targetGroupId: string;
+    /** Required stable retry key, at most 128 UTF-8 bytes. */
+    clientId: string;
+    text: string;
+    mode: MessageMode;
+    by?: string;
+    to?: string[];
+    format?: string;
+    insight?: string;
+    attachments?: Record<string, unknown>[];
+}
+export interface ConnectSendFilesOptions extends Omit<ConnectSendOptions, 'text' | 'attachments' | 'format'> {
+    text?: string;
+    paths: string[];
+}
+/** A mention identifies a remote Group; it does not send to that Group. */
+export interface ConnectGroupRef {
+    kind: 'connect_group_ref';
+    instance_name?: string;
+    group_title?: string;
+    token?: string;
+    instance_id: string;
+    group_id: string;
 }
 //# sourceMappingURL=types.d.ts.map