@friskai/frisk-js 0.3.0 → 0.3.2

package/dist/telemetry/constants.d.ts

@@ -5,8 +5,32 @@ export declare const TRACER_VERSION = "0.1.0";
 /** Span name used for policy evaluation around a single tool call. */
 export declare const SPAN_NAME_DECIDE_TOOL_CALL = "frisk.tool_call.decide";
 export declare const SPAN_NAME_OBSERVE_TOOL_CALL = "frisk.tool_call.observation";
+/** Span name used for a single LLM invocation within a session. */
+export declare const SPAN_NAME_LLM_CALL = "frisk.llm_call";
+/** Span name used for a single operation (e.g. a LangChain run) within a session. */
+export declare const SPAN_NAME_OPERATION = "frisk.operation";
 /** Span name used for the parent Frisk session lifecycle span. */
 export declare const SPAN_NAME_FRISK_SESSION = "frisk.session";
+/** Tool-call span attribute linking back to the LLM call that announced it. */
+export declare const ATTRIBUTE_NAME_LLM_CALL_SPAN_ID = "frisk.tool_call.llm_call_span_id";
+/** LLM call span attribute holding the single prompt string. */
+export declare const ATTRIBUTE_NAME_LLM_CALL_PROMPT = "frisk.llm_call.prompt";
+/** LLM call span attribute holding the JSON-stringified prompt messages. */
+export declare const ATTRIBUTE_NAME_LLM_CALL_PROMPTS_JSON = "frisk.llm_call.prompts.json";
+/** LLM call span attribute holding the JSON-stringified responses. */
+export declare const ATTRIBUTE_NAME_LLM_CALL_RESPONSES_JSON = "frisk.llm_call.responses.json";
+/** LLM call span attribute holding the JSON-stringified requested tool calls. */
+export declare const ATTRIBUTE_NAME_LLM_CALL_TOOL_CALLS_JSON = "frisk.llm_call.tool_calls.json";
+/** LLM call span attribute for the model name. */
+export declare const ATTRIBUTE_NAME_MODEL_NAME = "frisk.model.name";
+/** LLM call span attribute for the model provider. */
+export declare const ATTRIBUTE_NAME_MODEL_PROVIDER = "frisk.model.provider";
+/** LLM call span attribute for input (prompt) token count. */
+export declare const ATTRIBUTE_NAME_TOKEN_USAGE_INPUT_TOKENS = "frisk.token_usage.input_tokens";
+/** LLM call span attribute for output (completion) token count. */
+export declare const ATTRIBUTE_NAME_TOKEN_USAGE_OUTPUT_TOKENS = "frisk.token_usage.output_tokens";
+/** LLM call span attribute for total token count. */
+export declare const ATTRIBUTE_NAME_TOKEN_USAGE_TOTAL_TOKENS = "frisk.token_usage.total_tokens";
 export declare const ATTRIBUTE_NAME_SESSION_PROMPT = "frisk.session.prompt";
 export declare const ATTRIBUTE_NAME_SESSION_ID = "frisk.session.id";
 export declare const ATTRIBUTE_NAME_REMOTE_SESSION_ID = "frisk.session.remote_id";

package/dist/telemetry/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/telemetry/constants.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,WAAW,iBAAiB,CAAA;AACzC,mCAAmC;AACnC,eAAO,MAAM,cAAc,UAAU,CAAA;AACrC,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,2BAA2B,CAAA;AAElE,eAAO,MAAM,2BAA2B,gCAAgC,CAAA;AAExE,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AAEtD,eAAO,MAAM,6BAA6B,yBAAyB,CAAA;AACnE,eAAO,MAAM,yBAAyB,qBAAqB,CAAA;AAC3D,eAAO,MAAM,gCAAgC,4BAA4B,CAAA;AAEzE,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B,wBAAwB,CAAA;AACjE,eAAO,MAAM,wBAAwB,oBAAoB,CAAA;AACzD,eAAO,MAAM,4BAA4B,kBAAkB,CAAA;AAC3D,eAAO,MAAM,oCAAoC,0BAA0B,CAAA;AAC3E,eAAO,MAAM,2BAA2B,uBAAuB,CAAA;AAC/D,eAAO,MAAM,6BAA6B,yBAAyB,CAAA;AACnE,eAAO,MAAM,4CAA4C,wCAClB,CAAA;AACvC,eAAO,MAAM,+BAA+B,2BAA2B,CAAA;AACvE,eAAO,MAAM,8CAA8C,0CAClB,CAAA;AACzC,eAAO,MAAM,0CAA0C,sCAClB,CAAA;AACrC,eAAO,MAAM,+BAA+B,2BAA2B,CAAA;AACvE,eAAO,MAAM,8BAA8B,0BAA0B,CAAA;AACrE,eAAO,MAAM,yBAAyB,eAAe,CAAA;AACrD,eAAO,MAAM,4BAA4B,kBAAkB,CAAA;AAC3D,eAAO,MAAM,mCAAmC,+BAA+B,CAAA;AAC/E,eAAO,MAAM,iCAAiC,6BAA6B,CAAA;AAC3E,eAAO,MAAM,8BAA8B,2BAA2B,CAAA;AACtE,eAAO,MAAM,oCAAoC,iCACjB,CAAA;AAChC,eAAO,MAAM,wCAAwC,oCAClB,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/telemetry/constants.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,eAAO,MAAM,WAAW,iBAAiB,CAAA;AACzC,mCAAmC;AACnC,eAAO,MAAM,cAAc,UAAU,CAAA;AACrC,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,2BAA2B,CAAA;AAElE,eAAO,MAAM,2BAA2B,gCAAgC,CAAA;AAExE,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAElD,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,oBAAoB,CAAA;AAEpD,kEAAkE;AAClE,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AAEtD,+EAA+E;AAC/E,eAAO,MAAM,+BAA+B,qCACR,CAAA;AACpC,gEAAgE;AAChE,eAAO,MAAM,8BAA8B,0BAA0B,CAAA;AACrE,4EAA4E;AAC5E,eAAO,MAAM,oCAAoC,gCAClB,CAAA;AAC/B,sEAAsE;AACtE,eAAO,MAAM,sCAAsC,kCAClB,CAAA;AACjC,iFAAiF;AACjF,eAAO,MAAM,uCAAuC,mCAClB,CAAA;AAElC,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,qBAAqB,CAAA;AAC3D,sDAAsD;AACtD,eAAO,MAAM,6BAA6B,yBAAyB,CAAA;AACnE,8DAA8D;AAC9D,eAAO,MAAM,uCAAuC,mCAClB,CAAA;AAClC,mEAAmE;AACnE,eAAO,MAAM,wCAAwC,oCAClB,CAAA;AACnC,qDAAqD;AACrD,eAAO,MAAM,uCAAuC,mCAClB,CAAA;AAElC,eAAO,MAAM,6BAA6B,yBAAyB,CAAA;AACnE,eAAO,MAAM,yBAAyB,qBAAqB,CAAA;AAC3D,eAAO,MAAM,gCAAgC,4BAA4B,CAAA;AAEzE,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B,wBAAwB,CAAA;AACjE,eAAO,MAAM,wBAAwB,oBAAoB,CAAA;AACzD,eAAO,MAAM,4BAA4B,kBAAkB,CAAA;AAC3D,eAAO,MAAM,oCAAoC,0BAA0B,CAAA;AAC3E,eAAO,MAAM,2BAA2B,uBAAuB,CAAA;AAC/D,eAAO,MAAM,6BAA6B,yBAAyB,CAAA;AACnE,eAAO,MAAM,4CAA4C,wCAClB,CAAA;AACvC,eAAO,MAAM,+BAA+B,2BAA2B,CAAA;AACvE,eAAO,MAAM,8CAA8C,0CAClB,CAAA;AACzC,eAAO,MAAM,0CAA0C,sCAClB,CAAA;AACrC,eAAO,MAAM,+BAA+B,2BAA2B,CAAA;AACvE,eAAO,MAAM,8BAA8B,0BAA0B,CAAA;AACrE,eAAO,MAAM,yBAAyB,eAAe,CAAA;AACrD,eAAO,MAAM,4BAA4B,kBAAkB,CAAA;AAC3D,eAAO,MAAM,mCAAmC,+BAA+B,CAAA;AAC/E,eAAO,MAAM,iCAAiC,6BAA6B,CAAA;AAC3E,eAAO,MAAM,8BAA8B,2BAA2B,CAAA;AACtE,eAAO,MAAM,oCAAoC,iCACjB,CAAA;AAChC,eAAO,MAAM,wCAAwC,oCAClB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@friskai/frisk-js",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "FriskAI TypeScript SDK",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -31,6 +31,7 @@
     "build": "bash ./build.sh",
     "build:ts": "bash ./build-ts.sh",
     "dev": "bun build ./src/index.ts --outdir ./dist --target node --format esm --sourcemap=linked --watch --external @langchain/core --external @langchain/langgraph --external langchain",
+    "dev:watch": "node ./scripts/dev-watch.mjs",
     "clean": "rm -rf dist",
     "clean:all": "rm -rf dist native/*.node",
     "prepublishOnly": "bun run build",

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

@@ -1,102 +0,0 @@
-/**
- * @friskai/frisk-js Tool Call Span
- *
- * Context manager wrapping an OpenTelemetry span for a single tool call.
- * Handles span lifecycle, attribute setting, and latency recording.
- */
-import { Attributes, AttributeValue, type Span, type Tracer } from '@opentelemetry/api';
-import type { FrameworkAdapter } from '../framework-adapter';
-import { RedactionOptions } from './redaction-options';
-import type { NormalizedToolCall, ToolCallDecision, TraceContextCarrier } from './types';
-interface ToolCallSpanOptions {
-    sessionId: string;
-    adapter: FrameworkAdapter;
-    toolCall: NormalizedToolCall;
-    friskToolId?: string | null;
-    friskToolVersionId?: string | null;
-    agentState: Record<string, unknown>;
-    parent: Span | null;
-    tracer: Tracer;
-    redact: RedactionOptions;
-}
-/**
- * Context manager for wrapping a tool call in an OpenTelemetry span.
- *
- * Provides:
- * - Automatic span creation with parent context
- * - Tool call attributes (name, id, args, state)
- * - Redaction of sensitive fields
- * - Latency recording
- * - Result/error attribute setting
- *
- * @example
- * ```typescript
- * const span = new ToolCallSpan({adapter, toolCall, agentState, parent, tracer, redact});
- * span.enter();
- * try {
- *   const result = await processToolCall();
- *   span.saveResult(result);
- * } catch (error) {
- *   span.saveError(error);
- *   throw error;
- * } finally {
- *   span.exit();
- * }
- * ```
- */
-export declare class ToolCallSpan {
-    private adapter;
-    private toolCall;
-    private friskToolId;
-    private agentState;
-    private parent;
-    private tracer;
-    private redaction;
-    private _span;
-    private _traceContextCarrier;
-    private sessionId;
-    private friskToolVersionId;
-    constructor({ sessionId, adapter, toolCall, friskToolId, friskToolVersionId, agentState, parent, tracer, redact, }: ToolCallSpanOptions);
-    /**
-     * Get the current span (null if not entered)
-     */
-    private get span();
-    /**
-     * Get the trace context carrier for propagation
-     */
-    get traceContextCarrier(): TraceContextCarrier | null;
-    /**
-     * Execute an async callback within the span context
-     *
-     * @param callback - Async function to execute within the span
-     * @returns Promise resolving to the result of the callback
-     */
-    run<T>(callback: (span: ToolCallSpan) => T): T;
-    /**
-     * Execute an async callback within the span context
-     *
-     * @param callback - Async function to execute within the span
-     * @returns Promise resolving to the result of the callback
-     */
-    runAsync<T>(callback: (span: ToolCallSpan) => Promise<T>): Promise<T>;
-    setAttribute(key: string, value: AttributeValue): void;
-    setAttributes(attributes: Attributes): void;
-    /**
-     * Save the result of the tool call to the span
-     */
-    saveResult(decision: ToolCallDecision): void;
-    /**
-     * Save an error to the span
-     */
-    saveError(error: unknown): void;
-    /**
-     * Enter the span context - starts the span and sets initial attributes
-     */
-    private enter;
-    /**
-     * Exit the span context
-     */
-    private exit;
-}
-export {};
-//# sourceMappingURL=tool-call-span.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tool-call-span.d.ts","sourceRoot":"","sources":["../../src/core/tool-call-span.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,UAAU,EACV,cAAc,EAGd,KAAK,IAAI,EACT,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAmB5D,OAAO,EACL,gBAAgB,EAGjB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,SAAS,CAAA;AAEhB,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,gBAAgB,CAAA;IACzB,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,MAAM,EAAE,IAAI,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,SAAS,CAA0B;IAE3C,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,oBAAoB,CAAmC;IAC/D,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,kBAAkB,CAAe;gBAE7B,EACV,SAAS,EACT,OAAO,EACP,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE,mBAAmB;IAYtB;;OAEG;IACH,OAAO,KAAK,IAAI,GAKf;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,mBAAmB,GAAG,IAAI,CAEpD;IAED;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,CAAC,GAAG,CAAC;IAS9C;;;;;OAKG;IACG,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAS3E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAItD,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAI3C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAiB5C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAe/B;;OAEG;IACH,OAAO,CAAC,KAAK;IAwDb;;OAEG;IACH,OAAO,CAAC,IAAI;CAOb"}