@getpaseo/server 0.1.82 → 0.1.84

package/dist/server/server/agent/activity-curator.js

@@ -1,5 +1,5 @@
-import { isLikelyExternalToolName } from "./tool-name-normalization.js";
-import { buildToolCallDisplayModel } from "../../shared/tool-call-display.js";
+import { isLikelyExternalToolName } from "@getpaseo/protocol/tool-name-normalization";
+import { buildToolCallDisplayModel } from "@getpaseo/protocol/tool-call-display";
 import { projectTimelineRows } from "./timeline-projection.js";
 const DEFAULT_MAX_ITEMS = 0;
 const MAX_TOOL_INPUT_CHARS = 400;

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

@@ -1,4 +1,4 @@
-import { AGENT_LIFECYCLE_STATUSES, type AgentLifecycleStatus } from "../../shared/agent-lifecycle.js";
+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 ListPersistedAgentsOptions, type PersistedAgentDescriptor } from "./agent-sdk-types.js";
@@ -192,6 +192,7 @@ export declare class AgentManager {
     setAppendSystemPrompt(prompt: string | null | undefined): void;
     getMetricsSnapshot(): AgentMetricsSnapshot;
     private touchUpdatedAt;
+    private nextStoredUpdatedAt;
     hasInFlightRun(agentId: string): boolean;
     subscribe(callback: AgentSubscriber, options?: SubscribeOptions): () => void;
     listAgents(): ManagedAgent[];

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

@@ -1,15 +1,15 @@
 import { randomUUID } from "node:crypto";
 import { resolve } from "node:path";
 import { stat } from "node:fs/promises";
-import { AGENT_LIFECYCLE_STATUSES, } from "../../shared/agent-lifecycle.js";
-import { PARENT_AGENT_ID_LABEL } from "../../shared/agent-labels.js";
+import { AGENT_LIFECYCLE_STATUSES, } from "@getpaseo/protocol/agent-lifecycle";
+import { 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";
 import { InMemoryAgentTimelineStore, } from "./agent-timeline-store.js";
 import { AGENT_STREAM_COALESCE_DEFAULT_WINDOW_MS, AgentStreamCoalescer, } from "./agent-stream-coalescer.js";
 import { ForegroundRunState } from "./foreground-run-state.js";
-import { getAgentProviderDefinition } from "./provider-manifest.js";
+import { getAgentProviderDefinition } from "@getpaseo/protocol/provider-manifest";
 import { IMPORTABLE_PROVIDERS } from "./provider-registry.js";
 import { invokeRewindCapability } from "./rewind/rewind.js";
 import { isSystemInjectedEnvelope } from "./agent-prompt.js";
@@ -224,6 +224,12 @@ export class AgentManager {
         agent.updatedAt = next;
         return next;
     }
+    nextStoredUpdatedAt(record) {
+        const previousMs = Date.parse(record.updatedAt);
+        const nowMs = Date.now();
+        const nextMs = nowMs > previousMs ? nowMs : previousMs + 1;
+        return new Date(nextMs).toISOString();
+    }
     hasInFlightRun(agentId) {
         const agent = this.agents.get(agentId);
         if (!agent) {
@@ -708,11 +714,12 @@ export class AgentManager {
     async setAgentMode(agentId, modeId) {
         const agent = this.requireSessionAgent(agentId);
         await agent.session.setMode(modeId);
-        agent.config.modeId = modeId;
-        agent.currentModeId = modeId;
+        const currentMode = (await agent.session.getCurrentMode()) ?? modeId;
+        agent.config.modeId = currentMode ?? undefined;
+        agent.currentModeId = currentMode;
         // Update runtimeInfo to reflect the new mode
         if (agent.runtimeInfo) {
-            agent.runtimeInfo = { ...agent.runtimeInfo, modeId };
+            agent.runtimeInfo = { ...agent.runtimeInfo, modeId: currentMode };
         }
         this.touchUpdatedAt(agent);
         this.emitState(agent);
@@ -869,6 +876,7 @@ export class AgentManager {
             ...existing,
             ...(updates.title ? { title: updates.title } : {}),
             ...(updates.labels ? { labels: { ...existing.labels, ...updates.labels } } : {}),
+            updatedAt: this.nextStoredUpdatedAt(existing),
         });
     }
     async runAgent(agentId, prompt, options) {

package/dist/server/server/agent/agent-metadata-generator.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { DEFAULT_STRUCTURED_GENERATION_PROVIDERS, StructuredAgentFallbackError, StructuredAgentResponseError, generateStructuredAgentResponseWithFallback, } from "./agent-response-loop.js";
-import { MAX_AUTO_AGENT_TITLE_CHARS } from "./agent-title-limits.js";
+import { MAX_AUTO_AGENT_TITLE_CHARS } from "@getpaseo/protocol/agent-title-limits";
 import { buildMetadataPrompt } from "../../utils/build-metadata-prompt.js";
 function hasExplicitTitle(title) {
     return Boolean(title && title.trim().length > 0);

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

@@ -1,12 +1,13 @@
 import type { Logger } from "pino";
 import type { AgentPromptInput, AgentRunOptions } from "./agent-sdk-types.js";
-import type { AgentManager } from "./agent-manager.js";
+import type { AgentManager, ManagedAgent } from "./agent-manager.js";
 import type { AgentStorage } from "./agent-storage.js";
+export type AgentRunController = Pick<AgentManager, "getAgent" | "tryRunOutOfBand" | "hasInFlightRun" | "replaceAgentRun" | "streamAgent">;
 export interface StartAgentRunOptions {
     replaceRunning?: boolean;
     runOptions?: AgentRunOptions;
 }
-export declare function startAgentRun(agentManager: AgentManager, agentId: string, prompt: AgentPromptInput, logger: Logger, options?: StartAgentRunOptions): {
+export declare function startAgentRun(agentManager: AgentRunController, agentId: string, prompt: AgentPromptInput, logger: Logger, options?: StartAgentRunOptions): {
     outOfBand: boolean;
 };
 /**
@@ -40,6 +41,15 @@ export interface SendPromptToAgentParams {
     unarchive?: boolean;
     logger: Logger;
 }
+export interface StartCreatedAgentInitialPromptParams {
+    agentManager: AgentManager;
+    agentId: string;
+    snapshot?: ManagedAgent;
+    prompt: AgentPromptInput | null;
+    runOptions?: AgentRunOptions;
+    logger: Logger;
+}
+export declare function waitForAgentRunStartWithTimeout(agentManager: AgentManager, agentId: string): Promise<void>;
 /**
  * Full send-prompt orchestration: (optional unarchive) → load → (optional
  * mode change) → start run.
@@ -54,6 +64,7 @@ export interface SendPromptToAgentParams {
 export declare function sendPromptToAgent(params: SendPromptToAgentParams): Promise<{
     outOfBand: boolean;
 }>;
+export declare function startCreatedAgentInitialPrompt(params: StartCreatedAgentInitialPromptParams): Promise<ManagedAgent>;
 export interface SetupFinishNotificationParams {
     agentManager: AgentManager;
     agentStorage: AgentStorage;

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

@@ -81,6 +81,17 @@ const SYSTEM_ENVELOPE_PATTERN = /^<paseo-system>\n[\s\S]*\n<\/paseo-system>$/;
 export function isSystemInjectedEnvelope(text) {
     return SYSTEM_ENVELOPE_PATTERN.test(text);
 }
+const AGENT_RUN_START_TIMEOUT_MS = 15000;
+export async function waitForAgentRunStartWithTimeout(agentManager, agentId) {
+    const startAbort = new AbortController();
+    const startTimeout = setTimeout(() => startAbort.abort("timeout"), AGENT_RUN_START_TIMEOUT_MS);
+    try {
+        await agentManager.waitForAgentRunStart(agentId, { signal: startAbort.signal });
+    }
+    finally {
+        clearTimeout(startTimeout);
+    }
+}
 /**
  * Full send-prompt orchestration: (optional unarchive) → load → (optional
  * mode change) → start run.
@@ -114,6 +125,26 @@ export async function sendPromptToAgent(params) {
         runOptions: params.runOptions,
     });
 }
+export async function startCreatedAgentInitialPrompt(params) {
+    const currentSnapshot = params.agentManager.getAgent(params.agentId) ?? params.snapshot ?? null;
+    if (!currentSnapshot) {
+        throw new Error(`Agent ${params.agentId} not found`);
+    }
+    if (params.prompt === null) {
+        return currentSnapshot;
+    }
+    const dispatchResult = startAgentRun(params.agentManager, params.agentId, params.prompt, params.logger, {
+        runOptions: params.runOptions,
+    });
+    if (!dispatchResult.outOfBand) {
+        await waitForAgentRunStartWithTimeout(params.agentManager, params.agentId);
+    }
+    const refreshedSnapshot = params.agentManager.getAgent(params.agentId) ?? params.snapshot ?? null;
+    if (!refreshedSnapshot) {
+        throw new Error(`Agent ${params.agentId} not found`);
+    }
+    return refreshedSnapshot;
+}
 export function setupFinishNotification(params) {
     const { agentManager, agentStorage, childAgentId, callerAgentId, logger } = params;
     let hasSeenRunning = false;

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

@@ -1,6 +1,6 @@
 import { zodToJsonSchema } from "zod-to-json-schema";
 import Ajv from "ajv";
-import { getAgentProviderDefinition } from "./provider-manifest.js";
+import { getAgentProviderDefinition } from "@getpaseo/protocol/provider-manifest";
 export class StructuredAgentResponseError extends Error {
     constructor(message, options) {
         super(message);

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

@@ -1,5 +1,5 @@
 import type { Options as ClaudeAgentOptions } from "@anthropic-ai/claude-agent-sdk";
-import type { AgentAttachment } from "../../shared/messages.js";
+import type { AgentAttachment } from "@getpaseo/protocol/messages";
 export type AgentProvider = string;
 export interface AgentMetadata {
     [key: string]: unknown;
@@ -41,6 +41,7 @@ export interface AgentMode {
     description?: string;
     icon?: string;
     colorTier?: string;
+    isUnattended?: boolean;
 }
 export type ProviderStatus = "ready" | "loading" | "error" | "unavailable";
 export interface AgentModelDefinition {
@@ -73,6 +74,28 @@ export interface ProviderSnapshotEntry {
     description?: string;
     defaultModeId?: string | null;
 }
+export interface AgentCreateConfigParent {
+    provider: AgentProvider;
+    modeId: string | null;
+    isUnattended: boolean;
+}
+export interface ResolveAgentCreateConfigInput {
+    provider: AgentProvider;
+    requestedMode: string | undefined;
+    featureValues: Record<string, unknown> | undefined;
+    parent: AgentCreateConfigParent | null;
+    availableModes: AgentMode[] | undefined;
+}
+export interface ResolveAgentCreateConfigResult {
+    modeId: string | undefined;
+    featureValues: Record<string, unknown> | undefined;
+}
+export interface AgentCreateConfigUnattendedInput {
+    modeId: string | null;
+    config: AgentSessionConfig;
+    features?: AgentFeature[];
+    availableModes: AgentMode[];
+}
 export interface AgentFeatureToggle {
     type: "toggle";
     id: string;
@@ -532,6 +555,8 @@ export interface AgentClient {
     resumeSession(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>, launchContext?: AgentLaunchContext): Promise<AgentSession>;
     listModels(options: ListModelsOptions): Promise<AgentModelDefinition[]>;
     listModes?(options: ListModesOptions): Promise<AgentMode[]>;
+    resolveCreateConfig?(input: ResolveAgentCreateConfigInput): ResolveAgentCreateConfigResult;
+    isCreateConfigUnattended?(input: AgentCreateConfigUnattendedInput): boolean;
     listCommands?(config: AgentSessionConfig): Promise<AgentSlashCommand[]>;
     listFeatures?(config: AgentSessionConfig): Promise<AgentFeature[]>;
     listPersistedAgents?(options?: ListPersistedAgentsOptions): Promise<PersistedAgentDescriptor[]>;
@@ -548,6 +573,12 @@ export interface AgentClient {
      * Called when Paseo archives an agent so the provider's own UI reflects the same state.
      */
     archiveNativeSession?(handle: AgentPersistenceHandle): Promise<void>;
+    /**
+     * Release any provider-owned resources held by this client (background
+     * processes, sockets, cached subprocesses, etc.). Called when the daemon
+     * shuts down. Must be idempotent.
+     */
+    shutdown?(): Promise<void>;
 }
 export {};
 //# sourceMappingURL=agent-sdk-types.d.ts.map

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

@@ -26,18 +26,18 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
         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;
-        featureValues?: Record<string, unknown> | 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;
-        featureValues?: Record<string, unknown> | null | undefined;
     }>>>;
     runtimeInfo: z.ZodOptional<z.ZodObject<{
         provider: z.ZodString;
@@ -70,16 +70,16 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
         icon: z.ZodOptional<z.ZodString>;
         value: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        value: boolean;
         type: "toggle";
+        value: boolean;
         id: string;
         label: string;
         description?: string | undefined;
         icon?: string | undefined;
         tooltip?: string | undefined;
     }, {
-        value: boolean;
         type: "toggle";
+        value: boolean;
         id: string;
         label: string;
         description?: string | undefined;
@@ -113,6 +113,7 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
             isDefault?: boolean | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
+        type: "select";
         value: string | null;
         options: {
             id: string;
@@ -121,13 +122,13 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
             metadata?: Record<string, unknown> | undefined;
             isDefault?: boolean | undefined;
         }[];
-        type: "select";
         id: string;
         label: string;
         description?: string | undefined;
         icon?: string | undefined;
         tooltip?: string | undefined;
     }, {
+        type: "select";
         value: string | null;
         options: {
             id: string;
@@ -136,7 +137,6 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
             metadata?: Record<string, unknown> | undefined;
             isDefault?: boolean | undefined;
         }[];
-        type: "select";
         id: string;
         label: string;
         description?: string | undefined;
@@ -169,30 +169,48 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
     cwd: string;
     createdAt: string;
     id: string;
-    updatedAt: string;
     provider: string;
+    updatedAt: string;
     labels: Record<string, string>;
-    lastStatus: "error" | "initializing" | "idle" | "running" | "closed";
-    title?: string | null | undefined;
+    lastStatus: "error" | "running" | "initializing" | "idle" | "closed";
     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;
-        featureValues?: Record<string, unknown> | null | undefined;
     } | null | undefined;
     internal?: boolean | 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;
+    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";
+        value: boolean;
         id: string;
         label: string;
         description?: string | undefined;
         icon?: string | undefined;
         tooltip?: string | undefined;
     } | {
+        type: "select";
         value: string | null;
         options: {
             id: string;
@@ -201,61 +219,63 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
             metadata?: Record<string, unknown> | undefined;
             isDefault?: boolean | undefined;
         }[];
-        type: "select";
         id: string;
         label: string;
         description?: string | undefined;
         icon?: string | undefined;
         tooltip?: string | undefined;
     })[] | undefined;
-    lastUserMessageAt?: string | null | undefined;
-    persistence?: {
-        provider: string;
-        sessionId: string;
-        metadata?: Record<string, any> | undefined;
-        nativeHandle?: any;
-    } | 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;
     lastError?: string | null | undefined;
     requiresAttention?: boolean | undefined;
     attentionReason?: "finished" | "error" | "permission" | null | undefined;
     attentionTimestamp?: string | null | undefined;
     archivedAt?: string | null | undefined;
-    lastActivityAt?: string | undefined;
-    lastModeId?: string | null | undefined;
 }, {
     cwd: string;
     createdAt: string;
     id: string;
-    updatedAt: string;
     provider: string;
-    title?: string | null | undefined;
+    updatedAt: string;
     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;
-        featureValues?: Record<string, unknown> | null | undefined;
     } | null | undefined;
     internal?: boolean | 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" | "running" | "initializing" | "idle" | "closed" | undefined;
+    lastModeId?: string | 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";
+        value: boolean;
         id: string;
         label: string;
         description?: string | undefined;
         icon?: string | undefined;
         tooltip?: string | undefined;
     } | {
+        type: "select";
         value: string | null;
         options: {
             id: string;
@@ -264,37 +284,17 @@ declare const STORED_AGENT_SCHEMA: z.ZodObject<{
             metadata?: Record<string, unknown> | undefined;
             isDefault?: boolean | undefined;
         }[];
-        type: "select";
         id: string;
         label: string;
         description?: string | undefined;
         icon?: string | undefined;
         tooltip?: string | undefined;
     })[] | undefined;
-    lastUserMessageAt?: string | null | undefined;
-    persistence?: {
-        provider: string;
-        sessionId: string;
-        metadata?: Record<string, any> | undefined;
-        nativeHandle?: any;
-    } | 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;
     lastError?: string | null | undefined;
-    labels?: Record<string, string> | undefined;
     requiresAttention?: boolean | undefined;
     attentionReason?: "finished" | "error" | "permission" | null | undefined;
     attentionTimestamp?: string | null | undefined;
     archivedAt?: string | null | undefined;
-    lastActivityAt?: string | undefined;
-    lastStatus?: "error" | "initializing" | "idle" | "running" | "closed" | undefined;
-    lastModeId?: string | null | undefined;
 }>;
 export type SerializableAgentConfig = Pick<AgentSessionConfig, "modeId" | "model" | "thinkingOptionId" | "featureValues" | "extra" | "systemPrompt" | "mcpServers">;
 export type StoredAgentRecord = z.infer<typeof STORED_AGENT_SCHEMA>;

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

@@ -0,0 +1,87 @@
+import type { Logger } from "pino";
+import type { TerminalManager } from "../../../terminal/terminal-manager.js";
+import type { WorkspaceGitService } from "../../workspace-git-service.js";
+import type { AgentWorktreeSetupContinuation, CreatePaseoWorktreeWorkflowFn } from "../../worktree-session.js";
+import type { AgentAttachment, FirstAgentContext, GitSetupOptions } from "../../messages.js";
+import type { AgentManager, ManagedAgent } from "../agent-manager.js";
+import type { AgentSessionConfig } from "../agent-sdk-types.js";
+import type { AgentStorage } from "../agent-storage.js";
+import type { ProviderSnapshotManager } from "../provider-snapshot-manager.js";
+export interface CreateAgentWorkspace {
+    workspaceId: string;
+}
+export interface CreateAgentSessionWorktreeResult {
+    sessionConfig: AgentSessionConfig;
+    setupContinuation?: AgentWorktreeSetupContinuation;
+}
+interface CreateAgentCommandDependencies {
+    agentManager: AgentManager;
+    agentStorage: AgentStorage;
+    logger: Logger;
+    paseoHome?: string;
+    workspaceGitService?: Pick<WorkspaceGitService, "getSnapshot" | "listWorktrees" | "resolveRepoRoot">;
+    terminalManager?: TerminalManager | null;
+    providerSnapshotManager: ProviderSnapshotManager;
+    createPaseoWorktree?: CreatePaseoWorktreeWorkflowFn;
+}
+export interface CreateAgentFromSessionInput {
+    kind: "session";
+    config: AgentSessionConfig;
+    workspaceId?: string;
+    worktreeName?: string;
+    initialPrompt?: string;
+    clientMessageId?: string;
+    outputSchema?: Record<string, unknown>;
+    images?: Array<{
+        data: string;
+        mimeType: string;
+    }>;
+    attachments?: AgentAttachment[];
+    git?: GitSetupOptions;
+    labels: Record<string, string>;
+    env?: Record<string, string>;
+    provisionalTitle: string | null;
+    explicitTitle: string | null;
+    firstAgentContext: FirstAgentContext;
+    buildSessionConfig: (config: AgentSessionConfig, gitOptions?: GitSetupOptions, legacyWorktreeName?: string, firstAgentContext?: FirstAgentContext) => Promise<CreateAgentSessionWorktreeResult>;
+    resolveWorkspace: (input: {
+        cwd: string;
+        workspaceId?: string;
+    }) => Promise<CreateAgentWorkspace>;
+}
+export interface CreateAgentFromMcpInput {
+    kind: "mcp";
+    provider: string;
+    title: string;
+    initialPrompt: string;
+    cwd?: string;
+    thinking?: string;
+    features?: Record<string, unknown>;
+    labels?: Record<string, string>;
+    mode?: string;
+    background: boolean;
+    notifyOnFinish: boolean;
+    callerAgentId?: string;
+    callerContext?: {
+        lockedCwd?: string;
+        allowCustomCwd?: boolean;
+        childAgentDefaultLabels?: Record<string, string>;
+    } | null;
+    worktree?: {
+        worktreeName?: string;
+        baseBranch?: string;
+        refName?: string;
+        action?: "branch-off" | "checkout";
+        githubPrNumber?: number;
+    };
+}
+export type CreateAgentCommandInput = CreateAgentFromSessionInput | CreateAgentFromMcpInput;
+export interface CreateAgentCommandResult {
+    snapshot: ManagedAgent;
+    liveSnapshot: ManagedAgent;
+    background: boolean;
+    initialPromptStarted: boolean;
+}
+export declare function createAgentCommand(dependencies: CreateAgentCommandDependencies, input: CreateAgentCommandInput): Promise<CreateAgentCommandResult>;
+export {};
+//# sourceMappingURL=create.d.ts.map