@av-pi-studio/server 0.0.1

package/dist/agent/provider-contract.d.ts

@@ -0,0 +1,134 @@
+import type { AgentCapabilityFlags, AgentSessionConfig, AgentStreamEvent, ImageAttachment } from "@av-pi-studio/protocol";
+import type { AgentFeature } from "../persistence/entity-schemas.js";
+import type { TimelineRow } from "./timeline-store.js";
+/**
+ * Provider-neutral agent contracts (features/agent-providers.md § AgentClient / § AgentSession /
+ * § Capability flags). The rest of the daemon depends only on these interfaces, never on a concrete
+ * provider (`pi`, `mock`), so providers stay swappable.
+ */
+export type Unsubscribe = () => void;
+/** Resume / persistence handle for a provider-native session. */
+export interface PersistenceHandle {
+    provider: string;
+    sessionId?: string;
+    /** Provider-opaque resume token (e.g. the Pi JSONL session file path). */
+    nativeHandle?: unknown;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentModelDefinition {
+    id: string;
+    label?: string;
+    description?: string;
+}
+export interface AgentModeDefinition {
+    id: string;
+    label?: string;
+    description?: string;
+}
+export interface AgentCommandDefinition {
+    id: string;
+    label?: string;
+    description?: string;
+}
+/** Runtime info echoed from a live session. */
+export interface ProviderRuntimeInfo {
+    provider: string;
+    sessionId?: string;
+    model?: string;
+    thinkingOptionId?: string;
+    modeId?: string;
+    extra?: Record<string, unknown>;
+}
+export interface PendingPermission {
+    requestId: string;
+    toolName?: string;
+    detail?: unknown;
+}
+/** Context passed when launching/resuming a session (cwd, env, logger, …). */
+export interface LaunchContext {
+    cwd?: string;
+    env?: Record<string, string>;
+    logger?: Pick<Console, "info" | "warn" | "error">;
+}
+export interface RunOptions {
+    images?: ImageAttachment[];
+    attachments?: unknown;
+    clientMessageId?: string;
+    outputSchema?: Record<string, unknown>;
+}
+export type StartTurnOptions = RunOptions;
+export interface CreateSessionOptions {
+    env?: Record<string, string>;
+}
+/** A row in the importable-session picker (no full transcript). */
+export interface ImportableSessionRow {
+    providerHandleId: string;
+    cwd: string;
+    title?: string;
+    promptPreview?: string;
+    lastActivityAt?: string;
+}
+export interface ImportSessionArgs {
+    providerHandleId: string;
+    cwd: string;
+}
+export interface ImportSessionResult {
+    session: AgentSession;
+    persistence: PersistenceHandle;
+    timeline: AgentStreamEvent[];
+}
+/** One running instance of an agent: one provider, one model, one cwd, one timeline. */
+export interface AgentSession {
+    readonly provider: string;
+    readonly id: string;
+    readonly capabilities: AgentCapabilityFlags;
+    readonly features?: AgentFeature[];
+    run(prompt: string, opts?: RunOptions): Promise<void>;
+    startTurn(prompt: string, opts?: StartTurnOptions): Promise<{
+        turnId: string;
+    }>;
+    subscribe(cb: (event: AgentStreamEvent) => void): Unsubscribe;
+    streamHistory(): AsyncGenerator<AgentStreamEvent>;
+    getRuntimeInfo(): ProviderRuntimeInfo;
+    getAvailableModes(): AgentModeDefinition[];
+    getCurrentMode(): string | null;
+    setMode(id: string): Promise<void>;
+    getPendingPermissions(): PendingPermission[];
+    respondToPermission(requestId: string, response: unknown): Promise<void>;
+    describePersistence(): PersistenceHandle | null;
+    interrupt(): Promise<void>;
+    close(): Promise<void>;
+    listCommands?(): Promise<AgentCommandDefinition[]>;
+    setModel?(id: string): Promise<void>;
+    setThinkingOption?(id: string): Promise<void>;
+    setFeature?(id: string, value: unknown): Promise<void>;
+    tryHandleOutOfBand?(message: unknown): boolean;
+}
+/** A provider client: creates/resumes sessions and exposes discovery. */
+export interface AgentClient {
+    readonly provider: string;
+    readonly capabilities: AgentCapabilityFlags;
+    createSession(config: AgentSessionConfig, launchContext?: LaunchContext, options?: CreateSessionOptions): Promise<AgentSession>;
+    resumeSession(handle: PersistenceHandle, overrides?: Partial<AgentSessionConfig>, launchContext?: LaunchContext): Promise<AgentSession>;
+    listModels(opts?: {
+        cwd?: string;
+    }): Promise<AgentModelDefinition[]>;
+    isAvailable(): Promise<boolean> | boolean;
+    listModes?(opts?: {
+        cwd?: string;
+    }): Promise<AgentModeDefinition[]>;
+    listImportableSessions?(opts?: {
+        cwd?: string;
+    }): Promise<ImportableSessionRow[]>;
+    importSession?(args: ImportSessionArgs): Promise<ImportSessionResult>;
+    getDiagnostic?(): Promise<unknown>;
+    /**
+     * Rebuild a full timeline from a provider-native resume handle, without spawning a live
+     * session. Used when the daemon's in-memory `AgentTimelineStore` is empty (e.g. after a
+     * restart) but the agent record still carries a `persistence` handle — the `pi` provider
+     * implements this by reading its own on-disk JSONL session file
+     * (`session-hydration.ts`). Providers without durable native history omit this.
+     */
+    hydrateTimeline?(handle: PersistenceHandle): TimelineRow[];
+}
+//# sourceMappingURL=provider-contract.d.ts.map

package/dist/agent/provider-contract.d.ts.map

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

package/dist/agent/provider-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-contract.js.map

package/dist/agent/provider-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-contract.js","sourceRoot":"","sources":["../../src/agent/provider-contract.ts"],"names":[],"mappings":""}

package/dist/agent/provider-registry.d.ts

@@ -0,0 +1,37 @@
+import type { ProviderDefinition } from "@av-pi-studio/protocol";
+import type { PersistedConfig } from "../config/daemon-config.js";
+import type { AgentClient } from "./provider-contract.js";
+import type { PiTransportFactory } from "./providers/pi/rpc-transport.js";
+/**
+ * Provider client-factory registry + custom Pi-compatible profile resolution
+ * (features/agent-providers.md § Registration surface / § Custom Pi-compatible profiles;
+ * config.md § Provider override).
+ */
+export interface ProviderClientDeps {
+    logger?: Pick<Console, "info" | "warn" | "error">;
+    /** Injected for tests. */
+    transportFactory?: PiTransportFactory;
+    binaryResolver?: (bin: string, env?: Record<string, string | undefined>) => boolean;
+}
+export type ProviderClientFactory = (deps?: ProviderClientDeps) => AgentClient;
+/** Built-in provider factories, invoked with `(logger, runtimeSettings, options)`-style deps. */
+export declare const PROVIDER_CLIENT_FACTORIES: Record<string, ProviderClientFactory>;
+/**
+ * Resolve a usable `AgentClient` for `providerId`. Built-ins use their factory; an override of `pi`
+ * applies its settings; a custom `extends:"pi"` profile launches via its own `command` and locates
+ * imports via `params.sessionDir`. Building a client does **not** spawn Pi.
+ */
+export declare function resolveProviderClient(providerId: string, config: PersistedConfig, deps?: ProviderClientDeps): AgentClient;
+/**
+ * Holds visible provider metadata (manifest + config overrides). Replacing metadata updates
+ * label/description/enabled/default-mode only — it must **never** spawn the Pi process.
+ */
+export declare class ProviderRegistry {
+    private metadata;
+    constructor(manifest?: Record<string, ProviderDefinition>);
+    getMetadata(providerId: string): ProviderDefinition | undefined;
+    listMetadata(): ProviderDefinition[];
+    /** Merge config provider overrides into visible metadata. Does not construct/launch any client. */
+    replaceMetadata(config: PersistedConfig): void;
+}
+//# sourceMappingURL=provider-registry.d.ts.map

package/dist/agent/provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/agent/provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,4BAA4B,CAAC;AACpF,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,wBAAwB,CAAC;AAIhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAClD,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;IACtC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,OAAO,CAAC;CACrF;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,CAAC,EAAE,kBAAkB,KAAK,WAAW,CAAC;AAE/E,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAO3E,CAAC;AAqCF;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE,kBAAkB,GACxB,WAAW,CAWb;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAqC;gBAEzC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAqB;IAI5E,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/D,YAAY,IAAI,kBAAkB,EAAE;IAIpC,mGAAmG;IACnG,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;CAe/C"}

package/dist/agent/provider-registry.js

@@ -0,0 +1,92 @@
+import { PROVIDER_MANIFEST } from "./manifest.js";
+import { MockAgentClient } from "./providers/mock/mock-provider.js";
+import { PiAgentClient } from "./providers/pi/agent.js";
+/** Built-in provider factories, invoked with `(logger, runtimeSettings, options)`-style deps. */
+export const PROVIDER_CLIENT_FACTORIES = {
+    pi: (deps) => new PiAgentClient({
+        transportFactory: deps?.transportFactory,
+        binaryResolver: deps?.binaryResolver,
+    }),
+    mock: () => new MockAgentClient(),
+};
+/** Wrap `listModels` so a custom profile's `models` replaces and `additionalModels` merge/relabel. */
+function applyModelOverrides(client, override) {
+    if (!override.models && !override.additionalModels)
+        return client;
+    const baseList = override.models;
+    const additional = override.additionalModels ?? [];
+    const original = client.listModels.bind(client);
+    client.listModels = async (opts) => {
+        const base = baseList ?? (await original(opts));
+        const byId = new Map(base.map((m) => [m.id, m]));
+        for (const model of additional)
+            byId.set(model.id, { ...byId.get(model.id), ...model });
+        return [...byId.values()];
+    };
+    return client;
+}
+function buildPiClient(providerId, override, deps) {
+    const client = new PiAgentClient({
+        provider: providerId,
+        command: override?.command,
+        env: override?.env,
+        sessionDir: override?.params && typeof override.params.sessionDir === "string"
+            ? override.params.sessionDir
+            : undefined,
+        transportFactory: deps?.transportFactory,
+        binaryResolver: deps?.binaryResolver,
+    });
+    return override ? applyModelOverrides(client, override) : client;
+}
+/**
+ * Resolve a usable `AgentClient` for `providerId`. Built-ins use their factory; an override of `pi`
+ * applies its settings; a custom `extends:"pi"` profile launches via its own `command` and locates
+ * imports via `params.sessionDir`. Building a client does **not** spawn Pi.
+ */
+export function resolveProviderClient(providerId, config, deps) {
+    const override = config.agents.providers[providerId];
+    if (providerId === "pi")
+        return buildPiClient("pi", override, deps);
+    if (providerId === "mock")
+        return new MockAgentClient();
+    if (override?.extends === "pi")
+        return buildPiClient(providerId, override, deps);
+    const factory = PROVIDER_CLIENT_FACTORIES[providerId];
+    if (factory)
+        return factory(deps);
+    throw new Error(`unknown provider: ${providerId}`);
+}
+/**
+ * Holds visible provider metadata (manifest + config overrides). Replacing metadata updates
+ * label/description/enabled/default-mode only — it must **never** spawn the Pi process.
+ */
+export class ProviderRegistry {
+    metadata;
+    constructor(manifest = PROVIDER_MANIFEST) {
+        this.metadata = { ...manifest };
+    }
+    getMetadata(providerId) {
+        return this.metadata[providerId];
+    }
+    listMetadata() {
+        return Object.values(this.metadata);
+    }
+    /** Merge config provider overrides into visible metadata. Does not construct/launch any client. */
+    replaceMetadata(config) {
+        for (const [id, override] of Object.entries(config.agents.providers)) {
+            const base = this.metadata[id] ?? this.metadata.pi;
+            const capabilities = base?.capabilities ?? this.metadata.pi?.capabilities;
+            if (!capabilities)
+                continue;
+            this.metadata[id] = {
+                ...base,
+                id,
+                label: override.label ?? base?.label ?? id,
+                description: override.description ?? base?.description,
+                capabilities,
+                modes: base?.modes ?? [],
+            };
+        }
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/agent/provider-registry.js.map

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

package/dist/agent/provider-snapshot.d.ts

@@ -0,0 +1,52 @@
+import type { AgentModeDefinition, AgentModelDefinition } from "./provider-contract.js";
+/**
+ * Per-cwd provider snapshot cache (features/agent-providers.md § Provider snapshot refresh contract).
+ *
+ * Hard correctness/perf contract: a snapshot probes only while **cold**; once warm
+ * (`ready`/`error`/`unavailable`) it stays cached until an **explicit refresh** — no TTL, focus,
+ * selector-open, or config-reload revalidation. **Settings refresh** clears all cwd-scope caches +
+ * in-flight loads, then refreshes only the home snapshot with `force:true`; workspace snapshots
+ * re-probe lazily.
+ */
+export type SnapshotStatus = "cold" | "loading" | "ready" | "error" | "unavailable";
+export interface ProviderSnapshotData {
+    available: boolean;
+    models: AgentModelDefinition[];
+    modes: AgentModeDefinition[];
+}
+export interface ProviderSnapshot {
+    cwd: string;
+    status: SnapshotStatus;
+    data?: ProviderSnapshotData;
+    error?: string;
+}
+export interface SnapshotManagerDeps {
+    /** Resolved home directory; blank cwd resolves here. */
+    homeDir: string;
+    /** Probe a cwd (this is where Pi would be spawned). Throws → `error`; `available:false` → `unavailable`. */
+    probe: (cwd: string) => Promise<ProviderSnapshotData>;
+}
+export declare class ProviderSnapshotManager {
+    private readonly deps;
+    private readonly cache;
+    private readonly inflight;
+    constructor(deps: SnapshotManagerDeps);
+    /** Resolve a cwd; blank/empty → home. */
+    resolveCwd(cwd?: string): string;
+    /**
+     * Get the snapshot for `cwd`. Returns the cached warm snapshot without re-probing; probes only
+     * when cold (or `force:true`). Concurrent cold reads share one probe.
+     */
+    get(cwd?: string, opts?: {
+        force?: boolean;
+    }): Promise<ProviderSnapshot>;
+    /** The current cached snapshot (if any) without triggering a probe. */
+    peek(cwd?: string): ProviderSnapshot | undefined;
+    private probeInto;
+    /**
+     * Settings refresh: clear every cwd-scope cache + in-flight load, then immediately re-probe only
+     * the home snapshot with `force:true`. Workspace snapshots re-probe lazily on next `get`.
+     */
+    refreshSettings(): Promise<ProviderSnapshot>;
+}
+//# sourceMappingURL=provider-snapshot.d.ts.map

package/dist/agent/provider-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-snapshot.d.ts","sourceRoot":"","sources":["../../src/agent/provider-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAExF;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;AAEpF,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACvD;AAED,qBAAa,uBAAuB;IAItB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;gBAE5C,IAAI,EAAE,mBAAmB;IAEtD,yCAAyC;IACzC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAIhC;;;OAGG;IACH,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBxE,uEAAuE;IACvE,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;YAIlC,SAAS;IAuBvB;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAK7C"}

package/dist/agent/provider-snapshot.js

@@ -0,0 +1,73 @@
+const WARM = new Set(["ready", "error", "unavailable"]);
+export class ProviderSnapshotManager {
+    deps;
+    cache = new Map();
+    inflight = new Map();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Resolve a cwd; blank/empty → home. */
+    resolveCwd(cwd) {
+        return cwd && cwd.trim().length > 0 ? cwd : this.deps.homeDir;
+    }
+    /**
+     * Get the snapshot for `cwd`. Returns the cached warm snapshot without re-probing; probes only
+     * when cold (or `force:true`). Concurrent cold reads share one probe.
+     */
+    get(cwd, opts) {
+        const key = this.resolveCwd(cwd);
+        if (opts?.force) {
+            this.cache.delete(key);
+            this.inflight.delete(key);
+        }
+        else {
+            const cached = this.cache.get(key);
+            if (cached && WARM.has(cached.status))
+                return Promise.resolve(cached);
+            const loading = this.inflight.get(key);
+            if (loading)
+                return loading;
+        }
+        const probe = this.probeInto(key);
+        this.inflight.set(key, probe);
+        return probe;
+    }
+    /** The current cached snapshot (if any) without triggering a probe. */
+    peek(cwd) {
+        return this.cache.get(this.resolveCwd(cwd));
+    }
+    async probeInto(key) {
+        try {
+            const data = await this.deps.probe(key);
+            const snapshot = {
+                cwd: key,
+                status: data.available ? "ready" : "unavailable",
+                data,
+            };
+            this.cache.set(key, snapshot);
+            return snapshot;
+        }
+        catch (error) {
+            const snapshot = {
+                cwd: key,
+                status: "error",
+                error: error?.message ?? String(error),
+            };
+            this.cache.set(key, snapshot);
+            return snapshot;
+        }
+        finally {
+            this.inflight.delete(key);
+        }
+    }
+    /**
+     * Settings refresh: clear every cwd-scope cache + in-flight load, then immediately re-probe only
+     * the home snapshot with `force:true`. Workspace snapshots re-probe lazily on next `get`.
+     */
+    refreshSettings() {
+        this.cache.clear();
+        this.inflight.clear();
+        return this.get(this.deps.homeDir, { force: true });
+    }
+}
+//# sourceMappingURL=provider-snapshot.js.map

package/dist/agent/provider-snapshot.js.map

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

package/dist/agent/providers/mock/mock-provider.d.ts

@@ -0,0 +1,44 @@
+import type { AgentCapabilityFlags, AgentSessionConfig } from "@av-pi-studio/protocol";
+import type { AgentClient, AgentModeDefinition, AgentModelDefinition, AgentSession, CreateSessionOptions, LaunchContext, PersistenceHandle } from "../../provider-contract.js";
+/**
+ * In-process `mock` provider (features/agent-providers.md § Provider entry — dev/test only). It
+ * implements the `AgentClient`/`AgentSession` contracts in memory and emits a scripted turn. Never
+ * user-selectable in production paths.
+ */
+export declare const MOCK_CAPABILITIES: AgentCapabilityFlags;
+export interface MockSessionOptions {
+    /** Delay before a started turn completes (ms). Small but non-zero so `interrupt` can win. */
+    turnDelayMs?: number;
+}
+export declare class MockAgentClient implements AgentClient {
+    private readonly options;
+    readonly provider = "mock";
+    readonly capabilities: import("zod").objectOutputType<{
+        supportsStreaming: import("zod").ZodBoolean;
+        supportsSessionPersistence: import("zod").ZodBoolean;
+        supportsDynamicModes: import("zod").ZodBoolean;
+        supportsMcpServers: import("zod").ZodBoolean;
+        supportsReasoningStream: import("zod").ZodBoolean;
+        supportsToolInvocations: import("zod").ZodBoolean;
+        supportsRewindConversation: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        supportsRewindFiles: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        supportsRewindBoth: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod").ZodTypeAny, "passthrough">;
+    constructor(options?: MockSessionOptions);
+    createSession(config: AgentSessionConfig, _launchContext?: LaunchContext, _options?: CreateSessionOptions): Promise<AgentSession>;
+    resumeSession(_handle: PersistenceHandle): Promise<AgentSession>;
+    listModels(): Promise<AgentModelDefinition[]>;
+    listModes(): Promise<AgentModeDefinition[]>;
+    isAvailable(): boolean;
+    importSession(args: {
+        providerHandleId: string;
+        cwd: string;
+    }): Promise<{
+        session: import("../../provider-contract.js").AgentSession;
+        persistence: import("../../provider-contract.js").PersistenceHandle;
+        timeline: import("@av-pi-studio/protocol").AgentStreamEvent[];
+    }>;
+}
+/** Factory matching the provider-registry signature `(logger, runtimeSettings, options)`. */
+export declare function createMockClient(): MockAgentClient;
+//# sourceMappingURL=mock-provider.d.ts.map

package/dist/agent/providers/mock/mock-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-provider.d.ts","sourceRoot":"","sources":["../../../../src/agent/providers/mock/mock-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAEnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EAEb,iBAAiB,EAGlB,MAAM,4BAA4B,CAAC;AAEpC;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB,EAAE,oBAO/B,CAAC;AAOF,MAAM,WAAW,kBAAkB;IACjC,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgID,qBAAa,eAAgB,YAAW,WAAW;IAIrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,QAAQ,UAAU;IAC3B,QAAQ,CAAC,YAAY;;;;;;;;;;gDAAqB;gBAEb,OAAO,GAAE,kBAAuB;IAE7D,aAAa,CACX,MAAM,EAAE,kBAAkB,EAC1B,cAAc,CAAC,EAAE,aAAa,EAC9B,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,YAAY,CAAC;IAIxB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAMhE,UAAU,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAI7C,SAAS,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAI3C,WAAW,IAAI,OAAO;IAIhB,aAAa,CAAC,IAAI,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5E,OAAO,EAAE,OAAO,4BAA4B,EAAE,YAAY,CAAC;QAC3D,WAAW,EAAE,OAAO,4BAA4B,EAAE,iBAAiB,CAAC;QACpE,QAAQ,EAAE,OAAO,wBAAwB,EAAE,gBAAgB,EAAE,CAAC;KAC/D,CAAC;CAQH;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,eAAe,CAElD"}

package/dist/agent/providers/mock/mock-provider.js

@@ -0,0 +1,162 @@
+import { randomUUID } from "node:crypto";
+/**
+ * In-process `mock` provider (features/agent-providers.md § Provider entry — dev/test only). It
+ * implements the `AgentClient`/`AgentSession` contracts in memory and emits a scripted turn. Never
+ * user-selectable in production paths.
+ */
+export const MOCK_CAPABILITIES = {
+    supportsStreaming: true,
+    supportsSessionPersistence: true,
+    supportsDynamicModes: true,
+    supportsMcpServers: false,
+    supportsReasoningStream: true,
+    supportsToolInvocations: true,
+};
+const MOCK_MODES = [
+    { id: "default", label: "Default" },
+    { id: "plan", label: "Plan" },
+];
+class MockAgentSession {
+    config;
+    provider = "mock";
+    id = randomUUID();
+    capabilities = MOCK_CAPABILITIES;
+    subscribers = new Set();
+    history = [];
+    turnDelayMs;
+    activeTurn = null;
+    completionTimer = null;
+    mode = "default";
+    closed = false;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.turnDelayMs = options.turnDelayMs ?? 5;
+    }
+    emit(event) {
+        this.history.push(event);
+        for (const cb of this.subscribers)
+            cb(event);
+    }
+    subscribe(cb) {
+        this.subscribers.add(cb);
+        return () => this.subscribers.delete(cb);
+    }
+    async *streamHistory() {
+        for (const event of this.history)
+            yield event;
+    }
+    startTurn(prompt) {
+        const turnId = randomUUID();
+        this.activeTurn = turnId;
+        this.emit({ kind: "turn_started", turnId });
+        this.completionTimer = setTimeout(() => {
+            if (this.activeTurn !== turnId)
+                return;
+            this.emit({ kind: "assistant_message", messageId: randomUUID(), text: `echo: ${prompt}` });
+            this.emit({ kind: "turn_completed", turnId });
+            this.activeTurn = null;
+            this.completionTimer = null;
+        }, this.turnDelayMs);
+        return Promise.resolve({ turnId });
+    }
+    /** Convenience: start a turn and resolve when it reaches a terminal event. */
+    run(prompt) {
+        return new Promise((resolve) => {
+            const unsub = this.subscribe((event) => {
+                if (event.kind === "turn_completed" ||
+                    event.kind === "turn_failed" ||
+                    event.kind === "turn_canceled") {
+                    unsub();
+                    resolve();
+                }
+            });
+            void this.startTurn(prompt);
+        });
+    }
+    interrupt() {
+        if (this.activeTurn) {
+            if (this.completionTimer)
+                clearTimeout(this.completionTimer);
+            const turnId = this.activeTurn;
+            this.activeTurn = null;
+            this.completionTimer = null;
+            this.emit({ kind: "turn_canceled", turnId });
+        }
+        return Promise.resolve();
+    }
+    getRuntimeInfo() {
+        return {
+            provider: this.provider,
+            sessionId: this.id,
+            model: this.config.model ?? "mock-model",
+            modeId: this.mode,
+        };
+    }
+    getAvailableModes() {
+        return MOCK_MODES;
+    }
+    getCurrentMode() {
+        return this.mode;
+    }
+    setMode(id) {
+        this.mode = id;
+        return Promise.resolve();
+    }
+    getPendingPermissions() {
+        return [];
+    }
+    respondToPermission() {
+        return Promise.resolve();
+    }
+    describePersistence() {
+        return { provider: this.provider, sessionId: this.id, nativeHandle: `mock:${this.id}` };
+    }
+    close() {
+        this.closed = true;
+        if (this.completionTimer)
+            clearTimeout(this.completionTimer);
+        this.completionTimer = null;
+        this.activeTurn = null;
+        this.subscribers.clear();
+        return Promise.resolve();
+    }
+    isClosed() {
+        return this.closed;
+    }
+}
+export class MockAgentClient {
+    options;
+    provider = "mock";
+    capabilities = MOCK_CAPABILITIES;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    createSession(config, _launchContext, _options) {
+        return Promise.resolve(new MockAgentSession(config, this.options));
+    }
+    resumeSession(_handle) {
+        return Promise.resolve(new MockAgentSession({ provider: "mock", cwd: ".", model: "mock-model" }, this.options));
+    }
+    listModels() {
+        return Promise.resolve([{ id: "mock-model", label: "Mock Model" }]);
+    }
+    listModes() {
+        return Promise.resolve(MOCK_MODES);
+    }
+    isAvailable() {
+        return true;
+    }
+    async importSession(args) {
+        const session = new MockAgentSession({ provider: "mock", cwd: args.cwd }, this.options);
+        return {
+            session,
+            persistence: { provider: "mock", sessionId: session.id, nativeHandle: `mock:${session.id}` },
+            timeline: [],
+        };
+    }
+}
+/** Factory matching the provider-registry signature `(logger, runtimeSettings, options)`. */
+export function createMockClient() {
+    return new MockAgentClient();
+}
+//# sourceMappingURL=mock-provider.js.map

package/dist/agent/providers/mock/mock-provider.js.map

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