openmates 0.27.0-alpha.2 → 0.27.0-alpha.21

package/dist/{cli-CoxPyuUN.d.ts → cli-C2G3DpGo.d.ts}

@@ -41,6 +41,8 @@ interface CachedNewChatSuggestion {
 interface SyncCache {
     /** Timestamp of last successful sync */
     syncedAt: number;
+    /** Local freshness of individually saved/refreshed drafts, including known deletions. */
+    draftSyncedAt?: Record<string, number>;
     /** Total chat count as reported by the server */
     totalChatCount: number;
     /** Number of chats loaded (may be less than total if paginated) */
@@ -203,12 +205,28 @@ interface LocalConnectorRequestFrame {
     action: string;
     arguments?: Record<string, unknown>;
 }
+interface AvailableRecoveryOutputFrame {
+    record_id: string;
+    root_chat_id: string;
+    target_chat_id: string;
+    turn_id: string;
+    subject_id: string;
+    output_kind: "message" | "embed" | "diff" | "summary" | "checkpoint";
+    output_version: number;
+    chat_key_version: number;
+    message_role?: "user" | "assistant" | null;
+    root_hashed_team_id?: string | null;
+}
 declare class OpenMatesWsClient {
     private readonly interactiveHuman;
     private activeHumanChatId;
     private presenceTimer;
     private readonly socket;
     private readonly passiveTaskUpdateJobs;
+    private readonly availableRecoveryOutputPages;
+    private readonly queuedRecoveryOutputIds;
+    private recoveryOutputDiscoveryError;
+    private recoveryOutputDiscoveryComplete;
     private readonly remoteCommandReviewDeferredHandlers;
     private activeResponseCollectors;
     constructor(options: {
@@ -243,6 +261,10 @@ declare class OpenMatesWsClient {
     private bufferPassiveTaskUpdateJobs;
     private handleForceLogout;
     drainPassiveTaskUpdateJobs(): PendingTaskUpdateJobFrame[];
+    private bufferRecoveryOutputs;
+    drainAvailableRecoveryOutputPages(rootChatId?: string): AvailableRecoveryOutputFrame[][];
+    drainAvailableRecoveryOutputs(rootChatId?: string): AvailableRecoveryOutputFrame[];
+    waitForRecoveryOutputDiscovery(timeoutMs?: number): Promise<void>;
     waitForMessage(expectedType: string, predicate?: (payload: unknown) => boolean, timeoutMs?: number): Promise<WsEnvelope>;
     /**
      * Collect all frames until `terminatorType` arrives (or timeout).
@@ -421,6 +443,146 @@ interface HostedProjectFileHead {
     hasInitialHistory: boolean;
 }
 
+interface AppliedRule {
+    id: string;
+    title: string;
+    source: string;
+    revision: string;
+    body: string;
+    project_id?: string | null;
+    app_id?: string | null;
+}
+interface EventBase {
+    event_id: string;
+    created_at: number;
+    chat_id?: string;
+}
+type ChatContextEvent = EventBase & ({
+    type: "rules_loaded";
+    count: number;
+    set_key: string;
+    rules: AppliedRule[];
+} | {
+    type: "chat_direction_correction";
+    notice: string;
+    instruction: string;
+    delivery_id: string;
+    provenance?: Record<string, unknown>;
+} | {
+    type: "project_authoring_recommendation";
+    recommendation_id: string;
+    project_id: string;
+    kind: "focus" | "workflow";
+    action: "create" | "update";
+    target_id?: string | null;
+    expected_revision?: string | null;
+    title?: string;
+    team_id?: string | null;
+});
+
+/** Private saved Focus transport. Legacy conversion belongs to the server. */
+interface ProjectFocusRequirement {
+    id: string;
+    text: string;
+    type?: "semantic" | "user_confirmation";
+}
+interface CanonicalProjectFocusPhase {
+    id: string;
+    title: string;
+    instructions: string;
+    requirements: ProjectFocusRequirement[];
+}
+interface LegacyProjectFocusPhase {
+    id: string;
+    name: string;
+    instructions: string;
+}
+interface FocusDocumentBody {
+    name: string;
+    description: string;
+    when_to_use: string;
+    instructions: string;
+}
+type ProjectFocusDocument = FocusDocumentBody & ({
+    phases_version: 1;
+    phases: CanonicalProjectFocusPhase[];
+} | {
+    phases_version?: never;
+    phases: LegacyProjectFocusPhase[];
+});
+
+/** Bounded first-party context snapshots; discovery metadata never grants Project file access. */
+
+interface CustomRuleDocument {
+    id: string;
+    source: "personal" | "project";
+    project_id?: string;
+    document: string;
+}
+interface ProjectContextDocument {
+    item_id: string;
+    kind: "spec" | "fact" | "folder";
+    title: string;
+    description: string;
+    document: string;
+    revision: string;
+}
+interface ProjectFocusCatalogEntry {
+    id: string;
+    title: string;
+    summary: string;
+    revision: string;
+}
+interface ProjectFocusDocumentInput {
+    item_id: string;
+    document: string;
+    revision: string;
+}
+interface RelatedTaskCandidate {
+    task_id: string;
+    title: string;
+    summary: string;
+    project_id: string | null;
+    status: string;
+    changed_at: number;
+    revision: string;
+    explicit_dependency: boolean;
+}
+interface AcceptedPlanContext {
+    plan_id: string;
+    version: number;
+    approved_revision_id: string;
+    summary: string;
+    linked_task_id?: string;
+}
+interface CliJevContext {
+    /** Fresh server-approved current Plan, derived from existing chat/Task linkage. */
+    accepted_plan_context?: AcceptedPlanContext | null;
+    project_focus_candidates?: Array<{
+        project_id: string;
+        name: string;
+        summary: string;
+        auto_selection: boolean;
+    }>;
+    custom_rule_documents?: CustomRuleDocument[];
+    project_focus_catalog?: ProjectFocusCatalogEntry[];
+    project_focus_documents?: ProjectFocusDocumentInput[];
+    project_context_documents?: ProjectContextDocument[];
+    related_task_candidates?: RelatedTaskCandidate[];
+}
+type FocusAuthoringDocument = ProjectFocusDocument;
+
+/** Server-authorized cancellable Project activation; discovery never decrypts private context. */
+
+interface ProjectFocusCountdown {
+    chatId: string;
+    projectId: string;
+    focusId: string;
+    requestId: string;
+    expiresAt: number;
+    reject: () => Promise<void>;
+}
+
 /** Minimal model info needed for mention resolution */
 interface ModelInfo {
     id: string;
@@ -952,7 +1114,7 @@ interface LearningModeContext {
     ageGroup?: LearningModeAgeGroup | null;
     source?: "anonymous_session";
 }
-type WorkflowNodeType = "schedule_trigger" | "manual_trigger" | "webhook_trigger" | "app_skill_action" | "decision" | "check" | "send_chat_message" | "start_new_chat" | "event_trigger" | "wait" | "repeat" | "create_chat_report" | "send_notification" | "send_email_notification" | "ask_user" | "custom_code" | "end";
+type WorkflowNodeType = "schedule_trigger" | "manual_trigger" | "webhook_trigger" | "app_skill_action" | "decision" | "check" | "send_chat_message" | "start_new_chat" | "event_trigger" | "wait" | "repeat" | "for_each" | "create_chat_report" | "send_notification" | "send_email_notification" | "ask_user" | "custom_code" | "end";
 interface WorkflowNode {
     id: string;
     type: WorkflowNodeType;
@@ -977,13 +1139,36 @@ interface WorkflowGraph {
 }
 type WorkflowRunContentRetention = "last_5" | "none";
 type WorkflowRunContentStorage = "durable" | "ephemeral" | "deleted";
-type WorkflowLifecycle = "persisted" | "temporary";
+type WorkflowLifecycle = "persisted" | "temporary" | "chat_embed";
+interface WorkflowRunRouting {
+    sourceChatId?: string;
+    messageDestinationOverrides?: Record<string, string>;
+    returnOutputs?: Record<string, WorkflowReturnedOutputReference>;
+}
+interface WorkflowReturnedOutputReference {
+    ref: string;
+    type: "string" | "number" | "integer" | "boolean" | "object" | "array";
+}
+interface WorkflowRunOptions extends WorkflowRunRouting {
+    idempotencyKey: string;
+    mode?: "manual" | "test";
+    input?: Record<string, unknown>;
+}
+interface WorkflowRunOnceOptions extends WorkflowRunRouting {
+    title: string;
+    graph: WorkflowGraph;
+    idempotencyKey: string;
+    sourceChatId: string;
+    input?: Record<string, unknown>;
+}
 interface WorkflowAuthoringWarning {
     code: string;
     node_id: string;
     message: string;
 }
 interface WorkflowSummary {
+    /** Authoritative record revision used for Project authoring proposals. */
+    version?: number;
     id: string;
     slug?: string | null;
     encrypted_slug?: string | null;
@@ -1084,6 +1269,7 @@ interface ProjectSettingsRecord {
     default_focus_id_hash: string | null;
     encrypted_settings: string | null;
     updated_at: number | null;
+    auto_selection?: boolean;
 }
 interface ActiveProjectFocus {
     active: true;
@@ -1091,6 +1277,7 @@ interface ActiveProjectFocus {
     focus_id: string;
     team_id: string | null;
     activated_at: number;
+    specialist_focus_id?: string | null;
 }
 interface ProjectRemoteAccessRequestInput {
     request_id: string;
@@ -1314,6 +1501,10 @@ interface UserPlanRecord {
     encrypted_context?: string | null;
     encrypted_linked_project_ids?: string | null;
     status: UserPlanStatus;
+    /** Server-issued approval metadata; never writable through Plan create/update. */
+    approval_state?: string;
+    submitted_revision_id?: string | null;
+    approved_revision_id?: string | null;
     primary_chat_id?: string | null;
     linked_project_ids?: string[] | null;
     key_wrappers?: Array<Record<string, unknown>> | null;
@@ -1324,10 +1515,10 @@ interface UserPlanRecord {
     completed_at?: number | null;
     history?: WorkspaceHistoryResult | null;
 }
-type UserPlanCreateInput = Omit<UserPlanRecord, "version" | "completed_at"> & {
+type UserPlanCreateInput = Omit<UserPlanRecord, "version" | "completed_at" | "approval_state" | "submitted_revision_id" | "approved_revision_id"> & {
     version?: number;
 };
-type UserPlanUpdateInput = Partial<Omit<UserPlanRecord, "plan_id" | "created_at">> & {
+type UserPlanUpdateInput = Partial<Omit<UserPlanRecord, "plan_id" | "created_at" | "approval_state" | "submitted_revision_id" | "approved_revision_id">> & {
     version?: number;
 };
 interface UserPlanCriterionRecord {
@@ -1632,6 +1823,14 @@ interface ChatListItem {
     category: string | null;
     mateName: string | null;
     source?: "example";
+    parentId?: string | null;
+    isSubChat?: boolean;
+    isHiddenCandidate?: boolean;
+    isHidden?: boolean;
+    pinned?: boolean;
+    hasDraft?: boolean;
+    draftPreview?: string | null;
+    metadataUpdatedAt?: number | null;
 }
 /** A single parameter extracted from the OpenAPI skill schema. */
 interface SkillParam {
@@ -1731,6 +1930,12 @@ interface DecryptedMessage {
     modelName: string | null;
     createdAt: number;
     embedIds: string[];
+    /** Owner-local originals; never include these in model message history. */
+    piiMappings?: Array<{
+        placeholder: string;
+        original: string;
+        type?: string;
+    }>;
 }
 interface ChatMessageSummary extends DecryptedMessage {
     preview: string;
@@ -1759,6 +1964,9 @@ interface ChatMessageWindowResult {
     endCursor: ChatMessageWindowCursor | null;
     anchorFound: boolean;
     serverMessageCount: number | null;
+    storageTier?: 'hot' | 'archive' | 'mixed';
+    archivePageIds?: string[];
+    archivePayloadCache?: 'disabled';
 }
 interface ChatForkResult {
     success: boolean;
@@ -1803,8 +2011,14 @@ interface EmbedVersionsResponse {
     embed_id: string;
     current_version: number;
     versions: EmbedVersionMeta[];
+    next_cursor?: number | null;
     readonly: boolean;
 }
+interface EmbedVersionReadContext {
+    chatId?: string;
+    projectId?: string;
+    teamId?: string;
+}
 interface EmbedVersionContentResponse {
     embed_id: string;
     version_number: number;
@@ -1911,6 +2125,19 @@ interface DecryptedNewChatSuggestion {
     body: string;
     createdAt: number;
 }
+interface WikipediaLearningBundle {
+    canonical_title: string;
+    language: string;
+    source_url: string;
+    questions: string[];
+    related_articles: Array<{
+        title: string;
+        canonical_title: string;
+        language: string;
+        description: string;
+    }>;
+    expires_in_seconds: number;
+}
 /** A decrypted memory entry as returned to CLI callers. */
 interface DecryptedMemoryEntry {
     id: string;
@@ -2065,6 +2292,8 @@ declare class OpenMatesClient {
         disambiguation: boolean;
         language: string;
     }>>;
+    wikipediaSummary(title: string, language?: string): Promise<Record<string, unknown>>;
+    wikipediaLearning(title: string, language?: string): Promise<WikipediaLearningBundle>;
     startAccountExport(options?: AccountExportStartOptions): Promise<AccountExportResponse>;
     getAccountExport(exportId: string): Promise<AccountExportResponse>;
     getAccountExportManifest(exportId: string): Promise<AccountExportManifestResponse>;
@@ -2131,6 +2360,14 @@ declare class OpenMatesClient {
         message: string;
         learningMode?: LearningModeContext;
         messageHistory?: BenchmarkHistoryMessage[];
+        piiDetection?: boolean;
+        piiMappings?: Array<{
+            placeholder: string;
+            original: string;
+            type: string;
+        }>;
+        onPrivacyPrepared?: (message: string) => void;
+        onPrivacyProgress?: (done: number, total: number) => void;
     }): Promise<{
         status: "completed";
         chatId: string;
@@ -2297,6 +2534,15 @@ declare class OpenMatesClient {
      * Decrypt a single chat record from the sync cache into a ChatListItem.
      */
     private decryptChatListItem;
+    /** Global activity snapshot; decrypt only running chats and their ancestors. */
+    getChatActivity(options?: TeamContextOptions): Promise<{
+        ids: string[];
+        chats: ChatListItem[];
+    }>;
+    /** Minimal encrypted metadata; unreadable keys stay excluded from normal surfaces. */
+    getSidebarChats(ids: string[], options?: TeamContextOptions): Promise<ChatListItem[]>;
+    /** Observe lifecycle metadata without claiming or collecting AI responses. */
+    observeChatActivity(onChange: () => void): Promise<() => void>;
     listChats(limit?: number, page?: number, options?: TeamContextOptions): Promise<ChatListPage>;
     saveDraft(params: {
         markdown: string;
@@ -2341,6 +2587,7 @@ declare class OpenMatesClient {
     clearDraft(chatId: string): Promise<void>;
     reconcileDraftVersions(chatIds?: string[]): Promise<Record<string, number>>;
     private storeEncryptedDraft;
+    private markDraftCacheFresh;
     private decryptCachedDraft;
     searchChats(query: string, options?: TeamContextOptions): Promise<ChatListItem[]>;
     resolveChatKeyForContext(query: string, options?: TeamContextOptions): Promise<{
@@ -2467,13 +2714,27 @@ declare class OpenMatesClient {
      * Mirrors: chat_actions_store.ts / FollowUpSuggestions.svelte (web app)
      */
     getChatFollowUpSuggestions(chatId: string, options?: TeamContextOptions): Promise<string[]>;
+    private persistAvailableRecoveryOutputs;
+    private replayAvailableRecoveryOutputs;
+    private replayRecoveryOutputPages;
     sendMessage(params: {
         message: string;
+        /** Isolated, credential-free storage-capacity replay only. */
+        testMockMarker?: string;
         chatId?: string;
         /** Explicit user-selected Project; activates its focus before inference preflight. */
         projectId?: string;
+        /** Already authorized private snapshots; inaccessible Project documents are omitted. */
+        jevContext?: CliJevContext;
+        onChatContextApplied?: (event: ChatContextEvent) => void | Promise<void>;
+        onProjectFocusPending?: (countdown: ProjectFocusCountdown | null) => void;
         onProjectWriteApproval?: (request: ProjectWriteApprovalRequest) => boolean | Promise<boolean>;
         onProjectReadApproval?: (request: ProjectReadApprovalRequest) => boolean | Promise<boolean>;
+        /** Observe committed hosted Project file versions after the normal approval flow. */
+        onHostedVersionCommitted?: (result: {
+            embed_id: string;
+            revision: number;
+        }) => void | Promise<void>;
         onRemoteCommandReview?: (review: RemoteCommandReview) => RemoteCommandApprovalChoice | null | undefined | Promise<RemoteCommandApprovalChoice | null | undefined>;
         onRemoteCommandEvent?: (event: DecryptedRemoteCommandEvent) => void | Promise<void>;
         /** Client-generated ID for a new chat, allowing cleanup after an uncertain send outcome. */
@@ -2498,6 +2759,9 @@ declare class OpenMatesClient {
         encryptedEmbeds?: EncryptedEmbed[];
         /** Prepared embeds to encrypt after the real chat/message IDs are known. */
         preparedEmbeds?: PreparedEmbed[];
+        piiDetection?: boolean;
+        onPrivacyProgress?: (done: number, total: number) => void;
+        onPrivacyPrepared?: (message: string) => void;
         /** Placeholder-to-original PII mappings created before sending the user message. */
         piiMappings?: Array<{
             placeholder: string;
@@ -2693,13 +2957,17 @@ declare class OpenMatesClient {
         deleted: boolean;
     }>;
     keepWorkflow(workflowId: string): Promise<WorkflowDetail>;
+    saveWorkflowAsReusable(workflowId: string, options: {
+        idempotencyKey: string;
+    }): Promise<WorkflowDetail>;
+    private workflowRunRouting;
+    runWorkflowOnce(params: WorkflowRunOnceOptions): Promise<{
+        workflow: WorkflowDetail;
+        run: WorkflowRunDetail;
+    }>;
     enableWorkflow(workflowId: string): Promise<WorkflowDetail>;
     disableWorkflow(workflowId: string): Promise<WorkflowDetail>;
-    runWorkflow(workflowId: string, params: {
-        idempotencyKey: string;
-        mode?: "manual" | "test";
-        input?: Record<string, unknown>;
-    }): Promise<WorkflowRunDetail>;
+    runWorkflow(workflowId: string, params: WorkflowRunOptions): Promise<WorkflowRunDetail>;
     listWorkflowRuns(workflowId: string): Promise<WorkflowRunDetail[]>;
     getWorkflowRun(workflowId: string, runId: string): Promise<WorkflowRunDetail>;
     cancelWorkflowRun(workflowId: string, runId: string): Promise<WorkflowRunCancellationResult>;
@@ -2750,12 +3018,76 @@ declare class OpenMatesClient {
         default_focus_id?: string;
         encrypted_settings?: string;
         updated_at?: number;
+        auto_selection?: boolean;
     }, options?: TeamContextOptions): Promise<ProjectSettingsRecord>;
     activateProjectFocus(projectId: string, input: {
         chat_id: string;
         focus_id: string;
         instruction: string;
+        activation_request_id?: string;
     }, options?: TeamContextOptions): Promise<ActiveProjectFocus>;
+    confirmProjectFocusCountdown(projectId: string, input: {
+        chat_id: string;
+        activation_request_id: string;
+    }, options?: TeamContextOptions): Promise<void>;
+    getCustomRuleDocuments(): Promise<NonNullable<CliJevContext["custom_rule_documents"]>>;
+    decryptTaskContextRecord(record: UserTaskRecord, options?: TeamContextOptions): Promise<DecryptedUserTask>;
+    selectProjectContext(projectId: string, input: {
+        chat_id: string;
+        text: string;
+        candidates: Array<{
+            kind: "focus" | "rule" | "spec" | "fact" | "folder";
+            id: string;
+            title: string;
+            description: string;
+            when_to_use: string;
+            revision: string;
+        }>;
+    }, options?: TeamContextOptions): Promise<Array<{
+        id: string;
+        kind: string;
+        revision: string;
+    }>>;
+    requestProjectAuthoringRecommendations(projectId: string, input: {
+        chat_id: string;
+        message_id: string;
+        team_id?: string | null;
+        catalog: Array<{
+            kind: "focus" | "workflow";
+            id: string;
+            title: string;
+            summary: string;
+            revision: string;
+        }>;
+        history: Array<{
+            role: "user" | "assistant";
+            content: string;
+        }>;
+    }): Promise<Array<Record<string, unknown>>>;
+    inspectProjectFocusRecommendation(projectId: string, input: {
+        assessment_id: string;
+        history: Array<{
+            role: "user" | "assistant";
+            content: string;
+        }>;
+        document: FocusAuthoringDocument;
+    }): Promise<Record<string, unknown> | null>;
+    startProjectAuthoringJob(projectId: string, input: {
+        recommendation_id: string;
+        expected_revision: string | null;
+        history: Array<{
+            role: "user" | "assistant";
+            content: string;
+        }>;
+        target?: FocusAuthoringDocument;
+        remote_binding?: Record<string, unknown>;
+        timezone?: string;
+    }): Promise<Record<string, unknown>>;
+    getProjectAuthoringJob(projectId: string, jobId: string): Promise<Record<string, unknown>>;
+    getChatEncryptionKey(chatId: string, options?: TeamContextOptions): Promise<Uint8Array>;
+    openProjectAuthoringWebSocket(): Promise<OpenMatesWsClient>;
+    commitHostedProjectFileRevision(payload: Record<string, unknown>): Promise<Record<string, unknown>>;
+    acknowledgeProjectAuthoringSave(projectId: string, jobId: string, kind: "focus" | "workflow", input: Record<string, unknown>): Promise<Record<string, unknown>>;
     getActiveProjectFocus(chatId: string): Promise<ActiveProjectFocus | null>;
     deactivateProjectFocus(chatId: string): Promise<void>;
     /** Request cancellation of an active AI response and wait for the server receipt. */
@@ -2787,8 +3119,11 @@ declare class OpenMatesClient {
     }): Promise<Record<string, unknown>>;
     planProjectAsk(input: {
         instruction: string;
+        chatTitles?: string[];
     }): Promise<Record<string, unknown>>;
-    listProjectItems(projectId: string, options?: TeamContextOptions): Promise<{
+    listProjectItems(projectId: string, options?: TeamContextOptions & {
+        chatOnly?: boolean;
+    }): Promise<{
         folders: Array<Record<string, unknown>>;
         items: ProjectItemRecord[];
     }>;
@@ -2822,7 +3157,10 @@ declare class OpenMatesClient {
         ws: OpenMatesWsClient;
         ownerId: string;
     }>;
-    createProjectItem(projectId: string, input: ProjectItemCreateInput): Promise<ProjectItemRecord>;
+    createProjectItem(projectId: string, input: ProjectItemCreateInput, options?: TeamContextOptions): Promise<ProjectItemRecord>;
+    moveProjectItemToFolder(projectId: string, itemId: string, folderId: string | null, options?: TeamContextOptions): Promise<void>;
+    updateProjectItemMetadata(projectId: string, itemId: string, metadataEncrypted: string, options?: TeamContextOptions, expectedRevision?: string): Promise<void>;
+    createProjectFolder(projectId: string, input: Record<string, unknown>, options?: TeamContextOptions): Promise<void>;
     deleteProjectItemByTarget(projectId: string, itemType: "embed" | "chat" | "workflow", targetId: string, options?: TeamContextOptions): Promise<{
         deleted: boolean;
         deleted_count: number;
@@ -2899,7 +3237,7 @@ declare class OpenMatesClient {
     deleteUserTaskActivity(taskId: string, entryId: string, context?: TeamContextOptions): Promise<UserTaskActivityRecord>;
     addTaskDependency(taskId: string, targetRef: string): Promise<WorkDependencyRecord>;
     removeTaskDependency(taskId: string, targetKind: "plan" | "task", targetId: string): Promise<Record<string, unknown>>;
-    getTaskDependencies(taskId: string): Promise<{
+    getTaskDependencies(taskId: string, options?: TeamContextOptions): Promise<{
         dependencies: WorkDependencyRecord[];
         blockers: WorkDependencyRecord[];
     }>;
@@ -2917,6 +3255,9 @@ declare class OpenMatesClient {
         teamId?: string | null;
         personal?: boolean;
     }): Promise<UserPlanRecord[]>;
+    getUserPlan(planId: string, options?: TeamContextOptions): Promise<UserPlanRecord>;
+    /** Decrypt only the selected Plan's direction summary fields, without authoring or changing approval. */
+    decryptPlanContextSummary(record: UserPlanRecord, options?: TeamContextOptions): Promise<string>;
     createUserPlan(input: UserPlanCreateInput): Promise<UserPlanRecord>;
     askUserPlans(input: {
         instruction: string;
@@ -3156,14 +3497,17 @@ declare class OpenMatesClient {
      * @returns Full share URL, e.g. https://openmates.org/share/embed/{id}#key={blob}
      */
     createEmbedShareLink(embedIdOrShort: string, durationSeconds?: ShareDuration, password?: string): Promise<string>;
-    listEmbedVersions(embedIdOrShort: string): Promise<EmbedVersionsResponse>;
+    private embedVersionReadQuery;
+    listEmbedVersions(embedIdOrShort: string, context?: EmbedVersionReadContext): Promise<EmbedVersionsResponse>;
     startApplicationPreview(params: ApplicationPreviewStartParams): Promise<ApplicationPreviewStartResponse>;
     getApplicationPreviewStatus(sessionId: string): Promise<ApplicationPreviewStatusResponse>;
     openApplicationPreview(sessionId: string): Promise<ApplicationPreviewStatusResponse>;
     stopApplicationPreview(sessionId: string): Promise<ApplicationPreviewStopResponse>;
-    getEmbedVersion(embedIdOrShort: string, version: number): Promise<EmbedVersionContentResponse>;
+    getEmbedVersion(embedIdOrShort: string, version: number, context?: EmbedVersionReadContext): Promise<EmbedVersionContentResponse>;
+    private publishEmbedSnapshotFromContent;
     restoreEmbedVersion(embedIdOrShort: string, version: number): Promise<EmbedVersionRestoreResponse>;
     private reconstructEncryptedEmbedVersion;
+    private resolveVersionEmbedKey;
     private formatEmbedVersionError;
     private formatApplicationPreviewError;
     private resolveEmbedId;
@@ -3353,6 +3697,8 @@ declare function classifyImagesAiDetection(score: number | null | undefined): Im
 declare function formatImagesAiDetectionLabel(classification: ImagesAiDetectionClassification): string;
 declare function buildImagesAiDetectionSummary(uploadResult: UploadFileResponse, filePath: string): ImagesAiDetectionSummary;
 declare function buildTravelConnectionsRequest(positionals: string[], flags: Record<string, string | boolean>): Record<string, unknown>;
+/** Keep E2E auto-generated setup codes away from the TOTP rollover. */
+declare function waitForSafeE2ETotpWindow(now?: () => number, sleep?: (milliseconds: number) => Promise<void>): Promise<void>;
 /** Keep account output curated; complete API fields remain available with --json. */
 declare function printWhoAmI(user: Record<string, unknown>, client: Pick<OpenMatesClient, "apiUrl" | "getActiveTeamId" | "searchChats">): Promise<void>;
 /** Format a share duration for display */
@@ -3364,5 +3710,6 @@ declare function printWhoAmI(user: Record<string, unknown>, client: Pick<OpenMat
 declare function serializeToYaml(data: Record<string, unknown>, indent?: number): string;
 /** Map language identifier to file extension for code embed downloads. */
 declare function getExtForLang(language: string): string;
+declare function handleWiki(client: OpenMatesClient, action: string | undefined, rest: string[], flags: Record<string, string | boolean>): Promise<void>;
 
-export { type CachedChat as $, type WorkflowGraph as A, type WorkflowRunContentRetention as B, type WorkflowRunDetail as C, type DecryptedUserTask as D, type ExternalChatContext as E, type WorkflowNode as F, type WorkflowRunCancellationResult as G, type WorkflowTemplateProjectionUpsertParams as H, type WorkflowTemplateProjectionResult as I, type PublicWorkflowTemplateProjection as J, type WorkflowTemplateProjectionRevocationResult as K, type WorkflowTemplateBindingCompletionParams as L, type WorkflowTemplateBindingCompletionResult as M, type WorkflowTemplateShortUrlParams as N, type WorkflowTemplateShortUrlResult as O, type ProjectItemRecord as P, type WorkflowTemplateImportPayload as Q, type ImportedWorkflowTemplate as R, type ShortUrlRevokeResult as S, type TaskCreateOptions as T, type UserPlanStatus as U, type AuthMethodsStatus as V, type WorkflowSummary as W, type AuthoritativeChatReconciliation as X, type BackupCodesResult as Y, type BankTransferOrderDetails as Z, type BankTransferStatus as _, type UserPlanRecord as a, type CachedNewChatSuggestion as a0, type ChatListPage as a1, type CliSignupResult as a2, type DecryptedDraft as a3, type DecryptedEmbed as a4, type DecryptedMemoryEntry as a5, type DecryptedMessage as a6, type DecryptedNewChatSuggestion as a7, type DocsFile as a8, type DocsFolder as a9, getExtForLang as aA, normalizeInterestTagIds as aB, reconcileAuthoritativeChats as aC, serializeToYaml as aD, assertTrustedAccountCommandAllowed as aE, assertTrustedAccountGuardEnvironment as aF, buildProjectDefaultFocus as aG, buildTravelConnectionsRequest as aH, extractExplicitProjectMentions as aI, printWhoAmI as aJ, readRootProjectInstructions as aK, renderProjectReadApprovalRequest as aL, renderProjectWriteApprovalRequest as aM, renderRemoteCommandEvent as aN, requireExactConfirmation as aO, resolveProjectContext as aP, shouldRequireTrustedAccountGuard as aQ, waitForWorkflowRun as aR, type DocsSearchResult as aa, type DocsTree as ab, type EncryptedDraft as ac, type GiftCardBankTransferStatus as ad, INTEREST_TAG_IDS as ae, type ImagesAiDetectionClassification as af, type ImagesAiDetectionSummary as ag, type InterestTagId as ah, MATE_NAMES as ai, MEMORY_TYPE_REGISTRY as aj, type MemoryFieldDef as ak, type MemoryTypeDef as al, OpenMatesClient as am, type OpenMatesClientOptions as an, type OpenMatesSession as ao, type SyncCache as ap, type TopicPreferencesPayload as aq, type TotpSetupStartResult as ar, type WorkflowEdge as as, type WorkflowNodeRun as at, type WorkflowNodeType as au, type WorkflowRunContentStorage as av, buildImagesAiDetectionSummary as aw, classifyImagesAiDetection as ax, deriveAppUrl as ay, formatImagesAiDetectionLabel as az, type UserPlanVerificationStatus as b, type UserPlanLearningType as c, type UserPlanLearningTargetKind as d, type UserPlanLearningStatus as e, type UserPlanLearningLevel as f, type UserPlanLearningRecord as g, type UserPlanCriterionRecord as h, type UserPlanVerificationRecord as i, type UserPlanCreateInput as j, type UserPlanUpdateInput as k, type TaskUpdateOptions as l, type UserPlanLearningCreateTasksInput as m, type UserPlanLearningCreateTasksResult as n, type UserTaskStatus as o, type TaskPriorityLevel as p, type DecryptedTaskActivityEntry as q, type TaskActivityCreateOptions as r, type UserTaskReorderInput as s, type WorkflowCapability as t, type WorkflowDetail as u, type WorkflowAuthoringWarning as v, type WorkflowInputStartParams as w, type WorkflowInputSessionResult as x, type WorkflowInputSessionDetail as y, type WorkflowInputEvent as z };
+export { type BackupCodesResult as $, type WorkflowGraph as A, type WorkflowRunContentRetention as B, type WorkflowRunOnceOptions as C, type DecryptedUserTask as D, type ExternalChatContext as E, type WorkflowRunDetail as F, type WorkflowRunOptions as G, type WorkflowNode as H, type WorkflowRunCancellationResult as I, type WorkflowTemplateProjectionUpsertParams as J, type WorkflowTemplateProjectionResult as K, type PublicWorkflowTemplateProjection as L, type WorkflowTemplateProjectionRevocationResult as M, type WorkflowTemplateBindingCompletionParams as N, type WorkflowTemplateBindingCompletionResult as O, type ProjectItemRecord as P, type WorkflowTemplateShortUrlParams as Q, type WorkflowTemplateShortUrlResult as R, type ShortUrlRevokeResult as S, type TaskCreateOptions as T, type UserPlanStatus as U, type WorkflowTemplateImportPayload as V, type WorkflowSummary as W, type ImportedWorkflowTemplate as X, type WikipediaLearningBundle as Y, type AuthMethodsStatus as Z, type AuthoritativeChatReconciliation as _, type UserPlanRecord as a, type BankTransferOrderDetails as a0, type BankTransferStatus as a1, type CachedChat as a2, type CachedNewChatSuggestion as a3, type ChatListPage as a4, type CliSignupResult as a5, type DecryptedDraft as a6, type DecryptedEmbed as a7, type DecryptedMemoryEntry as a8, type DecryptedMessage as a9, type WorkflowRunRouting as aA, buildImagesAiDetectionSummary as aB, classifyImagesAiDetection as aC, deriveAppUrl as aD, formatImagesAiDetectionLabel as aE, getExtForLang as aF, normalizeInterestTagIds as aG, reconcileAuthoritativeChats as aH, serializeToYaml as aI, assertTrustedAccountCommandAllowed as aJ, assertTrustedAccountGuardEnvironment as aK, buildProjectDefaultFocus as aL, buildTravelConnectionsRequest as aM, extractExplicitProjectMentions as aN, handleWiki as aO, printWhoAmI as aP, readRootProjectInstructions as aQ, renderProjectReadApprovalRequest as aR, renderProjectWriteApprovalRequest as aS, renderRemoteCommandEvent as aT, requireExactConfirmation as aU, resolveProjectContext as aV, shouldRequireTrustedAccountGuard as aW, waitForSafeE2ETotpWindow as aX, waitForWorkflowRun as aY, type DecryptedNewChatSuggestion as aa, type DocsFile as ab, type DocsFolder as ac, type DocsSearchResult as ad, type DocsTree as ae, type EncryptedDraft as af, type GiftCardBankTransferStatus as ag, INTEREST_TAG_IDS as ah, type ImagesAiDetectionClassification as ai, type ImagesAiDetectionSummary as aj, type InterestTagId as ak, MATE_NAMES as al, MEMORY_TYPE_REGISTRY as am, type MemoryFieldDef as an, type MemoryTypeDef as ao, OpenMatesClient as ap, type OpenMatesClientOptions as aq, type OpenMatesSession as ar, type SyncCache as as, type TopicPreferencesPayload as at, type TotpSetupStartResult as au, type WorkflowEdge as av, type WorkflowNodeRun as aw, type WorkflowNodeType as ax, type WorkflowReturnedOutputReference as ay, type WorkflowRunContentStorage as az, type UserPlanVerificationStatus as b, type UserPlanLearningType as c, type UserPlanLearningTargetKind as d, type UserPlanLearningStatus as e, type UserPlanLearningLevel as f, type UserPlanLearningRecord as g, type UserPlanCriterionRecord as h, type UserPlanVerificationRecord as i, type UserPlanCreateInput as j, type UserPlanUpdateInput as k, type TaskUpdateOptions as l, type UserPlanLearningCreateTasksInput as m, type UserPlanLearningCreateTasksResult as n, type UserTaskStatus as o, type TaskPriorityLevel as p, type DecryptedTaskActivityEntry as q, type TaskActivityCreateOptions as r, type UserTaskReorderInput as s, type WorkflowCapability as t, type WorkflowDetail as u, type WorkflowAuthoringWarning as v, type WorkflowInputStartParams as w, type WorkflowInputSessionResult as x, type WorkflowInputSessionDetail as y, type WorkflowInputEvent as z };

package/dist/cli.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export { af as ImagesAiDetectionClassification, ag as ImagesAiDetectionSummary, aE as assertTrustedAccountCommandAllowed, aF as assertTrustedAccountGuardEnvironment, aw as buildImagesAiDetectionSummary, aG as buildProjectDefaultFocus, aH as buildTravelConnectionsRequest, ax as classifyImagesAiDetection, aI as extractExplicitProjectMentions, az as formatImagesAiDetectionLabel, aA as getExtForLang, aJ as printWhoAmI, aK as readRootProjectInstructions, aL as renderProjectReadApprovalRequest, aM as renderProjectWriteApprovalRequest, aN as renderRemoteCommandEvent, aO as requireExactConfirmation, aP as resolveProjectContext, aD as serializeToYaml, aQ as shouldRequireTrustedAccountGuard, aR as waitForWorkflowRun } from './cli-CoxPyuUN.js';
+export { ai as ImagesAiDetectionClassification, aj as ImagesAiDetectionSummary, aJ as assertTrustedAccountCommandAllowed, aK as assertTrustedAccountGuardEnvironment, aB as buildImagesAiDetectionSummary, aL as buildProjectDefaultFocus, aM as buildTravelConnectionsRequest, aC as classifyImagesAiDetection, aN as extractExplicitProjectMentions, aE as formatImagesAiDetectionLabel, aF as getExtForLang, aO as handleWiki, aP as printWhoAmI, aQ as readRootProjectInstructions, aR as renderProjectReadApprovalRequest, aS as renderProjectWriteApprovalRequest, aT as renderRemoteCommandEvent, aU as requireExactConfirmation, aV as resolveProjectContext, aI as serializeToYaml, aW as shouldRequireTrustedAccountGuard, aX as waitForSafeE2ETotpWindow, aY as waitForWorkflowRun } from './cli-C2G3DpGo.js';

package/dist/cli.js

@@ -9,6 +9,7 @@ import {
   extractExplicitProjectMentions,
   formatImagesAiDetectionLabel,
   getExtForLang,
+  handleWiki,
   printWhoAmI,
   readRootProjectInstructions,
   renderProjectReadApprovalRequest,
@@ -18,9 +19,12 @@ import {
   resolveProjectContext,
   serializeToYaml,
   shouldRequireTrustedAccountGuard,
+  waitForSafeE2ETotpWindow,
   waitForWorkflowRun
-} from "./chunk-S7KAERLW.js";
+} from "./chunk-UIW7XY2C.js";
+import "./chunk-FRNW5Q2V.js";
 import "./chunk-IWKP55ZB.js";
+import "./chunk-4IRYB3YN.js";
 import "./chunk-BBKJZ23O.js";
 export {
   assertTrustedAccountCommandAllowed,
@@ -32,6 +36,7 @@ export {
   extractExplicitProjectMentions,
   formatImagesAiDetectionLabel,
   getExtForLang,
+  handleWiki,
   printWhoAmI,
   readRootProjectInstructions,
   renderProjectReadApprovalRequest,
@@ -41,5 +46,6 @@ export {
   resolveProjectContext,
   serializeToYaml,
   shouldRequireTrustedAccountGuard,
+  waitForSafeE2ETotpWindow,
   waitForWorkflowRun
 };