@s_s/agent-kit 1.0.0

package/build/hook-translators/claude-code.js

@@ -0,0 +1,351 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function matcherToString(match) {
+    if (match === undefined || match === '*')
+        return '';
+    if (match instanceof RegExp)
+        return match.source;
+    return match;
+}
+/**
+ * Wrap a handler body with optional extend code appended.
+ */
+function applyExtends(body, agent, hookName, extendHooks) {
+    const key = `${agent}::${hookName}`;
+    const extends_ = extendHooks.get(key);
+    if (!extends_ || extends_.length === 0)
+        return body;
+    const extendParts = extends_.map((e, i) => `# --- extend #${i + 1} ---\n${e.handler}`);
+    return body + '\n\n' + extendParts.join('\n\n');
+}
+// ---------------------------------------------------------------------------
+// Claude Code / Codex Translator
+// ---------------------------------------------------------------------------
+/**
+ * Translates intent-based hooks into Claude Code / Codex native format.
+ *
+ * Claude Code uses:
+ * - Shell scripts executed as external processes
+ * - JSON input via stdin, JSON output via stdout
+ * - Exit codes for control (0 = allow, 2 = block)
+ * - settings.json for hook registration (event → matcher → handler)
+ */
+export class ClaudeCodeTranslator {
+    agent;
+    constructor(agent = 'claude-code') {
+        this.agent = agent;
+    }
+    translate(intents, rawHooks, extendHooks, toolName) {
+        const files = {};
+        const warnings = [];
+        const skipped = [];
+        // Track which native hooks are generated by intents (for conflict detection)
+        const intentGeneratedHooks = new Set();
+        // --- inject intents ---
+        const injectIntents = intents.filter((i) => i.type === 'inject');
+        if (injectIntents.length > 0) {
+            const hookName = 'UserPromptSubmit';
+            if (rawHooks.has(`${this.agent}::${hookName}`)) {
+                warnings.push(`[${this.agent}] raw hook for ${hookName} overrides inject intent. ` +
+                    `The inject content will not be applied via ${hookName}.`);
+            }
+            else {
+                const merged = this.mergeInjectIntents(injectIntents);
+                const body = this.buildInjectScript(toolName, merged);
+                const script = applyExtends(body, this.agent, hookName, extendHooks);
+                files[`${toolName}-inject.sh`] = script;
+                intentGeneratedHooks.add(hookName);
+            }
+            // sessionStart → SessionStart (separate hook)
+            const sessionStarts = injectIntents.filter((i) => i.sessionStart);
+            if (sessionStarts.length > 0 && !rawHooks.has(`${this.agent}::SessionStart`)) {
+                const combined = sessionStarts.map((i) => i.sessionStart).join('\n\n');
+                const body = this.buildSessionStartInjectScript(toolName, combined);
+                const script = applyExtends(body, this.agent, 'SessionStart', extendHooks);
+                files[`${toolName}-session-start.sh`] = script;
+                intentGeneratedHooks.add('SessionStart');
+            }
+            // compaction → PreCompact
+            const compactions = injectIntents.filter((i) => i.compaction);
+            if (compactions.length > 0 && !rawHooks.has(`${this.agent}::PreCompact`)) {
+                const combined = compactions.map((i) => i.compaction).join('\n\n');
+                const body = this.buildCompactionScript(toolName, combined);
+                const script = applyExtends(body, this.agent, 'PreCompact', extendHooks);
+                files[`${toolName}-compaction.sh`] = script;
+                intentGeneratedHooks.add('PreCompact');
+            }
+            // sessionEnd → SessionEnd
+            const sessionEnds = injectIntents.filter((i) => i.sessionEnd);
+            if (sessionEnds.length > 0 && !rawHooks.has(`${this.agent}::SessionEnd`)) {
+                const combined = sessionEnds.map((i) => i.sessionEnd).join('\n\n');
+                const body = this.buildSessionEndInjectScript(toolName, combined);
+                const script = applyExtends(body, this.agent, 'SessionEnd', extendHooks);
+                files[`${toolName}-session-end.sh`] = script;
+                intentGeneratedHooks.add('SessionEnd');
+            }
+        }
+        // --- beforeToolCall intents ---
+        const beforeIntents = intents.filter((i) => i.type === 'beforeToolCall');
+        if (beforeIntents.length > 0) {
+            const hookName = 'PreToolUse';
+            if (rawHooks.has(`${this.agent}::${hookName}`)) {
+                warnings.push(`[${this.agent}] raw hook for ${hookName} overrides beforeToolCall intent.`);
+            }
+            else {
+                const body = this.buildBeforeToolCallScript(toolName, beforeIntents);
+                const script = applyExtends(body, this.agent, hookName, extendHooks);
+                files[`${toolName}-before-tool.sh`] = script;
+                intentGeneratedHooks.add(hookName);
+            }
+        }
+        // --- afterToolCall intents ---
+        const afterIntents = intents.filter((i) => i.type === 'afterToolCall');
+        if (afterIntents.length > 0) {
+            const hookName = 'PostToolUse';
+            if (rawHooks.has(`${this.agent}::${hookName}`)) {
+                warnings.push(`[${this.agent}] raw hook for ${hookName} overrides afterToolCall intent.`);
+            }
+            else {
+                const body = this.buildAfterToolCallScript(toolName, afterIntents);
+                const script = applyExtends(body, this.agent, hookName, extendHooks);
+                files[`${toolName}-after-tool.sh`] = script;
+                intentGeneratedHooks.add(hookName);
+            }
+        }
+        // --- onSession intents ---
+        const sessionIntents = intents.filter((i) => i.type === 'onSession');
+        if (sessionIntents.length > 0) {
+            const hasStart = sessionIntents.some((i) => i.start);
+            const hasEnd = sessionIntents.some((i) => i.end);
+            if (hasStart && !intentGeneratedHooks.has('SessionStart')) {
+                if (rawHooks.has(`${this.agent}::SessionStart`)) {
+                    warnings.push(`[${this.agent}] raw hook for SessionStart overrides onSession.start intent.`);
+                }
+                else {
+                    const body = this.buildOnSessionScript(toolName, 'start');
+                    const script = applyExtends(body, this.agent, 'SessionStart', extendHooks);
+                    files[`${toolName}-on-session-start.sh`] = script;
+                    intentGeneratedHooks.add('SessionStart');
+                }
+            }
+            if (hasEnd && !intentGeneratedHooks.has('SessionEnd')) {
+                if (rawHooks.has(`${this.agent}::SessionEnd`)) {
+                    warnings.push(`[${this.agent}] raw hook for SessionEnd overrides onSession.end intent.`);
+                }
+                else {
+                    const body = this.buildOnSessionScript(toolName, 'end');
+                    const script = applyExtends(body, this.agent, 'SessionEnd', extendHooks);
+                    files[`${toolName}-on-session-end.sh`] = script;
+                    intentGeneratedHooks.add('SessionEnd');
+                }
+            }
+        }
+        // --- onPermission intents ---
+        const permIntents = intents.filter((i) => i.type === 'onPermission');
+        if (permIntents.length > 0) {
+            const hookName = 'PermissionRequest';
+            if (rawHooks.has(`${this.agent}::${hookName}`)) {
+                warnings.push(`[${this.agent}] raw hook for ${hookName} overrides onPermission intent.`);
+            }
+            else {
+                const body = this.buildPermissionScript(toolName, permIntents);
+                const script = applyExtends(body, this.agent, hookName, extendHooks);
+                files[`${toolName}-permission.sh`] = script;
+                intentGeneratedHooks.add(hookName);
+            }
+        }
+        // --- raw hooks: write directly ---
+        for (const [key, reg] of rawHooks) {
+            if (!key.startsWith(`${this.agent}::`))
+                continue;
+            const hookName = key.split('::')[1];
+            const fileName = `${toolName}-raw-${hookName.toLowerCase()}.sh`;
+            if (intentGeneratedHooks.has(hookName)) {
+                warnings.push(`[${this.agent}] raw hook for ${hookName} replaces intent-generated hook.`);
+            }
+            files[fileName] = reg.handler;
+        }
+        return { files, warnings, skipped };
+    }
+    getSettingsEntries(hookDir, toolName) {
+        const entries = [];
+        // We need to build entries for every file we'd generate.
+        // This is called after translate(), so we inspect the files pattern.
+        // However, since getSettingsEntries is called separately, we derive
+        // entries from standard naming conventions.
+        //
+        // The actual entries are built dynamically based on generated files
+        // by installHooks(). Here we provide the static mapping pattern.
+        //
+        // For now, return empty — installHooks will use translate() output
+        // to build settings entries directly.
+        return entries;
+    }
+    // -----------------------------------------------------------------------
+    // Script builders — Claude Code uses JSON stdin + stdout + exit code
+    // -----------------------------------------------------------------------
+    mergeInjectIntents(intents) {
+        return {
+            perTurn: intents.map((i) => i.perTurn).join('\n\n'),
+        };
+    }
+    buildInjectScript(toolName, merged) {
+        return `#!/bin/bash
+# ${capitalize(toolName)} — inject hook (UserPromptSubmit)
+# Generated by @s_s/agent-kit
+
+set -e
+
+cat << 'AGENT_KIT_EOF'
+${merged.perTurn}
+AGENT_KIT_EOF
+`;
+    }
+    buildSessionStartInjectScript(toolName, content) {
+        return `#!/bin/bash
+# ${capitalize(toolName)} — session start inject (SessionStart)
+# Generated by @s_s/agent-kit
+
+set -e
+
+cat << 'AGENT_KIT_EOF'
+${content}
+AGENT_KIT_EOF
+`;
+    }
+    buildCompactionScript(toolName, content) {
+        return `#!/bin/bash
+# ${capitalize(toolName)} — compaction inject (PreCompact)
+# Generated by @s_s/agent-kit
+
+set -e
+
+cat << 'AGENT_KIT_EOF'
+${content}
+AGENT_KIT_EOF
+`;
+    }
+    buildSessionEndInjectScript(toolName, content) {
+        return `#!/bin/bash
+# ${capitalize(toolName)} — session end inject (SessionEnd)
+# Generated by @s_s/agent-kit
+
+set -e
+
+cat << 'AGENT_KIT_EOF'
+${content}
+AGENT_KIT_EOF
+`;
+    }
+    buildBeforeToolCallScript(toolName, intents) {
+        // Claude Code PreToolUse: receives JSON on stdin with tool_name and tool_input,
+        // can output JSON with decision: "block"|"allow" and optionally modified input.
+        // Exit code 2 = block.
+        const matcherCases = intents.map((intent, i) => {
+            const matcherStr = matcherToString(intent.match);
+            const condition = matcherStr ? `echo "$TOOL_NAME" | grep -qE '${matcherStr}'` : 'true';
+            // Since the handler is a JS function, we serialize the logic as
+            // a shell-based JSON decision. For Claude Code, the handler runs
+            // as an external process, so we need to represent the logic as shell code.
+            // The intent handler is a JS function — we can't directly translate arbitrary
+            // JS to shell. Instead, we output the JSON stdin to a node script.
+            return `# Intent #${i + 1}${matcherStr ? ` (match: ${matcherStr})` : ''}
+if ${condition}; then
+    # Handler logic is evaluated by the agent-kit runtime.
+    # This script passes through the tool call context for runtime evaluation.
+    :
+fi`;
+        });
+        return `#!/bin/bash
+# ${capitalize(toolName)} — beforeToolCall hook (PreToolUse)
+# Generated by @s_s/agent-kit
+# Reads JSON from stdin, outputs JSON decision to stdout.
+
+set -e
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+TOOL_INPUT=$(echo "$INPUT" | jq -c '.tool_input // {}')
+
+${matcherCases.join('\n\n')}
+
+# Default: allow
+echo '{"decision": "allow"}'
+exit 0
+`;
+    }
+    buildAfterToolCallScript(toolName, intents) {
+        const matcherParts = intents.map((intent, i) => {
+            const matcherStr = matcherToString(intent.match);
+            const condition = matcherStr ? `echo "$TOOL_NAME" | grep -qE '${matcherStr}'` : 'true';
+            return `# Observer #${i + 1}${matcherStr ? ` (match: ${matcherStr})` : ''}
+if ${condition}; then
+    :
+fi`;
+        });
+        return `#!/bin/bash
+# ${capitalize(toolName)} — afterToolCall hook (PostToolUse)
+# Generated by @s_s/agent-kit
+# Observation-only — no output expected.
+
+set -e
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+TOOL_RESULT=$(echo "$INPUT" | jq -c '.tool_result // ""')
+
+${matcherParts.join('\n\n')}
+
+exit 0
+`;
+    }
+    buildOnSessionScript(toolName, phase) {
+        const hookName = phase === 'start' ? 'SessionStart' : 'SessionEnd';
+        return `#!/bin/bash
+# ${capitalize(toolName)} — onSession.${phase} hook (${hookName})
+# Generated by @s_s/agent-kit
+
+set -e
+
+INPUT=$(cat)
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty')
+
+# Session ${phase} handler — extend with hooks.extend() for custom logic.
+
+exit 0
+`;
+    }
+    buildPermissionScript(toolName, intents) {
+        const matcherParts = intents.map((intent, i) => {
+            const matcherStr = matcherToString(intent.match);
+            const condition = matcherStr ? `echo "$TOOL_NAME" | grep -qE '${matcherStr}'` : 'true';
+            return `# Permission handler #${i + 1}${matcherStr ? ` (match: ${matcherStr})` : ''}
+if ${condition}; then
+    # Permission decision handled by agent-kit runtime.
+    :
+fi`;
+        });
+        return `#!/bin/bash
+# ${capitalize(toolName)} — onPermission hook (PermissionRequest)
+# Generated by @s_s/agent-kit
+# Outputs JSON with decision: "allow"|"deny"|"ask".
+
+set -e
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
+TOOL_INPUT=$(echo "$INPUT" | jq -c '.tool_input // {}')
+
+${matcherParts.join('\n\n')}
+
+# Default: ask the user
+echo '{"decision": "ask"}'
+exit 0
+`;
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/build/hook-translators/claude-code.js.map

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

package/build/hook-translators/index.d.ts

@@ -0,0 +1,4 @@
+export type { AgentHookTranslator, TranslationResult, SettingsHookEntry } from './types.js';
+export { ClaudeCodeTranslator } from './claude-code.js';
+export { OpenCodeTranslator } from './opencode.js';
+export { OpenClawTranslator } from './openclaw.js';

package/build/hook-translators/index.js

@@ -0,0 +1,4 @@
+export { ClaudeCodeTranslator } from './claude-code.js';
+export { OpenCodeTranslator } from './opencode.js';
+export { OpenClawTranslator } from './openclaw.js';
+//# sourceMappingURL=index.js.map

package/build/hook-translators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hook-translators/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/build/hook-translators/openclaw.d.ts

@@ -0,0 +1,25 @@
+import type { AgentHookTranslator, TranslationResult, SettingsHookEntry } from './types.js';
+import type { HookIntent, RawHookRegistration, ExtendHookRegistration } from '../hook-types.js';
+/**
+ * Translates intent-based hooks into OpenClaw native format.
+ *
+ * OpenClaw dual-layer system:
+ * - Internal hooks: type:action string keys, event objects, errors never propagate
+ * - Plugin hooks: typed, validated, modifying hooks run sequentially by priority
+ *
+ * File format:
+ * - HOOK.md with YAML frontmatter (name, description, metadata.openclaw.events)
+ * - handler.ts exporting default async function
+ */
+export declare class OpenClawTranslator implements AgentHookTranslator {
+    translate(intents: readonly HookIntent[], rawHooks: ReadonlyMap<string, RawHookRegistration>, extendHooks: ReadonlyMap<string, readonly ExtendHookRegistration[]>, toolName: string): TranslationResult;
+    getSettingsEntries(): SettingsHookEntry[];
+    private buildInjectSection;
+    private buildSessionEndInjectSection;
+    private buildCompactionSection;
+    private buildBeforeToolCallSection;
+    private buildAfterToolCallSection;
+    private buildOnSessionSection;
+    private buildHookMd;
+    private buildHandlerTs;
+}