@tangle-network/sandbox 0.2.1 → 0.4.0

package/dist/openai/index.d.ts

@@ -383,13 +383,28 @@ declare class ResponsesValidationError extends Error {
   constructor(message: string, code: string, param?: string);
 }
 /**
- * Reject Responses requests that ask for tool types Tangle cannot
- * service. Function tools, the OpenAI computer-use preview tool, and
- * the code interpreter (every Tangle sandbox can run code) are
- * accepted; web_search and file_search are explicitly rejected with
- * the OpenAI error shape.
+ * Reject Responses requests that ask for unsupported tool types.
+ * Function tools, computer-use preview, code interpreter, and
+ * web_search/web_search_preview are accepted. file_search is rejected
+ * (no vector-store backend). Unknown types are rejected.
  */
 declare function validateResponsesRequest(req: ResponseCreateParamsBase): void;
+interface TangleRouterResponsesWebSearchOptions {
+  provider?: string;
+  maxResults?: number;
+  maxTotalResults?: number;
+  searchContextSize?: "low" | "medium" | "high";
+}
+/**
+ * Tangle Router's `/v1/responses` supports web search through the
+ * OpenRouter-compatible server-tool marker. Native OpenAI Responses
+ * `web_search` / `web_search_preview` tools are not forwarded to OpenAI;
+ * the router uses this marker to run Tangle-billed search first, inject
+ * cited context, and strip the marker before the upstream Responses call.
+ */
+declare function normalizeResponsesWebSearchForTangleRouter<T extends {
+  tools?: unknown;
+}>(req: T, options?: TangleRouterResponsesWebSearchOptions): T;
 /**
  * Build a settled `Response` shell from an aggregated output + usage.
  * Caller fills in the runtime-specific fields (id, model, created_at,
@@ -639,4 +654,4 @@ declare function outcomeToFinishReason(outcome: string, hasToolCall: boolean): O
  */
 declare function openaiMessagesToSandboxInput(messages: ChatCompletionMessageParam[], tools: ChatCompletionTool[] | undefined, model: string): SandboxRunInput;
 //#endregion
-export { type ActionRateLimitOptions, type AfterHookOutcome, type AuditEvent, type AuditLogOptions, type BeforeHookOutcome, type BufferedToolCall, type CostCapOptions, type DestructiveActionGuardOptions, type EgressPolicyOptions, EmbeddingValidationError, HookChain, type HookSurface, InMemoryResponseStore, type MultimodalPart, type NormalizedEmbeddingInput, type NormalizedEmbeddingRequest, type OpenAIFinishReason, type PriorToolCall, type PriorToolResult, type PriorTurn, type RedactionRegion, type ResponseStore, ResponsesValidationError, Run, type RunEvent, type RunEventSource, type RunOptions, type RunStatus, type SandboxRunInput, type SandboxToolSpec, type ScreenshotRedactionOptions, type TangleSSEEvent, type ToolCallContext, type ToolOutput, type ToolResult, type TranslatorContext, actionRateLimitHook, assembleResponseOutput, auditLogHook, buildResponseShell, costCapHook, createTranslatorContext, destructiveActionGuardHook, egressPolicyHook, openaiMessagesToSandboxInput, outcomeToFinishReason, resolvePreviousResponseId, runEvents, sandboxEventToChatChunk, sandboxEventToCompletionChunk, sandboxEventToResponsesEvent, screenshotRedactionHook, usageFromEvents, validateEmbeddingRequest, validateResponsesRequest };
+export { type ActionRateLimitOptions, type AfterHookOutcome, type AuditEvent, type AuditLogOptions, type BeforeHookOutcome, type BufferedToolCall, type CostCapOptions, type DestructiveActionGuardOptions, type EgressPolicyOptions, EmbeddingValidationError, HookChain, type HookSurface, InMemoryResponseStore, type MultimodalPart, type NormalizedEmbeddingInput, type NormalizedEmbeddingRequest, type OpenAIFinishReason, type PriorToolCall, type PriorToolResult, type PriorTurn, type RedactionRegion, type ResponseStore, ResponsesValidationError, Run, type RunEvent, type RunEventSource, type RunOptions, type RunStatus, type SandboxRunInput, type SandboxToolSpec, type ScreenshotRedactionOptions, type TangleRouterResponsesWebSearchOptions, type TangleSSEEvent, type ToolCallContext, type ToolOutput, type ToolResult, type TranslatorContext, actionRateLimitHook, assembleResponseOutput, auditLogHook, buildResponseShell, costCapHook, createTranslatorContext, destructiveActionGuardHook, egressPolicyHook, normalizeResponsesWebSearchForTangleRouter, openaiMessagesToSandboxInput, outcomeToFinishReason, resolvePreviousResponseId, runEvents, sandboxEventToChatChunk, sandboxEventToCompletionChunk, sandboxEventToResponsesEvent, screenshotRedactionHook, usageFromEvents, validateEmbeddingRequest, validateResponsesRequest };