agentplane 0.3.8 → 0.3.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oCAAoC,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,sCAAsC,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EACV,gCAAgC,EAChC,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,YAAY,CAAC"}

package/dist/runtime/capabilities/index.js

@@ -0,0 +1,4 @@
+export { createCapabilityRegistry, getCapabilityEntries, listCapabilities, mergeCapabilityRegistries, } from "./registry.js";
+export { resolveTaskBackendCapabilityRegistry } from "./backend.js";
+export { resolveRecipeCapabilityRegistry } from "./recipe.js";
+export { resolveRunnerAdapterCapabilityRegistry } from "./runner.js";

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

@@ -0,0 +1,10 @@
+import type { InstalledRecipeEntry, ResolvedRecipeScenarioSelection } from "../../commands/recipes/impl/types.js";
+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">;
+export declare function resolveRecipeCapabilityRegistry(opts: {
+    entry: RecipeEntry;
+    selection?: RecipeSelection | null;
+}): AgentplaneCapabilityRegistry;
+export {};
+//# sourceMappingURL=recipe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recipe.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/recipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,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;AA2C7E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACpC,GAAG,4BAA4B,CA+F/B"}

package/dist/runtime/capabilities/recipe.js

@@ -0,0 +1,123 @@
+import { createCapabilityRegistry } from "./registry.js";
+function source(entry) {
+    return {
+        id: "recipe_manifest",
+        detail: `${entry.id}@${entry.version}`,
+    };
+}
+function scenarioCapabilityId(recipeId, scenarioId) {
+    return `recipe.${recipeId}.scenario.${scenarioId}`;
+}
+function agentCapabilityId(recipeId, agentId) {
+    return `recipe.${recipeId}.agent.${agentId}`;
+}
+function skillCapabilityId(recipeId, skillId) {
+    return `recipe.${recipeId}.skill.${skillId}`;
+}
+function toolCapabilityId(recipeId, toolId) {
+    return `recipe.${recipeId}.tool.${toolId}`;
+}
+function selectedAvailability(opts) {
+    if (opts.selected) {
+        return { availability: "available" };
+    }
+    if (!opts.gate) {
+        return { availability: "available" };
+    }
+    return {
+        availability: "blocked",
+        reason: opts.reason,
+        blocked_by: [opts.gate],
+    };
+}
+export function resolveRecipeCapabilityRegistry(opts) {
+    const gate = opts.selection
+        ? scenarioCapabilityId(opts.entry.id, opts.selection.scenario_id)
+        : null;
+    const entries = [];
+    for (const scenario of opts.entry.manifest.scenarios) {
+        const selected = opts.selection ? scenario.id === opts.selection.scenario_id : true;
+        entries.push({
+            id: scenarioCapabilityId(opts.entry.id, scenario.id),
+            kind: "scenario",
+            source: source(opts.entry),
+            summary: scenario.summary,
+            ...selectedAvailability({
+                selected,
+                gate,
+                reason: "The scenario is declared by the recipe but is not the active selection.",
+            }),
+            metadata: {
+                recipe_id: opts.entry.id,
+                recipe_version: opts.entry.version,
+                scenario_id: scenario.id,
+                scenario_name: scenario.name,
+                file: scenario.file,
+            },
+        });
+    }
+    for (const agent of opts.entry.manifest.agents ?? []) {
+        const selected = opts.selection ? opts.selection.agents_involved.includes(agent.id) : true;
+        entries.push({
+            id: agentCapabilityId(opts.entry.id, agent.id),
+            kind: "agent",
+            source: source(opts.entry),
+            summary: agent.summary,
+            ...selectedAvailability({
+                selected,
+                gate,
+                reason: "The agent is declared by the recipe but is not used by the selected scenario.",
+            }),
+            metadata: {
+                recipe_id: opts.entry.id,
+                recipe_version: opts.entry.version,
+                agent_id: agent.id,
+                role: agent.role,
+                file: agent.file,
+            },
+        });
+    }
+    for (const skill of opts.entry.manifest.skills ?? []) {
+        const selected = opts.selection ? opts.selection.skills_used.includes(skill.id) : true;
+        entries.push({
+            id: skillCapabilityId(opts.entry.id, skill.id),
+            kind: "skill",
+            source: source(opts.entry),
+            summary: skill.summary,
+            ...selectedAvailability({
+                selected,
+                gate,
+                reason: "The skill is declared by the recipe but is not used by the selected scenario.",
+            }),
+            metadata: {
+                recipe_id: opts.entry.id,
+                recipe_version: opts.entry.version,
+                skill_id: skill.id,
+                kind: skill.kind,
+                file: skill.file,
+            },
+        });
+    }
+    for (const tool of opts.entry.manifest.tools ?? []) {
+        const selected = opts.selection ? opts.selection.tools_used.includes(tool.id) : true;
+        entries.push({
+            id: toolCapabilityId(opts.entry.id, tool.id),
+            kind: "tool",
+            source: source(opts.entry),
+            summary: tool.summary,
+            ...selectedAvailability({
+                selected,
+                gate,
+                reason: "The tool is declared by the recipe but is not used by the selected scenario.",
+            }),
+            metadata: {
+                recipe_id: opts.entry.id,
+                recipe_version: opts.entry.version,
+                tool_id: tool.id,
+                runtime: tool.runtime,
+                entrypoint: tool.entrypoint,
+            },
+        });
+    }
+    return createCapabilityRegistry(entries);
+}

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

@@ -0,0 +1,6 @@
+import type { AgentplaneCapabilityEntry, AgentplaneCapabilityFilter, AgentplaneCapabilityRegistry } from "./types.js";
+export declare function createCapabilityRegistry(entries?: readonly AgentplaneCapabilityEntry[]): AgentplaneCapabilityRegistry;
+export declare function mergeCapabilityRegistries(...registries: readonly (AgentplaneCapabilityRegistry | null | undefined)[]): AgentplaneCapabilityRegistry;
+export declare function listCapabilities(registry: AgentplaneCapabilityRegistry, filter?: AgentplaneCapabilityFilter): AgentplaneCapabilityEntry[];
+export declare function getCapabilityEntries(registry: AgentplaneCapabilityRegistry, id: string): AgentplaneCapabilityEntry[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AA6CpB,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,SAAS,yBAAyB,EAAO,GACjD,4BAA4B,CAc9B;AAED,wBAAgB,yBAAyB,CACvC,GAAG,UAAU,EAAE,SAAS,CAAC,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAC1E,4BAA4B,CAE9B;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,4BAA4B,EACtC,MAAM,CAAC,EAAE,0BAA0B,GAClC,yBAAyB,EAAE,CAO7B;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,4BAA4B,EACtC,EAAE,EAAE,MAAM,GACT,yBAAyB,EAAE,CAE7B"}

package/dist/runtime/capabilities/registry.js

@@ -0,0 +1,69 @@
+function sortStrings(values) {
+    if (!values || values.length === 0)
+        return undefined;
+    return [...values].filter((value) => value.trim().length > 0).toSorted();
+}
+function normalizeEntry(entry) {
+    const id = entry.id.trim();
+    const supportedValues = sortStrings(entry.supported_values);
+    const blockedBy = sortStrings(entry.blocked_by);
+    if (!id) {
+        throw new Error("Capability entries require a non-empty id");
+    }
+    return {
+        id,
+        kind: entry.kind,
+        availability: entry.availability,
+        source: {
+            id: entry.source.id,
+            detail: entry.source.detail,
+        },
+        ...(entry.summary ? { summary: entry.summary } : {}),
+        ...(Object.hasOwn(entry, "value") ? { value: entry.value } : {}),
+        ...(supportedValues ? { supported_values: supportedValues } : {}),
+        ...(entry.reason ? { reason: entry.reason } : {}),
+        ...(blockedBy ? { blocked_by: blockedBy } : {}),
+        ...(entry.metadata ? { metadata: structuredClone(entry.metadata) } : {}),
+    };
+}
+function entrySignature(entry) {
+    return JSON.stringify(entry);
+}
+function compareEntries(left, right) {
+    return (left.id.localeCompare(right.id) ||
+        left.kind.localeCompare(right.kind) ||
+        left.availability.localeCompare(right.availability) ||
+        left.source.id.localeCompare(right.source.id) ||
+        left.source.detail.localeCompare(right.source.detail));
+}
+export function createCapabilityRegistry(entries = []) {
+    const seen = new Set();
+    const normalized = [];
+    for (const entry of entries) {
+        const candidate = normalizeEntry(entry);
+        const signature = entrySignature(candidate);
+        if (seen.has(signature))
+            continue;
+        seen.add(signature);
+        normalized.push(candidate);
+    }
+    normalized.sort(compareEntries);
+    return { entries: normalized };
+}
+export function mergeCapabilityRegistries(...registries) {
+    return createCapabilityRegistry(registries.flatMap((registry) => registry?.entries ?? []));
+}
+export function listCapabilities(registry, filter) {
+    return registry.entries.filter((entry) => {
+        if (filter?.availability && entry.availability !== filter.availability)
+            return false;
+        if (filter?.kind && entry.kind !== filter.kind)
+            return false;
+        if (filter?.source_id && entry.source.id !== filter.source_id)
+            return false;
+        return true;
+    });
+}
+export function getCapabilityEntries(registry, id) {
+    return registry.entries.filter((entry) => entry.id === id);
+}

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

@@ -0,0 +1,8 @@
+import type { RunnerAdapterCapabilities } from "../../runner/types.js";
+import type { AgentplaneCapabilityRegistry } from "./types.js";
+export declare function resolveRunnerAdapterCapabilityRegistry(opts: {
+    adapter_id: string;
+    capabilities: RunnerAdapterCapabilities | undefined;
+    requested?: Record<string, unknown>;
+}): AgentplaneCapabilityRegistry;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,KAAK,EAA6B,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAiB1F,wBAAgB,sCAAsC,CAAC,IAAI,EAAE;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,yBAAyB,GAAG,SAAS,CAAC;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,GAAG,4BAA4B,CAgE/B"}

package/dist/runtime/capabilities/runner.js

@@ -0,0 +1,73 @@
+import { createCapabilityRegistry } from "./registry.js";
+function source(adapterId) {
+    return {
+        id: "runner_adapter",
+        detail: adapterId,
+    };
+}
+function adapterCapabilityId(adapterId) {
+    return `runner.adapter.${adapterId}`;
+}
+function policyFieldCapabilityId(adapterId, fieldName) {
+    return `runner.adapter.${adapterId}.policy_field.${fieldName}`;
+}
+export function resolveRunnerAdapterCapabilityRegistry(opts) {
+    const adapterId = opts.capabilities?.adapter_id ?? opts.adapter_id;
+    const requested = opts.requested ?? {};
+    const entries = [
+        {
+            id: adapterCapabilityId(adapterId),
+            kind: "runner_adapter",
+            availability: "available",
+            source: source(adapterId),
+            summary: `Runner adapter ${adapterId}`,
+            metadata: {
+                adapter_id: adapterId,
+                declared_fields: Object.keys(opts.capabilities?.fields ?? {}).toSorted(),
+            },
+        },
+    ];
+    for (const [fieldName, capability] of Object.entries(opts.capabilities?.fields ?? {})) {
+        const hasRequest = Object.hasOwn(requested, fieldName);
+        const requestedValue = hasRequest ? requested[fieldName] : undefined;
+        const supportedValues = capability.supported_values
+            ? [...capability.supported_values]
+            : undefined;
+        const stringRequest = typeof requestedValue === "string" ? requestedValue : null;
+        const availability = capability.level === "unsupported"
+            ? "unavailable"
+            : stringRequest &&
+                Array.isArray(supportedValues) &&
+                !supportedValues.includes(stringRequest)
+                ? "blocked"
+                : "available";
+        entries.push({
+            id: policyFieldCapabilityId(adapterId, fieldName),
+            kind: "runner_policy_field",
+            availability,
+            source: source(adapterId),
+            summary: `Runner policy field ${fieldName}`,
+            ...(hasRequest ? { value: requestedValue } : {}),
+            ...(supportedValues ? { supported_values: supportedValues } : {}),
+            ...(availability === "unavailable"
+                ? {
+                    reason: "The adapter declares this policy field unsupported.",
+                }
+                : {}),
+            ...(availability === "blocked"
+                ? {
+                    reason: "The requested policy value is outside the adapter-supported set.",
+                    blocked_by: [adapterCapabilityId(adapterId)],
+                }
+                : {}),
+            metadata: {
+                adapter_id: adapterId,
+                field: fieldName,
+                level: capability.level,
+                channel: capability.channel,
+                ...(capability.note ? { note: capability.note } : {}),
+            },
+        });
+    }
+    return createCapabilityRegistry(entries);
+}

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

@@ -0,0 +1,28 @@
+export type AgentplaneCapabilityKind = "backend_field" | "command" | "scenario" | "skill" | "tool" | "agent" | "runner_adapter" | "runner_policy_field" | "policy";
+export type AgentplaneCapabilityAvailability = "available" | "blocked" | "unavailable";
+export type AgentplaneCapabilitySourceId = "backend" | "builtin" | "command_catalog" | "harness" | "policy" | "recipe_manifest" | "runner_adapter";
+export type AgentplaneCapabilitySourceRef = {
+    id: AgentplaneCapabilitySourceId;
+    detail: string;
+};
+export type AgentplaneCapabilityEntry = {
+    id: string;
+    kind: AgentplaneCapabilityKind;
+    availability: AgentplaneCapabilityAvailability;
+    source: AgentplaneCapabilitySourceRef;
+    summary?: string;
+    value?: unknown;
+    supported_values?: string[];
+    reason?: string;
+    blocked_by?: string[];
+    metadata?: Record<string, unknown>;
+};
+export type AgentplaneCapabilityRegistry = {
+    entries: AgentplaneCapabilityEntry[];
+};
+export type AgentplaneCapabilityFilter = {
+    availability?: AgentplaneCapabilityAvailability;
+    kind?: AgentplaneCapabilityKind;
+    source_id?: AgentplaneCapabilitySourceId;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/capabilities/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,SAAS,GACT,UAAU,GACV,OAAO,GACP,MAAM,GACN,OAAO,GACP,gBAAgB,GAChB,qBAAqB,GACrB,QAAQ,CAAC;AAEb,MAAM,MAAM,gCAAgC,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAEvF,MAAM,MAAM,4BAA4B,GACpC,SAAS,GACT,SAAS,GACT,iBAAiB,GACjB,SAAS,GACT,QAAQ,GACR,iBAAiB,GACjB,gBAAgB,CAAC;AAErB,MAAM,MAAM,6BAA6B,GAAG;IAC1C,EAAE,EAAE,4BAA4B,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,wBAAwB,CAAC;IAC/B,YAAY,EAAE,gCAAgC,CAAC;IAC/C,MAAM,EAAE,6BAA6B,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,CAAC,EAAE,gCAAgC,CAAC;IAChD,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,SAAS,CAAC,EAAE,4BAA4B,CAAC;CAC1C,CAAC"}

package/dist/runtime/capabilities/types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/execution-profile/index.d.ts

@@ -0,0 +1,3 @@
+export type { ExecutionBudgetCounter, ExecutionBudgetPhase, ResolvedExecutionProfileRuntime, } from "./types.js";
+export { consumeExecutionProfileBudget, resolveExecutionProfileRuntime } from "./resolve.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/execution-profile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/execution-profile/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC"}

package/dist/runtime/execution-profile/index.js

@@ -0,0 +1 @@
+export { consumeExecutionProfileBudget, resolveExecutionProfileRuntime } from "./resolve.js";

package/dist/runtime/execution-profile/resolve.d.ts

@@ -0,0 +1,9 @@
+import { type AgentplaneConfig } from "@agentplaneorg/core";
+import type { ExecutionBudgetPhase, ResolvedExecutionProfileRuntime } from "./types.js";
+export declare function resolveExecutionProfileRuntime(config: Pick<AgentplaneConfig, "agents" | "execution" | "runner">): ResolvedExecutionProfileRuntime;
+export declare function consumeExecutionProfileBudget(opts: {
+    runtime: ResolvedExecutionProfileRuntime;
+    phase: ExecutionBudgetPhase;
+    units?: number;
+}): ResolvedExecutionProfileRuntime;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/runtime/execution-profile/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/execution-profile/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvF,OAAO,KAAK,EAEV,oBAAoB,EACpB,+BAA+B,EAChC,MAAM,YAAY,CAAC;AAsCpB,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC,GAChE,+BAA+B,CA8BjC;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,OAAO,EAAE,+BAA+B,CAAC;IACzC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,+BAA+B,CAkBlC"}

package/dist/runtime/execution-profile/resolve.js

@@ -0,0 +1,80 @@
+import { applyExecutionToApprovals } from "@agentplaneorg/core";
+import { resolveRunnerTimeoutPolicy, resolveRunnerTracePolicy } from "../../runner/config.js";
+function toBudgetCounter(limit) {
+    return {
+        limit,
+        used: 0,
+        remaining: limit,
+        exhausted: limit <= 0,
+    };
+}
+function applyProfileToTracePolicy(config) {
+    const trace = resolveRunnerTracePolicy(config);
+    if (config.execution.profile === "conservative") {
+        return {
+            ...trace,
+            capture_stderr: true,
+            retention: "keep",
+        };
+    }
+    return trace;
+}
+function applyProfileToTimeoutPolicy(config) {
+    const timeout = resolveRunnerTimeoutPolicy(config);
+    if (config.execution.profile === "conservative") {
+        return {
+            ...timeout,
+            terminate_grace_ms: Math.max(timeout.terminate_grace_ms, 5000),
+        };
+    }
+    return timeout;
+}
+export function resolveExecutionProfileRuntime(config) {
+    const approvals = applyExecutionToApprovals({
+        execution: config.execution,
+        approvals: config.agents?.approvals ?? {
+            require_plan: false,
+            require_network: false,
+            require_verify: false,
+            require_force: false,
+        },
+    });
+    return {
+        profile: config.execution.profile,
+        reasoning_effort: config.execution.reasoning_effort,
+        budget: {
+            discovery: toBudgetCounter(config.execution.tool_budget.discovery),
+            implementation: toBudgetCounter(config.execution.tool_budget.implementation),
+            verification: toBudgetCounter(config.execution.tool_budget.verification),
+        },
+        stop_conditions: [...config.execution.stop_conditions],
+        handoff_conditions: [...config.execution.handoff_conditions],
+        unsafe_actions_requiring_explicit_user_ok: [
+            ...config.execution.unsafe_actions_requiring_explicit_user_ok,
+        ],
+        approvals,
+        runner: {
+            trace_policy: applyProfileToTracePolicy(config),
+            timeout_policy: applyProfileToTimeoutPolicy(config),
+        },
+    };
+}
+export function consumeExecutionProfileBudget(opts) {
+    const units = Math.max(0, Math.trunc(opts.units ?? 1));
+    const current = opts.runtime.budget[opts.phase];
+    const used = current.used + units;
+    const limit = current.limit;
+    const nextCounter = {
+        limit,
+        used,
+        remaining: Math.max(0, limit - used),
+        exhausted: used >= limit,
+    };
+    return {
+        ...opts.runtime,
+        budget: {
+            ...opts.runtime.budget,
+            [opts.phase]: nextCounter,
+        },
+    };
+}

package/dist/runtime/execution-profile/types.d.ts

@@ -0,0 +1,27 @@
+import type { AgentplaneConfig, RunnerTimeoutConfig, RunnerTraceConfig } from "@agentplaneorg/core";
+export type ExecutionBudgetPhase = keyof AgentplaneConfig["execution"]["tool_budget"];
+export type ExecutionBudgetCounter = {
+    limit: number;
+    used: number;
+    remaining: number;
+    exhausted: boolean;
+};
+export type ResolvedExecutionProfileRuntime = {
+    profile: AgentplaneConfig["execution"]["profile"];
+    reasoning_effort: AgentplaneConfig["execution"]["reasoning_effort"];
+    budget: Record<ExecutionBudgetPhase, ExecutionBudgetCounter>;
+    stop_conditions: string[];
+    handoff_conditions: string[];
+    unsafe_actions_requiring_explicit_user_ok: string[];
+    approvals: {
+        require_plan: boolean;
+        require_network: boolean;
+        require_verify: boolean;
+        require_force?: boolean;
+    };
+    runner: {
+        trace_policy: RunnerTraceConfig;
+        timeout_policy: RunnerTimeoutConfig;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/execution-profile/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/execution-profile/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEpG,MAAM,MAAM,oBAAoB,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC,CAAC;AAEtF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,gBAAgB,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,kBAAkB,CAAC,CAAC;IACpE,MAAM,EAAE,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;IAC7D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yCAAyC,EAAE,MAAM,EAAE,CAAC;IACpD,SAAS,EAAE;QACT,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,MAAM,EAAE;QACN,YAAY,EAAE,iBAAiB,CAAC;QAChC,cAAc,EAAE,mBAAmB,CAAC;KACrC,CAAC;CACH,CAAC"}

package/dist/runtime/execution-profile/types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/explain/index.d.ts

@@ -0,0 +1,3 @@
+export { appendFrameworkExplainBehaviorInputs, buildFrameworkExplainPayload } from "./resolve.js";
+export type { ExplainBehaviorInput, ExplainBehaviorInputCategory, FrameworkExplainPayload, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/explain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/explain/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oCAAoC,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAClG,YAAY,EACV,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,YAAY,CAAC"}

package/dist/runtime/explain/index.js

@@ -0,0 +1 @@
+export { appendFrameworkExplainBehaviorInputs, buildFrameworkExplainPayload } from "./resolve.js";

package/dist/runtime/explain/resolve.d.ts

@@ -0,0 +1,14 @@
+import type { AgentplaneCapabilityRegistry } from "../capabilities/index.js";
+import type { ResolvedExecutionProfileRuntime } from "../execution-profile/index.js";
+import type { ResolvedHarnessContract } from "../harness/index.js";
+import type { TaskIntakeRuntime } from "../task-intake/index.js";
+import type { ExplainBehaviorInput, FrameworkExplainPayload } from "./types.js";
+export declare function buildFrameworkExplainPayload(opts: {
+    harness: ResolvedHarnessContract;
+    capabilities: AgentplaneCapabilityRegistry;
+    execution_profile: ResolvedExecutionProfileRuntime;
+    task_intake: TaskIntakeRuntime;
+    behavior_inputs?: readonly ExplainBehaviorInput[];
+}): FrameworkExplainPayload;
+export declare function appendFrameworkExplainBehaviorInputs(payload: FrameworkExplainPayload, behavior_inputs: readonly ExplainBehaviorInput[]): FrameworkExplainPayload;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/runtime/explain/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/runtime/explain/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA4BhF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IACjD,OAAO,EAAE,uBAAuB,CAAC;IACjC,YAAY,EAAE,4BAA4B,CAAC;IAC3C,iBAAiB,EAAE,+BAA+B,CAAC;IACnD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,eAAe,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD,GAAG,uBAAuB,CAkB1B;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,uBAAuB,EAChC,eAAe,EAAE,SAAS,oBAAoB,EAAE,GAC/C,uBAAuB,CAQzB"}

package/dist/runtime/explain/resolve.js

@@ -0,0 +1,50 @@
+function normalizeBehaviorInputs(inputs) {
+    const seen = new Set();
+    const out = [];
+    for (const input of inputs) {
+        const id = input.id.trim();
+        if (!id)
+            throw new Error("Explain behavior inputs require a non-empty id.");
+        const signature = `${input.category}:${id}:${input.source ?? ""}:${input.resolution.key}`;
+        if (seen.has(signature))
+            continue;
+        seen.add(signature);
+        out.push({
+            id,
+            category: input.category,
+            ...(input.source?.trim() ? { source: input.source.trim() } : {}),
+            resolution: structuredClone(input.resolution),
+        });
+    }
+    return out.toSorted((left, right) => left.category.localeCompare(right.category) ||
+        left.id.localeCompare(right.id) ||
+        (left.source ?? "").localeCompare(right.source ?? ""));
+}
+export function buildFrameworkExplainPayload(opts) {
+    return {
+        schema_version: 1,
+        harness: structuredClone(opts.harness),
+        policy: {
+            approvals: structuredClone(opts.harness.policy.approvals),
+            protected_paths: structuredClone(opts.harness.policy.protected_paths),
+            unsafe_actions_requiring_explicit_user_ok: [
+                ...opts.harness.policy.unsafe_actions_requiring_explicit_user_ok,
+            ],
+        },
+        capabilities: structuredClone(opts.capabilities),
+        runtime: {
+            execution_profile: structuredClone(opts.execution_profile),
+            task_intake: structuredClone(opts.task_intake),
+        },
+        behavior_inputs: normalizeBehaviorInputs(opts.behavior_inputs ?? []),
+    };
+}
+export function appendFrameworkExplainBehaviorInputs(payload, behavior_inputs) {
+    return buildFrameworkExplainPayload({
+        harness: payload.harness,
+        capabilities: payload.capabilities,
+        execution_profile: payload.runtime.execution_profile,
+        task_intake: payload.runtime.task_intake,
+        behavior_inputs: [...payload.behavior_inputs, ...behavior_inputs],
+    });
+}

package/dist/runtime/explain/types.d.ts

@@ -0,0 +1,28 @@
+import type { BehaviorResolutionTrace } from "../behavior/index.js";
+import type { AgentplaneCapabilityRegistry } from "../capabilities/index.js";
+import type { ResolvedExecutionProfileRuntime } from "../execution-profile/index.js";
+import type { ResolvedHarnessContract } from "../harness/index.js";
+import type { TaskIntakeRuntime } from "../task-intake/index.js";
+export type ExplainBehaviorInputCategory = "prompt" | "behavior";
+export type ExplainBehaviorInput = {
+    id: string;
+    category: ExplainBehaviorInputCategory;
+    source?: string;
+    resolution: BehaviorResolutionTrace<Record<string, unknown>>;
+};
+export type FrameworkExplainPayload = {
+    schema_version: 1;
+    harness: ResolvedHarnessContract;
+    policy: {
+        approvals: ResolvedHarnessContract["policy"]["approvals"];
+        protected_paths: ResolvedHarnessContract["policy"]["protected_paths"];
+        unsafe_actions_requiring_explicit_user_ok: string[];
+    };
+    capabilities: AgentplaneCapabilityRegistry;
+    runtime: {
+        execution_profile: ResolvedExecutionProfileRuntime;
+        task_intake: TaskIntakeRuntime;
+    };
+    behavior_inputs: ExplainBehaviorInput[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/explain/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/explain/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,MAAM,4BAA4B,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,4BAA4B,CAAC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE;QACN,SAAS,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC;QAC1D,eAAe,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACtE,yCAAyC,EAAE,MAAM,EAAE,CAAC;KACrD,CAAC;IACF,YAAY,EAAE,4BAA4B,CAAC;IAC3C,OAAO,EAAE;QACP,iBAAiB,EAAE,+BAA+B,CAAC;QACnD,WAAW,EAAE,iBAAiB,CAAC;KAChC,CAAC;IACF,eAAe,EAAE,oBAAoB,EAAE,CAAC;CACzC,CAAC"}

package/dist/runtime/explain/types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/harness/index.d.ts

@@ -0,0 +1,4 @@
+export { resolveHarnessContract } from "./resolve.js";
+export { resolveHarnessFromCommandContext } from "./resolve-from-command-context.js";
+export type { HarnessSourceId, HarnessSourceRef, HarnessTraceField, ResolvedHarnessContract, ResolvedHarnessTrace, ResolvedProtectedPathGroups, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gCAAgC,EAAE,MAAM,mCAAmC,CAAC;AACrF,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/dist/runtime/harness/index.js

@@ -0,0 +1,2 @@
+export { resolveHarnessContract } from "./resolve.js";
+export { resolveHarnessFromCommandContext } from "./resolve-from-command-context.js";

package/dist/runtime/harness/resolve-from-command-context.d.ts

@@ -0,0 +1,4 @@
+import type { CommandContext } from "../../commands/shared/task-backend.js";
+import type { ResolvedHarnessContract } from "./types.js";
+export declare function resolveHarnessFromCommandContext(ctx: CommandContext): Promise<ResolvedHarnessContract>;
+//# sourceMappingURL=resolve-from-command-context.d.ts.map

package/dist/runtime/harness/resolve-from-command-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-from-command-context.d.ts","sourceRoot":"","sources":["../../../src/runtime/harness/resolve-from-command-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAG5E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,wBAAsB,gCAAgC,CACpD,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,uBAAuB,CAAC,CASlC"}