@scotthuang/agent-knock-knock 0.2.44 → 0.2.47

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

@@ -0,0 +1,243 @@
+import { createHash } from "node:crypto";
+export function parseClaudeHookInput(value) {
+    const input = requireObject(value, "Claude hook input");
+    const common = parseCommonInput(input);
+    const hookEventName = requireString(input.hook_event_name, "hook_event_name");
+    switch (hookEventName) {
+        case "SessionStart": {
+            const source = requireString(input.source, "source");
+            if (source !== "startup" && source !== "resume" && source !== "clear" && source !== "compact" && source !== "fork") {
+                throw new Error(`unsupported Claude SessionStart source: ${source}`);
+            }
+            return {
+                ...common,
+                hook_event_name: hookEventName,
+                source,
+                ...optionalStringProperty(input, "model")
+            };
+        }
+        case "UserPromptSubmit":
+            return {
+                ...common,
+                hook_event_name: hookEventName,
+                prompt: requireString(input.prompt, "prompt", { allowEmpty: true })
+            };
+        case "PermissionRequest":
+            return {
+                ...common,
+                hook_event_name: hookEventName,
+                tool_name: requireString(input.tool_name, "tool_name"),
+                tool_input: requireJsonValue(input.tool_input, "tool_input"),
+                ...optionalJsonArrayProperty(input, "permission_suggestions")
+            };
+        case "Stop":
+            return {
+                ...common,
+                hook_event_name: hookEventName,
+                stop_hook_active: requireBoolean(input.stop_hook_active, "stop_hook_active"),
+                ...optionalStringProperty(input, "last_assistant_message", { allowEmpty: true }),
+                ...optionalBackgroundTasksProperty(input),
+                ...optionalSessionCronsProperty(input)
+            };
+        case "StopFailure": {
+            const error = requireString(input.error, "error");
+            if (!CLAUDE_STOP_FAILURE_CODES.has(error)) {
+                throw new Error(`unsupported Claude StopFailure error: ${error}`);
+            }
+            return {
+                ...common,
+                hook_event_name: hookEventName,
+                error,
+                ...optionalJsonProperty(input, "error_details"),
+                ...optionalStringProperty(input, "last_assistant_message", { allowEmpty: true })
+            };
+        }
+        case "Notification":
+            return {
+                ...common,
+                hook_event_name: hookEventName,
+                message: requireString(input.message, "message", { allowEmpty: true }),
+                notification_type: requireString(input.notification_type, "notification_type"),
+                ...optionalStringProperty(input, "title", { allowEmpty: true })
+            };
+        default:
+            throw new Error(`unsupported Claude hook event: ${hookEventName}`);
+    }
+}
+export function canonicalClaudePermissionFingerprint(input) {
+    return createHash("sha256")
+        .update(canonicalJson({
+        version: 1,
+        session_id: input.session_id,
+        cwd: input.cwd,
+        permission_mode: input.permission_mode ?? null,
+        tool_name: input.tool_name,
+        tool_input: input.tool_input
+    }))
+        .digest("hex");
+}
+export function claudePermissionHookOutput(decision) {
+    return decision.behavior === "allow"
+        ? {
+            hookSpecificOutput: {
+                hookEventName: "PermissionRequest",
+                decision: { behavior: "allow" }
+            }
+        }
+        : {
+            hookSpecificOutput: {
+                hookEventName: "PermissionRequest",
+                decision: {
+                    behavior: "deny",
+                    message: decision.message ?? "Denied by Agent Knock Knock.",
+                    ...(decision.interrupt === undefined ? {} : { interrupt: decision.interrupt })
+                }
+            }
+        };
+}
+export function canonicalJson(value) {
+    if (value === null || typeof value === "boolean" || typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("canonical JSON does not support non-finite numbers");
+        }
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => canonicalJson(entry)).join(",")}]`;
+    }
+    return `{${Object.keys(value)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`)
+        .join(",")}}`;
+}
+function parseCommonInput(input) {
+    return {
+        session_id: requireString(input.session_id, "session_id"),
+        transcript_path: requireString(input.transcript_path, "transcript_path"),
+        cwd: requireString(input.cwd, "cwd"),
+        ...optionalStringProperty(input, "permission_mode"),
+        ...optionalJsonProperty(input, "effort"),
+        ...optionalStringProperty(input, "agent_id"),
+        ...optionalStringProperty(input, "agent_type"),
+        ...optionalStringProperty(input, "prompt_id")
+    };
+}
+const CLAUDE_STOP_FAILURE_CODES = new Set([
+    "rate_limit",
+    "authentication_failed",
+    "oauth_org_not_allowed",
+    "billing_error",
+    "invalid_request",
+    "model_not_found",
+    "server_error",
+    "max_output_tokens",
+    "unknown"
+]);
+function requireObject(value, field) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${field} must be an object`);
+    }
+    return value;
+}
+function requireString(value, field, options = {}) {
+    if (typeof value !== "string" || (!options.allowEmpty && value.trim().length === 0)) {
+        throw new Error(`${field} must be ${options.allowEmpty ? "a string" : "a non-empty string"}`);
+    }
+    return value;
+}
+function requireBoolean(value, field) {
+    if (typeof value !== "boolean") {
+        throw new Error(`${field} must be a boolean`);
+    }
+    return value;
+}
+function requireJsonValue(value, field) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error(`${field} must contain only finite JSON numbers`);
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry, index) => requireJsonValue(entry, `${field}[${index}]`));
+    }
+    if (value && typeof value === "object") {
+        const result = {};
+        for (const [key, entry] of Object.entries(value)) {
+            result[key] = requireJsonValue(entry, `${field}.${key}`);
+        }
+        return result;
+    }
+    throw new Error(`${field} must be valid JSON`);
+}
+function optionalStringProperty(input, key, options = {}) {
+    return input[key] === undefined ? {} : { [key]: requireString(input[key], key, options) };
+}
+function optionalJsonProperty(input, key) {
+    return input[key] === undefined ? {} : { [key]: requireJsonValue(input[key], key) };
+}
+function optionalJsonArrayProperty(input, key) {
+    if (input[key] === undefined) {
+        return {};
+    }
+    if (!Array.isArray(input[key])) {
+        throw new Error(`${key} must be an array`);
+    }
+    return { [key]: input[key].map((entry, index) => requireJsonValue(entry, `${key}[${index}]`)) };
+}
+function optionalObjectArrayProperty(input, key) {
+    if (input[key] === undefined) {
+        return {};
+    }
+    if (!Array.isArray(input[key])) {
+        throw new Error(`${key} must be an array`);
+    }
+    return {
+        [key]: input[key].map((entry, index) => {
+            const parsed = requireJsonValue(entry, `${key}[${index}]`);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+                throw new Error(`${key}[${index}] must be an object`);
+            }
+            return parsed;
+        })
+    };
+}
+function optionalBackgroundTasksProperty(input) {
+    const objects = optionalObjectArrayProperty(input, "background_tasks").background_tasks;
+    if (!objects) {
+        return {};
+    }
+    return {
+        background_tasks: objects.map((entry, index) => ({
+            ...entry,
+            id: requireString(entry.id, `background_tasks[${index}].id`),
+            type: requireString(entry.type, `background_tasks[${index}].type`),
+            status: requireString(entry.status, `background_tasks[${index}].status`),
+            description: requireString(entry.description, `background_tasks[${index}].description`, {
+                allowEmpty: true
+            })
+        }))
+    };
+}
+function optionalSessionCronsProperty(input) {
+    const objects = optionalObjectArrayProperty(input, "session_crons").session_crons;
+    if (!objects) {
+        return {};
+    }
+    return {
+        session_crons: objects.map((entry, index) => ({
+            ...entry,
+            id: requireString(entry.id, `session_crons[${index}].id`),
+            schedule: requireString(entry.schedule, `session_crons[${index}].schedule`),
+            recurring: requireBoolean(entry.recurring, `session_crons[${index}].recurring`),
+            prompt: requireString(entry.prompt, `session_crons[${index}].prompt`, { allowEmpty: true })
+        }))
+    };
+}
+//# sourceMappingURL=claude-hook-protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-hook-protocol.js","sourceRoot":"","sources":["../../src/claude-hook-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAsHzC,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;IAE9E,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACnH,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,OAAO;gBACL,GAAG,MAAM;gBACT,eAAe,EAAE,aAAa;gBAC9B,MAAM;gBACN,GAAG,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC;aAC1C,CAAC;QACJ,CAAC;QACD,KAAK,kBAAkB;YACrB,OAAO;gBACL,GAAG,MAAM;gBACT,eAAe,EAAE,aAAa;gBAC9B,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;aACpE,CAAC;QACJ,KAAK,mBAAmB;YACtB,OAAO;gBACL,GAAG,MAAM;gBACT,eAAe,EAAE,aAAa;gBAC9B,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC;gBACtD,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC;gBAC5D,GAAG,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,CAAC;aAC9D,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,GAAG,MAAM;gBACT,eAAe,EAAE,aAAa;gBAC9B,gBAAgB,EAAE,cAAc,CAAC,KAAK,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;gBAC5E,GAAG,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBAChF,GAAG,+BAA+B,CAAC,KAAK,CAAC;gBACzC,GAAG,4BAA4B,CAAC,KAAK,CAAC;aACvC,CAAC;QACJ,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAA0B,CAAC;YAC3E,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,yCAAyC,KAAK,EAAE,CAAC,CAAC;YACpE,CAAC;YACD,OAAO;gBACL,GAAG,MAAM;gBACT,eAAe,EAAE,aAAa;gBAC9B,KAAK;gBACL,GAAG,oBAAoB,CAAC,KAAK,EAAE,eAAe,CAAC;gBAC/C,GAAG,sBAAsB,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;aACjF,CAAC;QACJ,CAAC;QACD,KAAK,cAAc;YACjB,OAAO;gBACL,GAAG,MAAM;gBACT,eAAe,EAAE,aAAa;gBAC9B,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;gBACtE,iBAAiB,EAAE,aAAa,CAAC,KAAK,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;gBAC9E,GAAG,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;aAChE,CAAC;QACJ;YACE,MAAM,IAAI,KAAK,CAAC,kCAAkC,aAAa,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,KAAuC;IAEvC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;QAC9C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;SACF,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAuF;IAEvF,OAAO,QAAQ,CAAC,QAAQ,KAAK,OAAO;QAClC,CAAC,CAAC;YACE,kBAAkB,EAAE;gBAClB,aAAa,EAAE,mBAAmB;gBAClC,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;aAChC;SACF;QACH,CAAC,CAAC;YACE,kBAAkB,EAAE;gBAClB,aAAa,EAAE,mBAAmB;gBAClC,QAAQ,EAAE;oBACR,QAAQ,EAAE,MAAM;oBAChB,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,8BAA8B;oBAC3D,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;iBAC/E;aACF;SACF,CAAC;AACR,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAsB;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;SAC1B,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;SACnE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA8B;IACtD,OAAO;QACL,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC;QACzD,eAAe,EAAE,aAAa,CAAC,KAAK,CAAC,eAAe,EAAE,iBAAiB,CAAC;QACxE,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC;QACpC,GAAG,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,CAAC;QACnD,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC;QACxC,GAAG,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC;QAC5C,GAAG,sBAAsB,CAAC,KAAK,EAAE,YAAY,CAAC;QAC9C,GAAG,sBAAsB,CAAC,KAAK,EAAE,WAAW,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAwB;IAC/D,YAAY;IACZ,uBAAuB;IACvB,uBAAuB;IACvB,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,cAAc;IACd,mBAAmB;IACnB,SAAS;CACV,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,KAAc,EAAE,KAAa;IAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,KAAa,EACb,UAAoC,EAAE;IAEtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,KAAc,EAAE,KAAa;IACnD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAAa;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wCAAwC,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAA8B,EAC9B,GAAW,EACX,UAAoC,EAAE;IAEtC,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA8B,EAC9B,GAAW;IAEX,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,yBAAyB,CAChC,KAA8B,EAC9B,GAAW;IAEX,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AAClG,CAAC;AAED,SAAS,2BAA2B,CAClC,KAA8B,EAC9B,GAAW;IAEX,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,mBAAmB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO;QACL,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,KAAK,qBAAqB,CAAC,CAAC;YACxD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,KAA8B;IAE9B,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,gBAAgB,CAAC;IACxF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/C,GAAG,KAAK;YACR,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,oBAAoB,KAAK,MAAM,CAAC;YAC5D,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,oBAAoB,KAAK,QAAQ,CAAC;YAClE,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,oBAAoB,KAAK,UAAU,CAAC;YACxE,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,oBAAoB,KAAK,eAAe,EAAE;gBACtF,UAAU,EAAE,IAAI;aACjB,CAAC;SACH,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,KAA8B;IAE9B,MAAM,OAAO,GAAG,2BAA2B,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,aAAa,CAAC;IAClF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5C,GAAG,KAAK;YACR,EAAE,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,iBAAiB,KAAK,MAAM,CAAC;YACzD,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,KAAK,YAAY,CAAC;YAC3E,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,iBAAiB,KAAK,aAAa,CAAC;YAC/E,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,KAAK,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;SAC5F,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,247 @@
+import { type ClaudeHookInput, type ClaudePermissionBehavior, type ClaudePermissionHookOutput, type ClaudePermissionRequestHookInput, type ClaudeStopFailureHookInput } from "./claude-hook-protocol.js";
+declare const STORE_SCHEMA_VERSION = 1;
+export type ClaudeHookStoreErrorCode = "INVALID_INPUT" | "SESSION_NOT_FOUND" | "SESSION_IDENTITY_MISMATCH" | "AMBIGUOUS_SESSION" | "PERMISSION_NOT_FOUND" | "PERMISSION_EXPIRED" | "PERMISSION_CONSUMED" | "PERMISSION_ALREADY_DECIDED" | "PERMISSION_FINGERPRINT_MISMATCH" | "AMBIGUOUS_PERMISSION" | "CORRUPT_STORE" | "LOCK_TIMEOUT";
+export declare class ClaudeHookStoreError extends Error {
+    readonly code: ClaudeHookStoreErrorCode;
+    constructor(code: ClaudeHookStoreErrorCode, message: string);
+}
+export interface ClaudeStoredHookEvent {
+    id: string;
+    received_at: string;
+    claude_pid?: number;
+    turn_id?: string;
+    lease_id?: string;
+    conversation_id?: string;
+    message_id?: string;
+    input: ClaudeHookInput;
+}
+export interface ClaudeStoredPermissionDecision {
+    behavior: ClaudePermissionBehavior;
+    interrupt?: boolean;
+    decided_at: string;
+}
+export interface ClaudePendingPermission {
+    requestId: string;
+    nonce: string;
+    fingerprint: string;
+    eventId: string;
+    turnId?: string;
+    sessionId: string;
+    leaseId: string;
+    leaseMatchedBy: "session" | "pid";
+    claudePid?: number;
+    terminalTarget: string;
+    conversationId: string;
+    messageId: string;
+    cwd: string;
+    toolName: string;
+    toolInput: ClaudePermissionRequestHookInput["tool_input"];
+    createdAt: string;
+    expiresAt: string;
+    decision?: ClaudeStoredPermissionDecision;
+    consumedAt?: string;
+}
+export interface ClaudeHookSession {
+    schema_version: typeof STORE_SCHEMA_VERSION;
+    session_id: string;
+    cwd: string;
+    transcript_path: string;
+    claude_pid?: number;
+    created_at: string;
+    updated_at: string;
+    active_turn_id?: string;
+    events: ClaudeStoredHookEvent[];
+    permissions: ClaudePendingPermission[];
+}
+export interface ClaudeHookStoreOptions {
+    rootDir?: string;
+    now?: () => Date;
+    sleep?: (milliseconds: number) => Promise<void>;
+    permissionLeaseMs?: number;
+    randomId?: () => string;
+}
+export interface ClaudeHookRecordOptions {
+    claudePid?: number;
+    permissionLeaseMs?: number;
+}
+export interface ClaudeHookRecordResult {
+    event: ClaudeStoredHookEvent;
+    session: ClaudeHookSession;
+    permission?: ClaudePendingPermission;
+    managed: boolean;
+    lease?: ClaudeManagedLeaseResolution;
+}
+export interface ClaudeSessionIdentity {
+    sessionId?: string;
+    pid?: number;
+    cwd?: string;
+    requireUnique?: boolean;
+}
+export interface ActivateClaudeManagedLeaseOptions {
+    sessionId?: string;
+    pid?: number;
+    cwd: string;
+    conversationId: string;
+    messageId: string;
+    terminalTarget: string;
+    expiresAt?: string | Date;
+}
+export interface ClaudeManagedLease {
+    id: string;
+    sessionId?: string;
+    pid?: number;
+    cwd: string;
+    conversationId: string;
+    messageId: string;
+    terminalTarget: string;
+    createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+    releasedAt?: string;
+}
+export interface ClaudeManagedLeaseResolution {
+    lease: ClaudeManagedLease;
+    matchedBy: "session" | "pid" | "cwd";
+    authorizationEligible: boolean;
+}
+export interface ReleaseClaudeManagedLeaseOptions {
+    leaseId?: string;
+    conversationId?: string;
+    messageId?: string;
+}
+export type ClaudePermissionInspection = {
+    blocked: false;
+    approvable: false;
+    reason: string;
+} | {
+    blocked: true;
+    approvable: false;
+    reason: string;
+    requestId?: string;
+    fingerprint?: string;
+    expiresAt?: string;
+    cwd?: string;
+    sessionId?: string;
+    conversationId?: string;
+    messageId?: string;
+} | {
+    blocked: true;
+    approvable: true;
+    reason: string;
+    requestId: string;
+    fingerprint: string;
+    expiresAt: string;
+    eventId: string;
+    sessionId: string;
+    leaseId: string;
+    conversationId: string;
+    messageId: string;
+    cwd: string;
+    toolName: string;
+    toolInput: ClaudePermissionRequestHookInput["tool_input"];
+    kind: "run_command" | "tool_permission";
+    promptKind: "run_command" | "tool_permission";
+    command?: string;
+};
+export interface DecideClaudePermissionOptions {
+    sessionId: string;
+    requestId: string;
+    fingerprint: string;
+    conversationId: string;
+    messageId: string;
+    decision: ClaudePermissionBehavior;
+    interrupt?: boolean;
+}
+export interface ConsumeClaudePermissionOptions {
+    sessionId: string;
+    requestId: string;
+    fingerprint: string;
+    conversationId: string;
+    messageId: string;
+}
+export interface WaitForClaudePermissionDecisionOptions extends ConsumeClaudePermissionOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export interface ClaudeConsumedPermissionDecision {
+    requestId: string;
+    fingerprint: string;
+    behavior: ClaudePermissionBehavior;
+    interrupt?: boolean;
+    decidedAt: string;
+    consumedAt: string;
+    hookOutput: ClaudePermissionHookOutput;
+}
+export interface DetectClaudeCompletionOptions extends ClaudeSessionIdentity {
+    startedAt: string | Date;
+    promptId?: string;
+    conversationId?: string;
+    messageId?: string;
+}
+export interface ClaudeStopFailure {
+    code: ClaudeStopFailureHookInput["error"];
+    details?: ClaudeStopFailureHookInput["error_details"];
+    message?: string;
+    eventId: string;
+    receivedAt: string;
+    promptId: string;
+}
+export type ClaudeCompletionInspection = {
+    status: "done";
+    reason: string;
+    sessionId: string;
+    promptId: string;
+    eventId: string;
+    timestamp: string;
+    text: string;
+    cwd: string;
+} | {
+    status: "failed";
+    reason: string;
+    sessionId: string;
+    promptId: string;
+    failure: ClaudeStopFailure;
+} | {
+    status: "pending" | "unknown";
+    reason: string;
+    sessionId?: string;
+    promptId?: string;
+};
+export declare function defaultClaudeHookStoreDir(): string;
+export declare class ClaudeHookStore {
+    readonly rootDir: string;
+    private readonly now;
+    private readonly sleep;
+    private readonly permissionLeaseMs;
+    private readonly randomId;
+    constructor(options?: ClaudeHookStoreOptions);
+    activateLease(options: ActivateClaudeManagedLeaseOptions): ClaudeManagedLease;
+    resolveLease(inputOrIdentity: ClaudeHookInput | ClaudeSessionIdentity): ClaudeManagedLeaseResolution | undefined;
+    releaseLease(options: ReleaseClaudeManagedLeaseOptions): ClaudeManagedLease | undefined;
+    record(inputValue: ClaudeHookInput | unknown, options?: ClaudeHookRecordOptions): ClaudeHookRecordResult;
+    resolveSession(identity: ClaudeSessionIdentity): ClaudeHookSession | undefined;
+    inspectPermission(identity: ClaudeSessionIdentity): ClaudePermissionInspection;
+    decidePermission(options: DecideClaudePermissionOptions): ClaudeStoredPermissionDecision;
+    consumePermissionDecision(options: ConsumeClaudePermissionOptions): ClaudeConsumedPermissionDecision | undefined;
+    waitForPermissionDecision(options: WaitForClaudePermissionDecisionOptions): Promise<ClaudeConsumedPermissionDecision | undefined>;
+    detectCompletion(options: DetectClaudeCompletionOptions): ClaudeCompletionInspection;
+    private createPendingPermission;
+    private resolveLeaseFrom;
+    private readLeases;
+    private writeLeases;
+    private withLeaseLock;
+    private validatePermissionLease;
+    private permissionLeaseRemaining;
+    private requireSession;
+    private readSessionById;
+    private readAllSessions;
+    private writeSession;
+    private withSessionLock;
+    private sessionPath;
+    private uniqueEventId;
+    private uniqueNonce;
+    private uniqueValue;
+    private nowDate;
+    private nowIso;
+}
+export {};