@aikdna/kdna-mcp-server 0.2.3 → 0.3.0

package/README.md

@@ -1,11 +1,15 @@
 # KDNA MCP Server
 
 `@aikdna/kdna-mcp-server` exposes KDNA as MCP tools so agent runtimes can use
-`.kdna` assets without learning the container internals. Stdio-only, minimal footprint.
+packaged `.kdna` assets without learning the container internals. Stdio-only,
+minimal footprint. The npm package source lives in this repository under
+[`mcp-server/`](./); there is no separate public `kdna-mcp-server` repository.
 
 ## Why MCP instead of the kdna-loader skill?
 
-The `kdna-loader` skill teaches an agent the full KDNA protocol (7-part routing, silent loading, boundary respect). The MCP server provides a lower-level bridge — use it when you need programmatic access to `.kdna` assets through structured tool calls rather than letting the agent drive the CLI.
+The `kdna-loader` skill teaches an agent the full toolchain-only protocol:
+routing, planning, Capsule loading, application, and boundary respect. The MCP
+server provides a lower-level bridge for structured tool calls.
 
 | Approach | Best for |
 |----------|----------|
@@ -16,13 +20,12 @@ The `kdna-loader` skill teaches an agent the full KDNA protocol (7-part routing,
 
 | Tool | Purpose | Input | Output |
 |------|---------|-------|--------|
-| `kdna.inspect` | Inspect a v1 `.kdna` asset or legacy asset | File path | Structured metadata |
+| `kdna.inspect` | Inspect a `.kdna` asset | File path | Structured metadata |
 | `kdna.verify` | Verify asset integrity state | File path | Pass/fail with reasons |
 | `kdna.plan-load` | Return Core LoadPlan before loading | File path, optional password or entitlement state | LoadPlan JSON |
-| `kdna.load` | Load and render a `.kdna` profile for agent context | File path, optional profile | Prompt-mode text or raw JSON |
-| `kdna.available-local` | List local v1 `.kdna` assets without registry dependency | Root directory | Local v1 asset inventory |
+| `kdna.load` | Load an authorized `.kdna` profile | File path, optional profile | Runtime Capsule |
+| `kdna.available-local` | List local `.kdna` assets | Root directory | Local asset inventory |
 | `kdna.match` | Rank candidate assets for a task string | Task description | Scored list with fit signals |
-| `kdna.available` | Legacy registry compatibility only | `domains.json` path | Legacy domain list |
 
 ## Install & Run
 
@@ -76,10 +79,14 @@ kdna-mcp
 
 | Variable | Purpose |
 |----------|---------|
-| `KDNA_ASSET_DIR` | Root directory for `kdna.available-local` (default: `~/.kdna/assets`) |
-| `KDNA_REGISTRY_FILE` | Legacy path to `domains.json` for `kdna.available` |
+| `KDNA_ASSET_DIR` | Root directory for `kdna.available-local`; overrides the default |
+| `KDNA_PACKAGE_DIR` | Package directory fallback for `kdna.available-local` |
 | `KDNA_DATA_ROOT` | Override KDNA data directory (default: `~/.kdna`) |
 
+When no override is provided, `kdna.available-local` scans
+`~/.kdna/packages`. Explicit local roots can be provided when a user keeps
+assets elsewhere.
+
 ## Local Development
 
 ```bash
@@ -96,7 +103,7 @@ node bin/kdna-mcp.mjs
 # Client calls kdna.plan-load { assetPath: "./dist/writing.kdna" }
 # Or kdna.plan-load { assetPath: "./dist/writing.kdna", entitlementStatus: "active" }
 # Client calls kdna.load { assetPath: "./dist/writing.kdna", profile: "compact" }
-# Agent injects prompt text into system context
+# Agent consumes only the returned Runtime Capsule context
 ```
 
 ## Relationship to kdna-loader skill

package/bin/kdna-mcp.mjs

@@ -9,21 +9,13 @@ import { createRequire } from 'node:module';
 const require = createRequire(import.meta.url);
 const packageInfo = require('../package.json');
 const {
-  inspectKDNA,
-  loadKDNA,
+  detectContainerFormat,
+  inspect,
+  load,
   matchDomain,
   planLoad,
-  renderForAgent,
-  verifyAsset,
+  validate,
 } = require('@aikdna/kdna-core');
-const {
-  detectContainerFormat,
-  inspect: inspectV1,
-  isV1SourceDir,
-  loadAuthorized,
-  loadV1,
-  validate: validateV1,
-} = require('@aikdna/kdna-core/v1');
 
 const tools = [
   {
@@ -77,7 +69,7 @@ const tools = [
   },
   {
     name: 'kdna.available-local',
-    description: 'List local v1 .kdna files without using a registry.',
+    description: 'List local .kdna files without using a registry.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -121,11 +113,11 @@ function textResult(value) {
   };
 }
 
-function isV1Asset(assetPath) {
+function isKdnaAsset(assetPath) {
   if (!assetPath) return false;
   try {
     if (!fs.existsSync(assetPath) || !fs.statSync(assetPath).isFile()) return false;
-    return assetPath.endsWith('.kdna') && detectContainerFormat(assetPath) === 'v1';
+    return assetPath.endsWith('.kdna') && detectContainerFormat(assetPath) === 'kdna';
   } catch {
     return false;
   }
@@ -153,12 +145,12 @@ function findLocalAssets(root = defaultAssetRoot(), maxDepth = 3) {
       const full = path.join(dir, entry.name);
       if (entry.isDirectory()) {
         visit(full, depth + 1);
-      } else if (entry.isFile() && entry.name.endsWith('.kdna') && detectContainerFormat(full) === 'v1') {
-        const inspection = inspectV1(full);
-        const validation = validateV1(full);
+      } else if (entry.isFile() && entry.name.endsWith('.kdna') && detectContainerFormat(full) === 'kdna') {
+        const inspection = inspect(full);
+        const validation = validate(full);
         found.push({
           path: full,
-          kind: 'v1_container',
+          kind: 'kdna_asset',
           asset_id: inspection.asset_id,
           title: inspection.title,
           version: inspection.version,
@@ -226,48 +218,26 @@ function planLoadThroughCoreOrCli(args = {}) {
   return runCliPlanLoad(args);
 }
 
-function loadV1Authorized(assetPath, options) {
-  if (typeof loadAuthorized === 'function') return loadAuthorized(assetPath, options);
-  const plan = planLoadThroughCoreOrCli({
-    assetPath,
-    hasPassword: options.hasPassword,
-    entitlementStatus: options.entitlement && options.entitlement.status,
-  });
-  if (plan.can_load_now !== true) {
-    const error = new Error(
-      `LoadPlan denied loading: state=${plan.state || 'invalid'} required_action=${plan.required_action || 'block'}`,
-    );
-    error.code = (plan.issues && plan.issues[0] && plan.issues[0].code) || 'KDNA_LOAD_NOT_AUTHORIZED';
-    throw error;
-  }
-  return loadV1(assetPath, options);
-}
-
 async function callTool(name, args = {}) {
   if (name === 'kdna.inspect') {
-    if (isV1Asset(args.assetPath)) return textResult(inspectV1(args.assetPath));
-    return textResult(await inspectKDNA(args.assetPath, { verify: args.verify !== false }));
+    if (!isKdnaAsset(args.assetPath)) throw new Error('assetPath is not a current KDNA asset');
+    return textResult(inspect(args.assetPath, { verify: args.verify !== false }));
   }
   if (name === 'kdna.verify') {
-    if (isV1Asset(args.assetPath)) return textResult(validateV1(args.assetPath));
-    return textResult(await verifyAsset(args.assetPath, {
+    if (!isKdnaAsset(args.assetPath)) throw new Error('assetPath is not a current KDNA asset');
+    return textResult(validate(args.assetPath, {
       asset_digest: args.asset_digest,
       content_digest: args.content_digest,
       requireSignature: Boolean(args.requireSignature),
     }));
   }
   if (name === 'kdna.load') {
-    if (isV1Asset(args.assetPath)) {
-      const profile = args.profile || 'compact';
-      const loaded = loadV1Authorized(args.assetPath, { profile, as: 'json' });
-      const prompt = profile === 'index' ? null : loadV1Authorized(args.assetPath, { profile, as: 'prompt' }).text;
-      return textResult({ ...loaded, context: prompt });
-    }
-    const loaded = await loadKDNA(args.assetPath, { profile: args.profile || 'compact', input: args.input || '' });
-    const context = args.profile === 'index'
-      ? null
-      : await renderForAgent(args.assetPath, { profile: args.profile || 'compact', input: args.input || '' });
-    return textResult({ ...loaded, context });
+    if (!isKdnaAsset(args.assetPath)) throw new Error('assetPath is not a current KDNA asset');
+    return textResult(load(args.assetPath, {
+      profile: args.profile || 'compact',
+      as: 'json',
+      input: args.input || '',
+    }));
   }
   if (name === 'kdna.plan-load') {
     return textResult(planLoadThroughCoreOrCli(args));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aikdna/kdna-mcp-server",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "MCP server for loading, inspecting, verifying, and matching KDNA .kdna assets.",
   "type": "module",
   "homepage": "https://aikdna.com",
@@ -30,14 +30,17 @@
   ],
   "scripts": {
     "test": "node --test test/*.test.mjs",
-    "prepublishOnly": "npm test"
+    "prepublishOnly": "npm test && node ../scripts/release-check.js"
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@aikdna/kdna-core": "^0.12.1",
+    "@aikdna/kdna-core": "0.15.12",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1"
   },
+  "devDependencies": {
+    "cbor-x": "^1.6.4"
+  },
   "engines": {
     "node": ">=18"
   }