@friskai/frisk-js 0.3.0 → 0.3.2

package/dist/core/frisk-session.d.ts

@@ -3,11 +3,12 @@
  *
  * FriskSession represents a single session for tracking tool calls and tracing.
  */
-import { Span, Tracer } from '@opentelemetry/api';
+import { type Tracer } from '@opentelemetry/api';
 import { FriskSDKLoggingOptions, SDKLogger } from '../logging';
 import type { DecideToolCallOptions } from './extensions';
 import type { Frisk } from './frisk';
 import { type ResolvedRedactionOptions } from './redaction-options';
+import { FriskSpan, LlmCallSpan, OperationSpan, SessionSpan, ToolCallObservationSpan } from './spans';
 import { ToolCallDecision } from './types';
 type AnyFrisk = Frisk<any, any, any, any>;
 export interface FriskSessionOptions<FriskClass extends AnyFrisk = AnyFrisk> {
@@ -45,23 +46,40 @@ export declare class FriskSession<TFrisk extends AnyFrisk = AnyFrisk> {
     private toolCallSequenceNumber;
     private toolCallSequenceGenerator;
     private toolCallErrorCount;
+    private tokenUsageInput;
+    private tokenUsageOutput;
+    private tokenUsageTotal;
     constructor({ frisk, redact, tracer, logging }: FriskSessionOptions<TFrisk>);
-    get rootSpan(): Span | null;
+    get rootSpan(): SessionSpan | null;
     getTracer(): Tracer;
     /**
      * Check if tracing is active
      */
     get isTracing(): boolean;
     get rootRunId(): string | null;
-    createToolCallSpan({ name, args: toolArgsInput, agentState, }: {
+    /**
+     * Open a span for a single LLM invocation, parented under `parent` (or the
+     * session root span).
+     */
+    createLlmCallSpan({ parent, }?: {
+        parent?: FriskSpan | null;
+    }): LlmCallSpan;
+    /**
+     * Open a span for a single operation (e.g. a nested LangChain run), parented
+     * under `parent` (or the session root span).
+     */
+    createOperationSpan({ parent, }?: {
+        parent?: FriskSpan | null;
+    }): OperationSpan;
+    createToolCallSpan({ name, args: toolArgsInput, agentState, parent, }: {
         name: string;
         args: object | any;
         agentState?: Record<string, unknown> | null;
-    }): Promise<Span>;
-    closeToolCallSpan({ toolCallId, // todo! Make this a method on toolcallspan
-    span, err, status, }: {
+        parent?: FriskSpan | null;
+    }): Promise<ToolCallObservationSpan>;
+    closeToolCallSpan({ toolCallId, span, err, status, }: {
         toolCallId: string | null;
-        span: Span;
+        span: ToolCallObservationSpan;
         status: ToolCallStatus | null;
         err: Error | null;
     }): void;
@@ -71,17 +89,32 @@ export declare class FriskSession<TFrisk extends AnyFrisk = AnyFrisk> {
      *
      * This method wraps the tool call evaluation in an OpenTelemetry span,
      * handling redaction of sensitive data, latency recording, and trace
-     * context propagation.
+     * context propagation. Serialization/redaction and decision/error
+     * translation live here; the span is a pure typed-attribute wrapper.
      */
     decideToolCall({ toolCall, agentState, }: DecideToolCallOptions): ToolCallDecision;
     private createToolCallSequenceGenerator;
     getToolCallCount(): number;
     incrementToolCallErrors(): void;
     getToolCallErrorCount(): number;
+    /**
+     * Add one LLM call's token usage to the session running totals and mirror the
+     * cumulative values onto the root session span. Missing counts default to 0.
+     */
+    recordTokenUsage({ inputTokens, outputTokens, totalTokens, }: {
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    }): void;
+    getTokenUsage(): {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
     /**
      * Initialize tracing for this session
      */
-    initTracing({ runId, agentState }: InitTracingOptions): Span;
+    initTracing({ runId, agentState }: InitTracingOptions): SessionSpan;
     /**
      * End tracing for this session
      */
@@ -89,7 +122,7 @@ export declare class FriskSession<TFrisk extends AnyFrisk = AnyFrisk> {
     /**
      * Set the root span for the session
      */
-    setRootSpan(span: Span): void;
+    setRootSpan(span: SessionSpan): void;
     private static generateSessionId;
 }
 export {};

package/dist/core/frisk-session.d.ts.map

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

package/dist/core/llm-reasoning/extractLlmReasoning.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Return the synthetic LLM reasoning argument as a string, if present.
+ *
+ * Returns `null` when `toolArgs` is not a plain object or the reasoning arg is
+ * absent or nullish.
+ */
+export declare function extractLlmReasoning(toolArgs: unknown): string | null;
+//# sourceMappingURL=extractLlmReasoning.d.ts.map

package/dist/core/llm-reasoning/extractLlmReasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractLlmReasoning.d.ts","sourceRoot":"","sources":["../../../src/core/llm-reasoning/extractLlmReasoning.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAepE"}

package/dist/core/spans/frisk-span.d.ts

@@ -0,0 +1,38 @@
+/**
+ * FriskSpan — typed wrapper around an OpenTelemetry span with an in-memory
+ * attribute mirror.
+ *
+ * Subclasses pass their `spanName` and `attributeFields` (public camelCase
+ * field name -> telemetry attribute constant) to `super()` and expose a typed
+ * `setAttributes({...})` API. Every write is validated against the field map,
+ * mirrored into an in-memory record (keyed by constant), and written verbatim
+ * to the underlying otel span. Span classes never format or transform values.
+ */
+import { type AttributeValue, type Span, type Tracer } from '@opentelemetry/api';
+export declare abstract class FriskSpan {
+    private readonly _spanName;
+    private readonly _attributeFields;
+    private readonly _otelSpan;
+    private readonly _attributes;
+    private _ended;
+    protected constructor({ tracer, parent, spanName, attributeFields, }: {
+        tracer: Tracer;
+        parent?: FriskSpan | null;
+        spanName: string;
+        attributeFields: Readonly<Record<string, string>>;
+    });
+    /** The wrapped otel span. Internal to `core` (trace-context propagation). */
+    get otelSpan(): Span;
+    /** The otel span id — for cross-span linkage without leaking otel types. */
+    get spanId(): string;
+    /** Set a single attribute by field name, e.g. `setAttribute('prompt', x)`. */
+    setAttribute(field: string, value: AttributeValue): void;
+    /** Read the in-memory value for `field`, or undefined if not set. */
+    getAttribute(field: string): AttributeValue | undefined;
+    /** End the underlying otel span. Subsequent calls are no-ops. */
+    end(): void;
+    /** Worker for subclasses' typed `setAttributes`. Skips null/undefined. */
+    protected setAttributesByField(values: Record<string, AttributeValue | null | undefined>): void;
+    private constantFor;
+}
+//# sourceMappingURL=frisk-span.d.ts.map

package/dist/core/spans/frisk-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frisk-span.d.ts","sourceRoot":"","sources":["../../../src/core/spans/frisk-span.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,IAAI,EACT,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAA;AAE3B,8BAAsB,SAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAM;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IACjE,OAAO,CAAC,MAAM,CAAQ;IAEtB,SAAS,aAAa,EACpB,MAAM,EACN,MAAM,EACN,QAAQ,EACR,eAAe,GAChB,EAAE;QACD,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;QACzB,QAAQ,EAAE,MAAM,CAAA;QAChB,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAClD;IASD,6EAA6E;IAC7E,IAAI,QAAQ,IAAI,IAAI,CAEnB;IAED,4EAA4E;IAC5E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,8EAA8E;IAC9E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAIxD,qEAAqE;IACrE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIvD,iEAAiE;IACjE,GAAG,IAAI,IAAI;IAQX,0EAA0E;IAC1E,SAAS,CAAC,oBAAoB,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC,GACxD,IAAI;IAWP,OAAO,CAAC,WAAW;CASpB"}

package/dist/core/spans/index.d.ts

@@ -0,0 +1,7 @@
+export { FriskSpan } from './frisk-span';
+export { LlmCallSpan } from './llm-call-span';
+export { OperationSpan } from './operation-span';
+export { SessionSpan } from './session-span';
+export { ToolCallDecisionSpan } from './tool-call-decision-span';
+export { ToolCallObservationSpan } from './tool-call-observation-span';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/spans/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/spans/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/core/spans/llm-call-span.d.ts

@@ -0,0 +1,23 @@
+import type { Tracer } from '@opentelemetry/api';
+import { FriskSpan } from './frisk-span';
+/** Typed span for a single LLM invocation. */
+export declare class LlmCallSpan extends FriskSpan {
+    constructor(args: {
+        tracer: Tracer;
+        parent?: FriskSpan | null;
+    });
+    setAttributes(values: {
+        sessionId?: string;
+        promptsJson?: string;
+        responsesJson?: string;
+        toolCallsJson?: string;
+        modelName?: string;
+        modelProvider?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+        errorType?: string;
+        errorMessage?: string;
+    }): void;
+}
+//# sourceMappingURL=llm-call-span.d.ts.map

package/dist/core/spans/llm-call-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-call-span.d.ts","sourceRoot":"","sources":["../../../src/core/spans/llm-call-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAehE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAgBxC,8CAA8C;AAC9C,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAI/D,aAAa,CAAC,MAAM,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,GAAG,IAAI;CAKT"}

package/dist/core/spans/operation-span.d.ts

@@ -0,0 +1,13 @@
+import type { Tracer } from '@opentelemetry/api';
+import { FriskSpan } from './frisk-span';
+/** Typed span for a single operation (e.g. a nested LangChain run). */
+export declare class OperationSpan extends FriskSpan {
+    constructor(args: {
+        tracer: Tracer;
+        parent?: FriskSpan | null;
+    });
+    setAttributes(values: {
+        sessionId?: string;
+    }): void;
+}
+//# sourceMappingURL=operation-span.d.ts.map

package/dist/core/spans/operation-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-span.d.ts","sourceRoot":"","sources":["../../../src/core/spans/operation-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAKhE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAMxC,uEAAuE;AACvE,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAI/D,aAAa,CAAC,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAKpD"}

package/dist/core/spans/session-span.d.ts

@@ -0,0 +1,20 @@
+import type { Tracer } from '@opentelemetry/api';
+import { FriskSpan } from './frisk-span';
+/** Typed span for the Frisk session root. */
+export declare class SessionSpan extends FriskSpan {
+    constructor(args: {
+        tracer: Tracer;
+        parent?: FriskSpan | null;
+    });
+    setAttributes(values: {
+        sessionId?: string;
+        remoteSessionId?: string;
+        prompt?: string;
+        toolCallCount?: number;
+        toolCallErrorCount?: number;
+        inputTokens?: number;
+        outputTokens?: number;
+        totalTokens?: number;
+    }): void;
+}
+//# sourceMappingURL=session-span.d.ts.map

package/dist/core/spans/session-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-span.d.ts","sourceRoot":"","sources":["../../../src/core/spans/session-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAYhE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAcxC,6CAA6C;AAC7C,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAQ/D,aAAa,CAAC,MAAM,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,GAAG,IAAI;CAKT"}

package/dist/core/spans/tool-call-decision-span.d.ts

@@ -0,0 +1,27 @@
+import type { Tracer } from '@opentelemetry/api';
+import { FriskSpan } from './frisk-span';
+/** Typed span for a tool-call policy decision. */
+export declare class ToolCallDecisionSpan extends FriskSpan {
+    constructor(args: {
+        tracer: Tracer;
+        parent?: FriskSpan | null;
+    });
+    setAttributes(values: {
+        sessionId?: string;
+        toolName?: string;
+        toolCallId?: string;
+        toolArgsJson?: string;
+        toolArgsRedactedPathsJson?: string;
+        agentStateJson?: string;
+        agentStateRedactedPathsJson?: string;
+        friskToolId?: string;
+        friskToolVersionId?: string;
+        llmReasoning?: string;
+        decisionOutcome?: string;
+        decisionMatchedRuleCount?: number;
+        decisionReason?: string;
+        errorType?: string;
+        errorMessage?: string;
+    }): void;
+}
+//# sourceMappingURL=tool-call-decision-span.d.ts.map

package/dist/core/spans/tool-call-decision-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-decision-span.d.ts","sourceRoot":"","sources":["../../../src/core/spans/tool-call-decision-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAmBhE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAoBxC,kDAAkD;AAClD,qBAAa,oBAAqB,SAAQ,SAAS;gBACrC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAQ/D,aAAa,CAAC,MAAM,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,yBAAyB,CAAC,EAAE,MAAM,CAAA;QAClC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,2BAA2B,CAAC,EAAE,MAAM,CAAA;QACpC,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,wBAAwB,CAAC,EAAE,MAAM,CAAA;QACjC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,GAAG,IAAI;CAKT"}

package/dist/core/spans/tool-call-observation-span.d.ts

@@ -0,0 +1,28 @@
+import type { Tracer } from '@opentelemetry/api';
+import { FriskSpan } from './frisk-span';
+/** Typed span for observing an executed tool call. */
+export declare class ToolCallObservationSpan extends FriskSpan {
+    constructor(args: {
+        tracer: Tracer;
+        parent?: FriskSpan | null;
+    });
+    setAttributes(values: {
+        sessionId?: string;
+        toolName?: string;
+        toolCallId?: string;
+        toolArgsJson?: string;
+        toolArgsRedactedPathsJson?: string;
+        agentStateJson?: string;
+        agentStateRedactedPathsJson?: string;
+        toolCallSequenceNumber?: number;
+        friskToolId?: string;
+        friskToolVersionId?: string;
+        llmReasoning?: string;
+        isSuccess?: boolean;
+        isError?: boolean;
+        errorMessage?: string;
+        errorType?: string;
+        llmCallSpanId?: string;
+    }): void;
+}
+//# sourceMappingURL=tool-call-observation-span.d.ts.map

package/dist/core/spans/tool-call-observation-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-observation-span.d.ts","sourceRoot":"","sources":["../../../src/core/spans/tool-call-observation-span.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAoBhE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAqBxC,sDAAsD;AACtD,qBAAa,uBAAwB,SAAQ,SAAS;gBACxC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE;IAQ/D,aAAa,CAAC,MAAM,EAAE;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,yBAAyB,CAAC,EAAE,MAAM,CAAA;QAClC,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,2BAA2B,CAAC,EAAE,MAAM,CAAA;QACpC,sBAAsB,CAAC,EAAE,MAAM,CAAA;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAA;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,GAAG,IAAI;CAKT"}

package/dist/generated/sdk-meta.d.ts

@@ -1,3 +1,3 @@
 export declare const SDK_NAME: "@friskai/frisk-js";
-export declare const SDK_VERSION: "0.3.0";
+export declare const SDK_VERSION: "0.3.2";
 //# sourceMappingURL=sdk-meta.d.ts.map

package/dist/index.d.ts

@@ -36,8 +36,8 @@ export { Frisk } from './core/frisk';
 export { FriskSession } from './core/frisk-session';
 export { type RedactionOptions, type ResolvedRedactionOptions, } from './core/redaction-options';
 export { SessionRegistry } from './core/session-registry';
+export { FriskSpan, LlmCallSpan, OperationSpan, SessionSpan, ToolCallDecisionSpan, ToolCallObservationSpan, } from './core/spans';
 export { type ToolApprovalRequest, type ToolApprovalRequestInput, type ToolApprovalRequestStatusUpdateResult, ToolApprovalStatus, } from './core/tool-approval-request';
-export { ToolCallSpan } from './core/tool-call-span';
 export { DecisionOutcome, type FriskOptions, type NormalizedToolCall, type RedactionResult, type ToolCallDecision, type TraceContextCarrier, } from './core/types';
 export { FRISK_API_KEY, FRISK_BASE_URL, FRISK_BASE_URL_DEFAULT, FRISK_TELEMETRY_ENDPOINT, FRISK_TELEMETRY_ENDPOINT_DEFAULT, getEnv, requireEnv, } from './env';
 export { FriskBaseURLNotFoundError, FriskError, FriskInvalidAPIKeyError, InvalidAccessTokenError, InvalidFriskSessionError, MissingAPIKeyError, MissingBaseURLError, MissingFriskSessionContextError, MissingOtlpEndpointError, SessionNotFoundError, UnexpectedFriskServerResponseError, } from './errors';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,qCAAqC,EAC1C,kBAAkB,GACnB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,MAAM,EACN,UAAU,GACX,MAAM,OAAO,CAAA;AAEd,OAAO,EACL,yBAAyB,EACzB,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,kCAAkC,GACnC,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,qBAAqB,GAC3C,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,GACzB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,qCAAqC,EAC1C,kBAAkB,GACnB,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,gCAAgC,EAChC,MAAM,EACN,UAAU,GACX,MAAM,OAAO,CAAA;AAEd,OAAO,EACL,yBAAyB,EACzB,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,EACpB,kCAAkC,GACnC,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,qBAAqB,GAC3C,MAAM,qBAAqB,CAAA"}