@silmaril-security/sdk 0.3.1 → 0.4.1

package/dist/index.d.ts

@@ -1,147 +1,5 @@
-import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
-
-declare const HookLabel: {
-    readonly USER_INPUT: "user_input";
-    readonly SYSTEM_PROMPT: "system_prompt";
-    readonly TOOL_CALL: "tool_call";
-    readonly TOOL_RESPONSE: "tool_response";
-    readonly LLM_OUTPUT: "llm_output";
-    readonly UNKNOWN: "unknown";
-};
-type HookLabel = (typeof HookLabel)[keyof typeof HookLabel];
-declare const FirewallHook: {
-    readonly LLM_START: "on_llm_start";
-    readonly CHAT_MODEL_START: "on_chat_model_start";
-    readonly TOOL_START: "on_tool_start";
-    readonly RETRIEVER_START: "on_retriever_start";
-    readonly LLM_END: "on_llm_end";
-    readonly TOOL_END: "on_tool_end";
-    readonly RETRIEVER_END: "on_retriever_end";
-};
-type FirewallHook = (typeof FirewallHook)[keyof typeof FirewallHook];
-declare const DEFAULT_HOOKS: ReadonlySet<FirewallHook>;
-declare const INPUT_HOOKS: ReadonlySet<FirewallHook>;
-declare const OUTPUT_HOOKS: ReadonlySet<FirewallHook>;
-declare const ALL_HOOKS: ReadonlySet<FirewallHook>;
-declare const FIREWALL_HOOK_TO_LABEL: Readonly<Record<FirewallHook, HookLabel>>;
-declare function resolveHooks(hooks: Iterable<FirewallHook | string> | undefined): ReadonlySet<FirewallHook>;
-declare function prependHook(text: string, hook: HookLabel | string | undefined | null): string;
-declare function prependToolName(text: string, toolName: string | undefined | null): string;
-
-type Prediction = "BENIGN" | "MALICIOUS";
-interface BlockResult {
-    readonly prediction: Prediction;
-    readonly score: number;
-    readonly threshold: number;
-    readonly primaryOutcome?: string;
-    readonly outcomeScores?: Readonly<Record<string, number>>;
-    readonly detectorScores?: Readonly<Record<string, number>>;
-    readonly detectorCounts?: Readonly<Record<string, number>>;
-}
-interface FirewallOptions {
-    apiKey: string;
-    apiUrl: string;
-    timeoutMs?: number;
-    chunkConcurrency?: number;
-    shadowMode?: boolean;
-}
-type ClassificationMetadata = Readonly<Record<string, unknown>>;
-interface ClassifyOptions {
-    hook?: HookLabel;
-    toolName?: string;
-    metadata?: ClassificationMetadata;
-}
-interface ClassifyBatchOptions {
-    hooks?: readonly HookLabel[];
-    toolNames?: readonly (string | undefined)[];
-    metadata?: readonly (ClassificationMetadata | undefined)[];
-}
-interface LangChainAdapterOptions {
-    hooks?: ReadonlySet<FirewallHook>;
-    includeSystem?: boolean;
-    includeTool?: boolean;
-    failOpen?: boolean;
-    logger?: (message: string, error: unknown) => void;
-    shadowMode?: boolean;
-    onClassify?: (event: ClassifyEvent) => void;
-}
-interface ClassifyEvent {
-    readonly hook: HookLabel;
-    readonly toolName?: string;
-    readonly text: string;
-    readonly result: BlockResult;
-    readonly blocked: boolean;
-    readonly shadowMode: boolean;
-}
-interface MiddlewareOptions {
-    scanInput?: boolean;
-    scanOutput?: boolean;
-    scanToolCalls?: boolean;
-    shadowMode?: boolean;
-    onBlocked?: (err: Error) => void;
-    onClassify?: (event: ClassifyEvent) => void;
-}
-
-interface VercelContentPart {
-    type?: string;
-    text?: string;
-    toolCallId?: string;
-    toolName?: string;
-    args?: unknown;
-    result?: unknown;
-}
-interface VercelPromptMessage {
-    role: string;
-    content: string | ReadonlyArray<VercelContentPart | string>;
-}
-interface VercelToolCall {
-    toolCallType?: string;
-    toolCallId?: string;
-    toolName?: string;
-    args?: unknown;
-}
-interface VercelGenerateResult {
-    text?: string;
-    toolCalls?: ReadonlyArray<VercelToolCall>;
-}
-interface WrapGenerateArgs<TResult extends VercelGenerateResult & Record<string, unknown>> {
-    params: {
-        prompt: ReadonlyArray<VercelPromptMessage>;
-    } & Record<string, unknown>;
-    doGenerate: () => PromiseLike<TResult>;
-}
-interface WrapStreamArgs<TResult extends {
-    stream: ReadableStream<unknown>;
-} & Record<string, unknown>> {
-    params: {
-        prompt: ReadonlyArray<VercelPromptMessage>;
-    } & Record<string, unknown>;
-    doStream: () => PromiseLike<TResult>;
-}
-interface FirewallMiddleware {
-    wrapGenerate: <TResult extends VercelGenerateResult & Record<string, unknown>>(args: WrapGenerateArgs<TResult>) => Promise<TResult>;
-    wrapStream: <TResult extends {
-        stream: ReadableStream<unknown>;
-    } & Record<string, unknown>>(args: WrapStreamArgs<TResult>) => Promise<TResult>;
-}
-
-declare const DEFAULT_TIMEOUT_MS = 10000;
-declare const DEFAULT_CHUNK_CONCURRENCY = 8;
-declare class Firewall {
-    readonly apiKey: string;
-    readonly apiUrl: string;
-    readonly timeoutMs: number;
-    readonly chunkConcurrency: number;
-    readonly shadowMode: boolean;
-    private readonly headers;
-    constructor(options: FirewallOptions);
-    classify(text: string, options?: ClassifyOptions): Promise<BlockResult>;
-    classifyBatch(texts: readonly string[], options?: ClassifyBatchOptions): Promise<BlockResult[]>;
-    asLangChainHandler(options?: LangChainAdapterOptions): Promise<BaseCallbackHandler>;
-    asMiddleware(options?: MiddlewareOptions): FirewallMiddleware;
-    private postWithRetry;
-    private classifySingleChunk;
-}
+import { H as HookLabel, B as BlockResult } from './firewall-CEV5hItA.js';
+export { A as ALL_HOOKS, C as ClassificationMetadata, a as ClassifyBatchOptions, b as ClassifyEvent, c as ClassifyOptions, D as DEFAULT_CHUNK_CONCURRENCY, d as DEFAULT_HOOKS, e as DEFAULT_TIMEOUT_MS, F as FIREWALL_HOOK_TO_LABEL, f as Firewall, g as FirewallHook, h as FirewallMiddleware, i as FirewallOptions, I as INPUT_HOOKS, L as LangChainAdapterOptions, j as LangChainFirewallHandler, M as MiddlewareOptions, O as OUTPUT_HOOKS, P as Prediction, p as prependHook, k as prependToolName, r as resolveHooks } from './firewall-CEV5hItA.js';
 
 interface MalformedInputDetails {
     field?: string;
@@ -151,19 +9,31 @@ interface MalformedInputDetails {
     codePoint?: string;
     reason?: string;
 }
-declare class PromptBlockedException extends Error {
+declare class FirewallBlockedException extends Error {
     readonly score: number;
     readonly threshold: number;
     readonly promptText: string;
     readonly runId: string | undefined;
+    readonly hook: HookLabel | undefined;
+    readonly toolName: string | undefined;
+    readonly toolCallId: string | undefined;
+    readonly result: BlockResult | undefined;
     constructor(params: {
         score: number;
         threshold: number;
         promptText: string;
         runId?: string;
+        hook?: HookLabel;
+        toolName?: string;
+        toolCallId?: string;
+        result?: BlockResult;
     });
     private static formatMessage;
 }
+/** @deprecated Use FirewallBlockedException instead. */
+declare const PromptBlockedException: typeof FirewallBlockedException;
+/** @deprecated Use FirewallBlockedException instead. */
+type PromptBlockedException = FirewallBlockedException;
 declare class SilmarilApiError extends Error {
     readonly status: number;
     readonly statusText: string;
@@ -190,4 +60,4 @@ declare const CHUNK_OVERLAP_CHARS: number;
 declare function sanitizeText(text: string): string;
 declare function chunkText(text: string): string[];
 
-export { ALL_HOOKS, type BlockResult, CHUNK_OVERLAP, CHUNK_OVERLAP_CHARS, CHUNK_WINDOW, CHUNK_WINDOW_CHARS, type ClassificationMetadata, type ClassifyBatchOptions, type ClassifyEvent, type ClassifyOptions, DEFAULT_CHUNK_CONCURRENCY, DEFAULT_HOOKS, DEFAULT_TIMEOUT_MS, FIREWALL_HOOK_TO_LABEL, Firewall, FirewallHook, type FirewallMiddleware, type FirewallOptions, HookLabel, INPUT_HOOKS, type LangChainAdapterOptions, MAX_INPUT_CHARS, MAX_INPUT_TOKENS, type MalformedInputDetails, type MiddlewareOptions, OUTPUT_HOOKS, type Prediction, PromptBlockedException, SilmarilApiError, chunkText, prependHook, prependToolName, resolveHooks, sanitizeText };
+export { BlockResult, CHUNK_OVERLAP, CHUNK_OVERLAP_CHARS, CHUNK_WINDOW, CHUNK_WINDOW_CHARS, FirewallBlockedException, HookLabel, MAX_INPUT_CHARS, MAX_INPUT_TOKENS, type MalformedInputDetails, PromptBlockedException, SilmarilApiError, chunkText, sanitizeText };

package/dist/index.js

@@ -25,30 +25,39 @@ function parseErrorBody(body) {
     return { details: void 0, error: void 0, apiMessage: void 0 };
   }
 }
-var MAX_PROMPT_DISPLAY_LEN, PromptBlockedException, SilmarilApiError;
+var MAX_PROMPT_DISPLAY_LEN, FirewallBlockedException, PromptBlockedException, SilmarilApiError;
 var init_exceptions = __esm({
   "src/exceptions.ts"() {
     "use strict";
     MAX_PROMPT_DISPLAY_LEN = 100;
-    PromptBlockedException = class _PromptBlockedException extends Error {
+    FirewallBlockedException = class _FirewallBlockedException extends Error {
       score;
       threshold;
       promptText;
       runId;
+      hook;
+      toolName;
+      toolCallId;
+      result;
       constructor(params) {
-        super(_PromptBlockedException.formatMessage(params));
-        this.name = "PromptBlockedException";
+        super(_FirewallBlockedException.formatMessage(params));
+        this.name = "FirewallBlockedException";
         this.score = params.score;
         this.threshold = params.threshold;
         this.promptText = params.promptText;
         this.runId = params.runId;
-        Object.setPrototypeOf(this, _PromptBlockedException.prototype);
+        this.hook = params.hook;
+        this.toolName = params.toolName;
+        this.toolCallId = params.toolCallId;
+        this.result = params.result;
+        Object.setPrototypeOf(this, _FirewallBlockedException.prototype);
       }
       static formatMessage(params) {
         const truncated = params.promptText.length > MAX_PROMPT_DISPLAY_LEN ? `${params.promptText.slice(0, MAX_PROMPT_DISPLAY_LEN)}...` : params.promptText;
-        return `Prompt blocked by Silmaril Firewall (score=${params.score.toFixed(4)}, threshold=${params.threshold.toFixed(4)}): '${truncated}'`;
+        return `Request blocked by Silmaril Firewall (score=${params.score.toFixed(4)}, threshold=${params.threshold.toFixed(4)}): '${truncated}'`;
       }
     };
+    PromptBlockedException = FirewallBlockedException;
     SilmarilApiError = class _SilmarilApiError extends Error {
       status;
       statusText;
@@ -239,19 +248,12 @@ async function createLangChainHandler(firewall, options = {}) {
   });
   const shadowMode = options.shadowMode ?? firewall.shadowMode;
   const onClassify = options.onClassify;
-  const fireOnClassify = (hookLabel, text, result, blocked, toolName) => {
+  const fireOnClassify = (event) => {
     if (!onClassify) {
       return;
     }
     try {
-      onClassify({
-        hook: hookLabel,
-        ...toolName !== void 0 ? { toolName } : {},
-        text,
-        result,
-        blocked,
-        shadowMode
-      });
+      onClassify(event);
     } catch (err) {
       logger("onClassify callback threw", err);
     }
@@ -272,15 +274,30 @@ async function createLangChainHandler(firewall, options = {}) {
     }
     const threshold = result.threshold;
     const blocked = result.score >= threshold;
-    fireOnClassify(hookLabel, text, result, blocked, toolName);
-    if (blocked && !shadowMode) {
-      throw new PromptBlockedException({
-        score: result.score,
-        threshold,
-        promptText: text,
-        runId
-      });
+    const commonEventFields = {
+      hook: hookLabel,
+      ...toolName !== void 0 ? { toolName } : {},
+      runId,
+      text,
+      result
+    };
+    fireOnClassify({
+      ...commonEventFields,
+      blocked,
+      shadowMode
+    });
+    if (!blocked || shadowMode) {
+      return;
     }
+    throw new FirewallBlockedException({
+      score: result.score,
+      threshold,
+      promptText: text,
+      runId,
+      hook: hookLabel,
+      ...toolName !== void 0 ? { toolName } : {},
+      result
+    });
   };
   class SilmarilFirewallHandler extends BaseCallbackHandler {
     name = "silmaril_firewall_handler";
@@ -383,6 +400,9 @@ var init_langchain = __esm({
   }
 });
 
+// src/firewall.ts
+import { randomUUID } from "crypto";
+
 // src/adapters/vercel.ts
 init_exceptions();
 init_hooks();
@@ -399,6 +419,9 @@ function stringifyToolValue(value) {
     return String(value);
   }
 }
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function extractContentText(content) {
   if (typeof content === "string") {
     return content;
@@ -423,14 +446,29 @@ function iterateToolResultParts(message) {
       continue;
     }
     if (part.type === "tool-result") {
-      const text = stringifyToolValue(part.result);
+      const text = stringifyToolResult(part.result !== void 0 ? part.result : part.output);
       if (text.trim()) {
-        out.push({ text, toolName: part.toolName });
+        out.push({ text, toolName: part.toolName, toolCallId: part.toolCallId });
       }
     }
   }
   return out;
 }
+function stringifyToolResult(value) {
+  if (!isRecord(value)) {
+    return stringifyToolValue(value);
+  }
+  if ((value.type === "text" || value.type === "error-text") && typeof value.value === "string") {
+    return value.value;
+  }
+  if ((value.type === "json" || value.type === "error-json") && value.value !== void 0) {
+    return stringifyToolValue(value.value);
+  }
+  if (value.type === "content" && Array.isArray(value.value)) {
+    return value.value.map((part) => isRecord(part) && part.type === "text" && typeof part.text === "string" ? part.text : "").filter((text) => text.length > 0).join(" ");
+  }
+  return stringifyToolValue(value);
+}
 function findLastUserMessage(messages) {
   for (let i = messages.length - 1; i >= 0; i--) {
     const msg = messages[i];
@@ -444,33 +482,43 @@ function createMiddleware(firewall, options = {}) {
   const scanInput = options.scanInput ?? true;
   const scanOutput = options.scanOutput ?? false;
   const shadowMode = options.shadowMode ?? firewall.shadowMode;
-  const classifyOrBlock = async (text, hook, toolName) => {
+  const classifyOrBlock = async (text, hook, context = { toolName: void 0, toolCallId: void 0 }) => {
     if (!text.trim()) {
       return;
     }
+    const { toolName, toolCallId } = context;
     const result = await firewall.classify(
       text,
       toolName !== void 0 ? { hook, toolName } : { hook }
     );
     const threshold = result.threshold;
     const blocked = result.score >= threshold;
-    options.onClassify?.({
+    const commonEventFields = {
       hook,
       ...toolName !== void 0 ? { toolName } : {},
+      ...toolCallId !== void 0 ? { toolCallId } : {},
       text,
-      result,
+      result
+    };
+    options.onClassify?.({
+      ...commonEventFields,
       blocked,
       shadowMode
     });
-    if (blocked && !shadowMode) {
-      const err = new PromptBlockedException({
-        score: result.score,
-        threshold,
-        promptText: text
-      });
-      options.onBlocked?.(err);
-      throw err;
+    if (!blocked || shadowMode) {
+      return;
     }
+    const err = new FirewallBlockedException({
+      score: result.score,
+      threshold,
+      promptText: text,
+      hook,
+      ...toolName !== void 0 ? { toolName } : {},
+      ...toolCallId !== void 0 ? { toolCallId } : {},
+      result
+    });
+    options.onBlocked?.(err);
+    throw err;
   };
   const scanPrompt = async (prompt) => {
     if (prompt.length === 0) {
@@ -479,8 +527,8 @@ function createMiddleware(firewall, options = {}) {
     const last = prompt[prompt.length - 1];
     const role = last.role.toLowerCase();
     if (role === "tool") {
-      for (const { text: text2, toolName } of iterateToolResultParts(last)) {
-        await classifyOrBlock(text2, HookLabel.TOOL_RESPONSE, toolName);
+      for (const { text: text2, toolName, toolCallId } of iterateToolResultParts(last)) {
+        await classifyOrBlock(text2, HookLabel.TOOL_RESPONSE, { toolName, toolCallId });
       }
       return;
     }
@@ -503,21 +551,25 @@ function createMiddleware(firewall, options = {}) {
         if (!call || typeof call !== "object") {
           continue;
         }
-        const args = typeof call.args === "string" ? call.args : stringifyToolValue(call.args);
+        const toolInput = call.args !== void 0 ? call.args : call.input;
+        const args = typeof toolInput === "string" ? toolInput : stringifyToolValue(toolInput);
         const toolName = typeof call.toolName === "string" ? call.toolName : void 0;
+        const toolCallId = typeof call.toolCallId === "string" ? call.toolCallId : void 0;
         if (args.trim()) {
-          await classifyOrBlock(args, HookLabel.TOOL_CALL, toolName);
+          await classifyOrBlock(args, HookLabel.TOOL_CALL, { toolName, toolCallId });
         }
       }
     }
   };
   return {
+    specificationVersion: "v3",
+    middlewareVersion: "v2",
     async wrapGenerate({
       params,
       doGenerate
     }) {
       if (scanInput) {
-        await scanPrompt(params.prompt);
+        await scanPrompt(params.prompt ?? []);
       }
       const result = await doGenerate();
       await scanGenerateResult(result);
@@ -528,7 +580,7 @@ function createMiddleware(firewall, options = {}) {
       doStream
     }) {
       if (scanInput) {
-        await scanPrompt(params.prompt);
+        await scanPrompt(params.prompt ?? []);
       }
       const { stream, ...rest } = await doStream();
       if (!scanOutput) {
@@ -552,7 +604,7 @@ function createMiddleware(firewall, options = {}) {
             try {
               await classifyOrBlock(buffered, HookLabel.LLM_OUTPUT);
             } catch (err) {
-              if (err instanceof PromptBlockedException) {
+              if (err instanceof FirewallBlockedException) {
                 controller.enqueue({ type: "error", error: err });
                 return;
               }
@@ -640,33 +692,17 @@ function chunkText(text) {
 
 // src/firewall.ts
 init_exceptions();
-var BASE_THRESHOLD = 0.5;
-var TARGET_SEQUENCE_FPR = 0.01;
-var MAX_ADAPTIVE_THRESHOLD = 0.9;
+var SDK_VERSION = "0.4.1";
 var DEFAULT_TIMEOUT_MS = 1e4;
 var DEFAULT_CHUNK_CONCURRENCY = 8;
 var DEFAULT_MAX_RETRIES = 5;
 var MAX_BACKOFF_SECONDS = 30;
 var MAX_ERROR_BODY_BYTES = 1 << 16;
-function adaptiveThreshold(scoringOpportunityCount) {
-  if (!Number.isInteger(scoringOpportunityCount) || scoringOpportunityCount < 1) {
-    throw new Error(
-      `Firewall: scoringOpportunityCount must be an integer >= 1, got ${scoringOpportunityCount}`
-    );
-  }
-  if (scoringOpportunityCount === 1) {
-    return BASE_THRESHOLD;
-  }
-  const targetChunkFpr = 1 - Math.pow(1 - TARGET_SEQUENCE_FPR, 1 / scoringOpportunityCount);
-  const oddsRatio = TARGET_SEQUENCE_FPR / targetChunkFpr;
-  const rawThreshold = oddsRatio / (1 + oddsRatio);
-  return Math.min(rawThreshold, MAX_ADAPTIVE_THRESHOLD);
-}
-function blockResultFromResponse(data, threshold) {
+function blockResultFromResponse(data) {
   const result = {
     prediction: data.prediction,
     score: Number(data.score),
-    threshold
+    threshold: Number(data.threshold)
   };
   if (data.primary_outcome !== void 0) {
     result.primaryOutcome = data.primary_outcome;
@@ -688,6 +724,26 @@ function blockResultFromResponse(data, threshold) {
   }
   return Object.freeze(result);
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function withSdkMetadata(metadata, info) {
+  const payload = { ...metadata ?? {} };
+  const existing = payload.silmaril;
+  if (existing !== void 0 && !isRecord2(existing)) {
+    throw new Error("Firewall: metadata.silmaril must be an object when provided");
+  }
+  payload.silmaril = {
+    ...isRecord2(existing) ? existing : {},
+    sdk_language: "typescript",
+    sdk_version: SDK_VERSION,
+    request_id: info.requestId,
+    input_index: info.inputIndex,
+    chunk_index: info.chunkIndex,
+    chunk_count: info.chunkCount
+  };
+  return payload;
+}
 async function readCappedErrorBody(response) {
   if (!response.body) {
     return response.text().then((body2) => body2.slice(0, MAX_ERROR_BODY_BYTES)).catch(() => "");
@@ -784,14 +840,24 @@ var Firewall = class {
   }
   async classify(text, options = {}) {
     const chunks = chunkText(text);
-    const threshold = adaptiveThreshold(chunks.length);
+    const requestId = options.requestId ?? randomUUID();
     if (chunks.length === 1) {
-      return this.classifySingleChunk(chunks[0], options, threshold);
+      return this.classifySingleChunk(chunks[0], options, {
+        requestId,
+        inputIndex: 0,
+        chunkIndex: 0,
+        chunkCount: 1
+      });
     }
     const results = await mapWithConcurrency(
       chunks,
       this.chunkConcurrency,
-      (chunk) => this.classifySingleChunk(chunk, options, threshold)
+      (chunk, index) => this.classifySingleChunk(chunk, options, {
+        requestId,
+        inputIndex: 0,
+        chunkIndex: index,
+        chunkCount: chunks.length
+      })
     );
     return results.reduce((best, r) => r.score > best.score ? r : best);
   }
@@ -814,10 +880,9 @@ var Firewall = class {
         `Firewall: metadata length ${options.metadata.length} does not match texts length ${texts.length}`
       );
     }
-    const threshold = adaptiveThreshold(texts.length);
+    const requestId = options.requestId ?? randomUUID();
     const payload = {
-      texts: texts.map((text) => sanitizeText(text)),
-      threshold
+      texts: texts.map((text) => sanitizeText(text))
     };
     if (options.hooks && options.hooks.length > 0) {
       payload.hooks = options.hooks.map((h) => String(h));
@@ -825,14 +890,21 @@ var Firewall = class {
     if (options.toolNames && options.toolNames.length > 0) {
       payload.tool_names = options.toolNames.map((t) => t === void 0 ? null : t);
     }
-    if (options.metadata && options.metadata.length > 0) {
-      payload.metadata = options.metadata.map((m) => m === void 0 ? null : m);
-    }
+    payload.metadata = texts.map(
+      (_, index) => withSdkMetadata(options.metadata?.[index], {
+        requestId,
+        inputIndex: index,
+        chunkIndex: 0,
+        chunkCount: 1
+      })
+    );
     const data = await this.postWithRetry(payload);
-    return data.predictions.map((p) => blockResultFromResponse(p, threshold));
+    return data.predictions.map((p) => blockResultFromResponse(p));
   }
   asLangChainHandler(options = {}) {
-    return Promise.resolve().then(() => (init_langchain(), langchain_exports)).then((m) => m.createLangChainHandler(this, options));
+    return Promise.resolve().then(() => (init_langchain(), langchain_exports)).then(
+      (m) => m.createLangChainHandler(this, options)
+    );
   }
   asMiddleware(options = {}) {
     return createMiddleware(this, options);
@@ -862,19 +934,17 @@ var Firewall = class {
     }
     throw new Error("Firewall: exhausted retries (unreachable)");
   }
-  async classifySingleChunk(text, options, threshold) {
-    const payload = { text, threshold };
+  async classifySingleChunk(text, options, metadataInfo) {
+    const payload = { text };
     if (options.hook !== void 0) {
       payload.hook = options.hook;
     }
     if (options.toolName !== void 0) {
       payload.tool_name = options.toolName;
     }
-    if (options.metadata !== void 0) {
-      payload.metadata = options.metadata;
-    }
+    payload.metadata = withSdkMetadata(options.metadata, metadataInfo);
     const data = await this.postWithRetry(payload);
-    return blockResultFromResponse(data, threshold);
+    return blockResultFromResponse(data);
   }
 };
 
@@ -892,6 +962,7 @@ export {
   DEFAULT_TIMEOUT_MS,
   FIREWALL_HOOK_TO_LABEL,
   Firewall,
+  FirewallBlockedException,
   FirewallHook,
   HookLabel,
   INPUT_HOOKS,