@kilnai/core 0.1.0

package/dist/verification/gate-runner.js.map

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

package/dist/verification/index.d.ts

@@ -0,0 +1,24 @@
+/** Verification check result */
+export interface VerificationCheck {
+    readonly name: string;
+    readonly passed: boolean;
+    readonly output: string;
+    readonly duration: number;
+}
+/** Full verification result */
+export interface VerificationResult {
+    readonly passed: boolean;
+    readonly checks: readonly VerificationCheck[];
+    readonly iteration: number;
+    readonly maxIterations: number;
+}
+/** Verification loop configuration */
+export interface VerificationConfig {
+    readonly maxIterations: number;
+    readonly coverageThreshold: number;
+}
+export { GateRunner } from "./gate-runner.js";
+export { VerificationLoop } from "./verification-loop.js";
+export type { FixHandler, GateRunnerPort } from "./verification-loop.js";
+export { parseCoverageFromOutput, checkCoverage } from "./coverage-parser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verification/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/verification/index.js

@@ -0,0 +1,4 @@
+export { GateRunner } from "./gate-runner.js";
+export { VerificationLoop } from "./verification-loop.js";
+export { parseCoverageFromOutput, checkCoverage } from "./coverage-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/verification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verification/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/verification/verification-loop.d.ts

@@ -0,0 +1,32 @@
+import type { EventBus } from "../events/event-bus.js";
+import type { QualityGate } from "../engine/composites/team.js";
+import type { VerificationCheck, VerificationResult, VerificationConfig } from "./index.js";
+/** Port for running quality gates (allows mocking in tests) */
+export interface GateRunnerPort {
+    runRequired(gates: readonly QualityGate[]): Promise<{
+        passed: boolean;
+        checks: VerificationCheck[];
+    }>;
+}
+/** Handler called between iterations to fix failing gates */
+export type FixHandler = (failedChecks: readonly VerificationCheck[]) => Promise<void>;
+/**
+ * Iterative verification loop: runs quality gates, optionally retries with a fix handler,
+ * and emits verification_result events on each iteration.
+ */
+export declare class VerificationLoop {
+    private readonly gateRunner;
+    private readonly eventBus;
+    private readonly config;
+    private readonly gates;
+    private readonly sessionId;
+    constructor(opts: {
+        gateRunner: GateRunnerPort;
+        eventBus: EventBus;
+        config: VerificationConfig;
+        gates: readonly QualityGate[];
+        sessionId?: string;
+    });
+    run(fixHandler?: FixHandler): Promise<VerificationResult>;
+}
+//# sourceMappingURL=verification-loop.d.ts.map

package/dist/verification/verification-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-loop.d.ts","sourceRoot":"","sources":["../../src/verification/verification-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAG5F,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,WAAW,CACT,KAAK,EAAE,SAAS,WAAW,EAAE,GAC5B,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,QAAQ,EAAE,QAAQ,CAAC;QACnB,MAAM,EAAE,kBAAkB,CAAC;QAC3B,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;IAQK,GAAG,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA0DhE"}

package/dist/verification/verification-loop.js

@@ -0,0 +1,71 @@
+import { checkCoverage } from "./coverage-parser.js";
+/**
+ * Iterative verification loop: runs quality gates, optionally retries with a fix handler,
+ * and emits verification_result events on each iteration.
+ */
+export class VerificationLoop {
+    gateRunner;
+    eventBus;
+    config;
+    gates;
+    sessionId;
+    constructor(opts) {
+        this.gateRunner = opts.gateRunner;
+        this.eventBus = opts.eventBus;
+        this.config = opts.config;
+        this.gates = opts.gates;
+        this.sessionId = opts.sessionId ?? "";
+    }
+    async run(fixHandler) {
+        for (let iteration = 1; iteration <= this.config.maxIterations; iteration++) {
+            const gateResult = await this.gateRunner.runRequired(this.gates);
+            const checks = [...gateResult.checks];
+            let passed = gateResult.passed;
+            // Coverage threshold check
+            if (this.config.coverageThreshold > 0) {
+                const testCheck = checks.find((c) => c.name.toLowerCase().includes("test"));
+                if (testCheck) {
+                    const cov = checkCoverage(testCheck.output, this.config.coverageThreshold);
+                    if (!cov.passed) {
+                        checks.push({
+                            name: "coverage",
+                            passed: false,
+                            output: `Coverage ${cov.coverage ?? 0}% below threshold ${this.config.coverageThreshold}%`,
+                            duration: 0,
+                        });
+                        passed = false;
+                    }
+                }
+            }
+            const result = {
+                passed,
+                checks,
+                iteration,
+                maxIterations: this.config.maxIterations,
+            };
+            // Emit event
+            const event = {
+                type: "verification_result",
+                passed: result.passed,
+                iteration,
+                maxIterations: this.config.maxIterations,
+                checks: result.checks.map((c) => ({ name: c.name, passed: c.passed, output: c.output })),
+                timestamp: new Date(),
+                sessionId: this.sessionId,
+            };
+            this.eventBus.emit(event);
+            if (passed) {
+                return result;
+            }
+            if (iteration < this.config.maxIterations && fixHandler) {
+                const failedChecks = checks.filter((c) => !c.passed);
+                await fixHandler(failedChecks);
+                continue;
+            }
+            return result;
+        }
+        // Unreachable in practice (loop always returns), but satisfies TypeScript
+        throw new Error("VerificationLoop: unexpected exit");
+    }
+}
+//# sourceMappingURL=verification-loop.js.map

package/dist/verification/verification-loop.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@kilnai/core",
+  "version": "0.1.0",
+  "description": "Domain-agnostic AI orchestration engine -- 7 primitives, 3 composites, YAML-configured",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sequelcore/kiln.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/sequelcore/kiln/tree/main/packages/core",
+  "keywords": [
+    "ai",
+    "orchestration",
+    "multi-agent",
+    "yaml",
+    "llm",
+    "anthropic",
+    "openai",
+    "mcp"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.74.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "yaml": "^2.8.2"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentelemetry/api": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  }
+}