shennian 0.5.0 → 0.5.2

package/node_modules/@shennian/wire/dist/machine.d.ts

@@ -1,160 +0,0 @@
-export type MachinePermission = 'view' | 'use' | 'full' | 'admin';
-/** `minor` is a legacy compatibility value; current daemons normalize it to `none`. */
-export type AutoUpgradePolicy = 'none' | 'patch' | 'minor';
-export type Machine = {
-    id: string;
-    name: string;
-    os: string;
-    agentList: string[];
-    /** Rich agent info with per-agent model lists (additive, backward-compatible) */
-    agents?: import('./session.ts').AgentInfo[];
-    paired: boolean;
-    online: boolean;
-    lastSeen: string;
-    region?: string;
-    /** CLI version currently running on this machine */
-    cliVersion?: string;
-    /** Stable identity of the daemon data root. It is not the mobile installationId. */
-    daemonInstallationId?: string;
-    /** Personal Session sync protocol understood by this daemon. */
-    sessionSyncProtocolVersion?: import('./session-sync.ts').SessionSyncProtocolVersion;
-    /** Active personal Session data authority generation. */
-    sessionSyncDataEpoch?: import('./session-sync.ts').SessionSyncDataEpoch;
-    /** Full capability set required by the hard-cutover personal Session protocol. */
-    sessionSyncCapabilities?: import('./session-sync.ts').SessionSyncCapability[];
-    /** External updater protocol advertised by the live daemon; absent means legacy engine. */
-    updaterProtocolVersion?: number;
-    /** Auto-upgrade policy configured on this machine */
-    autoUpgrade?: AutoUpgradePolicy;
-    /** Set only after the daemon durably disables remote access on the machine. */
-    remoteAccessDisabledAt?: string | null;
-    /** Ownership role — absent means owner (backward-compatible) */
-    role?: 'owner' | 'granted';
-    /** Non-null only when role === 'granted' */
-    permission?: MachinePermission;
-    /** Active redeemed grants created by the owner for this machine. */
-    sharedCount?: number;
-    /** Nicknames used by the owner-only machine detail summary. */
-    sharedWith?: string[];
-    /** Unredeemed, active invitations created by this owner. */
-    pendingShareCount?: number;
-    /** Agents on this machine that have a non-missing provider config. */
-    configuredAgentCount?: number;
-    /** Present for machines shared by another user. */
-    ownerName?: string | null;
-    ownerPhone?: string | null;
-    ownerEmail?: string | null;
-    /**
-     * Machine-scoped WeChat RPA capability projection.
-     * This is additive: old servers/daemons may omit it, and clients must treat
-     * omission as "unknown / not reported yet".
-     */
-    wechatRpa?: MachineWeChatRpaCapability | null;
-};
-export type MachineWeChatRpaCapability = {
-    supported: boolean;
-    enabled: boolean;
-    status: 'ready' | 'needs_setup' | 'unavailable' | 'error' | 'unknown';
-    reasonCode?: 'ready' | 'disabled' | 'offline' | 'unsupported_os' | 'not_reported' | 'wechat_not_installed' | 'wechat_not_running' | 'permission_missing' | 'helper_not_ready' | 'runtime_error' | 'unknown';
-    runtimeId?: string | null;
-    pollIntervalSeconds?: number | null;
-    foregroundPolicy?: 'work' | 'polite' | string | null;
-    helperVersion?: string | null;
-    clientRuntimeVersion?: string | null;
-    lastCheckedAt?: string | null;
-    lastSeenAt?: string | null;
-    lastError?: string | null;
-    checks?: {
-        wechatAppDetected?: boolean | null;
-        accessibilityPermission?: string | null;
-        screenRecordingPermission?: string | null;
-        inputMonitoringPermission?: string | null;
-        automationPermission?: string | null;
-        helperReady?: boolean | null;
-    } | null;
-};
-export type UpgradeEventPayload = {
-    state: 'checking';
-    machineId: string;
-} | {
-    state: 'downloading';
-    machineId: string;
-    version: string;
-    progress?: number;
-} | {
-    state: 'installing';
-    machineId: string;
-    version: string;
-} | {
-    state: 'starting';
-    machineId: string;
-    from: string;
-    to: string;
-    jobId?: string;
-} | {
-    state: 'recovering';
-    machineId: string;
-    from: string;
-    to: string;
-    jobId?: string;
-    activeRunCount?: number;
-} | {
-    state: 'healthy';
-    machineId: string;
-    from: string;
-    to: string;
-    jobId?: string;
-} | {
-    state: 'restarting';
-    machineId: string;
-    from: string;
-    to: string;
-} | {
-    state: 'success';
-    machineId: string;
-    from: string;
-    to: string;
-} | {
-    state: 'failed';
-    machineId: string;
-    error: string;
-} | {
-    state: 'rolledback';
-    machineId: string;
-    to: string;
-    reason: string;
-} | {
-    state: 'rolled_back';
-    machineId: string;
-    to: string;
-    reason: string;
-    jobId?: string;
-} | {
-    state: 'interrupted_by_upgrade';
-    machineId: string;
-    runCount: number;
-    jobId?: string;
-} | {
-    state: 'recovery_failed';
-    machineId: string;
-    runCount: number;
-    error?: string;
-    jobId?: string;
-};
-export type MachineGrant = {
-    id: string;
-    granteeId: string | null;
-    granteeName: string | null;
-    /** @deprecated Kept optional for old-server compatibility; current UI never displays it. */
-    granteePhone?: string | null;
-    granteeAvatar?: {
-        version: string;
-        thumbUrl: string;
-        originalUrl: string;
-    } | null;
-    permission: MachinePermission;
-    expiresAt: string | null;
-    revokedAt: string | null;
-    createdAt: string;
-    redeemed: boolean;
-};

package/node_modules/@shennian/wire/dist/message-payload.d.ts

@@ -1,71 +0,0 @@
-export type ChatAttachmentKind = 'image' | 'file' | 'folder';
-export type ChatAttachmentMeta = {
-    path: string;
-    name: string;
-    mimeType: string;
-    kind: ChatAttachmentKind;
-    byteSize?: number;
-    sha256?: string;
-    previewData?: string;
-};
-export type StructuredUserMessagePayload = {
-    v: 1;
-    type: 'user';
-    content: string;
-    attachments?: ChatAttachmentMeta[];
-};
-type StructuredPayload = StructuredUserMessagePayload | ApprovalPendingPayload | ChannelDeliveryStatusPayload | {
-    v: 1;
-    type?: string;
-    content?: string;
-    text?: string;
-    thinking?: string;
-};
-export type ApprovalPendingPayload = {
-    v: 1;
-    type: 'approval_pending';
-    title: string;
-    content: string;
-    source?: string;
-    actionHint?: string;
-    permission?: import('./events.ts').AcpPermissionPrompt;
-};
-export type ChannelDeliveryStatusPayload = {
-    v: 1;
-    type: 'channel_delivery_status';
-    content: string;
-    channel: 'wechat';
-    status: string;
-    agentVisible: false;
-    replyId?: string;
-    idempotencyKey?: string;
-    bindingId?: string;
-    reasonCode?: string;
-    copyText?: string;
-    copyableContentRef?: string;
-    errorSummary?: string;
-};
-export declare function parseStructuredMessagePayload(payload: string): StructuredPayload | null;
-export declare function parseUserMessagePayload(payload: string): StructuredUserMessagePayload | null;
-export declare function buildUserMessagePayload(content: string, attachments?: ChatAttachmentMeta[]): string;
-export declare function isToolPayload(payload: string): boolean;
-export declare function isApprovalPendingPayload(payload: string): boolean;
-export declare function isAgentHiddenPayload(payload: string): boolean;
-export declare function parseChannelDeliveryStatusPayload(payload: string): ChannelDeliveryStatusPayload | null;
-export declare function buildApprovalPendingPayload(input?: Partial<ApprovalPendingPayload>): string;
-export declare function isSystemEnvironmentContextPayload(payload: string): boolean;
-export declare function isCodexTurnAbortedPayload(payload: string): boolean;
-export declare function isCodexProjectInstructionsPayload(payload: string): boolean;
-export declare function isSystemControlPayload(payload: string): boolean;
-export declare function stripGitDirectiveArtifacts(text: string): string;
-export declare function extractPayloadText(payload: string): string;
-/**
- * Converts already-readable text into the only form allowed in the replicated
- * personal-session index. A preview is content, not an opaque transport field:
- * private control context and binary payloads are therefore rejected instead
- * of being truncated into something that still leaks them.
- */
-export declare function sanitizeSessionPreview(value: string | null | undefined, maxLength?: number): string | null;
-/** Extracts a safe, bounded preview from an envelope payload. */
-export declare function sessionPreviewFromPayload(payload: string, maxLength?: number): string | null;
-export {};

package/node_modules/@shennian/wire/dist/methods.d.ts

@@ -1,5 +0,0 @@
-export type ReqMethod = 'schedule.deliver'
-/** Server-originated durable delivery into a managed Room session queue. */
- | 'room.message.deliver' | 'chat.send' | 'chat.enqueue' | 'chat.queue.get' | 'chat.queue.edit' | 'chat.queue.delete' | 'chat.queue.promote' | 'chat.abort' | 'session.resume' | 'session.history' | 'session.history.open' | 'session.history.sync' | 'session.history.page' | 'session.history.close' | 'session.body.replica.subscribe' | 'session.body.replica.unsubscribe' | 'session.index.update' | 'session.deletions.sync' | 'session.deletions.ack' | 'session.message.status' | 'voice.session.body.window' | 'session.refresh' | 'session.tool.detail' | 'session.title.set' | 'session.title.generate' | 'fs.ls' | 'fs.read' | 'fs.write' | 'fs.export.markdown-pdf' | 'fs.export.markdown-pdf.setup' | 'fs.archive.zip' | 'fs.transfer.start' | 'fs.transfer.chunk' | 'fs.transfer.finish' | 'fs.transfer.abort' | 'fs.rename' | 'project.fs.open' | 'project.fs.list' | 'project.fs.read' | 'project.fs.close'
-/** Server-originated per-connection challenge; never accepted from an App client. */
- | 'project.fs.negotiate' | 'skill.list' | 'skill.install' | 'skill.doctor' | 'skill.setup' | 'skill.use' | 'region.probe' | 'region.switch' | 'upgrade.start' | 'upgrade.status' | 'upgrade.set-policy' | 'machine.remote-access.pause' | 'agents.refresh' | 'models.refresh' | 'agent.config.get' | 'agent.config.upsert' | 'agent.config.clear' | 'agent.config.test' | 'agent.workspace.validate' | 'agent.capabilities.list' | 'agent.permission.respond' | 'agent.auth.start' | 'agent.auth.logout' | 'agent.session-options.get' | 'agent.external-sessions.list' | 'agent.external-sessions.import' | 'agent.external-sessions.close' | 'agent.external-sessions.delete' | 'manager.channel.get' | 'manager.channel.upsert' | 'session.wechat-rpa.channel.get' | 'session.wechat-rpa.channel.upsert' | 'session.wechat-rpa.channel.sync' | 'session.wechat-rpa.outbound.cancel' | 'manager.wechat-rpa.channel.get' | 'manager.wechat-rpa.channel.upsert' | 'manager.wechat-rpa.channel.sync' | 'manager.wechat-rpa.outbound.cancel' | 'wechat-rpa.helper.runtime' | 'wecom.send' | 'external.send' | 'room.sync' | 'room.send' | 'room.bind' | 'room.agent.bind-managed' | 'room.agent.restart-managed' | 'room.unbind';

package/node_modules/@shennian/wire/dist/native-session.d.ts

@@ -1,20 +0,0 @@
-export type NativeSessionSourceMode = 'codex_rollout_import' | 'claude_transcript_import' | 'opencode_session_import' | 'managed_echo_claim';
-export type NativeSessionEventPayload = {
-    agentType: 'codex' | 'claude' | 'opencode';
-    sourceMode: NativeSessionSourceMode;
-    sourceSessionKey: string;
-    sourceEventKey: string;
-    cursor?: string | null;
-    role: 'user' | 'agent';
-    ts: number;
-    payload: string;
-    title?: string;
-    modelId?: string | null;
-    workDir?: string;
-    claimCanonicalMessageId?: string | null;
-    managedEchoPolicy?: 'suppress_following' | 'import_following';
-    terminal?: boolean;
-};
-export type NativeSessionImportBatch = {
-    events: NativeSessionEventPayload[];
-};

package/node_modules/@shennian/wire/dist/project-fs.d.ts

@@ -1,146 +0,0 @@
-export declare const PROJECT_FS_OPAQUE_CAPABILITY: "project_fs_opaque_v1";
-export type ProjectFsOpaqueCapability = typeof PROJECT_FS_OPAQUE_CAPABILITY;
-export declare const PROJECT_FS_NEGOTIATION_METHOD: "project.fs.negotiate";
-export declare const PROJECT_FS_SENSITIVE_AUTHORITY_VERSION: 1;
-export type ProjectFsNegotiationChallenge = {
-    version: typeof PROJECT_FS_SENSITIVE_AUTHORITY_VERSION;
-    nonce: string;
-    daemonInstallationId: string;
-};
-export type ProjectFsNegotiationResponse = {
-    version: typeof PROJECT_FS_SENSITIVE_AUTHORITY_VERSION;
-    capability: ProjectFsOpaqueCapability;
-    nonce: string;
-    daemonInstallationId: string;
-    proof: string;
-};
-export declare function projectFsNegotiationProofPayload(requestId: string, challenge: ProjectFsNegotiationChallenge): string;
-export declare function parseProjectFsNegotiationChallenge(value: unknown): ProjectFsNegotiationChallenge | null;
-export declare function parseProjectFsNegotiationResponse(value: unknown): ProjectFsNegotiationResponse | null;
-export declare const PROJECT_FS_METHODS: readonly ["project.fs.open", "project.fs.list", "project.fs.read", "project.fs.close"];
-export type ProjectFsMethod = (typeof PROJECT_FS_METHODS)[number];
-export declare const PROJECT_FS_LIMITS: {
-    readonly defaultDirectoryPageItems: 50;
-    readonly maxDirectoryPageItems: 200;
-    readonly maxReadBytes: number;
-    readonly maxTokenLength: 512;
-    readonly maxProjectRefLength: 1024;
-    readonly maxNameLength: 255;
-};
-export type ProjectFsEntryKind = 'directory' | 'file';
-export type ProjectFsReadEncoding = 'binary' | 'auto';
-export type ProjectFsEntry = {
-    handle: string;
-    name: string;
-    kind: ProjectFsEntryKind;
-    size?: number;
-    modifiedAt?: number;
-};
-export type ProjectFsDirectoryPage = {
-    directoryHandle: string;
-    cursor: number;
-    nextCursor: number | null;
-    entries: ProjectFsEntry[];
-};
-export type ProjectFsOpenParams = {
-    projectRef: string;
-    limit?: number;
-};
-export type ProjectFsOpenResult = {
-    leaseId: string;
-    root: {
-        handle: string;
-        name: string;
-        kind: 'directory';
-    };
-    page: ProjectFsDirectoryPage;
-    expiresAt: number;
-};
-export type ProjectFsListParams = {
-    projectRef: string;
-    leaseId: string;
-    directoryHandle: string;
-    cursor?: number;
-    limit?: number;
-};
-export type ProjectFsListResult = ProjectFsDirectoryPage & {
-    leaseId: string;
-    expiresAt: number;
-};
-export type ProjectFsReadParams = {
-    projectRef: string;
-    leaseId: string;
-    fileHandle: string;
-    offset: number;
-    limitBytes: number;
-    encoding?: ProjectFsReadEncoding;
-};
-export type ProjectFsReadResult = {
-    leaseId: string;
-    fileHandle: string;
-    offset: number;
-    bytesRead: number;
-    nextOffset: number | null;
-    totalSize: number;
-    dataBase64?: string;
-    text?: string;
-    encoding?: string;
-    encodingFallback?: boolean;
-    mimeType?: string;
-    expiresAt: number;
-};
-export type ProjectFsCloseParams = {
-    projectRef: string;
-    leaseId: string;
-};
-export type ProjectFsCloseResult = {
-    closed: true;
-};
-export declare const PROJECT_FS_ERROR_CODES: readonly ["capability_required", "machine_offline", "permission_denied", "project_not_found", "project_scope_changed", "handle_invalid", "handle_expired", "source_changed", "sensitive_path_denied", "unsupported_entry", "read_too_large", "rate_limited", "io_error"];
-export type ProjectFsErrorCode = (typeof PROJECT_FS_ERROR_CODES)[number];
-export declare const PROJECT_FS_REQUIRED_ACTIONS: readonly ["retry", "refresh_project", "upgrade_daemon", "reauthenticate", "none"];
-export type ProjectFsRequiredAction = (typeof PROJECT_FS_REQUIRED_ACTIONS)[number];
-/** Server-only envelope. Clients may send this key, but Server must replace it wholesale. */
-export declare const PROJECT_FS_AUTHORITY_PARAM: "__projectFsAuthority";
-export type ProjectFsAuthority = {
-    projectRef: string;
-    scopeId: string;
-    accountScope: string;
-    machineId: string;
-    projectId: string;
-    rootPath: string;
-    rootDigest: string;
-    authorizationEpoch: number;
-    daemonInstallationId: string;
-    generation: string;
-    expiresAt: number;
-};
-export type ProjectFsTrustedEnvelope = {
-    version: 1;
-    requestId: string;
-    method: ProjectFsMethod;
-    params: ProjectFsOpenParams | ProjectFsListParams | ProjectFsReadParams | ProjectFsCloseParams;
-    authority: ProjectFsAuthority;
-    signature: string;
-};
-export type ProjectFsRejection = {
-    code: ProjectFsErrorCode;
-    message?: string;
-    retryable: boolean;
-    requiredAction: ProjectFsRequiredAction;
-};
-export declare function isProjectFsMethod(value: unknown): value is ProjectFsMethod;
-export declare function parseProjectFsDirectoryPage(value: unknown): ProjectFsDirectoryPage | null;
-export declare function parseProjectFsOpenParams(value: unknown): ProjectFsOpenParams | null;
-export declare function parseProjectFsOpenResult(value: unknown): ProjectFsOpenResult | null;
-export declare function parseProjectFsListParams(value: unknown): ProjectFsListParams | null;
-export declare function parseProjectFsListResult(value: unknown): ProjectFsListResult | null;
-export declare function parseProjectFsReadParams(value: unknown): ProjectFsReadParams | null;
-export declare function parseProjectFsReadResult(value: unknown): ProjectFsReadResult | null;
-export declare function parseProjectFsCloseParams(value: unknown): ProjectFsCloseParams | null;
-export declare function parseProjectFsCloseResult(value: unknown): ProjectFsCloseResult | null;
-export declare function parseProjectFsRejection(value: unknown): ProjectFsRejection | null;
-/** Future clients must require this exact capability and never probe legacy path RPCs. */
-export declare function hasProjectFsOpaqueCapability(capabilities: readonly string[] | null | undefined): boolean;
-export declare function parseProjectFsTrustedEnvelope(value: unknown): ProjectFsTrustedEnvelope | null;
-export declare function projectFsAuthoritySigningPayload(envelope: Omit<ProjectFsTrustedEnvelope, 'signature'>): string;

package/node_modules/@shennian/wire/dist/project-path.d.ts

@@ -1,4 +0,0 @@
-/** Matching only: never changes persisted project IDs or directory spelling. */
-export declare function normalizeProjectMatchPath(workDir: string): string;
-/** Include both existing Windows spellings in one paginated database query. */
-export declare function projectSessionPathCandidates(workDir: string): string[];

package/node_modules/@shennian/wire/dist/project.d.ts

@@ -1,16 +0,0 @@
-import type { AgentType } from './session.js';
-export type NianProject = {
-    id: string;
-    machineId: string;
-    machineName: string;
-    machineOnline: boolean;
-    workDir: string;
-    displayName: string;
-    defaultAgentType?: AgentType | null;
-    defaultModelId?: string | null;
-    lastActivityAt: string;
-    createdAt: string;
-    updatedAt: string;
-    /** Server-minted opaque reference for project-scoped file RPCs. */
-    fileBrowserRef?: string;
-};

package/node_modules/@shennian/wire/dist/relay-connectivity.d.ts

@@ -1,30 +0,0 @@
-export type RelayConnectivityPhase = 'connecting' | 'connected' | 'recovering' | 'blocked' | 'offline';
-export type RelayConnectivityReason = 'initial_connect' | 'network_offline' | 'transient_transport' | 'server_unavailable' | 'auth_required' | 'version_unsupported' | 'permission_revoked' | 'plan_required' | 'machine_unavailable' | 'unknown';
-export type RelayConnectivitySnapshot = {
-    phase: RelayConnectivityPhase;
-    reason: RelayConnectivityReason;
-    closeCode: number | null;
-    closeReason: string | null;
-    retryable: boolean;
-    retryAttempt: number;
-    nextRetryAt: number | null;
-    disconnectedAt: number | null;
-    lastConnectedAt: number | null;
-    connectionId: string | null;
-};
-export type RelayConnectivityEventName = 'relay_connect_started' | 'relay_connected' | 'relay_disconnected' | 'relay_retry_scheduled' | 'relay_watchdog_rebuild' | 'relay_manual_retry' | 'relay_recovery_succeeded' | 'relay_recovery_failed';
-export type RelayConnectivityEvent = {
-    name: RelayConnectivityEventName;
-    snapshot: RelayConnectivitySnapshot;
-    at: number;
-    durationMs?: number;
-};
-export type RelayCloseClassification = {
-    reason: RelayConnectivityReason;
-    retryable: boolean;
-};
-/**
- * The server owns close-code meaning. Keeping this map in Wire prevents App,
- * Shared and Server from drifting into different user-facing explanations.
- */
-export declare function classifyRelayClose(code: number, closeReason?: string): RelayCloseClassification;

package/node_modules/@shennian/wire/dist/room.d.ts

@@ -1,190 +0,0 @@
-import { type AgentType } from './session.ts';
-export type RoomVisibility = 'private' | 'public_read';
-export type RoomJoinPolicy = 'open' | 'approval' | 'closed';
-export type RoomStatus = 'active' | 'archived' | 'deleted';
-export type RoomPrincipalType = 'human' | 'agent';
-export type RoomMembershipRole = 'owner' | 'admin' | 'member';
-export type RoomMembershipStatus = 'active' | 'removed' | 'left';
-export type RoomMessageKind = 'text' | 'attachment' | 'mixed' | 'system';
-export type RoomActivationMode = 'auto_follow' | 'mention_only' | 'paused';
-/** Runtime reachability is orthogonal to the owner's persisted activation mode. */
-export type AgentRuntimeAvailability = 'available' | 'unavailable' | 'recovering';
-export type AgentRepairAction = 'configure' | 'retry' | null;
-export type RoomAgentParticipation = {
-    activationMode: RoomActivationMode;
-    availability: AgentRuntimeAvailability;
-};
-export type RoomActivationCapability = 'managed' | 'idle_resume' | 'notify_only';
-export type RoomBindingMode = 'managed' | 'hook_native';
-export type RoomBindingStatus = 'pending_approval' | 'active' | 'paused' | 'detached';
-/** `claude_code` is accepted only as a legacy wire value. New writers use the real AgentType. */
-export type RoomRuntimeAdapter = Exclude<AgentType, 'manager' | 'pi' | 'openclaw'> | 'claude_code';
-export type RoomAttachmentKind = 'image' | 'audio' | 'video' | 'file';
-export type RoomAttachmentStatus = 'pending' | 'uploaded' | 'scanning' | 'ready' | 'rejected' | 'expired' | 'deleted';
-/** JSON-safe representation of the database BIGINT sequence. */
-export type RoomSequence = string;
-export declare function roomRuntimeAgentType(value: string): AgentType | null;
-export declare function isRoomRuntimeAdapter(value: string): value is RoomRuntimeAdapter;
-export declare function roomRuntimeAdapterForAgent(agentType: AgentType): RoomRuntimeAdapter | null;
-export type RoomSummary = {
-    id: string;
-    name: string;
-    status: RoomStatus;
-    visibility: RoomVisibility;
-    joinPolicy: RoomJoinPolicy;
-    humanCount: number;
-    agentCount: number;
-    lastSequence: RoomSequence;
-    /** First sequence still visible to this account. Older servers may omit it. */
-    historyFromSequence?: RoomSequence;
-    lastReadSequence?: RoomSequence;
-    unreadCount?: number;
-    membershipRole?: RoomMembershipRole;
-    /** The signed-in human's relationship to this Room. Older servers may omit it. */
-    membershipStatus?: 'active' | 'left' | 'removed';
-    pinnedAt?: string | null;
-    updatedAt: string;
-    /** Optional list projection used by local-first clients to avoid per-room requests. */
-    latestMessage?: RoomMessageView | null;
-    /** Compact active-member projection for the list avatar. */
-    avatarMembers?: Array<{
-        id: string;
-        principalType: RoomPrincipalType;
-        displayAlias: string;
-        /** Stable membership ordering key; older servers may omit it. */
-        joinedAt?: string;
-        avatar?: Record<string, unknown> | null;
-        ownerAvatar?: Record<string, unknown> | null;
-    }>;
-};
-export type RoomAuthorSnapshot = {
-    membershipId: string;
-    principalType: RoomPrincipalType;
-    ownerUserId: string;
-    displayName: string;
-    ownerDisplayName?: string | null;
-    avatar?: Record<string, unknown> | null;
-};
-export type RoomMentionSnapshot = {
-    membershipId: string;
-    principalType: RoomPrincipalType;
-    displayName: string;
-};
-export type RoomAttachmentView = {
-    attachmentId: string;
-    mediaKind: RoomAttachmentKind;
-    name: string;
-    mimeType: string;
-    byteSize: RoomSequence;
-    sha256: string;
-    width?: number | null;
-    height?: number | null;
-    durationMs?: number | null;
-    status: RoomAttachmentStatus;
-    /** Authoritative object-retention deadline. Older servers may omit it. */
-    expiresAt?: string | null;
-    downloadRef: string;
-    /** Binding-scoped bearer link for direct, on-demand download by an Agent. */
-    downloadUrl?: string;
-    downloadExpiresAt?: string;
-};
-export type RoomMessageView = {
-    id: string;
-    roomId: string;
-    sequence: RoomSequence;
-    kind: RoomMessageKind;
-    source?: 'app' | 'cli' | 'managed_agent' | 'system';
-    author: RoomAuthorSnapshot;
-    mentions?: RoomMentionSnapshot[];
-    text?: string | null;
-    replyToMessageId?: string | null;
-    attachments: RoomAttachmentView[];
-    createdAt: string;
-    editedAt?: string | null;
-    deletedAt?: string | null;
-    activationCause?: {
-        causeMessageId: string;
-        rootCauseMessageId: string;
-        hopCount: number;
-    } | null;
-};
-export type RoomMessageCreatedEvent = {
-    event: 'room.message.created';
-    roomId: string;
-    sequence: RoomSequence;
-    message: RoomMessageView;
-};
-export type RoomRefreshEvent = {
-    event: 'room.created' | 'room.updated' | 'room.membership.updated' | 'room.join_request.created' | 'room.join_request.updated' | 'room.binding.updated';
-    roomId: string;
-    sequence?: RoomSequence;
-    entityId?: string;
-};
-export type RoomEvent = RoomMessageCreatedEvent | RoomRefreshEvent;
-export type RoomSyncParams = {
-    roomId: string;
-    afterSequence: RoomSequence;
-    limit?: number;
-};
-/** Public Skill + CLI read contract. It intentionally omits Room and membership IDs. */
-export type RoomCliReadParams = {
-    before?: RoomSequence;
-    after?: RoomSequence;
-    limit?: number;
-};
-export type RoomCliAttachmentView = {
-    attachmentId: string;
-    mediaKind: RoomAttachmentKind;
-    name: string;
-    mimeType: string;
-    byteSize: RoomSequence;
-    sha256: string;
-    width?: number | null;
-    height?: number | null;
-    durationMs?: number | null;
-    status: RoomAttachmentStatus;
-    downloaded?: boolean;
-    localPath?: string | null;
-};
-export type RoomCliMessageView = {
-    sequence: RoomSequence;
-    kind: RoomMessageKind;
-    source: 'app' | 'cli' | 'managed_agent' | 'system';
-    author: {
-        nickname: string;
-        type: RoomPrincipalType;
-        ownerNickname?: string;
-        avatar?: Record<string, unknown> | null;
-    };
-    mentions: Array<{
-        nickname: string;
-        type: RoomPrincipalType;
-    }>;
-    text: string | null;
-    attachments: RoomCliAttachmentView[];
-    createdAt: string;
-    editedAt: string | null;
-    deletedAt: string | null;
-};
-export type RoomCliReadResult = {
-    messages: RoomCliMessageView[];
-};
-export type RoomSendParams = {
-    roomId: string;
-    clientMessageId: string;
-    text?: string;
-    mentionMembershipIds?: string[];
-    attachmentIds?: string[];
-    replyToMessageId?: string;
-    bindingId?: string;
-};
-export type RoomBindParams = {
-    roomId: string;
-    agentIdentityId: string;
-    invocationToken: string;
-    activationCapability?: RoomActivationCapability;
-    activationMode?: RoomActivationMode;
-};
-export type RoomUnbindParams = {
-    bindingId: string;
-};