@kilnai/core 0.1.0

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

@@ -0,0 +1,13 @@
+import type { ExecutionStrategy, StrategyContext, StrategyHandler } from "./index.js";
+import type { TaskNode } from "../../tree/index.js";
+/**
+ * Sequential mode: select batches from the tree, execute via BatchExecutor,
+ * record evidence and status updates. Identical to the original Orchestrator
+ * runImplementLoop behavior.
+ *
+ * The first agent in the team's agents map is used for all tasks.
+ */
+export declare class SequentialStrategy implements ExecutionStrategy {
+    execute(context: StrategyContext, handler: StrategyHandler): Promise<TaskNode[]>;
+}
+//# sourceMappingURL=sequential-strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-strategy.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/strategies/sequential-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;AAEpD;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IACpD,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsBvF"}

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

@@ -0,0 +1,29 @@
+// Sequential strategy: default team execution mode
+// Extracts existing runImplementLoop behavior from Orchestrator
+/**
+ * Sequential mode: select batches from the tree, execute via BatchExecutor,
+ * record evidence and status updates. Identical to the original Orchestrator
+ * runImplementLoop behavior.
+ *
+ * The first agent in the team's agents map is used for all tasks.
+ */
+export class SequentialStrategy {
+    async execute(context, handler) {
+        const { team, tree, batchExecutor } = context;
+        const defaultAgent = Object.keys(team.agents)[0] ?? "worker";
+        while (!tree.isComplete) {
+            const batch = tree.selectBatch();
+            if (batch.length === 0)
+                break;
+            const results = await batchExecutor.execute(batch, (task, workerIndex) => handler(task, workerIndex, defaultAgent));
+            for (const result of results) {
+                for (const evidence of result.evidence) {
+                    tree.addEvidence(result.taskId, evidence);
+                }
+                tree.updateStatus(result.taskId, result.success ? "supported" : "refuted");
+            }
+        }
+        return tree.allNodes;
+    }
+}
+//# sourceMappingURL=sequential-strategy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-strategy.js","sourceRoot":"","sources":["../../../src/orchestrator/strategies/sequential-strategy.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,gEAAgE;AAKhE;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,OAAO,CAAC,OAAwB,EAAE,OAAwB;QAC9D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;QAC9C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;QAE7D,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM;YAE9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,CACvE,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,CACzC,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACvC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC5C,CAAC;gBACD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,43 @@
+import type { ExecutionStrategy, StrategyContext, StrategyHandler } from "./index.js";
+import type { TaskNode } from "../../tree/index.js";
+/** Manager's delegation decision */
+export interface DelegationDecision {
+    readonly assignTo: string;
+    readonly instructions: string;
+}
+/** Manager's review of a worker's result */
+export interface ReviewDecision {
+    readonly accepted: boolean;
+    readonly feedback?: string;
+}
+/** Configuration for supervisor behavior */
+export interface SupervisorConfig {
+    readonly maxRetriesPerTask: number;
+}
+/**
+ * Supervisor mode: manager agent receives all tasks, delegates to workers
+ * by name, and validates results.
+ *
+ * Flow:
+ * 1. Select batch from tree
+ * 2. For each task, call handler with manager agent name (manager decides delegation)
+ * 3. If the result output contains a delegation decision, call handler with the assigned worker
+ * 4. Record evidence and advance
+ *
+ * In practice, the handler callback is responsible for:
+ * - When called with the manager agent: returning a DelegationDecision as structured output
+ * - When called with a worker agent: executing the task
+ *
+ * The strategy orchestrates the delegation flow and emits handoff events.
+ */
+export declare class SupervisorStrategy implements ExecutionStrategy {
+    private readonly config;
+    constructor(config?: Partial<SupervisorConfig>);
+    execute(context: StrategyContext, handler: StrategyHandler): Promise<TaskNode[]>;
+    /**
+     * Parse a delegation decision from the manager's output.
+     * Tries to parse JSON; falls back to assigning to first worker.
+     */
+    private parseDelegation;
+}
+//# sourceMappingURL=supervisor-strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-strategy.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/strategies/supervisor-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,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,YAAW,iBAAiB;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAIxC,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2EtF;;;OAGG;IACH,OAAO,CAAC,eAAe;CAwBxB"}

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

@@ -0,0 +1,118 @@
+// Supervisor strategy: manager agent delegates tasks to workers
+// Manager decides which worker handles each task, then reviews results
+const DEFAULT_SUPERVISOR_CONFIG = {
+    maxRetriesPerTask: 2,
+};
+/**
+ * Supervisor mode: manager agent receives all tasks, delegates to workers
+ * by name, and validates results.
+ *
+ * Flow:
+ * 1. Select batch from tree
+ * 2. For each task, call handler with manager agent name (manager decides delegation)
+ * 3. If the result output contains a delegation decision, call handler with the assigned worker
+ * 4. Record evidence and advance
+ *
+ * In practice, the handler callback is responsible for:
+ * - When called with the manager agent: returning a DelegationDecision as structured output
+ * - When called with a worker agent: executing the task
+ *
+ * The strategy orchestrates the delegation flow and emits handoff events.
+ */
+export class SupervisorStrategy {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_SUPERVISOR_CONFIG, ...config };
+    }
+    async execute(context, handler) {
+        const { team, tree, eventBus, sessionId } = context;
+        const managerKey = team.manager;
+        if (!managerKey) {
+            throw new Error("Supervisor strategy requires a manager agent");
+        }
+        const workerKeys = Object.keys(team.agents).filter((k) => k !== managerKey);
+        if (workerKeys.length === 0) {
+            throw new Error("Supervisor strategy requires at least one worker agent besides the manager");
+        }
+        while (!tree.isComplete) {
+            const batch = tree.selectBatch();
+            if (batch.length === 0)
+                break;
+            // Process tasks sequentially through the supervisor -- manager must see each task
+            for (const task of batch) {
+                let assigned = false;
+                let retries = 0;
+                while (!assigned && retries <= this.config.maxRetriesPerTask) {
+                    // Step 1: Manager decides delegation
+                    const managerResult = await handler(task, 0, managerKey);
+                    // Parse delegation decision from manager output
+                    const decision = this.parseDelegation(managerResult.output, workerKeys);
+                    // Emit handoff request
+                    const handoffRequest = {
+                        type: "handoff_requested",
+                        fromAgent: managerKey,
+                        toAgent: decision.assignTo,
+                        reason: decision.instructions,
+                        timestamp: new Date(),
+                        sessionId,
+                    };
+                    eventBus.emit(handoffRequest);
+                    // Step 2: Worker executes task
+                    const workerResult = await handler(task, retries + 1, decision.assignTo);
+                    // Emit handoff completion
+                    const handoffComplete = {
+                        type: "handoff_completed",
+                        fromAgent: managerKey,
+                        toAgent: decision.assignTo,
+                        accepted: workerResult.success,
+                        timestamp: new Date(),
+                        sessionId,
+                    };
+                    eventBus.emit(handoffComplete);
+                    // Record evidence from worker
+                    for (const evidence of workerResult.evidence) {
+                        tree.addEvidence(task.id, evidence);
+                    }
+                    if (workerResult.success) {
+                        tree.updateStatus(task.id, "supported");
+                        assigned = true;
+                    }
+                    else {
+                        retries++;
+                        if (retries > this.config.maxRetriesPerTask) {
+                            tree.updateStatus(task.id, "refuted");
+                        }
+                    }
+                }
+            }
+        }
+        return tree.allNodes;
+    }
+    /**
+     * Parse a delegation decision from the manager's output.
+     * Tries to parse JSON; falls back to assigning to first worker.
+     */
+    parseDelegation(output, workerKeys) {
+        try {
+            const parsed = JSON.parse(output);
+            if (typeof parsed === "object" &&
+                parsed !== null &&
+                typeof parsed.assignTo === "string" &&
+                workerKeys.includes(parsed.assignTo)) {
+                return {
+                    assignTo: parsed.assignTo,
+                    instructions: typeof parsed.instructions === "string" ? parsed.instructions : "",
+                };
+            }
+        }
+        catch {
+            // Not valid JSON -- fall through to default
+        }
+        // Default: assign to first available worker
+        return {
+            assignTo: workerKeys[0],
+            instructions: output,
+        };
+    }
+}
+//# sourceMappingURL=supervisor-strategy.js.map

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

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

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

@@ -0,0 +1,36 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,126 @@
+// 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

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

package/dist/package/index.d.ts

@@ -0,0 +1,7 @@
+export type { PackageManifest, SkillPackageManifest, PackageToolsConfig, PackageKnowledgeConfig, } from "./types.js";
+export type { PackageYaml, PackageToolsYaml, PackageKnowledgeYaml } from "./yaml-schema.js";
+export { validatePackageYaml } from "./yaml-schema.js";
+export { PackageYamlError, parseSkillPackageYaml, loadSkillPackageYaml, } from "./yaml-parser.js";
+export type { SecurityValidationResult } from "./security.js";
+export { computeContentHash, validatePackageSecurity, applyDefaultAnnotations, validatePackageFiles, } from "./security.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/package/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}

package/dist/package/index.js

@@ -0,0 +1,6 @@
+// Package: distribution infrastructure for domain and skill packages
+// Handles versioning, bundling, security -- separate from domain config
+export { validatePackageYaml } from "./yaml-schema.js";
+export { PackageYamlError, parseSkillPackageYaml, loadSkillPackageYaml, } from "./yaml-parser.js";
+export { computeContentHash, validatePackageSecurity, applyDefaultAnnotations, validatePackageFiles, } from "./security.js";
+//# sourceMappingURL=index.js.map

package/dist/package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/package/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wEAAwE;AAUxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}

package/dist/package/security.d.ts

@@ -0,0 +1,18 @@
+import type { CapabilityAnnotations } from "../engine/domain/capability.js";
+/** Result of security validation on a package */
+export interface SecurityValidationResult {
+    readonly valid: boolean;
+    readonly errors: readonly string[];
+    readonly warnings: readonly string[];
+}
+/** Compute SHA-256 hash of file contents */
+export declare function computeContentHash(content: string): string;
+/** Verify a file has not been tampered with */
+export declare function verifyContentHash(content: string, expectedHash: string): boolean;
+/** Validate a package for security compliance (lifecycle scripts + file extensions) */
+export declare function validatePackageSecurity(packageJsonContent: string | null, fileList: readonly string[]): SecurityValidationResult;
+/** Apply safe defaults to capability annotations -- unannotated tools default to destructive */
+export declare function applyDefaultAnnotations(annotations?: CapabilityAnnotations | null): CapabilityAnnotations;
+/** Validate package file paths for security violations */
+export declare function validatePackageFiles(fileList: readonly string[]): SecurityValidationResult;
+//# sourceMappingURL=security.d.ts.map

package/dist/package/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/package/security.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,4CAA4C;AAC5C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEhF;AA0BD,uFAAuF;AACvF,wBAAgB,uBAAuB,CACrC,kBAAkB,EAAE,MAAM,GAAG,IAAI,EACjC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,wBAAwB,CAkC1B;AAED,gGAAgG;AAChG,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,qBAAqB,GAAG,IAAI,GAAG,qBAAqB,CASzG;AAMD,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,wBAAwB,CA6B1F"}

package/dist/package/security.js

@@ -0,0 +1,110 @@
+// Package security: content hashing, lifecycle script validation, path traversal detection
+// Moved from domain/ -- package-level concern, not domain config
+import { createHash } from "node:crypto";
+/** Compute SHA-256 hash of file contents */
+export function computeContentHash(content) {
+    return createHash("sha256").update(content, "utf-8").digest("hex");
+}
+/** Verify a file has not been tampered with */
+export function verifyContentHash(content, expectedHash) {
+    return computeContentHash(content) === expectedHash;
+}
+const FORBIDDEN_SCRIPTS = [
+    "preinstall",
+    "install",
+    "postinstall",
+    "preuninstall",
+    "uninstall",
+    "postuninstall",
+    "preprepare",
+    "prepare",
+    "postprepare",
+    "prepublish",
+    "prepublishOnly",
+    "postpublish",
+];
+const ALLOWED_EXTENSIONS = new Set([
+    ".yaml",
+    ".yml",
+    ".md",
+    ".ts",
+    ".json",
+    ".txt",
+]);
+/** Validate a package for security compliance (lifecycle scripts + file extensions) */
+export function validatePackageSecurity(packageJsonContent, fileList) {
+    const errors = [];
+    const warnings = [];
+    // Check package.json for forbidden lifecycle scripts
+    if (packageJsonContent !== null) {
+        try {
+            const pkg = JSON.parse(packageJsonContent);
+            const scripts = pkg.scripts;
+            if (scripts && typeof scripts === "object") {
+                for (const script of FORBIDDEN_SCRIPTS) {
+                    if (script in scripts) {
+                        errors.push(`Forbidden lifecycle script "${script}" found in package.json`);
+                    }
+                }
+            }
+        }
+        catch {
+            errors.push("Invalid package.json: failed to parse JSON");
+        }
+    }
+    // Check file extensions
+    for (const file of fileList) {
+        const ext = file.slice(file.lastIndexOf("."));
+        if (!ALLOWED_EXTENSIONS.has(ext)) {
+            warnings.push(`Non-standard file extension "${ext}" in ${file}`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/** Apply safe defaults to capability annotations -- unannotated tools default to destructive */
+export function applyDefaultAnnotations(annotations) {
+    if (!annotations) {
+        return { destructive: true, readOnly: false, idempotent: false };
+    }
+    return {
+        destructive: annotations.destructive ?? true,
+        readOnly: annotations.readOnly ?? false,
+        idempotent: annotations.idempotent ?? false,
+    };
+}
+const PATH_TRAVERSAL_PATTERN = /(^|[\\/])\.\.($|[\\/])/;
+const ABSOLUTE_UNIX_PATTERN = /^\//;
+const ABSOLUTE_WINDOWS_PATTERN = /^[A-Za-z]:\\/;
+/** Validate package file paths for security violations */
+export function validatePackageFiles(fileList) {
+    const errors = [];
+    const warnings = [];
+    for (const file of fileList) {
+        if (PATH_TRAVERSAL_PATTERN.test(file)) {
+            errors.push(`Path traversal detected in "${file}"`);
+        }
+        if (ABSOLUTE_UNIX_PATTERN.test(file)) {
+            errors.push(`Absolute path detected: "${file}"`);
+        }
+        if (ABSOLUTE_WINDOWS_PATTERN.test(file)) {
+            errors.push(`Absolute path detected: "${file}"`);
+        }
+    }
+    // Warn about non-standard extensions
+    for (const file of fileList) {
+        const ext = file.slice(file.lastIndexOf("."));
+        if (!ALLOWED_EXTENSIONS.has(ext)) {
+            warnings.push(`Non-standard file extension "${ext}" in ${file}`);
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=security.js.map

package/dist/package/security.js.map

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

package/dist/package/types.d.ts

@@ -0,0 +1,34 @@
+import type { DomainConfig } from "../domain/index.js";
+import type { SkillConfig } from "../skill/types.js";
+/** MCP server tools configuration for a package */
+export interface PackageToolsConfig {
+    readonly server: string;
+}
+/** Knowledge file references for a package */
+export interface PackageKnowledgeConfig {
+    readonly examples?: string;
+    readonly gates?: string;
+}
+/** Base manifest for any installable package */
+export interface PackageManifest {
+    readonly name: string;
+    readonly type: "domain" | "skill";
+    readonly version: string;
+    readonly author: string;
+    readonly contentHash: string;
+    readonly installPath: string;
+}
+/** Manifest for an installed domain package */
+export interface DomainPackageManifest extends PackageManifest {
+    readonly type: "domain";
+    readonly config: DomainConfig;
+    readonly skills: readonly string[];
+    readonly tools: PackageToolsConfig | null;
+    readonly knowledge: PackageKnowledgeConfig | null;
+}
+/** Manifest for an installed skill package */
+export interface SkillPackageManifest extends PackageManifest {
+    readonly type: "skill";
+    readonly skill: SkillConfig;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/package/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACnD;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B"}

package/dist/package/types.js

@@ -0,0 +1,4 @@
+// Package: distribution types for domain and skill packages
+// Separate from domain (environment config) -- package handles versioning, bundling, security
+export {};
+//# sourceMappingURL=types.js.map

package/dist/package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/package/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8FAA8F"}

package/dist/package/yaml-parser.d.ts

@@ -0,0 +1,22 @@
+import { KilnError } from "../engine/errors.js";
+import type { DomainPackageManifest, SkillPackageManifest } from "./types.js";
+export declare class PackageYamlError extends KilnError {
+    readonly errors: readonly {
+        field: string;
+        message: string;
+    }[];
+    readonly filePath?: string;
+    constructor(errors: readonly {
+        field: string;
+        message: string;
+    }[], filePath?: string);
+}
+/** Parse a YAML string into a DomainPackageManifest */
+export declare function parseDomainPackageYaml(content: string, installPath: string, filePath?: string): DomainPackageManifest;
+/** Parse a YAML string into a SkillPackageManifest */
+export declare function parseSkillPackageYaml(content: string, installPath: string, filePath?: string): SkillPackageManifest;
+/** Load a domain package YAML from disk */
+export declare function loadDomainPackageYaml(filePath: string, installPath: string): DomainPackageManifest;
+/** Load a skill package YAML from disk */
+export declare function loadSkillPackageYaml(filePath: string, installPath: string): SkillPackageManifest;
+//# sourceMappingURL=yaml-parser.d.ts.map