@kilnai/core 0.23.2 → 1.0.1

package/dist/tools/mcp/dev-tools-server.js.map

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

package/dist/tools/tool-executor.d.ts

@@ -0,0 +1,34 @@
+import type { RetryConfig, ToolAuthorizer, ToolExecutionResult } from "../engine/domain/tool-execution.js";
+import type { ToolResult } from "./domain/tool.js";
+import { DevToolRegistry } from "./domain/tool-registry.js";
+export interface DevToolExecutionRequest {
+    readonly name: string;
+    readonly input: Record<string, unknown>;
+    readonly sandbox?: unknown;
+    readonly retry?: RetryConfig;
+}
+export interface DevToolExecutionBridgeOptions {
+    readonly registry: DevToolRegistry;
+    readonly authorizer?: ToolAuthorizer;
+}
+export interface DevToolExecutionResult extends ToolExecutionResult {
+    readonly result: ToolResult;
+}
+export interface DevToolAuthorizationDecision {
+    readonly toolName: string;
+    readonly level: number;
+    readonly allowed: boolean;
+    readonly requiresApproval: boolean;
+    readonly reason: string;
+}
+export declare class DevToolExecutionBridge {
+    private readonly registry;
+    private readonly authorizer?;
+    constructor(options: DevToolExecutionBridgeOptions);
+    execute(request: DevToolExecutionRequest): Promise<DevToolExecutionResult>;
+    authorizeRequest(name: string): DevToolAuthorizationDecision;
+    private executeSingle;
+    private authorize;
+    private getAuthorizationDecision;
+}
+//# sourceMappingURL=tool-executor.d.ts.map

package/dist/tools/tool-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/tools/tool-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,mBAAmB,EACpB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAW,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;CACtC;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAiB;gBAEjC,OAAO,EAAE,6BAA6B;IAK5C,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA0DhF,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,4BAA4B;YAY9C,aAAa;IAiB3B,OAAO,CAAC,SAAS;IAyBjB,OAAO,CAAC,wBAAwB;CAwBjC"}

package/dist/tools/tool-executor.js

@@ -0,0 +1,123 @@
+import { executeWithRetry } from "../agents/tool-execution-engine.js";
+import { KilnError } from "../engine/errors.js";
+export class DevToolExecutionBridge {
+    registry;
+    authorizer;
+    constructor(options) {
+        this.registry = options.registry;
+        this.authorizer = options.authorizer;
+    }
+    async execute(request) {
+        const primaryTool = this.registry.lookup(request.name);
+        if (!primaryTool) {
+            throw new KilnError("INTERNAL_ERROR", `Tool "${request.name}" is not registered`, {
+                context: { toolName: request.name },
+                retryable: false,
+            });
+        }
+        this.authorize(primaryTool);
+        if (request.retry?.fallback && !this.registry.lookup(request.retry.fallback)) {
+            throw new KilnError("INTERNAL_ERROR", `Fallback tool "${request.retry.fallback}" is not registered`, {
+                context: { fallbackToolName: request.retry.fallback },
+                retryable: false,
+            });
+        }
+        const executor = async (toolName, input) => {
+            return await this.executeSingle(toolName, input, request.sandbox);
+        };
+        const fallbackExecutor = request.retry?.fallback ? executor : undefined;
+        const execution = await executeWithRetry(request.name, request.input, executor, request.retry, fallbackExecutor);
+        if (!isToolResult(execution.result)) {
+            throw new KilnError("INTERNAL_ERROR", `Tool "${request.name}" returned an invalid result shape`, {
+                context: {
+                    toolName: request.name,
+                    resultType: typeof execution.result,
+                },
+                retryable: false,
+            });
+        }
+        return {
+            ...execution,
+            result: execution.result,
+        };
+    }
+    authorizeRequest(name) {
+        const tool = this.registry.lookup(name);
+        if (!tool) {
+            throw new KilnError("INTERNAL_ERROR", `Tool "${name}" is not registered`, {
+                context: { toolName: name },
+                retryable: false,
+            });
+        }
+        return this.getAuthorizationDecision(tool);
+    }
+    async executeSingle(toolName, input, sandbox) {
+        const tool = this.registry.lookup(toolName);
+        if (!tool) {
+            throw new KilnError("INTERNAL_ERROR", `Tool "${toolName}" is not registered`, {
+                context: { toolName },
+                retryable: false,
+            });
+        }
+        this.authorize(tool);
+        return await tool.execute({ name: toolName, input }, sandbox);
+    }
+    authorize(tool) {
+        const decision = this.getAuthorizationDecision(tool);
+        if (!decision.allowed) {
+            throw new KilnError("TOOL_AUTHORIZATION_DENIED", decision.reason, {
+                context: {
+                    toolName: tool.name,
+                    level: decision.level,
+                },
+                retryable: false,
+            });
+        }
+        if (decision.requiresApproval) {
+            throw new KilnError("TOOL_APPROVAL_REQUIRED", decision.reason, {
+                context: {
+                    toolName: tool.name,
+                    level: decision.level,
+                    requiresApproval: true,
+                },
+                retryable: false,
+            });
+        }
+    }
+    getAuthorizationDecision(tool) {
+        if (!this.authorizer) {
+            return {
+                toolName: tool.name,
+                level: 2,
+                allowed: true,
+                requiresApproval: false,
+                reason: "Audited execution",
+            };
+        }
+        const decision = this.authorizer.authorize(tool.name, tool.annotations);
+        return {
+            toolName: tool.name,
+            level: decision.level,
+            allowed: decision.allowed,
+            requiresApproval: decision.requiresApproval,
+            reason: decision.reason,
+        };
+    }
+}
+function isToolResult(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const candidate = value;
+    if (typeof candidate.output !== "string") {
+        return false;
+    }
+    if (typeof candidate.isError !== "boolean") {
+        return false;
+    }
+    if (candidate.metadata !== undefined && typeof candidate.metadata !== "object") {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=tool-executor.js.map

package/dist/tools/tool-executor.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kilnai/core",
-  "version": "0.23.2",
-  "description": "Domain-agnostic AI orchestration engine -- 7 primitives, 3 composites, YAML-configured",
+  "version": "1.0.1",
+  "description": "Cybernetic control plane for agentic systems with governed context, memory, safety, and execution",
   "type": "module",
   "exports": {
     ".": {
@@ -19,7 +19,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/sequelcore/kiln.git",
@@ -28,8 +28,8 @@
   "homepage": "https://github.com/sequelcore/kiln/tree/main/packages/core",
   "keywords": [
     "ai",
-    "orchestration",
-    "multi-agent",
+    "control-plane",
+    "agentic",
     "yaml",
     "llm",
     "anthropic",
@@ -40,6 +40,7 @@
     "access": "public"
   },
   "dependencies": {
+    "@kilnai/tools": "^1.0.1",
     "@anthropic-ai/sdk": "^0.74.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "yaml": "^2.8.2"

package/dist/orchestrator/strategies/swarm-strategy.d.ts

@@ -1,36 +0,0 @@
-import type { ExecutionStrategy, StrategyContext, StrategyHandler } from "./index.js";
-import type { TaskNode } from "../../tree/index.js";
-/** Handoff request parsed from agent output */
-export interface HandoffRequest {
-    readonly targetAgent: string;
-    readonly reason: string;
-    readonly context?: Record<string, unknown>;
-}
-/** Configuration for swarm behavior */
-export interface SwarmConfig {
-    readonly maxHandoffDepth: number;
-}
-/**
- * Swarm mode: agents hand control to each other via handoff capabilities.
- * No central coordinator. Active agent tracked per-task.
- *
- * Flow:
- * 1. Start with first agent in the agents map
- * 2. Active agent processes the current task
- * 3. If agent output indicates a handoff, control transfers to target agent
- * 4. Continue until no more handoffs (agent completes without handoff)
- *
- * Cycle detection: track handoff chain, error if same agent seen twice in one task.
- * Max handoff depth per task (configurable, default 10).
- */
-export declare class SwarmStrategy implements ExecutionStrategy {
-    private readonly config;
-    constructor(config?: Partial<SwarmConfig>);
-    execute(context: StrategyContext, handler: StrategyHandler): Promise<TaskNode[]>;
-    /**
-     * Parse a handoff request from agent output.
-     * Returns null if no handoff is indicated.
-     */
-    private parseHandoff;
-}
-//# sourceMappingURL=swarm-strategy.d.ts.map

package/dist/orchestrator/strategies/swarm-strategy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"swarm-strategy.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/strategies/swarm-strategy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAMD;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAInC,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAqFtF;;;OAGG;IACH,OAAO,CAAC,YAAY;CA0BrB"}

package/dist/orchestrator/strategies/swarm-strategy.js

@@ -1,126 +0,0 @@
-// Swarm strategy: agents hand control to each other via handoff capabilities
-// No central coordinator. Active agent tracked per-task.
-const DEFAULT_SWARM_CONFIG = {
-    maxHandoffDepth: 10,
-};
-/**
- * Swarm mode: agents hand control to each other via handoff capabilities.
- * No central coordinator. Active agent tracked per-task.
- *
- * Flow:
- * 1. Start with first agent in the agents map
- * 2. Active agent processes the current task
- * 3. If agent output indicates a handoff, control transfers to target agent
- * 4. Continue until no more handoffs (agent completes without handoff)
- *
- * Cycle detection: track handoff chain, error if same agent seen twice in one task.
- * Max handoff depth per task (configurable, default 10).
- */
-export class SwarmStrategy {
-    config;
-    constructor(config) {
-        this.config = { ...DEFAULT_SWARM_CONFIG, ...config };
-    }
-    async execute(context, handler) {
-        const { team, tree, eventBus, sessionId } = context;
-        const agentKeys = Object.keys(team.agents);
-        if (agentKeys.length < 2) {
-            throw new Error("Swarm strategy requires at least 2 agents");
-        }
-        while (!tree.isComplete) {
-            const batch = tree.selectBatch();
-            if (batch.length === 0)
-                break;
-            for (const task of batch) {
-                try {
-                    let activeAgent = agentKeys[0];
-                    const visitedAgents = new Set();
-                    let handoffCount = 0;
-                    let taskCompleted = false;
-                    while (!taskCompleted) {
-                        // Cycle detection -- mark task as refuted instead of aborting batch
-                        if (visitedAgents.has(activeAgent)) {
-                            tree.updateStatus(task.id, "refuted");
-                            break;
-                        }
-                        visitedAgents.add(activeAgent);
-                        // Depth check -- mark task as refuted instead of aborting batch
-                        if (handoffCount >= this.config.maxHandoffDepth) {
-                            tree.updateStatus(task.id, "refuted");
-                            break;
-                        }
-                        // Execute with active agent
-                        const result = await handler(task, handoffCount, activeAgent);
-                        // Record evidence
-                        for (const evidence of result.evidence) {
-                            tree.addEvidence(task.id, evidence);
-                        }
-                        // Check for handoff in the output
-                        const handoff = this.parseHandoff(result.output, agentKeys);
-                        if (handoff) {
-                            // Emit handoff events
-                            const handoffRequest = {
-                                type: "handoff_requested",
-                                fromAgent: activeAgent,
-                                toAgent: handoff.targetAgent,
-                                reason: handoff.reason,
-                                context: handoff.context,
-                                timestamp: new Date(),
-                                sessionId,
-                            };
-                            eventBus.emit(handoffRequest);
-                            const handoffComplete = {
-                                type: "handoff_completed",
-                                fromAgent: activeAgent,
-                                toAgent: handoff.targetAgent,
-                                accepted: true,
-                                timestamp: new Date(),
-                                sessionId,
-                            };
-                            eventBus.emit(handoffComplete);
-                            activeAgent = handoff.targetAgent;
-                            handoffCount++;
-                        }
-                        else {
-                            // No handoff -- task is complete
-                            tree.updateStatus(task.id, result.success ? "supported" : "refuted");
-                            taskCompleted = true;
-                        }
-                    }
-                }
-                catch {
-                    // Handler error -- mark task as refuted, continue with remaining tasks
-                    tree.updateStatus(task.id, "refuted");
-                }
-            }
-        }
-        return tree.allNodes;
-    }
-    /**
-     * Parse a handoff request from agent output.
-     * Returns null if no handoff is indicated.
-     */
-    parseHandoff(output, agentKeys) {
-        try {
-            const parsed = JSON.parse(output);
-            if (typeof parsed === "object" &&
-                parsed !== null &&
-                parsed.type === "handoff" &&
-                typeof parsed.targetAgent === "string" &&
-                agentKeys.includes(parsed.targetAgent)) {
-                return {
-                    targetAgent: parsed.targetAgent,
-                    reason: typeof parsed.reason === "string" ? parsed.reason : "",
-                    context: typeof parsed.context === "object" && parsed.context !== null
-                        ? parsed.context
-                        : undefined,
-                };
-            }
-        }
-        catch {
-            // Not valid JSON or not a handoff -- no handoff
-        }
-        return null;
-    }
-}
-//# sourceMappingURL=swarm-strategy.js.map

package/dist/orchestrator/strategies/swarm-strategy.js.map

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