@iniesta8888/agent-live 0.3.0

package/docs/VISION.md

@@ -0,0 +1,146 @@
+# Live Agent Show 产品愿景
+
+> 状态：已收敛方向 · 最后校准 2026-09-13
+
+相关设计：[Office 可配置内容模型](./OFFICE-THEMES.md) · [基础组件库](./COMPONENT-LIBRARY.md) · [系统架构](./ARCHITECTURE.md)
+
+## 1. 产品定义
+
+**Live Agent Show 把 AI Agent 的真实工作，实时呈现在一间有生命的办公室里。**
+
+这里的 Show 不是舞台剧，也不是让用户创造任意世界；它表示“工作正在现场发生，并且看得见”。办公室是固定的产品世界观，读取文件、执行命令、编辑代码、任务委派、等待和完成，都有稳定的办公叙事。
+
+当前只做 Demo 规格的单层办公室。普通用户选择完整 Office；Creator 可以在当前 Office 已声明的能力内调整美术风格、Agent 外观、NPC、物件、办公室生活、环境视觉、公共运行环境和文字区，但不能单独更换 Layout，也不能改变真实工作语义和基础运行规则。新的房间结构由内容开发者通过源码新增为完整 Preset。
+
+一句话可以表达为：
+
+> Watch your AI agents work—live in their office.
+
+## 2. 产品层级
+
+| 层级 | 定义 | 当前对应 |
+| --- | --- | --- |
+| Agent Live | 产品品牌 | 整个产品 |
+| Adapter | 从不同宿主读取其开放的 Agent 事实 | 已有 Pi、Codex、DSH；未来可继续接入 Cursor 等宿主 |
+| OfficeEvent | 与宿主无关的真实工作事件 | Pi、Codex、DSH 官方事实的转换结果 |
+| Office Engine | 将事件转成办公室位置、动作和状态 | 当前 `OfficeState`、映射与前端状态机 |
+| Office Runtime | 单层办公室的渲染、移动、寻路、气泡和状态规则 | 当前 Demo 前端状态机 |
+| Component Library | 八类基础组件的唯一全集与 Capability Catalog | 当前三个正式 Office 与 Custom Office 的共同内容来源 |
+| Office Spec | 一间办公室最终引用和实例化的组件集合 | Official Preset 与 Custom Office 的共同合同 |
+| Official Preset | 为普通用户准备的只读 Office Spec | 当前三个正式办公室 |
+| Custom Office | Creator 基于完整 Preset 修改、校验并保存在本地的 Office Spec | 已实现；Pi/DSH 支持会话级 custom/exit，Codex 使用当轮显式自定义 |
+| Episode | 一次可实时观看或回放的任务 | 一次 session / task |
+
+无论接入哪个宿主，核心体验都保持一致：Agent 在办公室中工作。不同宿主只会因为开放能力不同而出现信息精度差异，不会变成不同产品。
+
+## 3. 真实工作与开放的办公表现
+
+产品固定 Agent 真实工作的语义，但不把每种工作写死到一件家具：
+
+| 真实行为 | 固定语义 | 可选办公表现 |
+| --- | --- | --- |
+| 读取、搜索、分析 | `research` | 个人电脑、资料室、书架或档案柜 |
+| 写入、编辑 | `create` | 个人工位、设计台或共享工作桌 |
+| 命令、测试、运行 | `compute` | 个人电脑、服务器、机房或测试实验室 |
+| 计划、任务拆解 | `plan` | 白板、项目室或会议屏幕 |
+| 网络、提问、外部服务 | `communicate` | 电话间、前台、会议室或个人电脑 |
+| 委派、交接、评审 | `collaborate` | 会议桌、站会区或休息区 |
+
+Office 给设施标注能力，Office Engine 再为工作语义选择合适地点。因此办公室可以自由增加房间和设施；没有专用设施时，工作回退到个人工位。不能改变的是宿主事件的事实含义，而不是某张地图上的固定坐标。
+
+## 4. 可组合的 Office 内容
+
+当前固定为 Demo 的单层同屏办公室，不再定义 Company Scale。可替换内容拆成八个插槽：
+
+- **Style**：像素、手绘等整体美术语言，覆盖角色、家具、气泡、侧栏、颜色和特效。
+- **Layout**：同一单层办公室内的墙体、区域、家具坐标、功能锚点、座位和路径。
+- **Agent Skin**：真实 Agent 的角色造型、职位、制服与身份外观。
+- **NPC**：保安、清洁工、前台、访客、普通同事和宠物等办公室角色。
+- **Props**：工位、服务器、白板、饮水机、沙发、游戏机、绿植等功能或装饰物件。
+- **Life Activities**：喝水、休息、聊天、划水、娱乐，以及 NPC 的巡逻、打扫和接待等模拟日常。
+- **Atmosphere**：白天、雨夜等状态的色板、窗外、粒子和声音表现。
+- **Environment**：本地或固定时间、外部天气输入、自动照明和 NPC 班次。
+
+Component Library 是上述内容的唯一全集。Office Spec 从中组装一间办公室；Official Preset 是给普通用户一键选择的只读 Office Spec，Custom Office 则由 Creator 基于某个 Official Preset 修改得到（第一笔改动即生成内容完整继承的副本）。两者使用同一个 Compiler 和 Validator。内容模块不改变：
+
+- Agent 的真实状态与事件事实。
+- Work Event 的真实事实和工作语义。
+- 委派、等待、失败和完成代表的含义。
+
+其中 Work Event 来自宿主，拥有最高优先级；Life Event 由本地办公室模拟生成，只在空闲时运行，可以随时被真实工作打断，也不能进入真实工作统计。
+
+无论使用哪个 Preset，都保持单个场所、单层俯视、全办公室同屏，不增加园区、多楼层或视角下钻。
+
+完整边界与组合关系见 [Office 可配置内容模型](./OFFICE-THEMES.md)。
+
+## 5. 核心价值
+
+视觉风格负责吸引和陪伴，真实工作信息负责留存。产品应帮助用户快速回答：
+
+- 现在谁在做什么？
+- 哪一路正在等待、失败或需要我介入？
+- 多个 Agent 是否真的在并行？
+- 任务进行到哪里，刚才发生了什么？
+- 这次任务是否值得回放或分享？
+
+主画面服务于“瞥一眼”，完整日志、Diff、用量和时间轴放在侧栏或回放中。不能为了画面好看制造没有真实发生的工作、协作或结论。
+
+## 6. 建议路线图
+
+### 阶段一：把当前办公室做扎实（已完成基础版本）
+
+- 完善 Pi 事件覆盖、多人委派、错误和等待状态。
+- 将当前 Demo 明确为唯一的空间规格，不建设 Company Scale。
+- 已将 Demo 拆为 Preset 与八类内容，并由 V2 原生 renderer 和 Environment Runtime 驱动。
+- 将现有 `OfficeAction` 从具体家具逐步提升为 `research / create / compute / plan / communicate / collaborate` 等工作语义。
+- 将项目整理成用户可一键安装的 Pi Package，并提供宿主内启动入口。
+
+### 阶段二：先验证办公室生活的完整链路（已完成）
+
+- 加入一个饮水机 Prop、一个保洁 NPC，以及接水和巡检两类 Life Activities。
+- 保证 Life Activity 只在空闲时触发，并能被新的 Work Event 立即打断。
+- 保证 NPC 与模拟活动不会进入 Agent、工具、token 或任务统计。
+- 用这条纵向切片验证内容模块不是只有配置文件，而是能共同驱动画面与行为。
+
+### 阶段三：用第二套 Style 验证美术切换（已完成）
+
+- 制作一套视觉差异明显、但布局和行为相同的 Style。
+- 支持运行时选择 Style、预览和热切换。
+- 验证更换资源和视觉配置不影响事件语义与状态机。
+- 增加 Style 格式校验和资源缺失时的默认回退。
+
+### 阶段四：增加布局与角色内容（已完成基础版本）
+
+- 已增加 `old-school-office` 与 `boardroom-office` 两个单层 Layout，用设施能力标签承载相同 Work Semantics。
+- 已增加前台、后勤、秘书和会务 NPC，以及文件流转、会议支持与茶水服务；保安、办公室猫和更多生活行为继续作为可选内容。
+- 已用 Office Preset 将八类内容组合成顶部一键选项，并把时间、天气、照明和 NPC 班次收敛进共享 Environment。
+
+### 阶段五：回放与更多宿主（当前已有基础版本）
+
+- 保存标准 Show Event，支持时间轴、暂停、倍速和关键节点。
+- 当前已提供 Pi、Codex、DSH 三种官方 Adapter；未来宿主仍按其公开能力接入。
+- 在宿主能力不足时明确降级，而不是猜测或伪造状态。
+- 提供独立 Viewer / WebView，统一查看实时任务和历史 Episode。
+
+### 阶段六：有限开放内容创作（基础版本已完成）
+
+- 用户先选择经过验证的完整 Office，再通过受限 Creator 修改已实现内容；校验通过后直接保存并选择。
+- 导入、导出、版本检查和分享尚未实现，需要真实需求后再决定。
+- 只有真实需求出现后，再考虑可视化编辑器和内容市场。
+
+## 7. 当前明确不做
+
+- 不做任意世界生成器。
+- 不让用户改写真实工作语义，但允许 Office 自由提供不同设施来承载它们。
+- 不做故事规则编辑器、地图逻辑编辑器或脚本插件系统。
+- 不把产品做成只有一个桌宠的小悬浮窗。
+- 不为了展示原始推理而突破宿主能力和隐私边界。
+- 不先建设庞大的创作者平台或主题市场。
+
+## 8. 当前最重要的判断
+
+Live Agent Show 的边界可以概括为：
+
+> **一个开放而可信的办公世界：真实 Agent 工作驱动主线，独立 Office Life 让它在空闲时也持续生活。**
+
+当前 Demo 的配置拆分、V2 原生渲染、Office Life、三套正式 Office、公共 Environment、基础 Creator 和 Pi/Codex/DSH Adapter 已经进入主线。下一阶段聚焦真实宿主接入质量、三个 Adapter 的可维护性、开发者体验和发布流程，不扩张办公室世界边界。

package/examples/adapter/local-office.mjs

@@ -0,0 +1,52 @@
+import { randomBytes } from "node:crypto";
+import { pathToFileURL } from "node:url";
+import {
+  AgentLiveRuntime, OfficeContentService, CreatorService, CreatorCommandRouter,
+  defineAdapter, connectAdapter, createOfficeEventPublisher,
+} from "@iniesta8888/agent-live";
+
+// Public exports only. Replace this host subscription with your host's
+// documented event-to-OfficeDelta mapping.
+const adapter = defineAdapter({
+  id: "example",
+  name: "Example",
+  connect({ host, office }) { return host.subscribe((event) => office.publish(event)); },
+});
+
+export async function startExample({ host, cwd = process.cwd(), dataRoot, port = 0 }) {
+  const runtime = new AgentLiveRuntime(cwd, { dataRoot });
+  let connection;
+  let closePromise;
+  const close = () => closePromise ??= (async () => {
+    const results = await Promise.allSettled([connection?.close(), runtime.close()]);
+    const failures = results.filter((result) => result.status === "rejected");
+    if (failures.length) throw new AggregateError(failures.map((result) => result.reason), "Example cleanup failed");
+  })();
+  try {
+    const content = await OfficeContentService.create({ dataRoot });
+    const creator = new CreatorService(content.registry, content.library);
+    const commands = new CreatorCommandRouter(creator);
+    connection = await connectAdapter(adapter, { host, office: createOfficeEventPublisher(runtime.state) });
+    const token = randomBytes(24).toString("hex");
+    const server = await runtime.start({ port, content, creator: commands, creatorToken: token });
+    return { url: `${server.url}/v2.html?token=${token}`, close, creator, commands };
+  } catch (error) {
+    await close();
+    throw error;
+  }
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  const host = {
+    subscribe(publish) {
+      publish({ type: "agent_join", agent: { id: "main", name: "Example", role: "Agent", state: "idle", tokens: 0, cost: 0, toolCalls: 0, joinedAt: Date.now() } });
+      return () => {};
+    },
+  };
+  const office = await startExample({ host });
+  console.log(office.url);
+  console.log("Press Ctrl+C to close this example. Host adapters choose their own normal exit policy.");
+  const stop = () => void office.close().catch(console.error);
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+	"name": "@iniesta8888/agent-live",
+	"version": "0.3.0",
+	"type": "module",
+	"description": "Give coding agents a live pixel office",
+	"keywords": ["coding-agent", "agent-adapter", "codex-plugin", "pi-extension", "agent-visualization", "pixel-office"],
+	"author": "ssssnail",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ssssnail/agent-live.git"
+	},
+	"homepage": "https://github.com/ssssnail/agent-live#readme",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"bugs": {
+		"url": "https://github.com/ssssnail/agent-live/issues"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		},
+		"./adapter-sdk": {
+			"types": "./dist/adapter-sdk/index.d.ts",
+			"import": "./dist/adapter-sdk/index.js"
+		}
+	},
+	"files": ["dist/adapter-sdk", "dist/content", "dist/core", "dist/creator", "dist/runtime", "dist/web", "dist/index.js", "dist/index.js.map", "dist/index.d.ts", "dist/index.d.ts.map", "skills", "docs", "examples", "README.md", "CONTRIBUTING.md", "SECURITY.md", "CODE_OF_CONDUCT.md", "LICENSE"],
+	"engines": {
+		"node": ">=22"
+	},
+	"scripts": {
+		"test": "npm run check",
+		"build": "npm run build:validator && node scripts/build.mjs",
+		"typecheck": "tsc -p tsconfig.check.json",
+		"preview": "node plugins/agent-live/scripts/preview.ts",
+		"validate:components": "node plugins/agent-live/scripts/validate-component-library.ts",
+		"validate:activity-implementations": "node plugins/agent-live/scripts/validate-activity-implementations.ts",
+		"validate:architecture": "node plugins/agent-live/scripts/validate-architecture.ts",
+		"validate:adapter-sdk": "node plugins/agent-live/scripts/validate-adapter-sdk.ts",
+		"validate:sdk-example": "node scripts/validate-sdk-example.mjs",
+		"validate:layouts": "node plugins/agent-live/scripts/validate-layouts.ts && node plugins/agent-live/scripts/validate-office-engine.ts",
+		"validate:office-schema": "node plugins/agent-live/scripts/validate-office-schema.ts",
+		"validate:office-compiler": "node plugins/agent-live/scripts/validate-office-compiler.ts",
+		"validate:official-offices": "node plugins/agent-live/scripts/validate-official-offices.ts",
+		"validate:office-registry": "node plugins/agent-live/scripts/validate-office-registry.ts",
+		"validate:creator-service": "node plugins/agent-live/scripts/validate-creator-service.ts",
+		"validate:creator-mode": "node plugins/agent-live/scripts/validate-creator-mode.ts",
+		"validate:creator-commands": "node plugins/agent-live/scripts/validate-creator-commands.ts",
+		"validate:runtime-content": "node plugins/agent-live/scripts/validate-runtime-content.ts",
+		"validate:resource-guard": "node plugins/agent-live/scripts/validate-resource-guard.ts",
+		"validate:custom-office-runtime": "node plugins/agent-live/scripts/validate-custom-office-runtime.ts",
+		"validate:content": "node plugins/agent-live/scripts/validate-content.ts",
+		"validate:environment": "node plugins/agent-live/scripts/validate-environment.ts",
+		"validate:history": "node plugins/agent-live/scripts/validate-history.ts",
+		"validate:locales": "node plugins/agent-live/scripts/validate-locales.ts",
+		"validate:agents": "node plugins/agent-live/scripts/validate-agent-registry.ts",
+		"validate:codex-adapter": "node plugins/agent-live/scripts/validate-codex-adapter.ts",
+		"validate:dsh-adapter": "node plugins/agent-live/scripts/validate-dsh-adapter.ts",
+		"validate:office-engine": "node plugins/agent-live/scripts/validate-office-engine.ts",
+		"validate:render": "node plugins/agent-live/scripts/validate-render.mjs",
+		"validate:pi-creator": "node plugins/agent-live/scripts/validate-pi-creator.ts",
+		"validate:pi-lifecycle": "node plugins/agent-live/scripts/validate-pi-lifecycle.ts",
+		"validate:runtime-lifecycle": "node plugins/agent-live/scripts/validate-runtime-lifecycle.ts",
+		"validate:codex-turn-race": "node plugins/agent-live/scripts/validate-codex-turn-race.ts",
+		"validate:server-url": "node plugins/agent-live/scripts/validate-server-url.ts",
+		"validate:codex-client": "node plugins/agent-live/scripts/validate-codex-client.ts",
+		"validate:codex-session": "node plugins/agent-live/scripts/validate-codex-session.ts",
+		"validate:package": "node plugins/agent-live/scripts/validate-package.ts",
+		"codex": "node plugins/agent-live/scripts/codex-client.ts",
+		"test:integration:codex": "npm run validate:codex-client && npm run validate:codex-session",
+		"check": "npm run typecheck && npm run validate:architecture && npm run validate:web-validator && npm run validate:resource-guard && npm run validate:components && npm run validate:activity-implementations && npm run validate:layouts && npm run validate:office-schema && npm run validate:office-compiler && npm run validate:official-offices && npm run validate:office-registry && npm run validate:creator-service && npm run validate:creator-mode && npm run validate:creator-commands && npm run validate:runtime-content && npm run validate:custom-office-runtime && npm run validate:content && npm run validate:environment && npm run validate:history && npm run validate:locales && npm run validate:agents && npm run validate:codex-adapter && npm run validate:dsh-adapter && npm run validate:render && npm run validate:pi-creator && npm run validate:pi-lifecycle && npm run validate:runtime-lifecycle && npm run validate:codex-turn-race && npm run validate:server-url && node --check plugins/agent-live/src/core/protocol.ts && node --check plugins/agent-live/src/core/limits.ts && node --check plugins/agent-live/src/core/agents.ts && node --check plugins/agent-live/src/core/state.ts && node --check plugins/agent-live/src/core/mapping.ts && node --check plugins/agent-live/src/runtime/content-service.ts && node --check plugins/agent-live/src/runtime/server.ts && node --check plugins/agent-live/src/runtime/agent-live-runtime.ts && node --check plugins/agent-live/src/runtime/resource-guard.ts && node --input-type=module -e \"await import('./plugins/agent-live/src/runtime/agent-live-runtime.ts')\" && node --check packages/pi/src/adapter.ts && node --check plugins/agent-live/src/adapters/codex/app-server-client.ts && node --check plugins/agent-live/src/adapters/codex/adapter.ts && node --check plugins/agent-live/src/adapters/codex/launcher.ts && node --check plugins/agent-live/dsh/src/adapter.ts && node --check plugins/agent-live/scripts/codex-client.ts && node --check plugins/agent-live/scripts/creator-command.ts && node --check plugins/agent-live/web/app.js && node --check plugins/agent-live/web/v2/bootstrap.js && node --check plugins/agent-live/web/v2/static-content.js && node --check plugins/agent-live/web/v2/codex-controls.js && node --check plugins/agent-live/web/v2/i18n.js && node --check plugins/agent-live/web/v2/environment-runtime.js && node --check plugins/agent-live/web/v2/office-renderer.js && node --check plugins/agent-live/web/v2/sprite-renderer.js",
+		"check:dsh": "npm ci --ignore-scripts --prefix plugins/agent-live/dsh && npm run check --prefix plugins/agent-live/dsh",
+		"check:ci": "npm run check && npm run validate:adapter-sdk && npm run build && npm run validate:sdk-example && npm run check:dsh && npm run validate:generated && npm run validate:package && npm run validate:distributions && npm pack --dry-run --ignore-scripts",
+		"prepare": "npm run build",
+		"prepack": "npm run check && npm run build",
+		"build:validator": "node scripts/web-validator.mjs",
+		"validate:web-validator": "node scripts/web-validator.mjs --check",
+		"validate:generated": "node scripts/validate-generated.mjs",
+		"validate:distributions": "node scripts/validate-distributions.mjs"
+	},
+	"devDependencies": {
+		"@earendil-works/pi-coding-agent": "0.85.1",
+		"@types/node": "22.20.2",
+		"esbuild": "^0.25.0",
+		"typescript": "5.9.3"
+	}
+}

package/skills/agent-live-adapter-builder/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: agent-live-adapter-builder
+description: Investigate a coding agent's official extension APIs and build or review an independent Agent Live adapter with evidence, event mapping, scaffolding, and contract tests. Use when adding Agent Live support to a new coding-agent host; do not use for editing Offices or presets.
+---
+
+# Agent Live Adapter Builder
+
+Build adapters against the public `@iniesta8888/agent-live` package. Never import repository-internal files.
+
+## Required gates
+
+1. Locate official host documentation, SDK types, or public source. Record exact links, versions, event names, fields, and lifecycle behavior in `HOST-CAPABILITIES.md`.
+2. If the evidence cannot establish a supported extension or event surface, stop with an analysis. Do not probe private storage, infer events from UI text, or generate a pretend adapter.
+3. Map each authoritative host event to one `OfficeDelta` in `EVENT-MAPPING.md`. Mark missing capabilities unsupported; do not manufacture work facts for visual completeness.
+4. Run `scripts/create-adapter.mjs` only after the evidence and mapping are clear. Then replace every generated TODO with host-specific code.
+5. Test normal completion, failure, interruption/disconnect, stable IDs, duplicate delivery, missing optional fields, cleanup, and officially supported subagents or controls.
+
+Read [references/investigation.md](references/investigation.md) while investigating. Read [references/review.md](references/review.md) before declaring the adapter complete or preparing an upstream contribution.
+
+## Scaffold
+
+~~~bash
+node <SKILL_ROOT>/scripts/create-adapter.mjs --id <host-id> --name "<Host Name>" --output <directory>
+~~~
+
+The script refuses to overwrite a non-empty directory. The adapter remains an independent package unless the user explicitly asks to integrate it into the Agent Live repository.
+
+## Completion report
+
+Report verified capabilities, unsupported capabilities, tests run, real-host validation still required, and every assumption. Never describe a simulated test as real-host validation.

package/skills/agent-live-adapter-builder/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Agent Live Adapter Builder"
+  short_description: "Build a verified Agent Live adapter"
+  default_prompt: "Build an Agent Live adapter from official host documentation and SDK evidence."

package/skills/agent-live-adapter-builder/references/investigation.md

@@ -0,0 +1,9 @@
+# Host investigation
+
+Prefer the host's official terminology. For every claimed capability, capture a source and the exact public symbol, endpoint, callback, notification, command, or view slot.
+
+Investigate independently: realtime observation; task submission and interruption; approval response; model read or selection; stable session, agent, parent-agent, turn and tool-call identities; history APIs; command, tool, context and view registration; startup, shutdown, reconnect and duplicate delivery.
+
+An API that controls a task does not automatically expose all internal events. A history API is not realtime observation. A hook supplies only the fields present at that hook. Unknown means unsupported until evidence is found.
+
+Create an event table with: official event, source, delivery form, available fields, stable IDs, ordering/duplication notes, mapped `OfficeDelta`, and degradation.

package/skills/agent-live-adapter-builder/references/review.md

@@ -0,0 +1,7 @@
+# Adapter review
+
+Confirm that the package imports only `@iniesta8888/agent-live` public exports, contains no copied renderer or Creator implementation, and changes no other adapter. Capabilities must be inferred from implemented controls and view mounting rather than manually asserted.
+
+Check that one authoritative host source produces each fact, streaming cursors do not repeat completed text, tool start/end share an ID, subagents never replace the main agent, and uncertain outcomes remain uncertain. Cleanup must be idempotent and release only adapter-owned resources. Agent Live owns and cleans its own runtime resources; the adapter must not stop the host.
+
+For an official contribution, require automated contract tests, a real-host test record, supported host versions, permissions/data disclosure, dependency licenses, and evidence for every public API claim.

package/skills/agent-live-adapter-builder/scripts/create-adapter.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { mkdir, readdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+const args = process.argv.slice(2);
+const value = (flag) => { const index = args.indexOf(flag); return index >= 0 ? args[index + 1] : undefined; };
+const id = value("--id");
+const name = value("--name");
+const output = value("--output");
+if (!id || !/^[a-z0-9][a-z0-9-]*$/.test(id) || !name || !output) throw new Error("Usage: create-adapter.mjs --id <lowercase-id> --name <name> --output <directory>");
+const root = path.resolve(output);
+await mkdir(root, { recursive: true });
+if ((await readdir(root)).length) throw new Error(`Refusing to overwrite non-empty directory: ${root}`);
+await mkdir(path.join(root, "src"));
+await mkdir(path.join(root, "test"));
+const className = id.replace(/(^|-)([a-z])/g, (_match, _dash, letter) => letter.toUpperCase());
+const files = {
+	"package.json": JSON.stringify({ name: `agent-live-adapter-${id}`, version: "0.1.0", private: true, type: "module", scripts: { test: "node --test" }, dependencies: { "@iniesta8888/agent-live": "^0.3.0" } }, null, 2) + "\n",
+	"src/index.ts": `import { defineAdapter, type OfficeDelta } from "@iniesta8888/agent-live";\n\nexport interface ${className}Host {\n\tsubscribe(listener: (event: unknown) => void): () => void;\n}\n\nfunction mapHostEvent(_event: unknown): OfficeDelta | undefined {\n\t// TODO: implement only mappings supported by official host evidence.\n\treturn undefined;\n}\n\nexport default defineAdapter<${className}Host>({\n\tid: "${id}",\n\tname: ${JSON.stringify(name)},\n\tconnect({ host, office }) {\n\t\treturn host.subscribe((event) => {\n\t\t\tconst mapped = mapHostEvent(event);\n\t\t\tif (mapped) office.publish(mapped);\n\t\t});\n\t},\n});\n`,
+	"test/adapter.test.ts": `import test from "node:test";\nimport assert from "node:assert/strict";\nimport adapter from "../src/index.ts";\n\ntest("adapter identity", () => {\n\tassert.equal(adapter.id, "${id}");\n});\n`,
+	"HOST-CAPABILITIES.md": `# ${name} capabilities\n\nTODO: Record official sources, versions, supported and unsupported capabilities before implementation.\n`,
+	"EVENT-MAPPING.md": `# ${name} event mapping\n\n| Official event | Source | Fields and IDs | Delivery | OfficeDelta | Degradation |\n| --- | --- | --- | --- | --- | --- |\n| TODO | TODO | TODO | TODO | TODO | TODO |\n`,
+	"README.md": `# Agent Live adapter for ${name}\n\nDevelop against the public Agent Live Adapter SDK manual. Do not import Agent Live repository internals.\n`,
+};
+for (const [relative, content] of Object.entries(files)) await writeFile(path.join(root, relative), content, "utf8");
+console.log(root);