agentplane 0.3.12 → 0.3.14

package/dist/runner/context/base-prompt-sources.js

@@ -0,0 +1,144 @@
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { loadAgentTemplates, loadPolicyGatewayTemplate } from "../../agents/agents-template.js";
+import { fileExists } from "../../cli/fs-utils.js";
+import { resolveBehavior } from "../../runtime/behavior/index.js";
+import { resolvePolicyGatewayForRepo, } from "../../shared/policy-gateway.js";
+import { BASE_PROMPT_PRIORITIES, normalizeText, promptBlockFromResolved, promptCandidate, toPromptSource, validateJsonPrompt, } from "./prompt-block-shared.js";
+async function resolveRepoAgentProfilePath(opts) {
+    const agentsDir = path.join(opts.git_root, opts.agents_dir);
+    if (!(await fileExists(agentsDir)))
+        return null;
+    const entries = await readdir(agentsDir);
+    const wanted = `${opts.owner_id}.json`.toLowerCase();
+    const match = entries.find((entry) => entry.endsWith(".json") && entry.toLowerCase() === wanted);
+    if (!match)
+        return null;
+    return path.join(agentsDir, match);
+}
+export async function resolveOwnerProfilePromptSource(opts) {
+    const candidates = [];
+    const repoProfilePath = await resolveRepoAgentProfilePath(opts);
+    if (repoProfilePath) {
+        const source = toPromptSource(opts.git_root, repoProfilePath);
+        candidates.push(promptCandidate({
+            layer: "user",
+            source,
+            value: {
+                source,
+                title: `Owner Agent Profile (${opts.owner_id})`,
+                content: validateJsonPrompt(source, await readFile(repoProfilePath, "utf8")),
+            },
+        }));
+    }
+    const bundledFileName = `${opts.owner_id}.json`;
+    const bundledTemplates = await loadAgentTemplates();
+    const bundled = bundledTemplates.find((entry) => entry.fileName.toLowerCase() === bundledFileName.toLowerCase());
+    if (!bundled) {
+        throw new Error(`Bundled agent profile not found: ${bundledFileName}`);
+    }
+    candidates.push(promptCandidate({
+        layer: "builtin",
+        source: `bundled:agent-profile:${bundled.fileName}`,
+        value: {
+            source: `bundled:agent-profile:${bundled.fileName}`,
+            title: `Owner Agent Profile (${opts.owner_id})`,
+            content: validateJsonPrompt(`bundled:agent-profile:${bundled.fileName}`, bundled.contents),
+        },
+        order: 10,
+    }));
+    return resolveBehavior({
+        key: `runner.owner_profile:${opts.owner_id}`,
+        candidates,
+    });
+}
+export async function loadOwnerProfilePrompt(opts) {
+    const resolved = await resolveOwnerProfilePromptSource(opts);
+    return promptBlockFromResolved({
+        id: "base.owner_profile",
+        role: "profile",
+        priority: BASE_PROMPT_PRIORITIES.owner_profile,
+        resolved,
+    });
+}
+export async function resolvePolicyGatewayPromptSource(opts) {
+    const gateway = opts.harness?.repo.policy_gateway ??
+        (await resolvePolicyGatewayForRepo({
+            gitRoot: opts.git_root,
+            fallbackFlavor: opts.fallback_flavor,
+        }));
+    const candidates = [];
+    if (await fileExists(gateway.absPath)) {
+        const source = path.relative(opts.git_root, gateway.absPath).replaceAll("\\", "/");
+        candidates.push(promptCandidate({
+            layer: "harness",
+            source,
+            value: {
+                source,
+                title: `Repository Policy Gateway (${gateway.fileName})`,
+                content: normalizeText(await readFile(gateway.absPath, "utf8")),
+            },
+        }));
+    }
+    candidates.push(promptCandidate({
+        layer: "builtin",
+        source: `bundled:policy-gateway:${gateway.fileName}`,
+        value: {
+            source: `bundled:policy-gateway:${gateway.fileName}`,
+            title: `Bundled Policy Gateway Fallback (${gateway.fileName})`,
+            content: await loadPolicyGatewayTemplate(gateway.flavor),
+        },
+        order: 10,
+    }));
+    return resolveBehavior({
+        key: `runner.policy_gateway:${gateway.fileName}`,
+        candidates,
+    });
+}
+export async function loadPolicyGatewayPrompt(opts) {
+    const resolved = await resolvePolicyGatewayPromptSource(opts);
+    return promptBlockFromResolved({
+        id: "base.policy_gateway",
+        role: "policy",
+        priority: BASE_PROMPT_PRIORITIES.policy_gateway,
+        resolved,
+    });
+}
+function renderExecutionProfilePromptContent(runtime) {
+    return JSON.stringify({
+        profile: runtime.profile,
+        reasoning_effort: runtime.reasoning_effort,
+        budget: runtime.budget,
+        approvals: runtime.approvals,
+        stop_conditions: runtime.stop_conditions,
+        handoff_conditions: runtime.handoff_conditions,
+        unsafe_actions_requiring_explicit_user_ok: runtime.unsafe_actions_requiring_explicit_user_ok,
+        runner: runtime.runner,
+    }, null, 2);
+}
+export function loadExecutionProfilePrompt(opts) {
+    if (!opts.execution_profile)
+        return null;
+    const source = `runtime:execution-profile:${opts.execution_profile.profile}`;
+    const resolved = resolveBehavior({
+        key: "runner.execution_profile",
+        candidates: [
+            promptCandidate({
+                layer: "harness",
+                source,
+                value: {
+                    source,
+                    title: `Execution Profile Runtime (${opts.execution_profile.profile})`,
+                    content: normalizeText(renderExecutionProfilePromptContent(opts.execution_profile)),
+                },
+            }),
+        ],
+    });
+    return promptBlockFromResolved({
+        id: "base.execution_profile",
+        role: "policy",
+        priority: BASE_PROMPT_PRIORITIES.execution_profile,
+        resolved,
+    });
+}
+export { loadFrameworkRunnerPrompt } from "./prompt-block-shared.js";

package/dist/runner/context/base-prompts.d.ts

@@ -1,35 +1,17 @@
-import { type ResolvedBehavior } from "../../runtime/behavior/index.js";
-import { type PolicyGatewayFlavor } from "../../shared/policy-gateway.js";
 import type { ResolvedExecutionProfileRuntime } from "../../runtime/execution-profile/index.js";
 import type { ResolvedHarnessContract } from "../../runtime/harness/index.js";
-import type { RunnerPromptBlock, RunnerRecipeContext } from "../types.js";
-type PromptSourcePayload = {
-    source: string;
-    title: string;
-    content: string;
-};
-type PromptSourceTraceMetadata = {
-    title: string;
-};
-type ResolvedPromptSource = ResolvedBehavior<PromptSourcePayload, PromptSourceTraceMetadata>;
-export declare function resolveOwnerProfilePromptSource(opts: {
-    git_root: string;
-    agents_dir: string;
-    owner_id: string;
-}): Promise<ResolvedPromptSource>;
-export declare function resolvePolicyGatewayPromptSource(opts: {
-    git_root: string;
-    fallback_flavor: PolicyGatewayFlavor;
-    harness?: ResolvedHarnessContract;
-}): Promise<ResolvedPromptSource>;
+import type { RunnerPromptBlock, RunnerRecipeContext, RunnerTaskContext } from "../types.js";
+import type { PolicyGatewayFlavor } from "../../shared/policy-gateway.js";
+export { resolveOwnerProfilePromptSource, resolvePolicyGatewayPromptSource, } from "./base-prompt-sources.js";
 export declare function collectRunnerBasePrompts(opts: {
     git_root: string;
     owner_id: string;
     agents_dir?: string;
     fallback_policy_gateway_flavor?: PolicyGatewayFlavor;
+    task?: RunnerTaskContext;
+    command?: string;
     recipe?: RunnerRecipeContext;
     harness?: ResolvedHarnessContract;
     execution_profile?: ResolvedExecutionProfileRuntime;
 }): Promise<RunnerPromptBlock[]>;
-export {};
 //# sourceMappingURL=base-prompts.d.ts.map

package/dist/runner/context/base-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-prompts.d.ts","sourceRoot":"","sources":["../../../src/runner/context/base-prompts.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAoB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA8D5F,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;AAmD7F,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2ChC;AAwCD,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,mBAAmB,CAAC;IACrC,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAyChC;AA8MD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B,CAAC,EAAE,mBAAmB,CAAC;IACrD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;CACrD,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgC/B"}
+{"version":3,"file":"base-prompts.d.ts","sourceRoot":"","sources":["../../../src/runner/context/base-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAS9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,0BAA0B,CAAC;AAElC,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B,CAAC,EAAE,mBAAmB,CAAC;IACrD,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;CACrD,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqC/B"}

package/dist/runner/context/base-prompts.js

@@ -1,361 +1,8 @@
-import { readdir, readFile } from "node:fs/promises";
-import path from "node:path";
-import { loadAgentTemplates, loadPolicyGatewayTemplate } from "../../agents/agents-template.js";
-import { fileExists } from "../../cli/fs-utils.js";
-import { resolveBehavior, stripBehaviorValue, } from "../../runtime/behavior/index.js";
-import { resolvePolicyGatewayForRepo, } from "../../shared/policy-gateway.js";
-const FRAMEWORK_RUNNER_PROMPT_URL = new URL("../../../assets/RUNNER.md", import.meta.url);
-const BASE_PROMPT_PRIORITIES = {
-    framework_runner: 100,
-    policy_gateway: 200,
-    execution_profile: 250,
-    owner_profile: 300,
-    recipe_execution_context: 400,
-    recipe_agent_profile: 500,
-    recipe_skill_context: 600,
-    recipe_tools_context: 700,
-};
-function ensureTrailingNewline(text) {
-    return text.endsWith("\n") ? text : `${text}\n`;
-}
-function normalizeOwnerId(ownerIdRaw) {
-    const trimmed = ownerIdRaw.trim();
-    if (!trimmed)
-        throw new Error("Runner base prompt collection requires a non-empty owner id.");
-    return trimmed.toUpperCase();
-}
-function normalizeText(text) {
-    return ensureTrailingNewline(text.trimEnd());
-}
-function validateJsonPrompt(source, text) {
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch {
-        throw new Error(`Invalid prompt JSON: ${source} (malformed JSON)`);
-    }
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-        throw new Error(`Invalid prompt JSON: ${source} (expected object)`);
-    }
-    return normalizeText(text);
-}
-function renderRecipePromptJson(value) {
-    return normalizeText(JSON.stringify(value, null, 2));
-}
-function toPromptSource(gitRoot, absPath) {
-    return path.relative(gitRoot, absPath).replaceAll("\\", "/");
-}
-function isRecord(value) {
-    return !!value && typeof value === "object" && !Array.isArray(value);
-}
-function readOptionalStringArray(value) {
-    return Array.isArray(value)
-        ? value.filter((entry) => typeof entry === "string")
-        : [];
-}
-function promptCandidate(opts) {
-    return {
-        layer: opts.layer,
-        source: opts.source,
-        value: opts.value,
-        order: opts.order,
-        metadata: {
-            title: opts.value.title,
-        },
-    };
-}
-function promptBlockFromResolved(opts) {
-    return {
-        id: opts.id,
-        role: opts.role,
-        title: opts.resolved.value.title,
-        source: opts.resolved.value.source,
-        priority: opts.priority,
-        content: opts.resolved.value.content,
-        resolution: stripBehaviorValue(opts.resolved),
-    };
-}
-async function resolveRepoAgentProfilePath(opts) {
-    const agentsDir = path.join(opts.git_root, opts.agents_dir);
-    if (!(await fileExists(agentsDir)))
-        return null;
-    const entries = await readdir(agentsDir);
-    const wanted = `${opts.owner_id}.json`.toLowerCase();
-    const match = entries.find((entry) => entry.endsWith(".json") && entry.toLowerCase() === wanted);
-    if (!match)
-        return null;
-    return path.join(agentsDir, match);
-}
-export async function resolveOwnerProfilePromptSource(opts) {
-    const candidates = [];
-    const repoProfilePath = await resolveRepoAgentProfilePath(opts);
-    if (repoProfilePath) {
-        const source = toPromptSource(opts.git_root, repoProfilePath);
-        candidates.push(promptCandidate({
-            layer: "user",
-            source,
-            value: {
-                source,
-                title: `Owner Agent Profile (${opts.owner_id})`,
-                content: validateJsonPrompt(source, await readFile(repoProfilePath, "utf8")),
-            },
-        }));
-    }
-    const bundledFileName = `${opts.owner_id}.json`;
-    const bundledTemplates = await loadAgentTemplates();
-    const bundled = bundledTemplates.find((entry) => entry.fileName.toLowerCase() === bundledFileName.toLowerCase());
-    if (!bundled) {
-        throw new Error(`Bundled agent profile not found: ${bundledFileName}`);
-    }
-    candidates.push(promptCandidate({
-        layer: "builtin",
-        source: `bundled:agent-profile:${bundled.fileName}`,
-        value: {
-            source: `bundled:agent-profile:${bundled.fileName}`,
-            title: `Owner Agent Profile (${opts.owner_id})`,
-            content: validateJsonPrompt(`bundled:agent-profile:${bundled.fileName}`, bundled.contents),
-        },
-        order: 10,
-    }));
-    return resolveBehavior({
-        key: `runner.owner_profile:${opts.owner_id}`,
-        candidates,
-    });
-}
-async function loadOwnerProfilePrompt(opts) {
-    const resolved = await resolveOwnerProfilePromptSource(opts);
-    return promptBlockFromResolved({
-        id: "base.owner_profile",
-        role: "profile",
-        priority: BASE_PROMPT_PRIORITIES.owner_profile,
-        resolved,
-    });
-}
-async function loadFrameworkRunnerPrompt() {
-    const resolved = resolveBehavior({
-        key: "runner.framework_prompt",
-        candidates: [
-            promptCandidate({
-                layer: "builtin",
-                source: "bundled:runner-prompt:RUNNER.md",
-                value: {
-                    source: "bundled:runner-prompt:RUNNER.md",
-                    title: "Framework Runner Prompt",
-                    content: normalizeText(await readFile(FRAMEWORK_RUNNER_PROMPT_URL, "utf8")),
-                },
-            }),
-        ],
-    });
-    return promptBlockFromResolved({
-        id: "base.framework_runner",
-        role: "system",
-        priority: BASE_PROMPT_PRIORITIES.framework_runner,
-        resolved,
-    });
-}
-export async function resolvePolicyGatewayPromptSource(opts) {
-    const gateway = opts.harness?.repo.policy_gateway ??
-        (await resolvePolicyGatewayForRepo({
-            gitRoot: opts.git_root,
-            fallbackFlavor: opts.fallback_flavor,
-        }));
-    const candidates = [];
-    if (await fileExists(gateway.absPath)) {
-        const source = path.relative(opts.git_root, gateway.absPath).replaceAll("\\", "/");
-        candidates.push(promptCandidate({
-            layer: "harness",
-            source,
-            value: {
-                source,
-                title: `Repository Policy Gateway (${gateway.fileName})`,
-                content: normalizeText(await readFile(gateway.absPath, "utf8")),
-            },
-        }));
-    }
-    candidates.push(promptCandidate({
-        layer: "builtin",
-        source: `bundled:policy-gateway:${gateway.fileName}`,
-        value: {
-            source: `bundled:policy-gateway:${gateway.fileName}`,
-            title: `Bundled Policy Gateway Fallback (${gateway.fileName})`,
-            content: await loadPolicyGatewayTemplate(gateway.flavor),
-        },
-        order: 10,
-    }));
-    return resolveBehavior({
-        key: `runner.policy_gateway:${gateway.fileName}`,
-        candidates,
-    });
-}
-async function loadPolicyGatewayPrompt(opts) {
-    const resolved = await resolvePolicyGatewayPromptSource(opts);
-    return promptBlockFromResolved({
-        id: "base.policy_gateway",
-        role: "policy",
-        priority: BASE_PROMPT_PRIORITIES.policy_gateway,
-        resolved,
-    });
-}
-function renderExecutionProfilePromptContent(runtime) {
-    return renderRecipePromptJson({
-        profile: runtime.profile,
-        reasoning_effort: runtime.reasoning_effort,
-        budget: runtime.budget,
-        approvals: runtime.approvals,
-        stop_conditions: runtime.stop_conditions,
-        handoff_conditions: runtime.handoff_conditions,
-        unsafe_actions_requiring_explicit_user_ok: runtime.unsafe_actions_requiring_explicit_user_ok,
-        runner: runtime.runner,
-    });
-}
-function loadExecutionProfilePrompt(opts) {
-    if (!opts.execution_profile)
-        return null;
-    const source = `runtime:execution-profile:${opts.execution_profile.profile}`;
-    const resolved = resolveBehavior({
-        key: "runner.execution_profile",
-        candidates: [
-            promptCandidate({
-                layer: "harness",
-                source,
-                value: {
-                    source,
-                    title: `Execution Profile Runtime (${opts.execution_profile.profile})`,
-                    content: renderExecutionProfilePromptContent(opts.execution_profile),
-                },
-            }),
-        ],
-    });
-    return promptBlockFromResolved({
-        id: "base.execution_profile",
-        role: "policy",
-        priority: BASE_PROMPT_PRIORITIES.execution_profile,
-        resolved,
-    });
-}
-async function loadRecipePromptJsonBlock(opts) {
-    const candidates = [];
-    const relativeFile = opts.relative_file?.trim();
-    if (relativeFile) {
-        const absPath = path.join(opts.recipe_dir, relativeFile);
-        if (await fileExists(absPath)) {
-            const source = toPromptSource(opts.git_root, absPath);
-            candidates.push(promptCandidate({
-                layer: "extension",
-                source,
-                value: {
-                    source,
-                    title: opts.title,
-                    content: validateJsonPrompt(source, await readFile(absPath, "utf8")),
-                },
-            }));
-        }
-    }
-    candidates.push(promptCandidate({
-        layer: "extension",
-        source: opts.fallback_source,
-        value: {
-            source: opts.fallback_source,
-            title: opts.title,
-            content: renderRecipePromptJson(opts.fallback_payload),
-        },
-        order: 10,
-    }));
-    const resolved = resolveBehavior({
-        key: opts.prompt_id,
-        candidates,
-    });
-    return promptBlockFromResolved({
-        id: opts.prompt_id,
-        role: opts.role,
-        priority: opts.priority,
-        resolved,
-    });
-}
-async function collectRecipePromptBlocks(opts) {
-    const recipeDir = opts.recipe.recipe_dir?.trim();
-    if (!recipeDir)
-        return [];
-    const promptBlocks = [];
-    const scenario = isRecord(opts.recipe.scenario) ? opts.recipe.scenario : {};
-    const executionContext = {
-        recipe: {
-            id: opts.recipe.recipe_id,
-            name: opts.recipe.recipe_name ?? null,
-            version: opts.recipe.recipe_version ?? null,
-            scenario_id: opts.recipe.scenario_id,
-            scenario_file: opts.recipe.scenario_file ?? null,
-        },
-        selection_reasons: opts.recipe.selection_reasons ?? [],
-        run_profile: opts.recipe.run_profile ?? {},
-        scenario: {
-            summary: typeof scenario.summary === "string" ? scenario.summary : null,
-            description: typeof scenario.description === "string" ? scenario.description : null,
-            goal: typeof scenario.goal === "string" ? scenario.goal : null,
-            evidence: isRecord(scenario.evidence) ? scenario.evidence : null,
-            outputs: readOptionalStringArray(scenario.outputs),
-        },
-    };
-    promptBlocks.push({
-        id: "recipe.execution_context",
-        role: "context",
-        title: `Recipe Scenario Context (${opts.recipe.recipe_id}:${opts.recipe.scenario_id})`,
-        source: `recipe:${opts.recipe.recipe_id}:${opts.recipe.scenario_id}`,
-        priority: BASE_PROMPT_PRIORITIES.recipe_execution_context,
-        content: renderRecipePromptJson(executionContext),
-    });
-    const agentBlocks = await Promise.all((opts.recipe.agents ?? []).map(async (agent, index) => {
-        const agentId = typeof agent.id === "string" ? agent.id : `agent_${index + 1}`;
-        return loadRecipePromptJsonBlock({
-            git_root: opts.git_root,
-            recipe_dir: recipeDir,
-            prompt_id: `recipe.agent.${agentId}`,
-            role: "profile",
-            title: `Recipe Agent Prompt (${agentId})`,
-            relative_file: typeof agent.file === "string" ? agent.file : undefined,
-            fallback_source: `recipe:${opts.recipe.recipe_id}:agent:${agentId}`,
-            fallback_payload: agent,
-            priority: BASE_PROMPT_PRIORITIES.recipe_agent_profile + index,
-        });
-    }));
-    promptBlocks.push(...agentBlocks);
-    const skillBlocks = await Promise.all((opts.recipe.skills ?? []).map(async (skill, index) => {
-        const skillId = typeof skill.id === "string" ? skill.id : `skill_${index + 1}`;
-        return loadRecipePromptJsonBlock({
-            git_root: opts.git_root,
-            recipe_dir: recipeDir,
-            prompt_id: `recipe.skill.${skillId}`,
-            role: "context",
-            title: `Recipe Skill Prompt (${skillId})`,
-            relative_file: typeof skill.file === "string" ? skill.file : undefined,
-            fallback_source: `recipe:${opts.recipe.recipe_id}:skill:${skillId}`,
-            fallback_payload: skill,
-            priority: BASE_PROMPT_PRIORITIES.recipe_skill_context + index,
-        });
-    }));
-    promptBlocks.push(...skillBlocks);
-    if ((opts.recipe.tools ?? []).length > 0) {
-        const toolPayload = (opts.recipe.tools ?? []).map((tool) => ({
-            id: typeof tool.id === "string" ? tool.id : null,
-            summary: typeof tool.summary === "string" ? tool.summary : null,
-            runtime: typeof tool.runtime === "string" ? tool.runtime : null,
-            entrypoint: typeof tool.entrypoint === "string" ? tool.entrypoint : null,
-            permissions: readOptionalStringArray(tool.permissions),
-            timeout_ms: typeof tool.timeout_ms === "number" ? tool.timeout_ms : null,
-            cwd_policy: typeof tool.cwd_policy === "string" ? tool.cwd_policy : null,
-        }));
-        promptBlocks.push({
-            id: "recipe.tools_summary",
-            role: "context",
-            title: "Recipe Tool Context",
-            source: `recipe:${opts.recipe.recipe_id}:tools`,
-            priority: BASE_PROMPT_PRIORITIES.recipe_tools_context,
-            content: renderRecipePromptJson(toolPayload),
-        });
-    }
-    return promptBlocks;
-}
+import { loadExecutionProfilePrompt, loadOwnerProfilePrompt, loadPolicyGatewayPrompt, } from "./base-prompt-sources.js";
+import { collectOverlayPromptBlocks } from "./overlay-prompt-blocks.js";
+import { loadFrameworkRunnerPrompt, normalizeOwnerId } from "./prompt-block-shared.js";
+import { collectRecipePromptBlocks } from "./recipe-prompt-blocks.js";
+export { resolveOwnerProfilePromptSource, resolvePolicyGatewayPromptSource, } from "./base-prompt-sources.js";
 export async function collectRunnerBasePrompts(opts) {
     const owner_id = normalizeOwnerId(opts.owner_id);
     const trimmedAgentsDir = opts.agents_dir?.trim() ?? opts.harness?.workflow.paths.agents_dir;
@@ -374,6 +21,11 @@ export async function collectRunnerBasePrompts(opts) {
     const basePrompts = resolvedBasePrompts.filter((prompt) => prompt !== null);
     const prompts = [
         ...basePrompts,
+        ...(await collectOverlayPromptBlocks({
+            git_root: opts.git_root,
+            task: opts.task,
+            command: opts.command,
+        })),
         ...(await collectRecipePromptBlocks({
             git_root: opts.git_root,
             recipe: opts.recipe ?? { recipe_id: "", scenario_id: "" },

package/dist/runner/context/overlay-prompt-blocks.d.ts

@@ -0,0 +1,7 @@
+import type { RunnerPromptBlock, RunnerTaskContext } from "../types.js";
+export declare function collectOverlayPromptBlocks(opts: {
+    git_root: string;
+    task?: RunnerTaskContext;
+    command?: string;
+}): Promise<RunnerPromptBlock[]>;
+//# sourceMappingURL=overlay-prompt-blocks.d.ts.map

package/dist/runner/context/overlay-prompt-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-prompt-blocks.d.ts","sourceRoot":"","sources":["../../../src/runner/context/overlay-prompt-blocks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6BxE,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuC/B"}

package/dist/runner/context/overlay-prompt-blocks.js

@@ -0,0 +1,72 @@
+import path from "node:path";
+import { matchOverlayWhen } from "@agentplaneorg/recipes";
+import { fileExists } from "../../cli/fs-utils.js";
+import { readProjectOverlayBundle } from "../../commands/recipes.js";
+import { normalizeText, OVERLAY_PROMPT_PRIORITIES } from "./prompt-block-shared.js";
+async function detectRepoTypes(gitRoot) {
+    const repoTypes = ["generic"];
+    const checks = [
+        ["package.json", "node"],
+        ["pyproject.toml", "python"],
+        ["go.mod", "go"],
+        ["Cargo.toml", "rust"],
+    ];
+    for (const [relativePath, repoType] of checks) {
+        if (await fileExists(path.join(gitRoot, relativePath)))
+            repoTypes.push(repoType);
+    }
+    return [...new Set(repoTypes)].toSorted();
+}
+function inferTaskKind(task) {
+    const tags = Array.isArray(task?.data.tags)
+        ? task.data.tags.filter((tag) => typeof tag === "string")
+        : [];
+    if (tags.includes("docs"))
+        return "docs";
+    if (tags.includes("refactor"))
+        return "refactor";
+    if (tags.includes("research"))
+        return "research";
+    if (tags.includes("bug") || tags.includes("bugfix"))
+        return "bugfix";
+    if (tags.length > 0)
+        return "feature";
+    return undefined;
+}
+export async function collectOverlayPromptBlocks(opts) {
+    const bundle = await readProjectOverlayBundle({
+        agentplaneDir: path.join(opts.git_root, ".agentplane"),
+    });
+    if (!bundle)
+        return [];
+    const repoTypes = await detectRepoTypes(opts.git_root);
+    const tags = Array.isArray(opts.task?.data.tags)
+        ? opts.task.data.tags.filter((tag) => typeof tag === "string")
+        : [];
+    const taskKind = inferTaskKind(opts.task);
+    const blocks = [];
+    for (const [surface, fragments] of Object.entries(bundle.surfaces)) {
+        for (const fragment of fragments) {
+            if (!matchOverlayWhen(fragment.when, {
+                task_kind: taskKind,
+                command: opts.command,
+                tags,
+                repo_types: repoTypes,
+            })) {
+                continue;
+            }
+            blocks.push({
+                id: `overlay.${fragment.recipe_id}.${fragment.id}`,
+                role: fragment.strength === "required" ? "policy" : "context",
+                title: `${fragment.recipe_name}: ${fragment.id}`,
+                source: fragment.source,
+                priority: OVERLAY_PROMPT_PRIORITIES[surface] +
+                    (fragment.order ?? 0),
+                surface: surface,
+                strength: fragment.strength,
+                content: normalizeText(fragment.content),
+            });
+        }
+    }
+    return blocks;
+}