openmates 0.14.7 → 0.14.8-alpha.0

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   getExtForLang,
   serializeToYaml
-} from "./chunk-U2RKIE56.js";
+} from "./chunk-7BIVPFKJ.js";
 import "./chunk-AXNRPVLE.js";
 export {
   getExtForLang,

package/dist/index.d.ts

@@ -324,6 +324,7 @@ type WorkflowLifecycle = "persisted" | "temporary";
 interface WorkflowSummary {
     id: string;
     title: string;
+    description?: string | null;
     status: "draft" | "active" | "disabled" | "error" | "deleted";
     enabled: boolean;
     lifecycle?: WorkflowLifecycle;
@@ -379,10 +380,13 @@ interface ProjectSourceRecord {
 type ProjectSourceCreateInput = ProjectSourceRecord;
 interface UserTaskRecord {
     task_id: string;
+    short_id?: string | null;
+    short_id_prefix?: string | null;
     encrypted_task_key?: string | null;
     encrypted_title: string;
     encrypted_description?: string | null;
     encrypted_tags?: string | null;
+    encrypted_linked_project_ids?: string | null;
     encrypted_activity_summary?: string | null;
     encrypted_latest_instruction?: string | null;
     status: UserTaskStatus;
@@ -391,9 +395,14 @@ interface UserTaskRecord {
     primary_chat_id?: string | null;
     linked_project_ids?: string[] | null;
     parent_task_id?: string | null;
+    plan_id?: string | null;
+    plan_step_id?: string | null;
+    task_type?: "work" | "verification" | null;
+    verification_id?: string | null;
     due_at?: number | null;
     priority?: number;
     position?: number;
+    queue_state?: "none" | "waiting" | "active" | "skipped" | "waiting_for_user" | string | null;
     version?: number;
     created_at?: number;
     updated_at?: number;
@@ -485,7 +494,7 @@ interface WorkflowRunDetail {
     workflow_id: string;
     version_id: string;
     trigger_type: string;
-    status: "queued" | "running" | "waiting" | "completed" | "failed" | "cancelled";
+    status: "queued" | "running" | "waiting" | "cancellation_requested" | "completed" | "failed" | "cancelled";
     started_at?: number | null;
     finished_at?: number | null;
     error_summary?: string | null;
@@ -499,6 +508,10 @@ interface WorkflowRunDetail {
     node_runs?: WorkflowNodeRun[];
     output_summary?: Record<string, unknown>;
 }
+interface WorkflowRunCancellationResult {
+    run_id: string;
+    status: "cancellation_requested" | "cancelled";
+}
 type WorkflowInputType = "text" | "audio";
 interface WorkflowInputStartParams {
     text?: string | null;
@@ -540,6 +553,67 @@ interface WorkflowCapability {
     reason?: string | null;
     metadata?: Record<string, unknown>;
 }
+interface WorkflowTemplateProjectionUpsertParams {
+    templateId: string;
+    sourceVersion: number;
+    ciphertext: string;
+    ciphertextChecksum: string;
+    ownerWrappedKey: string;
+    projectionSchemaVersion: number;
+}
+interface WorkflowTemplateProjectionResult {
+    template_id: string;
+    source_version: number;
+    updated_at: number;
+}
+interface PublicWorkflowTemplateProjection {
+    template_id: string;
+    ciphertext: string;
+    ciphertext_checksum: string;
+    projection_schema_version: number;
+}
+interface WorkflowTemplateProjectionRevocationResult {
+    template_id: string;
+    revoked_at: number | null;
+}
+interface WorkflowTemplateBindingCompletionParams {
+    type: string;
+    nodeId: string;
+}
+interface WorkflowTemplateBindingCompletionResult {
+    workflow_id: string;
+    binding_requirement: Record<string, unknown>;
+    completed: boolean;
+}
+interface WorkflowTemplateImportPayload {
+    template_version: number;
+    title: string;
+    description?: string | null;
+    trigger_template: Record<string, unknown>;
+    node_templates?: Array<Record<string, unknown>>;
+    edge_templates?: Array<Record<string, unknown>>;
+    variables_schema?: Record<string, unknown>;
+    required_capabilities?: string[];
+    binding_requirements?: Array<Record<string, unknown>>;
+}
+interface ImportedWorkflowTemplate extends WorkflowDetail {
+    binding_requirements: Array<Record<string, unknown>>;
+}
+interface WorkflowTemplateShortUrlParams {
+    token: string;
+    encryptedUrl: string;
+    templateId: string;
+    ttlSeconds?: number | null;
+    passwordProtected?: boolean;
+}
+interface WorkflowTemplateShortUrlResult {
+    success: boolean;
+    expires_at?: number | null;
+}
+interface ShortUrlRevokeResult {
+    success: boolean;
+    revoked_at?: number | null;
+}
 type InterestTagId = "software_development" | "business_development" | "life_coach_psychology" | "medical_health" | "legal_law" | "finance" | "design" | "marketing_sales" | "science" | "history" | "cooking_food" | "electrical_engineering" | "maker_prototyping" | "movies_tv" | "activism" | "general_knowledge" | "find_events" | "find_restaurant" | "find_doctor_appointments" | "plot_charts" | "video_tutorials" | "find_apartments" | "build_electronics" | "diy_projects" | "create_videos" | "find_travel_connections" | "plan_trips" | "discuss_news" | "discuss_videos" | "run_code" | "privacy" | "learning" | "writing";
 interface TopicPreferencesPayload {
     version: 1;
@@ -597,6 +671,22 @@ interface ChatListPage {
     limit: number;
     hasMore: boolean;
 }
+interface EncryptedDraft {
+    chatId: string;
+    encryptedDraftMd: string;
+    encryptedDraftPreview: string | null;
+    draftV: number;
+}
+interface DecryptedDraft extends EncryptedDraft {
+    markdown: string;
+    preview: string | null;
+}
+interface AuthoritativeChatReconciliation {
+    authoritative: boolean;
+    authoritative_chat_ids?: string[];
+    deleted_chat_ids?: string[];
+}
+declare function reconcileAuthoritativeChats(chats: CachedChat[], evidence: AuthoritativeChatReconciliation): CachedChat[];
 interface BenchmarkMetadata {
     source: "benchmark";
     benchmark_run_id: string;
@@ -929,6 +1019,22 @@ declare class OpenMatesClient {
      */
     private decryptChatListItem;
     listChats(limit?: number, page?: number): Promise<ChatListPage>;
+    saveDraft(params: {
+        markdown: string;
+        preview?: string | null;
+        chatId?: string;
+    }): Promise<DecryptedDraft>;
+    saveEncryptedDraft(params: {
+        chatId: string;
+        encryptedDraftMd: string;
+        encryptedDraftPreview?: string | null;
+    }): Promise<EncryptedDraft>;
+    listDrafts(forceRefresh?: boolean): Promise<DecryptedDraft[]>;
+    getDraft(chatId: string, forceRefresh?: boolean): Promise<DecryptedDraft | null>;
+    clearDraft(chatId: string): Promise<void>;
+    reconcileDraftVersions(): Promise<Record<string, number>>;
+    private storeEncryptedDraft;
+    private decryptCachedDraft;
     searchChats(query: string): Promise<ChatListItem[]>;
     /**
      * Get the decrypted messages for a specific chat.
@@ -1126,6 +1232,27 @@ declare class OpenMatesClient {
         createdByAssistant?: boolean;
         autoDeleteAt?: number | null;
     }): Promise<WorkflowDetail>;
+    validateWorkflowYaml(source: string): Promise<{
+        draft_valid: boolean;
+        enable_ready: boolean;
+        diagnostics: Array<Record<string, unknown>>;
+    }>;
+    createWorkflowYaml(source: string): Promise<{
+        workflow: WorkflowDetail;
+        validation: {
+            draft_valid: boolean;
+            enable_ready: boolean;
+            diagnostics: Array<Record<string, unknown>>;
+        };
+    }>;
+    updateWorkflowYaml(workflowId: string, source: string): Promise<{
+        workflow: WorkflowDetail;
+        validation: {
+            draft_valid: boolean;
+            enable_ready: boolean;
+            diagnostics: Array<Record<string, unknown>>;
+        };
+    }>;
     getWorkflow(workflowId: string): Promise<WorkflowDetail>;
     updateWorkflow(workflowId: string, params: {
         title?: string;
@@ -1139,13 +1266,28 @@ declare class OpenMatesClient {
     keepWorkflow(workflowId: string): Promise<WorkflowDetail>;
     enableWorkflow(workflowId: string): Promise<WorkflowDetail>;
     disableWorkflow(workflowId: string): Promise<WorkflowDetail>;
-    runWorkflow(workflowId: string, params?: {
+    runWorkflow(workflowId: string, params: {
+        idempotencyKey: string;
         mode?: "manual" | "test";
         input?: Record<string, unknown>;
     }): Promise<WorkflowRunDetail>;
     listWorkflowRuns(workflowId: string): Promise<WorkflowRunDetail[]>;
     getWorkflowRun(workflowId: string, runId: string): Promise<WorkflowRunDetail>;
+    cancelWorkflowRun(workflowId: string, runId: string): Promise<WorkflowRunCancellationResult>;
+    testWorkflowStep(workflowId: string, stepId: string, params?: {
+        input?: Record<string, unknown>;
+        confirmed?: boolean;
+    }): Promise<WorkflowRunDetail>;
+    respondToWorkflowRun(workflowId: string, runId: string, stepId: string, input: Record<string, unknown>): Promise<WorkflowRunDetail>;
     listWorkflowCapabilities(): Promise<WorkflowCapability[]>;
+    upsertWorkflowTemplateProjection(workflowId: string, params: WorkflowTemplateProjectionUpsertParams): Promise<WorkflowTemplateProjectionResult>;
+    getPublicWorkflowTemplateProjection(templateId: string): Promise<PublicWorkflowTemplateProjection>;
+    revokeWorkflowTemplateProjection(workflowId: string): Promise<WorkflowTemplateProjectionRevocationResult>;
+    unrevokeWorkflowTemplateProjection(workflowId: string): Promise<WorkflowTemplateProjectionRevocationResult>;
+    completeImportedWorkflowBinding(workflowId: string, params: WorkflowTemplateBindingCompletionParams): Promise<WorkflowTemplateBindingCompletionResult>;
+    createWorkflowTemplateShortUrl(params: WorkflowTemplateShortUrlParams): Promise<WorkflowTemplateShortUrlResult>;
+    revokeShortUrl(token: string): Promise<ShortUrlRevokeResult>;
+    importWorkflowTemplate(payload: WorkflowTemplateImportPayload): Promise<ImportedWorkflowTemplate>;
     startWorkflowInput(params: WorkflowInputStartParams): Promise<WorkflowInputSessionResult>;
     getWorkflowInputSession(sessionId: string): Promise<WorkflowInputSessionDetail>;
     listWorkflowInputEvents(sessionId: string, afterEventId?: number): Promise<WorkflowInputEvent[]>;
@@ -1163,6 +1305,16 @@ declare class OpenMatesClient {
     createUserTask(input: UserTaskCreateInput): Promise<UserTaskRecord>;
     updateUserTask(taskId: string, input: UserTaskUpdateInput): Promise<UserTaskRecord>;
     startUserTaskWithAI(taskId: string, input?: UserTaskStartAIInput): Promise<UserTaskRecord>;
+    deleteUserTask(taskId: string): Promise<{
+        deleted?: boolean;
+        task_id?: string;
+    }>;
+    completeUserTask(taskId: string, input?: Record<string, unknown>): Promise<UserTaskRecord>;
+    blockUserTask(taskId: string, input?: Record<string, unknown>): Promise<UserTaskRecord>;
+    unblockUserTask(taskId: string, input?: Record<string, unknown>): Promise<UserTaskRecord>;
+    skipUserTask(taskId: string, input?: Record<string, unknown>): Promise<UserTaskRecord>;
+    reorderUserTasks(input: Record<string, unknown>): Promise<UserTaskRecord[]>;
+    postUserTaskAction(taskId: string, action: string, input?: Record<string, unknown>): Promise<UserTaskRecord>;
     listUserPlans(filters?: {
         status?: UserPlanStatus;
         chatId?: string;
@@ -1362,7 +1514,7 @@ declare class OpenMatesClient {
     private ensureEmailEncryptionKey;
     private hydrateEmailEncryptionKey;
     private requireSession;
-    private getMasterKeyBytes;
+    getMasterKeyBytes(): Uint8Array;
     private decryptTopicPreferences;
     private decryptSettingsRecord;
     private getValidSessionFromDisk;
@@ -4129,10 +4281,14 @@ declare class GeneratedAppSkills {
 interface OpenMatesOptions {
     apiKey?: string;
     apiUrl?: string;
+    deviceId?: string;
+    deviceIdPath?: string;
 }
 interface ChatCreateOptions {
     saveToAccount?: boolean;
     focusMode?: FocusModeSelection;
+    chatId?: string;
+    title?: string;
 }
 interface ChatSendOptions extends ChatCreateOptions {
     history?: Array<Record<string, unknown>> | {
@@ -4140,6 +4296,8 @@ interface ChatSendOptions extends ChatCreateOptions {
     };
     memoryIds?: string[];
     model?: string;
+    recoveryPollIntervalMs?: number;
+    recoveryTimeoutMs?: number;
 }
 interface ChatListOptions {
     limit?: number;
@@ -4164,6 +4322,26 @@ interface EncryptedChatMetadata {
     created_at?: string | number;
     [key: string]: unknown;
 }
+interface EncryptedDraftRecord {
+    chatId: string;
+    encryptedDraftMd: string;
+    encryptedDraftPreview: string | null;
+    draftV: number;
+}
+interface DraftRecord extends EncryptedDraftRecord {
+    markdown: string;
+    preview: string | null;
+}
+interface SdkSessionResponse {
+    user?: {
+        id?: string;
+    };
+    key_wrapper?: {
+        encrypted_key?: string;
+        salt?: string;
+        key_iv?: string;
+    };
+}
 interface ChatResponse {
     content?: string;
     [key: string]: unknown;
@@ -4195,6 +4373,7 @@ declare class OpenMates {
     readonly chats: OpenMatesChats;
     readonly connectedAccounts: OpenMatesConnectedAccounts;
     readonly docs: OpenMatesDocs;
+    readonly drafts: OpenMatesDrafts;
     readonly embeds: OpenMatesEmbeds;
     readonly feedback: OpenMatesFeedback;
     readonly inspirations: OpenMatesInspirations;
@@ -4210,13 +4389,17 @@ declare class OpenMates {
     readonly workflows: OpenMatesWorkflows;
     private readonly apiKey?;
     private readonly apiUrl;
+    private readonly deviceId;
+    private sdkSessionPromise?;
     private masterKeyPromise?;
     constructor(options?: OpenMatesOptions);
     runAppSkill<T = unknown>(appId: string, skillId: string, input: unknown): Promise<T>;
-    request<T>(path: string, body?: unknown): Promise<T>;
+    request<T>(path: string, body?: unknown, timeoutMs?: number, extraHeaders?: Record<string, string>): Promise<T>;
     patch<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
     delete<T>(path: string, body?: unknown): Promise<T>;
     get<T>(path: string): Promise<T>;
+    getPublic<T>(path: string): Promise<T>;
     getRaw(path: string): Promise<{
         contentType: string;
         filename?: string;
@@ -4224,6 +4407,7 @@ declare class OpenMates {
     }>;
     webOrigin(): string;
     masterKey(): Promise<Uint8Array>;
+    sdkSession(): Promise<SdkSessionResponse>;
     resolveEmbedKeyForShare(embedKeys: EmbedKeyRecord[], embedId: string): Promise<Uint8Array | null>;
     decryptChatMetadata<T extends EncryptedChatMetadata>(chat: T): Promise<T>;
     decryptLoadedChatPayload<T extends Record<string, unknown>>(payload: T): Promise<T>;
@@ -4232,7 +4416,9 @@ declare class OpenMates {
     private requestWithMethod;
     private getMasterKey;
     private loadMasterKey;
+    private getSdkSession;
     private headers;
+    private publicHeaders;
     private parseResponse;
 }
 declare class OpenMatesChats {
@@ -4242,6 +4428,9 @@ declare class OpenMatesChats {
     search(query: string, options?: ChatListOptions): Promise<EncryptedChatMetadata[]>;
     load(chatId: string): Promise<Record<string, unknown>>;
     send(message: string, options?: ChatSendOptions): Promise<ChatResponse>;
+    private sendSaved;
+    private pollRecoveryClaim;
+    private openRecoveryClaim;
     export(chatId: string, options?: {
         format?: "json" | "markdown" | "yaml";
     }): Promise<Record<string, unknown>>;
@@ -4253,6 +4442,15 @@ declare class OpenMatesChats {
     followUps(chatId: string): Promise<string[]>;
     incognito(message: string): Promise<ChatResponse>;
 }
+declare class OpenMatesDrafts {
+    private readonly client;
+    constructor(client: OpenMates);
+    listEncrypted(): Promise<EncryptedDraftRecord[]>;
+    list(): Promise<DraftRecord[]>;
+    getEncrypted(chatId: string): Promise<EncryptedDraftRecord | null>;
+    get(chatId: string): Promise<DraftRecord | null>;
+    private decrypt;
+}
 declare class OpenMatesAccount {
     private readonly client;
     constructor(client: OpenMates);
@@ -4389,6 +4587,15 @@ declare class OpenMatesWorkflows {
     list(): Promise<WorkflowSummary[]>;
     temporary(): Promise<WorkflowSummary[]>;
     capabilities(): Promise<WorkflowCapability[]>;
+    validateYaml(source: string): Promise<Record<string, unknown>>;
+    createFromYaml(source: string): Promise<{
+        workflow: WorkflowDetail;
+        validation: Record<string, unknown>;
+    }>;
+    updateFromYaml(workflowId: string, source: string): Promise<{
+        workflow: WorkflowDetail;
+        validation: Record<string, unknown>;
+    }>;
     startInput(params: WorkflowInputStartParams): Promise<WorkflowInputSessionResult>;
     inputSession(sessionId: string): Promise<WorkflowInputSessionDetail>;
     inputEvents(sessionId: string, afterEventId?: number): Promise<WorkflowInputEvent[]>;
@@ -4398,6 +4605,7 @@ declare class OpenMatesWorkflows {
     get(workflowId: string): Promise<WorkflowDetail>;
     create(params: {
         title: string;
+        description?: string | null;
         graph: WorkflowGraph;
         enabled?: boolean;
         runContentRetention?: WorkflowRunContentRetention;
@@ -4409,6 +4617,7 @@ declare class OpenMatesWorkflows {
     }): Promise<WorkflowDetail>;
     update(workflowId: string, params: {
         title?: string;
+        description?: string | null;
         graph?: WorkflowGraph;
         enabled?: boolean;
         runContentRetention?: WorkflowRunContentRetention;
@@ -4419,12 +4628,23 @@ declare class OpenMatesWorkflows {
         deleted: boolean;
     }>;
     keep(workflowId: string): Promise<WorkflowDetail>;
-    run(workflowId: string, params?: {
+    run(workflowId: string, params: {
+        idempotencyKey: string;
         mode?: "manual" | "test";
         input?: Record<string, unknown>;
     }): Promise<WorkflowRunDetail>;
     runs(workflowId: string): Promise<WorkflowRunDetail[]>;
     runDetail(workflowId: string, runId: string): Promise<WorkflowRunDetail>;
+    cancelRun(workflowId: string, runId: string): Promise<WorkflowRunCancellationResult>;
+    respond(workflowId: string, runId: string, stepId: string, input: Record<string, unknown>): Promise<WorkflowRunDetail>;
+    upsertTemplateProjection(workflowId: string, params: WorkflowTemplateProjectionUpsertParams): Promise<WorkflowTemplateProjectionResult>;
+    getPublicTemplateProjection(templateId: string): Promise<PublicWorkflowTemplateProjection>;
+    revokeTemplateProjection(workflowId: string): Promise<WorkflowTemplateProjectionRevocationResult>;
+    unrevokeTemplateProjection(workflowId: string): Promise<WorkflowTemplateProjectionRevocationResult>;
+    completeImportedBinding(workflowId: string, params: WorkflowTemplateBindingCompletionParams): Promise<WorkflowTemplateBindingCompletionResult>;
+    createTemplateShortUrl(params: WorkflowTemplateShortUrlParams): Promise<WorkflowTemplateShortUrlResult>;
+    revokeShortUrl(token: string): Promise<ShortUrlRevokeResult>;
+    importTemplate(payload: WorkflowTemplateImportPayload): Promise<ImportedWorkflowTemplate>;
 }
 declare class OpenMatesDocs {
     private readonly client;
@@ -4502,4 +4722,4 @@ type AssistantFeedbackDecision = {
 };
 declare function buildAssistantFeedbackDecision(rating: number): AssistantFeedbackDecision;
 
-export { APP_SKILL_METADATA, ASSISTANT_FEEDBACK_REPORT_TITLE, ASSISTANT_FEEDBACK_THANKS, type AssistantFeedbackDecision, type AuthMethodsStatus, type BackupCodesResult, type BankTransferOrderDetails, type BankTransferStatus, type CachedChat, type CachedNewChatSuggestion, type ChatCreateOptions, type ChatListOptions, type ChatListPage, type ChatResponse, type CliSignupResult, type DecryptedEmbed, type DecryptedMemoryEntry, type DecryptedMessage, type DecryptedNewChatSuggestion, type DocsFile, type DocsFolder, type DocsSearchResult, type DocsTree, type EncryptedChatMetadata, type FocusModeSelection, type GiftCardBankTransferStatus, INTEREST_TAG_IDS, type InterestTagId, MATE_NAMES, MEMORY_TYPE_REGISTRY, type MemoryFieldDef, type MemoryTypeDef, OpenMates, OpenMatesApiError, OpenMatesClient, type OpenMatesClientOptions, OpenMatesConfigError, type OpenMatesOptions, type OpenMatesSession, type ProjectSourceCapability, type ProjectSourceCreateInput, type ProjectSourceRecord, type ProjectSourceStatus, type ProjectSourceType, SUPPORT_URL, type SyncCache, type TopicPreferencesPayload, type TotpSetupStartResult, type WorkflowCapability, type WorkflowDetail, type WorkflowEdge, type WorkflowGraph, type WorkflowNode, type WorkflowNodeRun, type WorkflowNodeType, type WorkflowRunContentRetention, type WorkflowRunContentStorage, type WorkflowRunDetail, type WorkflowSummary, buildAssistantFeedbackDecision, defaultCloneBranchForVersion, deriveAppUrl, normalizeInterestTagIds, renderSupportInfo };
+export { APP_SKILL_METADATA, ASSISTANT_FEEDBACK_REPORT_TITLE, ASSISTANT_FEEDBACK_THANKS, type AssistantFeedbackDecision, type AuthMethodsStatus, type AuthoritativeChatReconciliation, type BackupCodesResult, type BankTransferOrderDetails, type BankTransferStatus, type CachedChat, type CachedNewChatSuggestion, type ChatCreateOptions, type ChatListOptions, type ChatListPage, type ChatResponse, type CliSignupResult, type DecryptedDraft, type DecryptedEmbed, type DecryptedMemoryEntry, type DecryptedMessage, type DecryptedNewChatSuggestion, type DocsFile, type DocsFolder, type DocsSearchResult, type DocsTree, type DraftRecord, type EncryptedChatMetadata, type EncryptedDraft, type EncryptedDraftRecord, type FocusModeSelection, type GiftCardBankTransferStatus, INTEREST_TAG_IDS, type InterestTagId, MATE_NAMES, MEMORY_TYPE_REGISTRY, type MemoryFieldDef, type MemoryTypeDef, OpenMates, OpenMatesApiError, OpenMatesClient, type OpenMatesClientOptions, OpenMatesConfigError, type OpenMatesOptions, type OpenMatesSession, type ProjectSourceCapability, type ProjectSourceCreateInput, type ProjectSourceRecord, type ProjectSourceStatus, type ProjectSourceType, SUPPORT_URL, type SyncCache, type TopicPreferencesPayload, type TotpSetupStartResult, type WorkflowCapability, type WorkflowDetail, type WorkflowEdge, type WorkflowGraph, type WorkflowNode, type WorkflowNodeRun, type WorkflowNodeType, type WorkflowRunContentRetention, type WorkflowRunContentStorage, type WorkflowRunDetail, type WorkflowSummary, buildAssistantFeedbackDecision, defaultCloneBranchForVersion, deriveAppUrl, normalizeInterestTagIds, reconcileAuthoritativeChats, renderSupportInfo };