agentplane 0.3.13 → 0.3.14

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;
+}

package/dist/runner/context/prompt-block-shared.d.ts

@@ -0,0 +1,54 @@
+import { type BehaviorCandidate, type ResolvedBehavior } from "../../runtime/behavior/index.js";
+import type { RunnerPromptBlock, RunnerPromptRole } from "../types.js";
+export declare const FRAMEWORK_RUNNER_PROMPT_URL: import("node:url").URL;
+export declare const BASE_PROMPT_PRIORITIES: {
+    readonly framework_runner: 100;
+    readonly policy_gateway: 200;
+    readonly execution_profile: 250;
+    readonly owner_profile: 300;
+    readonly recipe_execution_context: 400;
+    readonly recipe_agent_profile: 500;
+    readonly recipe_skill_context: 600;
+    readonly recipe_tools_context: 700;
+};
+export declare const OVERLAY_PROMPT_PRIORITIES: {
+    readonly planning: 410;
+    readonly execution: 420;
+    readonly coding: 430;
+    readonly debugging: 440;
+    readonly review: 450;
+    readonly verification: 460;
+    readonly docs: 470;
+    readonly finish: 480;
+};
+export declare function ensureTrailingNewline(text: string): string;
+export declare function normalizeOwnerId(ownerIdRaw: string): string;
+export declare function normalizeText(text: string): string;
+export declare function validateJsonPrompt(source: string, text: string): string;
+export declare function renderRecipePromptJson(value: Record<string, unknown> | Record<string, unknown>[]): string;
+export declare function toPromptSource(gitRoot: string, absPath: string): string;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function readOptionalStringArray(value: unknown): string[];
+export type PromptSourcePayload = {
+    source: string;
+    title: string;
+    content: string;
+};
+export type PromptSourceTraceMetadata = {
+    title: string;
+};
+export type ResolvedPromptSource = ResolvedBehavior<PromptSourcePayload, PromptSourceTraceMetadata>;
+export declare function promptCandidate(opts: {
+    layer: BehaviorCandidate<PromptSourcePayload, PromptSourceTraceMetadata>["layer"];
+    source: string;
+    value: PromptSourcePayload;
+    order?: number;
+}): BehaviorCandidate<PromptSourcePayload, PromptSourceTraceMetadata>;
+export declare function promptBlockFromResolved(opts: {
+    id: string;
+    role: RunnerPromptRole;
+    priority: number;
+    resolved: ResolvedPromptSource;
+}): RunnerPromptBlock;
+export declare function loadFrameworkRunnerPrompt(): Promise<RunnerPromptBlock>;
+//# sourceMappingURL=prompt-block-shared.d.ts.map

package/dist/runner/context/prompt-block-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-block-shared.d.ts","sourceRoot":"","sources":["../../../src/runner/context/prompt-block-shared.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,2BAA2B,wBAAwD,CAAC;AAEjG,eAAO,MAAM,sBAAsB;;;;;;;;;CASzB,CAAC;AAEX,eAAO,MAAM,yBAAyB;;;;;;;;;CAS5B,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACzD,MAAM,CAER;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAIhE;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;AAEpG,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,iBAAiB,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAUpE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;CAChC,GAAG,iBAAiB,CAUpB;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAsB5E"}

package/dist/runner/context/prompt-block-shared.js

@@ -0,0 +1,106 @@
+import { readFile } from "node:fs/promises";
+import { resolveBehavior, stripBehaviorValue, } from "../../runtime/behavior/index.js";
+export const FRAMEWORK_RUNNER_PROMPT_URL = new URL("../../../assets/RUNNER.md", import.meta.url);
+export 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,
+};
+export const OVERLAY_PROMPT_PRIORITIES = {
+    planning: 410,
+    execution: 420,
+    coding: 430,
+    debugging: 440,
+    review: 450,
+    verification: 460,
+    docs: 470,
+    finish: 480,
+};
+export function ensureTrailingNewline(text) {
+    return text.endsWith("\n") ? text : `${text}\n`;
+}
+export 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();
+}
+export function normalizeText(text) {
+    return ensureTrailingNewline(text.trimEnd());
+}
+export 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);
+}
+export function renderRecipePromptJson(value) {
+    return normalizeText(JSON.stringify(value, null, 2));
+}
+export function toPromptSource(gitRoot, absPath) {
+    return absPath.replace(`${gitRoot}/`, "").replaceAll("\\", "/");
+}
+export function isRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+export function readOptionalStringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((entry) => typeof entry === "string")
+        : [];
+}
+export function promptCandidate(opts) {
+    return {
+        layer: opts.layer,
+        source: opts.source,
+        value: opts.value,
+        order: opts.order,
+        metadata: {
+            title: opts.value.title,
+        },
+    };
+}
+export 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),
+    };
+}
+export 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,
+    });
+}

package/dist/runner/context/recipe-context.d.ts

@@ -1,5 +1,6 @@
 import type { ResolvedProject } from "@agentplaneorg/core";
-import { readProjectInstalledRecipes, type ResolvedRecipeScenarioSelection, type ScenarioDefinition } from "../../commands/recipes.js";
+import { type ResolvedRecipeScenarioSelection, type ScenarioDefinition } from "@agentplaneorg/recipes";
+import { readProjectInstalledRecipes } from "../../commands/recipes.js";
 import type { RunnerRecipeContext } from "../types.js";
 type InstalledRecipeEntry = Awaited<ReturnType<typeof readProjectInstalledRecipes>>["recipes"][number];
 export type RunnerRecipeContextEnvelope = {

package/dist/runner/context/recipe-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe-context.d.ts","sourceRoot":"","sources":["../../../src/runner/context/recipe-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAEL,2BAA2B,EAG3B,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,KAAK,oBAAoB,GAAG,OAAO,CACjC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAC/C,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,EAAE,+BAA+B,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAoEF,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA4BvC"}
+{"version":3,"file":"recipe-context.d.ts","sourceRoot":"","sources":["../../../src/runner/context/recipe-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAEL,2BAA2B,EAE5B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,KAAK,oBAAoB,GAAG,OAAO,CACjC,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAC/C,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,2BAA2B,GAAG;IACxC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,EAAE,+BAA+B,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAoEF,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA4BvC"}

package/dist/runner/context/recipe-context.js

@@ -1,4 +1,5 @@
-import { readProjectRecipeAssetRegistry, readProjectInstalledRecipes, readScenarioDefinition, resolveRecipeScenarioSelection, } from "../../commands/recipes.js";
+import { readScenarioDefinition, } from "@agentplaneorg/recipes";
+import { readProjectRecipeAssetRegistry, readProjectInstalledRecipes, resolveRecipeScenarioSelection, } from "../../commands/recipes.js";
 import { resolveRecipeCapabilityRegistry } from "../../runtime/capabilities/index.js";
 import { CliError } from "../../shared/errors.js";
 function toRecipeContext(opts) {

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

@@ -0,0 +1,6 @@
+import type { RunnerPromptBlock, RunnerRecipeContext } from "../types.js";
+export declare function collectRecipePromptBlocks(opts: {
+    git_root: string;
+    recipe: RunnerRecipeContext;
+}): Promise<RunnerPromptBlock[]>;
+//# sourceMappingURL=recipe-prompt-blocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-prompt-blocks.d.ts","sourceRoot":"","sources":["../../../src/runner/context/recipe-prompt-blocks.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAmF5F,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;CAC7B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA4F/B"}

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

@@ -0,0 +1,143 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../../cli/fs-utils.js";
+import { resolveBehavior } from "../../runtime/behavior/index.js";
+import { BASE_PROMPT_PRIORITIES, isRecord, promptBlockFromResolved, promptCandidate, readOptionalStringArray, renderRecipePromptJson, toPromptSource, } from "./prompt-block-shared.js";
+async function loadRecipePromptTextBlock(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: await readFile(absPath, "utf8"),
+                },
+            }));
+        }
+    }
+    if (typeof opts.fallback_content === "string" && opts.fallback_content.trim().length > 0) {
+        candidates.push(promptCandidate({
+            layer: "extension",
+            source: opts.fallback_source,
+            value: {
+                source: opts.fallback_source,
+                title: opts.title,
+                content: opts.fallback_content,
+            },
+            order: 10,
+        }));
+    }
+    else if (opts.fallback_payload) {
+        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,
+    });
+}
+export 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 loadRecipePromptTextBlock({
+            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_content: typeof agent.content === "string" ? agent.content : undefined,
+            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 loadRecipePromptTextBlock({
+            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_content: typeof skill.content === "string" ? skill.content : undefined,
+            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;
+}

package/dist/runner/usecases/scenario-materialize-task.js

@@ -5,7 +5,7 @@ import { TASK_DOC_VERSION_V3, buildDefaultVerifyStepsSection, defaultTaskDocV3,
 import { createClarificationContract, createTaskGraphDraft, createTaskIntakeContext, materializeTaskGraphDraft, } from "../../runtime/task-intake/index.js";
 import { buildTaskDocState } from "../../shared/task-doc-state.js";
 import { dedupeStrings } from "../../shared/strings.js";
-import { makeReadOnlyUsecaseContext } from "../../usecases/context/resolve-context.js";
+import { makeReadOnlyExecutionContext } from "../../runtime/execution-context.js";
 import { createRunnerRunId } from "../run-id.js";
 import { assembleRunnerRecipeContext, } from "../context/recipe-context.js";
 function nowIso() {
@@ -121,7 +121,7 @@ export function buildMaterializedRecipeTask(opts) {
 export async function materializeRecipeScenarioTask(opts) {
     const command = opts.ctx ??
         (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-    const executionContext = await makeReadOnlyUsecaseContext(command);
+    const executionContext = await makeReadOnlyExecutionContext(command);
     if (!executionContext.backend.task_backend.generateTaskId) {
         throw new Error("Backend does not support task materialization: missing generateTaskId()");
     }

package/dist/runner/usecases/task-run-inspect.js

@@ -1,12 +1,12 @@
 import { loadCommandContext } from "../../commands/shared/task-backend.js";
 import { CliError } from "../../shared/errors.js";
-import { makeReadOnlyUsecaseContext } from "../../usecases/context/resolve-context.js";
+import { makeReadOnlyExecutionContext } from "../../runtime/execution-context.js";
 import { resolveLatestRunnerRunId, RunnerRunRepository } from "../run-repository.js";
 import { resolveTaskRunnerPaths } from "../task-run-paths.js";
 export async function loadTaskRunnerInspection(opts) {
     const command = opts.ctx ??
         (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-    const executionContext = await makeReadOnlyUsecaseContext(command);
+    const executionContext = await makeReadOnlyExecutionContext(command);
     const task = await executionContext.backend.task_backend.getTask(opts.task_id);
     if (!task) {
         throw new CliError({

package/dist/runner/usecases/task-run-lifecycle-shared.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { loadCommandContext } from "../../commands/shared/task-backend.js";
 import { CliError } from "../../shared/errors.js";
-import { makeReadOnlyUsecaseContext } from "../../usecases/context/resolve-context.js";
+import { makeReadOnlyExecutionContext } from "../../runtime/execution-context.js";
 import { createRunnerAdapter } from "../adapters/index.js";
 import { runnerAdapterCancelledResult } from "../adapters/shared.js";
 import { evolveRunnerRunState } from "../artifacts.js";
@@ -142,7 +142,7 @@ export function buildSyntheticCancelledState(opts) {
 export async function loadExistingRunnerExecution(opts) {
     const command = opts.ctx ??
         (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-    const executionContext = await makeReadOnlyUsecaseContext(command);
+    const executionContext = await makeReadOnlyExecutionContext(command);
     if (opts.require_task_doing !== false) {
         assertCurrentTaskDoing(opts.task_id, await executionContext.backend.task_backend.getTask(opts.task_id));
     }

package/dist/runner/usecases/task-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-run.d.ts","sourceRoot":"","sources":["../../../src/runner/usecases/task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAuBhG,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,GAAG;IACtE,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAkHF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAc5E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,MAAM,CAiCR;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAqHvC;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAgDvC"}
+{"version":3,"file":"task-run.d.ts","sourceRoot":"","sources":["../../../src/runner/usecases/task-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAuBhG,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,GAAG;IACtE,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAkHF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAc5E;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,UAAU,CAAC,EAAE,gBAAgB,GAC5B,MAAM,CAiCR;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAuHvC;AAED,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAgDvC"}

package/dist/runner/usecases/task-run.js

@@ -5,7 +5,7 @@ import { resolveRunnerAdapterCapabilityRegistry } from "../../runtime/capabiliti
 import { consumeExecutionProfileBudget } from "../../runtime/execution-profile/index.js";
 import { appendFrameworkExplainBehaviorInputs, } from "../../runtime/explain/index.js";
 import { buildFrameworkProtocolSurface } from "../../runtime/protocol/index.js";
-import { makeReadOnlyUsecaseContext } from "../../usecases/context/resolve-context.js";
+import { makeReadOnlyExecutionContext } from "../../runtime/execution-context.js";
 import { evolveRunnerRunState } from "../artifacts.js";
 import { createRunnerAdapter } from "../adapters/index.js";
 import { readRecipeRunProfile } from "../adapters/recipe-run-profile.js";
@@ -166,7 +166,7 @@ export function renderTaskRunnerBootstrap(bundle, invocation) {
 export async function prepareTaskRunnerExecution(opts) {
     const command = opts.ctx ??
         (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
-    const executionContext = await makeReadOnlyUsecaseContext(command);
+    const executionContext = await makeReadOnlyExecutionContext(command);
     const target = opts.target ?? { kind: "task", task_id: opts.task_id };
     void executionContext.policy.evaluate({
         action: target.kind === "recipe_scenario" ? "scenario_execute" : "task_run",
@@ -184,11 +184,13 @@ export async function prepareTaskRunnerExecution(opts) {
         rootOverride: opts.rootOverride ?? null,
         task_id: opts.task_id,
     });
+    const runnerCommand = target.kind === "recipe_scenario" ? "recipes scenario execute" : "task run";
     const base_prompts = await collectRunnerBasePrompts({
         git_root: executionContext.repo.git_root,
         owner_id: taskEnvelope.task.data.owner,
         agents_dir: executionContext.harness.workflow.paths.agents_dir,
         task: taskEnvelope.task,
+        command: runnerCommand,
         recipe: opts.recipe,
         harness: executionContext.harness,
         execution_profile: executionProfile,

package/dist/runtime/capabilities/recipe.d.ts

@@ -1,4 +1,4 @@
-import type { CompiledRecipeAssetEntry, InstalledRecipeEntry, ResolvedRecipeScenarioSelection } from "../../commands/recipes/impl/types.js";
+import type { CompiledRecipeAssetEntry, InstalledRecipeEntry, ResolvedRecipeScenarioSelection } from "@agentplaneorg/recipes";
 import type { AgentplaneCapabilityRegistry } from "./types.js";
 type RecipeSelection = Pick<ResolvedRecipeScenarioSelection, "scenario_id" | "agents_involved" | "skills_used" | "tools_used">;
 type RecipeEntry = Pick<InstalledRecipeEntry, "id" | "version" | "manifest">;

package/dist/runtime/capabilities/recipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAChC,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAA6B,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1F,KAAK,eAAe,GAAG,IAAI,CACzB,+BAA+B,EAC/B,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,YAAY,CACjE,CAAC;AAEF,KAAK,WAAW,GAAG,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAsG7E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACpC,GAAG,4BAA4B,CAiG/B"}
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAChC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAA6B,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1F,KAAK,eAAe,GAAG,IAAI,CACzB,+BAA+B,EAC/B,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,YAAY,CACjE,CAAC;AAEF,KAAK,WAAW,GAAG,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;AAsG7E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACpC,GAAG,4BAA4B,CAiG/B"}

package/dist/runtime/execution-context.d.ts

@@ -0,0 +1,63 @@
+import type { AgentplaneConfig, ResolvedProject } from "@agentplaneorg/core";
+import type { Adapters } from "../adapters/index.js";
+import { type CommandContext } from "../commands/shared/task-backend.js";
+import { PolicyEngine } from "../policy/engine.js";
+import { type ApprovalRuntime } from "./approvals/index.js";
+import { type AgentplaneCapabilityRegistry } from "./capabilities/index.js";
+import { type ResolvedExecutionProfileRuntime } from "./execution-profile/index.js";
+import { type FrameworkExplainPayload } from "./explain/index.js";
+import { type ResolvedHarnessContract } from "./harness/index.js";
+import { type FrameworkProtocolSurface } from "./protocol/index.js";
+import { type TaskIntakeRuntime } from "./task-intake/index.js";
+export type AgentplaneRepositoryContext = {
+    git_root: string;
+    agentplane_dir: string;
+    workflow_dir: string;
+};
+export type AgentplaneBackendContext = {
+    id: string;
+    config_path: string;
+    capabilities: CommandContext["taskBackend"]["capabilities"] | null;
+    task_backend: CommandContext["taskBackend"];
+};
+export type ReadOnlyExecutionContext = {
+    command: CommandContext;
+    project: CommandContext["resolvedProject"];
+    repo: AgentplaneRepositoryContext;
+    config: CommandContext["config"];
+    backend: AgentplaneBackendContext;
+    harness: ResolvedHarnessContract;
+    capabilities: AgentplaneCapabilityRegistry;
+    execution: ResolvedHarnessContract["execution"];
+    executionProfile: ResolvedExecutionProfileRuntime;
+    taskIntake: TaskIntakeRuntime;
+    frameworkExplain: FrameworkExplainPayload;
+    frameworkProtocol: FrameworkProtocolSurface;
+    approvals: ResolvedHarnessContract["policy"]["approvals"];
+    policy: PolicyEngine;
+    approvalRuntime: ApprovalRuntime;
+};
+export type ExecutionContext = ReadOnlyExecutionContext & {
+    adapters: Adapters;
+};
+export declare function resolveCommandContext(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    resolvedProject?: ResolvedProject;
+    config?: AgentplaneConfig;
+}): Promise<CommandContext>;
+export declare function resolveReadOnlyExecutionContext(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    resolvedProject?: ResolvedProject;
+    config?: AgentplaneConfig;
+}): Promise<ReadOnlyExecutionContext>;
+export declare function resolveExecutionContext(opts: {
+    cwd: string;
+    rootOverride?: string | null;
+    resolvedProject?: ResolvedProject;
+    config?: AgentplaneConfig;
+}): Promise<ExecutionContext>;
+export declare function makeReadOnlyExecutionContext(command: CommandContext): Promise<ReadOnlyExecutionContext>;
+export declare function makeExecutionContext(command: CommandContext): Promise<ExecutionContext>;
+//# sourceMappingURL=execution-context.d.ts.map

package/dist/runtime/execution-context.d.ts.map

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