@friskai/frisk-js 0.1.0

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

@@ -0,0 +1,105 @@
+/**
+ * @friskai/frisk-js LangChain Framework Adapter
+ *
+ * Framework adapter for LangChain integration.
+ * Handles LangChain-specific tool calls, serialization, and tool wrapping.
+ */
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import type { FrameworkAdapter, ToolCallInfo } from '../../framework-adapter/framework-adapter';
+import type { RedactedDictionary, RedactedSerializedObject, RedactOption } from '../../utils/redact';
+/**
+ * LangChain ToolCall type
+ * Represents a tool call from LangChain messages
+ */
+export interface LangChainToolCall {
+    id?: string;
+    name: string;
+    args: Record<string, unknown>;
+    type?: string;
+}
+export interface LangchainTool {
+}
+/**
+ * LangChain framework adapter
+ *
+ * Provides LangChain-specific implementation of the FrameworkAdapter interface.
+ * Handles ToolCall objects, message serialization, and tool wrapping.
+ *
+ * @example
+ * ```typescript
+ * import { LangchainFrameworkAdapter } from '@friskai/frisk-js';
+ *
+ * const adapter = new LangchainFrameworkAdapter();
+ *
+ * // Extract tool call info from a LangChain ToolCall
+ * const toolCallInfo = adapter.getToolCallInfo(toolCall);
+ *
+ * // Serialize agent state with redaction
+ * const serialized = adapter.serializeAgentState(state, {
+ *   redact: ['password', 'api_key'],
+ * });
+ * ```
+ */
+export declare class LangchainFrameworkAdapter implements FrameworkAdapter<LangChainToolCall, LangchainTool> {
+    /**
+     * Serialize tool arguments to JSON with optional redaction
+     */
+    serializeToolArgs(toolArgs: Record<string, unknown> | null | undefined, options?: {
+        redact?: RedactOption;
+    }): RedactedSerializedObject;
+    /**
+     * Serialize agent state to JSON with optional redaction
+     *
+     * Automatically excludes the 'messages' key from serialization
+     * as it typically contains large message arrays.
+     */
+    serializeAgentState(agentState: Record<string, unknown> | null | undefined, options?: {
+        redact?: RedactOption;
+    }): RedactedSerializedObject;
+    /**
+     * Convert tool arguments to dictionary with optional redaction
+     */
+    toolArgsToDict(toolArgs: Record<string, unknown>, options?: {
+        redact?: RedactOption;
+    }): RedactedDictionary;
+    /**
+     * Convert agent state to dictionary with optional redaction
+     *
+     * Automatically combines the provided redact option with EXCLUDED_STATE_KEYS
+     */
+    agentStateToDict(agentState: Record<string, unknown>, options?: {
+        redact?: RedactOption;
+    }): RedactedDictionary;
+    /**
+     * Extract tool call information from a LangChain ToolCall
+     */
+    getToolCallInfo(toolCall: LangChainToolCall): ToolCallInfo;
+    /**
+     * Get the tool call ID or generate one if not present
+     */
+    private getOrCreateToolCallId;
+    /**
+     * Get the tool name from a ToolCall
+     */
+    private getToolName;
+    /**
+     * Extract the user query from agent state
+     *
+     * Looks for the last human message in the messages array
+     */
+    getUserQuery(agentState: Record<string, unknown>): string | null;
+    /**
+     * Wrap tools with additional functionality
+     *
+     * Note: For Frisk policy enforcement, use FriskLangChain.wrapTools() instead.
+     * This method provides basic tool wrapping without policy checks.
+     */
+    wrapTools(tools: Iterable<DynamicStructuredTool>): DynamicStructuredTool[];
+    /**
+     * Wrap a single tool
+     *
+     * This is a passthrough by default. Override in subclasses for custom wrapping.
+     */
+    private wrapTool;
+}
+//# sourceMappingURL=langchain-framework-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"langchain-framework-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/langchain/langchain-framework-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,2CAA2C,CAAA;AAClD,OAAO,KAAK,EACV,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACb,MAAM,oBAAoB,CAAA;AAO3B;;;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,MAAM,WAAW,aAAa;CAE7B;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,yBACX,YAAW,gBAAgB,CAAC,iBAAiB,EAAE,aAAa,CAAC;IAE7D;;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,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,YAAY;IAQ1D;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IA6BhE;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,EAAE;IAI1E;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAMjB"}

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

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Context key for the Frisk session ID in LangGraph runtime context
+ */
+export declare const FRISK_SESSION_ID_KEY = "frisk_session_id";
+export type FriskContext = {
+    frisk_session_id: string | undefined;
+};
+export declare const RUNTIME_CONTEXT_KEY = "context";
+export declare const FriskContextSchema: z.ZodObject<{
+    frisk_session_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/langchain/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AACtD,MAAM,MAAM,YAAY,GAAG;IAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAGnE,eAAO,MAAM,mBAAmB,YAAY,CAAA;AAE5C,eAAO,MAAM,kBAAkB;;iBAE7B,CAAA"}

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

@@ -0,0 +1,6 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { ZodObject } from 'zod/v4';
+export declare const LLM_REASONING_ARG_NAME = "llmReasoning";
+export declare function removeLlmReasoningArg<T extends object>(input: T): Omit<T, typeof LLM_REASONING_ARG_NAME>;
+export declare function wrapToolWithReasoning(tool: DynamicStructuredTool<ZodObject>): any;
+//# sourceMappingURL=wrapToolWithReasoning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrapToolWithReasoning.d.ts","sourceRoot":"","sources":["../../../src/adapters/langchain/wrapToolWithReasoning.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EAItB,MAAM,uBAAuB,CAAA;AAO9B,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAQlC,eAAO,MAAM,sBAAsB,iBAAiB,CAAA;AAEpD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,KAAK,EAAE,CAAC,GACP,IAAI,CAAC,CAAC,EAAE,OAAO,sBAAsB,CAAC,CASxC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,GACrC,GAAG,CAuDL"}

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

@@ -0,0 +1,44 @@
+/**
+ * @friskai/frisk-js Options Utilities
+ *
+ * Helpers for normalizing and validating Frisk options.
+ */
+/**
+ * Options for initializing the Frisk SDK
+ */
+export interface FriskOptions {
+    /**
+     * Redaction configuration for tool arguments.
+     * - `true`: Redact all fields in tool arguments
+     * - `false`: Do not redact any fields
+     * - `string[]`: Array of field names to selectively redact
+     */
+    redactToolArgs?: boolean | string[];
+    /**
+     * Redaction configuration for agent state.
+     * - `true`: Redact all fields in agent state
+     * - `false`: Do not redact any fields
+     * - `string[]`: Array of field names to selectively redact
+     */
+    redactAgentState?: boolean | string[];
+}
+/**
+ * Normalized Frisk options with defaults applied
+ */
+export interface NormalizedFriskOptions {
+    redactToolArgs: boolean | string[];
+    redactAgentState: boolean | string[];
+}
+/**
+ * Normalize Frisk options with defaults
+ */
+export declare function normalizeFriskOptions(options?: FriskOptions): NormalizedFriskOptions;
+/**
+ * Convert SDK options to core (Rust binding) format
+ * Note: The auto-generated types now use camelCase
+ */
+export declare function toCoreFriskOptions(options: NormalizedFriskOptions): {
+    redactToolArgs?: boolean | string[];
+    redactAgentState?: boolean | string[];
+};
+//# sourceMappingURL=frisk-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frisk-options.d.ts","sourceRoot":"","sources":["../../src/core/frisk-options.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;IAEnC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;IAClC,gBAAgB,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;CACrC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,YAAY,GACrB,sBAAsB,CAKxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,sBAAsB,GAAG;IACnE,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;IACnC,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAA;CACtC,CAKA"}

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

@@ -0,0 +1,82 @@
+/**
+ * @friskai/frisk-js Session
+ *
+ * FriskSession represents a single session for tracking tool calls and tracing.
+ */
+import type { Span, Tracer } from '@opentelemetry/api';
+import { FriskSDKLogOptions } from '../logging';
+import type { Frisk } from './frisk';
+import { type NormalizedFriskOptions } from './frisk-options';
+import { ProcessToolCallResult, ToolCallInfo } from './types';
+interface FriskSessionInitParams {
+    frisk: Frisk;
+    sessionId: string;
+    options: NormalizedFriskOptions;
+    tracer: Tracer;
+    logging?: FriskSDKLogOptions;
+}
+/**
+ * A Frisk session for tracking a sequence of tool calls
+ *
+ * Sessions provide:
+ * - Tool call evaluation against policies
+ * - Tracing context for distributed tracing
+ * - State management for the session lifecycle
+ */
+export declare class FriskSession {
+    private _frisk;
+    private _sessionId;
+    private _options;
+    private _tracer;
+    private _rootSpan;
+    private _rootRunId;
+    private _isTracing;
+    private logger;
+    constructor({ frisk, sessionId, options, tracer, logging, }: FriskSessionInitParams);
+    /**
+     * Get the session ID
+     */
+    get sessionId(): string;
+    /**
+     * Get the root run ID for tracing
+     */
+    get rootRunId(): string | null;
+    /**
+     * Check if tracing is active
+     */
+    get isTracing(): boolean;
+    /**
+     * Get the Frisk instance
+     */
+    get frisk(): Frisk;
+    /**
+     * Get the OpenTelemetry tracer
+     */
+    get tracer(): Tracer;
+    /**
+     * Get the root span for the session
+     */
+    get rootSpan(): Span | null;
+    /**
+     * Set the root span for the session
+     */
+    setRootSpan(span: Span): void;
+    /**
+     * Initialize tracing for this session
+     */
+    initTracing(runId: string, inputs: Record<string, unknown>): Span;
+    /**
+     * End tracing for this session
+     */
+    endTracing(): void;
+    /**
+     * Evaluate a tool call against policies
+     *
+     * This method wraps the tool call evaluation in an OpenTelemetry span,
+     * handling redaction of sensitive data, latency recording, and trace
+     * context propagation.
+     */
+    evaluateToolCall(toolCallInfo: ToolCallInfo, agentState: Record<string, unknown>): ProcessToolCallResult;
+}
+export {};
+//# sourceMappingURL=frisk-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frisk-session.d.ts","sourceRoot":"","sources":["../../src/core/frisk-session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,EAAE,kBAAkB,EAAa,MAAM,YAAY,CAAA;AAM1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAK7D,OAAO,EAEL,qBAAqB,EACrB,YAAY,EACb,MAAM,SAAS,CAAA;AAEhB,UAAU,sBAAsB;IAC9B,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,sBAAsB,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAC7B;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAO;IACrB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,MAAM,CAAW;gBAEb,EACV,KAAK,EACL,SAAS,EACT,OAAO,EACP,MAAM,EACN,OAAO,GACR,EAAE,sBAAsB;IAUzB;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,IAAI,GAAG,IAAI,CAE1B;IAED;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI7B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAgBjE;;OAEG;IACH,UAAU,IAAI,IAAI;IAWlB;;;;;;OAMG;IACH,gBAAgB,CACd,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,qBAAqB;CAuDzB"}

package/dist/core/frisk.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @friskai/frisk-js Frisk SDK
+ *
+ * Main entry point for the Frisk SDK. Provides a high-level API for
+ * policy evaluation, session management, and tool wrapping.
+ */
+import { FrameworkAdapter } from '../framework-adapter';
+import { LogLevel, SDKLogger } from '../logging';
+import { type FriskHandleInstance } from '../native-bindings';
+import { TracerHandle } from '../telemetry/tracer-handle';
+import { FriskSession } from './frisk-session';
+import type { FriskInitParams, ProcessToolCallResult, RedactionResult, ToolCallInfo, TraceContextCarrier } from './types';
+/**
+ * Main Frisk SDK class
+ *
+ * Provides a high-level API for:
+ * - Policy evaluation for tool calls
+ * - Session management for tracking conversations
+ * - Redaction of sensitive data
+ * - Integration with LangChain and other frameworks
+ *
+ * @example
+ * ```typescript
+ * import { Frisk } from '@friskai/frisk-js';
+ *
+ * const frisk = new Frisk({
+ *   apiKey: process.env.FRISK_API_KEY,
+ *   baseUrl: 'https://api.frisk.ai',
+ *   options: {
+ *     redactToolArgs: ['password', 'api_key'],
+ *     redactAgentState: true,
+ *   },
+ * });
+ *
+ * // Create a session for tracking
+ * const sessionId = frisk.createSession();
+ *
+ * // Evaluate a tool call
+ * const result = frisk.evaluateToolCall(
+ *   'send_email',
+ *   { recipient: 'user@example.com' },
+ *   { userId: 123 }
+ * );
+ *
+ * if (result.decision === ProcessToolCallDecision.ALLOW) {
+ *   // Execute the tool
+ * }
+ * ```
+ */
+export declare class Frisk<ToolCallT = unknown, ToolT = unknown> {
+    private options;
+    private baseUrl;
+    private telemetryEndpoint;
+    private tokenManager;
+    private initialized;
+    protected rootLogger: SDKLogger;
+    protected logger: SDKLogger;
+    protected logLevel?: LogLevel;
+    get frameworkAdapter(): FrameworkAdapter;
+    private _frameworkAdapter;
+    /**
+     * Get the native handle (for internal use)
+     * @internal
+     */
+    get friskHandle(): FriskHandleInstance;
+    private _friskHandle;
+    /**
+     * Get the OpenTelemetry tracer handle
+     */
+    get tracerHandle(): TracerHandle;
+    private _tracerHandle;
+    constructor(params?: FriskInitParams<ToolCallT, ToolT>);
+    init(): Promise<void>;
+    /**
+     * Extract tool call information using the framework adapter
+     */
+    getToolCallInfo(toolCall: ToolCallT): ToolCallInfo;
+    /**
+     * Wrap tools with LLM reasoning using the framework adapter
+     */
+    wrapTools(tools: Iterable<ToolT>): ToolT[];
+    /**
+     * Wrap a single tool with LLM reasoning using the framework adapter
+     */
+    wrapTool(tool: ToolT): ToolT;
+    /**
+     * Create a new session for tracking tool calls
+     *
+     * @returns The session ID
+     */
+    createSession(): string;
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): FriskSession;
+    /**
+     * Update the authentication token
+     *
+     * This is used for token refresh when the current token expires.
+     */
+    updateAuthToken(authToken: string): void;
+    /**
+     * Evaluate a tool call against policies
+     *
+     * @param toolName - Name of the tool being called
+     * @param toolArgs - Arguments passed to the tool
+     * @param agentState - Current state of the agent
+     * @param toolCallId - Optional unique identifier for the tool call
+     * @param traceContextCarrier - Optional trace context for distributed tracing
+     * @returns The policy evaluation result
+     */
+    evaluateToolCall(toolName: string, toolArgs: Record<string, unknown> | null, agentState: Record<string, unknown> | null, toolCallId?: string, traceContextCarrier?: TraceContextCarrier): ProcessToolCallResult;
+    /**
+     * Redact sensitive fields from data
+     *
+     * @param data - Object or JSON string to redact
+     * @param redactOption - Redaction configuration
+     * @returns The redaction result
+     */
+    redact(data: Record<string, unknown> | string, redactOption: boolean | string[]): RedactionResult;
+    /**
+     * Shutdown the Frisk SDK and flush telemetry
+     *
+     * This method flushes all pending spans to the telemetry backend
+     * before shutting down. Always call this before your process exits
+     * to ensure all telemetry data is exported.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=frisk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frisk.d.ts","sourceRoot":"","sources":["../../src/core/frisk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,OAAO,EAAwB,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAMzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAI9C,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAGhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,KAAK,CAAC,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IACrD,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAAiB;IACpC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAA;IAC/B,SAAS,CAAC,MAAM,EAAE,SAAS,CAAA;IAC3B,SAAS,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAE7B,IAAW,gBAAgB,IAAI,gBAAgB,CAE9C;IACD,OAAO,CAAC,iBAAiB,CAAoC;IAE7D;;;OAGG;IACH,IAAI,WAAW,IAAI,mBAAmB,CAKrC;IACD,OAAO,CAAC,YAAY,CAAmC;IAEvD;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,CAK/B;IACD,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,CAAC,EAAE,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC;IA4DzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBlC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY;IAIlD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE;IAO1C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK;IAO5B;;;;OAIG;IACH,aAAa,IAAI,MAAM;IAoBvB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAK3C;;;;OAIG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;;;;;;OASG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1C,UAAU,CAAC,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,qBAAqB;IA6BxB;;;;;;OAMG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EACtC,YAAY,EAAE,OAAO,GAAG,MAAM,EAAE,GAC/B,eAAe;IAUlB;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAShC"}

package/dist/core/install-graceful-shutdown.d.ts

@@ -0,0 +1,67 @@
+export type ShutdownReason = {
+    kind: 'signal';
+    signal: NodeJS.Signals;
+} | {
+    kind: 'beforeExit';
+    code: number;
+} | {
+    kind: 'manual';
+};
+export type InstallGracefulShutdownOptions = {
+    /**
+     * Signals you consider "graceful shutdown" triggers.
+     * In servers, SIGTERM is the big one (k8s/docker/systemd).
+     */
+    signals?: readonly NodeJS.Signals[];
+    /**
+     * If true, hook process.beforeExit to catch "normal" program completion.
+     * For long-running servers, this is usually false.
+     *
+     * NOTE: beforeExit can fire multiple times if you schedule work in it.
+     * This helper is idempotent to prevent loops.
+     */
+    hookBeforeExit?: boolean;
+    /**
+     * If provided, start a timer once shutdown begins. When reached:
+     * - sets process.exitCode to non-zero (cooperative)
+     * - optionally force exits (NOT recommended for SDKs)
+     */
+    hardTimeoutMs?: number;
+    /**
+     * If true, when hard timeout is reached, call process.exit(1).
+     * Default false (SDK-friendly; avoids cutting off other libraries).
+     */
+    forceExitOnHardTimeout?: boolean;
+    /**
+     * Exit code to use if hard timeout is reached.
+     * Default 1.
+     */
+    hardTimeoutExitCode?: number;
+    /**
+     * If true (default), once shutdown completes due to a signal,
+     * we re-send the signal to ourselves (after removing our listener)
+     * so the process exits with conventional semantics.
+     *
+     * If your host app manages exit itself, you can set this to false.
+     */
+    reRaiseSignalAfterShutdown?: boolean;
+    /**
+     * If true (default), if another signal arrives while shutdown is already running,
+     * immediately re-raise that signal to exit ASAP (common "second Ctrl+C kills now").
+     */
+    fastExitOnSecondSignal?: boolean;
+};
+export type GracefulShutdownHandle = {
+    /** Manually trigger shutdown (useful in tests or explicit server stop flows). */
+    shutdown: (reason?: ShutdownReason) => Promise<void>;
+    /** Remove installed listeners (useful if your library can be started/stopped). */
+    uninstall: () => void;
+    /** Returns the in-flight shutdown promise if running, else null. */
+    getShutdownPromise: () => Promise<void> | null;
+};
+export declare const ShutdownOptionDefaults: {
+    Server: InstallGracefulShutdownOptions;
+    Script: InstallGracefulShutdownOptions;
+};
+export declare function installGracefulShutdown(shutdownFn: (reason: ShutdownReason) => Promise<void>, opts?: InstallGracefulShutdownOptions): GracefulShutdownHandle;
+//# sourceMappingURL=install-graceful-shutdown.d.ts.map

package/dist/core/install-graceful-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/core/install-graceful-shutdown.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtB,MAAM,MAAM,8BAA8B,GAAG;IAC3C;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,CAAA;IAEnC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IAExB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAEhC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAE5B;;;;;;OAMG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAA;IAEpC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,iFAAiF;IACjF,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,kFAAkF;IAClF,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/C,CAAA;AAED,eAAO,MAAM,sBAAsB;YAS5B,8BAA8B;YAS9B,8BAA8B;CACpC,CAAA;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,IAAI,GAAE,8BAA8D,GACnE,sBAAsB,CAsIxB"}

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

@@ -0,0 +1,2 @@
+export declare const LLM_REASONING_ARG_NAME = "llmReasoning";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/llm-reasoning/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,iBAAiB,CAAA"}

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

@@ -0,0 +1,3 @@
+import { LLM_REASONING_ARG_NAME } from './constants';
+export declare function removeLlmReasoningArg<T extends object>(input: T): Omit<T, typeof LLM_REASONING_ARG_NAME>;
+//# sourceMappingURL=removeLlmReasoningArg.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removeLlmReasoningArg.d.ts","sourceRoot":"","sources":["../../../src/core/llm-reasoning/removeLlmReasoningArg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEpD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,KAAK,EAAE,CAAC,GACP,IAAI,CAAC,CAAC,EAAE,OAAO,sBAAsB,CAAC,CAQxC"}

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

@@ -0,0 +1,50 @@
+/**
+ * @friskai/frisk-js Session Registry
+ *
+ * Global registry for tracking Frisk sessions.
+ */
+import type { FriskSession } from './frisk-session';
+/**
+ * Global registry for Frisk sessions
+ *
+ * This singleton registry maintains a mapping of session IDs to FriskSession instances.
+ * It allows callbacks and middleware to retrieve session context without direct references.
+ */
+export declare class SessionRegistry {
+    private static instance;
+    private sessions;
+    /**
+     * Get the singleton SessionRegistry instance
+     */
+    static getInstance(): SessionRegistry;
+    /**
+     * Private constructor to enforce singleton pattern
+     */
+    private constructor();
+    /**
+     * Register a session in the registry
+     */
+    register(sessionId: string, session: FriskSession): void;
+    /**
+     * Get a session by ID
+     * @throws {SessionNotFoundError} if session is not found
+     */
+    get(sessionId: string): FriskSession;
+    /**
+     * Check if a session exists
+     */
+    has(sessionId: string): boolean;
+    /**
+     * Remove a session from the registry
+     */
+    unregister(sessionId: string): boolean;
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clear(): void;
+    /**
+     * Get the number of registered sessions
+     */
+    get size(): number;
+}
+//# sourceMappingURL=session-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../../src/core/session-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,eAAe;IAOrC;;OAEG;IACH,OAAO;IAEP;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAIxD;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;IAQpC;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}