@s_s/agent-kit 1.0.0

package/build/hook-translators/openclaw.js

@@ -0,0 +1,272 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function matcherToRegex(match) {
+    if (match === undefined || match === '*')
+        return '/.*/';
+    if (match instanceof RegExp)
+        return match.toString();
+    return `/${match}/`;
+}
+// ---------------------------------------------------------------------------
+// OpenClaw Translator
+// ---------------------------------------------------------------------------
+/**
+ * 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 class OpenClawTranslator {
+    translate(intents, rawHooks, extendHooks, toolName) {
+        const files = {};
+        const warnings = [];
+        const skipped = [];
+        // OpenClaw hook files live in subdirectories per hook type.
+        // We collect all events that the main handler needs to respond to,
+        // and internal hooks that need separate registration.
+        const pluginEvents = new Set();
+        const internalEvents = new Set();
+        const handlerSections = [];
+        // Track intent-generated hooks for conflict detection
+        const intentGeneratedPluginHooks = new Set();
+        const intentGeneratedInternalHooks = new Set();
+        // --- inject intents ---
+        const injectIntents = intents.filter((i) => i.type === 'inject');
+        if (injectIntents.length > 0) {
+            const internalHook = 'agent:bootstrap';
+            if (rawHooks.has(`openclaw::${internalHook}`)) {
+                warnings.push(`[openclaw] raw hook for ${internalHook} overrides inject intent.`);
+            }
+            else {
+                internalEvents.add(internalHook);
+                intentGeneratedInternalHooks.add(internalHook);
+                const reminderParts = injectIntents
+                    .flatMap((i) => [i.sessionStart, i.perTurn].filter(Boolean))
+                    .join('\\n\\n');
+                handlerSections.push(this.buildInjectSection(toolName, reminderParts));
+            }
+            // session_start / session_end via plugin hooks
+            const sessionStarts = injectIntents.filter((i) => i.sessionStart);
+            if (sessionStarts.length > 0 && !rawHooks.has('openclaw::session_start')) {
+                pluginEvents.add('session_start');
+                intentGeneratedPluginHooks.add('session_start');
+            }
+            const sessionEnds = injectIntents.filter((i) => i.sessionEnd);
+            if (sessionEnds.length > 0 && !rawHooks.has('openclaw::session_end')) {
+                pluginEvents.add('session_end');
+                intentGeneratedPluginHooks.add('session_end');
+                const combined = sessionEnds.map((i) => i.sessionEnd).join('\\n\\n');
+                handlerSections.push(this.buildSessionEndInjectSection(combined));
+            }
+            // compaction → session:compact:before (internal) or before_compaction (plugin)
+            const compactions = injectIntents.filter((i) => i.compaction);
+            if (compactions.length > 0) {
+                if (!rawHooks.has('openclaw::before_compaction')) {
+                    pluginEvents.add('before_compaction');
+                    intentGeneratedPluginHooks.add('before_compaction');
+                    const combined = compactions.map((i) => i.compaction).join('\\n\\n');
+                    handlerSections.push(this.buildCompactionSection(combined));
+                }
+            }
+        }
+        // --- beforeToolCall intents ---
+        const beforeIntents = intents.filter((i) => i.type === 'beforeToolCall');
+        if (beforeIntents.length > 0) {
+            const hookName = 'before_tool_call';
+            if (rawHooks.has(`openclaw::${hookName}`)) {
+                warnings.push(`[openclaw] raw hook for ${hookName} overrides beforeToolCall intent.`);
+            }
+            else {
+                pluginEvents.add(hookName);
+                intentGeneratedPluginHooks.add(hookName);
+                handlerSections.push(this.buildBeforeToolCallSection(beforeIntents));
+            }
+        }
+        // --- afterToolCall intents ---
+        const afterIntents = intents.filter((i) => i.type === 'afterToolCall');
+        if (afterIntents.length > 0) {
+            const hookName = 'after_tool_call';
+            if (rawHooks.has(`openclaw::${hookName}`)) {
+                warnings.push(`[openclaw] raw hook for ${hookName} overrides afterToolCall intent.`);
+            }
+            else {
+                pluginEvents.add(hookName);
+                intentGeneratedPluginHooks.add(hookName);
+                handlerSections.push(this.buildAfterToolCallSection(afterIntents));
+            }
+        }
+        // --- 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 && !intentGeneratedPluginHooks.has('session_start')) {
+                if (rawHooks.has('openclaw::session_start')) {
+                    warnings.push(`[openclaw] raw hook for session_start overrides onSession.start intent.`);
+                }
+                else {
+                    pluginEvents.add('session_start');
+                    intentGeneratedPluginHooks.add('session_start');
+                    handlerSections.push(this.buildOnSessionSection('start'));
+                }
+            }
+            if (hasEnd && !intentGeneratedPluginHooks.has('session_end')) {
+                if (rawHooks.has('openclaw::session_end')) {
+                    warnings.push(`[openclaw] raw hook for session_end overrides onSession.end intent.`);
+                }
+                else {
+                    pluginEvents.add('session_end');
+                    intentGeneratedPluginHooks.add('session_end');
+                    handlerSections.push(this.buildOnSessionSection('end'));
+                }
+            }
+        }
+        // --- onPermission intents ---
+        const permIntents = intents.filter((i) => i.type === 'onPermission');
+        if (permIntents.length > 0) {
+            // OpenClaw has no dedicated permission hook.
+            // Best effort: degrade to before_tool_call with block capability.
+            skipped.push({
+                intent: 'onPermission',
+                agent: 'openclaw',
+                reason: 'OpenClaw has no dedicated permission request hook. ' +
+                    'Consider using hooks.raw() with before_tool_call for similar behavior.',
+            });
+            warnings.push(`[openclaw] onPermission: not supported. OpenClaw has no PermissionRequest equivalent. ` +
+                `Use hooks.raw("openclaw", "before_tool_call", ...) as a workaround.`);
+        }
+        // --- Apply extend hooks to handler sections ---
+        for (const hookName of [...intentGeneratedPluginHooks, ...intentGeneratedInternalHooks]) {
+            const key = `openclaw::${hookName}`;
+            const extends_ = extendHooks.get(key);
+            if (extends_ && extends_.length > 0) {
+                for (const ext of extends_) {
+                    handlerSections.push(`    // --- extend for ${hookName} ---\n    ${ext.handler}`);
+                }
+            }
+        }
+        // --- Build HOOK.md and handler.ts ---
+        if (handlerSections.length > 0 || internalEvents.size > 0 || pluginEvents.size > 0) {
+            const allEvents = [...internalEvents, ...pluginEvents];
+            files['HOOK.md'] = this.buildHookMd(toolName, allEvents);
+            files['handler.ts'] = this.buildHandlerTs(toolName, handlerSections, internalEvents, pluginEvents);
+        }
+        // --- Raw hooks: write as additional files ---
+        for (const [key, reg] of rawHooks) {
+            if (!key.startsWith('openclaw::'))
+                continue;
+            const hookName = key.split('::')[1];
+            if (intentGeneratedPluginHooks.has(hookName) || intentGeneratedInternalHooks.has(hookName)) {
+                warnings.push(`[openclaw] raw hook for ${hookName} replaces intent-generated hook.`);
+            }
+            // Raw hooks get their own subdirectory-style files
+            const safeName = hookName.replace(/[:.]/g, '-');
+            files[`raw-${safeName}.ts`] = reg.handler;
+        }
+        return { files, warnings, skipped };
+    }
+    getSettingsEntries() {
+        // OpenClaw doesn't use settings.json for hooks
+        return [];
+    }
+    // -----------------------------------------------------------------------
+    // Section builders
+    // -----------------------------------------------------------------------
+    buildInjectSection(toolName, reminderContent) {
+        const constName = toolName.toUpperCase().replace(/-/g, '_') + '_REMINDER';
+        return `    // --- inject (agent:bootstrap) ---
+    if (event.type === 'agent' && event.action === 'bootstrap') {
+        if (event.sessionKey && event.sessionKey.includes(':subagent:')) {
+            return;
+        }
+        if (Array.isArray(event.context?.bootstrapFiles)) {
+            event.context.bootstrapFiles.push({
+                path: '${constName}.md',
+                content: \`${reminderContent}\`,
+                virtual: true,
+            });
+        }
+    }`;
+    }
+    buildSessionEndInjectSection(content) {
+        return `    // --- inject.sessionEnd (session_end) ---
+    if (event.hookName === 'session_end') {
+        // Session end content: ${content.substring(0, 50)}...
+    }`;
+    }
+    buildCompactionSection(content) {
+        return `    // --- inject.compaction (before_compaction) ---
+    if (event.hookName === 'before_compaction') {
+        if (event.context) {
+            event.context.additionalContext = (event.context.additionalContext || '') +
+                '\\n' + \`${content}\`;
+        }
+    }`;
+    }
+    buildBeforeToolCallSection(intents) {
+        const cases = intents.map((intent, i) => {
+            const regex = matcherToRegex(intent.match);
+            return `        // beforeToolCall handler #${i + 1}
+        if (${regex}.test(event.toolName || "")) {
+            // Handler evaluated at runtime via agent-kit
+        }`;
+        });
+        return `    // --- beforeToolCall (before_tool_call) ---
+    if (event.hookName === 'before_tool_call') {
+${cases.join('\n\n')}
+    }`;
+    }
+    buildAfterToolCallSection(intents) {
+        const cases = intents.map((intent, i) => {
+            const regex = matcherToRegex(intent.match);
+            return `        // afterToolCall observer #${i + 1}
+        if (${regex}.test(event.toolName || "")) {
+            // Observer evaluated at runtime via agent-kit
+        }`;
+        });
+        return `    // --- afterToolCall (after_tool_call) ---
+    if (event.hookName === 'after_tool_call') {
+${cases.join('\n\n')}
+    }`;
+    }
+    buildOnSessionSection(phase) {
+        return `    // --- onSession.${phase} (session_${phase}) ---
+    if (event.hookName === 'session_${phase}') {
+        // Session ${phase} handler — extend with hooks.extend() for custom logic.
+    }`;
+    }
+    // -----------------------------------------------------------------------
+    // File builders
+    // -----------------------------------------------------------------------
+    buildHookMd(toolName, events) {
+        return `---
+name: ${toolName}
+description: "${capitalize(toolName)} hook - generated by @s_s/agent-kit"
+metadata: {"openclaw":{"events":${JSON.stringify(events)}}}
+---
+`;
+    }
+    buildHandlerTs(toolName, sections, _internalEvents, _pluginEvents) {
+        return `/**
+ * ${capitalize(toolName)} Hook Handler for OpenClaw
+ * Generated by @s_s/agent-kit
+ */
+
+const handler = async (event: any) => {
+${sections.join('\n\n')}
+};
+
+export default handler;
+`;
+    }
+}
+//# sourceMappingURL=openclaw.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { AgentHookTranslator, TranslationResult, SettingsHookEntry } from './types.js';
+import type { HookIntent, RawHookRegistration, ExtendHookRegistration } from '../hook-types.js';
+/**
+ * Translates intent-based hooks into an OpenCode plugin file.
+ *
+ * OpenCode constraints:
+ * - All hooks must merge into a single .ts plugin file
+ * - Plugin exports an async factory function that returns a hook object
+ * - Hooks are keys in the returned object (e.g. "tool.execute.before")
+ * - Each hook is an async function(input, output) that modifies output in-place
+ * - No explicit block mechanism for tool.execute.before (partial support)
+ */
+export declare class OpenCodeTranslator implements AgentHookTranslator {
+    translate(intents: readonly HookIntent[], rawHooks: ReadonlyMap<string, RawHookRegistration>, extendHooks: ReadonlyMap<string, readonly ExtendHookRegistration[]>, toolName: string): TranslationResult;
+    getSettingsEntries(): SettingsHookEntry[];
+    private addHookBody;
+    private buildInjectHookBody;
+    private buildBeforeToolCallBody;
+    private buildAfterToolCallBody;
+    private buildSessionBody;
+    private buildPermissionBody;
+    private buildPluginFile;
+}

package/build/hook-translators/opencode.js

@@ -0,0 +1,254 @@
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function toPascalCase(str) {
+    return str
+        .split(/[-_]/)
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1).toLowerCase())
+        .join('');
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function matcherToRegex(match) {
+    if (match === undefined || match === '*')
+        return '/.*/';
+    if (match instanceof RegExp)
+        return match.toString();
+    return `/${match}/`;
+}
+// ---------------------------------------------------------------------------
+// OpenCode Translator
+// ---------------------------------------------------------------------------
+/**
+ * Translates intent-based hooks into an OpenCode plugin file.
+ *
+ * OpenCode constraints:
+ * - All hooks must merge into a single .ts plugin file
+ * - Plugin exports an async factory function that returns a hook object
+ * - Hooks are keys in the returned object (e.g. "tool.execute.before")
+ * - Each hook is an async function(input, output) that modifies output in-place
+ * - No explicit block mechanism for tool.execute.before (partial support)
+ */
+export class OpenCodeTranslator {
+    translate(intents, rawHooks, extendHooks, toolName) {
+        const warnings = [];
+        const skipped = [];
+        // Collect all hook bodies keyed by OpenCode hook name
+        const hookBodies = new Map();
+        // Track intent-generated hooks for conflict detection
+        const intentGeneratedHooks = new Set();
+        // --- inject intents ---
+        const injectIntents = intents.filter((i) => i.type === 'inject');
+        if (injectIntents.length > 0) {
+            const hookName = 'experimental.chat.messages.transform';
+            if (rawHooks.has(`opencode::${hookName}`)) {
+                warnings.push(`[opencode] raw hook for ${hookName} overrides inject intent.`);
+            }
+            else {
+                const body = this.buildInjectHookBody(injectIntents);
+                this.addHookBody(hookBodies, hookName, body);
+                intentGeneratedHooks.add(hookName);
+            }
+            // compaction → experimental.session.compacting
+            const compactions = injectIntents.filter((i) => i.compaction);
+            if (compactions.length > 0) {
+                const compactHook = 'experimental.session.compacting';
+                if (rawHooks.has(`opencode::${compactHook}`)) {
+                    warnings.push(`[opencode] raw hook for ${compactHook} overrides inject.compaction intent.`);
+                }
+                else {
+                    const combined = compactions.map((i) => i.compaction).join('\\n\\n');
+                    const body = `            output.context.push(\`${combined}\`);`;
+                    this.addHookBody(hookBodies, compactHook, body);
+                    intentGeneratedHooks.add(compactHook);
+                }
+            }
+            warnings.push(`[opencode] inject relies on experimental.chat.messages.transform which is marked experimental and may change.`);
+        }
+        // --- beforeToolCall intents ---
+        const beforeIntents = intents.filter((i) => i.type === 'beforeToolCall');
+        if (beforeIntents.length > 0) {
+            const hookName = 'tool.execute.before';
+            if (rawHooks.has(`opencode::${hookName}`)) {
+                warnings.push(`[opencode] raw hook for ${hookName} overrides beforeToolCall intent.`);
+            }
+            else {
+                const body = this.buildBeforeToolCallBody(beforeIntents);
+                this.addHookBody(hookBodies, hookName, body);
+                intentGeneratedHooks.add(hookName);
+                if (beforeIntents.some((i) => true)) {
+                    warnings.push(`[opencode] beforeToolCall.block: OpenCode's tool.execute.before has no explicit block mechanism. ` +
+                        `Blocking is simulated by clearing tool arguments, which may produce inconsistent behavior.`);
+                }
+            }
+        }
+        // --- afterToolCall intents ---
+        const afterIntents = intents.filter((i) => i.type === 'afterToolCall');
+        if (afterIntents.length > 0) {
+            const hookName = 'tool.execute.after';
+            if (rawHooks.has(`opencode::${hookName}`)) {
+                warnings.push(`[opencode] raw hook for ${hookName} overrides afterToolCall intent.`);
+            }
+            else {
+                const body = this.buildAfterToolCallBody(afterIntents);
+                this.addHookBody(hookBodies, hookName, body);
+                intentGeneratedHooks.add(hookName);
+            }
+        }
+        // --- onSession intents ---
+        const sessionIntents = intents.filter((i) => i.type === 'onSession');
+        if (sessionIntents.length > 0) {
+            const hookName = 'event';
+            if (rawHooks.has(`opencode::${hookName}`)) {
+                warnings.push(`[opencode] raw hook for ${hookName} overrides onSession intent.`);
+            }
+            else {
+                const body = this.buildSessionBody(sessionIntents);
+                this.addHookBody(hookBodies, hookName, body);
+                intentGeneratedHooks.add(hookName);
+            }
+        }
+        // --- onPermission intents ---
+        const permIntents = intents.filter((i) => i.type === 'onPermission');
+        if (permIntents.length > 0) {
+            const hookName = 'permission.ask';
+            if (rawHooks.has(`opencode::${hookName}`)) {
+                warnings.push(`[opencode] raw hook for ${hookName} overrides onPermission intent.`);
+            }
+            else {
+                const body = this.buildPermissionBody(permIntents);
+                this.addHookBody(hookBodies, hookName, body);
+                intentGeneratedHooks.add(hookName);
+            }
+        }
+        // --- Apply extend hooks ---
+        for (const hookName of hookBodies.keys()) {
+            const key = `opencode::${hookName}`;
+            const extends_ = extendHooks.get(key);
+            if (extends_ && extends_.length > 0) {
+                for (const ext of extends_) {
+                    this.addHookBody(hookBodies, hookName, `            // --- extend ---\n${ext.handler}`);
+                }
+            }
+        }
+        // --- Raw hooks: merge directly ---
+        for (const [key, reg] of rawHooks) {
+            if (!key.startsWith('opencode::'))
+                continue;
+            const hookName = key.split('::')[1];
+            if (intentGeneratedHooks.has(hookName)) {
+                warnings.push(`[opencode] raw hook for ${hookName} replaces intent-generated hook.`);
+                hookBodies.delete(hookName);
+            }
+            this.addHookBody(hookBodies, hookName, reg.handler);
+        }
+        // --- Generate the single plugin file ---
+        const files = {};
+        if (hookBodies.size > 0) {
+            files[`${toolName}-plugin.ts`] = this.buildPluginFile(toolName, hookBodies);
+        }
+        return { files, warnings, skipped };
+    }
+    getSettingsEntries() {
+        // OpenCode doesn't use settings.json for hooks
+        return [];
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    addHookBody(map, hookName, body) {
+        const existing = map.get(hookName) ?? [];
+        existing.push(body);
+        map.set(hookName, existing);
+    }
+    buildInjectHookBody(intents) {
+        const perTurnParts = intents.map((i) => i.perTurn);
+        const sessionStartParts = intents.filter((i) => i.sessionStart).map((i) => i.sessionStart);
+        const hasSessionStart = sessionStartParts.length > 0;
+        const perTurnCombined = perTurnParts.join('\\n\\n');
+        const sessionStartCombined = hasSessionStart
+            ? [...sessionStartParts, ...perTurnParts].join('\\n\\n')
+            : perTurnCombined;
+        return `            const messages = output.messages;
+            if (!messages || messages.length === 0) return;
+
+            const sessionID = messages[0]?.info?.sessionID;
+            const isNewSession = sessionID && !_seenSessions.has(sessionID);
+            if (sessionID) _seenSessions.add(sessionID);
+
+            const reminder = isNewSession
+                ? \`${sessionStartCombined}\`
+                : \`${perTurnCombined}\`;
+
+            for (let i = messages.length - 1; i >= 0; i--) {
+                if (messages[i].info?.role === "user") {
+                    messages[i].parts.push({ type: "text", text: reminder });
+                    break;
+                }
+            }`;
+    }
+    buildBeforeToolCallBody(intents) {
+        const cases = intents.map((intent, i) => {
+            const regex = matcherToRegex(intent.match);
+            return `            // beforeToolCall intent #${i + 1}
+            if (${regex}.test(output.toolName || "")) {
+                // Handler evaluated at runtime via agent-kit
+            }`;
+        });
+        return cases.join('\n\n');
+    }
+    buildAfterToolCallBody(intents) {
+        const cases = intents.map((intent, i) => {
+            const regex = matcherToRegex(intent.match);
+            return `            // afterToolCall observer #${i + 1}
+            if (${regex}.test(output.toolName || "")) {
+                // Observer evaluated at runtime via agent-kit
+            }`;
+        });
+        return cases.join('\n\n');
+    }
+    buildSessionBody(intents) {
+        return `            const eventType = output.type || "";
+            if (eventType === "session.start") {
+                // onSession.start handlers
+            } else if (eventType === "session.end") {
+                // onSession.end handlers
+            }`;
+    }
+    buildPermissionBody(intents) {
+        const cases = intents.map((intent, i) => {
+            const regex = matcherToRegex(intent.match);
+            return `            // onPermission handler #${i + 1}
+            if (${regex}.test(output.toolName || "")) {
+                // Permission decision evaluated at runtime via agent-kit
+            }`;
+        });
+        return cases.join('\n\n');
+    }
+    buildPluginFile(toolName, hookBodies) {
+        const exportName = toPascalCase(toolName) + 'Plugin';
+        const hookEntries = Array.from(hookBodies.entries())
+            .map(([hookName, bodies]) => {
+            const combinedBody = bodies.join('\n\n');
+            return `        "${hookName}": async (_input: unknown, output: any) => {
+${combinedBody}
+        }`;
+        })
+            .join(',\n\n');
+        return `/**
+ * ${capitalize(toolName)} Plugin for OpenCode
+ * Generated by @s_s/agent-kit
+ */
+
+const _seenSessions = new Set<string>();
+
+export const ${exportName} = async () => {
+    return {
+${hookEntries}
+    };
+};
+`;
+    }
+}
+//# sourceMappingURL=opencode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/hook-translators/opencode.ts"],"names":[],"mappings":"AAYA,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,YAAY,CAAC,GAAW;IAC7B,OAAO,GAAG;SACL,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAChE,IAAI,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,KAAkC;IACtD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IACxD,IAAI,KAAK,YAAY,MAAM;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACrD,OAAO,IAAI,KAAK,GAAG,CAAC;AACxB,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IAC3B,SAAS,CACL,OAA8B,EAC9B,QAAkD,EAClD,WAAmE,EACnE,QAAgB;QAEhB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAiC,EAAE,CAAC;QAEjD,sDAAsD;QACtD,MAAM,UAAU,GAA0B,IAAI,GAAG,EAAE,CAAC;QAEpD,sDAAsD;QACtD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/C,yBAAyB;QACzB,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACpF,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,sCAAsC,CAAC;YAExD,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,2BAA2B,CAAC,CAAC;YAClF,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;gBACrD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC7C,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;YAED,+CAA+C;YAC/C,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;YAC9D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,WAAW,GAAG,iCAAiC,CAAC;gBACtD,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC3C,QAAQ,CAAC,IAAI,CAAC,2BAA2B,WAAW,sCAAsC,CAAC,CAAC;gBAChG,CAAC;qBAAM,CAAC;oBACJ,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACtE,MAAM,IAAI,GAAG,qCAAqC,QAAQ,MAAM,CAAC;oBACjE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;oBAChD,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC1C,CAAC;YACL,CAAC;YAED,QAAQ,CAAC,IAAI,CACT,+GAA+G,CAClH,CAAC;QACN,CAAC;QAED,iCAAiC;QACjC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;QACpG,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,qBAAqB,CAAC;YACvC,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,mCAAmC,CAAC,CAAC;YAC1F,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;gBACzD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC7C,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAEnC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,QAAQ,CAAC,IAAI,CACT,mGAAmG;wBAC/F,4FAA4F,CACnG,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC;QAED,gCAAgC;QAChC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAA4B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;QACjG,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,oBAAoB,CAAC;YACtC,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,kCAAkC,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;gBACvD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC7C,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;QACL,CAAC;QAED,4BAA4B;QAC5B,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAC3F,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC;YACzB,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,8BAA8B,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;gBACnD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC7C,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;QACL,CAAC;QAED,+BAA+B;QAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAA2B,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;QAC9F,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,gBAAgB,CAAC;YAClC,IAAI,QAAQ,CAAC,GAAG,CAAC,aAAa,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,iCAAiC,CAAC,CAAC;YACxF,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,GAAG,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;gBACnD,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAC7C,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;QACL,CAAC;QAED,6BAA6B;QAC7B,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,aAAa,QAAQ,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBACzB,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,kCAAkC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC5F,CAAC;YACL,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC;gBAAE,SAAS;YAC5C,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAEpC,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,2BAA2B,QAAQ,kCAAkC,CAAC,CAAC;gBACrF,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChC,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,0CAA0C;QAC1C,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,GAAG,QAAQ,YAAY,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,kBAAkB;QACd,+CAA+C;QAC/C,OAAO,EAAE,CAAC;IACd,CAAC;IAED,0EAA0E;IAC1E,kBAAkB;IAClB,0EAA0E;IAElE,WAAW,CAAC,GAA0B,EAAE,QAAgB,EAAE,IAAY;QAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEO,mBAAmB,CAAC,OAAuB;QAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAa,CAAC,CAAC;QAE5F,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC;QACrD,MAAM,eAAe,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,oBAAoB,GAAG,eAAe;YACxC,CAAC,CAAC,CAAC,GAAG,iBAAiB,EAAE,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxD,CAAC,CAAC,eAAe,CAAC;QAEtB,OAAO;;;;;;;;sBAQO,oBAAoB;sBACpB,eAAe;;;;;;;cAOvB,CAAC;IACX,CAAC;IAEO,uBAAuB,CAAC,OAA+B;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,yCAAyC,CAAC,GAAG,CAAC;kBAC/C,KAAK;;cAET,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,sBAAsB,CAAC,OAA8B;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,0CAA0C,CAAC,GAAG,CAAC;kBAChD,KAAK;;cAET,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,gBAAgB,CAAC,OAA0B;QAC/C,OAAO;;;;;cAKD,CAAC;IACX,CAAC;IAEO,mBAAmB,CAAC,OAA6B;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,wCAAwC,CAAC,GAAG,CAAC;kBAC9C,KAAK;;cAET,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,eAAe,CAAC,QAAgB,EAAE,UAAiC;QACvE,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAErD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;aAC/C,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE;YACxB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,YAAY,QAAQ;EACzC,YAAY;UACJ,CAAC;QACC,CAAC,CAAC;aACD,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnB,OAAO;KACV,UAAU,CAAC,QAAQ,CAAC;;;;;;eAMV,UAAU;;EAEvB,WAAW;;;CAGZ,CAAC;IACE,CAAC;CACJ"}

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

@@ -0,0 +1,59 @@
+import type { HookIntent, RawHookRegistration, ExtendHookRegistration } from '../hook-types.js';
+import type { SkippedIntent } from '../types.js';
+/**
+ * Result of translating intents into native hook files for a specific agent.
+ */
+export interface TranslationResult {
+    /** Map of filename → file content to write to the hook directory. */
+    files: Record<string, string>;
+    /** Warnings about degradation, conflicts, or partial support. */
+    warnings: string[];
+    /** Intents that were completely skipped (unsupported by this agent). */
+    skipped: SkippedIntent[];
+}
+/**
+ * Describes a settings.json hook entry to merge.
+ * Used by agents that need hook config in a central settings file (Claude Code, Codex).
+ */
+export interface SettingsHookEntry {
+    /** Native hook event name (e.g. 'UserPromptSubmit', 'PreToolUse'). */
+    event: string;
+    /** Regex matcher string. Empty string matches all. */
+    matcher: string;
+    /** Handler type and command/URL. */
+    hook: {
+        type: 'command';
+        command: string;
+    };
+}
+/**
+ * Translates intent-based hook declarations into native hook files for a specific agent.
+ *
+ * Each agent has its own translator implementation that understands:
+ * - How to map intents to native hook event names
+ * - How to generate handler code (shell scripts, TypeScript plugins, etc.)
+ * - How to merge multiple intents targeting the same native hook
+ * - How to apply raw overrides and extend augmentations
+ * - What capabilities are partially or fully unsupported
+ */
+export interface AgentHookTranslator {
+    /**
+     * Translate all registered hook declarations into native files.
+     *
+     * @param intents - All registered intents from the hook registry.
+     * @param rawHooks - Raw hook registrations for this agent.
+     * @param extendHooks - Extend hook registrations for this agent.
+     * @param toolName - The registered tool name (used for file naming, markers, etc.)
+     * @returns Translation result with files, warnings, and skipped intents.
+     */
+    translate(intents: readonly HookIntent[], rawHooks: ReadonlyMap<string, RawHookRegistration>, extendHooks: ReadonlyMap<string, readonly ExtendHookRegistration[]>, toolName: string): TranslationResult;
+    /**
+     * Get settings entries that need to be merged into the agent's settings file.
+     * Only applicable for agents that use a central settings file (Claude Code, Codex).
+     * Returns empty array for agents that don't need settings.json updates.
+     *
+     * @param hookDir - The directory where hook files are written.
+     * @param toolName - The registered tool name.
+     */
+    getSettingsEntries(hookDir: string, toolName: string): SettingsHookEntry[];
+}

package/build/hook-translators/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hook-translators/types.ts"],"names":[],"mappings":""}