@sensu-ai/sdk 0.1.1 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sensu-ai/sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "main": "./src/index.ts",
   "exports": {
@@ -8,6 +8,10 @@
     "./integrations/langchain": "./src/integrations/langchain.ts",
     "./integrations/openai": "./src/integrations/openai.ts"
   },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
   "dependencies": {
     "@sensu-ai/shared": "*",
     "zod": "^3.23.8"
@@ -27,9 +31,5 @@
     "openai": {
       "optional": true
     }
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
   }
-}
+}

package/src/client.ts

@@ -7,6 +7,21 @@ import type {
   TrackLlmOptions,
   TrackToolOptions,
   RawLlmCallOptions,
+  ContextBreakdown,
+  TrackRetrievalOptions,
+  RawRetrievalOptions,
+  TrackEmbeddingOptions,
+  RawEmbeddingOptions,
+  RecordFeedbackOptions,
+  RecordEvalScoreOptions,
+  HandoffOptions,
+  SpawnRunOptions,
+  TrackGuardrailOptions,
+  RawGuardrailOptions,
+  RecordPromptRenderOptions,
+  DeployPromptVersionOptions,
+  StartSessionOptions,
+  ResumeSessionOptions,
 } from './types.js';
 
 // ---------------------------------------------------------------------------
@@ -96,6 +111,7 @@ export class StepHandle {
 
     // Try to extract token usage from common response shapes
     const usage = extractUsage(result, opts.model);
+    const contextBreakdown = opts.extractContextBreakdown?.(result);
 
     this.client.enqueue({
       ...this.base(),
@@ -107,6 +123,7 @@ export class StepHandle {
       latency_ms: latencyMs,
       status,
       ...usage,
+      ...(contextBreakdown ? { context_breakdown: contextBreakdown } : {}),
     });
 
     if (err) throw err;
@@ -115,10 +132,12 @@ export class StepHandle {
 
   /** Emit a raw LLM call event (when you have the stats already) */
   recordLlm(opts: RawLlmCallOptions): void {
+    const { contextBreakdown, ...rest } = opts;
     this.client.enqueue({
       ...this.base(),
       event_type: 'llm.request.completed',
-      ...opts,
+      ...rest,
+      ...(contextBreakdown ? { context_breakdown: contextBreakdown } : {}),
     });
   }
 
@@ -152,6 +171,171 @@ export class StepHandle {
     return result;
   }
 
+  /** Track a retrieval call — wraps fn(), measures latency, emits started + completed */
+  async trackRetrieval(opts: TrackRetrievalOptions): Promise<unknown> {
+    const startMs = Date.now();
+    const spanId = randomUUID();
+
+    this.client.enqueue({
+      ...this.base(),
+      span_id: spanId,
+      event_type: 'retrieval.started',
+      vector_store_id: opts.vectorStoreId,
+      top_k: opts.topK,
+    });
+
+    let result: unknown;
+    let status: 'success' | 'error' = 'success';
+    let err: unknown;
+
+    try {
+      result = await opts.fn();
+    } catch (e) {
+      status = 'error';
+      err = e;
+    }
+
+    const latencyMs = Date.now() - startMs;
+
+    this.client.enqueue({
+      ...this.base(),
+      span_id: spanId,
+      event_type: 'retrieval.completed',
+      vector_store_id: opts.vectorStoreId,
+      top_k: opts.topK,
+      latency_ms: latencyMs,
+      status,
+    });
+
+    if (err) throw err;
+    return result;
+  }
+
+  /** Emit a raw retrieval completed event (when you have the stats already) */
+  recordRetrieval(opts: RawRetrievalOptions): void {
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'retrieval.completed',
+      ...opts,
+    });
+  }
+
+  /** Track an embedding call — wraps fn(), measures latency */
+  async trackEmbedding(opts: TrackEmbeddingOptions): Promise<unknown> {
+    const startMs = Date.now();
+    let result: unknown;
+    let err: unknown;
+
+    try {
+      result = await opts.fn();
+    } catch (e) {
+      err = e;
+    }
+
+    const latencyMs = Date.now() - startMs;
+
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'embedding.created',
+      model: opts.model,
+      input_text_length: opts.inputTextLength,
+      batch_size: opts.batchSize,
+      latency_ms: latencyMs,
+    });
+
+    if (err) throw err;
+    return result;
+  }
+
+  /** Emit a raw embedding event */
+  recordEmbedding(opts: RawEmbeddingOptions): void {
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'embedding.created',
+      model: opts.model,
+      input_text_length: opts.inputTextLength,
+      token_count: opts.tokenCount,
+      latency_ms: opts.latencyMs,
+      cost_usd_estimate: opts.costUsdEstimate,
+      batch_size: opts.batchSize,
+    });
+  }
+
+  /** Track a guardrail check — wraps fn(), measures latency, handles block */
+  async trackGuardrail(opts: TrackGuardrailOptions): Promise<'pass' | 'fail' | 'modified'> {
+    const startMs = Date.now();
+
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'guardrail.check.started',
+      guardrail_id: opts.guardrailId,
+      guardrail_type: opts.guardrailType,
+      input_hash: opts.inputHash,
+    });
+
+    let result: 'pass' | 'fail' | 'modified' = 'pass';
+    let err: unknown;
+
+    try {
+      result = await opts.fn();
+    } catch (e) {
+      err = e;
+    }
+
+    const latencyMs = Date.now() - startMs;
+
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'guardrail.check.completed',
+      guardrail_id: opts.guardrailId,
+      guardrail_type: opts.guardrailType,
+      input_hash: opts.inputHash,
+      result,
+      latency_ms: latencyMs,
+    });
+
+    if (err) throw err;
+    return result;
+  }
+
+  /** Emit a raw guardrail result (check or block) */
+  recordGuardrail(opts: RawGuardrailOptions): void {
+    if (opts.blocked) {
+      this.client.enqueue({
+        ...this.base(),
+        event_type: 'guardrail.blocked',
+        guardrail_id: opts.guardrailId,
+        guardrail_type: opts.guardrailType,
+        input_hash: opts.inputHash,
+        block_reason: opts.blockReason,
+        severity: opts.severity,
+      });
+    } else {
+      this.client.enqueue({
+        ...this.base(),
+        event_type: 'guardrail.check.completed',
+        guardrail_id: opts.guardrailId,
+        guardrail_type: opts.guardrailType,
+        input_hash: opts.inputHash,
+        result: opts.result,
+        latency_ms: opts.latencyMs,
+      });
+    }
+  }
+
+  /** Record a prompt template render event */
+  recordPromptRender(opts: RecordPromptRenderOptions): void {
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'prompt.rendered',
+      template_id: opts.templateId,
+      template_version: opts.templateVersion,
+      rendered_token_count: opts.renderedTokenCount,
+      variable_count: opts.variableCount,
+      latency_ms: opts.latencyMs,
+    });
+  }
+
   async end(): Promise<void> {
     if (this.ended) return;
     this.ended = true;
@@ -238,6 +422,41 @@ export class RunHandle {
     });
   }
 
+  /** Record user feedback for this run */
+  recordFeedback(opts: RecordFeedbackOptions): void {
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'feedback.received',
+      type: opts.type,
+      score: opts.score,
+      comment: opts.comment,
+      end_user_id: opts.endUserId,
+    });
+  }
+
+  /** Record an automated eval score for this run */
+  recordEvalScore(opts: RecordEvalScoreOptions): void {
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'eval.score.recorded',
+      metric: opts.metric,
+      score: opts.score,
+      evaluator_id: opts.evaluatorId,
+      model_used_for_eval: opts.modelUsedForEval,
+    });
+  }
+
+  /** Emit an agent.handoff event from this run to another agent */
+  handoff(opts: HandoffOptions): void {
+    this.client.enqueue({
+      ...this.base(),
+      event_type: 'agent.handoff',
+      to_agent_id: opts.toAgentId,
+      reason: opts.reason,
+      context_tokens_transferred: opts.contextTokensTransferred,
+    });
+  }
+
   async end(status: 'completed' | 'failed' = 'completed'): Promise<void> {
     if (this.ended) return;
     this.ended = true;
@@ -358,6 +577,124 @@ export class SensuClient {
     });
   }
 
+  /**
+   * Spawn a child agent run from within a parent run.
+   * Emits `agent.spawned` on the parent and returns a RunHandle for the child.
+   */
+  spawnRun(parentRun: RunHandle, opts: SpawnRunOptions): RunHandle {
+    const childRunId = opts.childRunId ?? randomUUID();
+    const childAgentId = opts.childAgentId;
+    const sessionId = opts.sessionId ?? parentRun.sessionId;
+    const traceId = parentRun.traceId;
+    const spanId = randomUUID();
+
+    // Emit agent.spawned on the parent run
+    this.enqueue({
+      event_id: randomUUID(),
+      event_type: 'agent.spawned',
+      timestamp: new Date().toISOString(),
+      org_id: this.orgId,
+      agent_id: parentRun.agentId,
+      session_id: sessionId,
+      run_id: parentRun.runId,
+      trace_id: traceId,
+      span_id: spanId,
+      child_run_id: childRunId,
+      child_agent_id: childAgentId,
+      spawn_reason: opts.spawnReason,
+    });
+
+    // Emit agent.run.started for the child run (child agent emits this itself in practice,
+    // but the SDK can also do it on behalf of known child agents)
+    this.enqueue({
+      event_id: randomUUID(),
+      event_type: 'agent.run.started',
+      timestamp: new Date().toISOString(),
+      org_id: this.orgId,
+      agent_id: childAgentId,
+      session_id: sessionId,
+      run_id: childRunId,
+      trace_id: traceId,
+      span_id: randomUUID(),
+      run_type: opts.runType,
+    });
+
+    return new RunHandle(this, {
+      runId: childRunId,
+      sessionId,
+      agentId: childAgentId,
+      orgId: this.orgId,
+      traceId,
+      spanId,
+    });
+  }
+
+  /** Explicitly start a session (sets channel and end_user_id) */
+  startSession(opts: StartSessionOptions = {}): string {
+    const sessionId = opts.sessionId ?? randomUUID();
+    const traceId = randomUUID();
+    const spanId = randomUUID();
+
+    this.enqueue({
+      event_id: randomUUID(),
+      event_type: 'session.started',
+      timestamp: new Date().toISOString(),
+      org_id: this.orgId,
+      agent_id: this.agentId,
+      session_id: sessionId,
+      run_id: sessionId, // run_id required by base schema; reuse session_id as placeholder
+      trace_id: traceId,
+      span_id: spanId,
+      channel: opts.channel,
+      end_user_id: opts.endUserId,
+    });
+
+    return sessionId;
+  }
+
+  /** Resume a previous session */
+  resumeSession(opts: ResumeSessionOptions): string {
+    const sessionId = opts.sessionId ?? randomUUID();
+    const traceId = randomUUID();
+    const spanId = randomUUID();
+
+    this.enqueue({
+      event_id: randomUUID(),
+      event_type: 'session.resumed',
+      timestamp: new Date().toISOString(),
+      org_id: this.orgId,
+      agent_id: this.agentId,
+      session_id: sessionId,
+      run_id: sessionId,
+      trace_id: traceId,
+      span_id: spanId,
+      resumed_from_session_id: opts.resumedFromSessionId,
+      channel: opts.channel,
+      end_user_id: opts.endUserId,
+    });
+
+    return sessionId;
+  }
+
+  /** Record a prompt version deployment (org-level event, not tied to a run) */
+  deployPromptVersion(opts: DeployPromptVersionOptions): void {
+    this.enqueue({
+      event_id: randomUUID(),
+      event_type: 'prompt.version.deployed',
+      timestamp: new Date().toISOString(),
+      org_id: this.orgId,
+      agent_id: this.agentId,
+      session_id: 'system',
+      run_id: 'system',
+      trace_id: randomUUID(),
+      span_id: randomUUID(),
+      template_id: opts.templateId,
+      new_version: opts.newVersion,
+      old_version: opts.oldVersion,
+      deployed_by: opts.deployedBy,
+    });
+  }
+
   destroy(): void {
     if (this.flushTimer) clearInterval(this.flushTimer);
   }

package/src/index.ts

@@ -6,4 +6,19 @@ export type {
   TrackLlmOptions,
   TrackToolOptions,
   RawLlmCallOptions,
+  ContextBreakdown,
+  TrackRetrievalOptions,
+  RawRetrievalOptions,
+  TrackEmbeddingOptions,
+  RawEmbeddingOptions,
+  RecordFeedbackOptions,
+  RecordEvalScoreOptions,
+  SpawnRunOptions,
+  HandoffOptions,
+  TrackGuardrailOptions,
+  RawGuardrailOptions,
+  RecordPromptRenderOptions,
+  DeployPromptVersionOptions,
+  StartSessionOptions,
+  ResumeSessionOptions,
 } from './types.ts';

package/src/types.ts

@@ -27,12 +27,25 @@ export interface StartStepOptions {
   stepId?: string;
 }
 
+export interface ContextBreakdown {
+  system_tokens?: number;
+  user_tokens?: number;
+  assistant_tokens?: number;
+  tool_tokens?: number;
+  retrieval_tokens?: number;
+}
+
 export interface TrackLlmOptions {
   provider: string;
   model: string;
   /** Wraps the LLM call and measures latency automatically */
   fn: () => Promise<unknown>;
   maxContextTokens?: number;
+  /**
+   * Optional callback to extract a context breakdown from the LLM response.
+   * Called with the raw response after fn() resolves.
+   */
+  extractContextBreakdown?: (result: unknown) => ContextBreakdown | undefined;
 }
 
 export interface LlmResult {
@@ -62,4 +75,139 @@ export interface RawLlmCallOptions {
   ttftMs?: number;
   costUsdEstimate?: number;
   status?: 'success' | 'error' | 'timeout';
+  contextBreakdown?: ContextBreakdown;
+}
+
+// ---------------------------------------------------------------------------
+// Retrieval & Embedding
+// ---------------------------------------------------------------------------
+
+export interface TrackRetrievalOptions {
+  /** Wraps the retrieval call and measures latency automatically */
+  fn: () => Promise<unknown>;
+  vectorStoreId?: string;
+  topK?: number;
+}
+
+export interface RawRetrievalOptions {
+  vectorStoreId?: string;
+  topK?: number;
+  latencyMs?: number;
+  chunksReturned?: number;
+  tokensInjected?: number;
+  similarityScoreAvg?: number;
+  status?: 'success' | 'error';
+}
+
+export interface TrackEmbeddingOptions {
+  model: string;
+  /** Wraps the embedding call and measures latency automatically */
+  fn: () => Promise<unknown>;
+  inputTextLength?: number;
+  batchSize?: number;
+}
+
+export interface RawEmbeddingOptions {
+  model: string;
+  inputTextLength?: number;
+  tokenCount?: number;
+  latencyMs?: number;
+  costUsdEstimate?: number;
+  batchSize?: number;
+}
+
+// ---------------------------------------------------------------------------
+// Evaluation & Feedback
+// ---------------------------------------------------------------------------
+
+export interface RecordFeedbackOptions {
+  type: 'thumbs_up' | 'thumbs_down' | 'score' | 'correction';
+  score?: number;
+  comment?: string;
+  endUserId?: string;
+}
+
+export interface RecordEvalScoreOptions {
+  metric: string;
+  score: number;
+  evaluatorId?: string;
+  modelUsedForEval?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Multi-Agent
+// ---------------------------------------------------------------------------
+
+export interface SpawnRunOptions {
+  childAgentId: string;
+  childRunId?: string;
+  spawnReason?: string;
+  /** Options forwarded to the child RunHandle */
+  runType?: string;
+  sessionId?: string;
+}
+
+export interface HandoffOptions {
+  toAgentId: string;
+  reason?: string;
+  contextTokensTransferred?: number;
+}
+
+// ---------------------------------------------------------------------------
+// Guardrails
+// ---------------------------------------------------------------------------
+
+export interface TrackGuardrailOptions {
+  guardrailId: string;
+  guardrailType?: 'content' | 'pii' | 'jailbreak' | 'custom';
+  inputHash?: string;
+  /** Wraps the guardrail check and measures latency automatically */
+  fn: () => Promise<'pass' | 'fail' | 'modified'>;
+}
+
+export interface RawGuardrailOptions {
+  guardrailId: string;
+  guardrailType?: 'content' | 'pii' | 'jailbreak' | 'custom';
+  inputHash?: string;
+  result?: 'pass' | 'fail' | 'modified';
+  blockReason?: string;
+  severity?: 'low' | 'medium' | 'high';
+  latencyMs?: number;
+  blocked?: boolean;
+}
+
+// ---------------------------------------------------------------------------
+// Prompt Management
+// ---------------------------------------------------------------------------
+
+export interface RecordPromptRenderOptions {
+  templateId: string;
+  templateVersion?: string;
+  renderedTokenCount?: number;
+  variableCount?: number;
+  latencyMs?: number;
+}
+
+export interface DeployPromptVersionOptions {
+  templateId: string;
+  newVersion: string;
+  oldVersion?: string;
+  deployedBy?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Session Lifecycle
+// ---------------------------------------------------------------------------
+
+export interface StartSessionOptions {
+  sessionId?: string;
+  channel?: 'web' | 'api' | 'mobile';
+  endUserId?: string;
+}
+
+export interface ResumeSessionOptions {
+  sessionId?: string;
+  resumedFromSessionId: string;
+  channel?: 'web' | 'api' | 'mobile';
+  endUserId?: string;
 }

package/dist/client.d.ts

@@ -1,76 +0,0 @@
-import type { TelemetryEvent } from '@sensu-ai/shared';
-import type { SensuClientOptions, StartRunOptions, StartStepOptions, TrackLlmOptions, TrackToolOptions, RawLlmCallOptions } from './types.js';
-export declare class StepHandle {
-    private readonly client;
-    readonly stepId: string;
-    readonly runId: string;
-    readonly sessionId: string;
-    readonly agentId: string;
-    readonly orgId: string;
-    readonly traceId: string;
-    readonly spanId: string;
-    private sequence;
-    private stepName?;
-    private ended;
-    constructor(client: SensuClient, opts: {
-        stepId: string;
-        runId: string;
-        sessionId: string;
-        agentId: string;
-        orgId: string;
-        traceId: string;
-        spanId: string;
-        sequence: number;
-        name?: string;
-    });
-    private base;
-    /** Track an LLM call — wraps fn(), measures latency, emits event */
-    trackLlm(opts: TrackLlmOptions): Promise<unknown>;
-    /** Emit a raw LLM call event (when you have the stats already) */
-    recordLlm(opts: RawLlmCallOptions): void;
-    /** Track a tool call — wraps fn(), measures latency */
-    trackTool(opts: TrackToolOptions): Promise<unknown>;
-    end(): Promise<void>;
-}
-export declare class RunHandle {
-    private readonly client;
-    readonly runId: string;
-    readonly sessionId: string;
-    readonly agentId: string;
-    readonly orgId: string;
-    readonly traceId: string;
-    readonly spanId: string;
-    private stepCount;
-    private ended;
-    constructor(client: SensuClient, opts: {
-        runId: string;
-        sessionId: string;
-        agentId: string;
-        orgId: string;
-        traceId: string;
-        spanId: string;
-    });
-    private base;
-    startStep(opts?: StartStepOptions): StepHandle;
-    end(status?: 'completed' | 'failed'): Promise<void>;
-}
-export declare class SensuClient {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly agentId;
-    private readonly orgId;
-    private readonly batchSize;
-    private readonly flushIntervalMs;
-    readonly disabled: boolean;
-    private buffer;
-    private flushTimer;
-    constructor(opts?: SensuClientOptions);
-    /** Enqueue an event for batched sending */
-    enqueue(event: TelemetryEvent): void;
-    /** Flush all buffered events to the Sensu API */
-    flush(): Promise<void>;
-    /** Start a new agent run */
-    startRun(opts?: StartRunOptions): RunHandle;
-    destroy(): void;
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-export { SensuClient, RunHandle, StepHandle } from './client.ts';
-export type { SensuClientOptions, StartRunOptions, StartStepOptions, TrackLlmOptions, TrackToolOptions, RawLlmCallOptions, } from './types.ts';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/integrations/langchain.d.ts

@@ -1,46 +0,0 @@
-/**
- * LangChain callback handler for Sensu telemetry.
- *
- * Usage:
- *   import { SensuCallbackHandler } from '@sensu-ai/sdk/integrations/langchain';
- *   const handler = new SensuCallbackHandler({ client: sensu });
- *   const chain = new LLMChain({ ..., callbacks: [handler] });
- */
-import type { SensuClient } from '../client.ts';
-interface LangChainCallbackHandlerOptions {
-    client: SensuClient;
-    sessionId?: string;
-    runId?: string;
-}
-interface LangChainLlmStartInput {
-    name?: string;
-    [key: string]: unknown;
-}
-interface LangChainLlmEndOutput {
-    generations?: Array<Array<{
-        text?: string;
-        generationInfo?: Record<string, unknown>;
-    }>>;
-    llmOutput?: Record<string, unknown>;
-}
-export declare class SensuCallbackHandler {
-    private readonly client;
-    private readonly sessionId;
-    private runId;
-    private traceId;
-    private startTimes;
-    private toolStartTimes;
-    private stepIds;
-    constructor(opts: LangChainCallbackHandlerOptions);
-    private base;
-    handleChainStart(_chain: unknown, _inputs: unknown, runId: string): Promise<void>;
-    handleChainEnd(_outputs: unknown, runId: string): Promise<void>;
-    handleLLMStart(llm: LangChainLlmStartInput, _prompts: string[], runId: string): Promise<void>;
-    handleLLMEnd(output: LangChainLlmEndOutput, runId: string): Promise<void>;
-    handleLLMError(err: Error, runId: string): Promise<void>;
-    handleToolStart(_tool: unknown, _input: string, runId: string): Promise<void>;
-    handleToolEnd(output: string, runId: string): Promise<void>;
-    handleToolError(err: Error, runId: string): Promise<void>;
-}
-export {};
-//# sourceMappingURL=langchain.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/integrations/langchain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,UAAU,+BAA+B;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,sBAAsB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,qBAAqB;IAC7B,WAAW,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,OAAO,CAAkC;gBAErC,IAAI,EAAE,+BAA+B;IAOjD,OAAO,CAAC,IAAI;IAcN,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IAajE,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IAW/C,cAAc,CAClB,GAAG,EAAE,sBAAsB,EAC3B,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,EAAE,MAAM;IAYT,YAAY,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM;IAsBzD,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;IAgBxC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAU7D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAgB3C,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;CAahD"}

package/dist/integrations/openai.d.ts

@@ -1,26 +0,0 @@
-/**
- * OpenAI SDK wrapper for Sensu telemetry.
- * Wraps the OpenAI client to automatically track all completions.
- *
- * Usage:
- *   import { wrapOpenAI } from '@sensu-ai/sdk/integrations/openai';
- *   const openai = wrapOpenAI(new OpenAI({ apiKey }), { client: sensu, runHandle });
- *   const resp = await openai.chat.completions.create({ ... }); // auto-tracked
- */
-import type { SensuClient, RunHandle } from '../client.ts';
-interface OpenAILike {
-    chat: {
-        completions: {
-            create: (params: unknown) => Promise<unknown>;
-        };
-    };
-}
-interface WrapOpenAIOptions {
-    client: SensuClient;
-    runHandle?: RunHandle;
-    defaultModel?: string;
-    defaultProvider?: string;
-}
-export declare function wrapOpenAI<T extends OpenAILike>(openai: T, opts: WrapOpenAIOptions): T;
-export {};
-//# sourceMappingURL=openai.d.ts.map

package/dist/integrations/openai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/integrations/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,UAAU,UAAU;IAClB,IAAI,EAAE;QACJ,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;SAC/C,CAAC;KACH,CAAC;CACH;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAaD,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAC7C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,iBAAiB,GACtB,CAAC,CAmEH"}

package/dist/types.d.ts

@@ -1,60 +0,0 @@
-export interface SensuClientOptions {
-    apiKey?: string;
-    baseUrl?: string;
-    agentId?: string;
-    orgId?: string;
-    /** Read config from environment variables */
-    fromEnv?: boolean;
-    /** Flush buffer when this many events accumulate */
-    batchSize?: number;
-    /** Flush buffer every N milliseconds */
-    flushIntervalMs?: number;
-    /** Disable all telemetry (useful for tests) */
-    disabled?: boolean;
-}
-export interface StartRunOptions {
-    sessionId?: string;
-    runType?: string;
-    endUserId?: string;
-    runId?: string;
-}
-export interface StartStepOptions {
-    name?: string;
-    stepType?: string;
-    sequence?: number;
-    stepId?: string;
-}
-export interface TrackLlmOptions {
-    provider: string;
-    model: string;
-    /** Wraps the LLM call and measures latency automatically */
-    fn: () => Promise<unknown>;
-    maxContextTokens?: number;
-}
-export interface LlmResult {
-    inputTokens?: number;
-    outputTokens?: number;
-    cachedInputTokens?: number;
-    totalTokens?: number;
-    costUsdEstimate?: number;
-    result: unknown;
-}
-export interface TrackToolOptions {
-    toolName: string;
-    fn: () => Promise<unknown>;
-}
-export interface RawLlmCallOptions {
-    provider: string;
-    model: string;
-    inputTokens?: number;
-    outputTokens?: number;
-    cachedInputTokens?: number;
-    totalTokens?: number;
-    maxContextTokens?: number;
-    contextUsedTokens?: number;
-    latencyMs?: number;
-    ttftMs?: number;
-    costUsdEstimate?: number;
-    status?: 'success' | 'error' | 'timeout';
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;CAC1C"}