@av-pi-studio/server 0.0.1

package/dist/agent/agent-manager.d.ts

@@ -0,0 +1,107 @@
+import type { AgentStatus } from "@av-pi-studio/protocol";
+import type { AgentRecord } from "../persistence/entity-schemas.js";
+import type { AgentSession } from "./provider-contract.js";
+/**
+ * AgentManager — the single source of truth for agent lifecycle state
+ * (architecture/agent-lifecycle.md § States / § Lifecycle status semantics / § Relationship labels,
+ * daemon-bootstrap.md § Recovery). State changes persist to the agent record AND broadcast
+ * `agent_update` to all subscribers. Status is **literal**: a parent stays `idle` even while a child
+ * runs.
+ */
+export declare const PARENT_AGENT_ID_LABEL = "pi-studio.parent-agent-id";
+/** A managed agent: its persisted record, optional live session, and derived parent id. */
+export interface ManagedAgent {
+    record: AgentRecord;
+    session: AgentSession | null;
+    parentAgentId: string | null;
+}
+/** Broadcast shape for an `agent_update` (matches the protocol session message). */
+export interface AgentUpdateBroadcast {
+    type: "agent_update";
+    agentId: string;
+    status: AgentStatus;
+    title?: string;
+    labels: Record<string, string>;
+}
+/** Broadcast shape for an `agent_archived` lifecycle event. */
+export interface AgentArchivedBroadcast {
+    type: "agent_archived";
+    agentId: string;
+    archivedAt: string;
+}
+/** Broadcast shape for an `agent_deleted` lifecycle event (hard delete — no persisted trace). */
+export interface AgentDeletedBroadcast {
+    type: "agent_deleted";
+    agentId: string;
+}
+export type AgentManagerEvent = AgentUpdateBroadcast | AgentArchivedBroadcast | AgentDeletedBroadcast;
+export type AgentManagerSubscriber = (event: AgentManagerEvent) => void;
+export declare class InvalidAgentTransitionError extends Error {
+    constructor(from: AgentStatus, to: AgentStatus);
+}
+export declare function canTransition(from: AgentStatus, to: AgentStatus): boolean;
+export interface AgentManagerDeps {
+    home: string;
+    saveAgent?: (record: AgentRecord) => Promise<void>;
+    loadAllAgents?: () => Promise<AgentRecord[]>;
+    /** Delete a persisted agent record file by (cwd, id). Injectable for tests. */
+    deleteAgent?: (cwd: string, id: string) => Promise<boolean>;
+    /** Loop service hook: recover `running` loops as `stopped` with an interruption log entry. */
+    onRecoverLoops?: () => Promise<void> | void;
+    now?: () => string;
+}
+export declare class AgentManager {
+    private readonly deps;
+    private readonly agents;
+    private readonly subscribers;
+    private readonly save;
+    private readonly loadAll;
+    private readonly delete;
+    private readonly now;
+    constructor(deps: AgentManagerDeps);
+    subscribe(cb: AgentManagerSubscriber): () => void;
+    private broadcast;
+    private wrap;
+    /** Register a new agent: persist + broadcast its initial state. */
+    add(record: AgentRecord): Promise<ManagedAgent>;
+    attachSession(id: string, session: AgentSession): void;
+    /**
+     * Snapshot and persist the live session's resume handle (e.g. Pi's on-disk JSONL session file)
+     * onto the record. Called right after session creation/attach so a plain daemon restart — not
+     * just an archive — leaves a handle behind: without one, `fetch_agent_timeline_request` has no
+     * way to rebuild an agent's conversation once its in-memory timeline is gone
+     * (architecture/persistence.md § Agent record `persistence` field).
+     */
+    persistSessionHandle(id: string): Promise<void>;
+    /** Transition an agent's `lastStatus`, persisting and broadcasting the change. */
+    setStatus(id: string, status: AgentStatus): Promise<ManagedAgent>;
+    get(id: string): ManagedAgent | undefined;
+    /** Active (non-archived) agents. */
+    list(): ManagedAgent[];
+    /** Every tracked agent, including archived. */
+    listAll(): ManagedAgent[];
+    parentAgentId(id: string): string | null;
+    private broadcastArchived;
+    /**
+     * Archive (soft delete) an agent and recursively cascade to its non-detached children
+     * (architecture/agent-lifecycle.md § Archive). Snapshots the session's persistence handle, sets
+     * `archivedAt`, normalizes `lastStatus` away from running/initializing, notifies subscribers,
+     * closes/kills the runtime, then archives each child whose parent label points at this agent.
+     * Detached agents (no parent label) are never cascade-archived. Idempotent.
+     */
+    archiveAgent(id: string): Promise<void>;
+    private broadcastDeleted;
+    /**
+     * Hard-delete an agent: closes/kills any live runtime, removes its persisted record file from
+     * disk, drops it from memory, and recursively cascades to its non-detached children — same
+     * cascade rule as `archiveAgent`. Unlike archive, there is no trace left to resume from. Returns
+     * true if the agent existed (false = already gone, still idempotent/no-op).
+     */
+    deleteAgent(id: string): Promise<boolean>;
+    /**
+     * Boot recovery: rehydrate persisted agents (runtime is NOT auto-resumed — records only), then run
+     * the loop-recovery hook (`running` loops → `stopped`). Returns the number of agents reloaded.
+     */
+    recover(): Promise<number>;
+}
+//# sourceMappingURL=agent-manager.d.ts.map

package/dist/agent/agent-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.d.ts","sourceRoot":"","sources":["../../src/agent/agent-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAO1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;GAMG;AAEH,eAAO,MAAM,qBAAqB,8BAA8B,CAAC;AAEjE,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,iGAAiG;AACjG,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AACtG,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAExE,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW;CAI/C;AAWD,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,OAAO,CAGzE;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IAQX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgD;IACvE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEN,IAAI,EAAE,gBAAgB;IAOnD,SAAS,CAAC,EAAE,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAKjD,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,IAAI;IAQZ,mEAAmE;IAC7D,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAQrD,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKtD;;;;;;OAMG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAarD,kFAAkF;IAC5E,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAavE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC,oCAAoC;IACpC,IAAI,IAAI,YAAY,EAAE;IAItB,+CAA+C;IAC/C,OAAO,IAAI,YAAY,EAAE;IAIzB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIxC,OAAO,CAAC,iBAAiB;IAKzB;;;;;;OAMG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C7C,OAAO,CAAC,gBAAgB;IAKxB;;;;;OAKG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB/C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAQjC"}

package/dist/agent/agent-manager.js

@@ -0,0 +1,218 @@
+import { deleteAgent as deleteAgentFromDisk, loadAllAgents as loadAllAgentsFromDisk, saveAgent as saveAgentToDisk, } from "../persistence/entity-stores.js";
+/**
+ * AgentManager — the single source of truth for agent lifecycle state
+ * (architecture/agent-lifecycle.md § States / § Lifecycle status semantics / § Relationship labels,
+ * daemon-bootstrap.md § Recovery). State changes persist to the agent record AND broadcast
+ * `agent_update` to all subscribers. Status is **literal**: a parent stays `idle` even while a child
+ * runs.
+ */
+export const PARENT_AGENT_ID_LABEL = "pi-studio.parent-agent-id";
+export class InvalidAgentTransitionError extends Error {
+    constructor(from, to) {
+        super(`invalid agent transition: ${from} → ${to}`);
+        this.name = "InvalidAgentTransitionError";
+    }
+}
+// initializing → idle ⇄ running ; idle/running → error → closed (closed is terminal).
+const ALLOWED_TRANSITIONS = {
+    initializing: new Set(["idle", "error", "closed"]),
+    idle: new Set(["running", "error", "closed"]),
+    running: new Set(["idle", "error", "closed"]),
+    error: new Set(["idle", "closed"]),
+    closed: new Set(),
+};
+export function canTransition(from, to) {
+    if (from === to)
+        return true;
+    return ALLOWED_TRANSITIONS[from].has(to);
+}
+export class AgentManager {
+    deps;
+    agents = new Map();
+    subscribers = new Set();
+    save;
+    loadAll;
+    delete;
+    now;
+    constructor(deps) {
+        this.deps = deps;
+        this.save = deps.saveAgent ?? ((record) => saveAgentToDisk(deps.home, record));
+        this.loadAll = deps.loadAllAgents ?? (() => loadAllAgentsFromDisk(deps.home));
+        this.delete = deps.deleteAgent ?? ((cwd, id) => deleteAgentFromDisk(deps.home, cwd, id));
+        this.now = deps.now ?? (() => new Date().toISOString());
+    }
+    subscribe(cb) {
+        this.subscribers.add(cb);
+        return () => this.subscribers.delete(cb);
+    }
+    broadcast(record) {
+        const update = {
+            type: "agent_update",
+            agentId: record.id,
+            status: record.lastStatus,
+            ...(record.title ? { title: record.title } : {}),
+            labels: record.labels,
+        };
+        for (const cb of this.subscribers)
+            cb(update);
+    }
+    wrap(record, session = null) {
+        return {
+            record,
+            session,
+            parentAgentId: record.labels[PARENT_AGENT_ID_LABEL] ?? null,
+        };
+    }
+    /** Register a new agent: persist + broadcast its initial state. */
+    async add(record) {
+        const managed = this.wrap(record);
+        this.agents.set(record.id, managed);
+        await this.save(record);
+        this.broadcast(record);
+        return managed;
+    }
+    attachSession(id, session) {
+        const managed = this.agents.get(id);
+        if (managed)
+            managed.session = session;
+    }
+    /**
+     * Snapshot and persist the live session's resume handle (e.g. Pi's on-disk JSONL session file)
+     * onto the record. Called right after session creation/attach so a plain daemon restart — not
+     * just an archive — leaves a handle behind: without one, `fetch_agent_timeline_request` has no
+     * way to rebuild an agent's conversation once its in-memory timeline is gone
+     * (architecture/persistence.md § Agent record `persistence` field).
+     */
+    async persistSessionHandle(id) {
+        const managed = this.agents.get(id);
+        if (!managed?.session)
+            return;
+        const handle = managed.session.describePersistence();
+        if (!handle)
+            return;
+        managed.record = {
+            ...managed.record,
+            persistence: handle,
+            updatedAt: this.now(),
+        };
+        await this.save(managed.record);
+    }
+    /** Transition an agent's `lastStatus`, persisting and broadcasting the change. */
+    async setStatus(id, status) {
+        const managed = this.agents.get(id);
+        if (!managed)
+            throw new Error(`unknown agent: ${id}`);
+        const from = managed.record.lastStatus;
+        if (!canTransition(from, status))
+            throw new InvalidAgentTransitionError(from, status);
+        managed.record = { ...managed.record, lastStatus: status, updatedAt: this.now() };
+        await this.save(managed.record);
+        this.broadcast(managed.record);
+        return managed;
+    }
+    get(id) {
+        return this.agents.get(id);
+    }
+    /** Active (non-archived) agents. */
+    list() {
+        return [...this.agents.values()].filter((m) => !m.record.archivedAt);
+    }
+    /** Every tracked agent, including archived. */
+    listAll() {
+        return [...this.agents.values()];
+    }
+    parentAgentId(id) {
+        return this.agents.get(id)?.parentAgentId ?? null;
+    }
+    broadcastArchived(agentId, archivedAt) {
+        const event = { type: "agent_archived", agentId, archivedAt };
+        for (const cb of this.subscribers)
+            cb(event);
+    }
+    /**
+     * Archive (soft delete) an agent and recursively cascade to its non-detached children
+     * (architecture/agent-lifecycle.md § Archive). Snapshots the session's persistence handle, sets
+     * `archivedAt`, normalizes `lastStatus` away from running/initializing, notifies subscribers,
+     * closes/kills the runtime, then archives each child whose parent label points at this agent.
+     * Detached agents (no parent label) are never cascade-archived. Idempotent.
+     */
+    async archiveAgent(id) {
+        const managed = this.agents.get(id);
+        if (!managed || managed.record.archivedAt)
+            return;
+        // Snapshot the live session's persistence handle so the record can resume later.
+        let persistence = managed.record.persistence;
+        if (managed.session) {
+            const handle = managed.session.describePersistence();
+            if (handle)
+                persistence = handle;
+        }
+        const archivedAt = this.now();
+        const lastStatus = managed.record.lastStatus === "running" || managed.record.lastStatus === "initializing"
+            ? "closed"
+            : managed.record.lastStatus;
+        managed.record = {
+            ...managed.record,
+            archivedAt,
+            lastStatus,
+            ...(persistence ? { persistence } : {}),
+            updatedAt: archivedAt,
+        };
+        await this.save(managed.record);
+        // Close the runtime (kills the process if still running).
+        if (managed.session) {
+            await managed.session.close();
+            managed.session = null;
+        }
+        this.broadcastArchived(id, archivedAt);
+        // Cascade to non-detached children (those whose parent label == this id).
+        for (const child of this.listAll()) {
+            if (child.record.id !== id && child.parentAgentId === id && !child.record.archivedAt) {
+                await this.archiveAgent(child.record.id);
+            }
+        }
+    }
+    broadcastDeleted(agentId) {
+        const event = { type: "agent_deleted", agentId };
+        for (const cb of this.subscribers)
+            cb(event);
+    }
+    /**
+     * Hard-delete an agent: closes/kills any live runtime, removes its persisted record file from
+     * disk, drops it from memory, and recursively cascades to its non-detached children — same
+     * cascade rule as `archiveAgent`. Unlike archive, there is no trace left to resume from. Returns
+     * true if the agent existed (false = already gone, still idempotent/no-op).
+     */
+    async deleteAgent(id) {
+        const managed = this.agents.get(id);
+        if (!managed)
+            return false;
+        if (managed.session) {
+            await managed.session.close();
+            managed.session = null;
+        }
+        await this.delete(managed.record.cwd, id);
+        this.agents.delete(id);
+        this.broadcastDeleted(id);
+        // Cascade to non-detached children (those whose parent label == this id) — snapshot first,
+        // since deleting mutates `this.agents` out from under a live iteration.
+        const children = this.listAll().filter((child) => child.record.id !== id && child.parentAgentId === id);
+        for (const child of children) {
+            await this.deleteAgent(child.record.id);
+        }
+        return true;
+    }
+    /**
+     * Boot recovery: rehydrate persisted agents (runtime is NOT auto-resumed — records only), then run
+     * the loop-recovery hook (`running` loops → `stopped`). Returns the number of agents reloaded.
+     */
+    async recover() {
+        const records = await this.loadAll();
+        for (const record of records) {
+            this.agents.set(record.id, this.wrap(record, null));
+        }
+        await this.deps.onRecoverLoops?.();
+        return records.length;
+    }
+}
+//# sourceMappingURL=agent-manager.js.map

package/dist/agent/agent-manager.js.map

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

package/dist/agent/agent-service.d.ts

@@ -0,0 +1,36 @@
+import type { Session } from "../ws/session.js";
+import type { HandlerRegistry } from "../ws/router.js";
+import { AgentManager } from "./agent-manager.js";
+import type { AgentClient, AgentSession, RunOptions } from "./provider-contract.js";
+import { AgentTimelineStore } from "./timeline-store.js";
+/**
+ * AgentService wires `create_agent_request` + run/turn loop + `agent_stream` broadcast
+ * (features/agent-sessions.md § Create / § Behavior, architecture/websocket-protocol.md).
+ */
+export interface AgentServiceDeps {
+    manager: AgentManager;
+    resolveClient: (provider: string) => AgentClient;
+    broadcast: (sessions: Iterable<Session>, message: unknown) => void;
+    now?: () => string;
+}
+export declare function getTimeline(agentId: string): AgentTimelineStore | undefined;
+/**
+ * Seed the in-memory timeline for an agent that has none yet (e.g. right after a daemon restart)
+ * from externally rehydrated rows — see `timeline-rpc.ts`'s fallback to a provider's
+ * `hydrateTimeline()`. No-op if a timeline already exists (never overwrites live/streamed rows).
+ */
+export declare function seedTimeline(agentId: string, rows: import("./timeline-store.js").TimelineRow[]): void;
+export declare class AgentService {
+    private readonly deps;
+    private readonly now;
+    constructor(deps: AgentServiceDeps);
+    registerHandlers(registry: HandlerRegistry, getActiveSessions: () => Iterable<Session>): void;
+    private broadcastAll;
+    handleCreate(msg: Record<string, unknown>, getSessions: () => Iterable<Session>): Promise<unknown>;
+    handleSendPrompt(msg: Record<string, unknown>, getSessions: () => Iterable<Session>): Promise<unknown>;
+    runTurn(agentId: string, session: AgentSession, prompt: string, getSessions: () => Iterable<Session>, opts?: RunOptions & {
+        clientMessageId?: string;
+        autoArchive?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=agent-service.d.ts.map

package/dist/agent/agent-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-service.d.ts","sourceRoot":"","sources":["../../src/agent/agent-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,WAAW,CAAC;IACjD,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAcD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,qBAAqB,EAAE,WAAW,EAAE,GAAG,IAAI,CAGrG;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEN,IAAI,EAAE,gBAAgB;IAInD,gBAAgB,CAAC,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;IAS7F,OAAO,CAAC,YAAY;IAId,YAAY,CAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,WAAW,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,GACnC,OAAO,CAAC,OAAO,CAAC;IA6Db,gBAAgB,CACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,WAAW,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,GACnC,OAAO,CAAC,OAAO,CAAC;IAYb,OAAO,CACX,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,EACpC,IAAI,GAAE,UAAU,GAAG;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1E,OAAO,CAAC,IAAI,CAAC;CAkGjB"}

package/dist/agent/agent-service.js

@@ -0,0 +1,195 @@
+import { randomUUID } from "node:crypto";
+import { AgentManager, PARENT_AGENT_ID_LABEL } from "./agent-manager.js";
+import { AgentTimelineStore } from "./timeline-store.js";
+/** In-memory timeline per agentId; persisted rows are on the AgentRecord.timeline. */
+const timelinesByAgentId = new Map();
+function getOrCreateTimeline(agentId, now) {
+    let t = timelinesByAgentId.get(agentId);
+    if (!t) {
+        t = new AgentTimelineStore({ now });
+        timelinesByAgentId.set(agentId, t);
+    }
+    return t;
+}
+export function getTimeline(agentId) {
+    return timelinesByAgentId.get(agentId);
+}
+/**
+ * Seed the in-memory timeline for an agent that has none yet (e.g. right after a daemon restart)
+ * from externally rehydrated rows — see `timeline-rpc.ts`'s fallback to a provider's
+ * `hydrateTimeline()`. No-op if a timeline already exists (never overwrites live/streamed rows).
+ */
+export function seedTimeline(agentId, rows) {
+    if (timelinesByAgentId.has(agentId))
+        return;
+    timelinesByAgentId.set(agentId, new AgentTimelineStore({ initialRows: rows }));
+}
+export class AgentService {
+    deps;
+    now;
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? (() => new Date().toISOString());
+    }
+    registerHandlers(registry, getActiveSessions) {
+        registry.register("create_agent_request", (ctx) => this.handleCreate(ctx.message, getActiveSessions));
+        registry.register("send_agent_prompt", (ctx) => this.handleSendPrompt(ctx.message, getActiveSessions));
+    }
+    broadcastAll(sessions, message) {
+        this.deps.broadcast(sessions, message);
+    }
+    async handleCreate(msg, getSessions) {
+        const requestId = msg.requestId ?? randomUUID();
+        const config = msg.config;
+        if (!config)
+            throw new Error("missing config");
+        const provider = config.provider ?? "mock";
+        const cwd = config.cwd ?? ".";
+        const initialPrompt = msg.initialPrompt;
+        const title = config.title ?? msg.title;
+        const labels = msg.labels ?? {};
+        if (title && !labels["title"])
+            labels["title"] = title;
+        const clientMessageId = msg.clientMessageId;
+        const autoArchive = Boolean(msg.autoArchive);
+        // 1. Create the agent record at status "initializing".
+        const record = {
+            id: randomUUID(),
+            provider,
+            cwd,
+            createdAt: this.now(),
+            updatedAt: this.now(),
+            labels,
+            lastStatus: "initializing",
+            timeline: [],
+        };
+        const managed = await this.deps.manager.add(record);
+        const agentId = record.id;
+        this.broadcastAll(getSessions(), {
+            type: "agent_update",
+            agentId,
+            status: "initializing",
+            labels,
+        });
+        // 2. Create the provider session → status "idle".
+        const client = this.deps.resolveClient(provider);
+        const session = await client.createSession({ provider, cwd, ...config }, { cwd });
+        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", labels });
+        // 3. Run initial prompt if provided.
+        if (initialPrompt) {
+            await this.runTurn(agentId, session, initialPrompt, getSessions, {
+                clientMessageId,
+                autoArchive,
+                images: msg.images,
+            });
+        }
+        return {
+            type: "create_agent_response",
+            requestId,
+            payload: { agentId },
+        };
+    }
+    async handleSendPrompt(msg, getSessions) {
+        const agentId = msg.agentId;
+        const prompt = msg.prompt;
+        const managed = this.deps.manager.get(agentId);
+        if (!managed?.session)
+            throw new Error(`no live session for agent ${agentId}`);
+        await this.runTurn(agentId, managed.session, prompt, getSessions, {
+            clientMessageId: msg.clientMessageId,
+            images: msg.images,
+        });
+        return { type: "agent_prompt_response", agentId, status: "idle" };
+    }
+    async runTurn(agentId, session, prompt, getSessions, opts = {}) {
+        const timeline = getOrCreateTimeline(agentId, this.now);
+        timeline.startEpoch();
+        await this.deps.manager.setStatus(agentId, "running");
+        this.broadcastAll(getSessions(), { type: "agent_update", agentId, status: "running" });
+        let userMessageEmitted = false;
+        let userMessageId;
+        const unsubscribe = session.subscribe((event) => {
+            // Canonical user_message: emit exactly once keyed by provider message id.
+            if (event.kind === "user_message" && !userMessageEmitted) {
+                const msgId = event.messageId ?? opts.clientMessageId ?? randomUUID();
+                if (userMessageId === undefined || userMessageId === msgId) {
+                    userMessageId = msgId;
+                    userMessageEmitted = true;
+                    const userRow = timeline.append({
+                        kind: "user_message",
+                        messageId: msgId,
+                        text: prompt,
+                        images: opts.images,
+                    });
+                    this.broadcastAll(getSessions(), {
+                        type: "session",
+                        message: {
+                            type: "agent_stream",
+                            agentId,
+                            seq: userRow.seq,
+                            timestamp: userRow.timestamp,
+                            event: { kind: "user_message", messageId: msgId, text: prompt, images: opts.images },
+                        },
+                    });
+                    return;
+                }
+            }
+            // All other events: append + broadcast.
+            const row = timeline.append(event);
+            this.broadcastAll(getSessions(), {
+                type: "session",
+                message: {
+                    type: "agent_stream",
+                    agentId,
+                    seq: row.seq,
+                    timestamp: row.timestamp,
+                    event,
+                },
+            });
+        });
+        // If provider never emits a user_message, emit one ourselves.
+        if (!userMessageEmitted) {
+            const msgId = opts.clientMessageId ?? randomUUID();
+            userMessageId = msgId;
+            const row = timeline.append({
+                kind: "user_message",
+                messageId: msgId,
+                text: prompt,
+                images: opts.images,
+            });
+            this.broadcastAll(getSessions(), {
+                type: "session",
+                message: {
+                    type: "agent_stream",
+                    agentId,
+                    seq: row.seq,
+                    timestamp: row.timestamp,
+                    event: { kind: "user_message", messageId: msgId, text: prompt, images: opts.images },
+                },
+            });
+        }
+        try {
+            await session.run(prompt, opts);
+        }
+        finally {
+            unsubscribe();
+        }
+        const finalManaged = this.deps.manager.get(agentId);
+        const lastEvent = timeline.allRows().at(-1)?.event;
+        const newStatus = lastEvent?.kind === "turn_failed" || lastEvent?.kind === "error" ? "error" : "idle";
+        await this.deps.manager.setStatus(agentId, newStatus);
+        this.broadcastAll(getSessions(), { type: "agent_update", agentId, status: newStatus });
+        // autoArchive hook (worktree coupling wired in sprint-008).
+        if (opts.autoArchive &&
+            (lastEvent?.kind === "turn_completed" ||
+                lastEvent?.kind === "turn_failed" ||
+                lastEvent?.kind === "turn_canceled") &&
+            finalManaged) {
+            await this.deps.manager.archiveAgent(agentId);
+        }
+    }
+}
+//# sourceMappingURL=agent-service.js.map

package/dist/agent/agent-service.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./provider-contract.js";
+export * from "./providers/mock/mock-provider.js";
+export * from "./providers/pi/agent.js";
+export * from "./providers/pi/event-mapper.js";
+export * from "./providers/pi/rpc-transport.js";
+export * from "./manifest.js";
+export * from "./provider-registry.js";
+export * from "./provider-snapshot.js";
+export * from "./agent-manager.js";
+export * from "./timeline-store.js";
+export * from "./agent-service.js";
+export * from "./timeline-rpc.js";
+export * from "./session-operations.js";
+export * from "./permissions.js";
+export * from "./structured-generation.js";
+export * from "./mcp-server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,18 @@
+// Provider contracts, providers, registry, snapshot, and the agent manager.
+export * from "./provider-contract.js";
+export * from "./providers/mock/mock-provider.js";
+export * from "./providers/pi/agent.js";
+export * from "./providers/pi/event-mapper.js";
+export * from "./providers/pi/rpc-transport.js";
+export * from "./manifest.js";
+export * from "./provider-registry.js";
+export * from "./provider-snapshot.js";
+export * from "./agent-manager.js";
+export * from "./timeline-store.js";
+export * from "./agent-service.js";
+export * from "./timeline-rpc.js";
+export * from "./session-operations.js";
+export * from "./permissions.js";
+export * from "./structured-generation.js";
+export * from "./mcp-server.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,cAAc,wBAAwB,CAAC;AACvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC"}

package/dist/agent/manifest.d.ts

@@ -0,0 +1,7 @@
+import type { ProviderDefinition } from "@av-pi-studio/protocol";
+/**
+ * Provider manifest (features/agent-providers.md § Registration surface). UI scaffolding only —
+ * actual models/modes/features are discovered at runtime. Modes carry an `icon` + `colorTier`.
+ */
+export declare const PROVIDER_MANIFEST: Record<string, ProviderDefinition>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/agent/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/agent/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAKjE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAmBhE,CAAC"}