@agentplugins/core 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentplugins/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Core types, validation, and plugin registry for AgentPlugins",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,15 +9,12 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./adapter": {
+      "import": "./dist/adapter.js",
+      "types": "./dist/adapter.d.ts"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "clean": "rm -rf dist",
-    "test": "vitest",
-    "test:run": "vitest run __tests__/placeholder.test.ts"
-  },
   "files": [
     "dist",
     "README.md"
@@ -36,7 +33,15 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@types/node": "^20.0.0",
     "typescript": "^5.9.3",
     "vitest": "^3.1.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "test:run": "vitest run __tests__/placeholder.test.ts"
   }
-}
+}

package/dist/profiling-hof.d.ts

@@ -1,11 +0,0 @@
-import type { HookContext, HookResult } from './types.js';
-/**
- * Higher-order function that wraps an inline hook handler with timing instrumentation.
- *
- * @param handler - The inline hook handler to wrap
- * @param hookName - Name of the hook event (e.g. 'preToolUse')
- * @param platform - Platform identifier (e.g. 'opencode', 'pimono')
- * @returns The same handler, wrapped with timing and profiling
- */
-export declare function withTiming<T extends (ctx: HookContext) => Promise<HookResult>>(handler: T, hookName: string, platform: string): T;
-//# sourceMappingURL=profiling-hof.d.ts.map

package/dist/profiling-hof.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profiling-hof.d.ts","sourceRoot":"","sources":["../src/profiling-hof.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgB1D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,CAAC,SAAS,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,EACnD,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAqEnD"}

package/dist/profiling-hof.js

@@ -1,80 +0,0 @@
-import { createHookId, startTimer, emitProfilingEvent, shouldProfile, getProfilingOutput, } from './profiling.js';
-/**
- * Sequence counter for ordering profiling events within a session.
- * Incremented on each withTiming call.
- */
-let sequenceCounter = 0;
-/**
- * Higher-order function that wraps an inline hook handler with timing instrumentation.
- *
- * @param handler - The inline hook handler to wrap
- * @param hookName - Name of the hook event (e.g. 'preToolUse')
- * @param platform - Platform identifier (e.g. 'opencode', 'pimono')
- * @returns The same handler, wrapped with timing and profiling
- */
-export function withTiming(handler, hookName, platform) {
-    return (async (ctx) => {
-        // Inject timing fields into context before handler execution
-        const hookId = createHookId();
-        const timestamp = Date.now();
-        const getElapsed = startTimer();
-        ctx.timestamp = timestamp;
-        ctx.hookId = hookId;
-        let result;
-        let error;
-        try {
-            result = await handler(ctx);
-        }
-        catch (err) {
-            error = err instanceof Error ? err.message : String(err);
-            // Emit error profiling event when profiling is enabled
-            if (shouldProfile()) {
-                const event = {
-                    type: 'hook_invocation',
-                    hookName,
-                    hookId,
-                    sequenceId: ++sequenceCounter,
-                    timestamp,
-                    hookDurationMs: getElapsed(),
-                    platform,
-                    sessionId: ctx.sessionId,
-                    toolName: ctx.toolName,
-                    error,
-                };
-                try {
-                    emitProfilingEvent(event, getProfilingOutput());
-                }
-                catch {
-                    // profiling failure must never break the hook
-                }
-            }
-            throw err;
-        }
-        // Record duration after handler completes
-        const hookDurationMs = getElapsed();
-        ctx.hookDurationMs = hookDurationMs;
-        // Emit profiling event when profiling is enabled
-        if (shouldProfile()) {
-            const event = {
-                type: 'hook_invocation',
-                hookName,
-                hookId,
-                sequenceId: ++sequenceCounter,
-                timestamp,
-                hookDurationMs,
-                platform,
-                sessionId: ctx.sessionId,
-                toolName: ctx.toolName,
-                result,
-            };
-            try {
-                emitProfilingEvent(event, getProfilingOutput());
-            }
-            catch {
-                // profiling failure must never break the hook
-            }
-        }
-        return result;
-    });
-}
-//# sourceMappingURL=profiling-hof.js.map

package/dist/profiling-hof.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"profiling-hof.js","sourceRoot":"","sources":["../src/profiling-hof.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAExB,OAAU,EAAE,QAAgB,EAAE,QAAgB;IAC9C,OAAO,CAAC,KAAK,EAAE,GAAgB,EAAuB,EAAE;QACtD,6DAA6D;QAC7D,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;QAEhC,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QAC1B,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QAEpB,IAAI,MAAkB,CAAC;QACvB,IAAI,KAAyB,CAAC;QAE9B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEzD,uDAAuD;YACvD,IAAI,aAAa,EAAE,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAmB;oBAC5B,IAAI,EAAE,iBAAiB;oBACvB,QAAQ;oBACR,MAAM;oBACN,UAAU,EAAE,EAAE,eAAe;oBAC7B,SAAS;oBACT,cAAc,EAAE,UAAU,EAAE;oBAC5B,QAAQ;oBACR,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,KAAK;iBACN,CAAC;gBACF,IAAI,CAAC;oBACH,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACP,8CAA8C;gBAChD,CAAC;YACH,CAAC;YAED,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,0CAA0C;QAC1C,MAAM,cAAc,GAAG,UAAU,EAAE,CAAC;QACpC,GAAG,CAAC,cAAc,GAAG,cAAc,CAAC;QAEpC,iDAAiD;QACjD,IAAI,aAAa,EAAE,EAAE,CAAC;YACpB,MAAM,KAAK,GAAmB;gBAC5B,IAAI,EAAE,iBAAiB;gBACvB,QAAQ;gBACR,MAAM;gBACN,UAAU,EAAE,EAAE,eAAe;gBAC7B,SAAS;gBACT,cAAc;gBACd,QAAQ;gBACR,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,MAAM;aACP,CAAC;YACF,IAAI,CAAC;gBACH,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAM,CAAC;AACV,CAAC"}

package/dist/profiling.d.ts

@@ -1,64 +0,0 @@
-/**
- * Profiling event emitted as JSONL for external profiler consumption.
- * Mirrors schemas/profiling-event.json.
- */
-export interface ProfilingEvent {
-    /** Discriminator: always "hook_invocation" */
-    type: 'hook_invocation';
-    /** Name of the hook being invoked */
-    hookName: string;
-    /** Unique identifier for this hook invocation instance */
-    hookId: string;
-    /** Monotonically increasing sequence number for ordering events */
-    sequenceId: number;
-    /** Unix epoch timestamp in milliseconds when the hook was invoked */
-    timestamp: number;
-    /** Duration of the hook execution in milliseconds */
-    hookDurationMs: number;
-    /** Platform on which the hook ran (e.g. 'python', 'node', 'cli') */
-    platform: string;
-    /** Optional session identifier to correlate events */
-    sessionId?: string;
-    /** Optional name of the tool/agent associated with this hook invocation */
-    toolName?: string;
-    /** Optional result payload returned by the hook */
-    result?: object;
-    /** Optional error message if the hook invocation failed */
-    error?: string;
-}
-/**
- * Generates a unique hook invocation ID using crypto.randomUUID().
- */
-export declare function createHookId(): string;
-/**
- * Creates a timer. When the returned function is called, it returns
- * the elapsed milliseconds since the timer was created (via Date.now()).
- */
-export declare function startTimer(): () => number;
-/**
- * Writes a profiling event as a single JSONL line.
- *
- * - If `destination` is `'stderr'`, writes to `process.stderr` (without newline — JSONL
- *   consumers typically handle line separation; we add `\n` for readability).
- * - If `destination` is a file path, appends a JSONL line via `fs.appendFileSync`.
- */
-export declare function emitProfilingEvent(event: ProfilingEvent, destination: string): void;
-/**
- * Reads the `AGENTBRIDGE_PROFILING_OUTPUT` environment variable.
- * Returns `'stderr'` if the variable is not set.
- */
-export declare function getProfilingOutput(): string;
-/**
- * Returns `true` when profiling is enabled (i.e. the
- * `AGENTBRIDGE_PROFILING_OUTPUT` environment variable is set to a non-empty value).
- */
-export declare function shouldProfile(): boolean;
-/**
- * Creates a session-scoped sequence ID counter.
- * Returns `next()` which yields a monotonically increasing integer per session.
- * Used by generated wrappers to produce `sequenceId` values in profiling events.
- */
-export declare function createSequenceId(): {
-    next: () => number;
-};
-//# sourceMappingURL=profiling.d.ts.map

package/dist/profiling.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"profiling.d.ts","sourceRoot":"","sources":["../src/profiling.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,IAAI,EAAE,iBAAiB,CAAC;IACxB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,MAAM,CAGzC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,MAAM,GAClB,IAAI,CAQN;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAGvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,IAAI,EAAE,MAAM,MAAM,CAAA;CAAE,CAGzD"}

package/dist/profiling.js

@@ -1,58 +0,0 @@
-import fs from 'node:fs';
-import crypto from 'node:crypto';
-const PROFILING_ENV_VAR = 'AGENTBRIDGE_PROFILING_OUTPUT';
-/**
- * Generates a unique hook invocation ID using crypto.randomUUID().
- */
-export function createHookId() {
-    return crypto.randomUUID();
-}
-/**
- * Creates a timer. When the returned function is called, it returns
- * the elapsed milliseconds since the timer was created (via Date.now()).
- */
-export function startTimer() {
-    const start = Date.now();
-    return () => Date.now() - start;
-}
-/**
- * Writes a profiling event as a single JSONL line.
- *
- * - If `destination` is `'stderr'`, writes to `process.stderr` (without newline — JSONL
- *   consumers typically handle line separation; we add `\n` for readability).
- * - If `destination` is a file path, appends a JSONL line via `fs.appendFileSync`.
- */
-export function emitProfilingEvent(event, destination) {
-    const line = JSON.stringify(event) + '\n';
-    if (destination === 'stderr') {
-        process.stderr.write(line);
-    }
-    else {
-        fs.appendFileSync(destination, line, 'utf-8');
-    }
-}
-/**
- * Reads the `AGENTBRIDGE_PROFILING_OUTPUT` environment variable.
- * Returns `'stderr'` if the variable is not set.
- */
-export function getProfilingOutput() {
-    return process.env[PROFILING_ENV_VAR] ?? 'stderr';
-}
-/**
- * Returns `true` when profiling is enabled (i.e. the
- * `AGENTBRIDGE_PROFILING_OUTPUT` environment variable is set to a non-empty value).
- */
-export function shouldProfile() {
-    const value = process.env[PROFILING_ENV_VAR];
-    return value !== undefined && value !== '';
-}
-/**
- * Creates a session-scoped sequence ID counter.
- * Returns `next()` which yields a monotonically increasing integer per session.
- * Used by generated wrappers to produce `sequenceId` values in profiling events.
- */
-export function createSequenceId() {
-    let counter = 0;
-    return { next: () => ++counter };
-}
-//# sourceMappingURL=profiling.js.map

package/dist/profiling.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"profiling.js","sourceRoot":"","sources":["../src/profiling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;AA+BzD;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAqB,EACrB,WAAmB;IAEnB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAE1C,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC"}