@standardagents/spec 0.26.1 → 0.27.2

package/dist/index.d.ts

@@ -464,7 +464,10 @@ interface MessageUpdates {
  *
  * Always broadcast (no opt-in). Clients accumulate `chunk`s by `message_id` to
  * render the answer as it generates; the authoritative final content still
- * arrives separately as a persisted message.
+ * arrives separately as a persisted message. Clients must not discard an
+ * already-painted draft solely because a retry/reconnect exposes another id:
+ * retain keyed drafts or treat the id as a reconciliation alias until the
+ * terminal message record atomically supersedes it.
  */
 interface ThreadMessageChunkEvent {
     type: 'message_chunk';
@@ -1365,6 +1368,50 @@ interface ThreadState {
      *   to delete the key
      */
     setValue(key: string, value: unknown): Promise<void>;
+    /**
+     * Read a value from the account-wide durable key-value store of the user
+     * this thread belongs to.
+     *
+     * The user store is the account-scoped sibling of the thread store: values
+     * persist across every thread the user owns on the instance (e.g. a coding
+     * client's registry of registered machines and projects). Returns `null`
+     * when the thread has no associated user or the key has no value.
+     *
+     * @param key - The key to read
+     */
+    getUserValue<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Write a value to the account-wide durable key-value store of the user
+     * this thread belongs to.
+     *
+     * Passing `null` or `undefined` deletes the key. Values MUST be
+     * JSON-serializable. Implementations MUST reject the write when the thread
+     * has no associated user.
+     *
+     * @param key - The key to write
+     * @param value - The value to store (JSON-serializable), or `null`/`undefined`
+     *   to delete the key
+     */
+    setUserValue(key: string, value: unknown): Promise<void>;
+    /**
+     * List entries in the account-wide durable key-value store of the user this
+     * thread belongs to, optionally filtered by key prefix. Returns an empty
+     * list when the thread has no associated user.
+     *
+     * @param options - Optional `prefix`, `limit` (default 100), and `offset`
+     */
+    listUserValues(options?: {
+        prefix?: string | null;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        entries: Array<{
+            key: string;
+            value: unknown;
+            updated_at: number;
+        }>;
+        total: number;
+    }>;
     /**
      * The profile of the user this thread belongs to, or `null` when the thread
      * has no associated user (e.g. unauthenticated local development).