@anuma/sdk 10.7.0 → 10.8.0

package/dist/index.d.mts

@@ -7881,6 +7881,159 @@ declare function getCreditsUsed(r: ApiResponse): number | undefined;
  */
 declare function getImageModel(r: ApiResponse): string | undefined;
 
+type ChatRecordKind = "conversation" | "message" | "summary" | "project" | "memory_links" | "setting";
+type ChatJson = null | boolean | number | string | ChatJson[] | {
+    [key: string]: ChatJson;
+};
+/** Whole-record JSON data is encrypted on the device, including all text, vectors and tool events. */
+interface ChatRecord {
+    kind: ChatRecordKind;
+    id: string;
+    conversationId: string;
+    sortKey: number;
+    createdAt: number;
+    updatedAt: number;
+    isDeleted: boolean;
+    data: {
+        [key: string]: ChatJson;
+    };
+}
+interface ChatSnapshot {
+    record: ChatRecord;
+    version: number;
+    serverUpdatedAt: string;
+}
+interface ChatWrite {
+    record: ChatRecord;
+    expectedVersion: number;
+    /** Sent and stored unencrypted so vault can run vector search. */
+    embeddings?: number[][];
+    embeddingModel?: string;
+}
+interface ChatRef {
+    kind: ChatRecordKind;
+    id: string;
+}
+type ChatAccountState = "none" | "migrating" | "active";
+interface ChatAccount {
+    keyId: string;
+    state: ChatAccountState;
+    recordCount: number;
+    storageBytes: number;
+    vectorCount: number;
+    /** The newest change; read it before loading history and poll `changes` from it. Absent before the first record. */
+    changesCursor?: string;
+}
+interface ChatImport {
+    record: ChatRecord;
+    /** Sent and stored unencrypted so vault can run vector search. */
+    embeddings?: number[][];
+    embeddingModel?: string;
+}
+interface ChatRevision {
+    kind: ChatRecordKind;
+    id: string;
+    updatedAt: number;
+    isDeleted: boolean;
+}
+interface ChatChanges {
+    items: ChatSnapshot[];
+    nextCursor?: string;
+    changesCursor: string;
+}
+interface ChatSearchOptions {
+    limit?: number;
+    kinds?: ("message" | "summary")[];
+    conversationId?: string;
+    excludeConversationId?: string;
+    /** Ranks only vectors from this model; vectors stored without one always count. */
+    embeddingModel?: string;
+    signal?: AbortSignal;
+}
+interface ChatSearchHit extends ChatSnapshot {
+    chunk: number;
+    score: number;
+}
+interface ChatAttachment {
+    id: string;
+    sizeBytes: number;
+    state: "pending" | "committed";
+    ownerKind?: "message" | "summary";
+    ownerId?: string;
+    createdAt: string;
+    committedAt?: string;
+}
+interface ChatPresignedUrl {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    expiresAt: string;
+}
+interface ChatAttachments {
+    create(sizeBytes: number, signal?: AbortSignal): Promise<{
+        attachment: ChatAttachment;
+        upload: ChatPresignedUrl;
+    }>;
+    commit(attachmentId: string, owner: {
+        kind: "message" | "summary";
+        id: string;
+    }, signal?: AbortSignal): Promise<ChatAttachment>;
+    get(attachmentId: string, signal?: AbortSignal): Promise<{
+        attachment: ChatAttachment;
+        download?: ChatPresignedUrl;
+    } | null>;
+    delete(attachmentId: string, signal?: AbortSignal): Promise<void>;
+}
+interface ChatListOptions {
+    kind: ChatRecordKind;
+    conversationId?: string;
+    includeDeleted?: boolean;
+    cursor?: string;
+    limit?: number;
+    signal?: AbortSignal;
+}
+interface ChatPage {
+    items: ChatSnapshot[];
+    nextCursor?: string;
+    total?: number;
+}
+/** Explicit versions protect edits; ambiguous writes are never replayed automatically. */
+interface ChatStore {
+    get(kind: ChatRecordKind, id: string, signal?: AbortSignal): Promise<ChatSnapshot | null>;
+    list(options: ChatListOptions): Promise<ChatPage>;
+    putMany(writes: readonly ChatWrite[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
+    getMany(refs: readonly ChatRef[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
+    account(signal?: AbortSignal): Promise<ChatAccount>;
+    importRecords(records: readonly ChatImport[], signal?: AbortSignal): Promise<number>;
+    verify(revisions: readonly ChatRevision[], signal?: AbortSignal): Promise<ChatRef[]>;
+    activate(signal?: AbortSignal): Promise<boolean>;
+    /** Without `kinds`, vault returns every kind except `setting`. */
+    changes(cursor?: string, options?: {
+        limit?: number;
+        kinds?: readonly ChatRecordKind[];
+        signal?: AbortSignal;
+    }): Promise<ChatChanges>;
+    search(embedding: readonly number[], options?: ChatSearchOptions): Promise<ChatSearchHit[]>;
+    deleteAll(signal?: AbortSignal): Promise<number>;
+    attachments: ChatAttachments;
+}
+interface RemoteChatStoreOptions {
+    baseUrl: string;
+    getToken: () => Promise<string | null>;
+    keyId: string;
+    encrypt: (plaintext: string) => Promise<string>;
+    decrypt: (ciphertext: string) => Promise<string>;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+declare class ChatStoreError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, status: number, code?: string | undefined, retryAfterMs?: number | undefined);
+}
+
 /**
  * Class-B task types — the vocabulary of the `X-Anuma-Task-Type` header.
  *
@@ -8366,6 +8519,10 @@ interface StoredConversation {
     /** When the conversation was pinned to the top of the list; null/unset = not pinned.
      * `null` (not `undefined`) at runtime for unpinned rows — mirrors the model field. */
     pinnedAt?: Date | null;
+    /** Per-conversation app state kept with the conversation in vault, keyed by the app; absent on local storage. */
+    context?: {
+        [key: string]: ChatJson;
+    };
 }
 /**
  * Lazy variant of {@link StoredConversation}.
@@ -8391,159 +8548,6 @@ interface LazyStoredConversation extends Omit<StoredConversation, "title"> {
     encryptedTitle: string;
 }
 
-type ChatRecordKind = "conversation" | "message" | "summary" | "project" | "memory_links" | "setting";
-type ChatJson = null | boolean | number | string | ChatJson[] | {
-    [key: string]: ChatJson;
-};
-/** Whole-record JSON data is encrypted on the device, including all text, vectors and tool events. */
-interface ChatRecord {
-    kind: ChatRecordKind;
-    id: string;
-    conversationId: string;
-    sortKey: number;
-    createdAt: number;
-    updatedAt: number;
-    isDeleted: boolean;
-    data: {
-        [key: string]: ChatJson;
-    };
-}
-interface ChatSnapshot {
-    record: ChatRecord;
-    version: number;
-    serverUpdatedAt: string;
-}
-interface ChatWrite {
-    record: ChatRecord;
-    expectedVersion: number;
-    /** Sent and stored unencrypted so vault can run vector search. */
-    embeddings?: number[][];
-    embeddingModel?: string;
-}
-interface ChatRef {
-    kind: ChatRecordKind;
-    id: string;
-}
-type ChatAccountState = "none" | "migrating" | "active";
-interface ChatAccount {
-    keyId: string;
-    state: ChatAccountState;
-    recordCount: number;
-    storageBytes: number;
-    vectorCount: number;
-    /** The newest change; read it before loading history and poll `changes` from it. Absent before the first record. */
-    changesCursor?: string;
-}
-interface ChatImport {
-    record: ChatRecord;
-    /** Sent and stored unencrypted so vault can run vector search. */
-    embeddings?: number[][];
-    embeddingModel?: string;
-}
-interface ChatRevision {
-    kind: ChatRecordKind;
-    id: string;
-    updatedAt: number;
-    isDeleted: boolean;
-}
-interface ChatChanges {
-    items: ChatSnapshot[];
-    nextCursor?: string;
-    changesCursor: string;
-}
-interface ChatSearchOptions {
-    limit?: number;
-    kinds?: ("message" | "summary")[];
-    conversationId?: string;
-    excludeConversationId?: string;
-    /** Ranks only vectors from this model; vectors stored without one always count. */
-    embeddingModel?: string;
-    signal?: AbortSignal;
-}
-interface ChatSearchHit extends ChatSnapshot {
-    chunk: number;
-    score: number;
-}
-interface ChatAttachment {
-    id: string;
-    sizeBytes: number;
-    state: "pending" | "committed";
-    ownerKind?: "message" | "summary";
-    ownerId?: string;
-    createdAt: string;
-    committedAt?: string;
-}
-interface ChatPresignedUrl {
-    url: string;
-    method: string;
-    headers: Record<string, string>;
-    expiresAt: string;
-}
-interface ChatAttachments {
-    create(sizeBytes: number, signal?: AbortSignal): Promise<{
-        attachment: ChatAttachment;
-        upload: ChatPresignedUrl;
-    }>;
-    commit(attachmentId: string, owner: {
-        kind: "message" | "summary";
-        id: string;
-    }, signal?: AbortSignal): Promise<ChatAttachment>;
-    get(attachmentId: string, signal?: AbortSignal): Promise<{
-        attachment: ChatAttachment;
-        download?: ChatPresignedUrl;
-    } | null>;
-    delete(attachmentId: string, signal?: AbortSignal): Promise<void>;
-}
-interface ChatListOptions {
-    kind: ChatRecordKind;
-    conversationId?: string;
-    includeDeleted?: boolean;
-    cursor?: string;
-    limit?: number;
-    signal?: AbortSignal;
-}
-interface ChatPage {
-    items: ChatSnapshot[];
-    nextCursor?: string;
-    total?: number;
-}
-/** Explicit versions protect edits; ambiguous writes are never replayed automatically. */
-interface ChatStore {
-    get(kind: ChatRecordKind, id: string, signal?: AbortSignal): Promise<ChatSnapshot | null>;
-    list(options: ChatListOptions): Promise<ChatPage>;
-    putMany(writes: readonly ChatWrite[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
-    getMany(refs: readonly ChatRef[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
-    account(signal?: AbortSignal): Promise<ChatAccount>;
-    importRecords(records: readonly ChatImport[], signal?: AbortSignal): Promise<number>;
-    verify(revisions: readonly ChatRevision[], signal?: AbortSignal): Promise<ChatRef[]>;
-    activate(signal?: AbortSignal): Promise<boolean>;
-    /** Without `kinds`, vault returns every kind except `setting`. */
-    changes(cursor?: string, options?: {
-        limit?: number;
-        kinds?: readonly ChatRecordKind[];
-        signal?: AbortSignal;
-    }): Promise<ChatChanges>;
-    search(embedding: readonly number[], options?: ChatSearchOptions): Promise<ChatSearchHit[]>;
-    deleteAll(signal?: AbortSignal): Promise<number>;
-    attachments: ChatAttachments;
-}
-interface RemoteChatStoreOptions {
-    baseUrl: string;
-    getToken: () => Promise<string | null>;
-    keyId: string;
-    encrypt: (plaintext: string) => Promise<string>;
-    decrypt: (ciphertext: string) => Promise<string>;
-    fetch?: typeof globalThis.fetch;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-declare class ChatStoreError extends Error {
-    readonly status: number;
-    readonly code?: string | undefined;
-    readonly retryAfterMs?: number | undefined;
-    constructor(message: string, status: number, code?: string | undefined, retryAfterMs?: number | undefined);
-}
-
 /** Connect to owner-scoped server storage using the account's canonical device-held cipher. */
 declare function createRemoteChatStore(options: RemoteChatStoreOptions): Promise<ChatStore>;
 

package/dist/index.d.ts

@@ -7881,6 +7881,159 @@ declare function getCreditsUsed(r: ApiResponse): number | undefined;
  */
 declare function getImageModel(r: ApiResponse): string | undefined;
 
+type ChatRecordKind = "conversation" | "message" | "summary" | "project" | "memory_links" | "setting";
+type ChatJson = null | boolean | number | string | ChatJson[] | {
+    [key: string]: ChatJson;
+};
+/** Whole-record JSON data is encrypted on the device, including all text, vectors and tool events. */
+interface ChatRecord {
+    kind: ChatRecordKind;
+    id: string;
+    conversationId: string;
+    sortKey: number;
+    createdAt: number;
+    updatedAt: number;
+    isDeleted: boolean;
+    data: {
+        [key: string]: ChatJson;
+    };
+}
+interface ChatSnapshot {
+    record: ChatRecord;
+    version: number;
+    serverUpdatedAt: string;
+}
+interface ChatWrite {
+    record: ChatRecord;
+    expectedVersion: number;
+    /** Sent and stored unencrypted so vault can run vector search. */
+    embeddings?: number[][];
+    embeddingModel?: string;
+}
+interface ChatRef {
+    kind: ChatRecordKind;
+    id: string;
+}
+type ChatAccountState = "none" | "migrating" | "active";
+interface ChatAccount {
+    keyId: string;
+    state: ChatAccountState;
+    recordCount: number;
+    storageBytes: number;
+    vectorCount: number;
+    /** The newest change; read it before loading history and poll `changes` from it. Absent before the first record. */
+    changesCursor?: string;
+}
+interface ChatImport {
+    record: ChatRecord;
+    /** Sent and stored unencrypted so vault can run vector search. */
+    embeddings?: number[][];
+    embeddingModel?: string;
+}
+interface ChatRevision {
+    kind: ChatRecordKind;
+    id: string;
+    updatedAt: number;
+    isDeleted: boolean;
+}
+interface ChatChanges {
+    items: ChatSnapshot[];
+    nextCursor?: string;
+    changesCursor: string;
+}
+interface ChatSearchOptions {
+    limit?: number;
+    kinds?: ("message" | "summary")[];
+    conversationId?: string;
+    excludeConversationId?: string;
+    /** Ranks only vectors from this model; vectors stored without one always count. */
+    embeddingModel?: string;
+    signal?: AbortSignal;
+}
+interface ChatSearchHit extends ChatSnapshot {
+    chunk: number;
+    score: number;
+}
+interface ChatAttachment {
+    id: string;
+    sizeBytes: number;
+    state: "pending" | "committed";
+    ownerKind?: "message" | "summary";
+    ownerId?: string;
+    createdAt: string;
+    committedAt?: string;
+}
+interface ChatPresignedUrl {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    expiresAt: string;
+}
+interface ChatAttachments {
+    create(sizeBytes: number, signal?: AbortSignal): Promise<{
+        attachment: ChatAttachment;
+        upload: ChatPresignedUrl;
+    }>;
+    commit(attachmentId: string, owner: {
+        kind: "message" | "summary";
+        id: string;
+    }, signal?: AbortSignal): Promise<ChatAttachment>;
+    get(attachmentId: string, signal?: AbortSignal): Promise<{
+        attachment: ChatAttachment;
+        download?: ChatPresignedUrl;
+    } | null>;
+    delete(attachmentId: string, signal?: AbortSignal): Promise<void>;
+}
+interface ChatListOptions {
+    kind: ChatRecordKind;
+    conversationId?: string;
+    includeDeleted?: boolean;
+    cursor?: string;
+    limit?: number;
+    signal?: AbortSignal;
+}
+interface ChatPage {
+    items: ChatSnapshot[];
+    nextCursor?: string;
+    total?: number;
+}
+/** Explicit versions protect edits; ambiguous writes are never replayed automatically. */
+interface ChatStore {
+    get(kind: ChatRecordKind, id: string, signal?: AbortSignal): Promise<ChatSnapshot | null>;
+    list(options: ChatListOptions): Promise<ChatPage>;
+    putMany(writes: readonly ChatWrite[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
+    getMany(refs: readonly ChatRef[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
+    account(signal?: AbortSignal): Promise<ChatAccount>;
+    importRecords(records: readonly ChatImport[], signal?: AbortSignal): Promise<number>;
+    verify(revisions: readonly ChatRevision[], signal?: AbortSignal): Promise<ChatRef[]>;
+    activate(signal?: AbortSignal): Promise<boolean>;
+    /** Without `kinds`, vault returns every kind except `setting`. */
+    changes(cursor?: string, options?: {
+        limit?: number;
+        kinds?: readonly ChatRecordKind[];
+        signal?: AbortSignal;
+    }): Promise<ChatChanges>;
+    search(embedding: readonly number[], options?: ChatSearchOptions): Promise<ChatSearchHit[]>;
+    deleteAll(signal?: AbortSignal): Promise<number>;
+    attachments: ChatAttachments;
+}
+interface RemoteChatStoreOptions {
+    baseUrl: string;
+    getToken: () => Promise<string | null>;
+    keyId: string;
+    encrypt: (plaintext: string) => Promise<string>;
+    decrypt: (ciphertext: string) => Promise<string>;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+declare class ChatStoreError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, status: number, code?: string | undefined, retryAfterMs?: number | undefined);
+}
+
 /**
  * Class-B task types — the vocabulary of the `X-Anuma-Task-Type` header.
  *
@@ -8366,6 +8519,10 @@ interface StoredConversation {
     /** When the conversation was pinned to the top of the list; null/unset = not pinned.
      * `null` (not `undefined`) at runtime for unpinned rows — mirrors the model field. */
     pinnedAt?: Date | null;
+    /** Per-conversation app state kept with the conversation in vault, keyed by the app; absent on local storage. */
+    context?: {
+        [key: string]: ChatJson;
+    };
 }
 /**
  * Lazy variant of {@link StoredConversation}.
@@ -8391,159 +8548,6 @@ interface LazyStoredConversation extends Omit<StoredConversation, "title"> {
     encryptedTitle: string;
 }
 
-type ChatRecordKind = "conversation" | "message" | "summary" | "project" | "memory_links" | "setting";
-type ChatJson = null | boolean | number | string | ChatJson[] | {
-    [key: string]: ChatJson;
-};
-/** Whole-record JSON data is encrypted on the device, including all text, vectors and tool events. */
-interface ChatRecord {
-    kind: ChatRecordKind;
-    id: string;
-    conversationId: string;
-    sortKey: number;
-    createdAt: number;
-    updatedAt: number;
-    isDeleted: boolean;
-    data: {
-        [key: string]: ChatJson;
-    };
-}
-interface ChatSnapshot {
-    record: ChatRecord;
-    version: number;
-    serverUpdatedAt: string;
-}
-interface ChatWrite {
-    record: ChatRecord;
-    expectedVersion: number;
-    /** Sent and stored unencrypted so vault can run vector search. */
-    embeddings?: number[][];
-    embeddingModel?: string;
-}
-interface ChatRef {
-    kind: ChatRecordKind;
-    id: string;
-}
-type ChatAccountState = "none" | "migrating" | "active";
-interface ChatAccount {
-    keyId: string;
-    state: ChatAccountState;
-    recordCount: number;
-    storageBytes: number;
-    vectorCount: number;
-    /** The newest change; read it before loading history and poll `changes` from it. Absent before the first record. */
-    changesCursor?: string;
-}
-interface ChatImport {
-    record: ChatRecord;
-    /** Sent and stored unencrypted so vault can run vector search. */
-    embeddings?: number[][];
-    embeddingModel?: string;
-}
-interface ChatRevision {
-    kind: ChatRecordKind;
-    id: string;
-    updatedAt: number;
-    isDeleted: boolean;
-}
-interface ChatChanges {
-    items: ChatSnapshot[];
-    nextCursor?: string;
-    changesCursor: string;
-}
-interface ChatSearchOptions {
-    limit?: number;
-    kinds?: ("message" | "summary")[];
-    conversationId?: string;
-    excludeConversationId?: string;
-    /** Ranks only vectors from this model; vectors stored without one always count. */
-    embeddingModel?: string;
-    signal?: AbortSignal;
-}
-interface ChatSearchHit extends ChatSnapshot {
-    chunk: number;
-    score: number;
-}
-interface ChatAttachment {
-    id: string;
-    sizeBytes: number;
-    state: "pending" | "committed";
-    ownerKind?: "message" | "summary";
-    ownerId?: string;
-    createdAt: string;
-    committedAt?: string;
-}
-interface ChatPresignedUrl {
-    url: string;
-    method: string;
-    headers: Record<string, string>;
-    expiresAt: string;
-}
-interface ChatAttachments {
-    create(sizeBytes: number, signal?: AbortSignal): Promise<{
-        attachment: ChatAttachment;
-        upload: ChatPresignedUrl;
-    }>;
-    commit(attachmentId: string, owner: {
-        kind: "message" | "summary";
-        id: string;
-    }, signal?: AbortSignal): Promise<ChatAttachment>;
-    get(attachmentId: string, signal?: AbortSignal): Promise<{
-        attachment: ChatAttachment;
-        download?: ChatPresignedUrl;
-    } | null>;
-    delete(attachmentId: string, signal?: AbortSignal): Promise<void>;
-}
-interface ChatListOptions {
-    kind: ChatRecordKind;
-    conversationId?: string;
-    includeDeleted?: boolean;
-    cursor?: string;
-    limit?: number;
-    signal?: AbortSignal;
-}
-interface ChatPage {
-    items: ChatSnapshot[];
-    nextCursor?: string;
-    total?: number;
-}
-/** Explicit versions protect edits; ambiguous writes are never replayed automatically. */
-interface ChatStore {
-    get(kind: ChatRecordKind, id: string, signal?: AbortSignal): Promise<ChatSnapshot | null>;
-    list(options: ChatListOptions): Promise<ChatPage>;
-    putMany(writes: readonly ChatWrite[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
-    getMany(refs: readonly ChatRef[], signal?: AbortSignal): Promise<ChatSnapshot[]>;
-    account(signal?: AbortSignal): Promise<ChatAccount>;
-    importRecords(records: readonly ChatImport[], signal?: AbortSignal): Promise<number>;
-    verify(revisions: readonly ChatRevision[], signal?: AbortSignal): Promise<ChatRef[]>;
-    activate(signal?: AbortSignal): Promise<boolean>;
-    /** Without `kinds`, vault returns every kind except `setting`. */
-    changes(cursor?: string, options?: {
-        limit?: number;
-        kinds?: readonly ChatRecordKind[];
-        signal?: AbortSignal;
-    }): Promise<ChatChanges>;
-    search(embedding: readonly number[], options?: ChatSearchOptions): Promise<ChatSearchHit[]>;
-    deleteAll(signal?: AbortSignal): Promise<number>;
-    attachments: ChatAttachments;
-}
-interface RemoteChatStoreOptions {
-    baseUrl: string;
-    getToken: () => Promise<string | null>;
-    keyId: string;
-    encrypt: (plaintext: string) => Promise<string>;
-    decrypt: (ciphertext: string) => Promise<string>;
-    fetch?: typeof globalThis.fetch;
-    timeoutMs?: number;
-    signal?: AbortSignal;
-}
-declare class ChatStoreError extends Error {
-    readonly status: number;
-    readonly code?: string | undefined;
-    readonly retryAfterMs?: number | undefined;
-    constructor(message: string, status: number, code?: string | undefined, retryAfterMs?: number | undefined);
-}
-
 /** Connect to owner-scoped server storage using the account's canonical device-held cipher. */
 declare function createRemoteChatStore(options: RemoteChatStoreOptions): Promise<ChatStore>;