@scotthuang/agent-knock-knock 0.2.46 → 0.2.48

package/dist/src/claude-hook-installer.js

@@ -0,0 +1,410 @@
+import { randomBytes } from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const CLAUDE_HOOK_EVENT_NAMES = [
+    "SessionStart",
+    "UserPromptSubmit",
+    "PermissionRequest",
+    "Stop",
+    "StopFailure",
+    "Notification"
+];
+const HOOK_ARGUMENTS = ["claude-hook"];
+const PERMISSION_STATUS_MESSAGE = "Waiting for Agent Knock Knock approval...";
+const HOOK_DEFINITIONS = [
+    {
+        event: "SessionStart",
+        matcher: "startup|resume|clear|compact|fork",
+        timeout: 10
+    },
+    { event: "UserPromptSubmit", timeout: 10 },
+    { event: "PermissionRequest", matcher: "*", timeout: 600, statusMessage: PERMISSION_STATUS_MESSAGE },
+    { event: "Stop", timeout: 10 },
+    {
+        event: "StopFailure",
+        matcher: "rate_limit|authentication_failed|oauth_org_not_allowed|billing_error|invalid_request|model_not_found|server_error|max_output_tokens|unknown",
+        timeout: 10
+    },
+    {
+        event: "Notification",
+        matcher: "permission_prompt|idle_prompt|agent_needs_input|agent_completed",
+        timeout: 10
+    }
+];
+/** Returns Claude Code's user settings path without reading it. */
+export function defaultClaudeSettingsPath() {
+    return path.join(os.homedir(), ".claude", "settings.json");
+}
+/**
+ * Reads only Tokenjuice launcher provenance from Claude's trusted user settings.
+ * Invalid, missing, non-executable, or relative launchers are ignored so approval
+ * normalization fails closed without exposing settings contents.
+ */
+export function loadTrustedClaudeTokenjuiceLaunchers(settingsPath = defaultClaudeSettingsPath()) {
+    let settings;
+    try {
+        settings = readSettings(path.resolve(settingsPath));
+    }
+    catch {
+        return [];
+    }
+    return extractClaudeTokenjuiceLaunchers(settings).flatMap((launcher) => {
+        try {
+            fs.accessSync(launcher, fs.constants.X_OK);
+            return [{
+                    configuredPath: launcher,
+                    canonicalPath: fs.realpathSync(launcher)
+                }];
+        }
+        catch {
+            return [];
+        }
+    }).filter((launcher, index, values) => values.findIndex((candidate) => candidate.configuredPath === launcher.configuredPath &&
+        candidate.canonicalPath === launcher.canonicalPath) === index);
+}
+export function extractClaudeTokenjuiceLaunchers(settingsValue) {
+    if (!isObject(settingsValue) || !isObject(settingsValue.hooks)) {
+        return [];
+    }
+    const groups = settingsValue.hooks.PreToolUse;
+    if (!Array.isArray(groups)) {
+        return [];
+    }
+    const launchers = [];
+    for (const group of groups) {
+        if (!isObject(group) || group.matcher !== "Bash" || !Array.isArray(group.hooks)) {
+            continue;
+        }
+        for (const handler of group.hooks) {
+            if (!isObject(handler) || handler.type !== "command" || typeof handler.command !== "string") {
+                continue;
+            }
+            const tokens = tokenizeShellWords(handler.command);
+            if (!tokens) {
+                continue;
+            }
+            const subcommandIndex = tokens.indexOf("claude-code-pre-tool-use");
+            if (subcommandIndex < 1) {
+                continue;
+            }
+            let launcher;
+            for (let index = subcommandIndex + 1; index < tokens.length; index += 1) {
+                if (tokens[index] === "--wrap-launcher") {
+                    launcher = tokens[index + 1];
+                    break;
+                }
+                if (tokens[index].startsWith("--wrap-launcher=")) {
+                    launcher = tokens[index].slice("--wrap-launcher=".length);
+                    break;
+                }
+            }
+            if (launcher && path.isAbsolute(launcher)) {
+                launchers.push(path.normalize(launcher));
+            }
+        }
+    }
+    return launchers.filter((launcher, index) => launchers.indexOf(launcher) === index);
+}
+/**
+ * Adds AKK matcher groups without mutating the supplied settings object.
+ * Existing groups and sibling handlers are retained byte-for-byte when the
+ * result is serialized, apart from JSON's normal formatting.
+ */
+export function mergeClaudeHookSettings(settingsValue, executablePathValue) {
+    const executablePath = requireAbsoluteExecutable(executablePathValue);
+    const settings = requireObject(settingsValue, "Claude settings");
+    const existingHooksValue = settings.hooks;
+    const existingHooks = existingHooksValue === undefined
+        ? {}
+        : requireObject(existingHooksValue, "Claude settings hooks");
+    const mergedSettings = { ...settings };
+    const mergedHooks = { ...existingHooks };
+    const addedEvents = [];
+    const existingEvents = [];
+    const warnings = [];
+    for (const definition of HOOK_DEFINITIONS) {
+        const groupsValue = existingHooks[definition.event];
+        if (groupsValue !== undefined && !Array.isArray(groupsValue)) {
+            throw new Error(`Claude settings hooks.${definition.event} must be an array`);
+        }
+        const groups = groupsValue === undefined ? [] : groupsValue;
+        const inspection = inspectEventGroups(groups, definition, executablePath);
+        warnings.push(...inspection.warnings);
+        if (inspection.hasExactHandler) {
+            existingEvents.push(definition.event);
+            continue;
+        }
+        mergedHooks[definition.event] = [
+            ...groups,
+            createMatcherGroup(definition, executablePath)
+        ];
+        addedEvents.push(definition.event);
+    }
+    mergedSettings.hooks = mergedHooks;
+    return {
+        settings: mergedSettings,
+        changed: addedEvents.length > 0,
+        addedEvents,
+        existingEvents,
+        warnings
+    };
+}
+/**
+ * Safely installs Claude Code user hooks. This function does not log settings
+ * contents and its result contains only paths, event names, counts, and
+ * non-sensitive warnings.
+ */
+export function installClaudeHooks(options) {
+    const executablePath = requireAbsoluteExecutable(options.executablePath);
+    const settingsPath = path.resolve(options.settingsPath ?? defaultClaudeSettingsPath());
+    const dryRun = options.dryRun === true;
+    const exists = fs.existsSync(settingsPath);
+    const settings = exists ? readSettings(settingsPath) : {};
+    const merged = mergeClaudeHookSettings(settings, executablePath);
+    let backupPath;
+    if (merged.changed && !dryRun) {
+        const parentDirectory = path.dirname(settingsPath);
+        fs.mkdirSync(parentDirectory, { recursive: true, mode: 0o700 });
+        if (exists) {
+            backupPath = createBackup(settingsPath, options.now ?? (() => new Date()));
+        }
+        atomicWriteJson(settingsPath, merged.settings);
+    }
+    return {
+        settingsPath,
+        changed: merged.changed,
+        written: merged.changed && !dryRun,
+        dryRun,
+        created: !exists && merged.changed && !dryRun,
+        ...(backupPath === undefined ? {} : { backupPath }),
+        addedEvents: merged.addedEvents,
+        existingEvents: merged.existingEvents,
+        warnings: merged.warnings,
+        summary: {
+            addedCount: merged.addedEvents.length,
+            existingCount: merged.existingEvents.length,
+            warningCount: merged.warnings.length
+        }
+    };
+}
+/** Compatibility-friendly explicit name for callers wiring an install command. */
+export const installClaudeHookSettings = installClaudeHooks;
+function createMatcherGroup(definition, executablePath) {
+    const handler = {
+        type: "command",
+        command: executablePath,
+        args: [...HOOK_ARGUMENTS],
+        timeout: definition.timeout,
+        ...(definition.statusMessage === undefined ? {} : { statusMessage: definition.statusMessage })
+    };
+    return {
+        ...(definition.matcher === undefined ? {} : { matcher: definition.matcher }),
+        hooks: [handler]
+    };
+}
+function inspectEventGroups(groups, definition, executablePath) {
+    let hasExactHandler = false;
+    let hasDifferentArguments = false;
+    let exactHandlerNeedsReview = false;
+    for (const groupValue of groups) {
+        if (!isObject(groupValue) || !Array.isArray(groupValue.hooks)) {
+            continue;
+        }
+        for (const handlerValue of groupValue.hooks) {
+            if (!isObject(handlerValue) || handlerValue.command !== executablePath) {
+                continue;
+            }
+            if (!isExactHookArguments(handlerValue.args)) {
+                hasDifferentArguments = true;
+                continue;
+            }
+            hasExactHandler = true;
+            if (!handlerMatchesDefinition(handlerValue, groupValue, definition)) {
+                exactHandlerNeedsReview = true;
+            }
+        }
+    }
+    const warnings = [];
+    if (hasDifferentArguments) {
+        warnings.push(`${definition.event} contains a handler for the AKK executable with different arguments; it was preserved.`);
+    }
+    if (exactHandlerNeedsReview) {
+        warnings.push(`${definition.event} already contains the AKK claude-hook handler with non-recommended options; it was preserved.`);
+    }
+    return { hasExactHandler, warnings };
+}
+function handlerMatchesDefinition(handler, group, definition) {
+    const matcherMatches = definition.matcher === undefined
+        ? group.matcher === undefined
+        : group.matcher === definition.matcher;
+    const statusMatches = definition.statusMessage === undefined
+        ? true
+        : handler.statusMessage === definition.statusMessage;
+    return handler.type === "command" &&
+        handler.timeout === definition.timeout &&
+        matcherMatches &&
+        statusMatches;
+}
+function isExactHookArguments(value) {
+    return Array.isArray(value) && value.length === 1 && value[0] === HOOK_ARGUMENTS[0];
+}
+function tokenizeShellWords(command) {
+    const tokens = [];
+    let token = "";
+    let quote;
+    let escaped = false;
+    let started = false;
+    for (const character of command.trim()) {
+        if (escaped) {
+            token += character;
+            escaped = false;
+            started = true;
+            continue;
+        }
+        if (character === "\\" && quote !== "'") {
+            escaped = true;
+            started = true;
+            continue;
+        }
+        if (quote) {
+            if (character === quote) {
+                quote = undefined;
+            }
+            else {
+                token += character;
+            }
+            started = true;
+            continue;
+        }
+        if (character === "'" || character === '"') {
+            quote = character;
+            started = true;
+            continue;
+        }
+        if (/\s/u.test(character)) {
+            if (started) {
+                tokens.push(token);
+                token = "";
+                started = false;
+            }
+            continue;
+        }
+        token += character;
+        started = true;
+    }
+    if (escaped || quote) {
+        return undefined;
+    }
+    if (started) {
+        tokens.push(token);
+    }
+    return tokens;
+}
+function readSettings(settingsPath) {
+    const stat = fs.lstatSync(settingsPath);
+    if (stat.isSymbolicLink()) {
+        throw new Error(`Refusing to replace symbolic-link Claude settings: ${settingsPath}`);
+    }
+    if (!stat.isFile()) {
+        throw new Error(`Claude settings path is not a regular file: ${settingsPath}`);
+    }
+    let value;
+    try {
+        value = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    }
+    catch {
+        throw new Error(`Claude settings JSON is invalid: ${settingsPath}`);
+    }
+    return requireObject(value, "Claude settings");
+}
+function createBackup(settingsPath, now) {
+    const date = now();
+    if (!(date instanceof Date) || !Number.isFinite(date.getTime())) {
+        throw new Error("Claude hook installer clock returned an invalid date");
+    }
+    const timestamp = date.toISOString().replace(/[:.]/gu, "-");
+    let suffix = 0;
+    while (true) {
+        const candidate = `${settingsPath}.bak.${timestamp}${suffix === 0 ? "" : `.${suffix}`}`;
+        let descriptor;
+        try {
+            descriptor = fs.openSync(candidate, "wx", 0o600);
+            fs.writeFileSync(descriptor, fs.readFileSync(settingsPath));
+            fs.fsyncSync(descriptor);
+            fs.closeSync(descriptor);
+            descriptor = undefined;
+            return candidate;
+        }
+        catch (error) {
+            if (descriptor !== undefined) {
+                fs.closeSync(descriptor);
+                fs.rmSync(candidate, { force: true });
+            }
+            if (isFileExistsError(error)) {
+                suffix += 1;
+                continue;
+            }
+            throw error;
+        }
+    }
+}
+function atomicWriteJson(filePath, value) {
+    const parentDirectory = path.dirname(filePath);
+    const temporaryPath = `${filePath}.${process.pid}.${randomBytes(8).toString("hex")}.tmp`;
+    let descriptor;
+    try {
+        descriptor = fs.openSync(temporaryPath, "wx", 0o600);
+        fs.writeFileSync(descriptor, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+        fs.fsyncSync(descriptor);
+        fs.closeSync(descriptor);
+        descriptor = undefined;
+        fs.renameSync(temporaryPath, filePath);
+        fs.chmodSync(filePath, 0o600);
+        fsyncDirectory(parentDirectory);
+    }
+    finally {
+        if (descriptor !== undefined) {
+            fs.closeSync(descriptor);
+        }
+        fs.rmSync(temporaryPath, { force: true });
+    }
+}
+function fsyncDirectory(directoryPath) {
+    let descriptor;
+    try {
+        descriptor = fs.openSync(directoryPath, "r");
+        fs.fsyncSync(descriptor);
+    }
+    catch {
+        // Some filesystems do not support syncing directories. The rename is
+        // still atomic, and the original settings remain available as a backup.
+    }
+    finally {
+        if (descriptor !== undefined) {
+            fs.closeSync(descriptor);
+        }
+    }
+}
+function requireAbsoluteExecutable(value) {
+    if (typeof value !== "string" || value.trim().length === 0 || value.includes("\0")) {
+        throw new Error("Claude hook executable path must be a non-empty absolute path");
+    }
+    if (!path.isAbsolute(value)) {
+        throw new Error("Claude hook executable path must be absolute");
+    }
+    return path.normalize(value);
+}
+function requireObject(value, label) {
+    if (!isObject(value)) {
+        throw new Error(`${label} must be a JSON object`);
+    }
+    return value;
+}
+function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isFileExistsError(error) {
+    return isObject(error) && error.code === "EEXIST";
+}
+//# sourceMappingURL=claude-hook-installer.js.map

package/dist/src/claude-hook-installer.js.map

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

package/dist/src/claude-hook-protocol.d.ts

@@ -0,0 +1,89 @@
+export type ClaudeHookEventName = "SessionStart" | "UserPromptSubmit" | "PermissionRequest" | "Stop" | "StopFailure" | "Notification";
+export type ClaudeJsonValue = null | boolean | number | string | ClaudeJsonValue[] | {
+    [key: string]: ClaudeJsonValue;
+};
+export type ClaudeJsonObject = {
+    [key: string]: ClaudeJsonValue;
+};
+export interface ClaudeHookInputBase {
+    session_id: string;
+    transcript_path: string;
+    cwd: string;
+    permission_mode?: string;
+    effort?: ClaudeJsonValue;
+    agent_id?: string;
+    agent_type?: string;
+    /** Present in recent Claude Code hook payloads and useful for exact turn correlation. */
+    prompt_id?: string;
+}
+export interface ClaudeSessionStartHookInput extends ClaudeHookInputBase {
+    hook_event_name: "SessionStart";
+    source: "startup" | "resume" | "clear" | "compact" | "fork";
+    model?: string;
+}
+export interface ClaudeUserPromptSubmitHookInput extends ClaudeHookInputBase {
+    hook_event_name: "UserPromptSubmit";
+    prompt: string;
+}
+export interface ClaudePermissionRequestHookInput extends ClaudeHookInputBase {
+    hook_event_name: "PermissionRequest";
+    tool_name: string;
+    tool_input: ClaudeJsonValue;
+    permission_suggestions?: ClaudeJsonValue[];
+}
+export interface ClaudeBackgroundTaskSummary extends ClaudeJsonObject {
+    id: string;
+    type: string;
+    status: string;
+    description: string;
+}
+export interface ClaudeSessionCronSummary extends ClaudeJsonObject {
+    id: string;
+    schedule: string;
+    recurring: boolean;
+    prompt: string;
+}
+export interface ClaudeStopHookInput extends ClaudeHookInputBase {
+    hook_event_name: "Stop";
+    stop_hook_active: boolean;
+    last_assistant_message?: string;
+    /** Undefined is intentionally distinct from an observed empty array. */
+    background_tasks?: ClaudeBackgroundTaskSummary[];
+    /** Undefined is intentionally distinct from an observed empty array. */
+    session_crons?: ClaudeSessionCronSummary[];
+}
+export type ClaudeStopFailureCode = "rate_limit" | "authentication_failed" | "oauth_org_not_allowed" | "billing_error" | "invalid_request" | "model_not_found" | "server_error" | "max_output_tokens" | "unknown";
+export interface ClaudeStopFailureHookInput extends ClaudeHookInputBase {
+    hook_event_name: "StopFailure";
+    error: ClaudeStopFailureCode;
+    error_details?: ClaudeJsonValue;
+    last_assistant_message?: string;
+}
+export interface ClaudeNotificationHookInput extends ClaudeHookInputBase {
+    hook_event_name: "Notification";
+    message: string;
+    title?: string;
+    notification_type: string;
+}
+export type ClaudeHookInput = ClaudeSessionStartHookInput | ClaudeUserPromptSubmitHookInput | ClaudePermissionRequestHookInput | ClaudeStopHookInput | ClaudeStopFailureHookInput | ClaudeNotificationHookInput;
+export type ClaudePermissionBehavior = "allow" | "deny";
+export type ClaudePermissionHookOutput = {
+    hookSpecificOutput: {
+        hookEventName: "PermissionRequest";
+        decision: {
+            behavior: "allow";
+        } | {
+            behavior: "deny";
+            message: string;
+            interrupt?: boolean;
+        };
+    };
+};
+export declare function parseClaudeHookInput(value: unknown): ClaudeHookInput;
+export declare function canonicalClaudePermissionFingerprint(input: ClaudePermissionRequestHookInput): string;
+export declare function claudePermissionHookOutput(decision: {
+    behavior: ClaudePermissionBehavior;
+    interrupt?: boolean;
+    message?: string;
+}): ClaudePermissionHookOutput;
+export declare function canonicalJson(value: ClaudeJsonValue): string;