@av-pi-studio/protocol 0.0.113 → 0.0.114

package/dist/messages.js

@@ -1422,6 +1422,79 @@ export const agentUiListResponseSchema = z
 })
     .passthrough();
 // ===========================================================================
+// Agent todos (swe/features/agent-todos.md § Wire family) — sprint-079
+// ===========================================================================
+/** `deleted` is never sent: the daemon drops the extension's tombstones. */
+export const agentTodoStatusSchema = z.enum(["pending", "in_progress", "completed"]);
+/**
+ * Hard limits the **daemon** applies before sending (truncating over-long text with `…`, never
+ * rejecting). The schemas below deliberately do not enforce them: a newer daemon may raise a cap
+ * and an older client must still parse the result. Clients read `AGENT_TODOS_MAX_TASKS` for the
+ * "showing the first N" hint.
+ */
+export const AGENT_TODOS_MAX_TASKS = 200;
+export const AGENT_TODO_MAX_SUBJECT_CHARS = 500;
+export const AGENT_TODO_MAX_ACTIVE_FORM_CHARS = 500;
+export const AGENT_TODO_MAX_OWNER_CHARS = 100;
+export const AGENT_TODO_MAX_DESCRIPTION_CHARS = 4000;
+export const AGENT_TODO_MAX_BLOCKED_BY = 50;
+export const agentTodoSchema = z
+    .object({
+    /** Safe integer, unique within a snapshot (not enforced: a duplicate renders, never rejects). */
+    id: z.number().int(),
+    subject: z.string(),
+    status: agentTodoStatusSchema,
+    activeForm: z.string().optional(),
+    description: z.string().optional(),
+    owner: z.string().optional(),
+    /** Ids this task waits on; may name an id absent from the snapshot. */
+    blockedBy: z.array(z.number().int()).optional(),
+})
+    .passthrough();
+/**
+ * One agent's whole todo list, last-value-wins. `seq` is strictly increasing per agent within one
+ * daemon process lifetime and restarts at 1 after a daemon restart, so a client resets its
+ * per-agent seq on reconnect and refetches. Empty `tasks` means "no list" (panel hidden).
+ */
+export const agentTodosSnapshotSchema = z
+    .object({
+    agentId: z.string(),
+    seq: z.number(),
+    tasks: z.array(agentTodoSchema),
+    /** True when the task cap dropped tasks. */
+    truncated: z.boolean().optional(),
+})
+    .passthrough();
+/** Works for live agents and process-less records. */
+export const agentTodosListRequestSchema = z
+    .object({
+    type: z.literal("agent_todos_list_request"),
+    requestId: z.string(),
+    agentId: z.string(),
+})
+    .passthrough();
+/**
+ * Success carries `snapshot` (and no `ok`); a refusal carries `ok: false` and an open-string
+ * `error` (`not_found` documented, not enumerated). A failure to read the session never reaches
+ * here as an error: the daemon answers an empty snapshot instead.
+ */
+export const agentTodosListResponseSchema = z
+    .object({
+    type: z.literal("agent_todos_list_response"),
+    requestId: z.string(),
+    snapshot: agentTodosSnapshotSchema.optional(),
+    ok: z.boolean().optional(),
+    error: z.string().optional(),
+})
+    .passthrough();
+/** Broadcast to every active session, no subscribe RPC (same shape as `skills_changed`). */
+export const agentTodosUpdateSchema = z
+    .object({
+    type: z.literal("agent_todos_update"),
+    snapshot: agentTodosSnapshotSchema,
+})
+    .passthrough();
+// ===========================================================================
 // RPC error
 // ===========================================================================
 export const rpcErrorSchema = z.object({
@@ -1528,6 +1601,9 @@ export const sessionMessageSchema = z.discriminatedUnion("type", [
     agentUiRespondResponseSchema,
     agentUiListRequestSchema,
     agentUiListResponseSchema,
+    agentTodosListRequestSchema,
+    agentTodosListResponseSchema,
+    agentTodosUpdateSchema,
     rpcErrorSchema,
 ]);
 /**

package/dist/provider-manifest.d.ts

@@ -24,6 +24,7 @@ export declare const agentCapabilityFlagsSchema: z.ZodObject<{
     supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
     supportsSteering: z.ZodOptional<z.ZodBoolean>;
     supportsExtensionUi: z.ZodOptional<z.ZodBoolean>;
+    supportsTodos: z.ZodOptional<z.ZodBoolean>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     supportsStreaming: z.ZodBoolean;
     supportsSessionPersistence: z.ZodBoolean;
@@ -36,6 +37,7 @@ export declare const agentCapabilityFlagsSchema: z.ZodObject<{
     supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
     supportsSteering: z.ZodOptional<z.ZodBoolean>;
     supportsExtensionUi: z.ZodOptional<z.ZodBoolean>;
+    supportsTodos: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     supportsStreaming: z.ZodBoolean;
     supportsSessionPersistence: z.ZodBoolean;
@@ -48,6 +50,7 @@ export declare const agentCapabilityFlagsSchema: z.ZodObject<{
     supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
     supportsSteering: z.ZodOptional<z.ZodBoolean>;
     supportsExtensionUi: z.ZodOptional<z.ZodBoolean>;
+    supportsTodos: z.ZodOptional<z.ZodBoolean>;
 }, z.ZodTypeAny, "passthrough">>;
 export type AgentCapabilityFlags = z.infer<typeof agentCapabilityFlagsSchema>;
 /** UI metadata for a provider mode (plan/default/full-access/...). */
@@ -108,6 +111,7 @@ export declare const providerDefinitionSchema: z.ZodObject<{
         supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
         supportsSteering: z.ZodOptional<z.ZodBoolean>;
         supportsExtensionUi: z.ZodOptional<z.ZodBoolean>;
+        supportsTodos: z.ZodOptional<z.ZodBoolean>;
     }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
         supportsStreaming: z.ZodBoolean;
         supportsSessionPersistence: z.ZodBoolean;
@@ -120,6 +124,7 @@ export declare const providerDefinitionSchema: z.ZodObject<{
         supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
         supportsSteering: z.ZodOptional<z.ZodBoolean>;
         supportsExtensionUi: z.ZodOptional<z.ZodBoolean>;
+        supportsTodos: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
         supportsStreaming: z.ZodBoolean;
         supportsSessionPersistence: z.ZodBoolean;
@@ -132,6 +137,7 @@ export declare const providerDefinitionSchema: z.ZodObject<{
         supportsRewindBoth: z.ZodOptional<z.ZodBoolean>;
         supportsSteering: z.ZodOptional<z.ZodBoolean>;
         supportsExtensionUi: z.ZodOptional<z.ZodBoolean>;
+        supportsTodos: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough">>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -157,6 +163,7 @@ export declare const providerDefinitionSchema: z.ZodObject<{
         supportsRewindBoth?: boolean | undefined;
         supportsSteering?: boolean | undefined;
         supportsExtensionUi?: boolean | undefined;
+        supportsTodos?: boolean | undefined;
     } & {
         [k: string]: unknown;
     };
@@ -184,6 +191,7 @@ export declare const providerDefinitionSchema: z.ZodObject<{
         supportsRewindBoth?: boolean | undefined;
         supportsSteering?: boolean | undefined;
         supportsExtensionUi?: boolean | undefined;
+        supportsTodos?: boolean | undefined;
     } & {
         [k: string]: unknown;
     };

package/dist/provider-manifest.js

@@ -30,6 +30,10 @@ export const agentCapabilityFlagsSchema = z
     // provider's `AgentSession` implements `onUiRequest`/`respondToUi` and dialogs/fire-and-forget
     // extension UI methods are forwarded to clients instead of being auto-cancelled/dropped.
     supportsExtensionUi: z.boolean().optional(),
+    // Agent todos capability (features/agent-todos.md) — additive, optional. When true, the
+    // provider's `AgentSession` implements `onTodos`/`readTodos` (and its client `readTodos`) and the
+    // daemon derives and broadcasts the agent's todo list.
+    supportsTodos: z.boolean().optional(),
 })
     .passthrough();
 /** UI metadata for a provider mode (plan/default/full-access/...). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@av-pi-studio/protocol",
-  "version": "0.0.113",
+  "version": "0.0.114",
   "files": [
     "dist",
     "!dist/**/*.map",
@@ -21,5 +21,10 @@
   },
   "dependencies": {
     "zod": "^3.23.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avatsaev/pi-studio.git",
+    "directory": "packages/protocol"
   }
 }