@kilnai/core 0.1.0

package/dist/observability/span-mapper.js

@@ -0,0 +1,375 @@
+// Observability: SpanMapper -- pure, stateless mapping from KilnEvent to SpanOperation descriptors.
+// Zero external dependencies. Exhaustive switch with TypeScript never-guard.
+// ---------------------------------------------------------------------------
+// Individual mappers (typed helpers to keep the switch concise)
+// ---------------------------------------------------------------------------
+function mapPhaseChanged(e) {
+    return {
+        action: "startSpan",
+        name: e.phaseName || e.phase,
+        kind: "phase",
+        attributes: { phase: e.phase, phaseName: e.phaseName, phaseDescription: e.phaseDescription },
+    };
+}
+function mapTaskStarted(e) {
+    return {
+        action: "startSpan",
+        name: e.statement,
+        kind: "task",
+        attributes: {
+            taskId: e.taskId,
+            statement: e.statement,
+            ...(e.parentId !== null ? { parentId: e.parentId } : {}),
+        },
+    };
+}
+function mapTaskCompleted(e) {
+    return {
+        action: "endSpan",
+        status: e.status === "failed" ? "error" : "ok",
+        attributes: { taskId: e.taskId, status: e.status, action: e.action },
+    };
+}
+function mapToolCalled(e) {
+    return {
+        action: "startSpan",
+        name: e.toolName,
+        kind: "tool",
+        attributes: {
+            toolName: e.toolName,
+            ...(e.taskId !== undefined ? { taskId: e.taskId } : {}),
+            ...(e.workerIndex !== undefined ? { workerIndex: e.workerIndex } : {}),
+        },
+    };
+}
+function mapToolResult(e) {
+    return {
+        action: "endSpan",
+        status: e.success ? "ok" : "error",
+        attributes: {
+            toolName: e.toolName,
+            ...(e.taskId !== undefined ? { taskId: e.taskId } : {}),
+            durationMs: e.durationMs,
+            success: e.success,
+        },
+    };
+}
+function mapThinking(e) {
+    return {
+        action: "addEvent",
+        name: "thinking",
+        attributes: { role: e.role, content: e.content.slice(0, 512) },
+    };
+}
+function mapVerificationResult(e) {
+    return {
+        action: "addEvent",
+        name: "verification",
+        attributes: {
+            passed: e.passed,
+            iteration: e.iteration,
+            maxIterations: e.maxIterations,
+            checksCount: e.checks.length,
+        },
+    };
+}
+function mapCostUpdate(e) {
+    return {
+        action: "setAttributes",
+        attributes: {
+            inputTokens: e.inputTokens,
+            outputTokens: e.outputTokens,
+            cacheReadTokens: e.cacheReadTokens,
+            totalCostUsd: e.totalCostUsd,
+        },
+    };
+}
+function mapMemorySaved(e) {
+    return {
+        action: "addEvent",
+        name: "memory.saved",
+        attributes: { memoryId: e.memoryId, layer: e.layer, tags: e.tags.join(",") },
+    };
+}
+function mapMemoryRecalled(e) {
+    return {
+        action: "addEvent",
+        name: "memory.recalled",
+        attributes: { query: e.query.slice(0, 256), resultsCount: e.resultsCount },
+    };
+}
+function mapMemorySync(e) {
+    return {
+        action: "addEvent",
+        name: "memory.sync",
+        attributes: { imported: e.imported, entries: e.entries, developers: e.developers },
+    };
+}
+function mapApprovalRequested(e) {
+    return {
+        action: "addEvent",
+        name: "approval.requested",
+        attributes: { taskId: e.taskId, description: e.description.slice(0, 256) },
+    };
+}
+function mapApprovalReceived(e) {
+    return {
+        action: "addEvent",
+        name: "approval.received",
+        attributes: { taskId: e.taskId, approved: e.approved },
+    };
+}
+function mapWorkerAssigned(e) {
+    return {
+        action: "startSpan",
+        name: `worker-${e.workerIndex}`,
+        kind: "agent",
+        attributes: { workerIndex: e.workerIndex, taskId: e.taskId },
+    };
+}
+function mapError(e) {
+    return {
+        action: "endSpan",
+        status: "error",
+        attributes: {
+            "exception.message": e.message,
+            "exception.type": e.code,
+            ...(e.taskId !== null ? { taskId: e.taskId } : {}),
+        },
+    };
+}
+function mapTraceSpan(e) {
+    return {
+        action: "addEvent",
+        name: "trace_span",
+        attributes: {
+            spanId: e.span.spanId,
+            traceId: e.span.traceId,
+            spanName: e.span.name,
+            spanKind: e.span.kind,
+            spanStatus: e.span.status,
+            ...(e.span.parentSpanId !== null ? { parentSpanId: e.span.parentSpanId } : {}),
+        },
+    };
+}
+function mapHandoffRequested(e) {
+    return {
+        action: "addEvent",
+        name: "handoff.requested",
+        attributes: { fromAgent: e.fromAgent, toAgent: e.toAgent, reason: e.reason.slice(0, 256) },
+    };
+}
+function mapHandoffCompleted(e) {
+    return {
+        action: "addEvent",
+        name: "handoff.completed",
+        attributes: { fromAgent: e.fromAgent, toAgent: e.toAgent, accepted: e.accepted },
+    };
+}
+function mapInterruptRequested(e) {
+    return {
+        action: "addEvent",
+        name: "interrupt.requested",
+        attributes: { checkpointId: e.checkpointId, reason: e.reason.slice(0, 256) },
+    };
+}
+function mapInterruptResumed(e) {
+    return {
+        action: "addEvent",
+        name: "interrupt.resumed",
+        attributes: { checkpointId: e.checkpointId },
+    };
+}
+function mapInjectionScanned(e) {
+    return {
+        action: "addEvent",
+        name: "security.injection_scan",
+        attributes: { safe: e.safe, threats: e.threats, tier: e.tier, inputPreview: e.inputPreview.slice(0, 256) },
+    };
+}
+function mapGuardianReviewed(e) {
+    return {
+        action: "addEvent",
+        name: "security.guardian_review",
+        attributes: {
+            approved: e.approved,
+            capabilityName: e.capabilityName,
+            agentName: e.agentName,
+            riskLevel: e.riskLevel,
+            reason: e.reason.slice(0, 256),
+        },
+    };
+}
+function mapAuditEntry(e) {
+    return {
+        action: "addEvent",
+        name: "security.audit",
+        attributes: { action: e.action, actor: e.actor, outcome: e.outcome, resource: e.resource },
+    };
+}
+function mapTenantIsolationViolation(e) {
+    return {
+        action: "addEvent",
+        name: "security.tenant_violation",
+        attributes: { tenantId: e.tenantId, resource: e.attemptedResource, blockedBy: e.blockedBy },
+    };
+}
+function mapSecurityAlert(e) {
+    return {
+        action: "addEvent",
+        name: "security.alert",
+        attributes: { severity: e.severity, category: e.category, message: e.message.slice(0, 256) },
+    };
+}
+function mapWebhookReceived(e) {
+    return {
+        action: "startSpan",
+        name: "trigger.webhook",
+        kind: "trigger",
+        attributes: { path: e.path, appName: e.appName, triggerName: e.triggerName, method: e.method },
+    };
+}
+function mapTriggerFired(e) {
+    return {
+        action: "addEvent",
+        name: "trigger.fired",
+        attributes: { triggerName: e.triggerName, triggerType: e.triggerType, team: e.team, task: e.task },
+    };
+}
+function mapTriggerFailed(e) {
+    return {
+        action: "endSpan",
+        status: "error",
+        attributes: {
+            triggerName: e.triggerName,
+            triggerType: e.triggerType,
+            "exception.message": e.error,
+        },
+    };
+}
+function mapScheduleFired(e) {
+    return {
+        action: "addEvent",
+        name: "trigger.schedule_fired",
+        attributes: { triggerName: e.triggerName, cron: e.cron, team: e.team },
+    };
+}
+function mapPiiDetected(e) {
+    return {
+        action: "addEvent",
+        name: "safety.pii_detected",
+        attributes: {
+            direction: e.direction,
+            piiTypes: e.piiTypes.join(","),
+            action: e.action,
+            count: e.count,
+            tier: e.tier,
+        },
+    };
+}
+function mapContentClassified(e) {
+    return {
+        action: "addEvent",
+        name: "safety.content_classified",
+        attributes: {
+            direction: e.direction,
+            blocked: e.blocked,
+            tier: e.tier,
+        },
+    };
+}
+function mapPolicyEvaluated(e) {
+    return {
+        action: "addEvent",
+        name: "safety.policy_evaluated",
+        attributes: {
+            railType: e.railType,
+            allowed: e.allowed,
+            direction: e.direction,
+            ...(e.reason ? { reason: e.reason.slice(0, 256) } : {}),
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Maps a KilnEvent to a SpanOperation descriptor.
+ * Exhaustive -- adding a new EventType without updating this switch is a compile error.
+ */
+export function mapEventToSpan(event) {
+    switch (event.type) {
+        case "phase_changed":
+            return mapPhaseChanged(event);
+        case "task_started":
+            return mapTaskStarted(event);
+        case "task_completed":
+            return mapTaskCompleted(event);
+        case "tool_called":
+            return mapToolCalled(event);
+        case "tool_result":
+            return mapToolResult(event);
+        case "thinking":
+            return mapThinking(event);
+        case "verification_result":
+            return mapVerificationResult(event);
+        case "cost_update":
+            return mapCostUpdate(event);
+        case "memory_saved":
+            return mapMemorySaved(event);
+        case "memory_recalled":
+            return mapMemoryRecalled(event);
+        case "memory_sync":
+            return mapMemorySync(event);
+        case "approval_requested":
+            return mapApprovalRequested(event);
+        case "approval_received":
+            return mapApprovalReceived(event);
+        case "worker_assigned":
+            return mapWorkerAssigned(event);
+        case "error":
+            return mapError(event);
+        case "trace_span":
+            return mapTraceSpan(event);
+        case "handoff_requested":
+            return mapHandoffRequested(event);
+        case "handoff_completed":
+            return mapHandoffCompleted(event);
+        case "interrupt_requested":
+            return mapInterruptRequested(event);
+        case "interrupt_resumed":
+            return mapInterruptResumed(event);
+        case "injection_scanned":
+            return mapInjectionScanned(event);
+        case "guardian_reviewed":
+            return mapGuardianReviewed(event);
+        case "audit_entry":
+            return mapAuditEntry(event);
+        case "tenant_isolation_violation":
+            return mapTenantIsolationViolation(event);
+        case "security_alert":
+            return mapSecurityAlert(event);
+        case "webhook_received":
+            return mapWebhookReceived(event);
+        case "trigger_fired":
+            return mapTriggerFired(event);
+        case "trigger_failed":
+            return mapTriggerFailed(event);
+        case "schedule_fired":
+            return mapScheduleFired(event);
+        case "pii_detected":
+            return mapPiiDetected(event);
+        case "content_classified":
+            return mapContentClassified(event);
+        case "policy_evaluated":
+            return mapPolicyEvaluated(event);
+        default: {
+            // Exhaustiveness guard: TypeScript will produce a compile error here if a new
+            // EventType is added without a corresponding case above, because event.type
+            // narrows to `never` when all cases are covered.
+            const _exhaustive = event.type;
+            throw new Error(`Unhandled event type: ${_exhaustive}`);
+        }
+    }
+}
+//# sourceMappingURL=span-mapper.js.map

package/dist/observability/span-mapper.js.map

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

package/dist/orchestrator/checkpoint-store.d.ts

@@ -0,0 +1,9 @@
+import type { Checkpoint, CheckpointOptions } from "./checkpoint-types.js";
+export interface CheckpointStore {
+    save(checkpoint: Checkpoint, options?: CheckpointOptions): Promise<void>;
+    load(id: string): Promise<Checkpoint | null>;
+    listBySession(sessionId: string): Promise<readonly Checkpoint[]>;
+    listChildren(parentId: string): Promise<readonly Checkpoint[]>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=checkpoint-store.d.ts.map

package/dist/orchestrator/checkpoint-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-store.d.ts","sourceRoot":"","sources":["../../src/orchestrator/checkpoint-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC7C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACjE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/orchestrator/checkpoint-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkpoint-store.js.map

package/dist/orchestrator/checkpoint-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-store.js","sourceRoot":"","sources":["../../src/orchestrator/checkpoint-store.ts"],"names":[],"mappings":""}

package/dist/orchestrator/checkpoint-types.d.ts

@@ -0,0 +1,30 @@
+import type { OrchestratorStatus } from "./index.js";
+import type { TaskNode, TreeConfig } from "../tree/index.js";
+import type { KilnEvent } from "../events/index.js";
+import type { CostSummary } from "../cost/index.js";
+export interface Checkpoint {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly parentId: string | null;
+    readonly phase: string;
+    readonly phaseIndex: number;
+    readonly status: OrchestratorStatus;
+    readonly task: string;
+    readonly tree: {
+        readonly nodes: readonly TaskNode[];
+        readonly config: TreeConfig;
+    };
+    readonly eventHistory: readonly KilnEvent[];
+    readonly costSummary: CostSummary;
+    readonly timestamp: Date;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface CheckpointOptions {
+    readonly metadata?: Record<string, unknown>;
+}
+export interface ReplayOverrides {
+    readonly task?: string;
+    readonly startPhase?: string;
+    readonly metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=checkpoint-types.d.ts.map

package/dist/orchestrator/checkpoint-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-types.d.ts","sourceRoot":"","sources":["../../src/orchestrator/checkpoint-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C"}

package/dist/orchestrator/checkpoint-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkpoint-types.js.map

package/dist/orchestrator/checkpoint-types.js.map

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

package/dist/orchestrator/guardrails.d.ts

@@ -0,0 +1,23 @@
+/** Result of guardrail validation */
+export interface GuardrailResult {
+    readonly passed: boolean;
+    readonly errors: readonly string[];
+    readonly retryFeedback?: string;
+}
+/**
+ * Validate structured output against a JSON Schema subset.
+ * Supports: type, required, properties, enum, minLength, maxLength,
+ * minimum, maximum, items. Max recursion depth: 5.
+ */
+export declare function validateJsonSchema(value: unknown, schema: Record<string, unknown>, path?: string, depth?: number): GuardrailResult;
+/**
+ * Validate capability output against its schema.
+ * Convenience wrapper around validateJsonSchema.
+ */
+export declare function validateOutput(output: unknown, schema: Record<string, unknown>): GuardrailResult;
+/**
+ * Run guardrail validation with retry loop.
+ * Calls the handler, validates output, retries with feedback on failure.
+ */
+export declare function withGuardrail<T>(handler: (feedback?: string) => Promise<T>, schema: Record<string, unknown>, maxRetries?: number, onRetry?: (attempt: number, feedback: string) => void): Promise<T>;
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/orchestrator/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/orchestrator/guardrails.ts"],"names":[],"mappings":"AAKA,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,SAAM,EACV,KAAK,SAAI,GACR,eAAe,CA4EjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,eAAe,CAEjB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,SAAI,EACd,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACpD,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/orchestrator/guardrails.js

@@ -0,0 +1,136 @@
+// Guardrail validation: validate agent output against JSON Schema subset
+// Pure functions, zero external dependencies
+import { KilnError } from "../engine/errors.js";
+/**
+ * Validate structured output against a JSON Schema subset.
+ * Supports: type, required, properties, enum, minLength, maxLength,
+ * minimum, maximum, items. Max recursion depth: 5.
+ */
+export function validateJsonSchema(value, schema, path = "$", depth = 0) {
+    if (depth > 5) {
+        return { passed: true, errors: [] };
+    }
+    const errors = [];
+    // type check
+    if (schema.type !== undefined) {
+        const schemaType = schema.type;
+        if (!checkType(value, schemaType)) {
+            errors.push(`${path}: expected type "${schemaType}", got ${typeof value}`);
+            return makeResult(errors);
+        }
+    }
+    // enum check
+    if (schema.enum !== undefined && Array.isArray(schema.enum)) {
+        if (!schema.enum.includes(value)) {
+            errors.push(`${path}: value must be one of [${schema.enum.join(", ")}]`);
+        }
+    }
+    // string constraints
+    if (typeof value === "string") {
+        if (typeof schema.minLength === "number" && value.length < schema.minLength) {
+            errors.push(`${path}: string length ${value.length} < minLength ${schema.minLength}`);
+        }
+        if (typeof schema.maxLength === "number" && value.length > schema.maxLength) {
+            errors.push(`${path}: string length ${value.length} > maxLength ${schema.maxLength}`);
+        }
+    }
+    // number constraints
+    if (typeof value === "number") {
+        if (typeof schema.minimum === "number" && value < schema.minimum) {
+            errors.push(`${path}: value ${value} < minimum ${schema.minimum}`);
+        }
+        if (typeof schema.maximum === "number" && value > schema.maximum) {
+            errors.push(`${path}: value ${value} > maximum ${schema.maximum}`);
+        }
+    }
+    // object: required + properties
+    if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+        const obj = value;
+        if (Array.isArray(schema.required)) {
+            for (const key of schema.required) {
+                if (!(key in obj)) {
+                    errors.push(`${path}: missing required property "${key}"`);
+                }
+            }
+        }
+        if (typeof schema.properties === "object" && schema.properties !== null) {
+            const props = schema.properties;
+            for (const [key, propSchema] of Object.entries(props)) {
+                if (key in obj) {
+                    const subResult = validateJsonSchema(obj[key], propSchema, `${path}.${key}`, depth + 1);
+                    errors.push(...subResult.errors);
+                }
+            }
+        }
+    }
+    // array: items
+    if (Array.isArray(value) && typeof schema.items === "object" && schema.items !== null) {
+        const itemSchema = schema.items;
+        for (let i = 0; i < value.length; i++) {
+            const subResult = validateJsonSchema(value[i], itemSchema, `${path}[${i}]`, depth + 1);
+            errors.push(...subResult.errors);
+        }
+    }
+    return makeResult(errors);
+}
+/**
+ * Validate capability output against its schema.
+ * Convenience wrapper around validateJsonSchema.
+ */
+export function validateOutput(output, schema) {
+    return validateJsonSchema(output, schema);
+}
+/**
+ * Run guardrail validation with retry loop.
+ * Calls the handler, validates output, retries with feedback on failure.
+ */
+export async function withGuardrail(handler, schema, maxRetries = 3, onRetry) {
+    let lastFeedback;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const result = await handler(lastFeedback);
+        const validation = validateJsonSchema(result, schema);
+        if (validation.passed) {
+            return result;
+        }
+        if (attempt < maxRetries) {
+            lastFeedback = validation.retryFeedback ?? validation.errors.join("; ");
+            onRetry?.(attempt + 1, lastFeedback);
+        }
+        else {
+            throw new KilnError("GUARDRAIL_FAILED", `Output validation failed after ${maxRetries + 1} attempts: ${validation.errors.join("; ")}`, {
+                context: { errors: validation.errors, attempts: maxRetries + 1 },
+            });
+        }
+    }
+    // Unreachable, but TypeScript needs it
+    throw new KilnError("GUARDRAIL_FAILED", "Guardrail loop exhausted");
+}
+function checkType(value, expected) {
+    switch (expected) {
+        case "string":
+            return typeof value === "string";
+        case "number":
+        case "integer":
+            return typeof value === "number" && (expected !== "integer" || Number.isInteger(value));
+        case "boolean":
+            return typeof value === "boolean";
+        case "object":
+            return typeof value === "object" && value !== null && !Array.isArray(value);
+        case "array":
+            return Array.isArray(value);
+        case "null":
+            return value === null;
+        default:
+            return true;
+    }
+}
+function makeResult(errors) {
+    return {
+        passed: errors.length === 0,
+        errors,
+        retryFeedback: errors.length > 0
+            ? `Validation failed: ${errors.join("; ")}. Please fix and try again.`
+            : undefined,
+    };
+}
+//# sourceMappingURL=guardrails.js.map

package/dist/orchestrator/guardrails.js.map

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