@av-pi-studio/server 0.0.1

package/dist/agent/session-operations.js

@@ -0,0 +1,130 @@
+import { randomUUID } from "node:crypto";
+export class SessionOperationsService {
+    deps;
+    now;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? (() => new Date().toISOString());
+    }
+    registerHandlers(registry, getActiveSessions) {
+        registry.register("interrupt_agent", (ctx) => this.handleInterrupt(ctx.message, getActiveSessions));
+        registry.register("update_agent", (ctx) => this.handleUpdate(ctx.message, getActiveSessions));
+        registry.register("resume_agent", (ctx) => this.handleResume(ctx.message, getActiveSessions));
+        registry.register("import_agent_session", (ctx) => this.handleImport(ctx.message, getActiveSessions));
+        // Legacy flat alias.
+        registry.registerAlias("cancel_agent", "interrupt_agent");
+    }
+    broadcastAll(sessions, msg) {
+        this.deps.broadcast(sessions, msg);
+    }
+    async handleInterrupt(msg, getSessions) {
+        const agentId = msg.agentId;
+        const managed = this.deps.manager.get(agentId);
+        if (!managed?.session)
+            return { type: "interrupt_response", agentId, ok: false };
+        await managed.session.interrupt();
+        // The provider session will emit turn_canceled which goes through runTurn's subscriber.
+        // If the agent is still "running" (interrupt was out-of-band), force it to idle.
+        if (managed.record.lastStatus === "running") {
+            await this.deps.manager.setStatus(agentId, "idle");
+            this.broadcastAll(getSessions(), { type: "agent_update", agentId, status: "idle" });
+        }
+        return { type: "interrupt_response", agentId, ok: true };
+    }
+    async handleUpdate(msg, getSessions) {
+        const agentId = msg.agentId;
+        const managed = this.deps.manager.get(agentId);
+        if (!managed)
+            throw new Error(`unknown agent: ${agentId}`);
+        // Update fields that do NOT require a session recreate.
+        const title = typeof msg.title === "string" ? msg.title : managed.record.title;
+        const labels = msg.labels ?? managed.record.labels;
+        const config = {
+            ...managed.record.config,
+            ...msg.config,
+        };
+        // Apply mode/model/thinking to the live session (if attached).
+        if (managed.session) {
+            if (typeof msg.modeId === "string")
+                await managed.session.setMode(msg.modeId);
+            if (typeof msg.model === "string")
+                await managed.session.setModel?.(msg.model);
+            if (typeof msg.thinkingOptionId === "string") {
+                await managed.session.setThinkingOption?.(msg.thinkingOptionId);
+            }
+        }
+        // Persist updated record without recreating the session.
+        managed.record = {
+            ...managed.record,
+            title,
+            labels,
+            config: config,
+            updatedAt: this.now(),
+        };
+        this.broadcastAll(getSessions(), {
+            type: "agent_update",
+            agentId,
+            status: managed.record.lastStatus,
+            title,
+            labels,
+        });
+        return { type: "update_agent_response", agentId, ok: true };
+    }
+    async handleResume(msg, getSessions) {
+        const agentId = msg.agentId;
+        const managed = this.deps.manager.get(agentId);
+        if (!managed)
+            throw new Error(`unknown agent: ${agentId}`);
+        const handle = managed.record.persistence;
+        if (!handle) {
+            // Stale / no handle → rpc_error.
+            throw new Error(`agent ${agentId} has no persistence handle (stale or not resumable)`);
+        }
+        const client = this.deps.resolveClient(managed.record.provider);
+        const session = await client.resumeSession(handle);
+        this.deps.manager.attachSession(agentId, session);
+        await this.deps.manager.persistSessionHandle(agentId);
+        await this.deps.manager.setStatus(agentId, "idle");
+        this.broadcastAll(getSessions(), {
+            type: "agent_update",
+            agentId,
+            status: "idle",
+        });
+        return { type: "resume_agent_response", agentId, ok: true };
+    }
+    async handleImport(msg, getSessions) {
+        const provider = msg.provider ?? "pi";
+        const cwd = msg.cwd ?? ".";
+        const providerHandleId = msg.providerHandleId;
+        const client = this.deps.resolveClient(provider);
+        if (!client.importSession)
+            throw new Error(`provider ${provider} does not support import`);
+        const result = await client.importSession({ providerHandleId, cwd });
+        // Create the agent record and seed the timeline BEFORE publishing.
+        const record = {
+            id: randomUUID(),
+            provider,
+            cwd,
+            createdAt: this.now(),
+            updatedAt: this.now(),
+            labels: {},
+            lastStatus: "idle",
+            timeline: result.timeline.map((e) => ({ epoch: 0, seq: 0, timestamp: this.now(), event: e })),
+            persistence: result.persistence,
+        };
+        const managed = await this.deps.manager.add(record);
+        this.deps.manager.attachSession(record.id, result.session);
+        // Publish only once the agent is ready.
+        this.broadcastAll(getSessions(), {
+            type: "agent_update",
+            agentId: record.id,
+            status: "idle",
+        });
+        return {
+            type: "import_agent_session_response",
+            agentId: record.id,
+            ok: true,
+        };
+    }
+}
+//# sourceMappingURL=session-operations.js.map

package/dist/agent/session-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-operations.js","sourceRoot":"","sources":["../../src/agent/session-operations.ts"],"names":[],"mappings":"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"}

package/dist/agent/structured-generation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Daemon-side LLM-backed metadata generation (architecture/structured-generation.md § Tasks,
+ * § Provider selection, § Behavior). Drives agent-title generation, commit messages, PR text,
+ * branch names without creating throwaway `AgentSession`s.
+ */
+export declare const MAX_EXPLICIT_AGENT_TITLE_CHARS = 80;
+/** Supported metadata generation tasks. */
+export type GenerationTask = "agent_title" | "commit_message" | "pr_title" | "pr_body" | "branch_name";
+/** A candidate provider entry from `agents.metadataGeneration.providers`. */
+export interface MetadataGenerationCandidate {
+    provider: string;
+    model?: string;
+    thinkingOptionId?: string;
+}
+/** Minimal provider RPC interface (no AgentSession created). */
+export interface StructuredGenerationProvider {
+    readonly provider: string;
+    isAvailable(): boolean | Promise<boolean>;
+    /** Top-level structured generation call. Returns `null` when output is invalid/unavailable. */
+    structuredGenerate(prompt: string, task: GenerationTask): Promise<string | null>;
+}
+export interface GenerateOpts {
+    /** Configured provider fallback order from `agents.metadataGeneration.providers`. */
+    configuredCandidates?: MetadataGenerationCandidate[];
+    /** Already-resolved providers to try (in order). */
+    candidates?: StructuredGenerationProvider[];
+    /** Context passed to the prompt builder. */
+    context?: Record<string, unknown>;
+}
+/**
+ * Build a simple deterministic fallback for each task type. Used when all providers fail.
+ */
+export declare function deterministicFallback(task: GenerationTask, context?: Record<string, unknown>): string;
+/**
+ * Try each candidate in order, returning the first valid result. Falls back to a
+ * deterministic fallback if all providers fail. Never creates a throwaway `AgentSession`.
+ */
+export declare function generate(task: GenerationTask, opts?: GenerateOpts): Promise<string>;
+//# sourceMappingURL=structured-generation.d.ts.map

package/dist/agent/structured-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-generation.d.ts","sourceRoot":"","sources":["../../src/agent/structured-generation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,SAAS,GACT,aAAa,CAAC;AAElB,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,gEAAgE;AAChE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,WAAW,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,+FAA+F;IAC/F,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,2BAA2B,EAAE,CAAC;IACrD,oDAAoD;IACpD,UAAU,CAAC,EAAE,4BAA4B,EAAE,CAAC;IAC5C,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAsBR;AASD;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB7F"}

package/dist/agent/structured-generation.js

@@ -0,0 +1,78 @@
+/**
+ * Daemon-side LLM-backed metadata generation (architecture/structured-generation.md § Tasks,
+ * § Provider selection, § Behavior). Drives agent-title generation, commit messages, PR text,
+ * branch names without creating throwaway `AgentSession`s.
+ */
+export const MAX_EXPLICIT_AGENT_TITLE_CHARS = 80;
+/**
+ * Build a simple deterministic fallback for each task type. Used when all providers fail.
+ */
+export function deterministicFallback(task, context) {
+    const prompt = context?.prompt ?? context?.initialPrompt ?? "";
+    switch (task) {
+        case "agent_title":
+            return truncateTitle(prompt || "Untitled agent");
+        case "commit_message":
+            return truncateTitle(prompt || "Update");
+        case "pr_title":
+            return truncateTitle(prompt || "Changes");
+        case "pr_body":
+            return prompt ? `${prompt.slice(0, 200)}\n\n(Generated)` : "(No description)";
+        case "branch_name": {
+            const slug = (prompt || "update")
+                .toLowerCase()
+                .replace(/[^a-z0-9\s-]/g, "")
+                .replace(/\s+/g, "-")
+                .replace(/-{2,}/g, "-")
+                .slice(0, 40)
+                .replace(/-$/, "");
+            return slug || "update";
+        }
+    }
+}
+function truncateTitle(text) {
+    const cleaned = text.replace(/\s+/g, " ").trim();
+    return cleaned.length > MAX_EXPLICIT_AGENT_TITLE_CHARS
+        ? `${cleaned.slice(0, MAX_EXPLICIT_AGENT_TITLE_CHARS - 1)}…`
+        : cleaned;
+}
+/**
+ * Try each candidate in order, returning the first valid result. Falls back to a
+ * deterministic fallback if all providers fail. Never creates a throwaway `AgentSession`.
+ */
+export async function generate(task, opts = {}) {
+    const { candidates = [], context } = opts;
+    for (const candidate of candidates) {
+        try {
+            const available = await candidate.isAvailable();
+            if (!available)
+                continue;
+            const result = await candidate.structuredGenerate(buildPrompt(task, context), task);
+            if (result && result.trim().length > 0) {
+                return task === "agent_title" ? truncateTitle(result) : result;
+            }
+        }
+        catch {
+            // Provider failed → fall through to next.
+        }
+    }
+    return deterministicFallback(task, context);
+}
+function buildPrompt(task, context) {
+    const ctx = context ?? {};
+    const prompt = ctx.prompt ?? ctx.initialPrompt ?? "";
+    const cwd = ctx.cwd ?? "";
+    switch (task) {
+        case "agent_title":
+            return `Generate a short, descriptive title (≤${MAX_EXPLICIT_AGENT_TITLE_CHARS} chars) for an agent session started with: "${prompt}"`;
+        case "commit_message":
+            return `Write a concise Git commit message for: "${prompt}"${cwd ? ` in ${cwd}` : ""}`;
+        case "pr_title":
+            return `Write a short PR title for: "${prompt}"`;
+        case "pr_body":
+            return `Write a brief PR description for: "${prompt}"`;
+        case "branch_name":
+            return `Generate a short, slug-safe Git branch name for: "${prompt}"`;
+    }
+}
+//# sourceMappingURL=structured-generation.js.map

package/dist/agent/structured-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-generation.js","sourceRoot":"","sources":["../../src/agent/structured-generation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAkCjD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAoB,EACpB,OAAiC;IAEjC,MAAM,MAAM,GAAI,OAAO,EAAE,MAAiB,IAAK,OAAO,EAAE,aAAwB,IAAI,EAAE,CAAC;IACvF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC,MAAM,IAAI,gBAAgB,CAAC,CAAC;QACnD,KAAK,gBAAgB;YACnB,OAAO,aAAa,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC;QAC3C,KAAK,UAAU;YACb,OAAO,aAAa,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;QAC5C,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAChF,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,QAAQ,CAAC;iBAC9B,WAAW,EAAE;iBACb,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;iBAC5B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;iBACtB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;iBACZ,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrB,OAAO,IAAI,IAAI,QAAQ,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,OAAO,OAAO,CAAC,MAAM,GAAG,8BAA8B;QACpD,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,8BAA8B,GAAG,CAAC,CAAC,GAAG;QAC5D,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAoB,EAAE,OAAqB,EAAE;IAC1E,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE1C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC;YAChD,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;YACpF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACjE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,IAAoB,EAAE,OAAiC;IAC1E,MAAM,GAAG,GAAG,OAAO,IAAI,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAI,GAAG,CAAC,MAAiB,IAAK,GAAG,CAAC,aAAwB,IAAI,EAAE,CAAC;IAC7E,MAAM,GAAG,GAAI,GAAG,CAAC,GAAc,IAAI,EAAE,CAAC;IACtC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,yCAAyC,8BAA8B,+CAA+C,MAAM,GAAG,CAAC;QACzI,KAAK,gBAAgB;YACnB,OAAO,4CAA4C,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACzF,KAAK,UAAU;YACb,OAAO,gCAAgC,MAAM,GAAG,CAAC;QACnD,KAAK,SAAS;YACZ,OAAO,sCAAsC,MAAM,GAAG,CAAC;QACzD,KAAK,aAAa;YAChB,OAAO,qDAAqD,MAAM,GAAG,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/agent/timeline-rpc.d.ts

@@ -0,0 +1,21 @@
+import type { HandlerRegistry } from "../ws/router.js";
+import type { AgentManager } from "./agent-manager.js";
+import type { AgentClient } from "./provider-contract.js";
+export interface TimelineHandlerDeps {
+    manager: AgentManager;
+    resolveClient: (provider: string) => AgentClient;
+}
+/**
+ * `fetch_agent_timeline_request` handler (features/timeline-streaming.md § Fetch request/response,
+ * § Behavior — server). Returns full projected items (never deltas) with all paging fields. Bounded
+ * at `DEFAULT_PAGE_SIZE`; clients page to completion (`hasNewer:false`).
+ *
+ * A restarted daemon has no in-memory `AgentTimelineStore` for any agent (it lives only in
+ * process memory — see agent-service.ts). Rather than returning an empty page, fall back to the
+ * agent's provider re-deriving the timeline from its own durable native history (e.g. `pi`'s
+ * on-disk JSONL session file via `AgentClient.hydrateTimeline`), keyed off the record's persisted
+ * `persistence` handle. The result is seeded once into the in-memory store so subsequent pages
+ * (and any later live turn) build on it normally.
+ */
+export declare function registerTimelineHandler(registry: HandlerRegistry, deps: TimelineHandlerDeps): void;
+//# sourceMappingURL=timeline-rpc.d.ts.map

package/dist/agent/timeline-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-rpc.d.ts","sourceRoot":"","sources":["../../src/agent/timeline-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,wBAAwB,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;CAClD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CA6ClG"}

package/dist/agent/timeline-rpc.js

@@ -0,0 +1,59 @@
+import { getTimeline, seedTimeline } from "./agent-service.js";
+import { DEFAULT_PAGE_SIZE } from "./timeline-store.js";
+/**
+ * `fetch_agent_timeline_request` handler (features/timeline-streaming.md § Fetch request/response,
+ * § Behavior — server). Returns full projected items (never deltas) with all paging fields. Bounded
+ * at `DEFAULT_PAGE_SIZE`; clients page to completion (`hasNewer:false`).
+ *
+ * A restarted daemon has no in-memory `AgentTimelineStore` for any agent (it lives only in
+ * process memory — see agent-service.ts). Rather than returning an empty page, fall back to the
+ * agent's provider re-deriving the timeline from its own durable native history (e.g. `pi`'s
+ * on-disk JSONL session file via `AgentClient.hydrateTimeline`), keyed off the record's persisted
+ * `persistence` handle. The result is seeded once into the in-memory store so subsequent pages
+ * (and any later live turn) build on it normally.
+ */
+export function registerTimelineHandler(registry, deps) {
+    registry.register("fetch_agent_timeline_request", (ctx) => {
+        const msg = ctx.message;
+        const agentId = msg.agentId;
+        const direction = msg.direction ?? "after";
+        const cursor = msg.cursor;
+        const limit = typeof msg.limit === "number" && msg.limit > 0 ? msg.limit : DEFAULT_PAGE_SIZE;
+        let timeline = getTimeline(agentId);
+        if (!timeline) {
+            const record = deps.manager.get(agentId)?.record;
+            const handle = record?.persistence;
+            if (record && handle) {
+                const client = deps.resolveClient(record.provider);
+                const rows = client.hydrateTimeline?.(handle) ?? [];
+                if (rows.length > 0)
+                    seedTimeline(agentId, rows);
+            }
+            timeline = getTimeline(agentId);
+        }
+        if (!timeline) {
+            // No in-memory timeline and no rehydratable native history — genuinely empty.
+            return {
+                type: "fetch_agent_timeline_response",
+                requestId: ctx.requestId ?? "",
+                agentId,
+                items: [],
+                seqStart: 0,
+                seqEnd: 0,
+                sourceSeqRanges: [],
+                collapsed: false,
+                hasNewer: false,
+                startCursor: null,
+                endCursor: null,
+            };
+        }
+        const page = timeline.page({ direction, cursor, limit });
+        return {
+            type: "fetch_agent_timeline_response",
+            requestId: ctx.requestId ?? "",
+            agentId,
+            ...page,
+        };
+    });
+}
+//# sourceMappingURL=timeline-rpc.js.map

package/dist/agent/timeline-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-rpc.js","sourceRoot":"","sources":["../../src/agent/timeline-rpc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AASxD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAyB,EAAE,IAAyB;IAC1F,QAAQ,CAAC,QAAQ,CAAC,8BAA8B,EAAE,CAAC,GAAG,EAA2B,EAAE;QACjF,MAAM,GAAG,GAAG,GAAG,CAAC,OAAkC,CAAC;QACnD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAiB,CAAC;QACtC,MAAM,SAAS,GAAI,GAAG,CAAC,SAAgC,IAAI,OAAO,CAAC;QACnE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAmC,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAE7F,IAAI,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,EAAE,WAA4C,CAAC;YACpE,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACnD,CAAC;YACD,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,8EAA8E;YAC9E,OAAO;gBACL,IAAI,EAAE,+BAA+B;gBACrC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;gBAC9B,OAAO;gBACP,KAAK,EAAE,EAAE;gBACT,QAAQ,EAAE,CAAC;gBACX,MAAM,EAAE,CAAC;gBACT,eAAe,EAAE,EAAE;gBACnB,SAAS,EAAE,KAAK;gBAChB,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACzD,OAAO;YACL,IAAI,EAAE,+BAA+B;YACrC,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;YAC9B,OAAO;YACP,GAAG,IAAI;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/agent/timeline-store.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Append-only per-agent timeline store (features/timeline-streaming.md § Timeline model,
+ * § Behavior). Rows persist alongside the agent record in `agents/{cwd}/{id}.json`.
+ *
+ * Key concepts:
+ *  - **Epoch** — each run (`startTurn`) increments the epoch; rows within one epoch are ordered by
+ *    monotonically-increasing `seq`.
+ *  - **Source row** — one `AgentStreamEvent` mapped to one raw storage row (epoch + seq + timestamp
+ *    owned by the daemon, never the provider).
+ *  - **Projected item** — what a client renders. Multi-source events collapse: a tool-call lifecycle
+ *    (status updates, result) is ONE projected item regardless of how many source rows it spans;
+ *    adjacent assistant/reasoning chunks merge into one per run before counting toward the page limit.
+ *  - **Page** — bounded at `DEFAULT_PAGE_SIZE` projected items; supports `direction:"before"|"after"`
+ *    from an opaque cursor (encoded as base-10 `seq` string), with all paging fields.
+ */
+import type { AgentStreamEvent } from "@av-pi-studio/protocol";
+export declare const DEFAULT_PAGE_SIZE = 200;
+export interface TimelineRow {
+    epoch: number;
+    seq: number;
+    /** Daemon-owned canonical timestamp (ISO-8601). */
+    timestamp: string;
+    event: AgentStreamEvent;
+}
+export interface ToolCallItem {
+    kind: "tool_call";
+    callId?: string;
+    sourceSeqStart: number;
+    sourceSeqEnd: number;
+    events: AgentStreamEvent[];
+}
+export interface AssistantItem {
+    kind: "assistant";
+    sourceSeqStart: number;
+    sourceSeqEnd: number;
+    events: AgentStreamEvent[];
+}
+export interface OtherItem {
+    kind: "other";
+    sourceSeq: number;
+    event: AgentStreamEvent;
+}
+export type ProjectedItem = ToolCallItem | AssistantItem | OtherItem;
+/** Collapse a contiguous slice of rows into projected items. */
+export declare function projectRows(rows: TimelineRow[]): ProjectedItem[];
+/** Encode a cursor from a sequence number (opaque string → base-10 decimal). */
+export declare function encodeCursor(seq: number): string;
+/** Decode a cursor; returns `undefined` for an invalid/absent cursor. */
+export declare function decodeCursor(cursor: string | null | undefined): number | undefined;
+export interface SourceSeqRange {
+    start: number;
+    end: number;
+}
+export interface TimelinePage {
+    items: ProjectedItem[];
+    seqStart: number;
+    seqEnd: number;
+    sourceSeqRanges: SourceSeqRange[];
+    collapsed: boolean;
+    hasNewer: boolean;
+    startCursor: string | null;
+    endCursor: string | null;
+}
+export declare class AgentTimelineStore {
+    private rows;
+    private epoch;
+    private nextSeq;
+    private readonly now;
+    constructor(opts?: {
+        initialRows?: TimelineRow[];
+        now?: () => string;
+    });
+    /** Start a new epoch (called when a new run begins). */
+    startEpoch(): number;
+    /** Append one event, assigning the daemon-owned timestamp + monotonic seq. */
+    append(event: AgentStreamEvent): TimelineRow;
+    currentEpoch(): number;
+    allRows(): TimelineRow[];
+    rowCount(): number;
+    /**
+     * Truncate the timeline back to just before the user message identified by messageId.
+     * The messageId corresponds to the `messageId` field in user_message stream events.
+     * Returns the ISO timestamp of the last retained row, or undefined if nothing was retained.
+     * (features/rewind.md § Wire contract)
+     */
+    truncateBeforeMessage(messageId: string): string | undefined;
+    /**
+     * Return a bounded page of projected items.
+     *
+     * `direction:"after"` from cursor returns rows AFTER that seq (newer); `"before"` returns rows
+     * BEFORE that seq (older). Without a cursor, `"after"` returns from the start; `"before"` from
+     * the tail.
+     */
+    page(opts: {
+        direction: "before" | "after";
+        cursor?: string | null;
+        limit?: number;
+    }): TimelinePage;
+}
+//# sourceMappingURL=timeline-store.d.ts.map

package/dist/agent/timeline-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-store.d.ts","sourceRoot":"","sources":["../../src/agent/timeline-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAMrC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAaD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAErE,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,CAgDhE;AAMD,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlF;AAMD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAMD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,IAAI,GAAE;QAAE,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAU1E,wDAAwD;IACxD,UAAU,IAAI,MAAM;IAKpB,8EAA8E;IAC9E,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW;IAW5C,YAAY,IAAI,MAAM;IAItB,OAAO,IAAI,WAAW,EAAE;IAIxB,QAAQ,IAAI,MAAM;IAIlB;;;;;OAKG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAe5D;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE;QACT,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,YAAY;CAkFjB"}