@av-pi-studio/client 0.0.112 → 0.0.114

package/dist/agent-todos-state.d.ts

@@ -0,0 +1,34 @@
+import type { AgentTodosSnapshot } from "@av-pi-studio/protocol";
+/**
+ * Framework-free `agent_todos_*` state (`swe/features/agent-todos.md` § SDK, sprint-079/task-008).
+ * No DOM, no I/O, no timers — mirrors `agent-ui-state.ts`'s pure-module convention.
+ *
+ * `seq` is per-agent, strictly increasing within one daemon process lifetime, and restarts at 1
+ * after a daemon restart. This module tracks the last-applied seq inline on the stored snapshot
+ * (there is no separate `lastSeq` field — `AgentTodosState` is exactly `{byAgent}`, per the task
+ * spec) and drops anything `seq <= lastSeq`. `resetAgentTodosSeq` lowers every stored seq to
+ * `-Infinity` so the *next* snapshot of any seq (including a fresh daemon's `1`) always wins,
+ * without discarding the previously-rendered tasks in the meantime. The consumer (sprint-080's
+ * store) calls it on every reconnect (new `server_info`) and immediately refetches via `list`, so
+ * the `-Infinity` seq is never itself rendered.
+ */
+export interface AgentTodosState {
+    byAgent: Record<string, AgentTodosSnapshot>;
+}
+export declare const initialAgentTodosState: AgentTodosState;
+/**
+ * Last-value-wins per agent. Ignores `seq <= lastSeq` for that agent (stale or duplicate
+ * delivery) and returns the **same** `state` object when ignored, so a React selector keyed off
+ * `state` reference never re-renders for a dropped push. A `list` response is applied through
+ * this same function — there is no separate code path for it.
+ */
+export declare function applyAgentTodosSnapshot(state: AgentTodosState, snapshot: AgentTodosSnapshot): AgentTodosState;
+/**
+ * Keeps every agent's last-known snapshot (tasks stay visible) but lowers its tracked seq to
+ * `-Infinity`, so the next `applyAgentTodosSnapshot` call for that agent wins regardless of its
+ * seq value. Call on every reconnect (new `server_info`), before refetching via `list`.
+ */
+export declare function resetAgentTodosSeq(state: AgentTodosState): AgentTodosState;
+/** The last-applied snapshot for one agent, or `undefined` if none has arrived yet. */
+export declare function snapshotFor(state: AgentTodosState, agentId: string): AgentTodosSnapshot | undefined;
+//# sourceMappingURL=agent-todos-state.d.ts.map

package/dist/agent-todos-state.js

@@ -0,0 +1,32 @@
+export const initialAgentTodosState = { byAgent: {} };
+// ─── Reducer ──────────────────────────────────────────────────────────────────
+/**
+ * Last-value-wins per agent. Ignores `seq <= lastSeq` for that agent (stale or duplicate
+ * delivery) and returns the **same** `state` object when ignored, so a React selector keyed off
+ * `state` reference never re-renders for a dropped push. A `list` response is applied through
+ * this same function — there is no separate code path for it.
+ */
+export function applyAgentTodosSnapshot(state, snapshot) {
+    const current = state.byAgent[snapshot.agentId];
+    if (current && snapshot.seq <= current.seq)
+        return state;
+    return { byAgent: { ...state.byAgent, [snapshot.agentId]: snapshot } };
+}
+/**
+ * Keeps every agent's last-known snapshot (tasks stay visible) but lowers its tracked seq to
+ * `-Infinity`, so the next `applyAgentTodosSnapshot` call for that agent wins regardless of its
+ * seq value. Call on every reconnect (new `server_info`), before refetching via `list`.
+ */
+export function resetAgentTodosSeq(state) {
+    const byAgent = {};
+    for (const [agentId, snapshot] of Object.entries(state.byAgent)) {
+        byAgent[agentId] = { ...snapshot, seq: Number.NEGATIVE_INFINITY };
+    }
+    return { byAgent };
+}
+// ─── Selectors ────────────────────────────────────────────────────────────────
+/** The last-applied snapshot for one agent, or `undefined` if none has arrived yet. */
+export function snapshotFor(state, agentId) {
+    return state.byAgent[agentId];
+}
+//# sourceMappingURL=agent-todos-state.js.map

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from "./pairing.js";
 export * from "./daemon-client.js";
 export * from "./pistudio-client.js";
 export * from "./agent-ui-state.js";
+export * from "./agent-todos-state.js";
 export * from "./agent-ui-controller.js";
 export * from "./terminal-stream-router.js";
 export * from "./file-transfer-client.js";

package/dist/index.js

@@ -15,6 +15,8 @@ export * from "./daemon-client.js";
 export * from "./pistudio-client.js";
 // Extension-UI pure state module (reducer/selectors, sprint-067).
 export * from "./agent-ui-state.js";
+// Agent Todos pure state module (reducer/selectors, sprint-079).
+export * from "./agent-todos-state.js";
 // Extension-UI controller (subscribe-then-list, reconnect resync, agent pruning, sprint-067).
 export * from "./agent-ui-controller.js";
 // Terminal-stream router (binary frame demux per slot).

package/dist/pistudio-client.d.ts

@@ -1,4 +1,4 @@
-import type { AgentCloneResponse, AgentCompactResponse, AgentCycleModelResponse, AgentExportHtmlResponse, AgentForkMessagesResponse, AgentForkResponse, AgentLastAssistantTextResponse, AgentListCommandsResponse, AgentNewSessionResponse, AgentSessionStatsResponse, AgentSetModelResponse, AgentSetSessionNameResponse, AgentSetThinkingResponse, AgentStreamEvent, AgentSwitchSessionResponse, AgentThinkingLevelsResponse, AgentUiPendingRequest, AgentUiRequest, AgentUiResolved, AgentUiResponse, AgentUiSurface, CreateAgentRequest, ExtensionPacksListResponse, ExtensionPacksSetResponse, FetchAgentTimelineResponse, ProviderAuthInfo, ProviderAuthType, SessionMessage, SkillsInstallResponse, SkillsListResponse, SkillsPreviewResponse, SkillsRemoveResponse, SkillsSetEnabledResponse, SkillsUpdateAllResponse, TimelineDirection, ViewerSettings, ViewerSettingsPatchEntry } from "@av-pi-studio/protocol";
+import type { AgentCloneResponse, AgentCompactResponse, AgentCycleModelResponse, AgentExportHtmlResponse, AgentForkMessagesResponse, AgentForkResponse, AgentLastAssistantTextResponse, AgentListCommandsResponse, AgentNewSessionResponse, AgentSessionStatsResponse, AgentSetModelResponse, AgentSetSessionNameResponse, AgentSetThinkingResponse, AgentStreamEvent, AgentSwitchSessionResponse, AgentThinkingLevelsResponse, AgentTodosSnapshot, AgentTodosUpdate, AgentUiPendingRequest, AgentUiRequest, AgentUiResolved, AgentUiResponse, AgentUiSurface, CreateAgentRequest, ExtensionPacksListResponse, ExtensionPacksSetResponse, FetchAgentTimelineResponse, ProviderAuthInfo, ProviderAuthType, SessionMessage, SkillsInstallResponse, SkillsListResponse, SkillsPreviewResponse, SkillsRemoveResponse, SkillsSetEnabledResponse, SkillsUpdateAllResponse, TimelineDirection, ViewerSettings, ViewerSettingsPatchEntry } from "@av-pi-studio/protocol";
 import type { DaemonClient } from "./daemon-client.js";
 export { detectSkillSource } from "@av-pi-studio/protocol";
 /**
@@ -362,6 +362,17 @@ export declare class AgentUiError extends Error {
 export declare function isAgentUiRequest(message: unknown): message is AgentUiRequest;
 /** Narrows an inbound session message to the `agent_ui_resolved` broadcast. */
 export declare function isAgentUiResolved(message: unknown): message is AgentUiResolved;
+/**
+ * A domain failure reported *in `agent_todos_list_response`* (`{ok:false, error}`) rather than as
+ * an `rpc_error` — same hazard `ProviderAuthError`/`AgentUiError` guard against. `code` forwards
+ * the daemon's `error` string verbatim (open, not enumerated — only `not_found` is documented).
+ */
+export declare class AgentTodosError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** Narrows an inbound session message to the `agent_todos_update` broadcast. */
+export declare function isAgentTodosUpdate(message: unknown): message is AgentTodosUpdate;
 /** The `agent_archived` lifecycle push (`messages.ts`'s `agentArchivedSchema`). */
 export interface AgentArchivedMessage {
     type: "agent_archived";
@@ -507,6 +518,22 @@ export declare class PiStudioClient {
      * from "does this daemon speak the `agent_ui_*` RPC family at all".
      */
     extensionUiAvailable(): boolean;
+    /** True iff the daemon advertised the `agentTodos` capability in `server_info.features`. An old
+     *  daemon never gets `listAgentTodos`/`onAgentTodosUpdate` called against it. */
+    hasAgentTodosCapability(): boolean;
+    /**
+     * Reconnect/first-load snapshot for one agent's todo list — `agent_todos_list_request`, the
+     * default RPC timeout. The response is flat (`{type, requestId, snapshot}` on success, no
+     * `ok`), unlike most other RPCs on this facade: `daemon.request` only unwraps a `payload`
+     * field, and this family has none. A domain refusal (`{ok:false, error}`, e.g. unknown
+     * `agentId`) **throws** `AgentTodosError` — the caller treats any rejection as "keep what you
+     * have" (`agent-todos-state.ts`), so a malformed success (neither `snapshot` nor `ok:false`) is
+     * also raised rather than silently returning `undefined`.
+     */
+    listAgentTodos(agentId: string): Promise<AgentTodosSnapshot>;
+    /** Subscribe to every `agent_todos_update` broadcast (any agent) — raw pushes, undeduped and
+     *  unfiltered by agent; feed them through `agent-todos-state.ts`'s `applyAgentTodosSnapshot`. */
+    onAgentTodosUpdate(handler: (snapshot: AgentTodosSnapshot) => void): () => void;
     /** True iff the daemon advertised the `skills` capability in `server_info.features`. */
     hasSkillsCapability(): boolean;
     /** Every resolved Agent Skill plus every resolved `settings.json` package — `skills_list_request`.

package/dist/pistudio-client.js

@@ -105,6 +105,24 @@ export function isAgentUiResolved(message) {
         typeof m.requestId === "string" &&
         typeof m.agentId === "string");
 }
+/**
+ * A domain failure reported *in `agent_todos_list_response`* (`{ok:false, error}`) rather than as
+ * an `rpc_error` — same hazard `ProviderAuthError`/`AgentUiError` guard against. `code` forwards
+ * the daemon's `error` string verbatim (open, not enumerated — only `not_found` is documented).
+ */
+export class AgentTodosError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "AgentTodosError";
+    }
+}
+/** Narrows an inbound session message to the `agent_todos_update` broadcast. */
+export function isAgentTodosUpdate(message) {
+    const m = message;
+    return (!!m && m.type === "agent_todos_update" && typeof m.snapshot === "object" && m.snapshot !== null);
+}
 /**
  * Narrows an inbound session message to `agent_archived`. **Not** part of the `agent_ui_*` family —
  * exported so a controller (task-003) can prune retained extension-UI state on archive/delete.
@@ -494,6 +512,41 @@ export class PiStudioClient {
     extensionUiAvailable() {
         return this.daemon.hasFeature("extensionUi");
     }
+    // ─── Agent Todos (agent_todos_*, sprint-079) ───────────────────────────────
+    /** True iff the daemon advertised the `agentTodos` capability in `server_info.features`. An old
+     *  daemon never gets `listAgentTodos`/`onAgentTodosUpdate` called against it. */
+    hasAgentTodosCapability() {
+        return this.daemon.hasFeature("agentTodos");
+    }
+    /**
+     * Reconnect/first-load snapshot for one agent's todo list — `agent_todos_list_request`, the
+     * default RPC timeout. The response is flat (`{type, requestId, snapshot}` on success, no
+     * `ok`), unlike most other RPCs on this facade: `daemon.request` only unwraps a `payload`
+     * field, and this family has none. A domain refusal (`{ok:false, error}`, e.g. unknown
+     * `agentId`) **throws** `AgentTodosError` — the caller treats any rejection as "keep what you
+     * have" (`agent-todos-state.ts`), so a malformed success (neither `snapshot` nor `ok:false`) is
+     * also raised rather than silently returning `undefined`.
+     */
+    async listAgentTodos(agentId) {
+        const payload = await this.daemon.request("agent_todos_list_request", {
+            agentId,
+        });
+        if (payload.ok === false) {
+            throw new AgentTodosError(payload.error ?? "failed to list agent todos", payload.error ?? "unknown");
+        }
+        if (!payload.snapshot) {
+            throw new AgentTodosError("malformed agent_todos_list_response: missing snapshot", "malformed_response");
+        }
+        return payload.snapshot;
+    }
+    /** Subscribe to every `agent_todos_update` broadcast (any agent) — raw pushes, undeduped and
+     *  unfiltered by agent; feed them through `agent-todos-state.ts`'s `applyAgentTodosSnapshot`. */
+    onAgentTodosUpdate(handler) {
+        return this.daemon.onSessionMessage((msg) => {
+            if (isAgentTodosUpdate(msg))
+                handler(msg.snapshot);
+        });
+    }
     // ─── Skills (skills_*, sprint-075) ─────────────────────────────────────────
     /** True iff the daemon advertised the `skills` capability in `server_info.features`. */
     hasSkillsCapability() {

package/dist/test-support/scripted-daemon.js

@@ -47,10 +47,11 @@ export function makeScriptedDaemon(opts) {
         switch (msg.type) {
             case "agent_ui_respond_request":
             case "agent_ui_list_request":
+            case "agent_todos_list_request":
                 // Driven manually by each test via `fake.push()` — the ok/error mix (and, for
-                // agent_ui_list_request, the exact moment the reply lands relative to other pushed
-                // events) is exactly what the acceptance criteria differentiate on; an automatic reply
-                // would hide it.
+                // agent_ui_list_request/agent_todos_list_request, the exact moment the reply lands
+                // relative to other pushed events) is exactly what the acceptance criteria
+                // differentiate on; an automatic reply would hide it.
                 return;
             case "create_agent_request": {
                 const agentId = `agent-${++agentSeq}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@av-pi-studio/client",
-  "version": "0.0.112",
+  "version": "0.0.114",
   "files": [
     "dist",
     "!dist/**/*.map",
@@ -20,7 +20,12 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@av-pi-studio/protocol": "^0.0.112",
-    "@av-pi-studio/relay": "^0.0.112"
+    "@av-pi-studio/protocol": "^0.0.114",
+    "@av-pi-studio/relay": "^0.0.114"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avatsaev/pi-studio.git",
+    "directory": "packages/client"
   }
 }