@stigmer/runner 3.0.1

package/dist/activities/execute-deep-agent/subagent-transformer.d.ts

@@ -0,0 +1,150 @@
+/**
+ * SubAgent transformation and compilation.
+ *
+ * Transforms proto SubAgent definitions into CompiledSubAgent instances for
+ * the deepagents JS runtime. Each compiled subagent is a pre-compiled graph
+ * with its own middleware stack (loop detection, budget, truncation, cost cap)
+ * and concurrency gating via SubAgentGate.
+ *
+ * Design decisions:
+ * - CompiledSubAgent format: full middleware control, no unwanted deepagents defaults
+ * - Filter parent MCP tools: no reconnection overhead, stateless servers are the norm
+ * - Prompt injection for skills: FilesystemBackend incompatible with native skills field
+ * - Built-in explore/shell subagents use prompt-based tool restriction
+ * - Invalid configurations are logged and skipped (graceful degradation)
+ * - Empty subagent list returns null (no subagents configured)
+ */
+import type { CompiledSubAgent } from "deepagents";
+import type { StructuredTool } from "@langchain/core/tools";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { SubAgent, McpServerUsage } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
+import type { WorkspaceBackend } from "../../shared/workspace/types.js";
+import type { StigmerClient } from "../../client/stigmer-client.js";
+import type { MergedToolPolicy } from "../../shared/approval-policy.js";
+import type { CostCapMiddleware } from "../../middleware/index.js";
+export declare const BUILTIN_SUBAGENT_TYPES: ReadonlySet<string>;
+/**
+ * Intermediate representation of a transformed subagent before compilation.
+ * Contains all the data needed to create a compiled agent graph.
+ */
+export interface TransformedSubagent {
+    readonly name: string;
+    readonly description: string;
+    readonly systemPrompt: string;
+    readonly tools: StructuredTool[];
+    readonly model?: string;
+}
+/**
+ * Options for the full subagent transformation and compilation pipeline.
+ */
+export interface SubagentTransformOptions {
+    readonly subAgents: readonly SubAgent[];
+    readonly parentMcpTools: readonly StructuredTool[];
+    readonly parentMcpServerToolMap: ReadonlyMap<string, readonly StructuredTool[]>;
+    readonly parentMcpUsages: readonly McpServerUsage[];
+    readonly skillClient: StigmerClient;
+    readonly workspaceBackend: WorkspaceBackend;
+    readonly approvalPolicies: ReadonlyMap<string, MergedToolPolicy>;
+    readonly autoApproveAll: boolean;
+    readonly parentModelName: string;
+    readonly parentHasNativeThinking: boolean;
+    readonly costCap?: CostCapMiddleware;
+    /**
+     * Builds a configured chat-model instance for a given model name. When
+     * provided, sub-agents are compiled with the same proxy-aware model client
+     * as the parent (base URL, auth headers, API key). When absent (unit tests),
+     * the model name string is passed to deepagents directly.
+     */
+    readonly modelFactory?: (modelName: string) => BaseChatModel;
+}
+/**
+ * Create built-in explore and shell subagent specifications.
+ *
+ * Built-in subagents receive:
+ * - The full deepagents built-in tool set (from FilesystemBackend) restricted via prompt
+ * - Purpose-built system prompts with explicit scope boundaries
+ * - No skills, no MCP tools, no parent prompt inheritance
+ *
+ * Returns an empty array if no workspace is configured (subagents need
+ * workspace tools to be useful).
+ */
+export declare function createBuiltinSubagents(hasWorkspace: boolean): TransformedSubagent[];
+/**
+ * Transform a single SubAgent proto into the intermediate representation.
+ *
+ * Handles: proto field extraction, model override validation, think tool
+ * injection, and response rules appending. MCP filtering and skill
+ * resolution are handled separately and composed by the caller.
+ *
+ * Returns null if the subagent should be skipped (e.g., invalid model override).
+ */
+export declare function transformSingleSubagent(subAgent: SubAgent, opts: {
+    readonly parentMcpTools: readonly StructuredTool[];
+    readonly parentMcpServerToolMap: ReadonlyMap<string, readonly StructuredTool[]>;
+    readonly parentMcpUsages: readonly McpServerUsage[];
+    readonly parentHasNativeThinking: boolean;
+    readonly parentModelName: string;
+}): Promise<TransformedSubagent | null>;
+/**
+ * Filter parent MCP tools based on a subagent's McpAccess grants.
+ *
+ * Permission model:
+ * - Subagent can only access MCP servers explicitly listed in its mcpAccess
+ * - Tool names must be a subset of parent's enabled tools for that server
+ * - Empty enabledTools in McpAccess = inherit all parent tools for that server
+ * - Invalid slug or missing server → warn and skip
+ */
+export declare function filterMcpToolsForSubagent(mcpAccess: readonly {
+    mcpServer: string;
+    enabledTools: readonly string[];
+}[], parentMcpServerToolMap: ReadonlyMap<string, readonly StructuredTool[]>, parentMcpUsages: readonly McpServerUsage[]): StructuredTool[];
+/**
+ * Collect all unique skill refs across all subagents for batch fetching.
+ *
+ * Deduplicates by slug to minimize gRPC calls. Returns an array of refs
+ * and the mapping from slug to original refs for distribution.
+ */
+export declare function collectAllSkillRefs(subAgents: readonly SubAgent[]): {
+    slug: string;
+    ref: unknown;
+}[];
+/**
+ * Resolve skills for a single subagent and return the prompt section.
+ *
+ * Looks up each of the subagent's skill_refs in the pre-fetched skills
+ * collection and generates a prompt section containing activation
+ * instructions and file paths.
+ *
+ * Returns empty string if no skills match or if the subagent has no skill_refs.
+ */
+export declare function resolveSubagentSkillPrompt(subAgent: SubAgent, skillsBySlug: ReadonlyMap<string, {
+    skill: unknown;
+    path: string;
+}>): string;
+/**
+ * Compile transformed subagent specifications into CompiledSubAgent instances.
+ *
+ * Each subagent gets:
+ * - Its own agent graph (via createDeepAgent with FilesystemBackend sharing the workspace)
+ * - Per-subagent middleware (loop detection, budget, truncation, cost cap view)
+ * - Concurrency gating via shared SubAgentGate
+ */
+export declare function compileSubagents(transformed: readonly TransformedSubagent[], opts: {
+    readonly costCap?: CostCapMiddleware;
+    readonly parentModelName: string;
+    readonly workspaceRootDir: string;
+    readonly modelFactory?: (modelName: string) => BaseChatModel;
+}): Promise<CompiledSubAgent[]>;
+/**
+ * Transform proto SubAgents and compile into CompiledSubAgent instances.
+ *
+ * This is the main entry point called from setup.ts. It orchestrates:
+ * 1. Built-in subagent creation (explore + shell)
+ * 2. Per-subagent transformation (proto → TransformedSubagent)
+ * 3. MCP tool filtering per subagent
+ * 4. Skill resolution and prompt injection (Session 2)
+ * 5. Compilation with middleware + gate wrapping
+ *
+ * Returns null if no valid subagents after transformation.
+ */
+export declare function transformAndCompileSubagents(options: SubagentTransformOptions): Promise<CompiledSubAgent[] | null>;

package/dist/activities/execute-deep-agent/subagent-transformer.js

@@ -0,0 +1,450 @@
+/**
+ * SubAgent transformation and compilation.
+ *
+ * Transforms proto SubAgent definitions into CompiledSubAgent instances for
+ * the deepagents JS runtime. Each compiled subagent is a pre-compiled graph
+ * with its own middleware stack (loop detection, budget, truncation, cost cap)
+ * and concurrency gating via SubAgentGate.
+ *
+ * Design decisions:
+ * - CompiledSubAgent format: full middleware control, no unwanted deepagents defaults
+ * - Filter parent MCP tools: no reconnection overhead, stateless servers are the norm
+ * - Prompt injection for skills: FilesystemBackend incompatible with native skills field
+ * - Built-in explore/shell subagents use prompt-based tool restriction
+ * - Invalid configurations are logged and skipped (graceful degradation)
+ * - Empty subagent list returns null (no subagents configured)
+ */
+import { createDeepAgent, FilesystemBackend } from "deepagents";
+import { createThinkTool } from "../../middleware/index.js";
+import { buildSubAgentMiddleware } from "./subagent-wiring.js";
+import { SubAgentGate } from "../../shared/subagent-gate.js";
+import { isModelRegistered } from "../../shared/model-registry.js";
+import { fetchSkillsByRefs, fetchSkillArtifacts, writeSkills, generatePromptSection, } from "../../shared/skill-writer.js";
+// =========================================================================
+// Built-in subagent types and prompts
+// =========================================================================
+export const BUILTIN_SUBAGENT_TYPES = new Set(["explore", "shell"]);
+const EXPLORE_SYSTEM_PROMPT = `\
+You are an exploration specialist. Your ONLY job is to explore codebases \
+and report findings back to the parent agent.
+
+STRICT BOUNDARIES:
+- Use ONLY the read-only tools provided (read_file, list_dir, glob, grep, search)
+- Do NOT write files, create files, or modify anything
+- Do NOT execute shell commands
+- Do NOT follow skill activation instructions from any context
+- Do NOT create deliverables, scaffolds, or run initialization scripts
+- Report your findings concisely — the parent agent has direct file access
+
+Your task: {description}`;
+const SHELL_SYSTEM_PROMPT = `\
+You are a command execution specialist. Your ONLY job is to run shell \
+commands and report the results back to the parent agent.
+
+STRICT BOUNDARIES:
+- Use ONLY the tools provided (execute, read_file, list_dir)
+- Do NOT write or modify files directly — use shell commands if needed
+- Do NOT search extensively or explore the codebase beyond what is needed
+- Do NOT follow skill activation instructions from any context
+- Do NOT create deliverables, scaffolds, or run initialization scripts
+- Report command output concisely — the parent agent will interpret results
+
+Your task: {description}`;
+const BUILTIN_DESCRIPTIONS = new Map([
+    ["explore", ("Read-only codebase exploration specialist. Use for searching, " +
+            "reading files, finding patterns, and understanding code structure. " +
+            "Cannot write files or execute commands.")],
+    ["shell", ("Command execution specialist. Use for running shell commands, " +
+            "build operations, and system tasks. Has minimal file read access.")],
+]);
+const BUILTIN_PROMPTS = new Map([
+    ["explore", EXPLORE_SYSTEM_PROMPT],
+    ["shell", SHELL_SYSTEM_PROMPT],
+]);
+const RESPONSE_RULES = `\
+
+## Response rules
+
+- After using the read tool, NEVER reprint, echo, list, or \
+summarize file contents in your response. Tool results are \
+already in your context. Proceed directly to the task.
+- Your response is returned to the parent agent as a task \
+result. Return concise findings and actionable results — not \
+raw file contents. The parent agent has direct access to the \
+same files.
+- Do not begin responses with phrases like \
+"Below is the complete content", \
+"Here are the contents of the files", or similar.
+`;
+// =========================================================================
+// Built-in subagent creation
+// =========================================================================
+/**
+ * Create built-in explore and shell subagent specifications.
+ *
+ * Built-in subagents receive:
+ * - The full deepagents built-in tool set (from FilesystemBackend) restricted via prompt
+ * - Purpose-built system prompts with explicit scope boundaries
+ * - No skills, no MCP tools, no parent prompt inheritance
+ *
+ * Returns an empty array if no workspace is configured (subagents need
+ * workspace tools to be useful).
+ */
+export function createBuiltinSubagents(hasWorkspace) {
+    if (!hasWorkspace) {
+        return [];
+    }
+    const result = [];
+    for (const subagentType of ["explore", "shell"]) {
+        const prompt = BUILTIN_PROMPTS.get(subagentType);
+        const description = BUILTIN_DESCRIPTIONS.get(subagentType);
+        if (!prompt || !description)
+            continue;
+        result.push({
+            name: subagentType,
+            description,
+            systemPrompt: prompt + RESPONSE_RULES,
+            tools: [],
+        });
+    }
+    return result;
+}
+// =========================================================================
+// Single subagent transformation
+// =========================================================================
+/**
+ * Transform a single SubAgent proto into the intermediate representation.
+ *
+ * Handles: proto field extraction, model override validation, think tool
+ * injection, and response rules appending. MCP filtering and skill
+ * resolution are handled separately and composed by the caller.
+ *
+ * Returns null if the subagent should be skipped (e.g., invalid model override).
+ */
+export async function transformSingleSubagent(subAgent, opts) {
+    const name = subAgent.name;
+    const description = subAgent.description || `Sub-agent: ${name}`;
+    let systemPrompt = subAgent.instructions || "";
+    // Validate model_override if specified
+    let model;
+    if (subAgent.modelOverride) {
+        const isKnown = await isModelRegistered(subAgent.modelOverride);
+        if (!isKnown) {
+            console.error(`[subagent-transformer] Sub-agent '${name}' specifies model_override='${subAgent.modelOverride}' ` +
+                `which is not recognised by the ModelRegistry. Skipping this sub-agent. ` +
+                `Use a registered model name (e.g. 'claude-haiku-4.5') or a valid API model ID.`);
+            return null;
+        }
+        model = subAgent.modelOverride;
+    }
+    // Build tools list — start with filtered MCP tools (populated by caller)
+    const tools = [];
+    // Inject think tool when model lacks native extended thinking
+    const saHasNativeThinking = model
+        ? await _modelSupportsThinking(model)
+        : opts.parentHasNativeThinking;
+    if (!saHasNativeThinking) {
+        tools.push(createThinkTool());
+    }
+    // Append response rules
+    systemPrompt += RESPONSE_RULES;
+    return { name, description, systemPrompt, tools, model };
+}
+// =========================================================================
+// MCP tool filtering
+// =========================================================================
+/**
+ * Filter parent MCP tools based on a subagent's McpAccess grants.
+ *
+ * Permission model:
+ * - Subagent can only access MCP servers explicitly listed in its mcpAccess
+ * - Tool names must be a subset of parent's enabled tools for that server
+ * - Empty enabledTools in McpAccess = inherit all parent tools for that server
+ * - Invalid slug or missing server → warn and skip
+ */
+export function filterMcpToolsForSubagent(mcpAccess, parentMcpServerToolMap, parentMcpUsages) {
+    if (mcpAccess.length === 0)
+        return [];
+    const usageSlugs = new Set(parentMcpUsages
+        .map((u) => u.mcpServerRef?.slug)
+        .filter((s) => !!s));
+    const filtered = [];
+    for (const access of mcpAccess) {
+        const slug = access.mcpServer;
+        if (!slug) {
+            console.warn("[subagent-transformer] McpAccess has empty mcp_server slug, skipping");
+            continue;
+        }
+        if (!usageSlugs.has(slug)) {
+            console.warn(`[subagent-transformer] SubAgent references unknown MCP server '${slug}' ` +
+                "(not in parent's mcp_server_usages), skipping");
+            continue;
+        }
+        const serverTools = parentMcpServerToolMap.get(slug);
+        if (!serverTools || serverTools.length === 0) {
+            console.warn(`[subagent-transformer] MCP server '${slug}' has no tools in parent's connection, skipping`);
+            continue;
+        }
+        if (access.enabledTools.length === 0) {
+            filtered.push(...serverTools);
+        }
+        else {
+            const allowedNames = new Set(access.enabledTools);
+            for (const tool of serverTools) {
+                if (allowedNames.has(tool.name)) {
+                    filtered.push(tool);
+                }
+                else if (allowedNames.has(tool.name)) {
+                    // already included
+                }
+            }
+            const parentToolNames = new Set(serverTools.map((t) => t.name));
+            for (const requestedTool of access.enabledTools) {
+                if (!parentToolNames.has(requestedTool)) {
+                    console.warn(`[subagent-transformer] SubAgent requests tool '${requestedTool}' from server '${slug}' ` +
+                        "but it's not in parent's enabled tools, skipping tool");
+                }
+            }
+        }
+    }
+    return filtered;
+}
+// =========================================================================
+// Skill resolution for subagents
+// =========================================================================
+/**
+ * Collect all unique skill refs across all subagents for batch fetching.
+ *
+ * Deduplicates by slug to minimize gRPC calls. Returns an array of refs
+ * and the mapping from slug to original refs for distribution.
+ */
+export function collectAllSkillRefs(subAgents) {
+    const seen = new Set();
+    const unique = [];
+    for (const sa of subAgents) {
+        for (const ref of sa.skillRefs) {
+            const slug = ref.slug;
+            if (slug && !seen.has(slug)) {
+                seen.add(slug);
+                unique.push({ slug, ref });
+            }
+        }
+    }
+    return unique;
+}
+/**
+ * Resolve skills for a single subagent and return the prompt section.
+ *
+ * Looks up each of the subagent's skill_refs in the pre-fetched skills
+ * collection and generates a prompt section containing activation
+ * instructions and file paths.
+ *
+ * Returns empty string if no skills match or if the subagent has no skill_refs.
+ */
+export function resolveSubagentSkillPrompt(subAgent, skillsBySlug) {
+    if (subAgent.skillRefs.length === 0)
+        return "";
+    const matchedSkills = [];
+    const matchedPaths = new Map();
+    for (const ref of subAgent.skillRefs) {
+        const slug = ref.slug;
+        if (!slug)
+            continue;
+        const entry = skillsBySlug.get(slug);
+        if (entry) {
+            matchedSkills.push(entry.skill);
+            const id = entry.skill.metadata?.id;
+            if (id)
+                matchedPaths.set(id, entry.path);
+        }
+    }
+    if (matchedSkills.length === 0)
+        return "";
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return generatePromptSection(matchedSkills, matchedPaths);
+}
+// =========================================================================
+// Compilation pipeline
+// =========================================================================
+/**
+ * Compile transformed subagent specifications into CompiledSubAgent instances.
+ *
+ * Each subagent gets:
+ * - Its own agent graph (via createDeepAgent with FilesystemBackend sharing the workspace)
+ * - Per-subagent middleware (loop detection, budget, truncation, cost cap view)
+ * - Concurrency gating via shared SubAgentGate
+ */
+export async function compileSubagents(transformed, opts) {
+    if (transformed.length === 0)
+        return [];
+    const gate = new SubAgentGate();
+    const compiled = [];
+    for (const spec of transformed) {
+        try {
+            const middleware = buildSubAgentMiddleware({
+                costCap: opts.costCap,
+            });
+            const modelName = spec.model ?? opts.parentModelName;
+            // Use a configured model instance (proxy base URL + auth) when a
+            // factory is supplied so sub-agent LLM calls route through the same
+            // proxy as the parent. Falling back to the bare name lets deepagents
+            // construct a default client (unit tests / no-proxy paths).
+            const model = opts.modelFactory ? opts.modelFactory(modelName) : modelName;
+            const agentGraph = await createDeepAgent({
+                model,
+                systemPrompt: spec.systemPrompt,
+                tools: spec.tools.length > 0 ? spec.tools : undefined,
+                middleware: middleware,
+                backend: new FilesystemBackend({ rootDir: opts.workspaceRootDir }),
+                generalPurposeAgent: false,
+            });
+            const gatedRunnable = gate.wrapRunnable(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            agentGraph, spec.name);
+            compiled.push({
+                name: spec.name,
+                description: spec.description,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                runnable: gatedRunnable,
+            });
+            console.log(`[subagent-transformer] Compiled sub-agent '${spec.name}' ` +
+                `(model=${modelName}, tools=${spec.tools.length})`);
+        }
+        catch (err) {
+            console.error(`[subagent-transformer] Failed to compile sub-agent '${spec.name}': ${err}`);
+        }
+    }
+    return compiled;
+}
+// =========================================================================
+// Top-level orchestrator
+// =========================================================================
+/**
+ * Transform proto SubAgents and compile into CompiledSubAgent instances.
+ *
+ * This is the main entry point called from setup.ts. It orchestrates:
+ * 1. Built-in subagent creation (explore + shell)
+ * 2. Per-subagent transformation (proto → TransformedSubagent)
+ * 3. MCP tool filtering per subagent
+ * 4. Skill resolution and prompt injection (Session 2)
+ * 5. Compilation with middleware + gate wrapping
+ *
+ * Returns null if no valid subagents after transformation.
+ */
+export async function transformAndCompileSubagents(options) {
+    const { subAgents, parentMcpTools, parentMcpServerToolMap, parentMcpUsages, skillClient, workspaceBackend, parentModelName, parentHasNativeThinking, costCap, modelFactory, } = options;
+    if (subAgents.length === 0 && !workspaceBackend.rootDir) {
+        return null;
+    }
+    console.log(`[subagent-transformer] Transforming ${subAgents.length} proto sub-agent(s)` +
+        (workspaceBackend.rootDir ? " + built-in types" : ""));
+    // Step 1: Create built-in subagents
+    const builtins = createBuiltinSubagents(!!workspaceBackend.rootDir);
+    // Step 1b: Batch fetch all skills referenced by subagents
+    const allSkillRefs = collectAllSkillRefs(subAgents);
+    const skillsBySlug = new Map();
+    if (allSkillRefs.length > 0) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const refs = allSkillRefs.map((r) => r.ref);
+            const skills = await fetchSkillsByRefs(skillClient, refs);
+            if (skills.length > 0) {
+                const artifacts = await fetchSkillArtifacts(skillClient, skills);
+                const { paths: skillPaths } = await writeSkills(skills, workspaceBackend, artifacts);
+                for (const skill of skills) {
+                    const slug = skill.metadata?.slug;
+                    const id = skill.metadata?.id;
+                    if (slug && id) {
+                        skillsBySlug.set(slug, { skill, path: skillPaths.get(id) ?? "" });
+                    }
+                }
+                console.log(`[subagent-transformer] Fetched ${skills.length} skill(s) for subagents`);
+            }
+        }
+        catch (err) {
+            console.error(`[subagent-transformer] Failed to fetch skills for subagents: ${err}`);
+        }
+    }
+    // Step 2: Transform proto subagents
+    const transformed = [];
+    for (const subAgent of subAgents) {
+        if (BUILTIN_SUBAGENT_TYPES.has(subAgent.name)) {
+            console.warn(`[subagent-transformer] Sub-agent name '${subAgent.name}' conflicts with ` +
+                "built-in type. The proto definition will override the built-in.");
+        }
+        try {
+            const result = await transformSingleSubagent(subAgent, {
+                parentMcpTools,
+                parentMcpServerToolMap,
+                parentMcpUsages,
+                parentHasNativeThinking,
+                parentModelName,
+            });
+            if (result) {
+                // Apply MCP filtering for this subagent
+                const mcpTools = filterMcpToolsForSubagent(subAgent.mcpAccess, parentMcpServerToolMap, parentMcpUsages);
+                // Resolve skills prompt section for this subagent
+                const skillsSection = resolveSubagentSkillPrompt(subAgent, skillsBySlug);
+                const enhancedPrompt = skillsSection
+                    ? result.systemPrompt.replace(RESPONSE_RULES, skillsSection + RESPONSE_RULES)
+                    : result.systemPrompt;
+                transformed.push({
+                    ...result,
+                    systemPrompt: enhancedPrompt,
+                    tools: [...mcpTools, ...result.tools],
+                });
+            }
+        }
+        catch (err) {
+            console.error(`[subagent-transformer] Failed to transform sub-agent '${subAgent.name}': ${err}`);
+        }
+    }
+    // Step 3: Merge built-ins with transformed (proto overrides take precedence)
+    const protoNames = new Set(transformed.map((t) => t.name));
+    const allSpecs = [
+        ...builtins.filter((b) => !protoNames.has(b.name)),
+        ...transformed,
+    ];
+    if (allSpecs.length === 0) {
+        console.warn("[subagent-transformer] No valid subagents after transformation");
+        return null;
+    }
+    // Step 4: Compile all subagents
+    const compiled = await compileSubagents(allSpecs, {
+        costCap,
+        parentModelName,
+        workspaceRootDir: workspaceBackend.rootDir,
+        modelFactory,
+    });
+    if (compiled.length === 0) {
+        console.warn("[subagent-transformer] No subagents compiled successfully");
+        return null;
+    }
+    console.log(`[subagent-transformer] Successfully compiled ${compiled.length} sub-agent(s)`);
+    return compiled;
+}
+// =========================================================================
+// Private helpers
+// =========================================================================
+/**
+ * Check if a model supports native extended thinking.
+ *
+ * Heuristic: models with "claude" in the name that are NOT haiku-class
+ * support thinking. Models with "o1", "o3", "o4" support reasoning.
+ * This is a conservative heuristic — err on the side of injecting the
+ * think tool (it's harmless if the model already thinks natively).
+ */
+async function _modelSupportsThinking(modelId) {
+    const lower = modelId.toLowerCase();
+    if (lower.includes("haiku"))
+        return false;
+    if (lower.includes("gpt-4o-mini"))
+        return false;
+    if (lower.includes("claude") && (lower.includes("sonnet") || lower.includes("opus")))
+        return true;
+    if (lower.includes("o1") || lower.includes("o3") || lower.includes("o4")) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=subagent-transformer.js.map

package/dist/activities/execute-deep-agent/subagent-transformer.js.map

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

package/dist/activities/execute-deep-agent/subagent-wiring.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Sub-agent middleware composition for ExecuteDeepAgent.
+ *
+ * Each sub-agent gets its own middleware stack with:
+ * - Fresh loop detection (independent cycle tracking)
+ * - Fresh tool truncation (same limits as parent)
+ * - Periodic execution budget (interval=30, max=4 advisories)
+ * - Shared cost cap view (parent's budget, no reset on sub-agent start)
+ *
+ * The sub-agent middleware stack does NOT include:
+ * - Graceful stop (parent handles STOP signal propagation)
+ * - OTel spans (parent's OTel context propagates automatically)
+ * - Error hints (applied at tool level, not sub-agent level)
+ * - Approval gate (sub-agent interrupts propagate to parent checkpoint)
+ */
+import type { StigmerMiddleware, ToolTruncationConfig } from "../../middleware/types.js";
+import type { CostCapMiddleware } from "../../middleware/index.js";
+export interface SubAgentMiddlewareOptions {
+    readonly costCap?: CostCapMiddleware;
+    readonly toolTruncation?: Partial<ToolTruncationConfig>;
+}
+/**
+ * Build the middleware stack for a single sub-agent.
+ *
+ * Returns an ordered array matching the Python `compile_subagent` composition:
+ * loop detection → execution budget (periodic) → tool truncation → cost cap view.
+ */
+export declare function buildSubAgentMiddleware(options?: SubAgentMiddlewareOptions): StigmerMiddleware[];