@anuma/sdk 10.7.0 → 10.8.0

package/dist/react/index.d.ts

@@ -3262,6 +3262,159 @@ interface WebSearchPreProcessorOptions {
  */
 declare function createWebSearchPreProcessor(options?: WebSearchPreProcessorOptions): PromptPreProcessor;
 
+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);
+}
+
 declare class VaultMemory extends Model {
     static table: string;
     content: string;
@@ -8552,6 +8705,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}.
@@ -9251,159 +9408,6 @@ interface BaseUseChatStorageResult {
 }
 declare function generateConversationId(): 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);
-}
-
 interface ChatMigrationOptions {
     /** The device's local chat database. */
     database: Database;
@@ -9669,6 +9673,10 @@ interface VaultChatBackend extends ChatBackend {
         conversations: number;
         messages: number;
     }>;
+    /** Sets keys of a conversation's app context, each saved on its own so devices editing different keys keep both; `null` clears a key. */
+    updateConversationContext(conversationId: string, context: {
+        [key: string]: ChatJson | null;
+    }): Promise<boolean>;
     status(): {
         pending: number;
         stopped?: string;

package/dist/react/index.mjs

@@ -11554,9 +11554,23 @@ function conversationSortKey(data, createdAt) {
   if (pinnedAt) return PINNED_SORT_BASE + pinnedAt;
   return number(data.lastActivityAt) ?? createdAt;
 }
+var CONTEXT_FIELD_PREFIX = "context.";
+function contextField(key3) {
+  return `${CONTEXT_FIELD_PREFIX}${key3}`;
+}
+function contextFields(context) {
+  return plain(
+    Object.fromEntries(Object.entries(context ?? {}).map(([k, value]) => [contextField(k), value]))
+  );
+}
+function conversationContext(data) {
+  const entries = Object.entries(data).filter(([field10]) => field10.startsWith(CONTEXT_FIELD_PREFIX)).map(([field10, value]) => [field10.slice(CONTEXT_FIELD_PREFIX.length), value]);
+  return entries.length > 0 ? plain(Object.fromEntries(entries)) : void 0;
+}
 function toConversation(record2) {
   const pinnedAt = number(record2.data.pinnedAt);
   const projectId = text4(record2.data.projectId);
+  const context = conversationContext(record2.data);
   return {
     uniqueId: record2.id,
     conversationId: record2.id,
@@ -11565,7 +11579,8 @@ function toConversation(record2) {
     createdAt: new Date(record2.createdAt),
     updatedAt: new Date(record2.updatedAt),
     isDeleted: record2.isDeleted,
-    pinnedAt: pinnedAt ? new Date(pinnedAt) : null
+    pinnedAt: pinnedAt ? new Date(pinnedAt) : null,
+    ...context ? { context } : {}
   };
 }
 function messageData(options) {
@@ -11724,6 +11739,7 @@ function bytes2(value) {
 function conversationRecord(conversation, messages) {
   const createdAt = ms(conversation.createdAt);
   const data = plain({
+    ...contextFields(conversation.context),
     title: conversation.title,
     projectId: conversation.projectId || void 0,
     pinnedAt: conversation.pinnedAt ? ms(conversation.pinnedAt) : void 0,
@@ -13893,6 +13909,12 @@ function createVaultChatBackend(options) {
     async updateConversationPinned(conversationId, pinned) {
       return updateConversation(conversationId, { pinnedAt: pinned ? now() : null });
     },
+    async updateConversationContext(conversationId, context) {
+      const set = contextFields(context);
+      if (Object.keys(set).length > 0) return updateConversation(conversationId, set);
+      const record2 = await conversation(conversationId);
+      return !!record2 && !record2.isDeleted;
+    },
     async deleteConversation(conversationId) {
       const record2 = await conversation(conversationId);
       if (!record2 || record2.isDeleted) return false;

package/dist/server/index.d.mts

@@ -2603,6 +2603,10 @@ interface StockPricePreProcessorOptions {
  */
 declare function createStockPricePreProcessor(options?: StockPricePreProcessorOptions): PromptPreProcessor;
 
+type ChatJson = null | boolean | number | string | ChatJson[] | {
+    [key: string]: ChatJson;
+};
+
 declare class VaultMemory extends Model {
     static table: string;
     content: string;
@@ -7564,6 +7568,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}.

package/dist/server/index.d.ts

@@ -2603,6 +2603,10 @@ interface StockPricePreProcessorOptions {
  */
 declare function createStockPricePreProcessor(options?: StockPricePreProcessorOptions): PromptPreProcessor;
 
+type ChatJson = null | boolean | number | string | ChatJson[] | {
+    [key: string]: ChatJson;
+};
+
 declare class VaultMemory extends Model {
     static table: string;
     content: string;
@@ -7564,6 +7568,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}.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anuma/sdk",
-  "version": "10.7.0",
+  "version": "10.8.0",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",