@agentlair/audit-logger 0.1.0

package/README.md

@@ -0,0 +1,173 @@
+# @agentlair/audit-logger
+
+A lightweight, framework-agnostic agent action logger. Log locally by default. Connect to [AgentLair](https://agentlair.dev) for persistent, queryable audit trails.
+
+Zero runtime dependencies. Works in Node ≥ 18, Bun, Deno, and modern browsers.
+
+---
+
+## Install
+
+```bash
+npm install @agentlair/audit-logger
+# or
+bun add @agentlair/audit-logger
+```
+
+---
+
+## Quick start
+
+```typescript
+import { auditLog } from '@agentlair/audit-logger';
+
+// Logs to console — no config needed
+await auditLog({
+  agent: 'my-agent',
+  action: 'tool_call',
+  tool: 'web_search',
+  input: 'latest AI news',
+  output: results,
+});
+```
+
+**Output:**
+```
+[audit 14:32:01] my-agent → tool_call [web_search]
+```
+
+---
+
+## Connect to AgentLair
+
+Set `AGENTLAIR_API_KEY` to ship audit logs to AgentLair for persistent storage and querying.
+
+```bash
+export AGENTLAIR_API_KEY=aal_...
+```
+
+That's it. All `auditLog()` calls will now also POST to AgentLair asynchronously (non-blocking, fire-and-forget).
+
+Get a free API key at [agentlair.dev](https://agentlair.dev).
+
+---
+
+## API
+
+### `auditLog(entry)` — module-level convenience
+
+```typescript
+await auditLog({
+  agent: string;        // Name/ID of the agent
+  action: string;       // Action category (e.g. "tool_call", "llm_response", "decision")
+  tool?: string;        // Tool name, if this is a tool call
+  input?: unknown;      // Input to the tool or LLM
+  output?: unknown;     // Output from the tool or LLM
+  timestamp?: string;   // ISO 8601 — defaults to now
+  metadata?: Record<string, unknown>;  // Any additional context
+});
+```
+
+### `configureLogger(options)` — configure defaults
+
+```typescript
+import { configureLogger } from '@agentlair/audit-logger';
+
+configureLogger({
+  apiKey: 'aal_...',    // or set AGENTLAIR_API_KEY
+  console: true,        // write to console (default: true)
+  silent: false,        // suppress all output (useful in tests)
+  sinks: [              // custom sinks
+    { write(entry) { myDb.insert(entry); } }
+  ],
+});
+```
+
+### `AuditLogger` — class-based API
+
+```typescript
+import { AuditLogger } from '@agentlair/audit-logger';
+
+const logger = new AuditLogger({ apiKey: process.env.AGENTLAIR_API_KEY });
+
+await logger.log({ agent: 'my-agent', action: 'tool_call', tool: 'search', input: q });
+await logger.logAll([entry1, entry2, entry3]);
+```
+
+---
+
+## Framework adapters
+
+### LangChain.js
+
+```typescript
+import { AgentExecutor } from 'langchain/agents';
+import { AuditLoggerCallbackHandler } from '@agentlair/audit-logger/langchain';
+
+const handler = new AuditLoggerCallbackHandler({ agentName: 'my-agent' });
+const executor = new AgentExecutor({ agent, tools, callbacks: [handler] });
+
+// All tool calls and LLM invocations are now logged
+const result = await executor.invoke({ input: 'What is AgentLair?' });
+```
+
+Captured events: `handleToolStart`, `handleToolEnd`, `handleToolError`, `handleLLMStart`, `handleLLMEnd`, `handleChainStart`, `handleChainEnd`.
+
+### Anthropic / Claude SDK
+
+```typescript
+import Anthropic from '@anthropic-ai/sdk';
+import { wrapAnthropicClient } from '@agentlair/audit-logger/anthropic';
+
+const client = new Anthropic();
+const audited = wrapAnthropicClient(client, { agentName: 'researcher' });
+
+// Use exactly like normal client
+const msg = await audited.messages.create({
+  model: 'claude-opus-4-5',
+  max_tokens: 1024,
+  messages: [{ role: 'user', content: 'Explain AgentLair in one sentence.' }],
+});
+```
+
+Logged: request params summary + response usage (input/output tokens, stop reason).
+
+---
+
+## Custom sinks
+
+Implement the `AuditSink` interface to write to any backend:
+
+```typescript
+import type { AuditSink, ResolvedAuditEntry } from '@agentlair/audit-logger';
+
+const postgresSink: AuditSink = {
+  async write(entry: ResolvedAuditEntry) {
+    await db.insert('audit_log', entry);
+  },
+};
+
+const logger = new AuditLogger({ sinks: [postgresSink], console: false });
+```
+
+---
+
+## AgentLair storage
+
+When `AGENTLAIR_API_KEY` is set, audit entries are stored as Observations under the `audit-log` topic. You can query them using the AgentLair SDK:
+
+```typescript
+import { AgentLair } from '@agentlair/sdk';
+
+const lair = new AgentLair(process.env.AGENTLAIR_API_KEY!);
+const { observations } = await lair.observations.read({
+  topic: 'audit-log',
+  limit: 50,
+});
+```
+
+---
+
+## License
+
+MIT © [AgentLair](https://agentlair.dev)

package/dist/adapters/anthropic.d.ts

@@ -0,0 +1,48 @@
+import type { AuditLoggerOptions } from '../types.js';
+/** Minimal Anthropic message params we care about for logging */
+interface AnthropicMessageParams {
+    model?: string;
+    messages?: Array<{
+        role: string;
+        content: unknown;
+    }>;
+    tools?: unknown[];
+    max_tokens?: number;
+    system?: string;
+    [key: string]: unknown;
+}
+/** Minimal Anthropic message response */
+interface AnthropicMessage {
+    id?: string;
+    model?: string;
+    stop_reason?: string;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+    };
+    content?: unknown[];
+    [key: string]: unknown;
+}
+/** Minimal Anthropic client interface */
+interface AnthropicClientLike {
+    messages: {
+        create(params: AnthropicMessageParams): Promise<AnthropicMessage>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface WrapAnthropicOptions extends AuditLoggerOptions {
+    /** Name to use as the 'agent' field in audit entries */
+    agentName?: string;
+}
+/**
+ * Wraps an Anthropic client to automatically audit all messages.create() calls.
+ * Returns a proxy that behaves identically to the original client.
+ *
+ * @example
+ * const audited = wrapAnthropicClient(new Anthropic(), { agentName: 'researcher' });
+ * const msg = await audited.messages.create({ model: 'claude-opus-4-5', ... });
+ */
+export declare function wrapAnthropicClient<T extends AnthropicClientLike>(client: T, options?: WrapAnthropicOptions): T;
+export {};
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/adapters/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtD,iEAAiE;AACjE,UAAU,sBAAsB;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yCAAyC;AACzC,UAAU,gBAAgB;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yCAAyC;AACzC,UAAU,mBAAmB;IAC3B,QAAQ,EAAE;QACR,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,mBAAmB,EAC/D,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,oBAAyB,GACjC,CAAC,CAkEH"}

package/dist/adapters/anthropic.js

@@ -0,0 +1,99 @@
+// ─── Anthropic / Claude SDK Adapter ─────────────────────────────────────────
+// Middleware wrapper for Anthropic SDK message calls.
+//
+// Usage:
+//   import Anthropic from '@anthropic-ai/sdk';
+//   import { wrapAnthropicClient } from '@agentlair/audit-logger/anthropic';
+//
+//   const client = new Anthropic();
+//   const audited = wrapAnthropicClient(client, { agentName: 'my-agent' });
+//
+//   // Use exactly like normal client — audit happens automatically
+//   const msg = await audited.messages.create({ model: 'claude-3-5-sonnet', ... });
+//
+// No @anthropic-ai/sdk dependency required — uses duck-typing.
+import { AuditLogger } from '../logger.js';
+/**
+ * Wraps an Anthropic client to automatically audit all messages.create() calls.
+ * Returns a proxy that behaves identically to the original client.
+ *
+ * @example
+ * const audited = wrapAnthropicClient(new Anthropic(), { agentName: 'researcher' });
+ * const msg = await audited.messages.create({ model: 'claude-opus-4-5', ... });
+ */
+export function wrapAnthropicClient(client, options = {}) {
+    const { agentName, ...loggerOptions } = options;
+    const logger = new AuditLogger(loggerOptions);
+    const name = agentName ?? 'claude-agent';
+    const originalCreate = client.messages.create.bind(client.messages);
+    const wrappedMessages = {
+        ...client.messages,
+        async create(params) {
+            const startedAt = new Date().toISOString();
+            // Log the request
+            await logger.log({
+                agent: name,
+                action: 'llm_request',
+                tool: 'messages.create',
+                input: {
+                    model: params.model,
+                    messageCount: Array.isArray(params.messages) ? params.messages.length : 0,
+                    hasTools: Array.isArray(params.tools) && params.tools.length > 0,
+                    maxTokens: params.max_tokens,
+                    hasSystem: !!params.system,
+                    // Last user message content (truncated for privacy)
+                    lastMessage: Array.isArray(params.messages) && params.messages.length > 0
+                        ? summarize(params.messages[params.messages.length - 1]?.content)
+                        : undefined,
+                },
+                timestamp: startedAt,
+            });
+            let response;
+            try {
+                response = await originalCreate(params);
+            }
+            catch (err) {
+                // Log error
+                await logger.log({
+                    agent: name,
+                    action: 'llm_error',
+                    tool: 'messages.create',
+                    output: err.message,
+                    metadata: { error: true, startedAt },
+                });
+                throw err;
+            }
+            // Log the response
+            await logger.log({
+                agent: name,
+                action: 'llm_response',
+                tool: 'messages.create',
+                output: {
+                    model: response.model,
+                    stopReason: response.stop_reason,
+                    inputTokens: response.usage?.input_tokens,
+                    outputTokens: response.usage?.output_tokens,
+                    contentBlocks: Array.isArray(response.content) ? response.content.length : 0,
+                },
+                metadata: { startedAt, messageId: response.id },
+            });
+            return response;
+        },
+    };
+    return { ...client, messages: wrappedMessages };
+}
+/** Summarize content for safe logging (truncate long strings) */
+function summarize(content) {
+    if (typeof content === 'string') {
+        return content.length > 200 ? content.slice(0, 200) + '…' : content;
+    }
+    if (Array.isArray(content)) {
+        const text = content.find((b) => typeof b === 'object' && b !== null && b.type === 'text');
+        if (text && typeof text.text === 'string') {
+            const t = text.text;
+            return t.length > 200 ? t.slice(0, 200) + '…' : t;
+        }
+    }
+    return '[non-text content]';
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/adapters/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/adapters/langchain.d.ts

@@ -0,0 +1,36 @@
+import type { AuditLoggerOptions } from '../types.js';
+/** Minimal interface we need from LangChain's BaseCallbackHandler */
+interface LangChainCallbackHandlerInterface {
+    handleToolStart?: (tool: Record<string, unknown>, input: string, runId: string) => void | Promise<void>;
+    handleToolEnd?: (output: string, runId: string) => void | Promise<void>;
+    handleToolError?: (err: Error, runId: string) => void | Promise<void>;
+    handleLLMStart?: (llm: Record<string, unknown>, prompts: string[], runId: string) => void | Promise<void>;
+    handleLLMEnd?: (output: Record<string, unknown>, runId: string) => void | Promise<void>;
+    handleChainStart?: (chain: Record<string, unknown>, inputs: Record<string, unknown>, runId: string) => void | Promise<void>;
+    handleChainEnd?: (outputs: Record<string, unknown>, runId: string) => void | Promise<void>;
+}
+export interface AuditLoggerCallbackHandlerOptions extends AuditLoggerOptions {
+    /** Name to use as the 'agent' field in audit entries */
+    agentName?: string;
+}
+/**
+ * LangChain callback handler that logs all tool calls and LLM invocations.
+ *
+ * Compatible with LangChain.js >=0.1.0 (callback interface).
+ * Import langchain separately — this adapter uses duck-typing, no hard dep.
+ */
+export declare class AuditLoggerCallbackHandler implements LangChainCallbackHandlerInterface {
+    private readonly logger;
+    private readonly agentName;
+    private readonly pendingTools;
+    constructor(options?: AuditLoggerCallbackHandlerOptions);
+    handleToolStart(tool: Record<string, unknown>, input: string, runId: string): Promise<void>;
+    handleToolEnd(output: string, runId: string): Promise<void>;
+    handleToolError(err: Error, runId: string): Promise<void>;
+    handleLLMStart(_llm: Record<string, unknown>, prompts: string[], _runId: string): Promise<void>;
+    handleLLMEnd(output: Record<string, unknown>, _runId: string): Promise<void>;
+    handleChainStart(chain: Record<string, unknown>, inputs: Record<string, unknown>, _runId: string): Promise<void>;
+    handleChainEnd(outputs: Record<string, unknown>, _runId: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=langchain.d.ts.map

package/dist/adapters/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/adapters/langchain.ts"],"names":[],"mappings":"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"}

package/dist/adapters/langchain.js

@@ -0,0 +1,90 @@
+// ─── LangChain Adapter ───────────────────────────────────────────────────────
+// Provides a LangChain BaseCallbackHandler subclass that forwards tool calls
+// and LLM events to @agentlair/audit-logger.
+//
+// Usage (LangChain.js):
+//   import { AuditLoggerCallbackHandler } from '@agentlair/audit-logger/langchain';
+//   const handler = new AuditLoggerCallbackHandler({ agentName: 'my-agent' });
+//   const chain = new AgentExecutor({ ..., callbacks: [handler] });
+//
+// No langchain dependency required at runtime — uses duck-typing interface.
+import { AuditLogger } from '../logger.js';
+/**
+ * LangChain callback handler that logs all tool calls and LLM invocations.
+ *
+ * Compatible with LangChain.js >=0.1.0 (callback interface).
+ * Import langchain separately — this adapter uses duck-typing, no hard dep.
+ */
+export class AuditLoggerCallbackHandler {
+    logger;
+    agentName;
+    pendingTools = new Map();
+    constructor(options = {}) {
+        const { agentName, ...loggerOptions } = options;
+        this.logger = new AuditLogger(loggerOptions);
+        this.agentName = agentName ?? 'langchain-agent';
+    }
+    async handleToolStart(tool, input, runId) {
+        const toolName = tool.name ?? 'unknown_tool';
+        this.pendingTools.set(runId, { name: toolName, input, startedAt: new Date().toISOString() });
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'tool_start',
+            tool: toolName,
+            input,
+        });
+    }
+    async handleToolEnd(output, runId) {
+        const pending = this.pendingTools.get(runId);
+        this.pendingTools.delete(runId);
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'tool_end',
+            tool: pending?.name ?? 'unknown_tool',
+            input: pending?.input,
+            output,
+            metadata: pending ? { startedAt: pending.startedAt } : undefined,
+        });
+    }
+    async handleToolError(err, runId) {
+        const pending = this.pendingTools.get(runId);
+        this.pendingTools.delete(runId);
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'tool_error',
+            tool: pending?.name ?? 'unknown_tool',
+            output: err.message,
+            metadata: { error: true, errorClass: err.constructor.name },
+        });
+    }
+    async handleLLMStart(_llm, prompts, _runId) {
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'llm_start',
+            input: prompts[0],
+            metadata: { promptCount: prompts.length },
+        });
+    }
+    async handleLLMEnd(output, _runId) {
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'llm_end',
+            output,
+        });
+    }
+    async handleChainStart(chain, inputs, _runId) {
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'chain_start',
+            metadata: { chainType: chain.id, inputs },
+        });
+    }
+    async handleChainEnd(outputs, _runId) {
+        await this.logger.log({
+            agent: this.agentName,
+            action: 'chain_end',
+            output: outputs,
+        });
+    }
+}
+//# sourceMappingURL=langchain.js.map

package/dist/adapters/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../src/adapters/langchain.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @agentlair/audit-logger
+ *
+ * Framework-agnostic agent action logger. Zero runtime dependencies.
+ * Works in Node ≥ 18, Bun, Deno, and modern browsers.
+ *
+ * --- Quick start ---
+ *
+ * import { auditLog } from '@agentlair/audit-logger';
+ *
+ * // Just log locally:
+ * await auditLog({ agent: 'my-agent', action: 'tool_call', tool: 'search', input: query });
+ *
+ * // Connect to AgentLair (set AGENTLAIR_API_KEY env var):
+ * await auditLog({ agent: 'my-agent', action: 'decision', output: result });
+ *
+ * --- Framework adapters ---
+ *
+ * import { AuditLoggerCallbackHandler } from '@agentlair/audit-logger/langchain';
+ * import { wrapAnthropicClient }        from '@agentlair/audit-logger/anthropic';
+ *
+ * @see https://agentlair.dev/docs/audit-logger
+ */
+export { AuditLogger, auditLog, configureLogger } from './logger.js';
+export type { AuditLogEntry, ResolvedAuditEntry, AuditSink, AuditLoggerOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @agentlair/audit-logger
+ *
+ * Framework-agnostic agent action logger. Zero runtime dependencies.
+ * Works in Node ≥ 18, Bun, Deno, and modern browsers.
+ *
+ * --- Quick start ---
+ *
+ * import { auditLog } from '@agentlair/audit-logger';
+ *
+ * // Just log locally:
+ * await auditLog({ agent: 'my-agent', action: 'tool_call', tool: 'search', input: query });
+ *
+ * // Connect to AgentLair (set AGENTLAIR_API_KEY env var):
+ * await auditLog({ agent: 'my-agent', action: 'decision', output: result });
+ *
+ * --- Framework adapters ---
+ *
+ * import { AuditLoggerCallbackHandler } from '@agentlair/audit-logger/langchain';
+ * import { wrapAnthropicClient }        from '@agentlair/audit-logger/anthropic';
+ *
+ * @see https://agentlair.dev/docs/audit-logger
+ */
+export { AuditLogger, auditLog, configureLogger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,35 @@
+import type { AuditLogEntry, AuditLoggerOptions, ResolvedAuditEntry } from './types.js';
+export declare class AuditLogger {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly sinks;
+    private readonly useConsole;
+    private readonly silent;
+    constructor(options?: AuditLoggerOptions);
+    /**
+     * Log a single agent action.
+     * - Always writes to console (unless silent/disabled)
+     * - Writes to any configured sinks
+     * - If apiKey is present, ships to AgentLair async (non-blocking)
+     */
+    log(entry: AuditLogEntry): Promise<ResolvedAuditEntry>;
+    /** Convenience: log multiple entries in sequence */
+    logAll(entries: AuditLogEntry[]): Promise<ResolvedAuditEntry[]>;
+    private writeConsole;
+    private shipToAgentLair;
+}
+/**
+ * Log an agent action using the default logger.
+ * Reads AGENTLAIR_API_KEY from environment automatically.
+ *
+ * @example
+ * import { auditLog } from '@agentlair/audit-logger';
+ * await auditLog({ agent: 'researcher', action: 'tool_call', tool: 'web_search', input: query });
+ */
+export declare function auditLog(entry: AuditLogEntry): Promise<ResolvedAuditEntry>;
+/**
+ * Configure the default logger instance.
+ * Call this once at startup before any auditLog() calls.
+ */
+export declare function configureLogger(options: AuditLoggerOptions): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAa,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEnG,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;gBAErB,OAAO,GAAE,kBAAuB;IAW5C;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6B5D,oDAAoD;IAC9C,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQrE,OAAO,CAAC,YAAY;YAMN,eAAe;CAsB9B;AAcD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEhF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEjE"}

package/dist/logger.js

@@ -0,0 +1,113 @@
+// ─── AuditLogger ─────────────────────────────────────────────────────────────
+// Core logger class. Logs agent actions locally and optionally ships to AgentLair.
+//
+// Usage:
+//   import { AuditLogger } from '@agentlair/audit-logger';
+//   const logger = new AuditLogger(); // reads AGENTLAIR_API_KEY automatically
+//   await logger.log({ agent: 'my-agent', action: 'tool_call', tool: 'search', input: query, output: results });
+export class AuditLogger {
+    apiKey;
+    baseUrl;
+    sinks;
+    useConsole;
+    silent;
+    constructor(options = {}) {
+        // Resolve API key from options or env
+        this.apiKey = options.apiKey ?? (typeof process !== 'undefined' ? process.env.AGENTLAIR_API_KEY : undefined);
+        this.baseUrl = (options.baseUrl ?? 'https://agentlair.dev').replace(/\/$/, '');
+        this.sinks = options.sinks ?? [];
+        this.useConsole = options.console !== false;
+        this.silent = options.silent ?? false;
+    }
+    /**
+     * Log a single agent action.
+     * - Always writes to console (unless silent/disabled)
+     * - Writes to any configured sinks
+     * - If apiKey is present, ships to AgentLair async (non-blocking)
+     */
+    async log(entry) {
+        const resolved = {
+            ...entry,
+            timestamp: entry.timestamp ?? new Date().toISOString(),
+        };
+        if (!this.silent) {
+            // Console output
+            if (this.useConsole) {
+                this.writeConsole(resolved);
+            }
+            // Custom sinks
+            for (const sink of this.sinks) {
+                await sink.write(resolved);
+            }
+            // AgentLair backend (fire-and-forget, non-blocking)
+            if (this.apiKey) {
+                this.shipToAgentLair(resolved).catch((err) => {
+                    // Non-fatal — log locally but don't throw
+                    console.warn('[audit-logger] AgentLair upload failed:', err.message);
+                });
+            }
+        }
+        return resolved;
+    }
+    /** Convenience: log multiple entries in sequence */
+    async logAll(entries) {
+        const results = [];
+        for (const entry of entries) {
+            results.push(await this.log(entry));
+        }
+        return results;
+    }
+    writeConsole(entry) {
+        const tool = entry.tool ? ` [${entry.tool}]` : '';
+        const ts = entry.timestamp.slice(11, 19); // HH:MM:SS
+        console.log(`[audit ${ts}] ${entry.agent} → ${entry.action}${tool}`);
+    }
+    async shipToAgentLair(entry) {
+        // Use AgentLair Observations API with topic "audit-log"
+        // Content is serialized JSON of the full entry
+        const payload = {
+            topic: 'audit-log',
+            content: JSON.stringify(entry),
+        };
+        const res = await fetch(`${this.baseUrl}/v1/observations`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new Error(`AgentLair ${res.status}: ${text}`);
+        }
+    }
+}
+// ─── Module-level convenience API ────────────────────────────────────────────
+// Uses a default logger instance (lazy-initialized on first call).
+let _defaultLogger = null;
+function getDefaultLogger() {
+    if (!_defaultLogger) {
+        _defaultLogger = new AuditLogger();
+    }
+    return _defaultLogger;
+}
+/**
+ * Log an agent action using the default logger.
+ * Reads AGENTLAIR_API_KEY from environment automatically.
+ *
+ * @example
+ * import { auditLog } from '@agentlair/audit-logger';
+ * await auditLog({ agent: 'researcher', action: 'tool_call', tool: 'web_search', input: query });
+ */
+export async function auditLog(entry) {
+    return getDefaultLogger().log(entry);
+}
+/**
+ * Configure the default logger instance.
+ * Call this once at startup before any auditLog() calls.
+ */
+export function configureLogger(options) {
+    _defaultLogger = new AuditLogger(options);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+/** A single agent action to log */
+export interface AuditLogEntry {
+    /** Name/ID of the agent performing the action */
+    agent: string;
+    /** High-level action category (e.g. "tool_call", "llm_response", "decision") */
+    action: string;
+    /** Tool name, if this is a tool call */
+    tool?: string;
+    /** Input passed to the tool or LLM */
+    input?: unknown;
+    /** Output from the tool or LLM */
+    output?: unknown;
+    /** ISO 8601 timestamp — defaults to now */
+    timestamp?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/** A log entry with all fields resolved (timestamp guaranteed) */
+export interface ResolvedAuditEntry extends AuditLogEntry {
+    timestamp: string;
+}
+/** Sink: where to write audit logs */
+export interface AuditSink {
+    write(entry: ResolvedAuditEntry): Promise<void> | void;
+}
+/** Options for configuring the audit logger */
+export interface AuditLoggerOptions {
+    /**
+     * AgentLair API key. If set (or AGENTLAIR_API_KEY env var), logs are also
+     * shipped to AgentLair for persistent querying.
+     */
+    apiKey?: string;
+    /** Base URL for AgentLair API. Defaults to https://agentlair.dev */
+    baseUrl?: string;
+    /**
+     * Local sinks to write to in addition to (or instead of) console.
+     * Pass an empty array to suppress console output.
+     */
+    sinks?: AuditSink[];
+    /** If false, suppress console output. Default: true */
+    console?: boolean;
+    /** If true, suppress all output (useful in tests) */
+    silent?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+// ─── Types ───────────────────────────────────────────────────────────────────
+// Core types for @agentlair/audit-logger
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,yCAAyC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@agentlair/audit-logger",
+  "version": "0.1.0",
+  "description": "Framework-agnostic agent action logger. Logs locally by default. Connect to AgentLair for persistent, queryable audit trails.",
+  "keywords": [
+    "ai-agent",
+    "audit",
+    "logging",
+    "langchain",
+    "crewai",
+    "claude",
+    "anthropic",
+    "agentlair",
+    "observability",
+    "agent-monitoring"
+  ],
+  "homepage": "https://agentlair.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/piiiico/agentlair"
+  },
+  "license": "MIT",
+  "author": "AgentLair",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./langchain": {
+      "import": "./dist/adapters/langchain.js",
+      "types": "./dist/adapters/langchain.d.ts"
+    },
+    "./anthropic": {
+      "import": "./dist/adapters/anthropic.js",
+      "types": "./dist/adapters/anthropic.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "bun-types": "^1.3.11",
+    "typescript": "^6.0.2"
+  }
+}