@s_s/agent-kit 1.0.0 → 1.1.0

package/README.md

@@ -6,7 +6,7 @@ MCP Server / Skill 开发基础设施库。提供 agent 检测、prompt 注入
 
 - **Agent 检测** — 通过文件系统特征或 MCP clientInfo 自动识别 agent 类型（OpenCode、Claude Code、OpenClaw、Codex）
 - **Prompt 注入** — 向 agent 配置文件（`AGENTS.md`、`CLAUDE.md`、manifests 等）注入自定义指令，支持幂等更新
-- **Intent-based Hook 系统** — 按意图声明，自动翻译为各 agent 原生格式，支持三层优先级和显式降级
+- **Hook 安装** — 用户提供完整 hook 内容，agent-kit 负责写入正确路径、管理 settings.json 和生命周期
 - **跨平台数据目录** — 自动适配 macOS / Linux / Windows，支持 global / project 两种作用域
 - **零运行时依赖** — 纯 TypeScript，零 dependencies
 - **工厂模式** — `createKit(name)` 返回绑定了工具名的函数集，支持解构，无全局状态
@@ -20,42 +20,52 @@ npm install @s_s/agent-kit
 ## 快速开始
 
 ```typescript
-import { createKit, hooks, detectAgent } from '@s_s/agent-kit';
+import { createKit, defineHooks, detectAgent } from '@s_s/agent-kit';
 
-// 1. 创建 kit 实例（支持解构）
+// 1. 创建 kit 实例
 const { injectPrompt, installHooks, getDataDir } = createKit('my-mcp');
 
-// 2. 声明 hook 意图（全局 API，不绑定实例）
-hooks.inject({
-  perTurn: 'Remember to use my-mcp tools when relevant.',
-  sessionStart: 'Welcome! Check my-mcp for context.',
-  compaction: 'Preserve my-mcp context during compaction.',
-});
-
-hooks.beforeToolCall({
-  match: /^Bash/,
-  handler: (ctx) => {
-    if (ctx.args.command?.includes('rm -rf')) {
-      return { block: true, reason: 'Dangerous command blocked' };
-    }
+// 2. 声明 hook（每个 agent 独立声明，内容由用户完全控制）
+// hooks/claude-code.ts
+const claudeHooks = defineHooks('claude-code', [
+  {
+    events: ['UserPromptSubmit'],
+    content: '#!/bin/bash\necho "<reminder>Use my-mcp tools.</reminder>"',
+  },
+  {
+    events: ['PreToolUse'],
+    content:
+      '#!/bin/bash\n# 拦截危险操作\nTOOL_NAME="$HOOK_TOOL_NAME"\nif [[ "$TOOL_NAME" == "Bash" ]]; then echo "checked"; fi',
   },
+]);
+
+// hooks/opencode.ts
+const opencodeHooks = defineHooks('opencode', {
+  events: ['experimental.chat.messages.transform'],
+  content: `export default {
+    name: 'my-mcp',
+    hooks: {
+      'experimental.chat.messages.transform': async (messages) => {
+        messages.push({ role: 'user', content: '<reminder>Use my-mcp tools.</reminder>' });
+        return messages;
+      },
+    },
+  };`,
 });
 
 // 3. 检测当前 agent
 const agent = await detectAgent();
 if (!agent) throw new Error('No supported agent detected');
 
-// 4. 注入 prompt 到 agent 配置文件
+// 4. 注入 prompt
 await injectPrompt(agent, '## My MCP\nInstructions for the agent...');
 
-// 5. 安装 hooks（自动翻译为 agent 原生格式）
-const result = await installHooks(agent);
+// 5. 安装 hooks
+const result = await installHooks(agent, [claudeHooks, opencodeHooks]);
 console.log(`Hooks installed: ${result.filesWritten.join(', ')}`);
-console.log(`Warnings: ${result.warnings.join('\n')}`);
 
 // 6. 获取数据目录路径
 const dataDir = getDataDir(); // global scope
-const projectDir = getDataDir({ scope: 'project', projectRoot: '/path/to/project' });
 ```
 
 ## API
@@ -83,23 +93,14 @@ createKit(name: string, options?: KitOptions): Kit
 
 返回的 Kit 对象包含以下方法：
 
-| 方法                                    | 说明                          |
-| --------------------------------------- | ----------------------------- |
-| `injectPrompt(agent, prompt, options?)` | 注入 prompt 到 agent 配置文件 |
-| `hasPromptInjected(agent, options?)`    | 检查 prompt 是否已注入        |
-| `installHooks(agent)`                   | 安装 hooks                    |
-| `uninstallHooks(agent)`                 | 卸载 hooks                    |
-| `hasHooksInstalled(agent)`              | 检查 hooks 是否已安装         |
-| `getDataDir(options?)`                  | 获取跨平台数据目录路径        |
-
-### Hook 系统
-
-Hook 系统分为两个阶段：**声明**和**安装**。
-
-1. **声明**：通过全局 `hooks.*` API 声明意图（`inject` / `beforeToolCall` / `afterToolCall` / `onSession` / `onPermission`），以及 `raw` / `extend` 两种高级注册方式
-2. **安装**：调用 `kit.installHooks(agent)` 时，从全局注册中心读取所有声明，翻译为目标 agent 的原生格式并写入磁盘
-
-详细的 API 说明、示例、三层优先级机制和降级行为，请参阅 **[Hook 使用指南](docs/hook-usage.md)**。各 agent 原生 hook 能力的完整横向对比，请参阅 **[Hook 横向对比](docs/hooks-comparison.md)**。
+| 方法                                    | 说明                                |
+| --------------------------------------- | ----------------------------------- |
+| `injectPrompt(agent, prompt, options?)` | 注入 prompt 到 agent 配置文件       |
+| `hasPromptInjected(agent, options?)`    | 检查 prompt 是否已注入              |
+| `installHooks(agent, hooks)`            | 安装 hooks（传入 defineHooks 声明） |
+| `uninstallHooks(agent)`                 | 卸载 hooks                          |
+| `hasHooksInstalled(agent)`              | 检查 hooks 是否已安装               |
+| `getDataDir(options?)`                  | 获取跨平台数据目录路径              |
 
 ### Kit 方法详情
 
@@ -115,15 +116,20 @@ injectPrompt(agent: AgentType, prompt: string, options?: ScopeOptions): Promise<
 - 后续调用：替换已有标记块（幂等更新）
 - 自动创建目录和文件
 
-#### `kit.installHooks(agent)`
+#### `kit.installHooks(agent, hooks)`
 
-为指定 agent 安装 hooks。从 hook 注册中心读取所有声明，翻译为原生格式，写入文件。
+为指定 agent 安装 hooks。接受一个或多个 `HookSet`（由 `defineHooks()` 返回），将内容写入 agent 的 hook 目录。
 
 ```typescript
-installHooks(agent: AgentType): Promise<HookInstallResult>
+installHooks(agent: AgentType, hooks: HookSet | HookSet[]): Promise<HookInstallResult>
 ```
 
-返回值包含完整的降级信息：
+- 自动过滤：只处理与 `agent` 匹配的 `HookSet`，其余忽略
+- Claude Code / Codex：写入 shell 脚本 + 自动注册到 `settings.json`
+- OpenCode：写入 TypeScript 插件文件到 plugins 目录
+- OpenClaw：生成 `HOOK.md`（YAML frontmatter）+ `handler.ts`
+
+返回值：
 
 ```typescript
 interface HookInstallResult {
@@ -132,20 +138,11 @@ interface HookInstallResult {
   filesWritten: string[];
   settingsUpdated: boolean;
   notes: string[];
-  warnings: string[]; // 降级/冲突警告
-  skipped: SkippedIntent[]; // 被跳过的意图
+  warnings: string[];
   error?: string;
 }
 ```
 
-各 agent 的翻译方式：
-
-| Agent               | 生成内容                                                |
-| ------------------- | ------------------------------------------------------- |
-| claude-code / codex | Shell 脚本（多个原生 hook），自动注册到 `settings.json` |
-| openclaw            | `HOOK.md` + `handler.ts`（内部 hook + 插件 hook）       |
-| opencode            | 单个 TypeScript 插件文件（多个 hook 合并）              |
-
 #### `kit.uninstallHooks(agent)`
 
 清理已安装的 hook 文件和 settings.json 条目。
@@ -169,6 +166,49 @@ getDataDir(options?: ScopeOptions): string
 
 全局路径可通过环境变量覆盖（默认变量名：`{NAME}_DATA_DIR`）。
 
+### Hook 系统
+
+Hook 系统分为两个阶段：**声明**和**安装**。
+
+1. **声明**：通过 `defineHooks(agent, definitions)` 纯函数声明 hook 内容。每个 agent 独立声明，内容由用户完全控制。支持分文件组织。
+2. **安装**：调用 `kit.installHooks(agent, hooks)` 时，将声明内容写入目标 agent 的 hook 目录。
+
+#### `defineHooks(agent, definitions)`
+
+纯函数，不依赖任何实例或全局状态。做运行时校验（事件名合法性、content 非空），返回类型安全的 `HookSet` 数据对象。
+
+```typescript
+import { defineHooks } from '@s_s/agent-kit';
+
+// 单条声明
+const hooks = defineHooks('claude-code', {
+  events: ['PreToolUse', 'PostToolUse'], // 多事件共享同一内容
+  content: '#!/bin/bash\necho "hook fired"',
+});
+
+// 多条声明
+const hooks = defineHooks('claude-code', [
+  { events: ['PreToolUse'], content: '#!/bin/bash\necho "pre"' },
+  { events: ['PostToolUse'], content: '#!/bin/bash\necho "post"' },
+]);
+
+// OpenClaw — 支持 description 参数
+const hooks = defineHooks('openclaw', {
+  events: ['session_start', 'before_tool_call'],
+  content: 'export default async function(event) { return event; }',
+  description: '注入项目规范到每轮对话',
+});
+```
+
+**设计原则**：agent-kit 是"安装器"而非"翻译器"。用户提供各 agent 的原生 hook 内容，agent-kit 只负责：
+
+- 知道正确的文件路径
+- 写入文件
+- 管理 settings.json 合并（Claude Code / Codex）
+- 安装 / 卸载生命周期
+
+详细的使用示例和各 agent 事件名列表，请参阅 **[Hook 使用指南](docs/hook-usage.md)**。各 agent 原生 hook 能力的完整横向对比，请参阅 **[Hook 横向对比](docs/hooks-comparison.md)**。
+
 ### 独立函数
 
 以下函数不依赖 kit 实例，可直接使用。
@@ -208,23 +248,6 @@ detectProjectRoot(cwd?: string): Promise<string>
 
 优先使用 `git rev-parse --show-toplevel`，失败则向上遍历查找标记文件（`.git`、`package.json`、`pyproject.toml`、`Cargo.toml`、`go.mod`），都未找到则回退到 `cwd`。
 
-### 能力矩阵 API
-
-编程式查询各 agent 对各 intent 的支持程度。
-
-```typescript
-import { CAPABILITY_MATRIX, checkDegradation, isIntentFullyUnsupported } from '@s_s/agent-kit';
-
-// 查询特定能力
-CAPABILITY_MATRIX.opencode.beforeToolCall.block.level; // 'partial'
-
-// 检查某 intent 在某 agent 上的降级情况
-const warnings = checkDegradation('opencode', 'beforeToolCall');
-
-// 检查是否完全不支持
-isIntentFullyUnsupported('openclaw', 'onPermission'); // true
-```
-
 ## 类型
 
 ```typescript
@@ -246,12 +269,25 @@ interface Kit {
   readonly name: string;
   injectPrompt(agent: AgentType, prompt: string, options?: ScopeOptions): Promise<void>;
   hasPromptInjected(agent: AgentType, options?: ScopeOptions): Promise<boolean>;
-  installHooks(agent: AgentType): Promise<HookInstallResult>;
+  installHooks(agent: AgentType, hooks: HookSet | HookSet[]): Promise<HookInstallResult>;
   uninstallHooks(agent: AgentType): Promise<{ success: boolean; removed: string[]; error?: string }>;
   hasHooksInstalled(agent: AgentType): Promise<boolean>;
   getDataDir(options?: ScopeOptions): string;
 }
 
+// Hook 定义
+interface HookDefinition<A extends AgentType = AgentType> {
+  events: string[]; // agent 原生事件名
+  content: string; // hook 内容（shell 脚本、TypeScript 代码等）
+  description?: string; // OpenClaw 专属 — HOOK.md 描述
+}
+
+// defineHooks() 返回的数据对象
+interface HookSet<A extends AgentType = AgentType> {
+  readonly agent: A;
+  readonly definitions: readonly HookDefinition<A>[];
+}
+
 interface HookInstallResult {
   success: boolean;
   hookDir: string;
@@ -259,17 +295,8 @@ interface HookInstallResult {
   settingsUpdated: boolean;
   notes: string[];
   warnings: string[];
-  skipped: SkippedIntent[];
   error?: string;
 }
-
-interface SkippedIntent {
-  intent: string;
-  agent: string;
-  reason: string;
-}
-
-type SupportLevel = 'supported' | 'partial' | 'unsupported';
 ```
 
 ## 支持的 Agent

package/build/create-kit.js

@@ -37,8 +37,8 @@ export function createKit(name, options) {
         hasPromptInjected(agent, scopeOptions) {
             return hasPromptInjected(name, agent, scopeOptions);
         },
-        installHooks(agent) {
-            return installHooks(name, agent);
+        installHooks(agent, hooks) {
+            return installHooks(name, agent, hooks);
         },
         uninstallHooks(agent) {
             return uninstallHooks(name, agent);

package/build/create-kit.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-kit.js","sourceRoot":"","sources":["../src/create-kit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAoB;IACxD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAsB;QAC9B,IAAI;QACJ,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,WAAW,EAAE,OAAO,EAAE,WAAW;KACpC,CAAC;IAEF,OAAO;QACH,IAAI,IAAI;YACJ,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,YAAY,CAAC,KAAgB,EAAE,MAAc,EAAE,YAA2B;YACtE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAC3D,CAAC;QAED,iBAAiB,CAAC,KAAgB,EAAE,YAA2B;YAC3D,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QACxD,CAAC;QAED,YAAY,CAAC,KAAgB;YACzB,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,cAAc,CAAC,KAAgB;YAC3B,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,iBAAiB,CAAC,KAAgB;YAC9B,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,UAAU,CAAC,YAA2B;YAClC,OAAO,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5C,CAAC;KACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"create-kit.js","sourceRoot":"","sources":["../src/create-kit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAoB;IACxD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAsB;QAC9B,IAAI;QACJ,IAAI,EAAE,OAAO,EAAE,IAAI;QACnB,WAAW,EAAE,OAAO,EAAE,WAAW;KACpC,CAAC;IAEF,OAAO;QACH,IAAI,IAAI;YACJ,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,YAAY,CAAC,KAAgB,EAAE,MAAc,EAAE,YAA2B;YACtE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QAC3D,CAAC;QAED,iBAAiB,CAAC,KAAgB,EAAE,YAA2B;YAC3D,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;QACxD,CAAC;QAED,YAAY,CAAC,KAAgB,EAAE,KAA0B;YACrD,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QAED,cAAc,CAAC,KAAgB;YAC3B,OAAO,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QAED,iBAAiB,CAAC,KAAgB;YAC9B,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,UAAU,CAAC,YAA2B;YAClC,OAAO,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5C,CAAC;KACJ,CAAC;AACN,CAAC"}

package/build/define-hooks.d.ts

@@ -0,0 +1,31 @@
+import type { AgentType, HookDefinition, HookSet } from './types.js';
+/**
+ * Define hooks for a specific agent. Returns a validated HookSet that can be
+ * passed to `kit.installHooks()`.
+ *
+ * Pure function — no side effects, no global state, no instance dependency.
+ *
+ * @param agent - Target agent type.
+ * @param definitions - A single HookDefinition or an array of HookDefinitions.
+ *
+ * @example
+ * ```ts
+ * // Single definition
+ * const hooks = defineHooks('claude-code', {
+ *   events: ['PreToolUse', 'PostToolUse'],
+ *   content: '#!/bin/bash\necho "hook fired"',
+ * });
+ *
+ * // Multiple definitions
+ * const hooks = defineHooks('claude-code', [
+ *   { events: ['PreToolUse'], content: '#!/bin/bash\necho "pre"' },
+ *   { events: ['PostToolUse'], content: '#!/bin/bash\necho "post"' },
+ * ]);
+ * ```
+ */
+export declare function defineHooks<A extends AgentType>(agent: A, definitions: HookDefinition<A> | HookDefinition<A>[]): HookSet<A>;
+/**
+ * Get the set of valid event names for a given agent.
+ * Useful for tooling and documentation generation.
+ */
+export declare function getValidEvents(agent: AgentType): ReadonlySet<string>;

package/build/define-hooks.js

@@ -0,0 +1,192 @@
+import { AGENT_TYPES } from './types.js';
+// ---------------------------------------------------------------------------
+// Valid event names per agent (for runtime validation)
+// ---------------------------------------------------------------------------
+const VALID_EVENTS = {
+    'claude-code': new Set([
+        'SessionStart',
+        'InstructionsLoaded',
+        'UserPromptSubmit',
+        'PreToolUse',
+        'PermissionRequest',
+        'PostToolUse',
+        'PostToolUseFailure',
+        'Notification',
+        'SubagentStart',
+        'SubagentStop',
+        'Stop',
+        'TeammateIdle',
+        'TaskCompleted',
+        'ConfigChange',
+        'WorktreeCreate',
+        'WorktreeRemove',
+        'PreCompact',
+        'PostCompact',
+        'Elicitation',
+        'ElicitationResult',
+        'SessionEnd',
+    ]),
+    codex: new Set([
+        'SessionStart',
+        'InstructionsLoaded',
+        'UserPromptSubmit',
+        'PreToolUse',
+        'PermissionRequest',
+        'PostToolUse',
+        'PostToolUseFailure',
+        'Notification',
+        'SubagentStart',
+        'SubagentStop',
+        'Stop',
+        'TeammateIdle',
+        'TaskCompleted',
+        'ConfigChange',
+        'WorktreeCreate',
+        'WorktreeRemove',
+        'PreCompact',
+        'PostCompact',
+        'Elicitation',
+        'ElicitationResult',
+        'SessionEnd',
+    ]),
+    opencode: new Set([
+        'event',
+        'config',
+        'tool',
+        'auth',
+        'chat.message',
+        'chat.params',
+        'chat.headers',
+        'permission.ask',
+        'command.execute.before',
+        'tool.execute.before',
+        'shell.env',
+        'tool.execute.after',
+        'experimental.chat.messages.transform',
+        'experimental.chat.system.transform',
+        'experimental.session.compacting',
+        'experimental.text.complete',
+        'tool.definition',
+    ]),
+    openclaw: new Set([
+        // Plugin hooks
+        'before_model_resolve',
+        'before_prompt_build',
+        'before_agent_start',
+        'llm_input',
+        'llm_output',
+        'agent_end',
+        'before_compaction',
+        'after_compaction',
+        'before_reset',
+        'message_received',
+        'message_sending',
+        'message_sent',
+        'before_tool_call',
+        'after_tool_call',
+        'tool_result_persist',
+        'before_message_write',
+        'session_start',
+        'session_end',
+        'subagent_spawning',
+        'subagent_delivery_target',
+        'subagent_spawned',
+        'subagent_ended',
+        'gateway_start',
+        'gateway_stop',
+        // Internal hooks
+        'command:new',
+        'command:reset',
+        'command:stop',
+        'session:compact:before',
+        'session:compact:after',
+        'agent:bootstrap',
+        'gateway:startup',
+        'message:received',
+        'message:sent',
+        'message:transcribed',
+        'message:preprocessed',
+    ]),
+};
+// ---------------------------------------------------------------------------
+// defineHooks — pure validation + packaging function
+// ---------------------------------------------------------------------------
+/**
+ * Define hooks for a specific agent. Returns a validated HookSet that can be
+ * passed to `kit.installHooks()`.
+ *
+ * Pure function — no side effects, no global state, no instance dependency.
+ *
+ * @param agent - Target agent type.
+ * @param definitions - A single HookDefinition or an array of HookDefinitions.
+ *
+ * @example
+ * ```ts
+ * // Single definition
+ * const hooks = defineHooks('claude-code', {
+ *   events: ['PreToolUse', 'PostToolUse'],
+ *   content: '#!/bin/bash\necho "hook fired"',
+ * });
+ *
+ * // Multiple definitions
+ * const hooks = defineHooks('claude-code', [
+ *   { events: ['PreToolUse'], content: '#!/bin/bash\necho "pre"' },
+ *   { events: ['PostToolUse'], content: '#!/bin/bash\necho "post"' },
+ * ]);
+ * ```
+ */
+export function defineHooks(agent, definitions) {
+    // Validate agent
+    if (!AGENT_TYPES.includes(agent)) {
+        throw new Error(`defineHooks: unknown agent type "${agent}". Valid types: ${AGENT_TYPES.join(', ')}`);
+    }
+    // Normalize to array
+    const defs = Array.isArray(definitions) ? definitions : [definitions];
+    if (defs.length === 0) {
+        throw new Error('defineHooks: definitions array cannot be empty.');
+    }
+    // OpenClaw: warn if multiple definitions provided (only first is used)
+    const warnings = [];
+    if (agent === 'openclaw' && defs.length > 1) {
+        warnings.push(`defineHooks: OpenClaw only supports a single hook definition. ` +
+            `Got ${defs.length} definitions — only the first will be used.`);
+        // Log warning (user can also see it in installHooks result)
+        console.warn(warnings[0]);
+    }
+    const validEvents = VALID_EVENTS[agent];
+    for (let i = 0; i < defs.length; i++) {
+        const def = defs[i];
+        // Validate events
+        if (!Array.isArray(def.events) || def.events.length === 0) {
+            throw new Error(`defineHooks: definitions[${i}].events must be a non-empty array.`);
+        }
+        for (const event of def.events) {
+            if (!validEvents.has(event)) {
+                throw new Error(`defineHooks: unknown event "${event}" for agent "${agent}". ` +
+                    `Valid events: ${[...validEvents].join(', ')}`);
+            }
+        }
+        // Validate content
+        if (typeof def.content !== 'string' || !def.content.trim()) {
+            throw new Error(`defineHooks: definitions[${i}].content must be a non-empty string.`);
+        }
+    }
+    // For OpenClaw, only keep first definition
+    const effectiveDefs = agent === 'openclaw' && defs.length > 1 ? [defs[0]] : defs;
+    return {
+        __brand: 'HookSet',
+        agent,
+        definitions: Object.freeze([...effectiveDefs]),
+    };
+}
+/**
+ * Get the set of valid event names for a given agent.
+ * Useful for tooling and documentation generation.
+ */
+export function getValidEvents(agent) {
+    if (!AGENT_TYPES.includes(agent)) {
+        throw new Error(`getValidEvents: unknown agent type "${agent}".`);
+    }
+    return VALID_EVENTS[agent];
+}
+//# sourceMappingURL=define-hooks.js.map

package/build/define-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-hooks.js","sourceRoot":"","sources":["../src/define-hooks.ts"],"names":[],"mappings":"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"}

package/build/hooks.d.ts

@@ -1,14 +1,17 @@
-import type { AgentType, HookInstallResult } from './types.js';
+import type { AgentType, HookInstallResult, HookSet } from './types.js';
 /**
  * Install hooks for the given agent type.
  *
- * Reads all registered intents, raw hooks, and extend hooks from the hook
- * registry. Translates them into native hook files using the agent-specific
- * translator. Runs degradation checks and conflict detection.
+ * Accepts one or more HookSet (from defineHooks()). Filters to only those
+ * matching the target agent. Writes content to the agent's hook directory.
+ *
+ * For Claude Code / Codex: writes shell scripts, merges into settings.json.
+ * For OpenCode: writes TypeScript plugin files directly to plugins dir.
+ * For OpenClaw: writes HOOK.md + handler.ts, attempts CLI activation.
  *
  * @internal — called by the Kit object returned from createKit().
  */
-export declare function installHooks(name: string, agent: AgentType): Promise<HookInstallResult>;
+export declare function installHooks(name: string, agent: AgentType, hookSets: HookSet | HookSet[]): Promise<HookInstallResult>;
 /**
  * Uninstall hooks for the given agent type.
  *

package/build/hooks.js

@@ -4,40 +4,23 @@ import os from 'node:os';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { AGENT_REGISTRY } from './types.js';
-import { getIntents, getRawHooks, getExtendHooks } from './hook-registry.js';
-import { checkAllDegradation } from './hook-capabilities.js';
-import { ClaudeCodeTranslator } from './hook-translators/claude-code.js';
-import { OpenCodeTranslator } from './hook-translators/opencode.js';
-import { OpenClawTranslator } from './hook-translators/openclaw.js';
 const execFileAsync = promisify(execFile);
 // ---------------------------------------------------------------------------
-// Translator factory
-// ---------------------------------------------------------------------------
-function getTranslator(agent) {
-    switch (agent) {
-        case 'claude-code':
-            return new ClaudeCodeTranslator('claude-code');
-        case 'codex':
-            return new ClaudeCodeTranslator('codex');
-        case 'opencode':
-            return new OpenCodeTranslator();
-        case 'openclaw':
-            return new OpenClawTranslator();
-    }
-}
-// ---------------------------------------------------------------------------
-// installHooks — main entry point
+// installHooks — write hook files to disk
 // ---------------------------------------------------------------------------
 /**
  * Install hooks for the given agent type.
  *
- * Reads all registered intents, raw hooks, and extend hooks from the hook
- * registry. Translates them into native hook files using the agent-specific
- * translator. Runs degradation checks and conflict detection.
+ * Accepts one or more HookSet (from defineHooks()). Filters to only those
+ * matching the target agent. Writes content to the agent's hook directory.
+ *
+ * For Claude Code / Codex: writes shell scripts, merges into settings.json.
+ * For OpenCode: writes TypeScript plugin files directly to plugins dir.
+ * For OpenClaw: writes HOOK.md + handler.ts, attempts CLI activation.
  *
  * @internal — called by the Kit object returned from createKit().
  */
-export async function installHooks(name, agent) {
+export async function installHooks(name, agent, hookSets) {
     const home = os.homedir();
     const entry = AGENT_REGISTRY[agent];
     const hookDir = entry.getHookDir(home, name);
@@ -48,56 +31,41 @@ export async function installHooks(name, agent) {
         settingsUpdated: false,
         notes: [],
         warnings: [],
-        skipped: [],
     };
-    const intents = getIntents();
-    const rawHooks = getRawHooks();
-    const extendHooks = getExtendHooks();
-    // Check if there's anything to install
-    if (intents.length === 0 && rawHooks.size === 0 && extendHooks.size === 0) {
-        result.error =
-            'No hooks registered. Use hooks.inject(), hooks.beforeToolCall(), etc. to declare hook behavior.';
+    // Normalize and filter to matching agent
+    const sets = (Array.isArray(hookSets) ? hookSets : [hookSets]).filter((s) => s.agent === agent);
+    if (sets.length === 0) {
+        result.error = `No hook definitions found for agent "${agent}".`;
         return result;
     }
+    // Collect all definitions from matching sets
+    const allDefs = [];
+    for (const set of sets) {
+        allDefs.push(...set.definitions);
+    }
     try {
-        // Step 1: Run degradation checks
-        const intentTypes = [...new Set(intents.map((i) => i.type))];
-        const degradations = checkAllDegradation(agent, intentTypes);
-        for (const d of degradations) {
-            if (d.level === 'unsupported') {
-                result.warnings.push(d.message);
-            }
-            else if (d.level === 'partial') {
-                result.warnings.push(d.message);
-            }
-        }
-        // Step 2: Filter raw/extend hooks for this agent
-        const agentRawHooks = new Map();
-        for (const [key, reg] of rawHooks) {
-            if (key.startsWith(`${agent}::`)) {
-                agentRawHooks.set(key, reg);
-            }
+        // Generate files based on agent type
+        const files = {};
+        switch (agent) {
+            case 'claude-code':
+            case 'codex':
+                generateClaudeCodeFiles(files, allDefs, name);
+                break;
+            case 'opencode':
+                generateOpenCodeFiles(files, allDefs, name);
+                break;
+            case 'openclaw':
+                generateOpenClawFiles(files, allDefs, name);
+                break;
         }
-        const agentExtendHooks = new Map();
-        for (const [key, regs] of extendHooks) {
-            if (key.startsWith(`${agent}::`)) {
-                agentExtendHooks.set(key, regs);
-            }
-        }
-        // Step 3: Translate intents → native files
-        const translator = getTranslator(agent);
-        const translation = translator.translate(intents, agentRawHooks, agentExtendHooks, name);
-        // Merge translation warnings and skipped
-        result.warnings.push(...translation.warnings);
-        result.skipped.push(...translation.skipped);
-        // Step 4: Write hook files
-        if (Object.keys(translation.files).length === 0) {
-            result.notes.push('No hook files generated for this agent.');
+        if (Object.keys(files).length === 0) {
+            result.notes.push('No hook files generated.');
             result.success = true;
             return result;
         }
+        // Write files
         await fs.mkdir(hookDir, { recursive: true });
-        for (const [fileName, content] of Object.entries(translation.files)) {
+        for (const [fileName, content] of Object.entries(files)) {
             const filePath = path.join(hookDir, fileName);
             await fs.writeFile(filePath, content, 'utf-8');
             if (fileName.endsWith('.sh')) {
@@ -105,16 +73,16 @@ export async function installHooks(name, agent) {
             }
             result.filesWritten.push(filePath);
         }
-        // Step 5: Merge settings.json for agents that need it (Claude Code / Codex)
+        // Merge settings.json for Claude Code / Codex
         if (entry.getSettingsPath) {
             const settingsPath = entry.getSettingsPath(home);
-            const shellFiles = Object.keys(translation.files).filter((f) => f.endsWith('.sh'));
+            const shellFiles = Object.keys(files).filter((f) => f.endsWith('.sh'));
             if (shellFiles.length > 0) {
-                await mergeHookSettings(settingsPath, hookDir, shellFiles, name);
+                await mergeHookSettings(settingsPath, hookDir, shellFiles, allDefs, name);
                 result.settingsUpdated = true;
             }
         }
-        // Step 6: Agent-specific post-install
+        // OpenClaw post-install: attempt CLI activation
         if (agent === 'openclaw') {
             try {
                 await execFileAsync('openclaw', ['hooks', 'enable', name]);
@@ -148,7 +116,7 @@ export async function uninstallHooks(name, agent) {
     const hookDir = entry.getHookDir(home, name);
     const removed = [];
     try {
-        // Remove hook directory
+        // Remove hook directory contents
         try {
             const files = await fs.readdir(hookDir);
             for (const file of files) {
@@ -202,13 +170,69 @@ export async function hasHooksInstalled(name, agent) {
     }
 }
 // ---------------------------------------------------------------------------
+// File generators — per agent
+// ---------------------------------------------------------------------------
+/**
+ * Claude Code / Codex: each definition × each event → one shell script.
+ * Filename: `{toolName}-{event}.sh`
+ */
+function generateClaudeCodeFiles(files, defs, toolName) {
+    for (const def of defs) {
+        for (const event of def.events) {
+            const fileName = `${toolName}-${event}.sh`;
+            // If multiple definitions target the same event, later ones win
+            files[fileName] = def.content;
+        }
+    }
+}
+/**
+ * OpenCode: each definition × each event → one TypeScript plugin file.
+ * Filename: `{toolName}-{event}-plugin.ts`
+ *
+ * OpenCode plugins dir is flat (all in ~/.config/opencode/plugins/).
+ * Content is written as-is — users provide the full plugin file content.
+ */
+function generateOpenCodeFiles(files, defs, toolName) {
+    for (const def of defs) {
+        for (const event of def.events) {
+            // Sanitize event name for filename (dots → dashes)
+            const sanitized = event.replace(/\./g, '-');
+            const fileName = `${toolName}-${sanitized}-plugin.ts`;
+            files[fileName] = def.content;
+        }
+    }
+}
+/**
+ * OpenClaw: generates HOOK.md (YAML frontmatter) + handler.ts.
+ * Only uses the first definition (OpenClaw = one hook = one HOOK.md + handler.ts).
+ */
+function generateOpenClawFiles(files, defs, toolName) {
+    if (defs.length === 0)
+        return;
+    const def = defs[0]; // Only first definition used
+    // Generate HOOK.md
+    const description = def.description || `Hook installed by ${toolName}`;
+    const eventsYaml = def.events.map((e) => `  - ${e}`).join('\n');
+    files['HOOK.md'] = [
+        '---',
+        `name: ${toolName}`,
+        `description: ${description}`,
+        'events:',
+        eventsYaml,
+        '---',
+        '',
+    ].join('\n');
+    // handler.ts — user-provided content
+    files['handler.ts'] = def.content;
+}
+// ---------------------------------------------------------------------------
 // Settings merge (Claude Code / Codex)
 // ---------------------------------------------------------------------------
 /**
  * Merge hook entries into settings.json for Claude Code / Codex.
- * Maps each shell script to its corresponding native hook event based on filename conventions.
+ * Maps each shell script filename to its hook event via the definitions.
  */
-async function mergeHookSettings(settingsPath, hookDir, shellFiles, toolName) {
+async function mergeHookSettings(settingsPath, hookDir, shellFiles, defs, toolName) {
     let settings = {};
     try {
         const raw = await fs.readFile(settingsPath, 'utf-8');
@@ -221,39 +245,19 @@ async function mergeHookSettings(settingsPath, hookDir, shellFiles, toolName) {
         settings.hooks = {};
     }
     const hooks = settings.hooks;
-    // Map filename patterns to native hook events
-    const fileToEvent = {
-        inject: 'UserPromptSubmit',
-        'session-start': 'SessionStart',
-        'session-end': 'SessionEnd',
-        compaction: 'PreCompact',
-        'before-tool': 'PreToolUse',
-        'after-tool': 'PostToolUse',
-        'on-session-start': 'SessionStart',
-        'on-session-end': 'SessionEnd',
-        permission: 'PermissionRequest',
-    };
-    for (const fileName of shellFiles) {
-        const activatorPath = path.join(hookDir, fileName);
-        // Determine the event from filename
-        let event;
-        // Check raw hooks first (pattern: toolName-raw-hookname.sh)
-        const rawMatch = fileName.match(/^.+-raw-(.+)\.sh$/);
-        if (rawMatch) {
-            // Raw hooks use the hook name directly (case-insensitive lookup)
-            event = rawMatch[1].charAt(0).toUpperCase() + rawMatch[1].slice(1);
-        }
-        else {
-            // Intent-generated hooks use filename conventions
-            for (const [pattern, hookEvent] of Object.entries(fileToEvent)) {
-                if (fileName.includes(pattern)) {
-                    event = hookEvent;
-                    break;
-                }
-            }
+    // Build filename → event map from definitions
+    const fileToEvent = new Map();
+    for (const def of defs) {
+        for (const event of def.events) {
+            const fileName = `${toolName}-${event}.sh`;
+            fileToEvent.set(fileName, event);
         }
+    }
+    for (const fileName of shellFiles) {
+        const event = fileToEvent.get(fileName);
         if (!event)
             continue;
+        const activatorPath = path.join(hookDir, fileName);
         const hookEntry = {
             matcher: '',
             hooks: [{ type: 'command', command: activatorPath }],

package/build/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGpE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,SAAS,aAAa,CAAC,KAAgB;IACnC,QAAQ,KAAK,EAAE,CAAC;QACZ,KAAK,aAAa;YACd,OAAO,IAAI,oBAAoB,CAAC,aAAa,CAAC,CAAC;QACnD,KAAK,OAAO;YACR,OAAO,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC7C,KAAK,UAAU;YACX,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACpC,KAAK,UAAU;YACX,OAAO,IAAI,kBAAkB,EAAE,CAAC;IACxC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,KAAgB;IAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAsB;QAC9B,OAAO,EAAE,KAAK;QACd,OAAO;QACP,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,KAAK;QACtB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;KACd,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,uCAAuC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,KAAK;YACR,iGAAiG,CAAC;QACtG,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACD,iCAAiC;QACjC,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAiB,CAAC;QAC7E,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;gBAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;QAED,iDAAiD;QACjD,MAAM,aAAa,GAAG,IAAI,GAAG,EAA+B,CAAC;QAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC/B,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;QACL,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuE,CAAC;QACxG,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC;gBAC/B,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACpC,CAAC;QACL,CAAC;QAED,2CAA2C;QAC3C,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;QAEzF,yCAAyC;QACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAE5C,2BAA2B;QAC3B,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YAC7D,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7C,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,4EAA4E;QAC5E,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAEnF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,iBAAiB,CAAC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;gBACjE,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;YAClC,CAAC;QACL,CAAC;QAED,sCAAsC;QACtC,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC3D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,8CAA8C,IAAI,KAAK,CAAC,CAAC;YAC/E,CAAC;YAAC,MAAM,CAAC;gBACL,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,IAAI,0BAA0B,CAAC,CAAC;YACrF,CAAC;QACL,CAAC;QAED,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,IAAY,EACZ,KAAgB;IAEhB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACD,wBAAwB;QACxB,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;YACD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACL,wCAAwC;QAC5C,CAAC;QAED,8CAA8C;QAC9C,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,iBAAiB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,0BAA0B;QAC1B,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACL,cAAc;YAClB,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChG,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAgB;IAClE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7C,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAC5B,YAAoB,EACpB,OAAe,EACf,UAAoB,EACpB,QAAgB;IAEhB,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,cAAc;IAClB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxD,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAkC,CAAC;IAE1D,8CAA8C;IAC9C,MAAM,WAAW,GAA2B;QACxC,MAAM,EAAE,kBAAkB;QAC1B,eAAe,EAAE,cAAc;QAC/B,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,YAAY;QACxB,aAAa,EAAE,YAAY;QAC3B,YAAY,EAAE,aAAa;QAC3B,kBAAkB,EAAE,cAAc;QAClC,gBAAgB,EAAE,YAAY;QAC9B,UAAU,EAAE,mBAAmB;KAClC,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEnD,oCAAoC;QACpC,IAAI,KAAyB,CAAC;QAE9B,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACX,iEAAiE;YACjE,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACJ,kDAAkD;YAClD,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7D,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC7B,KAAK,GAAG,SAAS,CAAC;oBAClB,MAAM;gBACV,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,SAAS,GAAG;YACd,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;SACvD,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QAED,wCAAwC;QACxC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACrD,MAAM,CAAC,GAAG,KAAgC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;gBAChC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC9C,MAAM,IAAI,GAAG,CAA4B,CAAC;gBAC1C,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,YAAoB,EAAE,QAAgB;IACnE,IAAI,QAAiC,CAAC;IACtC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,4BAA4B;IACxC,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO;IAElE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAkC,CAAC;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAEtC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACrD,MAAM,CAAC,GAAG,KAAgC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;gBAC5C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC9C,MAAM,IAAI,GAAG,CAA4B,CAAC;gBAC1C,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,WAAW,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YACxB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;AACL,CAAC"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,8EAA8E;AAC9E,0CAA0C;AAC1C,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,IAAY,EACZ,KAAgB,EAChB,QAA6B;IAE7B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAsB;QAC9B,OAAO,EAAE,KAAK;QACd,OAAO;QACP,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,KAAK;QACtB,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;KACf,CAAC;IAEF,yCAAyC;IACzC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAEhG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,KAAK,GAAG,wCAAwC,KAAK,IAAI,CAAC;QACjE,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,6CAA6C;IAC7C,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC;QACD,qCAAqC;QACrC,MAAM,KAAK,GAA2B,EAAE,CAAC;QAEzC,QAAQ,KAAK,EAAE,CAAC;YACZ,KAAK,aAAa,CAAC;YACnB,KAAK,OAAO;gBACR,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC9C,MAAM;YACV,KAAK,UAAU;gBACX,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC5C,MAAM;YACV,KAAK,UAAU;gBACX,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC5C,MAAM;QACd,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YAC9C,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,cAAc;QACd,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7C,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,8CAA8C;QAC9C,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAEvE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,iBAAiB,CAAC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1E,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;YAClC,CAAC;QACL,CAAC;QAED,gDAAgD;QAChD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC3D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,8CAA8C,IAAI,KAAK,CAAC,CAAC;YAC/E,CAAC;YAAC,MAAM,CAAC;gBACL,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,IAAI,0BAA0B,CAAC,CAAC;YACrF,CAAC;QACL,CAAC;QAED,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,CAAC,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,IAAY,EACZ,KAAgB;IAEhB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC;QACD,iCAAiC;QACjC,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;YACD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACL,wCAAwC;QAC5C,CAAC;QAED,8CAA8C;QAC9C,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,iBAAiB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,0BAA0B;QAC1B,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACvB,IAAI,CAAC;gBACD,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACL,cAAc;YAClB,CAAC;QACL,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IAChG,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAgB;IAClE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE7C,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,uBAAuB,CAAC,KAA6B,EAAE,IAAsB,EAAE,QAAgB;IACpG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,KAAK,KAAK,CAAC;YAC3C,gEAAgE;YAChE,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QAClC,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,KAA6B,EAAE,IAAsB,EAAE,QAAgB;IAClG,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7B,mDAAmD;YACnD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,SAAS,YAAY,CAAC;YACtD,KAAK,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QAClC,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,KAA6B,EAAE,IAAsB,EAAE,QAAgB;IAClG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B;IAElD,mBAAmB;IACnB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,qBAAqB,QAAQ,EAAE,CAAC;IACvE,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhE,KAAK,CAAC,SAAS,CAAC,GAAG;QACf,KAAK;QACL,SAAS,QAAQ,EAAE;QACnB,gBAAgB,WAAW,EAAE;QAC7B,SAAS;QACT,UAAU;QACV,KAAK;QACL,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,qCAAqC;IACrC,KAAK,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAC5B,YAAoB,EACpB,OAAe,EACf,UAAoB,EACpB,IAAsB,EACtB,QAAgB;IAEhB,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,cAAc;IAClB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxD,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAkC,CAAC;IAE1D,8CAA8C;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,KAAK,KAAK,CAAC;YAC3C,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAe,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,SAAS;QAErB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEnD,MAAM,SAAS,GAAG;YACd,OAAO,EAAE,EAAE;YACX,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;SACvD,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACtB,CAAC;QAED,wCAAwC;QACxC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACrD,MAAM,CAAC,GAAG,KAAgC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;gBAChC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC9C,MAAM,IAAI,GAAG,CAA4B,CAAC;gBAC1C,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,YAAoB,EAAE,QAAgB;IACnE,IAAI,QAAiC,CAAC;IACtC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,CAAC,4BAA4B;IACxC,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO;IAElE,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAkC,CAAC;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAEtC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACrD,MAAM,CAAC,GAAG,KAAgC,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;gBAC5C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC9C,MAAM,IAAI,GAAG,CAA4B,CAAC;gBAC1C,OAAO,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,WAAW,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YACrC,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;YACxB,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;AACL,CAAC"}

package/build/index.d.ts

@@ -1,9 +1,6 @@
 export { createKit } from './create-kit.js';
-export type { AgentType, StorageScope, ScopeOptions, KitOptions, Kit, HookInstallResult, SkippedIntent, } from './types.js';
+export { defineHooks, getValidEvents } from './define-hooks.js';
+export type { AgentType, StorageScope, ScopeOptions, KitOptions, Kit, HookInstallResult, HookDefinition, HookSet, ClaudeCodeEvent, OpenCodeEvent, OpenClawPluginEvent, OpenClawInternalEvent, OpenClawEvent, AgentEventMap, } from './types.js';
 export { AGENT_TYPES, CLIENT_NAME_MAP } from './types.js';
-export type { InjectIntent, BeforeToolCallIntent, AfterToolCallIntent, OnSessionIntent, OnPermissionIntent, HookIntent, IntentType, ToolCallContext, ToolCallInterceptResult, ToolCallObserveContext, SessionContext, PermissionDecision, PermissionContext, RawHookRegistration, ExtendHookRegistration, } from './hook-types.js';
-export type { SupportLevel, CapabilityEntry, DegradationWarning } from './hook-capabilities.js';
-export { CAPABILITY_MATRIX, checkDegradation, checkAllDegradation, isIntentFullyUnsupported, } from './hook-capabilities.js';
 export { detectProjectRoot } from './platform.js';
 export { detectAgent, detectAgentFromClient } from './detect.js';
-export { hooks } from './hook-registry.js';

package/build/index.js

@@ -1,11 +1,10 @@
 // Core factory
 export { createKit } from './create-kit.js';
+// Hook definition
+export { defineHooks, getValidEvents } from './define-hooks.js';
 export { AGENT_TYPES, CLIENT_NAME_MAP } from './types.js';
-export { CAPABILITY_MATRIX, checkDegradation, checkAllDegradation, isIntentFullyUnsupported, } from './hook-capabilities.js';
 // Platform (only detectProjectRoot is standalone; getDataDir is on Kit)
 export { detectProjectRoot } from './platform.js';
 // Detection
 export { detectAgent, detectAgentFromClient } from './detect.js';
-// Hooks — declaration API (global, not bound to kit instance)
-export { hooks } from './hook-registry.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuB1D,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,wEAAwE;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEjE,8DAA8D;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,kBAAkB;AAClB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmBhE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1D,wEAAwE;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/build/types.d.ts

@@ -45,8 +45,8 @@ export interface Kit {
     injectPrompt(agent: AgentType, prompt: string, options?: ScopeOptions): Promise<void>;
     /** Check if prompt has been injected. */
     hasPromptInjected(agent: AgentType, options?: ScopeOptions): Promise<boolean>;
-    /** Install hooks for the given agent. */
-    installHooks(agent: AgentType): Promise<HookInstallResult>;
+    /** Install hooks for the given agent. Accepts one or more HookSet from defineHooks(). */
+    installHooks(agent: AgentType, hooks: HookSet | HookSet[]): Promise<HookInstallResult>;
     /** Uninstall hooks for the given agent. */
     uninstallHooks(agent: AgentType): Promise<{
         success: boolean;
@@ -58,16 +58,46 @@ export interface Kit {
     /** Get platform-appropriate data directory path. */
     getDataDir(options?: ScopeOptions): string;
 }
+/** Claude Code / Codex native hook event names. */
+export type ClaudeCodeEvent = 'SessionStart' | 'InstructionsLoaded' | 'UserPromptSubmit' | 'PreToolUse' | 'PermissionRequest' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'SubagentStart' | 'SubagentStop' | 'Stop' | 'TeammateIdle' | 'TaskCompleted' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'PreCompact' | 'PostCompact' | 'Elicitation' | 'ElicitationResult' | 'SessionEnd';
+/** OpenCode native hook event names. */
+export type OpenCodeEvent = 'event' | 'config' | 'tool' | 'auth' | 'chat.message' | 'chat.params' | 'chat.headers' | 'permission.ask' | 'command.execute.before' | 'tool.execute.before' | 'shell.env' | 'tool.execute.after' | 'experimental.chat.messages.transform' | 'experimental.chat.system.transform' | 'experimental.session.compacting' | 'experimental.text.complete' | 'tool.definition';
+/** OpenClaw plugin hook event names. */
+export type OpenClawPluginEvent = 'before_model_resolve' | 'before_prompt_build' | 'before_agent_start' | 'llm_input' | 'llm_output' | 'agent_end' | 'before_compaction' | 'after_compaction' | 'before_reset' | 'message_received' | 'message_sending' | 'message_sent' | 'before_tool_call' | 'after_tool_call' | 'tool_result_persist' | 'before_message_write' | 'session_start' | 'session_end' | 'subagent_spawning' | 'subagent_delivery_target' | 'subagent_spawned' | 'subagent_ended' | 'gateway_start' | 'gateway_stop';
+/** OpenClaw internal hook event names (type:action). */
+export type OpenClawInternalEvent = 'command:new' | 'command:reset' | 'command:stop' | 'session:compact:before' | 'session:compact:after' | 'agent:bootstrap' | 'gateway:startup' | 'message:received' | 'message:sent' | 'message:transcribed' | 'message:preprocessed';
+/** All OpenClaw hook event names (plugin + internal). */
+export type OpenClawEvent = OpenClawPluginEvent | OpenClawInternalEvent;
+/** Map from agent type to its event name union. */
+export type AgentEventMap = {
+    'claude-code': ClaudeCodeEvent;
+    codex: ClaudeCodeEvent;
+    opencode: OpenCodeEvent;
+    openclaw: OpenClawEvent;
+};
 /**
- * Describes an intent that was skipped during hook installation.
+ * A single hook definition for a specific agent.
+ *
+ * - `events`: one or more native event names for this agent.
+ * - `content`: the hook content (shell script, TypeScript code, handler.ts body, etc.).
+ *   Users are fully responsible for the content — agent-kit only writes it to the correct path.
+ * - `description`: (OpenClaw only) human-readable description for HOOK.md. Defaults to auto-generated.
  */
-export interface SkippedIntent {
-    /** The intent type that was skipped (e.g. 'onPermission'). */
-    intent: string;
-    /** The agent for which it was skipped. */
-    agent: string;
-    /** Human-readable reason for skipping. */
-    reason: string;
+export interface HookDefinition<A extends AgentType = AgentType> {
+    events: A extends keyof AgentEventMap ? AgentEventMap[A][] : string[];
+    content: string;
+    /** OpenClaw only — description for HOOK.md. Ignored by other agents. */
+    description?: string;
+}
+/**
+ * A validated set of hook definitions for a specific agent, returned by defineHooks().
+ * This is an opaque token — users should not construct it directly.
+ */
+export interface HookSet<A extends AgentType = AgentType> {
+    /** @internal brand field */
+    readonly __brand: 'HookSet';
+    readonly agent: A;
+    readonly definitions: readonly HookDefinition<A>[];
 }
 /**
  * Result of hook installation.
@@ -78,10 +108,7 @@ export interface HookInstallResult {
     filesWritten: string[];
     settingsUpdated: boolean;
     notes: string[];
-    /** Degradation and conflict warnings (e.g. raw overrides, partial support). */
     warnings: string[];
-    /** Intents that were completely skipped for this agent. */
-    skipped: SkippedIntent[];
     error?: string;
 }
 /**

package/build/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AA6GrF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA8B;IACtD,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,aAAa;IAC5B,qBAAqB,EAAE,UAAU;IACjC,kBAAkB,EAAE,OAAO;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0C;IACjE,QAAQ,EAAE;QACN,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,6BAA6B;QAChE,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,IAAI,2BAA2B;QACnE,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;YAC3B,GAAG,GAAG,gBAAgB;YACtB,GAAG,GAAG,iBAAiB;YACvB,GAAG,IAAI,iCAAiC;SAC3C;KACJ;IACD,aAAa,EAAE;QACX,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,oBAAoB;QACvD,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,kBAAkB,QAAQ,EAAE;QACnE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,wBAAwB;QAC1D,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,YAAY,EAAE,GAAG,IAAI,oBAAoB,CAAC;KACnF;IACD,QAAQ,EAAE;QACN,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,gCAAgC;QACnE,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,oBAAoB,QAAQ,EAAE;QACrE,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,0BAA0B,CAAC;KACtE;IACD,KAAK,EAAE;QACH,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,mBAAmB;QACtD,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,iBAAiB,QAAQ,EAAE;QAClE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,uBAAuB;QACzD,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,qBAAqB,EAAE,GAAG,IAAI,qBAAqB,CAAC;KAC7F;CACJ,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AA4NrF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA8B;IACtD,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,aAAa;IAC5B,qBAAqB,EAAE,UAAU;IACjC,kBAAkB,EAAE,OAAO;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0C;IACjE,QAAQ,EAAE;QACN,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,6BAA6B;QAChE,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,IAAI,2BAA2B;QACnE,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;YAC3B,GAAG,GAAG,gBAAgB;YACtB,GAAG,GAAG,iBAAiB;YACvB,GAAG,IAAI,iCAAiC;SAC3C;KACJ;IACD,aAAa,EAAE;QACX,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,oBAAoB;QACvD,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,kBAAkB,QAAQ,EAAE;QACnE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,wBAAwB;QAC1D,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,YAAY,EAAE,GAAG,IAAI,oBAAoB,CAAC;KACnF;IACD,QAAQ,EAAE;QACN,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,gCAAgC;QACnE,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,oBAAoB,QAAQ,EAAE;QACrE,cAAc,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,0BAA0B,CAAC;KACtE;IACD,KAAK,EAAE;QACH,cAAc,EAAE,WAAW;QAC3B,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,mBAAmB;QACtD,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY;QAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,iBAAiB,QAAQ,EAAE;QAClE,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,uBAAuB;QACzD,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,qBAAqB,EAAE,GAAG,IAAI,qBAAqB,CAAC;KAC7F;CACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@s_s/agent-kit",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "面向 MCP Server 与 Skill 开发的 Agent 适配工具包",
   "type": "module",
   "main": "./build/index.js",