@kuznai/inception-engine 0.19.0 → 0.20.0

package/dist/test/unit/toml.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/toml.test.js

@@ -0,0 +1,55 @@
+import assert from "node:assert/strict";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { applyTomlMcpPatch, revertTomlMcpPatch, } from "../../src/core/adapters/toml.js";
+describe("TOML Adapter", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "inception-toml-test-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    });
+    it("applies an MCP server patch to a new TOML file", async () => {
+        const target = path.join(tmpDir, "config.toml");
+        const config = { command: "npx", args: ["serve"] };
+        await applyTomlMcpPatch(target, "my-skill", config);
+        const content = await fs.readFile(target, "utf-8");
+        assert.match(content, /\[mcpServers\.my-skill\]/);
+        assert.match(content, /command = "npx"/);
+        assert.match(content, /args = \[ "serve" \]/);
+    });
+    it("applies an MCP server patch to an existing TOML file preserving other keys", async () => {
+        const target = path.join(tmpDir, "config.toml");
+        await fs.writeFile(target, 'title = "My App"\n\n[mcpServers.other]\ncommand = "ls"\n');
+        const config = { command: "npx", args: ["serve"] };
+        await applyTomlMcpPatch(target, "my-skill", config);
+        const content = await fs.readFile(target, "utf-8");
+        assert.match(content, /title = "My App"/);
+        assert.match(content, /\[mcpServers\.other\]/);
+        assert.match(content, /\[mcpServers\.my-skill\]/);
+        assert.match(content, /command = "npx"/);
+    });
+    it("reverts an MCP server patch", async () => {
+        const target = path.join(tmpDir, "config.toml");
+        await fs.writeFile(target, '[mcpServers.other]\ncommand = "ls"\n\n[mcpServers.my-skill]\ncommand = "npx"\n');
+        await revertTomlMcpPatch(target, "my-skill");
+        const content = await fs.readFile(target, "utf-8");
+        assert.match(content, /\[mcpServers\.other\]/);
+        assert.doesNotMatch(content, /my-skill/);
+    });
+    it("cleans up [mcpServers] table if it becomes empty after revert", async () => {
+        const target = path.join(tmpDir, "config.toml");
+        await fs.writeFile(target, '[mcpServers.my-skill]\ncommand = "npx"\n');
+        await revertTomlMcpPatch(target, "my-skill");
+        const content = await fs.readFile(target, "utf-8");
+        assert.strictEqual(content.trim(), "");
+    });
+    it("throws error if config.toml is invalid TOML", async () => {
+        const target = path.join(tmpDir, "config.toml");
+        await fs.writeFile(target, 'this is not = toml "bad"');
+        await assert.rejects(() => applyTomlMcpPatch(target, "any", {}), /Invalid TOML document/);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuznai/inception-engine",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Deploy AI agent skills from a git repo to user home directories",
   "license": "MIT",
   "author": "Damian Piątkowski",

package/dist/core/adapters/agent-definitions.js

@@ -1,91 +0,0 @@
-import path from "node:path";
-import { AGENT_REGISTRY_BY_ID } from "../../config/agents.js";
-import { getPlatformKey, resolvePlaceholders } from "../resolve.js";
-import { validateAgentRuleMarkdownPath, validateInstructionFileRequirements, validateSourceFile, validateSourcePath, } from "../validation.js";
-/**
- * Compiles deploy actions for agentDefinitions manifest entries.
- *
- * Agent definition files are Markdown files (typically with YAML frontmatter)
- * that define custom agents or subagents for a given platform. Unlike
- * agentRules (which target a single shared global file per agent), each
- * definition entry produces a separate file named after the entry in the
- * agent's dedicated agent-definitions directory (repo-local).
- *
- * Target paths use the `{repo}` placeholder so definitions land in the
- * repository being deployed, not the user's home directory.
- */
-export async function compileAgentDefinitionActions(entry, sourceDir, resolvedSourceDir, realRoot, detectedAgents, home, repo, workspace) {
-    const actions = [];
-    const warnings = [];
-    const platform = getPlatformKey();
-    const targetAgents = entry.agents.filter((agentId) => detectedAgents.includes(agentId));
-    const supportedTargets = [];
-    if (targetAgents.length === 0) {
-        return { actions, warnings };
-    }
-    for (const agentId of targetAgents) {
-        const agent = AGENT_REGISTRY_BY_ID[agentId];
-        const support = agent?.agentDefinitionsSupport;
-        if (!support || support.status === "unsupported") {
-            warnings.push({
-                kind: "confidence",
-                message: `agentDefinitions: agent "${agentId}" uses ${support?.schemaLabel ?? "an unsupported agent-definition schema"} and ${support?.status === "unsupported" ? support.reason : "does not expose a supported agent-definitions adapter"} — skipping "${entry.name}"`,
-            });
-            continue;
-        }
-        if (support.status === "planned") {
-            warnings.push({
-                kind: "confidence",
-                message: `agentDefinitions: agent "${agentId}" agent-definitions support is planned via ${support.plannedSurface} — skipping "${entry.name}" until that surface is implemented`,
-            });
-            continue;
-        }
-        supportedTargets.push({
-            agentId,
-            confidence: agent.provenance.agentDefinitions ?? "provisional",
-            target: resolvePlaceholders(support.path[platform], entry.name, home, repo, workspace),
-        });
-    }
-    if (supportedTargets.length === 0) {
-        return { actions, warnings };
-    }
-    // Validate the shared source file only when at least one target is active.
-    const source = path.resolve(sourceDir, entry.path);
-    await validateSourcePath(source, entry.path, resolvedSourceDir, realRoot);
-    await validateSourceFile(source, entry.path);
-    for (const target of supportedTargets) {
-        validateAgentRuleMarkdownPath(entry.path, target.agentId);
-        await validateInstructionFileRequirements(source, entry.path, target.agentId);
-        actions.push({
-            kind: "file-write",
-            skill: entry.name,
-            agent: target.agentId,
-            source,
-            target: target.target,
-            confidence: target.confidence,
-        });
-    }
-    return { actions, warnings };
-}
-export function compileAgentDefinitionReverts(entry, agentFilter, home, repo, workspace) {
-    const actions = [];
-    const platform = getPlatformKey();
-    for (const agentId of entry.agents) {
-        if (agentFilter && !agentFilter.includes(agentId))
-            continue;
-        const agent = AGENT_REGISTRY_BY_ID[agentId];
-        const support = agent?.agentDefinitionsSupport;
-        if (!support ||
-            support.status === "unsupported" ||
-            support.status === "planned")
-            continue;
-        const target = resolvePlaceholders(support.path[platform], entry.name, home, repo, workspace);
-        actions.push({
-            kind: "file-write",
-            skill: entry.name,
-            agent: agentId,
-            target,
-        });
-    }
-    return actions;
-}