@namzu/sdk 48.3.1 → 50.0.0

package/dist/contracts/session/schemas.d.ts

@@ -17,6 +17,7 @@ export declare const TurnConfigSchema: z.ZodObject<{
     systemPrompt: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     model?: string | undefined;
+    permissionMode?: "plan" | "auto" | undefined;
     timeoutMs?: number | undefined;
     temperature?: number | undefined;
     tokenBudget?: number | undefined;
@@ -24,9 +25,9 @@ export declare const TurnConfigSchema: z.ZodObject<{
     systemPrompt?: string | undefined;
     streamIdleTimeoutMs?: number | undefined;
     maxRequestRichContentBytes?: number | undefined;
-    permissionMode?: "plan" | "auto" | undefined;
 }, {
     model?: string | undefined;
+    permissionMode?: "plan" | "auto" | undefined;
     timeoutMs?: number | undefined;
     temperature?: number | undefined;
     tokenBudget?: number | undefined;
@@ -34,7 +35,6 @@ export declare const TurnConfigSchema: z.ZodObject<{
     systemPrompt?: string | undefined;
     streamIdleTimeoutMs?: number | undefined;
     maxRequestRichContentBytes?: number | undefined;
-    permissionMode?: "plan" | "auto" | undefined;
 }>;
 /** `POST /sessions/{id}/turns`. The session id comes from the path, not the body. */
 export declare const CreateTurnSchema: z.ZodObject<{
@@ -51,6 +51,7 @@ export declare const CreateTurnSchema: z.ZodObject<{
         systemPrompt: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -58,9 +59,9 @@ export declare const CreateTurnSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     }, {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -68,7 +69,6 @@ export declare const CreateTurnSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     }>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     stream: z.ZodOptional<z.ZodBoolean>;
@@ -76,6 +76,7 @@ export declare const CreateTurnSchema: z.ZodObject<{
     message: string;
     config: {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -83,7 +84,6 @@ export declare const CreateTurnSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     };
     env?: Record<string, string> | undefined;
     stream?: boolean | undefined;
@@ -91,6 +91,7 @@ export declare const CreateTurnSchema: z.ZodObject<{
     message: string;
     config: {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -98,7 +99,6 @@ export declare const CreateTurnSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     };
     env?: Record<string, string> | undefined;
     stream?: boolean | undefined;
@@ -119,6 +119,7 @@ export declare const CreateEphemeralSessionSchema: z.ZodObject<{
         systemPrompt: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -126,9 +127,9 @@ export declare const CreateEphemeralSessionSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     }, {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -136,13 +137,13 @@ export declare const CreateEphemeralSessionSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     }>;
     env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, "strict", z.ZodTypeAny, {
     message: string;
     config: {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -150,7 +151,6 @@ export declare const CreateEphemeralSessionSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     };
     agent_id: string;
     env?: Record<string, string> | undefined;
@@ -158,6 +158,7 @@ export declare const CreateEphemeralSessionSchema: z.ZodObject<{
     message: string;
     config: {
         model?: string | undefined;
+        permissionMode?: "plan" | "auto" | undefined;
         timeoutMs?: number | undefined;
         temperature?: number | undefined;
         tokenBudget?: number | undefined;
@@ -165,7 +166,6 @@ export declare const CreateEphemeralSessionSchema: z.ZodObject<{
         systemPrompt?: string | undefined;
         streamIdleTimeoutMs?: number | undefined;
         maxRequestRichContentBytes?: number | undefined;
-        permissionMode?: "plan" | "auto" | undefined;
     };
     agent_id: string;
     env?: Record<string, string> | undefined;

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

@@ -78,10 +78,15 @@ interface ChildSpawnRecord {
     parentSessionId: SessionId;
     /** The parent turn whose tool call spawned the child. */
     parentTurnId: TurnId;
+    /** A follow-up has a new invoking turn; the conversation's origin stays immutable. */
+    originParentTurnId?: TurnId;
+    /** Rollback must never delete a conversation that existed before this invocation. */
+    resumed?: boolean;
     rootSessionId: SessionId;
     /** The parent's ancestors and the parent itself, root first: the child's `SessionLocator.ancestors`. */
     ancestry: readonly SessionId[];
     childDepth: number;
+    childOwnerVersion: number;
     /**
      * Where the child's log and meta document were placed, when this manager
      * placed them (a layout was known and the child named no storage).
@@ -111,6 +116,7 @@ export declare class AgentManager {
     private registry;
     private instances;
     private spawnRecords;
+    private readonly childConversations;
     private completionCallbacks;
     private listeners;
     private log;
@@ -201,6 +207,11 @@ export declare class AgentManager {
     private provisionSpawn;
     private validateSpawn;
     private provisionSpawnUnlocked;
+    private retainChildConversation;
+    private releaseChildConversation;
+    /** Called under the same parent provisioning lock as ordinary admission. */
+    private provisionContinuation;
+    private assertContinuationOwnership;
     private runChild;
     /**
      * Wraps the parent listener so every event relayed from the child session

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

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

package/dist/manager/agent/lifecycle.js

@@ -20,6 +20,7 @@ import { registerChildSessionLog, writeChildSessionMeta } from './child-session.
 /** Internal backpressure: the parent's unmeasured request owns its budget until its receipt. */
 class ParentBudgetRequestPending extends Error {
 }
+const RETAINED_CHILD_CONVERSATION_CAP = 1_000;
 /**
  * Combine a child's own environment with what its parent passed down.
  *
@@ -126,6 +127,7 @@ export class AgentManager {
     registry;
     instances = new Map();
     spawnRecords = new Map();
+    childConversations = new Map();
     completionCallbacks = new Map();
     listeners = [];
     log;
@@ -481,6 +483,7 @@ export class AgentManager {
                 state: 'pending',
                 pendingMessages: queuedTask?.pendingMessages ?? [],
                 createdAt: queuedTask?.createdAt ?? Date.now(),
+                childSessionId: spawnRecord.childSessionId,
                 workspace: options.workspace?.mode === 'isolated' ? spawnRecord.workspaceRef : undefined,
                 sessionEventListener: listener,
             });
@@ -544,6 +547,9 @@ export class AgentManager {
                 'namzu.agent.depth': context.depth,
             });
             const definition = this.registry.getOrThrow(options.agentId);
+            if (spawnRecord.resumed &&
+                definition !== this.childConversations.get(spawnRecord.childSessionId)?.definition)
+                throw new Error('Child continuation requires its unchanged agent definition');
             let childConfig;
             if (definition.configBuilder) {
                 // Call the configBuilder regardless of whether factoryOptions were
@@ -754,6 +760,9 @@ export class AgentManager {
                 childConfig.sessionLog = childLog;
                 spawnRecord.releaseLog = registerChildSessionLog(childLog);
             }
+            if (!spawnRecord.resumed && childConfig.sessionLog) {
+                this.retainChildConversation(spawnRecord, context, childOptions, childConfig.sessionLog);
+            }
             // Outside the branch, like the scope above it and for the same reason:
             // a `configBuilder` cannot forward a field it was never told about.
             //
@@ -770,6 +779,11 @@ export class AgentManager {
             childAbortController.signal.throwIfAborted();
             await childBudget.flush();
             childAbortController.signal.throwIfAborted();
+            if (spawnRecord.resumed && this.registry.getOrThrow(options.agentId) !== definition)
+                throw new Error('Child continuation agent definition changed during admission');
+            if (spawnRecord.resumed)
+                await this.assertContinuationOwnership(spawnRecord, options.agentId);
+            childAbortController.signal.throwIfAborted();
             this.executingTasks.add(taskId);
             const runningTask = agentTask;
             this.runChild(runningTask, childOptions, childConfig, listener)
@@ -790,10 +804,13 @@ export class AgentManager {
                 if (!this.instances.has(taskId) || isTerminalAgentTaskState(runningTask.state)) {
                     await this.failSubSession(spawnRecord);
                 }
-                else
+                else {
+                    this.releaseChildConversation(spawnRecord);
                     this.markFailed(taskId, toErrorMessage(failure));
+                }
             })
                 .finally(() => {
+                this.releaseChildConversation(spawnRecord);
                 this.executingTasks.delete(taskId);
                 if (!this.instances.has(taskId))
                     this.dropSpawnRecord(taskId);
@@ -872,6 +889,22 @@ export class AgentManager {
     }
     async rollbackSpawnResources(spawnRecord) {
         spawnRecord.releaseLog?.();
+        if (spawnRecord.resumed) {
+            try {
+                await this.deps.sessionStore.deleteSubSession(spawnRecord.subSessionId, spawnRecord.tenantId);
+                const session = await this.deps.sessionStore.getSession(spawnRecord.childSessionId, spawnRecord.tenantId);
+                if (session &&
+                    session.status === 'active' &&
+                    session.ownerVersion === spawnRecord.childOwnerVersion) {
+                    await this.deps.sessionStore.updateSession({ ...session, status: 'idle' }, spawnRecord.tenantId, spawnRecord.childOwnerVersion);
+                }
+            }
+            finally {
+                this.releaseChildConversation(spawnRecord);
+            }
+            return;
+        }
+        this.childConversations.delete(spawnRecord.childSessionId);
         // A child that never started leaves no meta document naming it: the
         // session it describes is being deleted below.
         if (spawnRecord.placement) {
@@ -880,7 +913,10 @@ export class AgentManager {
                 'exception.message': toErrorMessage(err),
             }));
         }
-        await this.disposeChildWorkspace({ ...spawnRecord, workspaceRetention: undefined });
+        await this.disposeChildWorkspace({
+            ...spawnRecord,
+            workspaceRetention: undefined,
+        });
         try {
             // The edge must be removed before its child: stores reject deletion
             // of a session that still has a subsession reference.
@@ -916,7 +952,7 @@ export class AgentManager {
             kind: 'child-session',
             sessionId: spawnRecord.childSessionId,
             parentSessionId: spawnRecord.parentSessionId,
-            parentTurnId: spawnRecord.parentTurnId,
+            parentTurnId: spawnRecord.originParentTurnId ?? spawnRecord.parentTurnId,
             rootSessionId: spawnRecord.rootSessionId,
             depth: spawnRecord.childDepth,
             toolCallId: placement.toolCallId,
@@ -942,6 +978,18 @@ export class AgentManager {
      * the child's config as it is.
      */
     async placeChildSession(spawnRecord, childConfig, context, options, taskId) {
+        if (spawnRecord.resumed) {
+            const conversation = this.childConversations.get(spawnRecord.childSessionId);
+            if (!conversation)
+                throw new Error('Child conversation continuation authority is unavailable');
+            if (childConfig.sessionLog && childConfig.sessionLog !== conversation.log)
+                throw new Error('Child continuation cannot replace its conversation log');
+            if (conversation.origin.placement) {
+                childConfig.paths = conversation.origin.placement.paths;
+                spawnRecord.placement = conversation.origin.placement;
+            }
+            return conversation.log;
+        }
         if (childConfig.sessionLog !== undefined)
             return undefined;
         const inherited = context.childStorage;
@@ -1144,6 +1192,7 @@ export class AgentManager {
             this.cancel(taskId);
         }
         this.instances.clear();
+        this.childConversations.clear();
         for (const taskId of this.spawnRecords.keys())
             if (!this.executingTasks.has(taskId))
                 this.dropSpawnRecord(taskId);
@@ -1231,6 +1280,8 @@ export class AgentManager {
         await this.validateSpawn(options, context);
         context.parentAbortController.signal.throwIfAborted();
         const store = this.deps.sessionStore;
+        if (options.resumeSessionId)
+            return this.provisionContinuation(options, context);
         // Ancestry walk gives both the child depth and the root session id
         // attached to every sub-session event from here down.
         const parentAncestry = await store.getAncestry(options.parentSessionId, context.tenantId);
@@ -1355,12 +1406,128 @@ export class AgentManager {
             rootSessionId,
             ancestry: parentAncestry,
             childDepth,
+            childOwnerVersion: childSession.ownerVersion,
             workspaceRef,
             ...(options.workspace?.mode === 'isolated' && options.workspace.retention === 'retain'
                 ? { workspaceRetention: 'retain' }
                 : {}),
         };
     }
+    retainChildConversation(origin, context, options, log) {
+        // Existing builders may supply an application-managed log addressed to
+        // another session. Preserve that first invocation, but never turn its
+        // history into authority for this admitted child's conversation.
+        if (log.sessionId !== origin.childSessionId)
+            return;
+        // Conversation authority is bounded independently of the heavy task
+        // eviction. Losing a retained entry makes continuation unavailable; it
+        // never reconstructs execution authority from a history file.
+        if (this.childConversations.size >= RETAINED_CHILD_CONVERSATION_CAP) {
+            const oldest = [...this.childConversations].find(([, value]) => !value.activeSubSessionId);
+            if (oldest)
+                this.childConversations.delete(oldest[0]);
+            else
+                return;
+        }
+        this.childConversations.set(origin.childSessionId, {
+            definition: this.registry.getOrThrow(options.agentId),
+            origin,
+            topicId: context.topicId,
+            projectId: context.projectId,
+            cwd: resolve(options.input.workingDirectory ?? process.cwd()),
+            log,
+            activeSubSessionId: origin.subSessionId,
+        });
+    }
+    releaseChildConversation(record) {
+        const conversation = this.childConversations.get(record.childSessionId);
+        if (conversation?.activeSubSessionId !== record.subSessionId)
+            return;
+        conversation.activeSubSessionId = undefined;
+        // An old task's eviction must not unregister the next invocation's log.
+        record.releaseLog?.();
+        record.releaseLog = undefined;
+    }
+    /** Called under the same parent provisioning lock as ordinary admission. */
+    async provisionContinuation(options, context) {
+        const id = options.resumeSessionId;
+        const conversation = id ? this.childConversations.get(id) : undefined;
+        if (!id || !conversation)
+            throw new Error('Child conversation continuation authority is unavailable');
+        const origin = conversation.origin;
+        if (origin.parentSessionId !== options.parentSessionId ||
+            options.parentSessionId !== context.sessionId ||
+            origin.tenantId !== context.tenantId ||
+            conversation.projectId !== context.projectId ||
+            options.projectId !== context.projectId ||
+            conversation.topicId !== context.topicId)
+            throw new Error('Child continuation scope does not match its owning parent');
+        if (conversation.definition !== this.registry.getOrThrow(options.agentId))
+            throw new Error('Child continuation requires its unchanged agent definition');
+        if (conversation.activeSubSessionId)
+            throw new Error('Child conversation is still running or settling');
+        if (origin.workspaceRef || options.workspace?.mode === 'isolated' || options.workspaceBackend)
+            throw new Error('Child continuation requires a shared workspace; isolated leases cannot be resumed');
+        if (resolve(options.input.workingDirectory ?? process.cwd()) !== conversation.cwd)
+            throw new Error('Child continuation cannot change its working directory');
+        const store = this.deps.sessionStore;
+        if (store.supportsInvocationSummaries !== true || store.supportsOwnerVersionCas !== true)
+            throw new Error('Session store does not support child conversation continuation');
+        const child = await store.getSession(id, context.tenantId);
+        if (!child ||
+            child.status === 'archived' ||
+            child.status === 'locked' ||
+            child.ownerVersion !== origin.childOwnerVersion ||
+            child.projectId !== context.projectId ||
+            child.topicId !== context.topicId ||
+            child.currentActor?.kind !== 'agent' ||
+            child.currentActor.agentId !== options.agentId)
+            throw new Error('Child conversation ownership is no longer valid');
+        const edges = await store.getChildren(options.parentSessionId, context.tenantId);
+        if (!edges.some((edge) => edge.id === origin.subSessionId && edge.childSessionId === id))
+            throw new Error('Child conversation origin is no longer attached to this parent');
+        const edge = await store.createSubSession({
+            parentSessionId: options.parentSessionId,
+            childSessionId: id,
+            kind: 'agent_spawn',
+            spawnedBy: context.parentActor,
+            failureMode: 'delegate',
+            completionMode: 'summary_ref',
+        }, context.tenantId);
+        try {
+            context.parentAbortController.signal.throwIfAborted();
+            await store.updateSession({ ...child, status: 'active' }, context.tenantId, origin.childOwnerVersion);
+        }
+        catch (error) {
+            await store.deleteSubSession(edge.id, context.tenantId);
+            throw error;
+        }
+        conversation.activeSubSessionId = edge.id;
+        return {
+            subSessionId: edge.id,
+            childSessionId: id,
+            tenantId: context.tenantId,
+            parentSessionId: origin.parentSessionId,
+            parentTurnId: context.parentTurnId,
+            originParentTurnId: origin.parentTurnId,
+            rootSessionId: origin.rootSessionId,
+            ancestry: origin.ancestry,
+            childDepth: origin.childDepth,
+            childOwnerVersion: origin.childOwnerVersion,
+            ...(origin.placement ? { placement: origin.placement } : {}),
+            resumed: true,
+        };
+    }
+    async assertContinuationOwnership(record, agentId) {
+        const child = await this.deps.sessionStore.getSession(record.childSessionId, record.tenantId);
+        if (!child ||
+            child.ownerVersion !== record.childOwnerVersion ||
+            child.status === 'archived' ||
+            child.status === 'locked' ||
+            child.currentActor?.kind !== 'agent' ||
+            child.currentActor.agentId !== agentId)
+            throw new Error('Child conversation ownership changed during admission');
+    }
     async runChild(agentTask, options, childConfig, listener) {
         this.updateState(agentTask.taskId, 'running');
         this.emit({ type: 'running', taskId: agentTask.taskId });
@@ -1422,6 +1589,8 @@ export class AgentManager {
                     const agentSummary = deriveAgentSummary(result);
                     const summary = await this.deps.summaryMaterializer.materialize({
                         sessionId: spawnRecord.childSessionId,
+                        ...(spawnRecord.resumed ? { expectedOwnerVersion: spawnRecord.childOwnerVersion } : {}),
+                        ...(spawnRecord.resumed ? { turnId: result.turnId } : {}),
                         tenantId: spawnRecord.tenantId,
                         finalOutcome: outcome,
                         agentSummary,
@@ -1465,10 +1634,16 @@ export class AgentManager {
                     'namzu.task.id': agentTask.taskId,
                     'exception.message': toErrorMessage(err),
                 });
+                // A follow-up must never advertise its original conversation's
+                // stale summary as the completion of this new invocation.
+                if (spawnRecord.resumed)
+                    throw err;
             }
         }
         if (spawnRecord)
             await this.settleChildSession(agentTask, spawnRecord, result.status);
+        if (spawnRecord)
+            this.releaseChildConversation(spawnRecord);
         this.markCompleted(agentTask.taskId, result);
     }
     /**