@friskai/frisk-js 0.2.10 → 0.3.1

package/dist/adapters/langchain/langchain-framework-adapter/langchain-framework-adapter.d.ts

@@ -8,7 +8,7 @@ import { DynamicStructuredTool } from '@langchain/core/tools';
 import { ZodObject } from 'zod/v4';
 import type { RegisterToolProperties } from '../../../core/tool-registry';
 import { FrameworkAdapter, ToolCallInfo, WrapToolOptions } from '../../../framework-adapter/framework-adapter';
-import type { RedactedDictionary, RedactedSerializedObject, RedactOption } from '../../../utils/redact';
+import type { RedactedObject, RedactedSerializedObject, RedactOption } from '../../../utils/redact';
 /**
  * LangChain ToolCall type
  * Represents a tool call from LangChain messages
@@ -66,7 +66,7 @@ export declare class LangchainFrameworkAdapter implements FrameworkAdapter<Langc
      */
     toolArgsToDict(toolArgs: Record<string, unknown>, options?: {
         redact?: RedactOption;
-    }): RedactedDictionary;
+    }): RedactedObject;
     /**
      * Convert agent state to dictionary with optional redaction
      *
@@ -74,7 +74,7 @@ export declare class LangchainFrameworkAdapter implements FrameworkAdapter<Langc
      */
     agentStateToDict(agentState: Record<string, unknown>, options?: {
         redact?: RedactOption;
-    }): RedactedDictionary;
+    }): RedactedObject;
     /**
      * Extract tool call information from a LangChain ToolCall
      */

package/dist/adapters/langchain/langchain-framework-adapter/langchain-framework-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"langchain-framework-adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/langchain/langchain-framework-adapter/langchain-framework-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACzE,OAAO,EAEL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,8CAA8C,CAAA;AAErD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAS9B;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;CAG7B;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,yBACX,YAAW,gBAAgB,CAAC,iBAAiB,EAAE,aAAa,CAAC;IAE7D,SAAgB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAc;IAC3D,SAAgB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAC1B;IAE1B;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;;;;OAKG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,kBAAkB;IAIrB;;;;OAIG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,kBAAkB;IAQrB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,YAAY;IAQ5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IA6BjE;;;;;OAKG;IACH,SAAS,CACP,KAAK,EAAE,QAAQ,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,EACjD,OAAO,GAAE,eAAwC,GAChD,qBAAqB,EAAE;IAI1B;;;;OAIG;IACI,QAAQ,CACb,YAAY,EAAE,qBAAqB,CAAC,SAAS,CAAC,EAC9C,OAAO,GAAE,eAAwC,GAChD,qBAAqB;IAUxB,6BAA6B,CAC3B,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACrC,sBAAsB,GAAG,IAAI;CAYjC"}
+{"version":3,"file":"langchain-framework-adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/langchain/langchain-framework-adapter/langchain-framework-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACzE,OAAO,EAEL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,8CAA8C,CAAA;AAErD,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAM9B;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;CAG7B;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,yBACX,YAAW,gBAAgB,CAAC,iBAAiB,EAAE,aAAa,CAAC;IAE7D,SAAgB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAc;IAC3D,SAAgB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAC1B;IAE1B;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;;;;OAKG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,cAAc;IAIjB;;;;OAIG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,cAAc;IAQjB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,YAAY;IAQ5D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;;;OAIG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IA6BjE;;;;;OAKG;IACH,SAAS,CACP,KAAK,EAAE,QAAQ,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,EACjD,OAAO,GAAE,eAAwC,GAChD,qBAAqB,EAAE;IAI1B;;;;OAIG;IACI,QAAQ,CACb,YAAY,EAAE,qBAAqB,CAAC,SAAS,CAAC,EAC9C,OAAO,GAAE,eAAwC,GAChD,qBAAqB;IAUxB,6BAA6B,CAC3B,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACrC,sBAAsB,GAAG,IAAI;CAYjC"}

package/dist/core/extensions.d.ts

@@ -0,0 +1,30 @@
+import type { Frisk } from './frisk';
+import type { NormalizedToolCall, ToolCallDecision, TraceContextCarrier } from './types';
+type AnyFrisk = Frisk<any, any, any, any>;
+export interface FriskExtension {
+    readonly name: string;
+    initialize(frisk: AnyFrisk): void | Promise<void>;
+    shutdown(): void;
+}
+export type DecideToolCallOptions = {
+    toolCall: NormalizedToolCall;
+    agentState: Record<string, unknown>;
+    traceContextCarrier?: TraceContextCarrier;
+};
+export type ToolPoliciesDecideInput = {
+    toolCall: NormalizedToolCall;
+    toolArgsJson: string | null;
+    toolArgsRedactedJson: string | null;
+    toolArgsRedactedPathsJson: string;
+    agentStateJson: string | null;
+    agentStateRedactedJson: string | null;
+    agentStateRedactedPathsJson: string;
+    traceContextCarrier?: TraceContextCarrier;
+};
+export interface ToolPoliciesProvider extends FriskExtension {
+    readonly available: boolean;
+    decideToolCall(opts: ToolPoliciesDecideInput): ToolCallDecision;
+    updateAccessToken(token: string): void;
+}
+export {};
+//# sourceMappingURL=extensions.d.ts.map

package/dist/core/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/core/extensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAGhB,KAAK,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,QAAQ,IAAI,IAAI,CAAA;CACjB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,yBAAyB,EAAE,MAAM,CAAA;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,2BAA2B,EAAE,MAAM,CAAA;IACnC,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CAC1C,CAAA;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,cAAc,CAAC,IAAI,EAAE,uBAAuB,GAAG,gBAAgB,CAAA;IAC/D,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACvC"}

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

@@ -3,10 +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, Frisk } from './frisk';
+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> {
@@ -17,7 +19,7 @@ export interface FriskSessionOptions<FriskClass extends AnyFrisk = AnyFrisk> {
 }
 interface InitTracingOptions {
     runId: string;
-    inputs: Record<string, unknown>;
+    agentState: Record<string, unknown>;
 }
 export declare enum ToolCallStatus {
     Success = "success",
@@ -40,25 +42,44 @@ export declare class FriskSession<TFrisk extends AnyFrisk = AnyFrisk> {
     protected logger: SDKLogger;
     protected _rootRunId: string | null;
     protected _isTracing: boolean;
+    protected _agentState: Record<string, unknown> | null;
     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, }: {
+    /**
+     * 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;
-    }): Promise<Span>;
-    closeToolCallSpan({ toolCallId, // todo! Make this a method on toolcallspan
-    span, err, status, }: {
+        agentState?: Record<string, unknown> | null;
+        parent?: FriskSpan | null;
+    }): Promise<ToolCallObservationSpan>;
+    closeToolCallSpan({ toolCallId, span, err, status, }: {
         toolCallId: string | null;
-        span: Span;
+        span: ToolCallObservationSpan;
         status: ToolCallStatus | null;
         err: Error | null;
     }): void;
@@ -68,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, inputs }: InitTracingOptions): Span;
+    initTracing({ runId, agentState }: InitTracingOptions): SessionSpan;
     /**
      * End tracing for this session
      */
@@ -86,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/frisk.d.ts

@@ -7,21 +7,15 @@
 import { BaseFrameworkAdapter, FrameworkAdapter } from '../framework-adapter';
 import { WrapToolOptions } from '../framework-adapter/framework-adapter';
 import { LogLevel, SDKLogger } from '../logging';
-import { type FriskHandleInstance } from '../native-bindings';
 import { TracingManager } from '../telemetry/tracing-manager';
 import { AccessTokenProvider } from './access-token-provider';
+import type { DecideToolCallOptions } from './extensions';
 import { FriskSession } from './frisk-session';
 import { type ResolvedRedactionOptions } from './redaction-options';
 import { type ToolApprovalRequest, type ToolApprovalRequestInput, type ToolApprovalRequestStatusUpdateResult } from './tool-approval-request';
 import { ToolRegistryItem } from './tool-registry';
-import { FriskOptions, NormalizedToolCall, ToolCall, ToolCallDecision, TraceContextCarrier } from './types';
+import { FriskOptions, NormalizedToolCall, ToolCall, ToolCallDecision } from './types';
 type Ctor<T> = new (opts: any) => T;
-/** Input required to evaluate a normalized tool call within a session. */
-export type DecideToolCallOptions = {
-    toolCall: NormalizedToolCall;
-    agentState: Record<string, unknown>;
-    traceContextCarrier?: TraceContextCarrier;
-};
 /**
  * Main Frisk SDK class
  *
@@ -60,35 +54,31 @@ export type DecideToolCallOptions = {
  * ```
  */
 export declare class Frisk<ToolCallT extends ToolCall = ToolCall, ToolT = unknown, FrameworkAdapterT extends FrameworkAdapter<ToolCallT, ToolT> = BaseFrameworkAdapter, SessionMetadataT = never> {
+    get toolPoliciesAvailable(): boolean;
     get redaction(): ResolvedRedactionOptions;
     private _redaction;
-    protected apiBaseUrl: string;
-    protected otlpEndpoint: string;
-    protected accessTokenProvider: AccessTokenProvider;
+    readonly apiBaseUrl: string;
+    readonly otlpEndpoint: string;
+    readonly accessTokenProvider: AccessTokenProvider;
+    get adapter(): FrameworkAdapterT;
+    get logLevel(): LogLevel | undefined;
+    get tracingManager(): TracingManager;
     protected initialized: boolean;
     protected rootLogger: SDKLogger;
     protected logger: SDKLogger;
     private _logLevel?;
     private _adapter;
-    private _friskHandle;
     private _tracingManager;
-    private _toolRegistry;
+    private toolRegistry;
     private sdkAttributes;
+    private extensions;
+    private toolPolicies;
     private wrapToolsCalled;
     get toolRegistrationComplete(): Promise<boolean>;
-    get logLevel(): LogLevel | undefined;
     static connect<T extends Frisk>(this: Ctor<T>, options?: FriskOptions): Promise<T>;
     constructor(options?: FriskOptions<ToolCallT, ToolT, FrameworkAdapterT>);
-    /**
-     * Get the native handle (for internal use)
-     * @internal
-     */
-    get friskHandle(): FriskHandleInstance;
-    get adapter(): FrameworkAdapterT;
-    /**
-     * Get the OpenTelemetry tracer handle
-     */
-    get tracingManager(): TracingManager;
+    private mountExtensions;
+    private initializeExtensions;
     connect(): Promise<void>;
     /**
      * Create a new session for tracking tool calls

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

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

@@ -5,6 +5,7 @@
  */
 import { FrameworkAdapter } from '../framework-adapter';
 import type { FriskSDKLoggingOptions } from '../logging';
+import type { FriskExtension } from './extensions';
 import type { RedactionOptions } from './redaction-options';
 /**
  * Decision made by the policy engine for a tool call
@@ -72,6 +73,10 @@ export interface FriskOptions<ToolCallT = unknown, ToolT = unknown, FrameworkAda
      * Logging options for the SDK, including custom logger and log level.
      */
     logging?: FriskSDKLoggingOptions;
+    /**
+     * Extensions to register with the Frisk instance (e.g. ToolPolicies).
+     */
+    extensions?: FriskExtension[];
 }
 /** Raw tool-call shape accepted by generic Frisk evaluation APIs. */
 export interface ToolCall {

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D;;GAEG;AACH,oBAAY,eAAe;IACzB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IAExB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAC3B,SAAS,GAAG,OAAO,EACnB,KAAK,GAAG,OAAO,EACf,iBAAiB,SAAS,gBAAgB,CACxC,SAAS,EACT,KAAK,CACN,GAAG,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC;IAEtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAA;CACjC;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IAEZ,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D;;GAEG;AACH,oBAAY,eAAe;IACzB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,eAAe,CAAA;IAExB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAC3B,SAAS,GAAG,OAAO,EACnB,KAAK,GAAG,OAAO,EACf,iBAAiB,SAAS,gBAAgB,CACxC,SAAS,EACT,KAAK,CACN,GAAG,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC;IAEtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAA;IAE3B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAA;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAA;IAEhC;;OAEG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAA;CAC9B;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAA;IAEZ,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB"}

package/dist/errors/index.d.ts

@@ -97,6 +97,12 @@ export declare class FriskInvalidAPIKeyError extends Error {
 export declare class UnexpectedFriskServerResponseError extends Error {
     constructor(message?: string);
 }
+/**
+ * Error thrown when tool policy evaluation is attempted without the native extension available.
+ */
+export declare class MissingToolPoliciesExtensionError extends FriskError {
+    constructor(options?: FriskErrorOptions);
+}
 /** Raised when tool-call span APIs are used before span initialization. */
 export declare class ToolCallSpanNotInitializedError extends Error {
     constructor(message?: string);

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;CASzD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;CAO3D;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,UAAU;gBACjD,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;gBAC5C,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;CAO9D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAA;gBAEjB,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB;CAU9D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,SAAgC;CAIpD;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,SAAiC;CAIrD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,SAA0B;CAI9C;AAED;;GAEG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;gBAC/C,OAAO,SAA0C;CAI9D;AAED,2EAA2E;AAC3E,qBAAa,+BAAgC,SAAQ,KAAK;gBAEtD,OAAO,SAAiE;CAK3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;gBAE9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;CASzD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;gBACrC,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;CAO3D;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,UAAU;gBACjD,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;gBAC1C,OAAO,CAAC,EAAE,iBAAiB;CAOxC;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,UAAU;gBAC5C,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB;CAO9D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAA;gBAEjB,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB;CAU9D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,SAAgC;CAIpD;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,SAAiC;CAIrD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,SAA0B;CAI9C;AAED;;GAEG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;gBAC/C,OAAO,SAA0C;CAI9D;AAED;;GAEG;AACH,qBAAa,iCAAkC,SAAQ,UAAU;gBACnD,OAAO,CAAC,EAAE,iBAAiB;CAQxC;AAED,2EAA2E;AAC3E,qBAAa,+BAAgC,SAAQ,KAAK;gBAEtD,OAAO,SAAiE;CAK3E"}

package/dist/framework-adapter/base-framework-adapter.d.ts

@@ -5,7 +5,7 @@
  * Use this as a base for custom adapters or when not using a specific framework.
  */
 import type { RegisterToolProperties } from '../core/tool-registry';
-import type { RedactedDictionary, RedactedSerializedObject, RedactOption } from '../utils/redact';
+import type { RedactedObject, RedactedSerializedObject, RedactOption } from '../utils/redact';
 import type { FrameworkAdapter, ToolCallInfo } from './framework-adapter';
 /**
  * Generic tool call type for base adapter
@@ -52,13 +52,13 @@ export declare class BaseFrameworkAdapter implements FrameworkAdapter<GenericToo
      */
     toolArgsToDict(toolArgs: Record<string, unknown>, options?: {
         redact?: RedactOption;
-    }): RedactedDictionary;
+    }): RedactedObject;
     /**
      * Convert agent state to dictionary with optional redaction
      */
     agentStateToDict(agentState: Record<string, unknown>, options?: {
         redact?: RedactOption;
-    }): RedactedDictionary;
+    }): RedactedObject;
     /**
      * Extract tool call information from a generic tool call object
      */

package/dist/framework-adapter/base-framework-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-framework-adapter.d.ts","sourceRoot":"","sources":["../../src/framework-adapter/base-framework-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACb,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBACX,YAAW,gBAAgB,CAAC,eAAe,EAAE,OAAO,CAAC;IAErD,SAAgB,cAAc,UAAS;IACvC,SAAgB,qBAAqB,OAAO;IAE5C;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;OAEG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,kBAAkB;IAIrB;;OAEG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,kBAAkB;IAIrB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY;IAQ1D;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAKjE,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;CAG7E"}
+{"version":3,"file":"base-framework-adapter.d.ts","sourceRoot":"","sources":["../../src/framework-adapter/base-framework-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACb,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBACX,YAAW,gBAAgB,CAAC,eAAe,EAAE,OAAO,CAAC;IAErD,SAAgB,cAAc,UAAS;IACvC,SAAgB,qBAAqB,OAAO;IAE5C;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACpD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;OAEG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,wBAAwB;IAY3B;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,cAAc;IAIjB;;OAEG;IACH,gBAAgB,CACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,CAAA;KAAE,GAClC,cAAc;IAIjB;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,YAAY;IAQ1D;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAKjE,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,GAAG,IAAI;CAG7E"}

package/dist/framework-adapter/framework-adapter.d.ts

@@ -5,7 +5,7 @@
  * to integrate with different AI/LLM frameworks.
  */
 import type { RegisterToolProperties } from '../core/tool-registry';
-import type { RedactedDictionary, RedactedSerializedObject, RedactOption } from '../utils/redact';
+import type { RedactedObject, RedactedSerializedObject, RedactOption } from '../utils/redact';
 /**
  * Information about a tool call extracted by the framework adapter
  */
@@ -73,7 +73,7 @@ export interface FrameworkAdapter<ToolCallT = unknown, ToolT = unknown> {
      */
     toolArgsToDict(toolArgs: Record<string, unknown>, options?: {
         redact?: RedactOption;
-    }): RedactedDictionary;
+    }): RedactedObject;
     /**
      * Convert agent state to a dictionary with optional redaction
      *
@@ -83,7 +83,7 @@ export interface FrameworkAdapter<ToolCallT = unknown, ToolT = unknown> {
      */
     agentStateToDict(agentState: Record<string, unknown>, options?: {
         redact?: RedactOption;
-    }): RedactedDictionary;
+    }): RedactedObject;
     /**
      * Extract tool call information from a framework-specific tool call object
      *