@openrouter/sdk 0.3.12 → 0.3.15

package/esm/funcs/guardrailsListKeyAssignments.js

@@ -0,0 +1,87 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 09465ee2cc6d
+ */
+import { encodeFormQuery } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as errors from "../models/errors/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+/**
+ * List all key assignments
+ *
+ * @remarks
+ * List all API key guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+ */
+export function guardrailsListKeyAssignments(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.ListKeyAssignmentsRequest$outboundSchema.optional().parse(value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = null;
+    const path = pathToFunc("/guardrails/assignments/keys")();
+    const query = encodeFormQuery({
+        "limit": payload?.limit,
+        "offset": payload?.offset,
+    });
+    const headers = new Headers(compactMap({
+        Accept: "application/json",
+    }));
+    const secConfig = await extractSecurity(client._options.apiKey);
+    const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: "listKeyAssignments",
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.apiKey,
+        retryConfig: options?.retries
+            || client._options.retryConfig
+            || { strategy: "none" },
+        retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    };
+    const requestRes = client._createRequest(context, {
+        security: requestSecurity,
+        method: "GET",
+        baseURL: options?.serverURL,
+        path: path,
+        headers: headers,
+        query: query,
+        body: body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestRes.ok) {
+        return [requestRes, { status: "invalid" }];
+    }
+    const req = requestRes.value;
+    const doResult = await client._do(req, {
+        context,
+        errorCodes: ["401", "4XX", "500", "5XX"],
+        retryConfig: context.retryConfig,
+        retryCodes: context.retryCodes,
+    });
+    if (!doResult.ok) {
+        return [doResult, { status: "request-error", request: req }];
+    }
+    const response = doResult.value;
+    const responseFields = {
+        HttpMeta: { Response: response, Request: req },
+    };
+    const [result] = await M.match(M.json(200, operations.ListKeyAssignmentsResponse$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    if (!result.ok) {
+        return [result, { status: "complete", request: req, response }];
+    }
+    return [result, { status: "complete", request: req, response }];
+}
+//# sourceMappingURL=guardrailsListKeyAssignments.js.map

package/esm/funcs/guardrailsListMemberAssignments.d.ts

@@ -0,0 +1,18 @@
+import { OpenRouterCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OpenRouterError } from "../models/errors/openroutererror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+/**
+ * List all member assignments
+ *
+ * @remarks
+ * List all organization member guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+ */
+export declare function guardrailsListMemberAssignments(client: OpenRouterCore, request?: operations.ListMemberAssignmentsRequest | undefined, options?: RequestOptions): APIPromise<Result<operations.ListMemberAssignmentsResponse, errors.UnauthorizedResponseError | errors.InternalServerResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=guardrailsListMemberAssignments.d.ts.map

package/esm/funcs/guardrailsListMemberAssignments.js

@@ -0,0 +1,87 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f4359f4c7ba4
+ */
+import { encodeFormQuery } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as errors from "../models/errors/index.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+/**
+ * List all member assignments
+ *
+ * @remarks
+ * List all organization member guardrail assignments for the authenticated user. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+ */
+export function guardrailsListMemberAssignments(client, request, options) {
+    return new APIPromise($do(client, request, options));
+}
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.ListMemberAssignmentsRequest$outboundSchema.optional().parse(value), "Input validation failed");
+    if (!parsed.ok) {
+        return [parsed, { status: "invalid" }];
+    }
+    const payload = parsed.value;
+    const body = null;
+    const path = pathToFunc("/guardrails/assignments/members")();
+    const query = encodeFormQuery({
+        "limit": payload?.limit,
+        "offset": payload?.offset,
+    });
+    const headers = new Headers(compactMap({
+        Accept: "application/json",
+    }));
+    const secConfig = await extractSecurity(client._options.apiKey);
+    const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
+    const context = {
+        options: client._options,
+        baseURL: options?.serverURL ?? client._baseURL ?? "",
+        operationID: "listMemberAssignments",
+        oAuth2Scopes: null,
+        resolvedSecurity: requestSecurity,
+        securitySource: client._options.apiKey,
+        retryConfig: options?.retries
+            || client._options.retryConfig
+            || { strategy: "none" },
+        retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+    };
+    const requestRes = client._createRequest(context, {
+        security: requestSecurity,
+        method: "GET",
+        baseURL: options?.serverURL,
+        path: path,
+        headers: headers,
+        query: query,
+        body: body,
+        userAgent: client._options.userAgent,
+        timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+    }, options);
+    if (!requestRes.ok) {
+        return [requestRes, { status: "invalid" }];
+    }
+    const req = requestRes.value;
+    const doResult = await client._do(req, {
+        context,
+        errorCodes: ["401", "4XX", "500", "5XX"],
+        retryConfig: context.retryConfig,
+        retryCodes: context.retryCodes,
+    });
+    if (!doResult.ok) {
+        return [doResult, { status: "request-error", request: req }];
+    }
+    const response = doResult.value;
+    const responseFields = {
+        HttpMeta: { Response: response, Request: req },
+    };
+    const [result] = await M.match(M.json(200, operations.ListMemberAssignmentsResponse$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    if (!result.ok) {
+        return [result, { status: "complete", request: req, response }];
+    }
+    return [result, { status: "complete", request: req, response }];
+}
+//# sourceMappingURL=guardrailsListMemberAssignments.js.map

package/esm/funcs/guardrailsUpdate.d.ts

@@ -0,0 +1,18 @@
+import { OpenRouterCore } from "../core.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OpenRouterError } from "../models/errors/openroutererror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+/**
+ * Update a guardrail
+ *
+ * @remarks
+ * Update an existing guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
+ */
+export declare function guardrailsUpdate(client: OpenRouterCore, request: operations.UpdateGuardrailRequest, options?: RequestOptions): APIPromise<Result<operations.UpdateGuardrailResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.NotFoundResponseError | errors.InternalServerResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=guardrailsUpdate.d.ts.map

package/esm/funcs/{parametersGetParameters.js → guardrailsUpdate.js}

@@ -1,60 +1,53 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
- * @generated-id: 565ce9801e34
+ * @generated-id: 383ee7d83fc3
  */
-import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
-import { resolveSecurity } from "../lib/security.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
 import * as errors from "../models/errors/index.js";
 import * as operations from "../models/operations/index.js";
 import { APIPromise } from "../types/async.js";
 /**
- * Get a model's supported parameters and data about which are most popular
+ * Update a guardrail
+ *
+ * @remarks
+ * Update an existing guardrail. [Provisioning key](/docs/guides/overview/auth/provisioning-api-keys) required.
  */
-export function parametersGetParameters(client, security, request, options) {
-    return new APIPromise($do(client, security, request, options));
+export function guardrailsUpdate(client, request, options) {
+    return new APIPromise($do(client, request, options));
 }
-async function $do(client, security, request, options) {
-    const parsed = safeParse(request, (value) => operations.GetParametersRequest$outboundSchema.parse(value), "Input validation failed");
+async function $do(client, request, options) {
+    const parsed = safeParse(request, (value) => operations.UpdateGuardrailRequest$outboundSchema.parse(value), "Input validation failed");
     if (!parsed.ok) {
         return [parsed, { status: "invalid" }];
     }
     const payload = parsed.value;
-    const body = null;
+    const body = encodeJSON("body", payload.RequestBody, { explode: true });
     const pathParams = {
-        author: encodeSimple("author", payload.author, {
-            explode: false,
-            charEncoding: "percent",
-        }),
-        slug: encodeSimple("slug", payload.slug, {
+        id: encodeSimple("id", payload.id, {
             explode: false,
             charEncoding: "percent",
         }),
     };
-    const path = pathToFunc("/parameters/{author}/{slug}")(pathParams);
-    const query = encodeFormQuery({
-        "provider": payload.provider,
-    });
+    const path = pathToFunc("/guardrails/{id}")(pathParams);
     const headers = new Headers(compactMap({
+        "Content-Type": "application/json",
         Accept: "application/json",
     }));
-    const requestSecurity = resolveSecurity([
-        {
-            fieldName: "Authorization",
-            type: "http:bearer",
-            value: security?.bearer,
-        },
-    ]);
+    const secConfig = await extractSecurity(client._options.apiKey);
+    const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+    const requestSecurity = resolveGlobalSecurity(securityInput);
     const context = {
         options: client._options,
         baseURL: options?.serverURL ?? client._baseURL ?? "",
-        operationID: "getParameters",
+        operationID: "updateGuardrail",
         oAuth2Scopes: null,
         resolvedSecurity: requestSecurity,
-        securitySource: security,
+        securitySource: client._options.apiKey,
         retryConfig: options?.retries
             || client._options.retryConfig
             || { strategy: "none" },
@@ -62,11 +55,10 @@ async function $do(client, security, request, options) {
     };
     const requestRes = client._createRequest(context, {
         security: requestSecurity,
-        method: "GET",
+        method: "PATCH",
         baseURL: options?.serverURL,
         path: path,
         headers: headers,
-        query: query,
         body: body,
         userAgent: client._options.userAgent,
         timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
@@ -77,7 +69,7 @@ async function $do(client, security, request, options) {
     const req = requestRes.value;
     const doResult = await client._do(req, {
         context,
-        errorCodes: ["401", "404", "4XX", "500", "5XX"],
+        errorCodes: ["400", "401", "404", "4XX", "500", "5XX"],
         retryConfig: context.retryConfig,
         retryCodes: context.retryCodes,
     });
@@ -88,10 +80,10 @@ async function $do(client, security, request, options) {
     const responseFields = {
         HttpMeta: { Response: response, Request: req },
     };
-    const [result] = await M.match(M.json(200, operations.GetParametersResponse$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(404, errors.NotFoundResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    const [result] = await M.match(M.json(200, operations.UpdateGuardrailResponse$inboundSchema), M.jsonErr(400, errors.BadRequestResponseError$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(404, errors.NotFoundResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
     if (!result.ok) {
         return [result, { status: "complete", request: req, response }];
     }
     return [result, { status: "complete", request: req, response }];
 }
-//# sourceMappingURL=parametersGetParameters.js.map
+//# sourceMappingURL=guardrailsUpdate.js.map

package/esm/index.d.ts

@@ -1,6 +1,6 @@
-export type { CallModelInput, FieldOrAsyncFunction, ResolvedCallModelInput, } from './lib/async-params.js';
+export type { CallModelInput, CallModelInputWithState, FieldOrAsyncFunction, ResolvedCallModelInput, } from './lib/async-params.js';
 export type { Fetcher, HTTPClientOptions } from './lib/http.js';
-export type { ChatStreamEvent, ResponseStreamEvent as EnhancedResponseStreamEvent, InferToolEvent, InferToolEventsUnion, InferToolInput, InferToolOutput, ManualTool, NextTurnParamsContext, NextTurnParamsFunctions, ParsedToolCall, StepResult, StopCondition, StopWhen, Tool, ToolExecutionResult, ToolExecutionResultUnion, ToolPreliminaryResultEvent, ToolStreamEvent, ToolWithExecute, ToolWithGenerator, TurnContext, TypedToolCall, TypedToolCallUnion, Warning, } from './lib/tool-types.js';
+export type { ChatStreamEvent, ConversationState, ConversationStatus, ResponseStreamEvent as EnhancedResponseStreamEvent, HasApprovalTools, InferToolEvent, InferToolEventsUnion, InferToolInput, InferToolOutput, ManualTool, NextTurnParamsContext, NextTurnParamsFunctions, ParsedToolCall, PartialResponse, StateAccessor, StepResult, StopCondition, StopWhen, Tool, ToolApprovalCheck, ToolExecutionResult, ToolExecutionResultUnion, ToolHasApproval, ToolPreliminaryResultEvent, ToolStreamEvent, ToolWithExecute, ToolWithGenerator, TurnContext, TypedToolCall, TypedToolCallUnion, UnsentToolResult, Warning, } from './lib/tool-types.js';
 export type { BuildTurnContextOptions } from './lib/turn-context.js';
 export type { ClaudeBase64ImageSource, ClaudeCacheControl, ClaudeCitationCharLocation, ClaudeCitationContentBlockLocation, ClaudeCitationPageLocation, ClaudeCitationSearchResultLocation, ClaudeCitationWebSearchResultLocation, ClaudeContentBlock, ClaudeContentBlockParam, ClaudeImageBlockParam, ClaudeMessage, ClaudeMessageParam, ClaudeRedactedThinkingBlock, ClaudeServerToolUseBlock, ClaudeStopReason, ClaudeTextBlock, ClaudeTextBlockParam, ClaudeTextCitation, ClaudeThinkingBlock, ClaudeToolResultBlockParam, ClaudeToolUseBlock, ClaudeToolUseBlockParam, ClaudeURLImageSource, ClaudeUsage, } from './models/claude-message.js';
 export { fromClaudeMessages, toClaudeMessage } from './lib/anthropic-compat.js';
@@ -15,8 +15,9 @@ export { applyNextTurnParamsToRequest, buildNextTurnParamsContext, executeNextTu
 export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed, stepCountIs, } from './lib/stop-conditions.js';
 export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
 export { tool } from './lib/tool.js';
-export { hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolPreliminaryResultEvent, ToolType, } from './lib/tool-types.js';
+export { hasApprovalRequiredTools, hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolPreliminaryResultEvent, toolHasApprovalConfigured, ToolType, } from './lib/tool-types.js';
 export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
+export { appendToMessages, createInitialState, createRejectedResult, createUnsentResult, generateConversationId, partitionToolCalls, toolRequiresApproval, updateState, } from './lib/conversation-state.js';
 export { ToolEventBroadcaster } from './lib/tool-event-broadcaster.js';
 export * from './sdk/sdk.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/index.js

@@ -18,9 +18,11 @@ export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed
 export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
 // Tool creation helpers
 export { tool } from './lib/tool.js';
-export { hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolPreliminaryResultEvent, ToolType, } from './lib/tool-types.js';
+export { hasApprovalRequiredTools, hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolPreliminaryResultEvent, toolHasApprovalConfigured, ToolType, } from './lib/tool-types.js';
 // Turn context helpers
 export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
+// Conversation state helpers
+export { appendToMessages, createInitialState, createRejectedResult, createUnsentResult, generateConversationId, partitionToolCalls, toolRequiresApproval, updateState, } from './lib/conversation-state.js';
 // Real-time tool event broadcasting
 export { ToolEventBroadcaster } from './lib/tool-event-broadcaster.js';
 export * from './sdk/sdk.js';

package/esm/lib/anthropic-compat.test.js

@@ -9,12 +9,15 @@ function createMockResponse(overrides) {
         id: "resp_test",
         object: "response",
         createdAt: Date.now(),
+        completedAt: Date.now(),
         model: "openai/gpt-4",
         status: "completed",
         error: null,
         incompleteDetails: null,
         temperature: null,
         topP: null,
+        presencePenalty: null,
+        frequencyPenalty: null,
         metadata: null,
         tools: [],
         toolChoice: "auto",

package/esm/lib/async-params.d.ts

@@ -1,20 +1,60 @@
 import type * as models from '../models/index.js';
-import type { StopWhen, Tool, TurnContext } from './tool-types.js';
+import type { ParsedToolCall, StateAccessor, StopWhen, Tool, TurnContext } from './tool-types.js';
+export type { Tool } from './tool-types.js';
 /**
  * A field can be either a value of type T or a function that computes T
  */
 export type FieldOrAsyncFunction<T> = T | ((context: TurnContext) => T | Promise<T>);
 /**
- * Input type for callModel function
- * Each field can independently be a static value or a function that computes the value
- * Generic over TTools to enable proper type inference for stopWhen conditions
+ * Base input type for callModel without approval-related fields
  */
-export type CallModelInput<TTools extends readonly Tool[] = readonly Tool[]> = {
+type BaseCallModelInput<TTools extends readonly Tool[] = readonly Tool[]> = {
     [K in keyof Omit<models.OpenResponsesRequest, 'stream' | 'tools'>]?: FieldOrAsyncFunction<models.OpenResponsesRequest[K]>;
 } & {
     tools?: TTools;
     stopWhen?: StopWhen<TTools>;
+    /**
+     * Call-level approval check - overrides tool-level requireApproval setting
+     * Receives the tool call and turn context, can be sync or async
+     */
+    requireApproval?: (toolCall: ParsedToolCall<TTools[number]>, context: TurnContext) => boolean | Promise<boolean>;
+};
+/**
+ * Approval params when state is provided (allows approve/reject)
+ */
+type ApprovalParamsWithState<TTools extends readonly Tool[] = readonly Tool[]> = {
+    /** State accessor for multi-turn persistence and approval gates */
+    state: StateAccessor<TTools>;
+    /** Tool call IDs to approve (for resuming from awaiting_approval status) */
+    approveToolCalls?: string[];
+    /** Tool call IDs to reject (for resuming from awaiting_approval status) */
+    rejectToolCalls?: string[];
+};
+/**
+ * Approval params when state is NOT provided (forbids approve/reject)
+ */
+type ApprovalParamsWithoutState = {
+    /** State accessor for multi-turn persistence and approval gates */
+    state?: undefined;
+    /** Not allowed without state - will cause type error */
+    approveToolCalls?: never;
+    /** Not allowed without state - will cause type error */
+    rejectToolCalls?: never;
 };
+/**
+ * Input type for callModel function
+ * Each field can independently be a static value or a function that computes the value
+ * Generic over TTools to enable proper type inference for stopWhen conditions
+ *
+ * Type enforcement:
+ * - `approveToolCalls` and `rejectToolCalls` are only valid when `state` is provided
+ * - Using these without `state` will cause a TypeScript error
+ */
+export type CallModelInput<TTools extends readonly Tool[] = readonly Tool[]> = BaseCallModelInput<TTools> & (ApprovalParamsWithState<TTools> | ApprovalParamsWithoutState);
+/**
+ * CallModelInput variant that requires state - use when approval workflows are needed
+ */
+export type CallModelInputWithState<TTools extends readonly Tool[] = readonly Tool[]> = BaseCallModelInput<TTools> & ApprovalParamsWithState<TTools>;
 /**
  * Resolved CallModelInput (all functions evaluated to values)
  * This is the type after all async functions have been resolved to their values
@@ -42,7 +82,7 @@ export type ResolvedCallModelInput = Omit<models.OpenResponsesRequest, 'stream'
  * // resolved.temperature === 0.2
  * ```
  */
-export declare function resolveAsyncFunctions(input: CallModelInput, context: TurnContext): Promise<ResolvedCallModelInput>;
+export declare function resolveAsyncFunctions<TTools extends readonly Tool[] = readonly Tool[]>(input: CallModelInput<TTools>, context: TurnContext): Promise<ResolvedCallModelInput>;
 /**
  * Check if input has any async functions that need resolution
  *

package/esm/lib/async-params.js

@@ -36,11 +36,19 @@ function buildResolvedRequest(entries) {
 export async function resolveAsyncFunctions(input, context) {
     // Build array of resolved entries
     const resolvedEntries = [];
+    // Fields that should not be sent to the API (client-side only)
+    const clientOnlyFields = new Set([
+        'stopWhen', // Handled separately in ModelResult
+        'state', // Client-side state management
+        'requireApproval', // Client-side approval check function
+        'approveToolCalls', // Client-side approval decisions
+        'rejectToolCalls', // Client-side rejection decisions
+    ]);
     // Iterate over all keys in the input
     for (const [key, value] of Object.entries(input)) {
-        // Skip stopWhen - it's handled separately in ModelResult
+        // Skip client-only fields - they're handled separately and shouldn't be sent to the API
         // Note: tools are already in API format at this point (converted in callModel()), so we include them
-        if (key === 'stopWhen') {
+        if (clientOnlyFields.has(key)) {
             continue;
         }
         if (isParameterFunction(value)) {

package/esm/lib/chat-compat.test.js

@@ -9,12 +9,15 @@ function createMockResponse(overrides) {
         id: "resp_test",
         object: "response",
         createdAt: Date.now(),
+        completedAt: Date.now(),
         model: "openai/gpt-4",
         status: "completed",
         error: null,
         incompleteDetails: null,
         temperature: null,
         topP: null,
+        presencePenalty: null,
+        frequencyPenalty: null,
         metadata: null,
         tools: [],
         toolChoice: "auto",

package/esm/lib/config.d.ts

@@ -1,4 +1,3 @@
-import { SDKHooks } from "../hooks/hooks.js";
 import { HTTPClient } from "./http.js";
 import { Logger } from "./logger.js";
 import { RetryConfig } from "./retries.js";
@@ -41,14 +40,13 @@ export type SDKOptions = {
     retryConfig?: RetryConfig;
     timeoutMs?: number;
     debugLogger?: Logger;
-    hooks?: SDKHooks;
 };
 export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "0.3.12";
+    readonly sdkVersion: "0.3.15";
     readonly genVersion: "2.788.4";
-    readonly userAgent: "speakeasy-sdk/typescript 0.3.12 2.788.4 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.3.15 2.788.4 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -26,8 +26,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.3.12",
+    sdkVersion: "0.3.15",
     genVersion: "2.788.4",
-    userAgent: "speakeasy-sdk/typescript 0.3.12 2.788.4 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.3.15 2.788.4 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/lib/conversation-state.d.ts

@@ -0,0 +1,61 @@
+import type * as models from '../models/index.js';
+import type { ConversationState, ParsedToolCall, Tool, TurnContext, UnsentToolResult } from './tool-types.js';
+/**
+ * Generate a unique ID for a conversation
+ * Uses crypto.randomUUID if available, falls back to timestamp + random
+ */
+export declare function generateConversationId(): string;
+/**
+ * Create an initial conversation state
+ * @param id - Optional custom ID, generates one if not provided
+ */
+export declare function createInitialState<TTools extends readonly Tool[] = readonly Tool[]>(id?: string): ConversationState<TTools>;
+/**
+ * Update a conversation state with new values
+ * Automatically updates the updatedAt timestamp
+ */
+export declare function updateState<TTools extends readonly Tool[] = readonly Tool[]>(state: ConversationState<TTools>, updates: Partial<Omit<ConversationState<TTools>, 'id' | 'createdAt' | 'updatedAt'>>): ConversationState<TTools>;
+/**
+ * Append new items to the message history
+ */
+export declare function appendToMessages(current: models.OpenResponsesInput, newItems: models.OpenResponsesInput1[]): models.OpenResponsesInput;
+/**
+ * Check if a tool call requires approval
+ * @param toolCall - The tool call to check
+ * @param tools - Available tools
+ * @param context - Turn context for the approval check
+ * @param callLevelCheck - Optional call-level approval function (overrides tool-level), can be async
+ */
+export declare function toolRequiresApproval<TTools extends readonly Tool[]>(toolCall: ParsedToolCall<TTools[number]>, tools: TTools, context: TurnContext, callLevelCheck?: (toolCall: ParsedToolCall<TTools[number]>, context: TurnContext) => boolean | Promise<boolean>): Promise<boolean>;
+/**
+ * Partition tool calls into those requiring approval and those that can auto-execute
+ * @param toolCalls - Tool calls to partition
+ * @param tools - Available tools
+ * @param context - Turn context for the approval check
+ * @param callLevelCheck - Optional call-level approval function (overrides tool-level), can be async
+ */
+export declare function partitionToolCalls<TTools extends readonly Tool[]>(toolCalls: ParsedToolCall<TTools[number]>[], tools: TTools, context: TurnContext, callLevelCheck?: (toolCall: ParsedToolCall<TTools[number]>, context: TurnContext) => boolean | Promise<boolean>): Promise<{
+    requiresApproval: ParsedToolCall<TTools[number]>[];
+    autoExecute: ParsedToolCall<TTools[number]>[];
+}>;
+/**
+ * Create an unsent tool result from a successful execution
+ */
+export declare function createUnsentResult<TTools extends readonly Tool[] = readonly Tool[]>(callId: string, name: string, output: unknown): UnsentToolResult<TTools>;
+/**
+ * Create an unsent tool result from a rejection
+ */
+export declare function createRejectedResult<TTools extends readonly Tool[] = readonly Tool[]>(callId: string, name: string, reason?: string): UnsentToolResult<TTools>;
+/**
+ * Convert unsent tool results to API format for sending to the model
+ */
+export declare function unsentResultsToAPIFormat(results: UnsentToolResult[]): models.OpenResponsesFunctionCallOutput[];
+/**
+ * Extract text content from a response
+ */
+export declare function extractTextFromResponse(response: models.OpenResponsesNonStreamingResponse): string;
+/**
+ * Extract tool calls from a response
+ */
+export declare function extractToolCallsFromResponse<TTools extends readonly Tool[]>(response: models.OpenResponsesNonStreamingResponse): ParsedToolCall<TTools[number]>[];
+//# sourceMappingURL=conversation-state.d.ts.map