@kybernesis/arp-create-adapter 0.1.0

package/dist/index.js

@@ -0,0 +1,95 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync, statSync } from 'fs';
+import { dirname, resolve, join, relative } from 'path';
+import { fileURLToPath } from 'url';
+import Handlebars from 'handlebars';
+
+// src/scaffold.ts
+var __filename$1 = fileURLToPath(import.meta.url);
+var __dirname$1 = dirname(__filename$1);
+var DEFAULT_TEMPLATES_DIR = resolve(__dirname$1, "..", "templates");
+async function scaffoldAdapter(options) {
+  const framework = options.framework.trim().toLowerCase();
+  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {
+    throw new Error(
+      `framework slug "${options.framework}" must match /^[a-z][a-z0-9-]*$/`
+    );
+  }
+  const displayName = options.displayName ?? toDisplayName(framework);
+  const arpVersion = options.arpVersion ?? "^0.1.0";
+  const templateRoot = options.templatesDir ? resolve(options.templatesDir, options.language) : join(DEFAULT_TEMPLATES_DIR, options.language);
+  if (!existsSync(templateRoot)) {
+    throw new Error(`template directory missing: ${templateRoot}`);
+  }
+  const context = {
+    framework,
+    frameworkPascal: toPascal(framework),
+    frameworkCamel: toCamel(framework),
+    frameworkSnake: framework.replace(/-/g, "_"),
+    frameworkUpper: framework.toUpperCase().replace(/-/g, "_"),
+    displayName,
+    arpVersion,
+    /** Best-effort Python-compatible version range — strip leading `^`. */
+    pythonArpVersion: arpVersion.startsWith("^") ? `>=${arpVersion.slice(1)}` : arpVersion,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const created = [];
+  const skipped = [];
+  for (const rel of walk(templateRoot)) {
+    const src = join(templateRoot, rel);
+    const dst = join(options.out, renderFilename(rel, context));
+    if (existsSync(dst) && !options.force) {
+      skipped.push(dst);
+      continue;
+    }
+    const raw = readFileSync(src, "utf8");
+    const rendered = rel.endsWith(".hbs") ? Handlebars.compile(raw, { noEscape: true })(context) : raw;
+    mkdirSync(dirname(dst), { recursive: true });
+    writeFileSync(dst, rendered);
+    created.push(dst);
+  }
+  const summary = [
+    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,
+    `Created ${created.length} file(s), skipped ${skipped.length}.`,
+    "",
+    "Next steps:",
+    `  1. cd ${relative(process.cwd(), options.out) || options.out}`,
+    options.language === "ts" ? "  2. pnpm install" : "  2. uv sync  # or: python -m pip install -e .",
+    "  3. Implement src/* to map your framework's public extension points to ArpAgent.",
+    "  4. Run the conformance test: pnpm test  (or: uv run pytest)",
+    "  5. See docs/ARP-adapter-authoring-guide.md for the full contract."
+  ].join("\n");
+  return { createdFiles: created, skippedFiles: skipped, summary };
+}
+function walk(dir) {
+  const out = [];
+  function recurse(sub) {
+    const abs = join(dir, sub);
+    for (const entry of readdirSync(abs)) {
+      const fullRel = sub ? join(sub, entry) : entry;
+      const fullAbs = join(dir, fullRel);
+      const st = statSync(fullAbs);
+      if (st.isDirectory()) recurse(fullRel);
+      else out.push(fullRel);
+    }
+  }
+  recurse("");
+  return out;
+}
+function renderFilename(rel, ctx) {
+  const withoutHbs = rel.endsWith(".hbs") ? rel.slice(0, -".hbs".length) : rel;
+  return Handlebars.compile(withoutHbs, { noEscape: true })(ctx);
+}
+function toPascal(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function toCamel(slug) {
+  const pascal = toPascal(slug);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function toDisplayName(slug) {
+  return slug.split("-").filter(Boolean).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
+}
+
+export { scaffoldAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts"],"names":["__filename","__dirname"],"mappings":";;;;;;AAwCA,IAAMA,YAAA,GAAa,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AAChD,IAAMC,WAAA,GAAY,QAAQD,YAAU,CAAA;AAEpC,IAAM,qBAAA,GAAwB,OAAA,CAAQC,WAAA,EAAW,IAAA,EAAM,WAAW,CAAA;AAElE,eAAsB,gBACpB,OAAA,EACyB;AACzB,EAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,SAAA,CAAU,IAAA,GAAO,WAAA,EAAY;AACvD,EAAA,IAAI,CAAC,mBAAA,CAAoB,IAAA,CAAK,SAAS,CAAA,EAAG;AACxC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,gBAAA,EAAmB,QAAQ,SAAS,CAAA,gCAAA;AAAA,KACtC;AAAA,EACF;AACA,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,WAAA,IAAe,aAAA,CAAc,SAAS,CAAA;AAClE,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,QAAA;AAEzC,EAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,YAAA,GACzB,OAAA,CAAQ,OAAA,CAAQ,YAAA,EAAc,OAAA,CAAQ,QAAQ,CAAA,GAC9C,IAAA,CAAK,qBAAA,EAAuB,OAAA,CAAQ,QAAQ,CAAA;AAChD,EAAA,IAAI,CAAC,UAAA,CAAW,YAAY,CAAA,EAAG;AAC7B,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,4BAAA,EAA+B,YAAY,CAAA,CAAE,CAAA;AAAA,EAC/D;AAEA,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,SAAA;AAAA,IACA,eAAA,EAAiB,SAAS,SAAS,CAAA;AAAA,IACnC,cAAA,EAAgB,QAAQ,SAAS,CAAA;AAAA,IACjC,cAAA,EAAgB,SAAA,CAAU,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA;AAAA,IAC3C,gBAAgB,SAAA,CAAU,WAAA,EAAY,CAAE,OAAA,CAAQ,MAAM,GAAG,CAAA;AAAA,IACzD,WAAA;AAAA,IACA,UAAA;AAAA;AAAA,IAEA,gBAAA,EAAkB,UAAA,CAAW,UAAA,CAAW,GAAG,CAAA,GACvC,KAAK,UAAA,CAAW,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA,GACxB,UAAA;AAAA,IACJ,WAAA,EAAA,iBAAa,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,GACtC;AAEA,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,MAAM,UAAoB,EAAC;AAE3B,EAAA,KAAA,MAAW,GAAA,IAAO,IAAA,CAAK,YAAY,CAAA,EAAG;AACpC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,YAAA,EAAc,GAAG,CAAA;AAClC,IAAA,MAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,KAAK,cAAA,CAAe,GAAA,EAAK,OAAO,CAAC,CAAA;AAC1D,IAAA,IAAI,UAAA,CAAW,GAAG,CAAA,IAAK,CAAC,QAAQ,KAAA,EAAO;AACrC,MAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAChB,MAAA;AAAA,IACF;AACA,IAAA,MAAM,GAAA,GAAM,YAAA,CAAa,GAAA,EAAK,MAAM,CAAA;AACpC,IAAA,MAAM,QAAA,GAAW,GAAA,CAAI,QAAA,CAAS,MAAM,IAChC,UAAA,CAAW,OAAA,CAAQ,GAAA,EAAK,EAAE,QAAA,EAAU,IAAA,EAAM,CAAA,CAAE,OAAO,CAAA,GACnD,GAAA;AACJ,IAAA,SAAA,CAAU,QAAQ,GAAG,CAAA,EAAG,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3C,IAAA,aAAA,CAAc,KAAK,QAAQ,CAAA;AAC3B,IAAA,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,EAClB;AAEA,EAAA,MAAM,OAAA,GAAU;AAAA,IACd,sCAAsC,SAAS,CAAA,EAAA,EAAK,QAAQ,QAAQ,CAAA,KAAA,EAAQ,QAAQ,GAAG,CAAA,CAAA,CAAA;AAAA,IACvF,CAAA,QAAA,EAAW,OAAA,CAAQ,MAAM,CAAA,kBAAA,EAAqB,QAAQ,MAAM,CAAA,CAAA,CAAA;AAAA,IAC5D,EAAA;AAAA,IACA,aAAA;AAAA,IACA,CAAA,QAAA,EAAW,SAAS,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,GAAG,CAAA,IAAK,OAAA,CAAQ,GAAG,CAAA,CAAA;AAAA,IAC9D,OAAA,CAAQ,QAAA,KAAa,IAAA,GACjB,mBAAA,GACA,gDAAA;AAAA,IACJ,mFAAA;AAAA,IACA,+DAAA;AAAA,IACA;AAAA,GACF,CAAE,KAAK,IAAI,CAAA;AAEX,EAAA,OAAO,EAAE,YAAA,EAAc,OAAA,EAAS,YAAA,EAAc,SAAS,OAAA,EAAQ;AACjE;AAEA,SAAS,KAAK,GAAA,EAAuB;AACnC,EAAA,MAAM,MAAgB,EAAC;AACvB,EAAA,SAAS,QAAQ,GAAA,EAAa;AAC5B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,GAAA,EAAK,GAAG,CAAA;AACzB,IAAA,KAAA,MAAW,KAAA,IAAS,WAAA,CAAY,GAAG,CAAA,EAAG;AACpC,MAAA,MAAM,OAAA,GAAU,GAAA,GAAM,IAAA,CAAK,GAAA,EAAK,KAAK,CAAA,GAAI,KAAA;AACzC,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,GAAA,EAAK,OAAO,CAAA;AACjC,MAAA,MAAM,EAAA,GAAK,SAAS,OAAO,CAAA;AAC3B,MAAA,IAAI,EAAA,CAAG,WAAA,EAAY,EAAG,OAAA,CAAQ,OAAO,CAAA;AAAA,WAChC,GAAA,CAAI,KAAK,OAAO,CAAA;AAAA,IACvB;AAAA,EACF;AACA,EAAA,OAAA,CAAQ,EAAE,CAAA;AACV,EAAA,OAAO,GAAA;AACT;AAEA,SAAS,cAAA,CAAe,KAAa,GAAA,EAAqC;AAGxE,EAAA,MAAM,UAAA,GAAa,GAAA,CAAI,QAAA,CAAS,MAAM,CAAA,GAAI,GAAA,CAAI,KAAA,CAAM,CAAA,EAAG,CAAC,MAAA,CAAO,MAAM,CAAA,GAAI,GAAA;AACzE,EAAA,OAAO,UAAA,CAAW,QAAQ,UAAA,EAAY,EAAE,UAAU,IAAA,EAAM,EAAE,GAAG,CAAA;AAC/D;AAEA,SAAS,SAAS,IAAA,EAAsB;AACtC,EAAA,OAAO,IAAA,CACJ,MAAM,GAAG,CAAA,CACT,OAAO,OAAO,CAAA,CACd,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,CAAA,CAAE,MAAM,CAAC,CAAC,CAAA,CACjD,IAAA,CAAK,EAAE,CAAA;AACZ;AAEA,SAAS,QAAQ,IAAA,EAAsB;AACrC,EAAA,MAAM,MAAA,GAAS,SAAS,IAAI,CAAA;AAC5B,EAAA,OAAO,MAAA,CAAO,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,MAAA,CAAO,MAAM,CAAC,CAAA;AACxD;AAEA,SAAS,cAAc,IAAA,EAAsB;AAC3C,EAAA,OAAO,IAAA,CACJ,MAAM,GAAG,CAAA,CACT,OAAO,OAAO,CAAA,CACd,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,CAAC,CAAA,CAAE,aAAY,GAAI,CAAA,CAAE,MAAM,CAAC,CAAC,CAAA,CACjD,IAAA,CAAK,GAAG,CAAA;AACb","file":"index.js","sourcesContent":["/**\n * Core scaffolder. Reads a template directory, renders each file through\n * Handlebars, and writes to the target path.\n *\n * Templates live under `packages/create-adapter/templates/<lang>/` and the\n * scaffolder resolves them relative to the compiled `dist/` via\n * `fileURLToPath(import.meta.url)`. Consumers using the programmatic API\n * in a non-standard layout can pass `templatesDir` directly.\n */\n\nimport { readdirSync, readFileSync, statSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';\nimport { dirname, join, relative, resolve } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport Handlebars from 'handlebars';\n\nexport type SupportedLanguage = 'ts' | 'python';\n\nexport interface ScaffoldOptions {\n  /** Framework slug (kebab-case). Used in file paths + imports. */\n  framework: string;\n  /** Human-readable name (e.g. \"KyberBot\"). Used in README, error strings. */\n  displayName?: string;\n  /** Target language. */\n  language: SupportedLanguage;\n  /** Destination directory — will be created if missing. */\n  out: string;\n  /** Override the template root. Default: bundled templates. */\n  templatesDir?: string;\n  /** ARP spec version pinned in the generated package.json. */\n  arpVersion?: string;\n  /** When true, overwrite existing files. Default false. */\n  force?: boolean;\n}\n\nexport interface ScaffoldResult {\n  createdFiles: string[];\n  skippedFiles: string[];\n  summary: string;\n}\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nconst DEFAULT_TEMPLATES_DIR = resolve(__dirname, '..', 'templates');\n\nexport async function scaffoldAdapter(\n  options: ScaffoldOptions,\n): Promise<ScaffoldResult> {\n  const framework = options.framework.trim().toLowerCase();\n  if (!/^[a-z][a-z0-9-]*$/.test(framework)) {\n    throw new Error(\n      `framework slug \"${options.framework}\" must match /^[a-z][a-z0-9-]*$/`,\n    );\n  }\n  const displayName = options.displayName ?? toDisplayName(framework);\n  const arpVersion = options.arpVersion ?? '^0.1.0';\n\n  const templateRoot = options.templatesDir\n    ? resolve(options.templatesDir, options.language)\n    : join(DEFAULT_TEMPLATES_DIR, options.language);\n  if (!existsSync(templateRoot)) {\n    throw new Error(`template directory missing: ${templateRoot}`);\n  }\n\n  const context = {\n    framework,\n    frameworkPascal: toPascal(framework),\n    frameworkCamel: toCamel(framework),\n    frameworkSnake: framework.replace(/-/g, '_'),\n    frameworkUpper: framework.toUpperCase().replace(/-/g, '_'),\n    displayName,\n    arpVersion,\n    /** Best-effort Python-compatible version range — strip leading `^`. */\n    pythonArpVersion: arpVersion.startsWith('^')\n      ? `>=${arpVersion.slice(1)}`\n      : arpVersion,\n    generatedAt: new Date().toISOString(),\n  };\n\n  const created: string[] = [];\n  const skipped: string[] = [];\n\n  for (const rel of walk(templateRoot)) {\n    const src = join(templateRoot, rel);\n    const dst = join(options.out, renderFilename(rel, context));\n    if (existsSync(dst) && !options.force) {\n      skipped.push(dst);\n      continue;\n    }\n    const raw = readFileSync(src, 'utf8');\n    const rendered = rel.endsWith('.hbs')\n      ? Handlebars.compile(raw, { noEscape: true })(context)\n      : raw;\n    mkdirSync(dirname(dst), { recursive: true });\n    writeFileSync(dst, rendered);\n    created.push(dst);\n  }\n\n  const summary = [\n    `Scaffolded @kybernesis/arp-adapter-${framework} (${options.language}) at ${options.out}.`,\n    `Created ${created.length} file(s), skipped ${skipped.length}.`,\n    '',\n    'Next steps:',\n    `  1. cd ${relative(process.cwd(), options.out) || options.out}`,\n    options.language === 'ts'\n      ? '  2. pnpm install'\n      : '  2. uv sync  # or: python -m pip install -e .',\n    '  3. Implement src/* to map your framework\\'s public extension points to ArpAgent.',\n    '  4. Run the conformance test: pnpm test  (or: uv run pytest)',\n    '  5. See docs/ARP-adapter-authoring-guide.md for the full contract.',\n  ].join('\\n');\n\n  return { createdFiles: created, skippedFiles: skipped, summary };\n}\n\nfunction walk(dir: string): string[] {\n  const out: string[] = [];\n  function recurse(sub: string) {\n    const abs = join(dir, sub);\n    for (const entry of readdirSync(abs)) {\n      const fullRel = sub ? join(sub, entry) : entry;\n      const fullAbs = join(dir, fullRel);\n      const st = statSync(fullAbs);\n      if (st.isDirectory()) recurse(fullRel);\n      else out.push(fullRel);\n    }\n  }\n  recurse('');\n  return out;\n}\n\nfunction renderFilename(rel: string, ctx: Record<string, string>): string {\n  // Trim trailing `.hbs` and run Handlebars on the path (for filenames\n  // like `src/{{framework}}.ts.hbs`).\n  const withoutHbs = rel.endsWith('.hbs') ? rel.slice(0, -'.hbs'.length) : rel;\n  return Handlebars.compile(withoutHbs, { noEscape: true })(ctx);\n}\n\nfunction toPascal(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join('');\n}\n\nfunction toCamel(slug: string): string {\n  const pascal = toPascal(slug);\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1);\n}\n\nfunction toDisplayName(slug: string): string {\n  return slug\n    .split('-')\n    .filter(Boolean)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join(' ');\n}\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@kybernesis/arp-create-adapter",
+  "version": "0.1.0",
+  "description": "Scaffolds a conformance-passing ARP framework adapter in TypeScript or Python.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KybernesisAI/arp.git",
+    "directory": "packages/create-adapter"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "create-arp-adapter": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "handlebars": "^4.7.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests"
+  }
+}

package/templates/python/MIGRATION.md.hbs

@@ -0,0 +1,34 @@
+# Migrating {{displayName}} (Python) to ARP
+
+## Before
+
+```python
+from {{framework}} import {{frameworkPascal}}
+
+agent = {{frameworkPascal}}( ... )
+await agent.start()
+```
+
+## After
+
+```python
+from arp_sdk import ArpAgent
+from {{framework}} import {{frameworkPascal}}
+from arp_adapter_{{frameworkSnake}} import with_arp
+
+arp = await ArpAgent.from_handoff("./arp-handoff.json")
+framework = {{frameworkPascal}}( ... )
+await with_arp(framework, agent=arp)
+await framework.start()
+```
+
+## What ARP adds
+
+- Cedar PDP check before every tool invocation.
+- Obligation pipeline (redact, rate limit, watermark) applied to outbound replies.
+- Append-only hash-chained audit log per connection.
+
+## What doesn't change
+
+- No prompt / model changes.
+- No fork of {{displayName}} — the adapter uses its documented public API only.

package/templates/python/README.md.hbs

@@ -0,0 +1,37 @@
+# arp-adapter-{{framework}} (Python)
+
+ARP adapter for **{{displayName}}**.
+
+Generated by [`@kybernesis/arp-create-adapter`](https://npmjs.com/package/@kybernesis/arp-create-adapter).
+
+## Install
+
+```bash
+pip install arp-adapter-{{framework}} arp-sdk
+```
+
+## Usage
+
+```python
+from arp_sdk import ArpAgent
+from arp_adapter_{{frameworkSnake}} import with_arp
+from {{framework}} import {{frameworkPascal}}
+
+agent = await ArpAgent.from_handoff("./arp-handoff.json")
+framework = {{frameworkPascal}}( ... )
+await with_arp(framework, agent=agent)
+await framework.start()
+```
+
+## Next steps
+
+1. Replace `{{frameworkPascal}}Like` in `arp_adapter_{{frameworkSnake}}/__init__.py` with the real extension interface {{displayName}} exposes.
+2. Wire the ARP hooks to the framework's real middleware / event-handler methods.
+3. Run `uv run pytest` (or `pytest`) to exercise the scaffold conformance test.
+
+## Rules
+
+- **Never fork {{displayName}}.** Public API only.
+- **Adapter stays ≤ 1000 lines.**
+- **Pass the ARP testkit audit** when integrated with a real agent.
+- See `docs/ARP-adapter-authoring-guide.md`.

package/templates/python/arp_adapter_{{frameworkSnake}}/__init__.py.hbs

@@ -0,0 +1,77 @@
+"""
+arp_adapter_{{frameworkSnake}} — ARP adapter for {{displayName}} (Python).
+
+Generated on {{generatedAt}} by @kybernesis/arp-create-adapter.
+
+TODO (you): replace the placeholder `{{frameworkPascal}}Like` protocol
+below with the real {{displayName}} extension interface (middleware,
+decorator, plugin) and wire `with_arp` into whichever hook names
+{{displayName}} actually exposes.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Awaitable, Callable, Protocol
+
+from arp_sdk import ArpAgent, guard_action  # type: ignore
+
+
+class {{frameworkPascal}}Like(Protocol):
+    id: str
+
+    def use_tool_middleware(
+        self,
+        middleware: Callable[[dict[str, Any], Callable[[], Awaitable[Any]]], Awaitable[Any]],
+    ) -> None: ...
+
+    def on_peer_message(
+        self,
+        handler: Callable[[dict[str, Any]], Awaitable[dict[str, Any]]],
+    ) -> None: ...
+
+    async def start(self) -> None: ...
+    async def stop(self) -> None: ...
+
+
+async def with_arp(
+    framework: {{frameworkPascal}}Like,
+    *,
+    agent: ArpAgent,
+) -> {{frameworkPascal}}Like:
+    """Register ARP hooks on `framework` using `agent`."""
+
+    async def tool_mw(ctx: dict[str, Any], nxt: Callable[[], Awaitable[Any]]) -> Any:
+        result = await guard_action(
+            agent,
+            connection_id=ctx["connection_id"],
+            action=ctx["tool_name"],
+            resource={"type": "Tool", "id": ctx["tool_name"]},
+            context=ctx.get("args", {}),
+            run=nxt,
+        )
+        if not result.allow:
+            return {"error": "denied_by_arp", "reason": result.reason}
+        return result.data
+
+    async def inbound(msg: dict[str, Any]) -> dict[str, Any]:
+        connection_id = msg.get("connection_id") or msg.get("body", {}).get("connection_id")
+        if not connection_id:
+            return {"body": {"error": "missing_connection_id"}}
+        res = await guard_action(
+            agent,
+            connection_id=connection_id,
+            action=msg["action"],
+            resource={"type": "Message", "id": msg["id"]},
+            context=msg.get("body", {}),
+            run=lambda: {"ok": True},
+        )
+        if not res.allow:
+            return {"body": {"error": "denied_by_arp", "reason": res.reason}}
+        return {"body": res.data or {}}
+
+    framework.use_tool_middleware(tool_mw)
+    framework.on_peer_message(inbound)
+    return framework
+
+
+__all__ = ["with_arp", "{{frameworkPascal}}Like"]

package/templates/python/pyproject.toml.hbs

@@ -0,0 +1,21 @@
+[project]
+name = "arp-adapter-{{framework}}"
+version = "0.1.0"
+description = "ARP adapter for {{displayName}} (Python)."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "ARP Adapter Author", email = "you@example.com" }]
+dependencies = [
+  "arp-sdk{{pythonArpVersion}}",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8", "pytest-asyncio>=0.23"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["arp_adapter_{{frameworkSnake}}"]

package/templates/python/tests/test_conformance.py.hbs

@@ -0,0 +1,42 @@
+"""
+Baseline conformance test.
+
+The real conformance test — pairing with the ARP reference agents and
+running `arp-testkit audit` — lives in the ARP monorepo's
+`tests/phase-6` suite. Point it at this adapter once wiring is done.
+"""
+
+import asyncio
+import pytest
+
+
+class Fake{{frameworkPascal}}:
+    def __init__(self) -> None:
+        self.id = "fake-{{framework}}"
+        self.tool_hook_registered = False
+        self.peer_hook_registered = False
+
+    def use_tool_middleware(self, _mw) -> None:
+        self.tool_hook_registered = True
+
+    def on_peer_message(self, _handler) -> None:
+        self.peer_hook_registered = True
+
+    async def start(self) -> None:
+        pass
+
+    async def stop(self) -> None:
+        pass
+
+
+@pytest.mark.asyncio
+async def test_with_arp_registers_hooks():
+    from arp_adapter_{{frameworkSnake}} import with_arp
+
+    class FakeAgent:
+        did = "did:web:test.agent"
+
+    fw = Fake{{frameworkPascal}}()
+    await with_arp(fw, agent=FakeAgent())  # type: ignore[arg-type]
+    assert fw.tool_hook_registered
+    assert fw.peer_hook_registered

package/templates/ts/MIGRATION.md.hbs

@@ -0,0 +1,44 @@
+# Migrating {{displayName}} to ARP
+
+## Before
+
+```ts
+import { {{displayName}} } from '{{framework}}';
+const agent = new {{displayName}}({ /* ... */ });
+await agent.start();
+```
+
+## After
+
+```ts
+import { {{displayName}} } from '{{framework}}';
+import { withArp } from '@kybernesis/arp-adapter-{{framework}}';
+
+const guarded = withArp(new {{displayName}}({ /* ... */ }), {
+  handoff: './arp-handoff.json',
+});
+await guarded.start();
+```
+
+## What ARP adds
+
+- Cedar PDP check before every tool call.
+- Obligation pipeline (redact, rate limit, watermark) applied to every outbound reply.
+- Append-only audit log per connection.
+- Lifecycle events (`revocation`, `rotation`, `pairing`) via `guarded.agent.on(...)`.
+
+## What doesn't change
+
+- No prompt / model changes.
+- No fork of {{displayName}} — the adapter uses its documented public API only.
+
+## FAQ
+
+**Will my tools still work?**
+Yes. The middleware only wraps the invocation — your tool runs unchanged when the PDP allows.
+
+**Latency?**
+The PDP is in-process Cedar-WASM; <5 ms per check on a realistic policy bundle.
+
+**Debuggability?**
+Every decision is appended to `<dataDir>/audit/<connection_id>.jsonl` (hash-chained). Use `arp-testkit audit <agent>` to verify.

package/templates/ts/README.md.hbs

@@ -0,0 +1,35 @@
+# @kybernesis/arp-adapter-{{framework}}
+
+ARP adapter for **{{displayName}}**.
+
+Generated by [`@kybernesis/arp-create-adapter`](https://npmjs.com/package/@kybernesis/arp-create-adapter). Next steps:
+
+1. Replace the placeholder `{{frameworkPascal}}Like` structural type in `src/types.ts` with the real {{displayName}} extension interface you depend on (middleware, plugin hook, decorator — whatever shape {{displayName}} publishes).
+2. Wire `useToolMiddleware` / `onPeerMessage` in `src/index.ts` to the framework's real hook names.
+3. Run `pnpm test` and then hook this adapter into your own agent.
+
+## Install
+
+```bash
+pnpm add @kybernesis/arp-adapter-{{framework}} @kybernesis/arp-sdk
+```
+
+## Usage
+
+```ts
+import { {{displayName}} } from '{{framework}}';
+import { withArp } from '@kybernesis/arp-adapter-{{framework}}';
+
+const framework = new {{displayName}}({ /* normal config */ });
+const guarded = withArp(framework, {
+  handoff: './arp-handoff.json',
+});
+
+await guarded.start();
+```
+
+## Further reading
+
+- [`docs/ARP-adapter-authoring-guide.md`](https://github.com/KybernesisAI/arp/blob/main/docs/ARP-adapter-authoring-guide.md) — contract + anti-patterns.
+- [`docs/ARP-installation-and-hosting.md`](https://github.com/KybernesisAI/arp/blob/main/docs/ARP-installation-and-hosting.md) — the 5 integration points.
+- [`docs/ARP-policy-examples.md`](https://github.com/KybernesisAI/arp/blob/main/docs/ARP-policy-examples.md) — what a PDP decision looks like from the SDK's perspective.

package/templates/ts/package.json.hbs

@@ -0,0 +1,34 @@
+{
+  "name": "@kybernesis/arp-adapter-{{framework}}",
+  "version": "0.1.0",
+  "description": "ARP adapter for {{displayName}} — wraps the framework's public extension API with the five ARP integration points.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist", "README.md", "MIGRATION.md"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests"
+  },
+  "dependencies": {
+    "@kybernesis/arp-sdk": "{{arpVersion}}",
+    "@kybernesis/arp-spec": "{{arpVersion}}"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "tsup": "^8.3.5",
+    "typescript": "~5.5.4",
+    "vitest": "^2.1.5"
+  }
+}

package/templates/ts/src/index.ts.hbs

@@ -0,0 +1,142 @@
+/**
+ * @kybernesis/arp-adapter-{{framework}}
+ *
+ * Generated on {{generatedAt}} by @kybernesis/arp-create-adapter.
+ *
+ * Implements the five ARP integration points
+ * (see ARP-installation-and-hosting.md §8) on top of {{displayName}}'s
+ * public extension surface.
+ *
+ * TODO (you): replace the placeholder `{{frameworkPascal}}Like` surface in
+ * src/types.ts with the actual {{displayName}} public interface you
+ * depend on, and wire `useToolMiddleware` / `onPeerMessage` to whatever
+ * real hook names the framework uses.
+ */
+
+import {
+  ArpAgent,
+  guardAction,
+  type ArpAgentOptions,
+  type Resource,
+} from '@kybernesis/arp-sdk';
+import type { HandoffBundle } from '@kybernesis/arp-spec';
+import type {
+  {{frameworkPascal}}Like,
+  {{frameworkPascal}}Message,
+  {{frameworkPascal}}ToolContext,
+} from './types.js';
+
+export type {
+  {{frameworkPascal}}Like,
+  {{frameworkPascal}}Message,
+  {{frameworkPascal}}MessageHandler,
+  {{frameworkPascal}}Reply,
+  {{frameworkPascal}}ToolContext,
+  {{frameworkPascal}}ToolMiddleware,
+} from './types.js';
+
+export interface {{frameworkPascal}}ArpOptions
+  extends Omit<ArpAgentOptions, 'onIncoming'> {
+  handoff?: HandoffBundle | string | Record<string, unknown>;
+  agent?: ArpAgent;
+  port?: number;
+  toolMapping?: (ctx: {{frameworkPascal}}ToolContext) => {
+    action: string;
+    resource: Resource;
+    context?: Record<string, unknown>;
+  };
+}
+
+export interface ArpWrapped{{frameworkPascal}}<F extends {{frameworkPascal}}Like> {
+  framework: F;
+  agent: ArpAgent;
+  start(): Promise<void>;
+  stop(graceMs?: number): Promise<void>;
+}
+
+export function withArp<F extends {{frameworkPascal}}Like>(
+  framework: F,
+  options: {{frameworkPascal}}ArpOptions,
+): ArpWrapped{{frameworkPascal}}<F> {
+  let agent: ArpAgent | null = options.agent ?? null;
+  let started = false;
+  const port = options.port ?? 4500;
+
+  const toolMapping =
+    options.toolMapping ??
+    ((ctx: {{frameworkPascal}}ToolContext) => ({
+      action: ctx.toolName,
+      resource: { type: 'Tool', id: ctx.toolName },
+      context: ctx.args,
+    }));
+
+  async function ensureAgent(): Promise<ArpAgent> {
+    if (agent) return agent;
+    if (!options.handoff) {
+      throw new Error(
+        '@kybernesis/arp-adapter-{{framework}}: options.handoff or options.agent required',
+      );
+    }
+    const { agent: _a, handoff: _h, port: _p, toolMapping: _tm, ...rest } = options;
+    void _a; void _h; void _p; void _tm;
+    agent = await ArpAgent.fromHandoff(options.handoff, rest);
+    return agent;
+  }
+
+  framework.useToolMiddleware(async (ctx, next) => {
+    const a = await ensureAgent();
+    const mapping = toolMapping(ctx);
+    const result = await guardAction(a, {
+      connectionId: ctx.connectionId,
+      action: mapping.action,
+      resource: mapping.resource,
+      ...(mapping.context !== undefined ? { context: mapping.context } : {}),
+      run: () => next(),
+    });
+    if (!result.allow) {
+      return { error: 'denied_by_arp', reason: result.reason };
+    }
+    return result.data;
+  });
+
+  framework.onPeerMessage(async (msg: {{frameworkPascal}}Message) => {
+    const a = await ensureAgent();
+    const connectionId = msg.connectionId ?? (typeof msg.body['connection_id'] === 'string' ? msg.body['connection_id'] : null);
+    if (!connectionId) return { body: { error: 'missing_connection_id' } };
+    const res = await guardAction(a, {
+      connectionId,
+      action: msg.action,
+      resource: { type: 'Message', id: msg.id },
+      context: msg.body,
+      run: async () => ({ ok: true }),
+    });
+    if (!res.allow) return { body: { error: 'denied_by_arp', reason: res.reason } };
+    return { body: (res.data as Record<string, unknown>) ?? {} };
+  });
+
+  return {
+    framework,
+    get agent() {
+      if (!agent) throw new Error('agent not started');
+      return agent;
+    },
+    async start() {
+      const a = await ensureAgent();
+      if (!started) {
+        await a.start({ port });
+        started = true;
+      }
+      await framework.start();
+    },
+    async stop(graceMs = 5000) {
+      try {
+        await framework.stop();
+      } finally {
+        if (agent && started) {
+          await agent.stop({ graceMs });
+          started = false;
+        }
+      }
+    },
+  };
+}

package/templates/ts/src/types.ts.hbs

@@ -0,0 +1,46 @@
+/**
+ * Minimal structural interface describing {{displayName}}'s public
+ * extension surface that this adapter consumes. Replace the placeholder
+ * shape below with whatever {{displayName}} actually exposes (middleware,
+ * plugin, hooks, decorators).
+ *
+ * Rule: the adapter MUST only depend on documented public API. Never fork
+ * framework source or reach into internals.
+ */
+
+export interface {{frameworkPascal}}Like {
+  readonly id: string;
+  /** Register middleware for every outbound tool / action call. */
+  useToolMiddleware(mw: {{frameworkPascal}}ToolMiddleware): void;
+  /** Register an inbound-message handler. */
+  onPeerMessage(handler: {{frameworkPascal}}MessageHandler): void;
+  /** Start / stop — framework lifecycle. */
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+
+export interface {{frameworkPascal}}ToolContext {
+  connectionId: string;
+  toolName: string;
+  args: Record<string, unknown>;
+}
+
+export type {{frameworkPascal}}ToolMiddleware = (
+  ctx: {{frameworkPascal}}ToolContext,
+  next: () => Promise<unknown>,
+) => Promise<unknown>;
+
+export interface {{frameworkPascal}}Message {
+  id: string;
+  connectionId?: string;
+  action: string;
+  body: Record<string, unknown>;
+}
+
+export interface {{frameworkPascal}}Reply {
+  body: Record<string, unknown>;
+}
+
+export type {{frameworkPascal}}MessageHandler = (
+  msg: {{frameworkPascal}}Message,
+) => Promise<{{frameworkPascal}}Reply | void>;