@nirmos/sdk 0.3.2 → 0.3.3

package/src/gateway/mappers.ts

@@ -36,6 +36,12 @@ export function toWireMessage(message: ChatMessage): Record<string, unknown> {
               audio: { data: part.data, format: part.format },
             };
           }),
+    ...(message.reasoning !== undefined
+      ? { reasoning: message.reasoning }
+      : {}),
+    ...(message.reasoningDetails?.length
+      ? { reasoning_details: message.reasoningDetails }
+      : {}),
     ...(message.name ? { name: message.name } : {}),
     ...(message.toolCallId ? { tool_call_id: message.toolCallId } : {}),
     ...(message.toolCalls && message.toolCalls.length > 0
@@ -68,8 +74,15 @@ export function normalizeUsage(value: unknown): Usage {
     totalTokens:
       readNumber(usage, "total_tokens", "totalTokens") ??
       inputTokens + outputTokens,
-    cachedTokens: readNumber(usage, "cached_tokens", "cachedTokens"),
-    reasoningTokens: readNumber(usage, "reasoning_tokens", "reasoningTokens"),
+    cachedTokens:
+      readNumber(usage, "cached_tokens", "cachedTokens") ??
+      readNumber(asUnknownRecord(usage.prompt_tokens_details), "cached_tokens"),
+    reasoningTokens:
+      readNumber(usage, "reasoning_tokens", "reasoningTokens") ??
+      readNumber(
+        asUnknownRecord(usage.completion_tokens_details),
+        "reasoning_tokens",
+      ),
   };
 }
 
@@ -183,6 +196,12 @@ export function normalizeMessage(value: unknown): ChatMessage {
         ? content
         : "",
     name: readString(message, "name"),
+    reasoning: readString(message, "reasoning"),
+    reasoningDetails: readArray(
+      message,
+      "reasoning_details",
+      "reasoningDetails",
+    ) as ChatMessage["reasoningDetails"],
     toolCallId: readString(message, "tool_call_id", "toolCallId"),
     toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
   };
@@ -232,3 +251,37 @@ function normalizeFinishReason(
   if (value === "content_filter") return "contentFilter";
   return value;
 }
+
+/** Assemble indexed reasoning blocks without losing encrypted continuation data. */
+export function mergeReasoningDetails(
+  current: NonNullable<ChatMessage["reasoningDetails"]>,
+  incoming: NonNullable<ChatMessage["reasoningDetails"]>,
+): NonNullable<ChatMessage["reasoningDetails"]> {
+  const result = [...current];
+  for (const value of incoming) {
+    const detail = asUnknownRecord(value);
+    const position = result.findIndex((item) => {
+      const previous = asUnknownRecord(item);
+      return (
+        previous.type === detail.type &&
+        ((detail.index !== undefined && previous.index === detail.index) ||
+          (typeof detail.id === "string" && previous.id === detail.id))
+      );
+    });
+    if (position < 0) {
+      result.push(value);
+      continue;
+    }
+    const previous = asUnknownRecord(result[position]);
+    const merged = { ...previous, ...detail };
+    for (const field of ["text", "summary", "data", "signature"]) {
+      if (
+        typeof previous[field] === "string" &&
+        typeof detail[field] === "string"
+      )
+        merged[field] = previous[field] + detail[field];
+    }
+    result[position] = merged as (typeof result)[number];
+  }
+  return result;
+}

package/src/gateway/types.ts

@@ -45,6 +45,8 @@ export interface ChatMessage {
   role: ChatRole;
   content: string | readonly ChatContentPart[];
   name?: string;
+  reasoning?: string;
+  reasoningDetails?: readonly JsonValue[];
   toolCallId?: string;
   toolCalls?: readonly FunctionToolCall[];
 }
@@ -106,6 +108,8 @@ interface ChatCreateParamsBase {
   user?: string;
   /** Optional provider override. Omit to let the gateway select a provider. */
   provider?: string;
+  /** Options scoped to an upstream provider slug; other targets never receive them. */
+  providerOptions?: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
   fallbackModels?: readonly string[];
   routingStrategy?: RoutingStrategy;
   metadata?: Readonly<Record<string, JsonValue>>;
@@ -167,6 +171,8 @@ export interface EmbeddingCreateParams {
   user?: string;
   /** Optional provider override. Omit to use the model's configured default provider. */
   provider?: string;
+  /** Options scoped to an upstream provider slug; other targets never receive them. */
+  providerOptions?: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
   /** @deprecated Embeddings never fall back to another vector space. Requests with this option are rejected. */
   fallbackModels?: readonly string[];
   /** @deprecated Embeddings require direct model selection. */
@@ -204,6 +210,8 @@ export interface ImageGenerateParams {
   user?: string;
   /** Optional provider override. Omit to use the model's configured default provider. */
   provider?: string;
+  /** Options scoped to an upstream provider slug; other targets never receive them. */
+  providerOptions?: Readonly<Record<string, Readonly<Record<string, JsonValue>>>>;
   metadata?: Readonly<Record<string, JsonValue>>;
 }
 

package/src/management/contracts.ts

@@ -2,15 +2,15 @@
 export type ApiError = { "error": { "code": string; "message": string; "details"?: unknown; "requestId": string; }; };
 export type listProvidersQuery = { "limit"?: number; "cursor"?: string; };
 export type listProvidersResponse___schema0 = string | number | boolean | null | Array<listProvidersResponse___schema0> | { [key: string]: listProvidersResponse___schema0; };
-export type listProvidersResponse = { "items": Array<{ "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "capabilities": listProvidersResponse___schema0 | null; "metadata": listProvidersResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; }>; "nextCursor": string | null; };
+export type listProvidersResponse = { "items": Array<{ "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "authSchema"?: listProvidersResponse___schema0 | null; "capabilities": listProvidersResponse___schema0 | null; "metadata": listProvidersResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; }>; "nextCursor": string | null; };
 export type getProviderResponse___schema0 = string | number | boolean | null | Array<getProviderResponse___schema0> | { [key: string]: getProviderResponse___schema0; };
-export type getProviderResponse = { "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "capabilities": getProviderResponse___schema0 | null; "metadata": getProviderResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; };
+export type getProviderResponse = { "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "authSchema"?: getProviderResponse___schema0 | null; "capabilities": getProviderResponse___schema0 | null; "metadata": getProviderResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; };
 export type createProviderRequest = { "name": string; "slug"?: string; "description"?: string; "baseUrl": string; "kind": string; "adapterType": "native_sdk" | "openai_compatible" | "vercel_ai_sdk"; };
 export type createProviderResponse___schema0 = string | number | boolean | null | Array<createProviderResponse___schema0> | { [key: string]: createProviderResponse___schema0; };
-export type createProviderResponse = { "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "capabilities": createProviderResponse___schema0 | null; "metadata": createProviderResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; };
+export type createProviderResponse = { "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "authSchema"?: createProviderResponse___schema0 | null; "capabilities": createProviderResponse___schema0 | null; "metadata": createProviderResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; };
 export type updateProviderRequest = { "name"?: string; "slug"?: string; "description"?: string; "baseUrl"?: string; "kind"?: string; "adapterType"?: "native_sdk" | "openai_compatible" | "vercel_ai_sdk"; "status"?: "active" | "degraded" | "outage" | "maintenance"; };
 export type updateProviderResponse___schema0 = string | number | boolean | null | Array<updateProviderResponse___schema0> | { [key: string]: updateProviderResponse___schema0; };
-export type updateProviderResponse = { "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "capabilities": updateProviderResponse___schema0 | null; "metadata": updateProviderResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; };
+export type updateProviderResponse = { "id": string; "name": string; "slug": string; "kind": string; "scope": string; "status": string; "isCustom": boolean; "modelCount"?: number; "baseUrl": string | null; "adapterType": string | null; "authSchema"?: updateProviderResponse___schema0 | null; "capabilities": updateProviderResponse___schema0 | null; "metadata": updateProviderResponse___schema0 | null; "logoUrl"?: string | null; "createdAt": string; "updatedAt": string; };
 export type deleteProviderResponse = { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
 export type listModelsQuery = { "limit"?: number; "cursor"?: string; "capability"?: "embeddings" | "chat" | "vision" | "tools" | "json" | "streaming"; "providerId"?: string; "availability"?: "true" | "false"; };
 export type listModelsResponse___schema0 = string | number | boolean | null | Array<listModelsResponse___schema0> | { [key: string]: listModelsResponse___schema0; };
@@ -25,14 +25,14 @@ export type updateModelResponse___schema0 = string | number | boolean | null | A
 export type updateModelResponse = { "id": string; "name": string; "slug": string; "providerId": string; "availability": boolean; "scope": string; "externalId": string | null; "status": string; "lifecycleStatus": string; "runtimeHealth": string; "contextWindow": number | null; "maxOutputTokens": number | null; "capabilities": updateModelResponse___schema0 | null; "pricing": updateModelResponse___schema0 | null; "metadata": updateModelResponse___schema0 | null; "createdAt": string; "updatedAt": string; "knowledgeSupportedDimensions"?: Array<number>; "knowledgeRecommendedDimensions"?: number; };
 export type deleteModelResponse = { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
 export type listCredentialsQuery = { "limit"?: number; "cursor"?: string; "providerId"?: string; };
-export type listCredentialsResponse = { "items": Array<{ "id": string; "name": string; "providerId"?: string; "provider"?: { "id": string; "name": string; "slug": string; }; "providerName"?: string; "providerSlug"?: string; "environmentId"?: string | null; "label"?: string | null; "credentialType": string; "keyPreview"?: string | null; "isDefault"?: boolean; "status": string; "validationStatus"?: string; "validatedAt"?: string | null; "version"?: number; "lastRotatedAt"?: string | null; "lastUsedAt"?: string | null; "usageCount"?: number; "expiresAt"?: string | null; "createdAt": string; "updatedAt"?: string; }>; "nextCursor": string | null; };
+export type listCredentialsResponse = { "items": Array<{ "id": string; "name": string; "providerId"?: string; "provider"?: { "id": string; "name": string; "slug": string; }; "providerName"?: string; "providerSlug"?: string; "environmentId"?: string | null; "label"?: string | null; "config"?: { "accountId"?: string; }; "credentialType": string; "keyPreview"?: string | null; "isDefault"?: boolean; "status": string; "validationStatus"?: string; "validatedAt"?: string | null; "version"?: number; "lastRotatedAt"?: string | null; "lastUsedAt"?: string | null; "usageCount"?: number; "expiresAt"?: string | null; "createdAt": string; "updatedAt"?: string; }>; "nextCursor": string | null; };
 export type createCredentialRequest___schema0 = string | number | boolean | null | Array<createCredentialRequest___schema0> | { [key: string]: createCredentialRequest___schema0; };
 export type createCredentialRequest = { "name": string; "providerId": string; "environmentId"?: string; "label"?: string; "credentialType": "api_key" | "oauth" | "azure" | "aws" | "custom"; "secretData"?: { [key: string]: string | number | boolean; }; "secret"?: string; "config"?: { [key: string]: createCredentialRequest___schema0; }; "isDefault"?: boolean; "expiresAt"?: string; };
-export type createCredentialResponse = { "id": string; "name": string; "providerId"?: string; "provider"?: { "id": string; "name": string; "slug": string; }; "providerName"?: string; "providerSlug"?: string; "environmentId"?: string | null; "label"?: string | null; "credentialType": string; "keyPreview"?: string | null; "isDefault"?: boolean; "status": string; "validationStatus"?: string; "validatedAt"?: string | null; "version"?: number; "lastRotatedAt"?: string | null; "lastUsedAt"?: string | null; "usageCount"?: number; "expiresAt"?: string | null; "createdAt": string; "updatedAt"?: string; } | { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
+export type createCredentialResponse = { "id": string; "name": string; "providerId"?: string; "provider"?: { "id": string; "name": string; "slug": string; }; "providerName"?: string; "providerSlug"?: string; "environmentId"?: string | null; "label"?: string | null; "config"?: { "accountId"?: string; }; "credentialType": string; "keyPreview"?: string | null; "isDefault"?: boolean; "status": string; "validationStatus"?: string; "validatedAt"?: string | null; "version"?: number; "lastRotatedAt"?: string | null; "lastUsedAt"?: string | null; "usageCount"?: number; "expiresAt"?: string | null; "createdAt": string; "updatedAt"?: string; } | { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
 export type updateCredentialRequest___schema0 = string | number | boolean | null | Array<updateCredentialRequest___schema0> | { [key: string]: updateCredentialRequest___schema0; };
 export type updateCredentialRequest___schema1 = string | number | boolean | null | Array<updateCredentialRequest___schema1> | { [key: string]: updateCredentialRequest___schema1; };
 export type updateCredentialRequest = { "name"?: string; "label"?: string; "secret"?: string; "secretData"?: { [key: string]: updateCredentialRequest___schema0; }; "config"?: { [key: string]: updateCredentialRequest___schema1; }; "isDefault"?: boolean; "expiresAt"?: string | null; };
-export type updateCredentialResponse = { "id": string; "name": string; "providerId"?: string; "provider"?: { "id": string; "name": string; "slug": string; }; "providerName"?: string; "providerSlug"?: string; "environmentId"?: string | null; "label"?: string | null; "credentialType": string; "keyPreview"?: string | null; "isDefault"?: boolean; "status": string; "validationStatus"?: string; "validatedAt"?: string | null; "version"?: number; "lastRotatedAt"?: string | null; "lastUsedAt"?: string | null; "usageCount"?: number; "expiresAt"?: string | null; "createdAt": string; "updatedAt"?: string; } | { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
+export type updateCredentialResponse = { "id": string; "name": string; "providerId"?: string; "provider"?: { "id": string; "name": string; "slug": string; }; "providerName"?: string; "providerSlug"?: string; "environmentId"?: string | null; "label"?: string | null; "config"?: { "accountId"?: string; }; "credentialType": string; "keyPreview"?: string | null; "isDefault"?: boolean; "status": string; "validationStatus"?: string; "validatedAt"?: string | null; "version"?: number; "lastRotatedAt"?: string | null; "lastUsedAt"?: string | null; "usageCount"?: number; "expiresAt"?: string | null; "createdAt": string; "updatedAt"?: string; } | { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
 export type deleteCredentialResponse = { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
 export type validateCredentialResponse = { "id"?: string; "promptId"?: string; "branchId"?: string; "branchSlug"?: string; "versionId"?: string; "mergedVersionId"?: string; "version"?: number; "count"?: number; "imported"?: number; "completed"?: boolean; "deleted"?: boolean; "status"?: string; "existing"?: boolean; "valid"?: boolean; "error"?: string; "scoreFinalized"?: boolean; "result"?: string | null; };
 export type listPromptsQuery = { "limit"?: number; "cursor"?: string; "search"?: string; "status"?: "all" | "draft" | "published" | "archived"; "sort"?: "updated" | "newest" | "oldest" | "name"; };
@@ -488,14 +488,14 @@ export type workspaceSummaryResponse___schema0 = string | number | boolean | nul
 export type workspaceSummaryResponse = { "user": { "id": string; "name": string; "email": string; "image"?: string | null; }; "activeOrganization": { "id": string; "memberCount"?: number; "pendingInvitationCount"?: number; "name": string; "slug": string; "createdAt": string; "logo"?: string | null; "metadata"?: workspaceSummaryResponse___schema0 | null; } | null; "role": string | null; "metrics": { "organizations": number; "members": number; "pendingInvitations": number; "managedTokens": number; }; };
 export type listLogsQuery = { "limit"?: number; "cursor"?: string; "providerId"?: string; "modelId"?: string; "applicationId"?: string; "environmentId"?: string; "traceId"?: string; "success"?: "true" | "false"; "from"?: string; "to"?: string; };
 export type listLogsResponse___schema0 = string | number | boolean | null | Array<listLogsResponse___schema0> | { [key: string]: listLogsResponse___schema0; };
-export type listLogsResponse = { "items": Array<{ "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: listLogsResponse___schema0 | null; "responsePayload"?: listLogsResponse___schema0 | null; "errorCode"?: string | null; }>; "nextCursor": string | null; };
+export type listLogsResponse = { "items": Array<{ "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: listLogsResponse___schema0 | null; "responsePayload"?: listLogsResponse___schema0 | null; "errorCode"?: string | null; "statusCode"?: number | null; "retryable"?: boolean; "retryAfterMs"?: number; "diagnostics"?: { "memoryRunId"?: string; "memoryOperation"?: string; "parentRequestId"?: string; "parentTraceId"?: string; }; }>; "nextCursor": string | null; };
 export type listTracesQuery = { "limit"?: number; "cursor"?: string; "providerId"?: string; "modelId"?: string; "applicationId"?: string; "environmentId"?: string; "traceId"?: string; "success"?: "true" | "false"; "from"?: string; "to"?: string; };
 export type listTracesResponse___schema0 = string | number | boolean | null | Array<listTracesResponse___schema0> | { [key: string]: listTracesResponse___schema0; };
-export type listTracesResponse = { "items": Array<{ "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: listTracesResponse___schema0 | null; "responsePayload"?: listTracesResponse___schema0 | null; "errorCode"?: string | null; }>; "nextCursor": string | null; };
+export type listTracesResponse = { "items": Array<{ "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: listTracesResponse___schema0 | null; "responsePayload"?: listTracesResponse___schema0 | null; "errorCode"?: string | null; "statusCode"?: number | null; "retryable"?: boolean; "retryAfterMs"?: number; "diagnostics"?: { "memoryRunId"?: string; "memoryOperation"?: string; "parentRequestId"?: string; "parentTraceId"?: string; }; }>; "nextCursor": string | null; };
 export type getLogResponse___schema0 = string | number | boolean | null | Array<getLogResponse___schema0> | { [key: string]: getLogResponse___schema0; };
-export type getLogResponse = { "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: getLogResponse___schema0 | null; "responsePayload"?: getLogResponse___schema0 | null; "errorCode"?: string | null; };
+export type getLogResponse = { "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: getLogResponse___schema0 | null; "responsePayload"?: getLogResponse___schema0 | null; "errorCode"?: string | null; "statusCode"?: number | null; "retryable"?: boolean; "retryAfterMs"?: number; "diagnostics"?: { "memoryRunId"?: string; "memoryOperation"?: string; "parentRequestId"?: string; "parentTraceId"?: string; }; };
 export type getTraceResponse___schema0 = string | number | boolean | null | Array<getTraceResponse___schema0> | { [key: string]: getTraceResponse___schema0; };
-export type getTraceResponse = { "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: getTraceResponse___schema0 | null; "responsePayload"?: getTraceResponse___schema0 | null; "errorCode"?: string | null; };
+export type getTraceResponse = { "id": string; "requestId": string; "traceId": string | null; "executionType"?: string; "createdAt": string; "providerId": string | null; "modelId": string | null; "providerName": string | null; "modelName": string | null; "applicationId": string | null; "environmentId": string | null; "apiKeyId": string | null; "success": boolean; "latencyMs": number | null; "promptTokens": number | null; "completionTokens": number | null; "totalTokens": number | null; "estimatedCost": number | null; "cacheHit": boolean; "retryCount": number; "fallbackCount": number; "requestPayload"?: getTraceResponse___schema0 | null; "responsePayload"?: getTraceResponse___schema0 | null; "errorCode"?: string | null; "statusCode"?: number | null; "retryable"?: boolean; "retryAfterMs"?: number; "diagnostics"?: { "memoryRunId"?: string; "memoryOperation"?: string; "parentRequestId"?: string; "parentTraceId"?: string; }; };
 export type gatewayOverviewResponse = string | number | boolean | null | Array<gatewayOverviewResponse> | { [key: string]: gatewayOverviewResponse; };
 export type providerHealthResponse = string | number | boolean | null | Array<providerHealthResponse> | { [key: string]: providerHealthResponse; };
 export type observabilityOverviewQuery = { "from"?: string; "to"?: string; };
@@ -589,15 +589,15 @@ export type listMemoryItemEvidenceResponse = { "items": Array<{ "id": string; "m
 export type listMemoryItemRelationsQuery = { "limit"?: number; "cursor"?: string; };
 export type listMemoryItemRelationsResponse = { "items": Array<{ "id": string; "fromMemoryId": string; "toMemoryId": string; "relationType": string; "confidence": number | null; "createdAt": string; }>; "nextCursor": string | null; };
 export type listMemoryItemEmbeddingsQuery = { "limit"?: number; "cursor"?: string; };
-export type listMemoryItemEmbeddingsResponse = { "items": Array<{ "id": string; "createdAt": string; "updatedAt": string; "memoryId": string; "modelId": string; "embeddingModel": string; "embeddingProvider": string; "dimensions": number; "vectorStoreConnectionId": string; "collection": string; "namespace": string | null; "vectorId": string; "contentHash": string; "status": string; "indexedAt": string | null; "staleAt": string | null; "errorCode": string | null; }>; "nextCursor": string | null; };
+export type listMemoryItemEmbeddingsResponse = { "items": Array<{ "id": string; "createdAt": string; "updatedAt": string; "memoryId": string; "modelId": string; "embeddingModel": string; "embeddingProvider": string; "dimensions": number; "vectorStoreConnectionId": string; "collection": string; "namespace": string | null; "vectorId": string; "contentHash": string; "status": string; "indexedAt": string | null; "staleAt": string | null; "errorCode": string | null; "diagnosticReference": string | null; "diagnostics": { "stage": string; "memoryRunId"?: string; "gatewayRequestId"?: string; "requestId"?: string; "traceId"?: string; "providerCode"?: string; "providerStatus"?: number; "retryAfterMs"?: number; } | null; }>; "nextCursor": string | null; };
 export type listMemoryItemEntitiesQuery = { "limit"?: number; "cursor"?: string; };
 export type listMemoryItemEntitiesResponse = { "items": Array<{ "id": string; "memoryId": string; "entityId": string; "role": string; "confidence": number | null; "entity": { "id": string; "canonicalName": string; "entityType": string; "aliases": Array<string>; "externalId": string | null; }; }>; "nextCursor": string | null; };
 export type getMemorySpaceProfileQuery = { "subjectType"?: string; "subjectId"?: string; };
 export type getMemorySpaceProfileResponse___schema0 = string | number | boolean | null | Array<getMemorySpaceProfileResponse___schema0> | { [key: string]: getMemorySpaceProfileResponse___schema0; };
 export type getMemorySpaceProfileResponse = { "id": string; "createdAt": string; "updatedAt": string; "memorySpaceId": string; "subjectType": string; "subjectId": string; "summary": string | null; "attributes": getMemorySpaceProfileResponse___schema0; "version": number; "generatedAt": string | null; "sourceRunId": string | null; };
 export type listMemoryRunsQuery = { "limit"?: number; "cursor"?: string; "memorySpaceId"?: string; "runType"?: "episode_extraction" | "conversation_extraction" | "reconciliation" | "observation_generation" | "profile_generation" | "reindex" | "deletion" | "custom"; "status"?: "pending" | "running" | "completed" | "partial" | "failed" | "cancelled"; "createdAfter"?: string; "createdBefore"?: string; };
-export type listMemoryRunsResponse = { "items": Array<{ "id": string; "createdAt": string; "updatedAt": string; "memorySpaceId": string; "runType": string; "status": string; "policyId": string | null; "model": string | null; "provider": string | null; "startedAt": string | null; "completedAt": string | null; "inputEpisodeCount": number; "candidateCount": number; "acceptedCount": number; "rejectedCount": number; "insertedCount": number; "mergedCount": number; "reinforcedCount": number; "supersededCount": number; "ignoredCount": number; "errorCode": string | null; }>; "nextCursor": string | null; };
-export type getMemoryRunResponse = { "id": string; "createdAt": string; "updatedAt": string; "memorySpaceId": string; "runType": string; "status": string; "policyId": string | null; "model": string | null; "provider": string | null; "startedAt": string | null; "completedAt": string | null; "inputEpisodeCount": number; "candidateCount": number; "acceptedCount": number; "rejectedCount": number; "insertedCount": number; "mergedCount": number; "reinforcedCount": number; "supersededCount": number; "ignoredCount": number; "errorCode": string | null; };
+export type listMemoryRunsResponse = { "items": Array<{ "id": string; "createdAt": string; "updatedAt": string; "memorySpaceId": string; "runType": string; "status": string; "policyId": string | null; "model": string | null; "provider": string | null; "startedAt": string | null; "completedAt": string | null; "inputEpisodeCount": number; "candidateCount": number; "acceptedCount": number; "rejectedCount": number; "insertedCount": number; "mergedCount": number; "reinforcedCount": number; "supersededCount": number; "ignoredCount": number; "errorCode": string | null; "diagnosticReference": string | null; "diagnostics": { "stage": string; "memoryRunId"?: string; "gatewayRequestId"?: string; "requestId"?: string; "traceId"?: string; "providerCode"?: string; "providerStatus"?: number; "retryAfterMs"?: number; } | null; }>; "nextCursor": string | null; };
+export type getMemoryRunResponse = { "id": string; "createdAt": string; "updatedAt": string; "memorySpaceId": string; "runType": string; "status": string; "policyId": string | null; "model": string | null; "provider": string | null; "startedAt": string | null; "completedAt": string | null; "inputEpisodeCount": number; "candidateCount": number; "acceptedCount": number; "rejectedCount": number; "insertedCount": number; "mergedCount": number; "reinforcedCount": number; "supersededCount": number; "ignoredCount": number; "errorCode": string | null; "diagnosticReference": string | null; "diagnostics": { "stage": string; "memoryRunId"?: string; "gatewayRequestId"?: string; "requestId"?: string; "traceId"?: string; "providerCode"?: string; "providerStatus"?: number; "retryAfterMs"?: number; } | null; };
 export interface Requests { "listProviders": undefined;
 "getProvider": undefined;
 "createProvider": createProviderRequest;

package/src/memory/types.ts

@@ -79,6 +79,10 @@ export interface MemorySearchFilters {
 export interface MemorySearchRequest {
   memorySpaceId: string;
   query: string;
+  /** Default relevant: one bounded model check. Raw returns nearest neighbors without validation. */
+  relevance?: "relevant" | "raw";
+  /** Minimum normalized vector similarity (0–1), before ranking. Calibrate per embedding model. */
+  minScore?: number;
   limit?: number;
   filters?: MemorySearchFilters;
 }
@@ -100,12 +104,19 @@ export type MemoryResult = Pick<
   | "confidence"
 >;
 export interface MemorySearchResponse {
-  memories: Array<MemoryResult & { score: number }>;
-}
-export interface MemoryContextResponse {
-  memories: Array<MemoryResult & { score?: number }>;
+  memories: Array<MemoryResult & { score: number; similarityScore: number }>;
+  relevance: "relevant" | "raw";
 }
+export type MemoryContextResponse = MemorySearchResponse;
+
 export interface MemoryIndexingResult {
+  /** Safe stage/provider diagnostics for partial indexing failures. */
+  diagnostics?: Array<{
+    code: string;
+    status: number;
+    retryable: boolean;
+    details?: Record<string, unknown>;
+  }>;
   indexed: number;
   failed: number;
 }