@executioncontrolprotocol/runtime 0.3.0

package/dist/mounts/types.js

@@ -0,0 +1,10 @@
+/**
+ * Types for the staged mount hydration system.
+ *
+ * Mounts retrieve data from external tool servers in three stages
+ * (seed → focus → deep) to avoid blowing up the context window.
+ *
+ * @category Mounts
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mounts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mounts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/policies/enforcer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Default policy enforcer implementation.
+ *
+ * Enforces tool access controls, budget limits, and write barriers
+ * as declared in an executor's {@link Policies} definition.
+ *
+ * @category Policies
+ */
+import type { Policies } from "@executioncontrolprotocol/spec";
+import type { PolicyEnforcer } from "./types.js";
+/**
+ * Creates a {@link PolicyEnforcer} from an executor's declared policies.
+ *
+ * The enforcer is stateless — it evaluates each check against the
+ * executor's policy declaration and the current budget usage.
+ *
+ * @param policies - The executor's declared policies.
+ * @returns A policy enforcer bound to those policies.
+ *
+ * @category Policies
+ */
+export declare function createPolicyEnforcer(policies: Policies): PolicyEnforcer;
+//# sourceMappingURL=enforcer.d.ts.map

package/dist/policies/enforcer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcer.d.ts","sourceRoot":"","sources":["../../src/policies/enforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAEvE"}

package/dist/policies/enforcer.js

@@ -0,0 +1,111 @@
+/**
+ * Default policy enforcer implementation.
+ *
+ * Enforces tool access controls, budget limits, and write barriers
+ * as declared in an executor's {@link Policies} definition.
+ *
+ * @category Policies
+ */
+/**
+ * Creates a {@link PolicyEnforcer} from an executor's declared policies.
+ *
+ * The enforcer is stateless — it evaluates each check against the
+ * executor's policy declaration and the current budget usage.
+ *
+ * @param policies - The executor's declared policies.
+ * @returns A policy enforcer bound to those policies.
+ *
+ * @category Policies
+ */
+export function createPolicyEnforcer(policies) {
+    return new DefaultPolicyEnforcer(policies);
+}
+class DefaultPolicyEnforcer {
+    policies;
+    constructor(policies) {
+        this.policies = policies;
+    }
+    checkToolAccess(toolName) {
+        const access = this.policies.toolAccess;
+        if (!access) {
+            return { allowed: true };
+        }
+        if (access.default === "deny") {
+            const allowed = access.allow ?? [];
+            if (allowed.includes(toolName)) {
+                return { allowed: true };
+            }
+            return {
+                allowed: false,
+                reason: `Tool "${toolName}" is not in the allow list (default: deny).`,
+            };
+        }
+        if (access.default === "allow") {
+            const denied = access.deny ?? [];
+            if (denied.includes(toolName)) {
+                return {
+                    allowed: false,
+                    reason: `Tool "${toolName}" is explicitly denied.`,
+                };
+            }
+            return { allowed: true };
+        }
+        return { allowed: true };
+    }
+    checkBudget(usage) {
+        const budgets = this.policies.budgets;
+        if (!budgets) {
+            return { withinBudget: true };
+        }
+        if (budgets.maxToolCalls !== undefined && usage.toolCalls >= budgets.maxToolCalls) {
+            return {
+                withinBudget: false,
+                exceededLimit: "tool-calls",
+                message: `Tool call limit exceeded: ${usage.toolCalls} >= ${budgets.maxToolCalls}`,
+            };
+        }
+        if (budgets.maxRuntimeSeconds !== undefined &&
+            usage.runtimeSeconds >= budgets.maxRuntimeSeconds) {
+            return {
+                withinBudget: false,
+                exceededLimit: "runtime-seconds",
+                message: `Runtime limit exceeded: ${usage.runtimeSeconds}s >= ${budgets.maxRuntimeSeconds}s`,
+            };
+        }
+        return { withinBudget: true };
+    }
+    checkWrite(toolName) {
+        const controls = this.policies.writeControls;
+        if (!controls) {
+            return { allowed: true, requiresApproval: false };
+        }
+        switch (controls.mode) {
+            case "forbid":
+                return {
+                    allowed: false,
+                    requiresApproval: false,
+                    reason: `Write operations are forbidden for this executor.`,
+                };
+            case "propose-only": {
+                const needsApproval = controls.requireApprovalFor ?? [];
+                if (needsApproval.includes(toolName)) {
+                    return {
+                        allowed: false,
+                        requiresApproval: true,
+                        reason: `Tool "${toolName}" requires approval before execution.`,
+                    };
+                }
+                return {
+                    allowed: false,
+                    requiresApproval: true,
+                    reason: `Write operations require approval (mode: propose-only).`,
+                };
+            }
+            case "execute-if-allowed":
+                return { allowed: true, requiresApproval: false };
+            default:
+                return { allowed: true, requiresApproval: false };
+        }
+    }
+}
+//# sourceMappingURL=enforcer.js.map

package/dist/policies/enforcer.js.map

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

package/dist/policies/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./enforcer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/policies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/policies/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/policies/index.js

@@ -0,0 +1,3 @@
+export * from "./types.js";
+export * from "./enforcer.js";
+//# sourceMappingURL=index.js.map

package/dist/policies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/policies/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/policies/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Types for the policy enforcement system.
+ *
+ * Policies are checked at the executor level before every tool call
+ * and throughout the executor's runtime to enforce budgets, tool
+ * access controls, and write barriers.
+ *
+ * @category Policies
+ */
+import type { Policies } from "@executioncontrolprotocol/spec";
+import type { BudgetUsage } from "../engine/types.js";
+/**
+ * The result of checking whether a tool call is allowed.
+ *
+ * @category Policies
+ */
+export interface ToolAccessDecision {
+    /** Whether the tool call is permitted. */
+    allowed: boolean;
+    /** If denied, the reason. */
+    reason?: string;
+}
+/**
+ * The result of checking whether budget limits have been exceeded.
+ *
+ * @category Policies
+ */
+export interface BudgetCheckResult {
+    /** Whether the executor is still within budget. */
+    withinBudget: boolean;
+    /** Which limit was exceeded, if any. */
+    exceededLimit?: "tool-calls" | "runtime-seconds";
+    /** Human-readable message. */
+    message?: string;
+}
+/**
+ * The result of checking whether a write operation is allowed.
+ *
+ * @category Policies
+ */
+export interface WriteDecision {
+    /** Whether the write is permitted. */
+    allowed: boolean;
+    /** Whether the write requires human approval. */
+    requiresApproval: boolean;
+    /** If denied or requiring approval, the reason. */
+    reason?: string;
+}
+/**
+ * Interface for the policy enforcement service.
+ *
+ * Created per-executor with the executor's declared policies.
+ *
+ * @category Policies
+ */
+export interface PolicyEnforcer {
+    /**
+     * Check whether a specific tool call is allowed by the executor's
+     * tool access policy.
+     *
+     * @param toolName - The fully-qualified tool name (e.g. `"jira:issues.search"`).
+     * @returns The access decision.
+     */
+    checkToolAccess(toolName: string): ToolAccessDecision;
+    /**
+     * Check whether the executor is still within its budget limits.
+     *
+     * @param usage - The current budget consumption.
+     * @returns Whether the executor is within budget.
+     */
+    checkBudget(usage: BudgetUsage): BudgetCheckResult;
+    /**
+     * Check whether a write operation is allowed.
+     *
+     * @param toolName - The tool that would perform the write.
+     * @returns The write decision.
+     */
+    checkWrite(toolName: string): WriteDecision;
+}
+/**
+ * Factory function type for creating a {@link PolicyEnforcer} from
+ * an executor's declared policies.
+ *
+ * @category Policies
+ */
+export type PolicyEnforcerFactory = (policies: Policies) => PolicyEnforcer;
+//# sourceMappingURL=types.d.ts.map

package/dist/policies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/policies/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IAEjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;IAEtB,wCAAwC;IACxC,aAAa,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAAC;IAEjD,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,iDAAiD;IACjD,gBAAgB,EAAE,OAAO,CAAC;IAE1B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAEtD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAAC;IAEnD;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,cAAc,CAAC"}

package/dist/policies/types.js

@@ -0,0 +1,11 @@
+/**
+ * Types for the policy enforcement system.
+ *
+ * Policies are checked at the executor level before every tool call
+ * and throughout the executor's runtime to enforce budgets, tool
+ * access controls, and write barriers.
+ *
+ * @category Policies
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/policies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/policies/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/protocols/a2a/a2a-transport.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A2A implementation of the {@link AgentTransport} interface.
+ *
+ * Uses the official `@a2a-js/sdk` to communicate with remote
+ * A2A-compliant agents. Each specialist executor maps to a remote
+ * agent endpoint.
+ *
+ * @category Protocols
+ */
+import type { AgentTransport, AgentRef, AgentCapabilities, DelegatedTask, DelegationResult } from "../agent-transport.js";
+/**
+ * Options for the A2A agent transport.
+ *
+ * @category Protocols
+ */
+export interface A2ATransportConfig {
+    /** Timeout in ms for sendMessage calls. Defaults to 60_000. */
+    timeoutMs?: number;
+}
+/**
+ * A2A-backed agent transport for delegating tasks to specialist executors.
+ *
+ * @category Protocols
+ */
+export declare class A2AAgentTransport implements AgentTransport {
+    readonly name = "a2a";
+    private agents;
+    private factory;
+    private timeoutMs;
+    constructor(config?: A2ATransportConfig);
+    capabilities(agent: AgentRef): Promise<AgentCapabilities>;
+    delegate(agent: AgentRef, task: DelegatedTask): Promise<DelegationResult>;
+    close(): Promise<void>;
+    private ensureConnected;
+    private pollForCompletion;
+    private extractStatusMessage;
+    private extractOutput;
+    private extractPartsOutput;
+}
+//# sourceMappingURL=a2a-transport.d.ts.map

package/dist/protocols/a2a/a2a-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-transport.d.ts","sourceRoot":"","sources":["../../../src/protocols/a2a/a2a-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,cAAc;IACtD,QAAQ,CAAC,IAAI,SAAS;IAEtB,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,kBAAuB;IAIrC,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoBzD,QAAQ,CACZ,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAkFtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,eAAe;YAUf,iBAAiB;IA4C/B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,kBAAkB;CAoB3B"}

package/dist/protocols/a2a/a2a-transport.js

@@ -0,0 +1,212 @@
+/**
+ * A2A implementation of the {@link AgentTransport} interface.
+ *
+ * Uses the official `@a2a-js/sdk` to communicate with remote
+ * A2A-compliant agents. Each specialist executor maps to a remote
+ * agent endpoint.
+ *
+ * @category Protocols
+ */
+import { ClientFactory, } from "@a2a-js/sdk/client";
+/**
+ * A2A-backed agent transport for delegating tasks to specialist executors.
+ *
+ * @category Protocols
+ */
+export class A2AAgentTransport {
+    name = "a2a";
+    agents = new Map();
+    factory = new ClientFactory();
+    timeoutMs;
+    constructor(config = {}) {
+        this.timeoutMs = config.timeoutMs ?? 60_000;
+    }
+    async capabilities(agent) {
+        const connected = await this.ensureConnected(agent);
+        const transport = connected.client.transport;
+        try {
+            const card = await transport.getExtendedAgentCard();
+            return {
+                name: card.name ?? agent.name,
+                skills: (card.skills ?? []).map((s) => s.name ?? s.id ?? "unknown"),
+                supportsStreaming: card.capabilities?.streaming ?? false,
+            };
+        }
+        catch {
+            return {
+                name: agent.name,
+                skills: [],
+                supportsStreaming: false,
+            };
+        }
+    }
+    async delegate(agent, task) {
+        const connected = await this.ensureConnected(agent);
+        const transport = connected.client.transport;
+        const messageContent = JSON.stringify({
+            executorName: task.executorName,
+            task: task.task,
+            context: task.context,
+            hints: task.hints,
+        });
+        try {
+            const result = await transport.sendMessage({
+                message: {
+                    kind: "message",
+                    role: "user",
+                    parts: [{ kind: "text", text: messageContent }],
+                    messageId: task.id,
+                },
+                configuration: {
+                    blocking: true,
+                },
+            });
+            if ("status" in result && result.status) {
+                const taskResult = result;
+                if (taskResult.status.state === "completed") {
+                    const output = this.extractOutput(taskResult);
+                    return {
+                        taskId: task.id,
+                        executorName: task.executorName,
+                        output,
+                        success: true,
+                    };
+                }
+                if (taskResult.status.state === "failed") {
+                    return {
+                        taskId: task.id,
+                        executorName: task.executorName,
+                        output: {},
+                        success: false,
+                        error: this.extractStatusMessage(taskResult.status) ?? "Task failed",
+                    };
+                }
+                return await this.pollForCompletion(transport, taskResult.id ?? task.id, task);
+            }
+            if ("parts" in result) {
+                const output = this.extractPartsOutput(result.parts ?? []);
+                return {
+                    taskId: task.id,
+                    executorName: task.executorName,
+                    output,
+                    success: true,
+                };
+            }
+            return {
+                taskId: task.id,
+                executorName: task.executorName,
+                output: {},
+                success: false,
+                error: "Unexpected response format from A2A agent",
+            };
+        }
+        catch (err) {
+            return {
+                taskId: task.id,
+                executorName: task.executorName,
+                output: {},
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    async close() {
+        this.agents.clear();
+    }
+    async ensureConnected(agent) {
+        const existing = this.agents.get(agent.name);
+        if (existing)
+            return existing;
+        const client = await this.factory.createFromUrl(agent.endpoint);
+        const connected = { client, ref: agent };
+        this.agents.set(agent.name, connected);
+        return connected;
+    }
+    async pollForCompletion(transport, taskId, task) {
+        const deadline = Date.now() + this.timeoutMs;
+        const pollInterval = 1000;
+        while (Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, pollInterval));
+            const taskState = await transport.getTask({ id: taskId });
+            if ("status" in taskState && taskState.status) {
+                if (taskState.status.state === "completed") {
+                    return {
+                        taskId: task.id,
+                        executorName: task.executorName,
+                        output: this.extractOutput(taskState),
+                        success: true,
+                    };
+                }
+                if (taskState.status.state === "failed") {
+                    return {
+                        taskId: task.id,
+                        executorName: task.executorName,
+                        output: {},
+                        success: false,
+                        error: this.extractStatusMessage(taskState.status) ?? "Task failed",
+                    };
+                }
+            }
+        }
+        return {
+            taskId: task.id,
+            executorName: task.executorName,
+            output: {},
+            success: false,
+            error: `Task timed out after ${this.timeoutMs}ms`,
+        };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extractStatusMessage(status) {
+        if (!status?.message)
+            return undefined;
+        const msg = status.message;
+        if (typeof msg === "string")
+            return msg;
+        if (msg.parts) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return msg.parts.filter((p) => p.kind === "text").map((p) => p.text).join(" ");
+        }
+        return String(msg);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extractOutput(taskResult) {
+        const artifacts = taskResult.artifacts ?? [];
+        if (artifacts.length > 0) {
+            const parts = artifacts.flatMap(
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            (a) => a.parts ?? []);
+            return this.extractPartsOutput(parts);
+        }
+        const history = taskResult.history ?? [];
+        if (history.length > 0) {
+            const lastMsg = history[history.length - 1];
+            if (lastMsg?.parts) {
+                return this.extractPartsOutput(lastMsg.parts);
+            }
+        }
+        return {};
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extractPartsOutput(parts) {
+        const textParts = parts
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .filter((p) => p.kind === "text" && p.text)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            .map((p) => p.text);
+        if (textParts.length === 0)
+            return {};
+        const combined = textParts.join("\n");
+        try {
+            const parsed = JSON.parse(combined);
+            if (typeof parsed === "object" && parsed !== null) {
+                return parsed;
+            }
+            return { result: parsed };
+        }
+        catch {
+            return { result: combined };
+        }
+    }
+}
+//# sourceMappingURL=a2a-transport.js.map

package/dist/protocols/a2a/a2a-transport.js.map

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

package/dist/protocols/a2a/index.d.ts

@@ -0,0 +1,3 @@
+export { A2AAgentTransport } from "./a2a-transport.js";
+export type { A2ATransportConfig } from "./a2a-transport.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocols/a2a/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/protocols/a2a/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/protocols/a2a/index.js

@@ -0,0 +1,2 @@
+export { A2AAgentTransport } from "./a2a-transport.js";
+//# sourceMappingURL=index.js.map

package/dist/protocols/a2a/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/protocols/a2a/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}