@webpieces/hook-runtime 0.0.1

package/src/protocol.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentHookEvent = exports.FileOperation = exports.NormalizedBashInput = exports.NormalizedToolInput = exports.NormalizedEdit = exports.AI_TYPE_UNKNOWN = exports.AI_TYPES = void 0;
+exports.AI_TYPES = ['claude-code', 'codex'];
+exports.AI_TYPE_UNKNOWN = 'unknown';
+class NormalizedEdit {
+    oldString;
+    newString;
+    constructor(oldString, newString) { this.oldString = oldString; this.newString = newString; }
+}
+exports.NormalizedEdit = NormalizedEdit;
+class NormalizedToolInput {
+    filePath;
+    edits;
+    constructor(filePath, edits) { this.filePath = filePath; this.edits = edits; }
+}
+exports.NormalizedToolInput = NormalizedToolInput;
+class NormalizedBashInput {
+    command;
+    constructor(command) { this.command = command; }
+}
+exports.NormalizedBashInput = NormalizedBashInput;
+class FileOperation {
+    toolKind;
+    input;
+    constructor(toolKind, input) { this.toolKind = toolKind; this.input = input; }
+}
+exports.FileOperation = FileOperation;
+/** One normalized hook event, independent of the source harness and rule product. */
+class AgentHookEvent {
+    aiType;
+    kind;
+    rawToolName;
+    cwd;
+    sessionId;
+    agentId;
+    agentType;
+    files;
+    bash;
+    reads;
+    constructor(aiType, kind, rawToolName, cwd, sessionId, agentId, agentType, files, bash, reads) {
+        this.aiType = aiType;
+        this.kind = kind;
+        this.rawToolName = rawToolName;
+        this.cwd = cwd;
+        this.sessionId = sessionId;
+        this.agentId = agentId;
+        this.agentType = agentType;
+        this.files = files;
+        this.bash = bash;
+        this.reads = reads;
+    }
+}
+exports.AgentHookEvent = AgentHookEvent;
+//# sourceMappingURL=protocol.js.map

package/src/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../../../packages/tooling/hook-runtime/src/protocol.ts"],"names":[],"mappings":";;;AAEa,QAAA,QAAQ,GAAsB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACvD,QAAA,eAAe,GAAG,SAAS,CAAC;AAKzC,MAAa,cAAc;IACd,SAAS,CAAS;IAClB,SAAS,CAAS;IAC3B,YAAY,SAAiB,EAAE,SAAiB,IAAI,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;CAChH;AAJD,wCAIC;AAED,MAAa,mBAAmB;IACnB,QAAQ,CAAS;IACjB,KAAK,CAA4B;IAC1C,YAAY,QAAgB,EAAE,KAAgC,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;CACpH;AAJD,kDAIC;AAED,MAAa,mBAAmB;IACnB,OAAO,CAAS;IACzB,YAAY,OAAe,IAAI,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAC3D;AAHD,kDAGC;AAED,MAAa,aAAa;IACb,QAAQ,CAAW;IACnB,KAAK,CAAsB;IACpC,YAAY,QAAkB,EAAE,KAA0B,IAAI,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;CAChH;AAJD,sCAIC;AAED,qFAAqF;AACrF,MAAa,cAAc;IACd,MAAM,CAAS;IACf,IAAI,CAAiB;IACrB,WAAW,CAAS;IACpB,GAAG,CAAS;IACZ,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,KAAK,CAA2B;IAChC,IAAI,CAA6B;IACjC,KAAK,CAAoB;IAElC,YACI,MAAc,EAAE,IAAoB,EAAE,WAAmB,EAAE,GAAW,EAAE,SAAiB,EACzF,OAAe,EAAE,SAAiB,EAAE,KAA+B,EACnE,IAAgC,EAAE,KAAwB;QAE1D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;CACJ;AA5BD,wCA4BC","sourcesContent":["/** Coding harness that produced an agent-hook call. */\nexport type AiType = 'claude-code' | 'codex';\nexport const AI_TYPES: readonly AiType[] = ['claude-code', 'codex'];\nexport const AI_TYPE_UNKNOWN = 'unknown';\nexport type HookMode = 'rules' | 'guards' | 'all';\nexport type ToolKind = 'Write' | 'Edit' | 'MultiEdit' | 'Read' | 'Delete';\nexport type AgentEventKind = 'File' | 'Bash' | 'Read' | 'Ignored';\n\nexport class NormalizedEdit {\n    readonly oldString: string;\n    readonly newString: string;\n    constructor(oldString: string, newString: string) { this.oldString = oldString; this.newString = newString; }\n}\n\nexport class NormalizedToolInput {\n    readonly filePath: string;\n    readonly edits: readonly NormalizedEdit[];\n    constructor(filePath: string, edits: readonly NormalizedEdit[]) { this.filePath = filePath; this.edits = edits; }\n}\n\nexport class NormalizedBashInput {\n    readonly command: string;\n    constructor(command: string) { this.command = command; }\n}\n\nexport class FileOperation {\n    readonly toolKind: ToolKind;\n    readonly input: NormalizedToolInput;\n    constructor(toolKind: ToolKind, input: NormalizedToolInput) { this.toolKind = toolKind; this.input = input; }\n}\n\n/** One normalized hook event, independent of the source harness and rule product. */\nexport class AgentHookEvent {\n    readonly aiType: AiType;\n    readonly kind: AgentEventKind;\n    readonly rawToolName: string;\n    readonly cwd: string;\n    readonly sessionId: string;\n    readonly agentId: string;\n    readonly agentType: string;\n    readonly files: readonly FileOperation[];\n    readonly bash: NormalizedBashInput | null;\n    readonly reads: readonly string[];\n\n    constructor(\n        aiType: AiType, kind: AgentEventKind, rawToolName: string, cwd: string, sessionId: string,\n        agentId: string, agentType: string, files: readonly FileOperation[],\n        bash: NormalizedBashInput | null, reads: readonly string[],\n    ) {\n        this.aiType = aiType;\n        this.kind = kind;\n        this.rawToolName = rawToolName;\n        this.cwd = cwd;\n        this.sessionId = sessionId;\n        this.agentId = agentId;\n        this.agentType = agentType;\n        this.files = files;\n        this.bash = bash;\n        this.reads = reads;\n    }\n}\n"]}

package/src/response.d.ts

@@ -0,0 +1,2 @@
+import { AgentHookEvent } from './protocol';
+export declare function denyJson(event: AgentHookEvent | null, reason: string): string;

package/src/response.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.denyJson = denyJson;
+const ESC = String.fromCharCode(0x1b);
+// webpieces-disable no-function-outside-class -- private wire-format helper at the protocol boundary.
+function redSystemMessage(reason) {
+    const nl = reason.indexOf('\n');
+    if (nl < 0)
+        return `${ESC}[31;1m🛑 ${reason}${ESC}[0m`;
+    return `${ESC}[31;1m🛑 ${reason.slice(0, nl)}${ESC}[0m${reason.slice(nl)}`;
+}
+// webpieces-disable no-function-outside-class -- the shared PreToolUse wire format.
+function denyJson(event, reason) {
+    const safe = reason.trim() === '' ? '[ai-hooks] blocked, but the guard produced no reason — failing closed.' : reason;
+    const hookSpecificOutput = { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: safe };
+    if (event !== null && event.kind === 'Bash') {
+        return JSON.stringify({ systemMessage: redSystemMessage(safe), hookSpecificOutput });
+    }
+    return JSON.stringify({ hookSpecificOutput });
+}
+//# sourceMappingURL=response.js.map

package/src/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../../packages/tooling/hook-runtime/src/response.ts"],"names":[],"mappings":";;AAYA,4BAOC;AAjBD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAEtC,sGAAsG;AACtG,SAAS,gBAAgB,CAAC,MAAc;IACpC,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,GAAG,GAAG,YAAY,MAAM,GAAG,GAAG,KAAK,CAAC;IACvD,OAAO,GAAG,GAAG,YAAY,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,oFAAoF;AACpF,SAAgB,QAAQ,CAAC,KAA4B,EAAE,MAAc;IACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,wEAAwE,CAAC,CAAC,CAAC,MAAM,CAAC;IACtH,MAAM,kBAAkB,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,EAAE,wBAAwB,EAAE,IAAI,EAAE,CAAC;IACvH,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAClD,CAAC","sourcesContent":["import { AgentHookEvent } from './protocol';\n\nconst ESC = String.fromCharCode(0x1b);\n\n// webpieces-disable no-function-outside-class -- private wire-format helper at the protocol boundary.\nfunction redSystemMessage(reason: string): string {\n    const nl = reason.indexOf('\\n');\n    if (nl < 0) return `${ESC}[31;1m🛑 ${reason}${ESC}[0m`;\n    return `${ESC}[31;1m🛑 ${reason.slice(0, nl)}${ESC}[0m${reason.slice(nl)}`;\n}\n\n// webpieces-disable no-function-outside-class -- the shared PreToolUse wire format.\nexport function denyJson(event: AgentHookEvent | null, reason: string): string {\n    const safe = reason.trim() === '' ? '[ai-hooks] blocked, but the guard produced no reason — failing closed.' : reason;\n    const hookSpecificOutput = { hookEventName: 'PreToolUse', permissionDecision: 'deny', permissionDecisionReason: safe };\n    if (event !== null && event.kind === 'Bash') {\n        return JSON.stringify({ systemMessage: redSystemMessage(safe), hookSpecificOutput });\n    }\n    return JSON.stringify({ hookSpecificOutput });\n}\n"]}

package/src/to-error.d.ts

@@ -0,0 +1 @@
+export declare function toError(err: unknown): Error;

package/src/to-error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toError = toError;
+// webpieces-disable no-any-unknown -- thrown values are unknown by construction; this boundary narrows them to Error.
+// webpieces-disable no-function-outside-class -- dependency-free exception normalizer used before/without DI at the process boundary.
+function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+//# sourceMappingURL=to-error.js.map

package/src/to-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-error.js","sourceRoot":"","sources":["../../../../../packages/tooling/hook-runtime/src/to-error.ts"],"names":[],"mappings":";;AAEA,0BAEC;AAJD,sHAAsH;AACtH,sIAAsI;AACtI,SAAgB,OAAO,CAAC,GAAY;IAChC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["// webpieces-disable no-any-unknown -- thrown values are unknown by construction; this boundary narrows them to Error.\n// webpieces-disable no-function-outside-class -- dependency-free exception normalizer used before/without DI at the process boundary.\nexport function toError(err: unknown): Error {\n    return err instanceof Error ? err : new Error(String(err));\n}\n"]}