@mauribadnights/clooks 0.1.0 → 0.2.0

package/dist/types.d.ts

@@ -14,34 +14,77 @@ export interface HookInput {
     stop_hook_active?: boolean;
     [key: string]: unknown;
 }
-/** Handler types in manifest */
-export type HandlerType = 'script' | 'inline';
-/** Configuration for a single handler */
-export interface HandlerConfig {
+/** Supported LLM models */
+export type LLMModel = 'claude-haiku-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6';
+/** Handler types — extended with 'llm' */
+export type HandlerType = 'script' | 'inline' | 'llm';
+/** LLM-specific handler config fields */
+export interface LLMHandlerConfig {
     id: string;
-    type: HandlerType;
-    command?: string;
-    module?: string;
+    type: 'llm';
+    model: LLMModel;
+    prompt: string;
+    batchGroup?: string;
+    maxTokens?: number;
+    temperature?: number;
+    filter?: string;
     timeout?: number;
     enabled?: boolean;
 }
-/** The full manifest structure */
+/** Script handler config */
+export interface ScriptHandlerConfig {
+    id: string;
+    type: 'script';
+    command: string;
+    filter?: string;
+    timeout?: number;
+    enabled?: boolean;
+}
+/** Inline handler config */
+export interface InlineHandlerConfig {
+    id: string;
+    type: 'inline';
+    module: string;
+    filter?: string;
+    timeout?: number;
+    enabled?: boolean;
+}
+/** Union of all handler configs */
+export type HandlerConfig = ScriptHandlerConfig | InlineHandlerConfig | LLMHandlerConfig;
+/** Prefetchable context keys */
+export type PrefetchKey = 'transcript' | 'git_status' | 'git_diff';
+/** Pre-fetched context data */
+export interface PrefetchContext {
+    transcript?: string;
+    git_status?: string;
+    git_diff?: string;
+}
+/** Extended manifest with prefetch and LLM settings */
 export interface Manifest {
     handlers: Partial<Record<HookEvent, HandlerConfig[]>>;
+    prefetch?: PrefetchKey[];
     settings?: {
         port?: number;
         logLevel?: 'debug' | 'info' | 'warn' | 'error';
+        anthropicApiKey?: string;
     };
 }
-/** Result from executing a single handler */
-export interface HandlerResult {
-    id: string;
-    ok: boolean;
-    output?: unknown;
-    error?: string;
-    duration_ms: number;
+/** Token usage from API response */
+export interface TokenUsage {
+    input_tokens: number;
+    output_tokens: number;
 }
-/** A single metrics entry */
+/** Cost entry for tracking */
+export interface CostEntry {
+    ts: string;
+    event: HookEvent;
+    handler: string;
+    model: LLMModel;
+    usage: TokenUsage;
+    cost_usd: number;
+    batched: boolean;
+}
+/** Extended metrics entry with optional cost fields */
 export interface MetricEntry {
     ts: string;
     event: HookEvent;
@@ -49,6 +92,20 @@ export interface MetricEntry {
     duration_ms: number;
     ok: boolean;
     error?: string;
+    filtered?: boolean;
+    usage?: TokenUsage;
+    cost_usd?: number;
+}
+/** Extended handler result with cost info */
+export interface HandlerResult {
+    id: string;
+    ok: boolean;
+    output?: unknown;
+    error?: string;
+    duration_ms: number;
+    filtered?: boolean;
+    usage?: TokenUsage;
+    cost_usd?: number;
 }
 /** Runtime state for tracking consecutive failures */
 export interface HandlerState {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mauribadnights/clooks",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Persistent hook runtime for Claude Code — eliminates process spawning overhead and gives you observability",
   "bin": {
     "clooks": "./dist/cli.js"
@@ -11,7 +11,8 @@
     "build": "tsc",
     "dev": "tsc --watch",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "bench": "npx tsx benchmarks/bench.ts"
   },
   "license": "MIT",
   "author": "mauribadnights",
@@ -38,8 +39,17 @@
     "commander": "^14.0.3",
     "yaml": "^2.8.3"
   },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.30.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.1"
   }