@getpaseo/server 0.1.97-beta.3 → 0.1.98

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

@@ -1,7 +1,7 @@
 import { AGENT_LIFECYCLE_STATUSES, type AgentLifecycleStatus } from "@getpaseo/protocol/agent-lifecycle";
 import type { Logger } from "pino";
 import type { TerminalManager } from "../../terminal/terminal-manager.js";
-import { type AgentCapabilityFlags, type AgentClient, type AgentFeature, type AgentSlashCommand, type AgentMode, type AgentPermissionRequest, type AgentPermissionResponse, type AgentPermissionResult, type AgentPersistenceHandle, type AgentPromptInput, type AgentProvider, type AgentRunOptions, type AgentRunResult, type AgentSession, type AgentSessionConfig, type AgentStreamEvent, type AgentTimelineItem, type AgentUsage, type AgentRuntimeInfo, type ImportableProviderSession, type ListImportableSessionsOptions } from "./agent-sdk-types.js";
+import { type AgentCapabilityFlags, type AgentClient, type AgentFeature, type AgentSlashCommand, type AgentMode, type AgentPermissionRequest, type AgentPermissionResponse, type AgentPermissionResult, type AgentPersistenceHandle, type AgentProviderNotice, type AgentPromptInput, type AgentProvider, type AgentRunOptions, type AgentRunResult, type AgentSession, type AgentSessionConfig, type AgentStreamEvent, type AgentTimelineItem, type AgentUsage, type AgentRuntimeInfo, type ImportableProviderSession, type ListImportableSessionsOptions } from "./agent-sdk-types.js";
 import type { StoredAgentRecord, AgentStorage } from "./agent-storage.js";
 import type { AgentTimelineFetchOptions, AgentTimelineFetchResult, AgentTimelineRow, AgentTimelineStore } from "./agent-timeline-store-types.js";
 import { type ForegroundTurnWaiter } from "./foreground-run-state.js";
@@ -266,12 +266,19 @@ export declare class AgentManager {
     private markRecordArchived;
     private fireAgentArchived;
     private dispatchArchivedStoredAgent;
-    setAgentMode(agentId: string, modeId: string): Promise<void>;
+    setAgentMode(agentId: string, modeId: string): Promise<AgentProviderNotice | null>;
     setAgentModel(agentId: string, modelId: string | null): Promise<void>;
-    setAgentThinkingOption(agentId: string, thinkingOptionId: string | null): Promise<void>;
+    setAgentThinkingOption(agentId: string, thinkingOptionId: string | null): Promise<AgentProviderNotice | null>;
     setAgentFeature(agentId: string, featureId: string, value: unknown): Promise<void>;
     setTitle(agentId: string, title: string): Promise<void>;
     setLabels(agentId: string, labels: Record<string, string>): Promise<void>;
+    private writeLabels;
+    private writeStoredMetadata;
+    detachAgent(agentId: string): Promise<{
+        record: StoredAgentRecord;
+        live: boolean;
+        previousParentAgentId: string | null;
+    }>;
     notifyAgentState(agentId: string): void;
     clearAgentAttention(agentId: string): Promise<void>;
     archiveSnapshot(agentId: string, archivedAt: string): Promise<StoredAgentRecord>;
@@ -373,6 +380,7 @@ export declare class AgentManager {
     private getConfiguredProviderIds;
     private requireClient;
     archiveNativeSessionBestEffort(provider: AgentProvider, persistence: AgentPersistenceHandle | null | undefined): Promise<void>;
+    private unarchiveNativeSession;
     private requireAgent;
     private requireSessionAgent;
 }

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

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { resolve } from "node:path";
 import { stat } from "node:fs/promises";
 import { AGENT_LIFECYCLE_STATUSES, } from "@getpaseo/protocol/agent-lifecycle";
-import { isDelegatedAgent, PARENT_AGENT_ID_LABEL } from "@getpaseo/protocol/agent-labels";
+import { getParentAgentIdFromLabels, isDelegatedAgent, PARENT_AGENT_ID_LABEL, } from "@getpaseo/protocol/agent-labels";
 import { z } from "zod";
 import { getAgentStreamEventTurnId, } from "./agent-sdk-types.js";
 import { buildArchivedAgentRecord } from "./agent-archive.js";
@@ -82,7 +82,7 @@ function attachPersistenceCwd(handle, cwd) {
     };
 }
 const BUSY_STATUSES = new Set(["initializing", "running"]);
-const AgentIdSchema = z.string().uuid();
+const AgentIdSchema = z.guid();
 function isAgentBusy(status) {
     return BUSY_STATUSES.has(status);
 }
@@ -109,6 +109,18 @@ function validateAgentId(agentId, source) {
     }
     return result.data;
 }
+function applyLabelPatch(labels, patch) {
+    const nextLabels = { ...labels };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete nextLabels[key];
+        }
+        else {
+            nextLabels[key] = value;
+        }
+    }
+    return nextLabels;
+}
 function buildExplicitTimelineSeedForRegister(now, options) {
     const hasTimeline = Boolean(options?.timeline?.length);
     const hasTimelineRows = Boolean(options?.timelineRows?.length);
@@ -676,9 +688,8 @@ export class AgentManager {
     }
     // Children created via the MCP `create_agent` tool carry the parent-agent-id
     // label pointing back at the caller. Archiving the parent cascades to those
-    // children so subagent fleets don't outlive their orchestrator. Handoff agents
-    // launched the same way are caught by this cascade — see docs/agent-lifecycle.md
-    // for the accepted limitation.
+    // children so subagent fleets don't outlive their orchestrator. Detached
+    // handoff agents omit this label, so they stand outside the cascade.
     async cascadeArchiveChildren(parentAgentId) {
         const registry = this.registry;
         if (!registry) {
@@ -768,7 +779,7 @@ export class AgentManager {
     }
     async setAgentMode(agentId, modeId) {
         const agent = this.requireSessionAgent(agentId);
-        await agent.session.setMode(modeId);
+        const notice = (await agent.session.setMode(modeId)) ?? null;
         const currentMode = (await agent.session.getCurrentMode()) ?? modeId;
         agent.config.modeId = currentMode ?? undefined;
         agent.currentModeId = currentMode;
@@ -778,6 +789,7 @@ export class AgentManager {
         }
         this.touchUpdatedAt(agent);
         this.emitState(agent);
+        return notice;
     }
     async setAgentModel(agentId, modelId) {
         const agent = this.requireSessionAgent(agentId);
@@ -797,8 +809,9 @@ export class AgentManager {
         const normalizedThinkingOptionId = typeof thinkingOptionId === "string" && thinkingOptionId.trim().length > 0
             ? thinkingOptionId
             : null;
+        let notice = null;
         if (agent.session.setThinkingOption) {
-            await agent.session.setThinkingOption(normalizedThinkingOptionId);
+            notice = (await agent.session.setThinkingOption(normalizedThinkingOptionId)) ?? null;
         }
         agent.config.thinkingOptionId = normalizedThinkingOptionId ?? undefined;
         if (agent.runtimeInfo) {
@@ -809,6 +822,7 @@ export class AgentManager {
         }
         this.touchUpdatedAt(agent);
         this.emitState(agent);
+        return notice;
     }
     async setAgentFeature(agentId, featureId, value) {
         const agent = this.requireAgent(agentId);
@@ -837,10 +851,68 @@ export class AgentManager {
     }
     async setLabels(agentId, labels) {
         const agent = this.requireAgent(agentId);
-        agent.labels = { ...agent.labels, ...labels };
-        this.touchUpdatedAt(agent);
-        await this.persistSnapshot(agent);
-        this.emitState(agent, { persist: false });
+        await this.writeLabels(agent.id, labels);
+    }
+    async writeLabels(agentId, patch) {
+        const liveAgent = this.agents.get(agentId);
+        if (liveAgent) {
+            liveAgent.labels = applyLabelPatch(liveAgent.labels, patch);
+            this.touchUpdatedAt(liveAgent);
+            await this.persistSnapshot(liveAgent);
+            this.emitState(liveAgent, { persist: false });
+            const record = this.registry ? await this.registry.get(agentId) : null;
+            return { record, live: true };
+        }
+        const nextRecord = await this.writeStoredMetadata(agentId, { labels: patch });
+        return { record: nextRecord, live: false };
+    }
+    async writeStoredMetadata(agentId, patch) {
+        const registry = this.requireRegistry();
+        const record = await registry.get(agentId);
+        if (!record) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        const nextRecord = {
+            ...record,
+            ...(patch.title ? { title: patch.title } : {}),
+            ...(patch.labels ? { labels: applyLabelPatch(record.labels, patch.labels) } : {}),
+            updatedAt: this.nextStoredUpdatedAt(record),
+        };
+        await registry.upsert(nextRecord);
+        return nextRecord;
+    }
+    async detachAgent(agentId) {
+        const registry = this.requireRegistry();
+        const liveAgent = this.agents.get(agentId);
+        if (liveAgent) {
+            const previousParentAgentId = getParentAgentIdFromLabels(liveAgent.labels);
+            if (!previousParentAgentId) {
+                await this.persistSnapshot(liveAgent);
+                const record = await registry.get(agentId);
+                if (!record) {
+                    throw new Error(`Agent not found in storage after detach: ${agentId}`);
+                }
+                return { record, live: true, previousParentAgentId: null };
+            }
+            const { record } = await this.writeLabels(agentId, { [PARENT_AGENT_ID_LABEL]: null });
+            if (!record) {
+                throw new Error(`Agent not found in storage after detach: ${agentId}`);
+            }
+            return { record, live: true, previousParentAgentId };
+        }
+        const record = await registry.get(agentId);
+        if (!record) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        const previousParentAgentId = getParentAgentIdFromLabels(record.labels);
+        if (!previousParentAgentId) {
+            return { record, live: false, previousParentAgentId: null };
+        }
+        const result = await this.writeLabels(agentId, { [PARENT_AGENT_ID_LABEL]: null });
+        if (!result.record) {
+            throw new Error(`Agent not found in storage after detach: ${agentId}`);
+        }
+        return { record: result.record, live: false, previousParentAgentId };
     }
     notifyAgentState(agentId) {
         const agent = this.agents.get(agentId);
@@ -888,9 +960,11 @@ export class AgentManager {
         if (!record || !record.archivedAt) {
             return false;
         }
+        await this.unarchiveNativeSession(record.provider, record.persistence);
         await registry.upsert({
             ...record,
             archivedAt: null,
+            updatedAt: new Date().toISOString(),
         });
         if (this.getAgent(agentId)) {
             this.notifyAgentState(agentId);
@@ -914,21 +988,11 @@ export class AgentManager {
                 await this.setTitle(agentId, updates.title);
             }
             if (updates.labels) {
-                await this.setLabels(agentId, updates.labels);
+                await this.writeLabels(agentId, updates.labels);
             }
             return;
         }
-        const registry = this.requireRegistry();
-        const existing = await registry.get(agentId);
-        if (!existing) {
-            throw new Error(`Agent not found: ${agentId}`);
-        }
-        await registry.upsert({
-            ...existing,
-            ...(updates.title ? { title: updates.title } : {}),
-            ...(updates.labels ? { labels: { ...existing.labels, ...updates.labels } } : {}),
-            updatedAt: this.nextStoredUpdatedAt(existing),
-        });
+        await this.writeStoredMetadata(agentId, updates);
     }
     async runAgent(agentId, prompt, options) {
         const events = this.streamAgent(agentId, prompt, options);
@@ -2619,6 +2683,14 @@ export class AgentManager {
             this.logger.warn({ error, provider, sessionId: persistence.sessionId }, "Failed to archive native session (best-effort)");
         }
     }
+    async unarchiveNativeSession(provider, persistence) {
+        if (!persistence)
+            return;
+        const client = this.clients.get(provider);
+        if (!client?.unarchiveNativeSession)
+            return;
+        await client.unarchiveNativeSession(persistence);
+    }
     requireAgent(id) {
         const normalizedId = validateAgentId(id, "requireAgent");
         const agent = this.agents.get(normalizedId);

package/dist/server/server/agent/agent-prompt.d.ts

@@ -15,7 +15,7 @@ export declare function startAgentRun(agentManager: AgentRunController, agentId:
  * Shared across Session (app/WS), MCP, and CLI so every surface that acts on
  * an archived agent unarchives it the same way.
  */
-export declare function unarchiveAgentState(agentStorage: AgentStorage, agentManager: AgentManager, agentId: string): Promise<boolean>;
+export declare function unarchiveAgentState(_agentStorage: AgentStorage, agentManager: AgentManager, agentId: string): Promise<boolean>;
 /**
  * Wrap a body in <paseo-system>…</paseo-system> so the receiving agent
  * recognizes the prompt as system-injected context — not a user turn.

package/dist/server/server/agent/agent-prompt.js

@@ -55,17 +55,10 @@ export function startAgentRun(agentManager, agentId, prompt, logger, options) {
  * Shared across Session (app/WS), MCP, and CLI so every surface that acts on
  * an archived agent unarchives it the same way.
  */
-export async function unarchiveAgentState(agentStorage, agentManager, agentId) {
-    const record = await agentStorage.get(agentId);
-    if (!record || !record.archivedAt) {
+export async function unarchiveAgentState(_agentStorage, agentManager, agentId) {
+    const unarchived = await agentManager.unarchiveSnapshot(agentId);
+    if (!unarchived)
         return false;
-    }
-    const updatedAt = new Date().toISOString();
-    await agentStorage.upsert({
-        ...record,
-        archivedAt: null,
-        updatedAt,
-    });
     agentManager.notifyAgentState(agentId);
     return true;
 }

package/dist/server/server/agent/agent-response-loop.js

@@ -1,4 +1,4 @@
-import { zodToJsonSchema } from "zod-to-json-schema";
+import { z } from "zod";
 import Ajv from "ajv";
 export class StructuredAgentResponseError extends Error {
     constructor(message, options) {
@@ -32,8 +32,14 @@ function isZodSchema(value) {
     return typeof value?.safeParse === "function";
 }
 function buildZodValidator(schema, schemaName) {
-    const zodToJsonSchemaAny = zodToJsonSchema;
-    const jsonSchema = zodToJsonSchemaAny(schema, schemaName);
+    const jsonSchema = z.toJSONSchema(schema, {
+        target: "draft-07",
+        unrepresentable: "any",
+        io: "input",
+    });
+    if (typeof jsonSchema.title !== "string") {
+        jsonSchema.title = schemaName;
+    }
     return {
         jsonSchema,
         validate: (value) => {

package/dist/server/server/agent/agent-sdk-types.d.ts

@@ -1,5 +1,7 @@
 import type { Options as ClaudeAgentOptions } from "@anthropic-ai/claude-agent-sdk";
+import type { AgentProviderNotice } from "@getpaseo/protocol/agent-types";
 import type { AgentAttachment } from "@getpaseo/protocol/messages";
+export type { AgentProviderNotice };
 export type AgentProvider = string;
 export interface AgentMetadata {
     [key: string]: unknown;
@@ -543,7 +545,7 @@ export interface AgentSession {
     getRuntimeInfo(): Promise<AgentRuntimeInfo>;
     getAvailableModes(): Promise<AgentMode[]>;
     getCurrentMode(): Promise<string | null>;
-    setMode(modeId: string): Promise<void>;
+    setMode(modeId: string): Promise<void | AgentProviderNotice>;
     getPendingPermissions(): AgentPermissionRequest[];
     respondToPermission(requestId: string, response: AgentPermissionResponse): Promise<AgentPermissionResult | void>;
     describePersistence(): AgentPersistenceHandle | null;
@@ -551,7 +553,7 @@ export interface AgentSession {
     close(): Promise<void>;
     listCommands?(): Promise<AgentSlashCommand[]>;
     setModel?(modelId: string | null): Promise<void>;
-    setThinkingOption?(thinkingOptionId: string | null): Promise<void>;
+    setThinkingOption?(thinkingOptionId: string | null): Promise<void | AgentProviderNotice>;
     setFeature?(featureId: string, value: unknown): Promise<void>;
     revertConversation?(input: {
         messageId: string;
@@ -610,6 +612,11 @@ export interface AgentClient {
      * Called when Paseo archives an agent so the provider's own UI reflects the same state.
      */
     archiveNativeSession?(handle: AgentPersistenceHandle): Promise<void>;
+    /**
+     * Unarchive a persisted session in the native provider.
+     * Called before Paseo clears its archived flag so provider resume can succeed.
+     */
+    unarchiveNativeSession?(handle: AgentPersistenceHandle): Promise<void>;
     /**
      * Release any provider-owned resources held by this client (background
      * processes, sockets, cached subprocesses, etc.). Called when the daemon
@@ -617,5 +624,4 @@ export interface AgentClient {
      */
     shutdown?(): Promise<void>;
 }
-export {};
 //# sourceMappingURL=agent-sdk-types.d.ts.map

package/dist/server/server/agent/agent-storage.d.ts

@@ -13,7 +13,13 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
     lastUserMessageAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     labels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
-    lastStatus: z.ZodDefault<z.ZodEnum<["initializing", "idle", "running", "error", "closed"]>>;
+    lastStatus: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        initializing: "initializing";
+        idle: "idle";
+        running: "running";
+        closed: "closed";
+    }>>;
     lastModeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     config: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         modeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -23,23 +29,7 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
         extra: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
         systemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         mcpServers: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
-    }, "strip", z.ZodTypeAny, {
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        featureValues?: Record<string, unknown> | null | undefined;
-        extra?: Record<string, any> | null | undefined;
-        systemPrompt?: string | null | undefined;
-        mcpServers?: Record<string, any> | null | undefined;
-    }, {
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        featureValues?: Record<string, unknown> | null | undefined;
-        extra?: Record<string, any> | null | undefined;
-        systemPrompt?: string | null | undefined;
-        mcpServers?: Record<string, any> | null | undefined;
-    }>>>;
+    }, z.core.$strip>>>;
     runtimeInfo: z.ZodOptional<z.ZodObject<{
         provider: z.ZodString;
         sessionId: z.ZodNullable<z.ZodString>;
@@ -47,22 +37,8 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
         thinkingOptionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         modeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         extra: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, "strip", z.ZodTypeAny, {
-        provider: string;
-        sessionId: string | null;
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        extra?: Record<string, unknown> | undefined;
-    }, {
-        provider: string;
-        sessionId: string | null;
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        extra?: Record<string, unknown> | undefined;
-    }>>;
-    features: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    }, z.core.$strip>>;
+    features: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"toggle">;
         id: z.ZodString;
         label: z.ZodString;
@@ -70,23 +46,7 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
         tooltip: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
         value: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        value: boolean;
-        type: "toggle";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    }, {
-        value: boolean;
-        type: "toggle";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    }>, z.ZodObject<{
+    }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"select">;
         id: z.ZodString;
         label: z.ZodString;
@@ -100,205 +60,25 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             isDefault: z.ZodOptional<z.ZodBoolean>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            label: string;
-            description?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            isDefault?: boolean | undefined;
-        }, {
-            id: string;
-            label: string;
-            description?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            isDefault?: boolean | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        value: string | null;
-        options: {
-            id: string;
-            label: string;
-            description?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            isDefault?: boolean | undefined;
-        }[];
-        type: "select";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    }, {
-        value: string | null;
-        options: {
-            id: string;
-            label: string;
-            description?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            isDefault?: boolean | undefined;
-        }[];
-        type: "select";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    }>]>, "many">>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "type">>>;
     persistence: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         provider: z.ZodString;
         sessionId: z.ZodString;
         nativeHandle: z.ZodOptional<z.ZodAny>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    }, "strip", z.ZodTypeAny, {
-        provider: string;
-        sessionId: string;
-        metadata?: Record<string, any> | undefined;
-        nativeHandle?: any;
-    }, {
-        provider: string;
-        sessionId: string;
-        metadata?: Record<string, any> | undefined;
-        nativeHandle?: any;
-    }>>>;
+    }, z.core.$strip>>>;
     lastError: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     requiresAttention: z.ZodOptional<z.ZodBoolean>;
-    attentionReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<["finished", "error", "permission"]>>>;
+    attentionReason: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        finished: "finished";
+        error: "error";
+        permission: "permission";
+    }>>>;
     attentionTimestamp: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     internal: z.ZodOptional<z.ZodBoolean>;
     archivedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    cwd: string;
-    id: string;
-    provider: string;
-    createdAt: string;
-    updatedAt: string;
-    labels: Record<string, string>;
-    lastStatus: "error" | "idle" | "running" | "initializing" | "closed";
-    workspaceId?: string | undefined;
-    internal?: boolean | undefined;
-    attentionReason?: "finished" | "error" | "permission" | null | undefined;
-    title?: string | null | undefined;
-    persistence?: {
-        provider: string;
-        sessionId: string;
-        metadata?: Record<string, any> | undefined;
-        nativeHandle?: any;
-    } | null | undefined;
-    lastActivityAt?: string | undefined;
-    lastUserMessageAt?: string | null | undefined;
-    lastModeId?: string | null | undefined;
-    config?: {
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        featureValues?: Record<string, unknown> | null | undefined;
-        extra?: Record<string, any> | null | undefined;
-        systemPrompt?: string | null | undefined;
-        mcpServers?: Record<string, any> | null | undefined;
-    } | null | undefined;
-    runtimeInfo?: {
-        provider: string;
-        sessionId: string | null;
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        extra?: Record<string, unknown> | undefined;
-    } | undefined;
-    features?: ({
-        value: boolean;
-        type: "toggle";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    } | {
-        value: string | null;
-        options: {
-            id: string;
-            label: string;
-            description?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            isDefault?: boolean | undefined;
-        }[];
-        type: "select";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    })[] | undefined;
-    lastError?: string | null | undefined;
-    requiresAttention?: boolean | undefined;
-    attentionTimestamp?: string | null | undefined;
-    archivedAt?: string | null | undefined;
-}, {
-    cwd: string;
-    id: string;
-    provider: string;
-    createdAt: string;
-    updatedAt: string;
-    workspaceId?: string | undefined;
-    internal?: boolean | undefined;
-    attentionReason?: "finished" | "error" | "permission" | null | undefined;
-    title?: string | null | undefined;
-    persistence?: {
-        provider: string;
-        sessionId: string;
-        metadata?: Record<string, any> | undefined;
-        nativeHandle?: any;
-    } | null | undefined;
-    lastActivityAt?: string | undefined;
-    lastUserMessageAt?: string | null | undefined;
-    labels?: Record<string, string> | undefined;
-    lastStatus?: "error" | "idle" | "running" | "initializing" | "closed" | undefined;
-    lastModeId?: string | null | undefined;
-    config?: {
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        featureValues?: Record<string, unknown> | null | undefined;
-        extra?: Record<string, any> | null | undefined;
-        systemPrompt?: string | null | undefined;
-        mcpServers?: Record<string, any> | null | undefined;
-    } | null | undefined;
-    runtimeInfo?: {
-        provider: string;
-        sessionId: string | null;
-        modeId?: string | null | undefined;
-        model?: string | null | undefined;
-        thinkingOptionId?: string | null | undefined;
-        extra?: Record<string, unknown> | undefined;
-    } | undefined;
-    features?: ({
-        value: boolean;
-        type: "toggle";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    } | {
-        value: string | null;
-        options: {
-            id: string;
-            label: string;
-            description?: string | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            isDefault?: boolean | undefined;
-        }[];
-        type: "select";
-        id: string;
-        label: string;
-        description?: string | undefined;
-        icon?: string | undefined;
-        tooltip?: string | undefined;
-    })[] | undefined;
-    lastError?: string | null | undefined;
-    requiresAttention?: boolean | undefined;
-    attentionTimestamp?: string | null | undefined;
-    archivedAt?: string | null | undefined;
-}>;
+}, z.core.$strip>;
 export type SerializableAgentConfig = Pick<AgentSessionConfig, "modeId" | "model" | "thinkingOptionId" | "featureValues" | "extra" | "systemPrompt" | "mcpServers">;
 export type StoredAgentRecord = z.infer<typeof STORED_AGENT_SCHEMA>;
 export declare function parseStoredAgentRecord(value: unknown): StoredAgentRecord;