@mduan/paseo-cli 0.11.0-fork.38 → 0.11.0-fork.39

package/dist/commands/agent/run.js

@@ -509,6 +509,7 @@ export async function runRunCommand(prompt, options, _command) {
             model: resolvedProviderModel.model,
             thinkingOptionId,
             initialPrompt: prompt,
+            notifyOnFinish: Boolean(callerAgentId && runsInBackground(options)),
             images,
             env: requestEnv,
             labels: Object.keys(labels).length > 0 ? labels : undefined,

package/node_modules/@getpaseo/client/dist/daemon-client.d.ts

@@ -182,6 +182,7 @@ export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     env?: CreateAgentRequestMessage["env"];
     workspaceId?: string;
     callerAgentId?: string;
+    notifyOnFinish?: boolean;
     initialPrompt?: string;
     idempotencyKey?: string;
     clientMessageId?: string;

package/node_modules/@getpaseo/client/dist/daemon-client.js

@@ -1637,6 +1637,11 @@ export class DaemonClient {
         return { agent: payload.agent, project: payload.project ?? null };
     }
     async createAgent(options) {
+        // COMPAT(agentCreationFinishNotifications): added after v0.11.0-fork.38; remove gate after 2027-05-13.
+        if (options.notifyOnFinish &&
+            !this.lastServerInfoMessage?.features?.agentCreationFinishNotifications) {
+            throw new Error("Update the host to receive agent creation finish notifications.");
+        }
         const result = await this.creations.createAgent({
             ...options,
             config: resolveAgentConfig(options),
@@ -1655,6 +1660,7 @@ export class DaemonClient {
             ...(options.env ? { env: options.env } : {}),
             ...(options.workspaceId !== undefined ? { workspaceId: options.workspaceId } : {}),
             ...(options.callerAgentId !== undefined ? { callerAgentId: options.callerAgentId } : {}),
+            ...(options.notifyOnFinish !== undefined ? { notifyOnFinish: options.notifyOnFinish } : {}),
             ...(options.initialPrompt ? { initialPrompt: options.initialPrompt } : {}),
             idempotencyKey: options.idempotencyKey,
             ...(options.clientMessageId ? { clientMessageId: options.clientMessageId } : {}),
@@ -5083,7 +5089,7 @@ export class DaemonClient {
     }
 }
 function resolveAgentConfig(options) {
-    const { config, provider, cwd, agentId: _agentId, onEvent: _onEvent, idempotencyKey: _idempotencyKey, clientMessageId: _clientMessageId, callerAgentId: _callerAgentId, outputSchema: _outputSchema, attachments: _attachments, worktree: _worktree, autoArchive: _autoArchive, env: _env, workspaceId: _workspaceId, initialPrompt: _initialPrompt, images: _images, git: _git, worktreeName: _worktreeName, requestId: _requestId, labels: _labels, ...overrides } = options;
+    const { config, provider, cwd, agentId: _agentId, onEvent: _onEvent, idempotencyKey: _idempotencyKey, clientMessageId: _clientMessageId, callerAgentId: _callerAgentId, notifyOnFinish: _notifyOnFinish, outputSchema: _outputSchema, attachments: _attachments, worktree: _worktree, autoArchive: _autoArchive, env: _env, workspaceId: _workspaceId, initialPrompt: _initialPrompt, images: _images, git: _git, worktreeName: _worktreeName, requestId: _requestId, labels: _labels, ...overrides } = options;
     const baseConfig = {
         ...(provider ? { provider } : {}),
         ...(cwd ? { cwd } : {}),

package/node_modules/@getpaseo/client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/client",
-  "version": "0.11.0-fork.38",
+  "version": "0.11.0-fork.39",
   "description": "Paseo client SDK package",
   "files": [
     "dist",
@@ -44,7 +44,7 @@
     "vitest": "^4.1.6"
   },
   "dependencies": {
-    "@getpaseo/protocol": "0.11.0-fork.38",
-    "@getpaseo/relay": "0.11.0-fork.38"
+    "@getpaseo/protocol": "0.11.0-fork.39",
+    "@getpaseo/relay": "0.11.0-fork.39"
   }
 }

package/node_modules/@getpaseo/highlight/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/highlight",
-  "version": "0.11.0-fork.38",
+  "version": "0.11.0-fork.39",
   "files": [
     "dist",
     "!dist/**/*.map",

package/node_modules/@getpaseo/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/plugin",
-  "version": "0.11.0-fork.38",
+  "version": "0.11.0-fork.39",
   "description": "Paseo plugin SDK package",
   "files": [
     "dist",
@@ -66,8 +66,8 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@getpaseo/client": "0.11.0-fork.38",
-    "@getpaseo/protocol": "0.11.0-fork.38",
+    "@getpaseo/client": "0.11.0-fork.39",
+    "@getpaseo/protocol": "0.11.0-fork.39",
     "@types/node": "^20.9.0",
     "@types/react": "~19.2.0",
     "react": "19.1.0",

package/node_modules/@getpaseo/protocol/dist/messages.d.ts

@@ -2185,6 +2185,7 @@ export declare const CreateAgentRequestMessageSchema: z.ZodObject<{
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     workspaceId: z.ZodOptional<z.ZodString>;
     callerAgentId: z.ZodOptional<z.ZodString>;
+    notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
     worktreeName: z.ZodOptional<z.ZodString>;
     initialPrompt: z.ZodOptional<z.ZodString>;
     clientMessageId: z.ZodOptional<z.ZodString>;
@@ -2364,6 +2365,7 @@ export declare const AgentCreateRequestSchema: z.ZodObject<{
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     workspaceId: z.ZodOptional<z.ZodString>;
     callerAgentId: z.ZodOptional<z.ZodString>;
+    notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
     worktreeName: z.ZodOptional<z.ZodString>;
     initialPrompt: z.ZodOptional<z.ZodString>;
     clientMessageId: z.ZodOptional<z.ZodString>;
@@ -2686,6 +2688,7 @@ export declare const WorkspaceInitialAgentSchema: z.ZodObject<{
         mimeType: z.ZodString;
     }, z.core.$strip>>>;
     callerAgentId: z.ZodOptional<z.ZodString>;
+    notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
     initialPrompt: z.ZodOptional<z.ZodString>;
     outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     autoArchive: z.ZodOptional<z.ZodBoolean>;
@@ -4183,6 +4186,7 @@ export declare const WorkspaceCreateRequestSchema: z.ZodObject<{
             mimeType: z.ZodString;
         }, z.core.$strip>>>;
         callerAgentId: z.ZodOptional<z.ZodString>;
+        notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
         initialPrompt: z.ZodOptional<z.ZodString>;
         outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         autoArchive: z.ZodOptional<z.ZodBoolean>;
@@ -5973,6 +5977,7 @@ export declare const SessionInboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     workspaceId: z.ZodOptional<z.ZodString>;
     callerAgentId: z.ZodOptional<z.ZodString>;
+    notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
     worktreeName: z.ZodOptional<z.ZodString>;
     initialPrompt: z.ZodOptional<z.ZodString>;
     clientMessageId: z.ZodOptional<z.ZodString>;
@@ -7059,6 +7064,7 @@ export declare const SessionInboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
             mimeType: z.ZodString;
         }, z.core.$strip>>>;
         callerAgentId: z.ZodOptional<z.ZodString>;
+        notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
         initialPrompt: z.ZodOptional<z.ZodString>;
         outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         autoArchive: z.ZodOptional<z.ZodBoolean>;
@@ -7234,6 +7240,7 @@ export declare const SessionInboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     workspaceId: z.ZodOptional<z.ZodString>;
     callerAgentId: z.ZodOptional<z.ZodString>;
+    notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
     worktreeName: z.ZodOptional<z.ZodString>;
     initialPrompt: z.ZodOptional<z.ZodString>;
     clientMessageId: z.ZodOptional<z.ZodString>;
@@ -7981,6 +7988,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         agentRequestReceipts: z.ZodOptional<z.ZodBoolean>;
         workspaceRequestReceipts: z.ZodOptional<z.ZodBoolean>;
         creationLifecycle: z.ZodOptional<z.ZodBoolean>;
+        agentCreationFinishNotifications: z.ZodOptional<z.ZodBoolean>;
         hubAgentRpc: z.ZodOptional<z.ZodBoolean>;
         providersSnapshot: z.ZodOptional<z.ZodBoolean>;
         usageSources: z.ZodOptional<z.ZodBoolean>;
@@ -8104,6 +8112,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         agentRequestReceipts?: boolean | undefined;
         workspaceRequestReceipts?: boolean | undefined;
         creationLifecycle?: boolean | undefined;
+        agentCreationFinishNotifications?: boolean | undefined;
         hubAgentRpc?: boolean | undefined;
         providersSnapshot?: boolean | undefined;
         usageSources?: boolean | undefined;
@@ -8228,6 +8237,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         agentRequestReceipts?: boolean | undefined;
         workspaceRequestReceipts?: boolean | undefined;
         creationLifecycle?: boolean | undefined;
+        agentCreationFinishNotifications?: boolean | undefined;
         hubAgentRpc?: boolean | undefined;
         providersSnapshot?: boolean | undefined;
         usageSources?: boolean | undefined;
@@ -39561,6 +39571,7 @@ export declare const WSSessionInboundSchema: z.ZodObject<{
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         workspaceId: z.ZodOptional<z.ZodString>;
         callerAgentId: z.ZodOptional<z.ZodString>;
+        notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
         worktreeName: z.ZodOptional<z.ZodString>;
         initialPrompt: z.ZodOptional<z.ZodString>;
         clientMessageId: z.ZodOptional<z.ZodString>;
@@ -40647,6 +40658,7 @@ export declare const WSSessionInboundSchema: z.ZodObject<{
                 mimeType: z.ZodString;
             }, z.core.$strip>>>;
             callerAgentId: z.ZodOptional<z.ZodString>;
+            notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
             initialPrompt: z.ZodOptional<z.ZodString>;
             outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             autoArchive: z.ZodOptional<z.ZodBoolean>;
@@ -40822,6 +40834,7 @@ export declare const WSSessionInboundSchema: z.ZodObject<{
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         workspaceId: z.ZodOptional<z.ZodString>;
         callerAgentId: z.ZodOptional<z.ZodString>;
+        notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
         worktreeName: z.ZodOptional<z.ZodString>;
         initialPrompt: z.ZodOptional<z.ZodString>;
         clientMessageId: z.ZodOptional<z.ZodString>;
@@ -56273,6 +56286,7 @@ export declare const WSInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         workspaceId: z.ZodOptional<z.ZodString>;
         callerAgentId: z.ZodOptional<z.ZodString>;
+        notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
         worktreeName: z.ZodOptional<z.ZodString>;
         initialPrompt: z.ZodOptional<z.ZodString>;
         clientMessageId: z.ZodOptional<z.ZodString>;
@@ -57359,6 +57373,7 @@ export declare const WSInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
                 mimeType: z.ZodString;
             }, z.core.$strip>>>;
             callerAgentId: z.ZodOptional<z.ZodString>;
+            notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
             initialPrompt: z.ZodOptional<z.ZodString>;
             outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             autoArchive: z.ZodOptional<z.ZodBoolean>;
@@ -57534,6 +57549,7 @@ export declare const WSInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         workspaceId: z.ZodOptional<z.ZodString>;
         callerAgentId: z.ZodOptional<z.ZodString>;
+        notifyOnFinish: z.ZodOptional<z.ZodBoolean>;
         worktreeName: z.ZodOptional<z.ZodString>;
         initialPrompt: z.ZodOptional<z.ZodString>;
         clientMessageId: z.ZodOptional<z.ZodString>;

package/node_modules/@getpaseo/protocol/dist/messages.js

@@ -1559,6 +1559,7 @@ export const CreateAgentRequestMessageSchema = z.object({
     // Optional caller context lets managed CLI invocations use the same daemon-owned
     // workspace and parentage policy as agent-scoped MCP creation.
     callerAgentId: z.string().optional(),
+    notifyOnFinish: z.boolean().optional(),
     worktreeName: z.string().optional(),
     initialPrompt: z.string().optional(),
     clientMessageId: z.string().optional(),
@@ -3310,6 +3311,7 @@ export const ServerInfoStatusPayloadSchema = z
         // COMPAT(workspaceRequestReceipts): added in v0.8.0; remove gate after 2027-03-07.
         workspaceRequestReceipts: z.boolean().optional(),
         creationLifecycle: z.boolean().optional(),
+        agentCreationFinishNotifications: z.boolean().optional(),
         // COMPAT(hubAgentRpc): added in v0.8.0; remove gate after 2027-03-05.
         hubAgentRpc: z.boolean().optional(),
         providersSnapshot: z.boolean().optional(),

package/node_modules/@getpaseo/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/protocol",
-  "version": "0.11.0-fork.38",
+  "version": "0.11.0-fork.39",
   "description": "Paseo shared protocol schemas and wire types",
   "files": [
     "dist",

package/node_modules/@getpaseo/relay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/relay",
-  "version": "0.11.0-fork.38",
+  "version": "0.11.0-fork.39",
   "description": "Paseo relay for bridging daemon and client connections",
   "files": [
     "dist",

package/node_modules/@getpaseo/server/dist/server/builtin-plugins/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/builtin-plugins",
-  "version": "0.11.0-fork.38",
+  "version": "0.11.0-fork.39",
   "private": true,
   "type": "module",
   "scripts": {

package/node_modules/@getpaseo/server/dist/server/server/agent/create-agent/create.d.ts

@@ -26,6 +26,8 @@ export interface CreateAgentCommandDependencies {
 export type EnsureWorkspaceForCreate = (cwd: string, firstAgentContext?: FirstAgentContext) => Promise<string>;
 export interface CreateAgentFromSessionInput {
     kind: "session";
+    callerAgentId?: string;
+    notifyOnFinish?: boolean;
     onAgentReady?: (agent: ManagedAgent) => Promise<void>;
     agentId?: string;
     config: AgentSessionConfig;

package/node_modules/@getpaseo/server/dist/server/server/agent/create-agent/create.js

@@ -46,21 +46,16 @@ export async function createAgentCommand(dependencies, input) {
         input.onCreated?.({ agentId: snapshot.id, createdWorktree: resolved.createdWorktree ?? null });
     }
     if (resolved.prompt !== undefined) {
-        const sendResult = await sendInitialPrompt(dependencies, resolved, snapshot);
+        const sendResult = await sendInitialPrompt({
+            dependencies,
+            resolved,
+            snapshot,
+            callerAgentId: input.notifyOnFinish ? input.callerAgentId : undefined,
+        });
         initialPromptStarted = sendResult.started;
         liveSnapshot = sendResult.liveSnapshot;
         initialPromptError = sendResult.error ?? null;
     }
-    if (input.kind === "mcp" && input.notifyOnFinish && input.callerAgentId && initialPromptStarted) {
-        setupFinishNotification({
-            agentManager: dependencies.agentManager,
-            agentStorage: dependencies.agentStorage,
-            childAgentId: snapshot.id,
-            callerAgentId: input.callerAgentId,
-            requireParentOwnership: true,
-            logger: dependencies.logger,
-        });
-    }
     return {
         snapshot,
         liveSnapshot,
@@ -243,13 +238,13 @@ async function ensureWorkspaceForMcpCreate(dependencies, cwd, initialPrompt) {
     }
     return dependencies.ensureWorkspaceForCreate(cwd, { prompt: initialPrompt });
 }
-async function sendInitialPrompt(dependencies, resolved, snapshot) {
+async function sendInitialPrompt({ dependencies, resolved, snapshot, callerAgentId, }) {
     try {
         const prompt = resolved.prompt;
         if (prompt === undefined) {
             return { started: false, liveSnapshot: snapshot };
         }
-        const liveSnapshot = await startCreatedAgentInitialPrompt({
+        const dispatch = startCreatedAgentInitialPrompt({
             agentManager: dependencies.agentManager,
             agentId: snapshot.id,
             snapshot,
@@ -257,6 +252,18 @@ async function sendInitialPrompt(dependencies, resolved, snapshot) {
             runOptions: resolved.runOptions,
             logger: resolved.promptLogger ?? dependencies.logger,
         });
+        if (callerAgentId) {
+            setupFinishNotification({
+                agentManager: dependencies.agentManager,
+                agentStorage: dependencies.agentStorage,
+                childAgentId: snapshot.id,
+                callerAgentId,
+                requireParentOwnership: true,
+                dispatch,
+                logger: dependencies.logger,
+            });
+        }
+        const liveSnapshot = await dispatch;
         return { started: true, liveSnapshot };
     }
     catch (error) {

package/node_modules/@getpaseo/server/dist/server/server/agent/turn-diffs/store.js

@@ -74,7 +74,11 @@ export class TurnDiffStore {
         return record ? record.turns.map(toSummary) : [];
     }
     async resolveRange(agentId, target) {
-        const record = await this.enqueue(agentId, () => this.read(agentId));
+        let record = target.kind === "turn" ? await this.read(agentId) : null;
+        const hasSavedTurn = target.kind === "turn" && record?.turns.some((turn) => turn.turnId === target.turnId);
+        // Atomic records let saved turns bypass later snapshots without exposing partial writes.
+        if (!hasSavedTurn)
+            record = await this.enqueue(agentId, () => this.read(agentId));
         if (!record)
             return null;
         const { repoRoot } = record;

package/node_modules/@getpaseo/server/dist/server/server/session.js

@@ -3373,6 +3373,8 @@ export class Session {
                 providerSnapshotManager: this.providerSnapshotManager,
             }, {
                 kind: "session",
+                callerAgentId: msg.callerAgentId,
+                notifyOnFinish: msg.notifyOnFinish,
                 onAgentReady: async (agent) => {
                     createdAgentId = agent.id;
                     await onAgentReady?.(await this.buildAgentPayload(agent));

package/node_modules/@getpaseo/server/dist/server/server/websocket-server.js

@@ -1302,6 +1302,7 @@ export class VoiceAssistantWebSocketServer {
                 agentRequestReceipts: true,
                 workspaceRequestReceipts: true,
                 creationLifecycle: true,
+                agentCreationFinishNotifications: true,
                 hubAgentRpc: true,
                 // COMPAT(directorySync): added in v0.3.x, remove gate after 2027-02-12.
                 directorySync: true,