TypeScript SDK

npm install provenlog

import { ProvenLogClient } from "provenlog";

const client = new ProvenLogClient("http://localhost:7600", {
  agentId: "my-agent",
});

client.logEvent({
  action_type: "TOOL_CALL",
  action_name: "fetch_data",
  action_input: { query: "revenue Q4" },
  action_status: "success",
  action_output: { results: 42 },
});

await client.close();

const client = new ProvenLogClient("http://localhost:7600", {
  agentId: "my-agent",        // Default agent ID
  sessionId: "session-123",   // Default session ID
  metadata: { env: "prod" },  // Default metadata
  labels: { dept: "finance" },// Default labels
  context: {                  // Initial label context for dashboard enrichment
    dept: { displayName: "Finance", costCenter: "CC-100" },
  },
  batchSize: 100,             // Events per batch
  flushInterval: 1000,        // Milliseconds between flushes
  timeout: 30000,             // HTTP timeout in ms
  apiKey: "your-key",         // Bearer token for auth
});

client.logEvent({
  action_type: "TOOL_CALL",
  action_name: "search_database",
  action_input: { query: "revenue Q4" },
  action_output: { results: 42 },
  action_status: "success",
  duration_ms: 150,
  metadata: { model: "claude-sonnet-4-5-20250929" },
  labels: { env: "prod" },
});

const client = new ProvenLogClient("http://localhost:7600", {
  agentId: "loan-processor",
  labels: { env: "prod", dept: "lending" },
});

// This event will have labels { env: "prod", dept: "lending", loan_id: "LN-2024-4821" }
client.logEvent({
  action_type: "TOOL_CALL",
  action_name: "pull_credit_report",
  action_status: "success",
  labels: { loan_id: "LN-2024-4821" },
});

const client = new ProvenLogClient("http://localhost:7600", {
  agentId: "loan-processor",
  labels: { loan_id: "LN-2024-4821" },
});

await client.setContext("loan_id", {
  borrower: "Alice Rivera",
  amount: 420000,
  stage: "underwriting",
});

const client = new ProvenLogClient("http://localhost:7600", {
  agentId: "loan-processor",
  labels: { loan_id: "LN-2024-4821", env: "prod" },
  context: {
    loan_id: { borrower: "Alice Rivera", amount: 420000 },
    env: { displayName: "Production", region: "us-east-1" },
  },
});

// Flush pending events
await client.flush();

// Clean shutdown
await client.close();