@wytness/sdk 0.1.0 → 0.2.0

package/README.md

@@ -44,7 +44,7 @@ Send events directly to the Wytness API using your API key:
 const client = new AuditClient({
   agentId: "my-agent",
   humanOperatorId: "user-123",
-  httpEndpoint: "https://api.wytness.io",
+  httpEndpoint: "https://api.wytness.dev",
   httpApiKey: "aa_live_...",
 });
 ```

package/dist/index.cjs

@@ -34,7 +34,8 @@ __export(src_exports, {
   AuditEventSchema: () => AuditEventSchema,
   auditTool: () => auditTool,
   computeEventHash: () => computeEventHash,
-  createEmitter: () => createEmitter,
+  createFileEmitter: () => createFileEmitter,
+  createHttpEmitter: () => createHttpEmitter,
   generateKeypair: () => generateKeypair,
   signEvent: () => signEvent,
   verifyChain: () => verifyChain,
@@ -142,43 +143,33 @@ function fileEmit(path, eventDict) {
   (0, import_fs.mkdirSync)((0, import_path.dirname)(path), { recursive: true });
   (0, import_fs.appendFileSync)(path, JSON.stringify(eventDict) + "\n");
 }
-function createEmitter(bootstrapServers, topic, fallbackPath) {
-  if (bootstrapServers) {
-    try {
-      const { Kafka } = require("kafkajs");
-      const kafka = new Kafka({
-        clientId: "wytness-sdk",
-        brokers: bootstrapServers.split(",")
-      });
-      const producer = kafka.producer();
-      let connected = false;
-      return (eventDict) => {
-        const doSend = async () => {
-          try {
-            if (!connected) {
-              await producer.connect();
-              connected = true;
-            }
-            await producer.send({
-              topic,
-              messages: [
-                {
-                  key: eventDict["agent_id"],
-                  value: JSON.stringify(eventDict)
-                }
-              ]
-            });
-          } catch (e) {
-            console.error(`Kafka error: ${e}`);
-            fileEmit(fallbackPath, eventDict);
-          }
-        };
-        doSend().catch(() => fileEmit(fallbackPath, eventDict));
-      };
-    } catch (e) {
-      console.warn(`Kafka unavailable (${e}), using file fallback`);
-    }
-  }
+function createHttpEmitter(apiUrl, apiKey, fallbackPath) {
+  return (eventDict) => {
+    const doSend = async () => {
+      try {
+        const body = JSON.stringify(eventDict);
+        const resp = await fetch(`${apiUrl}/ingest`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": apiKey
+          },
+          body,
+          signal: AbortSignal.timeout(1e4)
+        });
+        if (resp.status !== 201) {
+          console.error(`HTTP ingest failed: ${resp.status}`);
+          fileEmit(fallbackPath, eventDict);
+        }
+      } catch (e) {
+        console.error(`HTTP ingest error: ${e}`);
+        fileEmit(fallbackPath, eventDict);
+      }
+    };
+    doSend().catch(() => fileEmit(fallbackPath, eventDict));
+  };
+}
+function createFileEmitter(fallbackPath) {
   return (eventDict) => {
     fileEmit(fallbackPath, eventDict);
   };
@@ -211,11 +202,16 @@ var AuditClient = class {
       (0, import_fs2.mkdirSync)((0, import_path2.dirname)(keyPath), { recursive: true });
       (0, import_fs2.writeFileSync)(keyPath, Buffer.from(kp.secretKey));
     }
-    this._emit = createEmitter(
-      options.kafkaBootstrapServers ?? null,
-      options.kafkaTopic ?? "wytness-events",
-      options.fallbackLogPath ?? "./audit_fallback.jsonl"
-    );
+    const fallback = options.fallbackLogPath ?? "./audit_fallback.jsonl";
+    if (options.httpApiKey) {
+      this._emit = createHttpEmitter(
+        options.httpEndpoint ?? "https://api.wytness.dev",
+        options.httpApiKey,
+        fallback
+      );
+    } else {
+      this._emit = createFileEmitter(fallback);
+    }
   }
   get sessionId() {
     return this._sessionId;
@@ -242,47 +238,58 @@ function sanitise(params) {
 function hashValue(value) {
   return (0, import_crypto4.createHash)("sha256").update(JSON.stringify(value, null, 0)).digest("hex");
 }
-function auditTool(client, taskId = "default") {
+function wrapFn(client, fn, toolName, taskId) {
+  const wrapped = function(...args) {
+    const start = performance.now();
+    let status = "success";
+    let errorCode = null;
+    let result;
+    const inputsHash = hashValue(args);
+    try {
+      result = fn.apply(this, args);
+    } catch (e) {
+      status = "failure";
+      errorCode = e.constructor.name;
+      throw e;
+    } finally {
+      const durationMs = Math.round(performance.now() - start);
+      const params = {};
+      args.forEach((arg, i) => {
+        params[`arg${i}`] = arg;
+      });
+      const event = AuditEventSchema.parse({
+        agent_id: client.agentId,
+        agent_version: client.agentVersion,
+        human_operator_id: client.humanOperatorId,
+        task_id: taskId,
+        session_id: client.sessionId,
+        tool_name: toolName,
+        tool_parameters: sanitise(params),
+        inputs_hash: inputsHash,
+        outputs_hash: result != null ? hashValue(result) : "",
+        status,
+        error_code: errorCode,
+        duration_ms: durationMs
+      });
+      client.record(event);
+    }
+    return result;
+  };
+  Object.defineProperty(wrapped, "name", { value: toolName });
+  return wrapped;
+}
+function auditTool(client, fnOrTaskId, options) {
+  if (typeof fnOrTaskId === "function") {
+    const fn = fnOrTaskId;
+    const opts = typeof options === "object" ? options : {};
+    const toolName = opts.toolName ?? fn.name ?? "anonymous";
+    const taskId2 = opts.taskId ?? "default";
+    return wrapFn(client, fn, toolName, taskId2);
+  }
+  const taskId = typeof fnOrTaskId === "string" ? fnOrTaskId : "default";
   return function(fn, fnName) {
-    const name = fnName ?? fn.name ?? "anonymous";
-    const wrapped = function(...args) {
-      const start = performance.now();
-      let status = "success";
-      let errorCode = null;
-      let result;
-      const inputsHash = hashValue(args);
-      try {
-        result = fn.apply(this, args);
-      } catch (e) {
-        status = "failure";
-        errorCode = e.constructor.name;
-        throw e;
-      } finally {
-        const durationMs = Math.round(performance.now() - start);
-        const params = {};
-        args.forEach((arg, i) => {
-          params[`arg${i}`] = arg;
-        });
-        const event = AuditEventSchema.parse({
-          agent_id: client.agentId,
-          agent_version: client.agentVersion,
-          human_operator_id: client.humanOperatorId,
-          task_id: taskId,
-          session_id: client.sessionId,
-          tool_name: name,
-          tool_parameters: sanitise(params),
-          inputs_hash: inputsHash,
-          outputs_hash: result != null ? hashValue(result) : "",
-          status,
-          error_code: errorCode,
-          duration_ms: durationMs
-        });
-        client.record(event);
-      }
-      return result;
-    };
-    Object.defineProperty(wrapped, "name", { value: name });
-    return wrapped;
+    const toolName = fnName ?? fn.name ?? "anonymous";
+    return wrapFn(client, fn, toolName, taskId);
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -291,7 +298,8 @@ function auditTool(client, taskId = "default") {
   AuditEventSchema,
   auditTool,
   computeEventHash,
-  createEmitter,
+  createFileEmitter,
+  createHttpEmitter,
   generateKeypair,
   signEvent,
   verifyChain,

package/dist/index.d.cts

@@ -97,16 +97,17 @@ declare function verifyChain(events: Record<string, unknown>[]): {
 };
 
 type EmitFn = (eventDict: Record<string, unknown>) => void;
-declare function createEmitter(bootstrapServers: string | null, topic: string, fallbackPath: string): EmitFn;
+declare function createHttpEmitter(apiUrl: string, apiKey: string, fallbackPath: string): EmitFn;
+declare function createFileEmitter(fallbackPath: string): EmitFn;
 
 interface AuditClientOptions {
     agentId: string;
     agentVersion?: string;
     humanOperatorId?: string;
     signingKeyPath?: string;
-    kafkaBootstrapServers?: string | null;
-    kafkaTopic?: string;
     fallbackLogPath?: string;
+    httpApiKey?: string;
+    httpEndpoint?: string;
 }
 declare class AuditClient {
     readonly agentId: string;
@@ -121,6 +122,22 @@ declare class AuditClient {
     record(event: AuditEvent): void;
 }
 
-declare function auditTool(client: AuditClient, taskId?: string): <T extends (...args: unknown[]) => unknown>(fn: T, fnName?: string) => T;
+interface AuditToolOptions {
+    toolName?: string;
+    taskId?: string;
+}
+/**
+ * Wrap a function with audit logging.
+ *
+ * Supports two calling styles:
+ *
+ * 1. Direct (documented API):
+ *    auditTool(client, fn, { toolName: "name", taskId: "task" })
+ *
+ * 2. Curried (legacy):
+ *    auditTool(client)(fn, "name")
+ *    auditTool(client, "taskId")(fn, "name")
+ */
+declare function auditTool(client: AuditClient, fnOrTaskId?: ((...args: unknown[]) => unknown) | string, options?: AuditToolOptions | string): any;
 
-export { AuditClient, type AuditClientOptions, type AuditEvent, AuditEventSchema, auditTool, computeEventHash, createEmitter, generateKeypair, signEvent, verifyChain, verifyEvent };
+export { AuditClient, type AuditClientOptions, type AuditEvent, AuditEventSchema, auditTool, computeEventHash, createFileEmitter, createHttpEmitter, generateKeypair, signEvent, verifyChain, verifyEvent };

package/dist/index.d.ts

@@ -97,16 +97,17 @@ declare function verifyChain(events: Record<string, unknown>[]): {
 };
 
 type EmitFn = (eventDict: Record<string, unknown>) => void;
-declare function createEmitter(bootstrapServers: string | null, topic: string, fallbackPath: string): EmitFn;
+declare function createHttpEmitter(apiUrl: string, apiKey: string, fallbackPath: string): EmitFn;
+declare function createFileEmitter(fallbackPath: string): EmitFn;
 
 interface AuditClientOptions {
     agentId: string;
     agentVersion?: string;
     humanOperatorId?: string;
     signingKeyPath?: string;
-    kafkaBootstrapServers?: string | null;
-    kafkaTopic?: string;
     fallbackLogPath?: string;
+    httpApiKey?: string;
+    httpEndpoint?: string;
 }
 declare class AuditClient {
     readonly agentId: string;
@@ -121,6 +122,22 @@ declare class AuditClient {
     record(event: AuditEvent): void;
 }
 
-declare function auditTool(client: AuditClient, taskId?: string): <T extends (...args: unknown[]) => unknown>(fn: T, fnName?: string) => T;
+interface AuditToolOptions {
+    toolName?: string;
+    taskId?: string;
+}
+/**
+ * Wrap a function with audit logging.
+ *
+ * Supports two calling styles:
+ *
+ * 1. Direct (documented API):
+ *    auditTool(client, fn, { toolName: "name", taskId: "task" })
+ *
+ * 2. Curried (legacy):
+ *    auditTool(client)(fn, "name")
+ *    auditTool(client, "taskId")(fn, "name")
+ */
+declare function auditTool(client: AuditClient, fnOrTaskId?: ((...args: unknown[]) => unknown) | string, options?: AuditToolOptions | string): any;
 
-export { AuditClient, type AuditClientOptions, type AuditEvent, AuditEventSchema, auditTool, computeEventHash, createEmitter, generateKeypair, signEvent, verifyChain, verifyEvent };
+export { AuditClient, type AuditClientOptions, type AuditEvent, AuditEventSchema, auditTool, computeEventHash, createFileEmitter, createHttpEmitter, generateKeypair, signEvent, verifyChain, verifyEvent };

package/dist/index.js

@@ -1,11 +1,3 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined")
-    return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // src/models.ts
 import { z } from "zod";
 import { randomUUID } from "crypto";
@@ -106,43 +98,33 @@ function fileEmit(path, eventDict) {
   mkdirSync(dirname(path), { recursive: true });
   appendFileSync(path, JSON.stringify(eventDict) + "\n");
 }
-function createEmitter(bootstrapServers, topic, fallbackPath) {
-  if (bootstrapServers) {
-    try {
-      const { Kafka } = __require("kafkajs");
-      const kafka = new Kafka({
-        clientId: "wytness-sdk",
-        brokers: bootstrapServers.split(",")
-      });
-      const producer = kafka.producer();
-      let connected = false;
-      return (eventDict) => {
-        const doSend = async () => {
-          try {
-            if (!connected) {
-              await producer.connect();
-              connected = true;
-            }
-            await producer.send({
-              topic,
-              messages: [
-                {
-                  key: eventDict["agent_id"],
-                  value: JSON.stringify(eventDict)
-                }
-              ]
-            });
-          } catch (e) {
-            console.error(`Kafka error: ${e}`);
-            fileEmit(fallbackPath, eventDict);
-          }
-        };
-        doSend().catch(() => fileEmit(fallbackPath, eventDict));
-      };
-    } catch (e) {
-      console.warn(`Kafka unavailable (${e}), using file fallback`);
-    }
-  }
+function createHttpEmitter(apiUrl, apiKey, fallbackPath) {
+  return (eventDict) => {
+    const doSend = async () => {
+      try {
+        const body = JSON.stringify(eventDict);
+        const resp = await fetch(`${apiUrl}/ingest`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "X-API-Key": apiKey
+          },
+          body,
+          signal: AbortSignal.timeout(1e4)
+        });
+        if (resp.status !== 201) {
+          console.error(`HTTP ingest failed: ${resp.status}`);
+          fileEmit(fallbackPath, eventDict);
+        }
+      } catch (e) {
+        console.error(`HTTP ingest error: ${e}`);
+        fileEmit(fallbackPath, eventDict);
+      }
+    };
+    doSend().catch(() => fileEmit(fallbackPath, eventDict));
+  };
+}
+function createFileEmitter(fallbackPath) {
   return (eventDict) => {
     fileEmit(fallbackPath, eventDict);
   };
@@ -150,7 +132,7 @@ function createEmitter(bootstrapServers, topic, fallbackPath) {
 
 // src/client.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { existsSync, readFileSync, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync as mkdirSync2 } from "fs";
 import { dirname as dirname2 } from "path";
 var AuditClient = class {
   agentId;
@@ -173,13 +155,18 @@ var AuditClient = class {
       const kp = generateKeypair();
       this._secretKey = kp.secretKey;
       mkdirSync2(dirname2(keyPath), { recursive: true });
-      writeFileSync2(keyPath, Buffer.from(kp.secretKey));
+      writeFileSync(keyPath, Buffer.from(kp.secretKey));
+    }
+    const fallback = options.fallbackLogPath ?? "./audit_fallback.jsonl";
+    if (options.httpApiKey) {
+      this._emit = createHttpEmitter(
+        options.httpEndpoint ?? "https://api.wytness.dev",
+        options.httpApiKey,
+        fallback
+      );
+    } else {
+      this._emit = createFileEmitter(fallback);
     }
-    this._emit = createEmitter(
-      options.kafkaBootstrapServers ?? null,
-      options.kafkaTopic ?? "wytness-events",
-      options.fallbackLogPath ?? "./audit_fallback.jsonl"
-    );
   }
   get sessionId() {
     return this._sessionId;
@@ -206,47 +193,58 @@ function sanitise(params) {
 function hashValue(value) {
   return createHash2("sha256").update(JSON.stringify(value, null, 0)).digest("hex");
 }
-function auditTool(client, taskId = "default") {
+function wrapFn(client, fn, toolName, taskId) {
+  const wrapped = function(...args) {
+    const start = performance.now();
+    let status = "success";
+    let errorCode = null;
+    let result;
+    const inputsHash = hashValue(args);
+    try {
+      result = fn.apply(this, args);
+    } catch (e) {
+      status = "failure";
+      errorCode = e.constructor.name;
+      throw e;
+    } finally {
+      const durationMs = Math.round(performance.now() - start);
+      const params = {};
+      args.forEach((arg, i) => {
+        params[`arg${i}`] = arg;
+      });
+      const event = AuditEventSchema.parse({
+        agent_id: client.agentId,
+        agent_version: client.agentVersion,
+        human_operator_id: client.humanOperatorId,
+        task_id: taskId,
+        session_id: client.sessionId,
+        tool_name: toolName,
+        tool_parameters: sanitise(params),
+        inputs_hash: inputsHash,
+        outputs_hash: result != null ? hashValue(result) : "",
+        status,
+        error_code: errorCode,
+        duration_ms: durationMs
+      });
+      client.record(event);
+    }
+    return result;
+  };
+  Object.defineProperty(wrapped, "name", { value: toolName });
+  return wrapped;
+}
+function auditTool(client, fnOrTaskId, options) {
+  if (typeof fnOrTaskId === "function") {
+    const fn = fnOrTaskId;
+    const opts = typeof options === "object" ? options : {};
+    const toolName = opts.toolName ?? fn.name ?? "anonymous";
+    const taskId2 = opts.taskId ?? "default";
+    return wrapFn(client, fn, toolName, taskId2);
+  }
+  const taskId = typeof fnOrTaskId === "string" ? fnOrTaskId : "default";
   return function(fn, fnName) {
-    const name = fnName ?? fn.name ?? "anonymous";
-    const wrapped = function(...args) {
-      const start = performance.now();
-      let status = "success";
-      let errorCode = null;
-      let result;
-      const inputsHash = hashValue(args);
-      try {
-        result = fn.apply(this, args);
-      } catch (e) {
-        status = "failure";
-        errorCode = e.constructor.name;
-        throw e;
-      } finally {
-        const durationMs = Math.round(performance.now() - start);
-        const params = {};
-        args.forEach((arg, i) => {
-          params[`arg${i}`] = arg;
-        });
-        const event = AuditEventSchema.parse({
-          agent_id: client.agentId,
-          agent_version: client.agentVersion,
-          human_operator_id: client.humanOperatorId,
-          task_id: taskId,
-          session_id: client.sessionId,
-          tool_name: name,
-          tool_parameters: sanitise(params),
-          inputs_hash: inputsHash,
-          outputs_hash: result != null ? hashValue(result) : "",
-          status,
-          error_code: errorCode,
-          duration_ms: durationMs
-        });
-        client.record(event);
-      }
-      return result;
-    };
-    Object.defineProperty(wrapped, "name", { value: name });
-    return wrapped;
+    const toolName = fnName ?? fn.name ?? "anonymous";
+    return wrapFn(client, fn, toolName, taskId);
   };
 }
 export {
@@ -254,7 +252,8 @@ export {
   AuditEventSchema,
   auditTool,
   computeEventHash,
-  createEmitter,
+  createFileEmitter,
+  createHttpEmitter,
   generateKeypair,
   signEvent,
   verifyChain,

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@wytness/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "TypeScript SDK for Wytness — audit logging for AI agents with cryptographic signing and chain integrity",
   "license": "MIT",
-  "author": "Wytness <hello@wytness.io>",
+  "author": "Wytness <hello@wytness.dev>",
   "repository": {
     "type": "git",
     "url": "https://github.com/wytness/wytness-sdk",
     "directory": "sdk-typescript"
   },
-  "homepage": "https://wytness.io",
+  "homepage": "https://wytness.dev",
   "keywords": ["audit", "logging", "ai", "agents", "compliance", "security", "typescript"],
   "type": "module",
   "main": "./dist/index.cjs",
@@ -31,7 +31,6 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "kafkajs": "2.2.4",
     "tweetnacl": "1.0.3",
     "tweetnacl-util": "0.15.1",
     "zod": "3.23.6"