pilotswarm-sdk 0.5.64 → 0.5.65

package/dist/activity-routing.d.ts

@@ -0,0 +1,21 @@
+/** Capability routing for the complete named-agent handoff contract.
+ *
+ * Old orchestration callers omit this contract and retain their exact activity
+ * names, inputs and descriptors. Orchestrations 1.0.75 and later opt into it.
+ */
+export declare const AGENT_HANDOFF_CAPABILITY = "pilotswarm.agent-handoff.v2";
+export type ActivityRoutingContract = "agent-handoff-v2";
+export declare const HANDOFF_ACTIVITY_NAMES: {
+    readonly runTurn: "runTurnV3";
+    readonly runTurn2: "runTurnEpochV3";
+    readonly resolveAgentConfig: "resolveAgentConfigV2";
+    readonly resolveAgentForRequiredTool: "resolveAgentForRequiredToolV2";
+    readonly spawnChildSession: "spawnChildSessionV2";
+    readonly getSessionStatus: "getSessionStatusV2";
+    readonly listChildSessions: "listChildSessionsV2";
+};
+export declare function routedActivityName(name: keyof typeof HANDOFF_ACTIVITY_NAMES, contract?: ActivityRoutingContract): string;
+export declare function routeHandoffActivity(task: any, contract?: ActivityRoutingContract): any;
+/** Retain legacy handlers for already-scheduled work while registering the new contract. */
+export declare function registerHandoffActivity(runtime: any, name: keyof typeof HANDOFF_ACTIVITY_NAMES, handler: any, versionedHandler?: any): void;
+//# sourceMappingURL=activity-routing.d.ts.map

package/dist/activity-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-routing.d.ts","sourceRoot":"","sources":["../src/activity-routing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,gCAAgC,CAAC;AACtE,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAC;AACzD,eAAO,MAAM,sBAAsB;;;;;;;;CAQzB,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,OAAO,sBAAsB,EAAE,QAAQ,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAExH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,uBAAuB,GAAG,GAAG,CAMvF;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,OAAO,sBAAsB,EAAE,OAAO,EAAE,GAAG,EAAE,gBAAgB,MAAU,GAAG,IAAI,CAG/I"}

package/dist/activity-routing.js

@@ -0,0 +1,32 @@
+/** Capability routing for the complete named-agent handoff contract.
+ *
+ * Old orchestration callers omit this contract and retain their exact activity
+ * names, inputs and descriptors. Orchestrations 1.0.75 and later opt into it.
+ */
+export const AGENT_HANDOFF_CAPABILITY = "pilotswarm.agent-handoff.v2";
+export const HANDOFF_ACTIVITY_NAMES = {
+    runTurn: "runTurnV3",
+    runTurn2: "runTurnEpochV3",
+    resolveAgentConfig: "resolveAgentConfigV2",
+    resolveAgentForRequiredTool: "resolveAgentForRequiredToolV2",
+    spawnChildSession: "spawnChildSessionV2",
+    getSessionStatus: "getSessionStatusV2",
+    listChildSessions: "listChildSessionsV2",
+};
+export function routedActivityName(name, contract) {
+    return contract ? HANDOFF_ACTIVITY_NAMES[name] : name;
+}
+export function routeHandoffActivity(task, contract) {
+    if (!contract)
+        return task;
+    if (typeof task.withTag !== "function") {
+        throw new Error("Agent handoff requires Duroxide activity tag routing support");
+    }
+    return task.withTag(AGENT_HANDOFF_CAPABILITY);
+}
+/** Retain legacy handlers for already-scheduled work while registering the new contract. */
+export function registerHandoffActivity(runtime, name, handler, versionedHandler = handler) {
+    runtime.registerActivity(name, handler);
+    runtime.registerActivity(HANDOFF_ACTIVITY_NAMES[name], versionedHandler);
+}
+//# sourceMappingURL=activity-routing.js.map

package/dist/activity-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-routing.js","sourceRoot":"","sources":["../src/activity-routing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAEtE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,gBAAgB;IAC1B,kBAAkB,EAAE,sBAAsB;IAC1C,2BAA2B,EAAE,+BAA+B;IAC5D,iBAAiB,EAAE,qBAAqB;IACxC,gBAAgB,EAAE,oBAAoB;IACtC,iBAAiB,EAAE,qBAAqB;CAClC,CAAC;AAEX,MAAM,UAAU,kBAAkB,CAAC,IAAyC,EAAE,QAAkC;IAC5G,OAAO,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAS,EAAE,QAAkC;IAC9E,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAClD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,uBAAuB,CAAC,OAAY,EAAE,IAAyC,EAAE,OAAY,EAAE,gBAAgB,GAAG,OAAO;IACrI,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,gBAAgB,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAC7E,CAAC"}

package/dist/agent-discovery.d.ts

@@ -0,0 +1,35 @@
+/** A selectable blueprint, with metadata from exactly the copy spawning binds. */
+export interface AgentDiscoveryEntry {
+    /** Pass this reference unchanged to spawn_agent. */
+    agent_name: string;
+    name: string;
+    qualifiedName: string;
+    namespace: string | null;
+    description: string | null;
+    tools: string[];
+    skills: string[];
+    /** Server names only. Connection details and credentials are never listed. */
+    mcpServers: string[];
+    initialRequiredTool: string | null;
+    source: "static" | "published";
+    scope: "cluster" | "user";
+    system: boolean;
+    creatable: boolean;
+    id: string | null;
+    parent: string | null;
+}
+export declare function listAgentDefinitionsForCaller(opts: {
+    userAgents: any[];
+    systemAgents?: any[];
+    getCallerOwnerKey: () => Promise<string | null>;
+    systemOnly?: boolean;
+}): Promise<AgentDiscoveryEntry[]>;
+/** Live getters keep discovery consistent with worker package polling. */
+export declare function createAgentDiscoveryTool(opts: {
+    getUserAgents: () => any[];
+    getSystemAgents: () => any[];
+    getCallerOwnerKey: (durableSessionId?: string) => Promise<string | null>;
+}): import("@github/copilot-sdk").Tool<{
+    systemOnly?: boolean;
+}>;
+//# sourceMappingURL=agent-discovery.d.ts.map

package/dist/agent-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-discovery.d.ts","sourceRoot":"","sources":["../src/agent-discovery.ts"],"names":[],"mappings":"AAGA,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAChC,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAsB,6BAA6B,CAAC,IAAI,EAAE;IACtD,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAqEjC;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC3C,aAAa,EAAE,MAAM,GAAG,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,EAAE,CAAC;IAC7B,iBAAiB,EAAE,CAAC,gBAAgB,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5E;iBAgB4C,OAAO;GAUnD"}

package/dist/agent-discovery.js

@@ -0,0 +1,107 @@
+import { defineTool } from "@github/copilot-sdk";
+import { resolveAgentDefinitionForCaller } from "./session-proxy.js";
+export async function listAgentDefinitionsForCaller(opts) {
+    // Snapshot the arrays: worker package refresh mutates them in place while
+    // owner lookup awaits the catalog. A listing must use one coherent set.
+    const userAgents = [...opts.userAgents];
+    const systemAgents = [...(opts.systemAgents ?? [])];
+    let ownerKey;
+    const getCallerOwnerKey = () => ownerKey ??= Promise.resolve()
+        .then(opts.getCallerOwnerKey).catch(() => null);
+    const candidates = [];
+    for (const candidate of opts.systemOnly ? systemAgents : userAgents) {
+        // Do not even generate aliases from invisible metadata. A foreign
+        // name can fuzzy-match a public role; returning that reference would
+        // disclose the foreign name despite selecting a public definition.
+        const visible = await resolveAgentDefinitionForCaller({
+            agentName: candidate.name,
+            userAgents: opts.systemOnly ? [] : [candidate],
+            systemAgents: opts.systemOnly ? [candidate] : [],
+            getCallerOwnerKey,
+        });
+        if (visible)
+            candidates.push(candidate);
+    }
+    const references = new Set();
+    for (const agent of candidates) {
+        if (!agent.name)
+            continue;
+        references.add(agent.name);
+        if (agent.namespace)
+            references.add(`${agent.namespace}:${agent.name}`);
+        if (agent.packageScope !== "user")
+            references.add(`__shared:${agent.name}`);
+    }
+    // IDs are existing resolver aliases. They can reach a public copy hidden
+    // behind both an own-copy shadow and another namespace's same-name role.
+    for (const agent of candidates) {
+        if (!agent.id)
+            continue;
+        references.add(agent.id);
+        if (agent.packageScope !== "user")
+            references.add(`__shared:${agent.id}`);
+    }
+    const seen = new Set();
+    const entries = [];
+    for (const agentName of references) {
+        const resolved = await resolveAgentDefinitionForCaller({
+            agentName, userAgents: opts.systemOnly ? [] : userAgents, systemAgents, getCallerOwnerKey,
+        });
+        if (!resolved || (opts.systemOnly ? resolved.creatable !== false : resolved.creatable === false))
+            continue;
+        const selected = candidates.find(agent => agent.name === resolved.name
+            && agent.packageId === resolved.packageId
+            && agent.namespace === resolved.namespace
+            && agent.prompt === resolved.prompt);
+        if (!selected || seen.has(selected))
+            continue;
+        seen.add(selected);
+        entries.push({
+            agent_name: agentName,
+            name: resolved.name,
+            qualifiedName: agentName,
+            namespace: resolved.namespace ?? null,
+            description: selected.description || null,
+            tools: [...(resolved.tools ?? [])],
+            skills: [...(selected.skills ?? [])],
+            mcpServers: Array.isArray(selected.mcpServers)
+                ? [...selected.mcpServers] : Object.keys(selected.mcpServers ?? {}),
+            initialRequiredTool: resolved.initialRequiredTool ?? null,
+            source: resolved.packageId ? "published" : "static",
+            scope: resolved.packageScope === "user" ? "user" : "cluster",
+            system: resolved.system === true,
+            creatable: resolved.creatable !== false,
+            id: resolved.id ?? null,
+            parent: resolved.parent ?? null,
+        });
+    }
+    return entries.sort((a, b) => a.name.localeCompare(b.name) || a.agent_name.localeCompare(b.agent_name));
+}
+/** Live getters keep discovery consistent with worker package polling. */
+export function createAgentDiscoveryTool(opts) {
+    return defineTool("ps_list_agents", {
+        description: "Discover the named agent blueprints available to this session: static deployment agents and enabled published agents visible to its owner. " +
+            "Before choosing a generic child or native task, inspect this list if you do not already have an adequate current catalog. " +
+            "Match the job to each role's description, declared tools, skills and source access; pass its exact agent_name to spawn_agent with task for the assignment. " +
+            "A named agent loads its own instructions, tools and startup requirement. Tools listed here are declarations; session defaults may also apply. " +
+            "If no listed specialist fits, choose the appropriate generic or native delegation. " +
+            "These are blueprints, not running children; use check_agents for children already spawned. " +
+            "systemOnly is for inspecting worker-managed definitions, which cannot be spawned.",
+        parameters: {
+            type: "object",
+            properties: {
+                systemOnly: { type: "boolean", description: "Inspect worker-managed definitions only. These are not spawn targets. Default false." },
+            },
+        },
+        handler: async (args, invocation) => {
+            const agents = await listAgentDefinitionsForCaller({
+                userAgents: opts.getUserAgents(),
+                systemAgents: opts.getSystemAgents(),
+                getCallerOwnerKey: () => opts.getCallerOwnerKey(invocation?.durableSessionId),
+                systemOnly: args.systemOnly === true,
+            });
+            return JSON.stringify({ agents, total: agents.length }, null, 2);
+        },
+    });
+}
+//# sourceMappingURL=agent-discovery.js.map

package/dist/agent-discovery.js.map

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

package/dist/client.d.ts

@@ -136,6 +136,12 @@ export declare class PilotSwarmClient {
     start(): Promise<void>;
     private _resolveCreationModel;
     stop(): Promise<void>;
+    /**
+     * Creation and first send may land on different API processes. Restore the
+     * child boundary from durable lineage before starting an orchestration;
+     * otherwise the child silently becomes a root with a reset nesting budget.
+     */
+    private _restoreLineageForStart;
     /** @internal — ensure orchestration exists, update CMS, enqueue prompt. */
     private _ensureOrchestrationAndSend;
     /** @internal */
@@ -162,7 +168,9 @@ export declare class PilotSwarmClient {
     /** @internal */
     private _getLatestResponse;
     /** @internal */
-    _getSessionInfo(sessionId: string): Promise<PilotSwarmSessionInfo>;
+    _getSessionInfo(sessionId: string, options?: {
+        includeResultSource?: boolean;
+    }): Promise<PilotSwarmSessionInfo>;
     /** @internal */
     private _waitForTurnResult;
 }

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -13,6 +13,7 @@ import { createRequire } from "node:module";
 const require = createRequire(import.meta.url);
 const { SqliteProvider, Client } = require("duroxide");
 const WAIT_POLL_SLICE_MS = 10_000;
+const MAX_SESSION_LINEAGE_HOPS = 128;
 function createAbortError(message, reason) {
     if (reason instanceof Error)
         return reason;
@@ -70,6 +71,11 @@ export function projectSerializableSessionConfig(fullConfig, fallbackWaitThresho
         workingDirectory: fullConfig?.workingDirectory,
         waitThreshold: fullConfig?.waitThreshold ?? fallbackWaitThreshold,
         boundAgentName: fullConfig?.boundAgentName,
+        boundAgentPackageId: fullConfig?.boundAgentPackageId,
+        boundAgentSource: fullConfig?.boundAgentSource,
+        ...(fullConfig?.namedAgentToolAdditions !== undefined
+            ? { namedAgentToolAdditions: fullConfig.namedAgentToolAdditions } : {}),
+        detachedPackageToolPolicy: fullConfig?.detachedPackageToolPolicy,
         promptLayering: fullConfig?.promptLayering,
         childContract: fullConfig?.childContract,
         toolNames: allNames.length ? allNames : undefined,
@@ -155,6 +161,13 @@ export class PilotSwarmClient {
                 contextTier: resolvedConfig.contextTier,
                 systemMessage: resolvedConfig.systemMessage,
                 boundAgentName: resolvedConfig.boundAgentName,
+                boundAgentPackageId: resolvedConfig.boundAgentPackageId,
+                boundAgentSource: resolvedConfig.boundAgentSource,
+                ...(!isSubAgent && (resolvedConfig.boundAgentName || agentId) ? {
+                    namedAgentToolAdditions: resolvedConfig.namedAgentToolAdditions
+                        ?? projectSerializableSessionConfig(resolvedConfig, undefined).toolNames ?? [],
+                } : {}),
+                detachedPackageToolPolicy: resolvedConfig.detachedPackageToolPolicy,
                 promptLayering: resolvedConfig.promptLayering,
                 childContract: resolvedConfig.childContract,
                 tools: resolvedConfig.tools,
@@ -177,11 +190,15 @@ export class PilotSwarmClient {
             contextTier: resolvedConfig.contextTier ?? undefined,
             modelResolutionSource: resolved?.source,
             parentSessionId: config?.parentSessionId,
+            ...(agentId ? { agentId } : {}),
             owner: config?.owner ?? null,
             groupId: config?.groupId ?? null,
             visibility: config?.visibility ?? null,
             creationConfig: configForRow
-                ? JSON.parse(JSON.stringify(projectSerializableSessionConfig(configForRow, this.config.waitThreshold)))
+                ? {
+                    ...JSON.parse(JSON.stringify(projectSerializableSessionConfig(configForRow, this.config.waitThreshold))),
+                    ...(config?.nestingLevel !== undefined ? { bootstrapNestingLevel: config.nestingLevel } : {}),
+                }
                 : null,
         });
         if (resolved) {
@@ -554,6 +571,50 @@ export class PilotSwarmClient {
         this.started = false;
     }
     // ─── Internal ────────────────────────────────────────────
+    /**
+     * Creation and first send may land on different API processes. Restore the
+     * child boundary from durable lineage before starting an orchestration;
+     * otherwise the child silently becomes a root with a reset nesting budget.
+     */
+    async _restoreLineageForStart(sessionId, row, bootstrapNestingLevel) {
+        const invalid = (detail) => Object.assign(new Error(`Cannot restore session lineage for "${sessionId}": ${detail}`), { code: "SESSION_LINEAGE_INVALID" });
+        if (!row)
+            throw invalid("the session is missing from the catalog.");
+        const parentSessionId = row.parentSessionId || undefined;
+        const visited = new Set([sessionId]);
+        let current = row;
+        let depth = 0;
+        while (current.parentSessionId) {
+            const parentId = current.parentSessionId;
+            if (visited.has(parentId))
+                throw invalid(`a parent cycle includes "${parentId}".`);
+            if (depth >= MAX_SESSION_LINEAGE_HOPS)
+                throw invalid(`the parent chain exceeds ${MAX_SESSION_LINEAGE_HOPS} hops.`);
+            visited.add(parentId);
+            const parent = await this._catalog.getSession(parentId);
+            if (!parent)
+                throw invalid(`parent session "${parentId}" is missing from the catalog.`);
+            current = parent;
+            depth++;
+        }
+        // Logical depth can differ from physical ancestry (managed system
+        // sessions start their own delegation budget). Preserve an explicit
+        // create depth across processes; older rows fall back to ancestry.
+        if (bootstrapNestingLevel !== undefined
+            && (typeof bootstrapNestingLevel !== "number" || !Number.isSafeInteger(bootstrapNestingLevel) || bootstrapNestingLevel < 0)) {
+            throw invalid("the stored bootstrap nesting level must be a non-negative integer.");
+        }
+        const nestingLevel = this.nestingLevels.get(sessionId) ?? bootstrapNestingLevel ?? depth;
+        if (!Number.isSafeInteger(nestingLevel) || nestingLevel < 0) {
+            throw invalid("the explicit nesting level must be a non-negative integer.");
+        }
+        if (parentSessionId)
+            this.parentSessionIds.set(sessionId, parentSessionId);
+        else
+            this.parentSessionIds.delete(sessionId);
+        this.nestingLevels.set(sessionId, nestingLevel);
+        return { parentSessionId, nestingLevel };
+    }
     /** @internal — ensure orchestration exists, update CMS, enqueue prompt. */
     async _ensureOrchestrationAndSend(sessionId, prompt, opts) {
         if (!this.duroxideClient)
@@ -585,12 +646,21 @@ export class PilotSwarmClient {
         // waitThreshold must inherit the row's creation-time value, not this
         // process's default. The default applies only if neither side set it.
         let serializableConfig;
+        let bootstrapNestingLevel;
         trace(`[client] ensureOrchestrationAndSend start session=${sessionId} active=${this.activeOrchestrations.has(sessionId)}`);
         const cmsRow = await this._catalog.getSession(sessionId);
         {
             const stored = this._catalog.getSessionCreationConfig
-                ? await this._catalog.getSessionCreationConfig(sessionId).catch(() => null)
+                ? await this._catalog.getSessionCreationConfig(sessionId).catch(error => {
+                    // Missing legacy metadata is supported; an unreadable start
+                    // record cannot silently reset a persisted delegation budget.
+                    if (!this.activeOrchestrations.has(sessionId))
+                        throw error;
+                    return null;
+                })
                 : null;
+            const { bootstrapNestingLevel: storedDepth, ...storedSessionConfig } = stored ?? {};
+            bootstrapNestingLevel = storedDepth;
             if (stored && !fullConfig) {
                 trace(`[client] creation config restored from catalog row (in-memory config miss)`);
             }
@@ -598,9 +668,16 @@ export class PilotSwarmClient {
                 ? JSON.parse(JSON.stringify(projectSerializableSessionConfig(fullConfig, undefined)))
                 : {};
             const merged = {
-                ...(stored ?? {}),
+                ...storedSessionConfig,
                 ...overrides,
             };
+            // A partial resume may explicitly replace root tool additions before
+            // the first message, while retaining its durable named binding.
+            if ((merged.boundAgentName || merged.namedAgentToolAdditions !== undefined) && !cmsRow?.parentSessionId && fullConfig
+                && fullConfig.namedAgentToolAdditions === undefined
+                && (fullConfig.toolNames !== undefined || fullConfig.tools !== undefined)) {
+                merged.namedAgentToolAdditions = overrides.toolNames ?? [];
+            }
             if (merged.waitThreshold == null)
                 merged.waitThreshold = this.config.waitThreshold;
             serializableConfig = merged;
@@ -629,8 +706,10 @@ export class PilotSwarmClient {
             }
         }
         if (!this.activeOrchestrations.has(sessionId)) {
-            const parentSessionId = this.parentSessionIds.get(sessionId);
-            const nestingLevel = this.nestingLevels.get(sessionId);
+            const { parentSessionId, nestingLevel } = await this._restoreLineageForStart(sessionId, cmsRow, bootstrapNestingLevel);
+            // Explicit local identity keeps its precedence; another process
+            // reconstructs the named agent's startup contract from the row.
+            const agentId = this.sessionAgentIds.get(sessionId) ?? cmsRow?.agentId;
             const input = {
                 sessionId,
                 config: serializableConfig,
@@ -650,7 +729,7 @@ export class PilotSwarmClient {
                 ...(parentSessionId ? { parentSessionId } : {}),
                 ...(nestingLevel != null ? { nestingLevel } : {}),
                 ...(this.systemSessions.has(sessionId) ? { isSystem: true } : {}),
-                ...(this.sessionAgentIds.has(sessionId) ? { agentId: this.sessionAgentIds.get(sessionId) } : {}),
+                ...(agentId ? { agentId } : {}),
                 ...(this._sessionPolicy ? { sessionPolicy: this._sessionPolicy } : {}),
                 ...(this._allowedAgentNames.length > 0 ? { allowedAgentNames: this._allowedAgentNames } : {}),
             };
@@ -758,7 +837,7 @@ export class PilotSwarmClient {
         }
     }
     /** @internal */
-    async _getSessionInfo(sessionId) {
+    async _getSessionInfo(sessionId, options) {
         const cmsRow = await this._catalog.getSession(sessionId);
         // Merge with live customStatus for real-time fields
         const orchestrationId = `session-${sessionId}`;
@@ -852,6 +931,11 @@ export class PilotSwarmClient {
         const effectiveError = (status === "error" || status === "failed")
             ? (orchStatus.status === "Failed" ? orchStatus.error : (cmsRow?.lastError ?? undefined))
             : undefined;
+        const completedResponse = customStatus.turnResult?.type === "completed"
+            ? customStatus.turnResult
+            : latestResponse?.type === "completed" ? latestResponse : undefined;
+        const resultSource = completedResponse ? "response"
+            : orchStatus.status === "Completed" ? "orchestration" : undefined;
         return {
             sessionId,
             status,
@@ -882,11 +966,9 @@ export class PilotSwarmClient {
             contextUsage: customStatus?.contextUsage && typeof customStatus.contextUsage === "object"
                 ? customStatus.contextUsage
                 : undefined,
-            result: customStatus.turnResult?.type === "completed"
-                ? customStatus.turnResult.content
-                : latestResponse?.type === "completed"
-                    ? latestResponse.content
-                    : (orchStatus.status === "Completed" ? orchStatus.output : undefined),
+            result: completedResponse ? completedResponse.content
+                : (orchStatus.status === "Completed" ? orchStatus.output : undefined),
+            ...(options?.includeResultSource && resultSource ? { resultSource } : {}),
             error: effectiveError,
         };
     }