@keel-agent/adapters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keel-agent contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @keel-agent/adapters
+
+Host adapters for exporting keel-agent canonical assets to Codex and other agent hosts.
+
+Use this package when you already have `.keel-agent/` canonical assets and need to export them to a supported host.
+
+```js
+import { exportHost } from "@keel-agent/adapters";
+
+await exportHost(process.cwd(), "codex");
+```
+
+Normal project setup should go through `@keel-agent/cli`:
+
+```bash
+ka export --host codex
+```

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@keel-agent/adapters",
+  "version": "0.1.0",
+  "description": "Host adapters for exporting keel-agent canonical assets to Codex and other agent hosts.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/netpilot-z/keel-agent.git",
+    "directory": "packages/adapters"
+  },
+  "homepage": "https://github.com/netpilot-z/keel-agent/tree/main/packages/adapters#readme",
+  "bugs": {
+    "url": "https://github.com/netpilot-z/keel-agent/issues"
+  },
+  "dependencies": {
+    "@keel-agent/core": "0.1.0",
+    "@keel-agent/templates": "0.1.0"
+  },
+  "engines": {
+    "node": ">=20.10.0"
+  }
+}

package/src/index.js

@@ -0,0 +1,73 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { codexSkillPath, copyDirectory, ensureDir, keelPath, pathExists, writeManagedFile } from "@keel-agent/core";
+import { rootAgentsTemplate } from "@keel-agent/templates";
+
+export const supportedHosts = ["codex", "claude", "cursor", "opencode"];
+
+export async function exportHost(root, host, options = {}) {
+  if (!supportedHosts.includes(host)) {
+    throw new Error(`Unsupported host adapter: ${host}`);
+  }
+  if (host === "codex") return exportCodex(root, options);
+  return exportPlaceholder(root, host, options);
+}
+
+export async function exportCodex(root, options = {}) {
+  const actions = [];
+  const force = options.force === true;
+  const dryRun = options.dryRun === true;
+  const sourceSkills = keelPath(root, "skills");
+  const targetSkills = codexSkillPath(root);
+
+  if (!(await pathExists(sourceSkills))) {
+    throw new Error("Missing .keel-agent/skills. Run `ka init` first.");
+  }
+
+  actions.push(await writeManagedFile(path.join(root, "AGENTS.md"), rootAgentsTemplate(), { force, dryRun }));
+  if (!dryRun) await ensureDir(targetSkills);
+
+  const skills = await fs.readdir(sourceSkills, { withFileTypes: true });
+  for (const entry of skills) {
+    if (!entry.isDirectory()) continue;
+    const source = path.join(sourceSkills, entry.name);
+    const target = path.join(targetSkills, entry.name);
+    if (!dryRun) await copyDirectory(source, target);
+    actions.push({ action: dryRun ? "would-export-skill" : "exported-skill", path: target });
+  }
+
+  actions.push(await writeManagedFile(
+    keelPath(root, "export", "codex", "README.md"),
+    `# Codex Export
+
+<!-- keel-agent:managed -->
+
+Generated assets:
+
+- \`AGENTS.md\`
+- \`.agents/skills/*/SKILL.md\`
+
+These files are generated from keel-agent canonical assets under \`.keel-agent/\`.
+`,
+    { force, dryRun }
+  ));
+
+  return { host: "codex", actions };
+}
+
+async function exportPlaceholder(root, host, options = {}) {
+  const force = options.force === true;
+  const dryRun = options.dryRun === true;
+  const target = keelPath(root, "export", host, "README.md");
+  const result = await writeManagedFile(
+    target,
+    `# ${host} Export
+
+<!-- keel-agent:managed -->
+
+This adapter is reserved for the keel-agent v0.x roadmap. Canonical assets already exist under \`.keel-agent/\`.
+`,
+    { force, dryRun }
+  );
+  return { host, actions: [result] };
+}