@qpqjs/core 0.3.0 → 0.5.0

package/README.md

@@ -74,7 +74,7 @@ A mock can be a literal value or a function, and a function mock is re-invoked p
 ## Conventions worth knowing
 
 - Anything named `ask*` is a generator and must be called with `yield*`. The [ESLint plugin](https://github.com/qpqjs/quidproquo/tree/main/packages/eslint-config) enforces this and auto-fixes a missing `yield*`.
-- Stories must be deterministic. No `Date.now()`, `Math.random()`, or `crypto.randomUUID()`. Yield `askDateNow()` or `askNewGuid()` so logs replay and tests stay stable.
+- Stories must be deterministic. No `Date.now()`, `Math.random()`, or `crypto.randomUUID()`. Yield `askDateNow()` or `askGuidNew()` so logs replay and tests stay stable.
 - Throw with `return yield* askThrowError(...)`, which tells TypeScript that control stops there.
 
 ## Status

package/lib/commonjs/actions/ai/AiMessage.d.ts

@@ -1,40 +1,40 @@
-export interface AiTextPart {
+export type AiTextPart = {
     type: 'text';
     text: string;
-}
-export interface AiFileUrlPart {
+};
+export type AiFileUrlPart = {
     type: 'file';
     url: string;
     mediaType: string;
     filename?: string;
-}
-export interface AiFileDrivePart {
+};
+export type AiFileDrivePart = {
     type: 'file';
     drive: string;
     filepath: string;
     scope?: string;
     mediaType: string;
     filename?: string;
-}
+};
 export type AiFilePart = AiFileUrlPart | AiFileDrivePart;
-export interface AiToolCallPart {
+export type AiToolCallPart = {
     type: 'tool-call';
     toolCallId: string;
     toolName: string;
     input: unknown;
-}
-export interface AiReasoningPart {
+};
+export type AiReasoningPart = {
     type: 'reasoning';
     text: string;
     providerOptions?: Record<string, Record<string, unknown>>;
-}
-export interface AiToolResultPart {
+};
+export type AiToolResultPart = {
     type: 'tool-result';
     toolCallId: string;
     toolName: string;
     output: unknown;
     isError?: boolean;
-}
+};
 export type AiUserMessagePart = AiTextPart | AiFilePart;
 export type AiAssistantMessagePart = AiTextPart | AiFilePart | AiToolCallPart | AiReasoningPart;
 export type AiUserMessage = {

package/lib/commonjs/actions/ai/AiMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiMessage.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiMessage.ts"],"names":[],"mappings":"","sourcesContent":["export interface AiTextPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface AiFileUrlPart {\n  type: 'file';\n  url: string;\n  mediaType: string;\n  filename?: string;\n}\n\n// References a file on a storage drive — resolved to file contents by the action\n// processor at prompt time, so no presigned url ever enters logs or session state.\nexport interface AiFileDrivePart {\n  type: 'file';\n  drive: string;\n  filepath: string;\n  // Storage scope the file lives under, for scoped drives. Forwarded to the\n  // file read at resolve time; omit for unscoped drives.\n  scope?: string;\n  mediaType: string;\n  filename?: string;\n}\n\nexport type AiFilePart = AiFileUrlPart | AiFileDrivePart;\n\nexport interface AiToolCallPart {\n  type: 'tool-call';\n  toolCallId: string;\n  toolName: string;\n  input: unknown;\n}\n\nexport interface AiReasoningPart {\n  type: 'reasoning';\n  text: string;\n  providerOptions?: Record<string, Record<string, unknown>>;\n}\n\nexport interface AiToolResultPart {\n  type: 'tool-result';\n  toolCallId: string;\n  toolName: string;\n  output: unknown;\n  isError?: boolean;\n}\n\nexport type AiUserMessagePart = AiTextPart | AiFilePart;\nexport type AiAssistantMessagePart = AiTextPart | AiFilePart | AiToolCallPart | AiReasoningPart;\n\nexport type AiUserMessage = {\n  role: 'user';\n  content: string | AiUserMessagePart[];\n};\n\nexport type AiAssistantMessage = {\n  role: 'assistant';\n  content: string | AiAssistantMessagePart[];\n};\n\nexport type AiToolMessage = {\n  role: 'tool';\n  content: AiToolResultPart[];\n};\n\nexport type AiMessage = AiUserMessage | AiAssistantMessage | AiToolMessage;\n"]}
+{"version":3,"file":"AiMessage.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiMessage.ts"],"names":[],"mappings":"","sourcesContent":["export type AiTextPart = {\n  type: 'text';\n  text: string;\n};\n\nexport type AiFileUrlPart = {\n  type: 'file';\n  url: string;\n  mediaType: string;\n  filename?: string;\n};\n\n// References a file on a storage drive, resolved to file contents by the action\n// processor at prompt time, so no presigned url ever enters logs or session state.\nexport type AiFileDrivePart = {\n  type: 'file';\n  drive: string;\n  filepath: string;\n  // Storage scope the file lives under, for scoped drives. Forwarded to the\n  // file read at resolve time; omit for unscoped drives.\n  scope?: string;\n  mediaType: string;\n  filename?: string;\n};\n\nexport type AiFilePart = AiFileUrlPart | AiFileDrivePart;\n\nexport type AiToolCallPart = {\n  type: 'tool-call';\n  toolCallId: string;\n  toolName: string;\n  input: unknown;\n};\n\nexport type AiReasoningPart = {\n  type: 'reasoning';\n  text: string;\n  providerOptions?: Record<string, Record<string, unknown>>;\n};\n\nexport type AiToolResultPart = {\n  type: 'tool-result';\n  toolCallId: string;\n  toolName: string;\n  output: unknown;\n  isError?: boolean;\n};\n\nexport type AiUserMessagePart = AiTextPart | AiFilePart;\nexport type AiAssistantMessagePart = AiTextPart | AiFilePart | AiToolCallPart | AiReasoningPart;\n\nexport type AiUserMessage = {\n  role: 'user';\n  content: string | AiUserMessagePart[];\n};\n\nexport type AiAssistantMessage = {\n  role: 'assistant';\n  content: string | AiAssistantMessagePart[];\n};\n\nexport type AiToolMessage = {\n  role: 'tool';\n  content: AiToolResultPart[];\n};\n\nexport type AiMessage = AiUserMessage | AiAssistantMessage | AiToolMessage;\n"]}

package/lib/commonjs/actions/ai/askAiGetModelRegions.d.ts

@@ -5,4 +5,4 @@ import { AiModelRegionMap } from './AiModelRegionMap';
  * where a request's data goes. The mapping is platform-owned, so a story asks for it rather than
  * hard-coding it.
  */
-export declare const askAiGetModelRegions: import("../../types").ActionRequesterFunction<AiActionType.GetModelRegions, [], undefined, AiModelRegionMap, never>;
+export declare const askAiGetModelRegions: import("../..").ActionRequesterFunction<AiActionType.GetModelRegions, [], undefined, AiModelRegionMap, never>;

package/lib/commonjs/actions/ai/askAiGetModelRegions.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askAiGetModelRegions = void 0;
-const types_1 = require("../../types");
+const actions_1 = require("../../logic/actions");
 const AiActionType_1 = require("./AiActionType");
 /**
  * The regions every `AiModel` is offered in on the current platform, for a picker that shows
  * where a request's data goes. The mapping is platform-owned, so a story asks for it rather than
  * hard-coding it.
  */
-exports.askAiGetModelRegions = (0, types_1.createActionRequester)()({
+exports.askAiGetModelRegions = (0, actions_1.createActionRequester)()({
     actionType: AiActionType_1.AiActionType.GetModelRegions,
 });
 //# sourceMappingURL=askAiGetModelRegions.js.map

package/lib/commonjs/actions/ai/askAiGetModelRegions.js.map

@@ -1 +1 @@
-{"version":3,"file":"askAiGetModelRegions.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiGetModelRegions.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,iDAA8C;AAG9C;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,IAAA,6BAAqB,GAAoB,CAAC;IAC5E,UAAU,EAAE,2BAAY,CAAC,eAAe;CACzC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { AiActionType } from './AiActionType';\nimport { AiModelRegionMap } from './AiModelRegionMap';\n\n/**\n * The regions every `AiModel` is offered in on the current platform, for a picker that shows\n * where a request's data goes. The mapping is platform-owned, so a story asks for it rather than\n * hard-coding it.\n */\nexport const askAiGetModelRegions = createActionRequester<AiModelRegionMap>()({\n  actionType: AiActionType.GetModelRegions,\n});\n"]}
+{"version":3,"file":"askAiGetModelRegions.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiGetModelRegions.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAC5D,iDAA8C;AAG9C;;;;GAIG;AACU,QAAA,oBAAoB,GAAG,IAAA,+BAAqB,GAAoB,CAAC;IAC5E,UAAU,EAAE,2BAAY,CAAC,eAAe;CACzC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { AiActionType } from './AiActionType';\nimport { AiModelRegionMap } from './AiModelRegionMap';\n\n/**\n * The regions every `AiModel` is offered in on the current platform, for a picker that shows\n * where a request's data goes. The mapping is platform-owned, so a story asks for it rather than\n * hard-coding it.\n */\nexport const askAiGetModelRegions = createActionRequester<AiModelRegionMap>()({\n  actionType: AiActionType.GetModelRegions,\n});\n"]}

package/lib/commonjs/actions/ai/askAiPrompt.d.ts

@@ -41,7 +41,7 @@ export type AiPromptActionResult = {
     /** Token usage summed across every step, when the provider reports it. */
     usage?: AiStreamUsage;
 };
-export declare const askAiPrompt: import("../../types").ActionRequesterFunction<AiActionType.Prompt, [model: AiModel, prompt: string, options?: AskAiPromptOptions | undefined], {
+export declare const askAiPrompt: import("../..").ActionRequesterFunction<AiActionType.Prompt, [model: AiModel, prompt: string, options?: AskAiPromptOptions | undefined], {
     model: AiModel;
     prompt: string;
     messages: AiMessage[] | undefined;
@@ -56,4 +56,4 @@ export declare const askAiPrompt: import("../../types").ActionRequesterFunction<
     maxOutputTokens: number | undefined;
     outputSchema: AiJsonSchema | undefined;
     outputRepairAttempts: number | undefined;
-}, AiPromptActionResult, never>;
+}, AiPromptActionResult, "NotFound" | "NotImplemented" | "Invalid">;

package/lib/commonjs/actions/ai/askAiPrompt.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askAiPrompt = void 0;
-const types_1 = require("../../types");
+const actions_1 = require("../../logic/actions");
 const AiActionType_1 = require("./AiActionType");
-exports.askAiPrompt = (0, types_1.createActionRequester)()({
+exports.askAiPrompt = (0, actions_1.createActionRequester)()({
     actionType: AiActionType_1.AiActionType.Prompt,
+    errorTypes: [
+        'NotFound', // no ai config is defined under the given aiName
+        'NotImplemented', // the model is not offered on this platform
+        'Invalid', // the reply does not match outputSchema, even after the repair attempts
+    ],
     getPayload: (model, prompt, options) => ({
         model,
         prompt,

package/lib/commonjs/actions/ai/askAiPrompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"askAiPrompt.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPrompt.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AAEpD,iDAA8C;AA6CjC,QAAA,WAAW,GAAG,IAAA,6BAAqB,GAAwB,CAAC;IACvE,UAAU,EAAE,2BAAY,CAAC,MAAM;IAC/B,UAAU,EAAE,CAAC,KAAc,EAAE,MAAc,EAAE,OAA4B,EAAE,EAAE,CAAC,CAAC;QAC7E,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,WAAW,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW;QACjC,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;QACzB,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,aAAa,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa;QACrC,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,eAAe,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;QACzC,YAAY,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY;QACnC,oBAAoB,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,oBAAoB;KACpD,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { AiStreamUsage } from './types/AiStreamUsage';\nimport { AiActionType } from './AiActionType';\nimport { AiCacheTtl } from './AiCacheTtl';\nimport { AiJsonSchema } from './AiJsonSchema';\nimport { AiMessage } from './AiMessage';\nimport { AiModel } from './AiModel';\nimport { AiReasoningConfig } from './AiReasoningConfig';\n\nexport type AskAiPromptOptions = {\n  system?: string;\n  aiName?: string;\n  messages?: AiMessage[];\n  /** Per-request messages sent after `messages`. They never receive a cache point and the caller\n   *  never persists them; with only `prompt`, the prompt becomes the first user message. */\n  turnContext?: AiMessage[];\n  reasoning?: AiReasoningConfig;\n  caching?: boolean;\n  /** Requested lifetime of the request's cache points. Unset means `AiCacheTtl.Dynamic`. */\n  cacheTtl?: AiCacheTtl;\n  /** Stop the tool loop between steps once this much wall-clock time has passed. The\n   *  turn then finishes with `toolCalls` if the model still wanted to act, so it can be resumed. */\n  maxDurationMs?: number;\n  /** Cap on model/tool steps in one call. Unset means the loop runs until the model stops\n   *  (or `maxDurationMs` trips); client-side tools still halt it immediately. */\n  maxSteps?: number;\n  /** Output token cap per model call. Unset uses the provider default (8192 on Bedrock), which a\n   *  large tool input plus reasoning can exceed; the step then finishes with `length`. */\n  maxOutputTokens?: number;\n  /** The reply must be a JSON value matching this schema. It is checked before it is returned, and\n   *  a reply that does not match is an `Invalid` action error, never a result. */\n  outputSchema?: AiJsonSchema;\n  /** With `outputSchema`: how many times a reply that does not match is shown back to the model with\n   *  the problems listed, to correct. Each is another model call. Unset means none. */\n  outputRepairAttempts?: number;\n};\n\nexport type AiPromptActionResult = {\n  text: string;\n  /** The reply, parsed and checked against `outputSchema`. Set only when a schema was given. */\n  object?: unknown;\n  /** How many repair calls the reply took (see `outputRepairAttempts`). Set only with a schema. */\n  repairs?: number;\n  /** Token usage summed across every step, when the provider reports it. */\n  usage?: AiStreamUsage;\n};\n\nexport const askAiPrompt = createActionRequester<AiPromptActionResult>()({\n  actionType: AiActionType.Prompt,\n  getPayload: (model: AiModel, prompt: string, options?: AskAiPromptOptions) => ({\n    model,\n    prompt,\n    messages: options?.messages,\n    turnContext: options?.turnContext,\n    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n    cacheTtl: options?.cacheTtl,\n    maxDurationMs: options?.maxDurationMs,\n    maxSteps: options?.maxSteps,\n    maxOutputTokens: options?.maxOutputTokens,\n    outputSchema: options?.outputSchema,\n    outputRepairAttempts: options?.outputRepairAttempts,\n  }),\n});\n"]}
+{"version":3,"file":"askAiPrompt.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPrompt.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAE5D,iDAA8C;AA6CjC,QAAA,WAAW,GAAG,IAAA,+BAAqB,GAAwB,CAAC;IACvE,UAAU,EAAE,2BAAY,CAAC,MAAM;IAC/B,UAAU,EAAE;QACV,UAAU,EAAE,iDAAiD;QAC7D,gBAAgB,EAAE,4CAA4C;QAC9D,SAAS,EAAE,wEAAwE;KACpF;IACD,UAAU,EAAE,CAAC,KAAc,EAAE,MAAc,EAAE,OAA4B,EAAE,EAAE,CAAC,CAAC;QAC7E,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,WAAW,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW;QACjC,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;QACzB,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,aAAa,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa;QACrC,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,eAAe,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;QACzC,YAAY,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY;QACnC,oBAAoB,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,oBAAoB;KACpD,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { AiStreamUsage } from './types/AiStreamUsage';\nimport { AiActionType } from './AiActionType';\nimport { AiCacheTtl } from './AiCacheTtl';\nimport { AiJsonSchema } from './AiJsonSchema';\nimport { AiMessage } from './AiMessage';\nimport { AiModel } from './AiModel';\nimport { AiReasoningConfig } from './AiReasoningConfig';\n\nexport type AskAiPromptOptions = {\n  system?: string;\n  aiName?: string;\n  messages?: AiMessage[];\n  /** Per-request messages sent after `messages`. They never receive a cache point and the caller\n   *  never persists them; with only `prompt`, the prompt becomes the first user message. */\n  turnContext?: AiMessage[];\n  reasoning?: AiReasoningConfig;\n  caching?: boolean;\n  /** Requested lifetime of the request's cache points. Unset means `AiCacheTtl.Dynamic`. */\n  cacheTtl?: AiCacheTtl;\n  /** Stop the tool loop between steps once this much wall-clock time has passed. The\n   *  turn then finishes with `toolCalls` if the model still wanted to act, so it can be resumed. */\n  maxDurationMs?: number;\n  /** Cap on model/tool steps in one call. Unset means the loop runs until the model stops\n   *  (or `maxDurationMs` trips); client-side tools still halt it immediately. */\n  maxSteps?: number;\n  /** Output token cap per model call. Unset uses the provider default (8192 on Bedrock), which a\n   *  large tool input plus reasoning can exceed; the step then finishes with `length`. */\n  maxOutputTokens?: number;\n  /** The reply must be a JSON value matching this schema. It is checked before it is returned, and\n   *  a reply that does not match is an `Invalid` action error, never a result. */\n  outputSchema?: AiJsonSchema;\n  /** With `outputSchema`: how many times a reply that does not match is shown back to the model with\n   *  the problems listed, to correct. Each is another model call. Unset means none. */\n  outputRepairAttempts?: number;\n};\n\nexport type AiPromptActionResult = {\n  text: string;\n  /** The reply, parsed and checked against `outputSchema`. Set only when a schema was given. */\n  object?: unknown;\n  /** How many repair calls the reply took (see `outputRepairAttempts`). Set only with a schema. */\n  repairs?: number;\n  /** Token usage summed across every step, when the provider reports it. */\n  usage?: AiStreamUsage;\n};\n\nexport const askAiPrompt = createActionRequester<AiPromptActionResult>()({\n  actionType: AiActionType.Prompt,\n  errorTypes: [\n    'NotFound', // no ai config is defined under the given aiName\n    'NotImplemented', // the model is not offered on this platform\n    'Invalid', // the reply does not match outputSchema, even after the repair attempts\n  ],\n  getPayload: (model: AiModel, prompt: string, options?: AskAiPromptOptions) => ({\n    model,\n    prompt,\n    messages: options?.messages,\n    turnContext: options?.turnContext,\n    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n    cacheTtl: options?.cacheTtl,\n    maxDurationMs: options?.maxDurationMs,\n    maxSteps: options?.maxSteps,\n    maxOutputTokens: options?.maxOutputTokens,\n    outputSchema: options?.outputSchema,\n    outputRepairAttempts: options?.outputRepairAttempts,\n  }),\n});\n"]}

package/lib/commonjs/actions/ai/askAiPromptStream.d.ts

@@ -26,7 +26,7 @@ export type AskAiPromptStreamOptions = {
      *  large tool input plus reasoning can exceed; the step then finishes with `length`. */
     maxOutputTokens?: number;
 };
-export declare const askAiPromptStream: import("../../types").ActionRequesterFunction<AiActionType.PromptStream, [model: AiModel, prompt: string, options?: AskAiPromptStreamOptions | undefined], {
+export declare const askAiPromptStream: import("../..").ActionRequesterFunction<AiActionType.PromptStream, [model: AiModel, prompt: string, options?: AskAiPromptStreamOptions | undefined], {
     model: AiModel;
     prompt: string;
     messages: AiMessage[] | undefined;
@@ -39,4 +39,4 @@ export declare const askAiPromptStream: import("../../types").ActionRequesterFun
     maxDurationMs: number | undefined;
     maxSteps: number | undefined;
     maxOutputTokens: number | undefined;
-}, StreamHandle<"json", AiStreamPart>, never>;
+}, StreamHandle<"json", AiStreamPart>, "NotFound" | "NotImplemented">;

package/lib/commonjs/actions/ai/askAiPromptStream.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.askAiPromptStream = void 0;
-const types_1 = require("../../types");
+const actions_1 = require("../../logic/actions");
 const AiActionType_1 = require("./AiActionType");
-exports.askAiPromptStream = (0, types_1.createActionRequester)()({
+exports.askAiPromptStream = (0, actions_1.createActionRequester)()({
     actionType: AiActionType_1.AiActionType.PromptStream,
+    errorTypes: [
+        'NotFound', // no ai config is defined under the given aiName
+        'NotImplemented', // the model is not offered on this platform
+    ],
     getPayload: (model, prompt, options) => ({
         model,
         prompt,

package/lib/commonjs/actions/ai/askAiPromptStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"askAiPromptStream.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPromptStream.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AAEpD,iDAA8C;AA6BjC,QAAA,iBAAiB,GAAG,IAAA,6BAAqB,GAAsC,CAAC;IAC3F,UAAU,EAAE,2BAAY,CAAC,YAAY;IACrC,UAAU,EAAE,CAAC,KAAc,EAAE,MAAc,EAAE,OAAkC,EAAE,EAAE,CAAC,CAAC;QACnF,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,WAAW,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW;QACjC,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;QACzB,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,aAAa,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa;QACrC,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,eAAe,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;KAC1C,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { AiActionType } from './AiActionType';\nimport { AiCacheTtl } from './AiCacheTtl';\nimport { AiMessage } from './AiMessage';\nimport { AiModel } from './AiModel';\nimport { AiReasoningConfig } from './AiReasoningConfig';\nimport { AiStreamPart } from './types';\n\nexport type AskAiPromptStreamOptions = {\n  system?: string;\n  aiName?: string;\n  messages?: AiMessage[];\n  /** Per-request messages sent after `messages`. They never receive a cache point and the caller\n   *  never persists them; with only `prompt`, the prompt becomes the first user message. */\n  turnContext?: AiMessage[];\n  reasoning?: AiReasoningConfig;\n  caching?: boolean;\n  /** Requested lifetime of the request's cache points. Unset means `AiCacheTtl.Dynamic`. */\n  cacheTtl?: AiCacheTtl;\n  /** Stop the tool loop between steps once this much wall-clock time has passed. The\n   *  turn then finishes with `toolCalls` if the model still wanted to act, so it can be resumed. */\n  maxDurationMs?: number;\n  /** Cap on model/tool steps in one call. Unset means the loop runs until the model stops\n   *  (or `maxDurationMs` trips); client-side tools still halt it immediately. */\n  maxSteps?: number;\n  /** Output token cap per model call. Unset uses the provider default (8192 on Bedrock), which a\n   *  large tool input plus reasoning can exceed; the step then finishes with `length`. */\n  maxOutputTokens?: number;\n};\n\nexport const askAiPromptStream = createActionRequester<StreamHandle<'json', AiStreamPart>>()({\n  actionType: AiActionType.PromptStream,\n  getPayload: (model: AiModel, prompt: string, options?: AskAiPromptStreamOptions) => ({\n    model,\n    prompt,\n    messages: options?.messages,\n    turnContext: options?.turnContext,\n    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n    cacheTtl: options?.cacheTtl,\n    maxDurationMs: options?.maxDurationMs,\n    maxSteps: options?.maxSteps,\n    maxOutputTokens: options?.maxOutputTokens,\n  }),\n});\n"]}
+{"version":3,"file":"askAiPromptStream.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPromptStream.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAE5D,iDAA8C;AA6BjC,QAAA,iBAAiB,GAAG,IAAA,+BAAqB,GAAsC,CAAC;IAC3F,UAAU,EAAE,2BAAY,CAAC,YAAY;IACrC,UAAU,EAAE;QACV,UAAU,EAAE,iDAAiD;QAC7D,gBAAgB,EAAE,4CAA4C;KAC/D;IACD,UAAU,EAAE,CAAC,KAAc,EAAE,MAAc,EAAE,OAAkC,EAAE,EAAE,CAAC,CAAC;QACnF,KAAK;QACL,MAAM;QACN,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,WAAW,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW;QACjC,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,MAAM,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM;QACvB,SAAS,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS;QAC7B,OAAO,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;QACzB,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,aAAa,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa;QACrC,QAAQ,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ;QAC3B,eAAe,EAAE,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,eAAe;KAC1C,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { AiActionType } from './AiActionType';\nimport { AiCacheTtl } from './AiCacheTtl';\nimport { AiMessage } from './AiMessage';\nimport { AiModel } from './AiModel';\nimport { AiReasoningConfig } from './AiReasoningConfig';\nimport { AiStreamPart } from './types';\n\nexport type AskAiPromptStreamOptions = {\n  system?: string;\n  aiName?: string;\n  messages?: AiMessage[];\n  /** Per-request messages sent after `messages`. They never receive a cache point and the caller\n   *  never persists them; with only `prompt`, the prompt becomes the first user message. */\n  turnContext?: AiMessage[];\n  reasoning?: AiReasoningConfig;\n  caching?: boolean;\n  /** Requested lifetime of the request's cache points. Unset means `AiCacheTtl.Dynamic`. */\n  cacheTtl?: AiCacheTtl;\n  /** Stop the tool loop between steps once this much wall-clock time has passed. The\n   *  turn then finishes with `toolCalls` if the model still wanted to act, so it can be resumed. */\n  maxDurationMs?: number;\n  /** Cap on model/tool steps in one call. Unset means the loop runs until the model stops\n   *  (or `maxDurationMs` trips); client-side tools still halt it immediately. */\n  maxSteps?: number;\n  /** Output token cap per model call. Unset uses the provider default (8192 on Bedrock), which a\n   *  large tool input plus reasoning can exceed; the step then finishes with `length`. */\n  maxOutputTokens?: number;\n};\n\nexport const askAiPromptStream = createActionRequester<StreamHandle<'json', AiStreamPart>>()({\n  actionType: AiActionType.PromptStream,\n  errorTypes: [\n    'NotFound', // no ai config is defined under the given aiName\n    'NotImplemented', // the model is not offered on this platform\n  ],\n  getPayload: (model: AiModel, prompt: string, options?: AskAiPromptStreamOptions) => ({\n    model,\n    prompt,\n    messages: options?.messages,\n    turnContext: options?.turnContext,\n    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n    cacheTtl: options?.cacheTtl,\n    maxDurationMs: options?.maxDurationMs,\n    maxSteps: options?.maxSteps,\n    maxOutputTokens: options?.maxOutputTokens,\n  }),\n});\n"]}

package/lib/commonjs/actions/ai/types/AiStreamAbort.d.ts

@@ -1,11 +1,11 @@
 import { AiStreamPartType } from './AiStreamPartType';
 /**
- * The stream was aborted before completion — e.g. an abort signal fired or the client disconnected.
+ * The stream was aborted before completion, e.g. an abort signal fired or the client disconnected.
  *
  * No `Finish` part will follow an `Abort`.
  */
-export interface AiStreamAbort {
+export type AiStreamAbort = {
     type: AiStreamPartType.Abort;
     /** Optional human-readable reason for the abort. */
     reason?: string;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamAbort.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamAbort.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamAbort.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * The stream was aborted before completion — e.g. an abort signal fired or the client disconnected.\n *\n * No `Finish` part will follow an `Abort`.\n */\nexport interface AiStreamAbort {\n  type: AiStreamPartType.Abort;\n  /** Optional human-readable reason for the abort. */\n  reason?: string;\n}\n"]}
+{"version":3,"file":"AiStreamAbort.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamAbort.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * The stream was aborted before completion, e.g. an abort signal fired or the client disconnected.\n *\n * No `Finish` part will follow an `Abort`.\n */\nexport type AiStreamAbort = {\n  type: AiStreamPartType.Abort;\n  /** Optional human-readable reason for the abort. */\n  reason?: string;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamCustom.d.ts

@@ -2,10 +2,10 @@ import { AiStreamPartType } from './AiStreamPartType';
 /**
  * A provider-specific custom event that didn't map to any higher-level part.
  *
- * The payload is not forwarded — `kind` identifies the event for debugging or custom handling.
+ * The payload is not forwarded, `kind` identifies the event for debugging or custom handling.
  */
-export interface AiStreamCustom {
+export type AiStreamCustom = {
     type: AiStreamPartType.Custom;
     /** Provider-defined identifier for the custom event (e.g. `provider.eventName`). */
     kind: string;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamCustom.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamCustom.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamCustom.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * A provider-specific custom event that didn't map to any higher-level part.\n *\n * The payload is not forwarded — `kind` identifies the event for debugging or custom handling.\n */\nexport interface AiStreamCustom {\n  type: AiStreamPartType.Custom;\n  /** Provider-defined identifier for the custom event (e.g. `provider.eventName`). */\n  kind: string;\n}\n"]}
+{"version":3,"file":"AiStreamCustom.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamCustom.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * A provider-specific custom event that didn't map to any higher-level part.\n *\n * The payload is not forwarded, `kind` identifies the event for debugging or custom handling.\n */\nexport type AiStreamCustom = {\n  type: AiStreamPartType.Custom;\n  /** Provider-defined identifier for the custom event (e.g. `provider.eventName`). */\n  kind: string;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamError.d.ts

@@ -3,8 +3,8 @@ import { AiStreamPartType } from './AiStreamPartType';
  * A non-fatal error during streaming. The underlying SDK swallows errors by default
  * to keep the connection alive; this part surfaces them to the consumer.
  */
-export interface AiStreamError {
+export type AiStreamError = {
     type: AiStreamPartType.Error;
     /** Stringified error message. */
     message: string;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamError.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamError.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * A non-fatal error during streaming. The underlying SDK swallows errors by default\n * to keep the connection alive; this part surfaces them to the consumer.\n */\nexport interface AiStreamError {\n  type: AiStreamPartType.Error;\n  /** Stringified error message. */\n  message: string;\n}\n"]}
+{"version":3,"file":"AiStreamError.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamError.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * A non-fatal error during streaming. The underlying SDK swallows errors by default\n * to keep the connection alive; this part surfaces them to the consumer.\n */\nexport type AiStreamError = {\n  type: AiStreamPartType.Error;\n  /** Stringified error message. */\n  message: string;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamFile.d.ts

@@ -4,9 +4,9 @@
  * The binary payload is delivered as base64 so the part can travel across
  * the JSON-encoded stream. Decode with `mediaType` to interpret the bytes.
  */
-export interface AiStreamFile {
+export type AiStreamFile = {
     /** File contents, base64-encoded. */
     base64: string;
-    /** IANA media type — e.g. `'image/png'`. */
+    /** IANA media type, e.g. `'image/png'`. */
     mediaType: string;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamFile.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFile.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A file artifact produced by the model (e.g. a generated image).\n *\n * The binary payload is delivered as base64 so the part can travel across\n * the JSON-encoded stream. Decode with `mediaType` to interpret the bytes.\n */\nexport interface AiStreamFile {\n  /** File contents, base64-encoded. */\n  base64: string;\n  /** IANA media type — e.g. `'image/png'`. */\n  mediaType: string;\n}\n"]}
+{"version":3,"file":"AiStreamFile.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFile.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * A file artifact produced by the model (e.g. a generated image).\n *\n * The binary payload is delivered as base64 so the part can travel across\n * the JSON-encoded stream. Decode with `mediaType` to interpret the bytes.\n */\nexport type AiStreamFile = {\n  /** File contents, base64-encoded. */\n  base64: string;\n  /** IANA media type, e.g. `'image/png'`. */\n  mediaType: string;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamFilePart.d.ts

@@ -3,7 +3,7 @@ import { AiStreamPartType } from './AiStreamPartType';
 /**
  * The model produced a file artifact (e.g. an image from a multi-modal model).
  */
-export interface AiStreamFilePart {
+export type AiStreamFilePart = {
     type: AiStreamPartType.File;
     file: AiStreamFile;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamFilePart.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamFilePart.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFilePart.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFile } from './AiStreamFile';\nimport { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * The model produced a file artifact (e.g. an image from a multi-modal model).\n */\nexport interface AiStreamFilePart {\n  type: AiStreamPartType.File;\n  file: AiStreamFile;\n}\n"]}
+{"version":3,"file":"AiStreamFilePart.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFilePart.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFile } from './AiStreamFile';\nimport { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * The model produced a file artifact (e.g. an image from a multi-modal model).\n */\nexport type AiStreamFilePart = {\n  type: AiStreamPartType.File;\n  file: AiStreamFile;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamFinish.d.ts

@@ -5,7 +5,7 @@ import { AiStreamUsage } from './AiStreamUsage';
  * Emitted once at the very end of the response with the aggregate finish reason and total usage
  * across every step. Use this (not `FinishStep`) for end-of-response accounting.
  */
-export interface AiStreamFinish {
+export type AiStreamFinish = {
     type: AiStreamPartType.Finish;
     /** Why the model stopped. `toolCalls` here means the loop was halted early and is resumable. */
     finishReason: AiStreamFinishReasonEnum;
@@ -13,4 +13,4 @@ export interface AiStreamFinish {
     rawFinishReason?: string;
     /** Aggregate token usage across all steps. */
     usage: AiStreamUsage;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamFinish.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamFinish.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFinish.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFinishReasonEnum } from './AiStreamFinishReason';\nimport { AiStreamPartType } from './AiStreamPartType';\nimport { AiStreamUsage } from './AiStreamUsage';\n\n/**\n * Emitted once at the very end of the response with the aggregate finish reason and total usage\n * across every step. Use this (not `FinishStep`) for end-of-response accounting.\n */\nexport interface AiStreamFinish {\n  type: AiStreamPartType.Finish;\n  /** Why the model stopped. `toolCalls` here means the loop was halted early and is resumable. */\n  finishReason: AiStreamFinishReasonEnum;\n  /** The provider's own stop reason string, when it reported one; explains an `other` or `unknown` reason. */\n  rawFinishReason?: string;\n  /** Aggregate token usage across all steps. */\n  usage: AiStreamUsage;\n}\n"]}
+{"version":3,"file":"AiStreamFinish.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFinish.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFinishReasonEnum } from './AiStreamFinishReason';\nimport { AiStreamPartType } from './AiStreamPartType';\nimport { AiStreamUsage } from './AiStreamUsage';\n\n/**\n * Emitted once at the very end of the response with the aggregate finish reason and total usage\n * across every step. Use this (not `FinishStep`) for end-of-response accounting.\n */\nexport type AiStreamFinish = {\n  type: AiStreamPartType.Finish;\n  /** Why the model stopped. `toolCalls` here means the loop was halted early and is resumable. */\n  finishReason: AiStreamFinishReasonEnum;\n  /** The provider's own stop reason string, when it reported one; explains an `other` or `unknown` reason. */\n  rawFinishReason?: string;\n  /** Aggregate token usage across all steps. */\n  usage: AiStreamUsage;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamFinishStep.d.ts

@@ -6,12 +6,12 @@ import { AiStreamUsage } from './AiStreamUsage';
  *
  * For total-response accounting use {@link AiStreamFinish}; this carries the per-step slice only.
  */
-export interface AiStreamFinishStep {
+export type AiStreamFinishStep = {
     type: AiStreamPartType.FinishStep;
-    /** Why this step stopped — `toolCalls` between steps, `stop` on the final step. */
+    /** Why this step stopped, `toolCalls` between steps, `stop` on the final step. */
     finishReason: AiStreamFinishReasonEnum;
     /** The provider's own stop reason string, when it reported one; explains an `other` or `unknown` reason. */
     rawFinishReason?: string;
     /** Token usage for this step only. */
     usage: AiStreamUsage;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamFinishStep.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamFinishStep.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFinishStep.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFinishReasonEnum } from './AiStreamFinishReason';\nimport { AiStreamPartType } from './AiStreamPartType';\nimport { AiStreamUsage } from './AiStreamUsage';\n\n/**\n * The current generation step ended.\n *\n * For total-response accounting use {@link AiStreamFinish}; this carries the per-step slice only.\n */\nexport interface AiStreamFinishStep {\n  type: AiStreamPartType.FinishStep;\n  /** Why this step stopped — `toolCalls` between steps, `stop` on the final step. */\n  finishReason: AiStreamFinishReasonEnum;\n  /** The provider's own stop reason string, when it reported one; explains an `other` or `unknown` reason. */\n  rawFinishReason?: string;\n  /** Token usage for this step only. */\n  usage: AiStreamUsage;\n}\n"]}
+{"version":3,"file":"AiStreamFinishStep.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamFinishStep.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFinishReasonEnum } from './AiStreamFinishReason';\nimport { AiStreamPartType } from './AiStreamPartType';\nimport { AiStreamUsage } from './AiStreamUsage';\n\n/**\n * The current generation step ended.\n *\n * For total-response accounting use {@link AiStreamFinish}; this carries the per-step slice only.\n */\nexport type AiStreamFinishStep = {\n  type: AiStreamPartType.FinishStep;\n  /** Why this step stopped, `toolCalls` between steps, `stop` on the final step. */\n  finishReason: AiStreamFinishReasonEnum;\n  /** The provider's own stop reason string, when it reported one; explains an `other` or `unknown` reason. */\n  rawFinishReason?: string;\n  /** Token usage for this step only. */\n  usage: AiStreamUsage;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamPartType.d.ts

@@ -8,9 +8,9 @@
  * start → delta… → end triples sharing the same `id`.
  */
 export declare enum AiStreamPartType {
-    /** Emitted once before any other parts — the overall response is starting. */
+    /** Emitted once before any other parts, the overall response is starting. */
     Start = "start",
-    /** Emitted once at the very end — overall response is complete, with aggregate usage. */
+    /** Emitted once at the very end, overall response is complete, with aggregate usage. */
     Finish = "finish",
     /** A single generation step (one round-trip to the model) has started. */
     StartStep = "start-step",
@@ -20,15 +20,15 @@ export declare enum AiStreamPartType {
     Abort = "abort",
     /** A non-fatal streaming error. `streamText` swallows errors by default; this surfaces them. */
     Error = "error",
-    /** A provider-specific raw chunk — passed through for debugging or custom handling. */
+    /** A provider-specific raw chunk, passed through for debugging or custom handling. */
     Raw = "raw",
-    /** The model cited a source (URL or document) — used for grounded / RAG-style responses. */
+    /** The model cited a source (URL or document), used for grounded / RAG-style responses. */
     Source = "source",
     /** The model produced a file artifact (e.g. generated image). */
     File = "file",
     /** The model produced a reasoning file artifact (e.g. an encrypted reasoning trace). */
     ReasoningFile = "reasoning-file",
-    /** A provider-specific custom event — identified by `kind`, with no higher-level mapping. */
+    /** A provider-specific custom event, identified by `kind`, with no higher-level mapping. */
     Custom = "custom",
     /** Beginning of a contiguous text block. Pair with `TextEnd` via shared `id`. */
     TextStart = "text-start",
@@ -48,7 +48,7 @@ export declare enum AiStreamPartType {
     ToolInputEnd = "tool-input-end",
     /** An incremental chunk of the (JSON) tool-call arguments. */
     ToolInputDelta = "tool-input-delta",
-    /** A fully-assembled tool call — arguments are complete and parsed. */
+    /** A fully-assembled tool call, arguments are complete and parsed. */
     ToolCall = "tool-call",
     /** A tool finished executing successfully. Includes the original `input` and the `output`. */
     ToolResult = "tool-result",
@@ -56,7 +56,7 @@ export declare enum AiStreamPartType {
     ToolError = "tool-error",
     /** The caller denied executing the tool after an approval request. */
     ToolOutputDenied = "tool-output-denied",
-    /** The model is requesting permission to execute a tool — awaiting approve/deny. */
+    /** The model is requesting permission to execute a tool, awaiting approve/deny. */
     ToolApprovalRequest = "tool-approval-request",
     /** The approve/deny decision for a prior {@link ToolApprovalRequest}. */
     ToolApprovalResponse = "tool-approval-response"

package/lib/commonjs/actions/ai/types/AiStreamPartType.js

@@ -12,9 +12,9 @@ exports.AiStreamPartType = void 0;
  */
 var AiStreamPartType;
 (function (AiStreamPartType) {
-    /** Emitted once before any other parts — the overall response is starting. */
+    /** Emitted once before any other parts, the overall response is starting. */
     AiStreamPartType["Start"] = "start";
-    /** Emitted once at the very end — overall response is complete, with aggregate usage. */
+    /** Emitted once at the very end, overall response is complete, with aggregate usage. */
     AiStreamPartType["Finish"] = "finish";
     /** A single generation step (one round-trip to the model) has started. */
     AiStreamPartType["StartStep"] = "start-step";
@@ -24,15 +24,15 @@ var AiStreamPartType;
     AiStreamPartType["Abort"] = "abort";
     /** A non-fatal streaming error. `streamText` swallows errors by default; this surfaces them. */
     AiStreamPartType["Error"] = "error";
-    /** A provider-specific raw chunk — passed through for debugging or custom handling. */
+    /** A provider-specific raw chunk, passed through for debugging or custom handling. */
     AiStreamPartType["Raw"] = "raw";
-    /** The model cited a source (URL or document) — used for grounded / RAG-style responses. */
+    /** The model cited a source (URL or document), used for grounded / RAG-style responses. */
     AiStreamPartType["Source"] = "source";
     /** The model produced a file artifact (e.g. generated image). */
     AiStreamPartType["File"] = "file";
     /** The model produced a reasoning file artifact (e.g. an encrypted reasoning trace). */
     AiStreamPartType["ReasoningFile"] = "reasoning-file";
-    /** A provider-specific custom event — identified by `kind`, with no higher-level mapping. */
+    /** A provider-specific custom event, identified by `kind`, with no higher-level mapping. */
     AiStreamPartType["Custom"] = "custom";
     /** Beginning of a contiguous text block. Pair with `TextEnd` via shared `id`. */
     AiStreamPartType["TextStart"] = "text-start";
@@ -52,7 +52,7 @@ var AiStreamPartType;
     AiStreamPartType["ToolInputEnd"] = "tool-input-end";
     /** An incremental chunk of the (JSON) tool-call arguments. */
     AiStreamPartType["ToolInputDelta"] = "tool-input-delta";
-    /** A fully-assembled tool call — arguments are complete and parsed. */
+    /** A fully-assembled tool call, arguments are complete and parsed. */
     AiStreamPartType["ToolCall"] = "tool-call";
     /** A tool finished executing successfully. Includes the original `input` and the `output`. */
     AiStreamPartType["ToolResult"] = "tool-result";
@@ -60,7 +60,7 @@ var AiStreamPartType;
     AiStreamPartType["ToolError"] = "tool-error";
     /** The caller denied executing the tool after an approval request. */
     AiStreamPartType["ToolOutputDenied"] = "tool-output-denied";
-    /** The model is requesting permission to execute a tool — awaiting approve/deny. */
+    /** The model is requesting permission to execute a tool, awaiting approve/deny. */
     AiStreamPartType["ToolApprovalRequest"] = "tool-approval-request";
     /** The approve/deny decision for a prior {@link ToolApprovalRequest}. */
     AiStreamPartType["ToolApprovalResponse"] = "tool-approval-response";

package/lib/commonjs/actions/ai/types/AiStreamPartType.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamPartType.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamPartType.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,IAAY,gBA8EX;AA9ED,WAAY,gBAAgB;IAC1B,8EAA8E;IAC9E,mCAAe,CAAA;IAEf,yFAAyF;IACzF,qCAAiB,CAAA;IAEjB,0EAA0E;IAC1E,4CAAwB,CAAA;IAExB,kFAAkF;IAClF,8CAA0B,CAAA;IAE1B,qEAAqE;IACrE,mCAAe,CAAA;IAEf,gGAAgG;IAChG,mCAAe,CAAA;IAEf,uFAAuF;IACvF,+BAAW,CAAA;IAEX,4FAA4F;IAC5F,qCAAiB,CAAA;IAEjB,iEAAiE;IACjE,iCAAa,CAAA;IAEb,wFAAwF;IACxF,oDAAgC,CAAA;IAEhC,6FAA6F;IAC7F,qCAAiB,CAAA;IAEjB,iFAAiF;IACjF,4CAAwB,CAAA;IAExB,8DAA8D;IAC9D,wCAAoB,CAAA;IAEpB,yEAAyE;IACzE,4CAAwB,CAAA;IAExB,oFAAoF;IACpF,sDAAkC,CAAA;IAElC,wEAAwE;IACxE,kDAA8B,CAAA;IAE9B,wFAAwF;IACxF,sDAAkC,CAAA;IAElC,+DAA+D;IAC/D,uDAAmC,CAAA;IAEnC,oEAAoE;IACpE,mDAA+B,CAAA;IAE/B,8DAA8D;IAC9D,uDAAmC,CAAA;IAEnC,uEAAuE;IACvE,0CAAsB,CAAA;IAEtB,8FAA8F;IAC9F,8CAA0B,CAAA;IAE1B,6EAA6E;IAC7E,4CAAwB,CAAA;IAExB,sEAAsE;IACtE,2DAAuC,CAAA;IAEvC,oFAAoF;IACpF,iEAA6C,CAAA;IAE7C,yEAAyE;IACzE,mEAA+C,CAAA;AACjD,CAAC,EA9EW,gBAAgB,gCAAhB,gBAAgB,QA8E3B","sourcesContent":["/**\n * Discriminator for every part that can appear in an AI prompt stream.\n *\n * Lifecycle order, broadly:\n *   Start → (StartStep → step events → FinishStep)+ → Finish\n *\n * Within a step, text / reasoning / tool-input events come in matched\n * start → delta… → end triples sharing the same `id`.\n */\nexport enum AiStreamPartType {\n  /** Emitted once before any other parts — the overall response is starting. */\n  Start = 'start',\n\n  /** Emitted once at the very end — overall response is complete, with aggregate usage. */\n  Finish = 'finish',\n\n  /** A single generation step (one round-trip to the model) has started. */\n  StartStep = 'start-step',\n\n  /** The current generation step ended, with the step's finish reason and usage. */\n  FinishStep = 'finish-step',\n\n  /** The stream was aborted (e.g. abort signal, client disconnect). */\n  Abort = 'abort',\n\n  /** A non-fatal streaming error. `streamText` swallows errors by default; this surfaces them. */\n  Error = 'error',\n\n  /** A provider-specific raw chunk — passed through for debugging or custom handling. */\n  Raw = 'raw',\n\n  /** The model cited a source (URL or document) — used for grounded / RAG-style responses. */\n  Source = 'source',\n\n  /** The model produced a file artifact (e.g. generated image). */\n  File = 'file',\n\n  /** The model produced a reasoning file artifact (e.g. an encrypted reasoning trace). */\n  ReasoningFile = 'reasoning-file',\n\n  /** A provider-specific custom event — identified by `kind`, with no higher-level mapping. */\n  Custom = 'custom',\n\n  /** Beginning of a contiguous text block. Pair with `TextEnd` via shared `id`. */\n  TextStart = 'text-start',\n\n  /** End of the text block opened by a matching `TextStart`. */\n  TextEnd = 'text-end',\n\n  /** An incremental chunk of text inside the currently open text block. */\n  TextDelta = 'text-delta',\n\n  /** Beginning of a model reasoning / \"thinking\" block (extended-thinking models). */\n  ReasoningStart = 'reasoning-start',\n\n  /** End of the reasoning block opened by a matching `ReasoningStart`. */\n  ReasoningEnd = 'reasoning-end',\n\n  /** An incremental chunk of reasoning text inside the currently open reasoning block. */\n  ReasoningDelta = 'reasoning-delta',\n\n  /** The model has begun streaming arguments for a tool call. */\n  ToolInputStart = 'tool-input-start',\n\n  /** The model has finished streaming arguments for the tool call. */\n  ToolInputEnd = 'tool-input-end',\n\n  /** An incremental chunk of the (JSON) tool-call arguments. */\n  ToolInputDelta = 'tool-input-delta',\n\n  /** A fully-assembled tool call — arguments are complete and parsed. */\n  ToolCall = 'tool-call',\n\n  /** A tool finished executing successfully. Includes the original `input` and the `output`. */\n  ToolResult = 'tool-result',\n\n  /** A tool threw while executing. `message` carries the stringified error. */\n  ToolError = 'tool-error',\n\n  /** The caller denied executing the tool after an approval request. */\n  ToolOutputDenied = 'tool-output-denied',\n\n  /** The model is requesting permission to execute a tool — awaiting approve/deny. */\n  ToolApprovalRequest = 'tool-approval-request',\n\n  /** The approve/deny decision for a prior {@link ToolApprovalRequest}. */\n  ToolApprovalResponse = 'tool-approval-response',\n}\n"]}
+{"version":3,"file":"AiStreamPartType.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamPartType.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,IAAY,gBA8EX;AA9ED,WAAY,gBAAgB;IAC1B,6EAA6E;IAC7E,mCAAe,CAAA;IAEf,wFAAwF;IACxF,qCAAiB,CAAA;IAEjB,0EAA0E;IAC1E,4CAAwB,CAAA;IAExB,kFAAkF;IAClF,8CAA0B,CAAA;IAE1B,qEAAqE;IACrE,mCAAe,CAAA;IAEf,gGAAgG;IAChG,mCAAe,CAAA;IAEf,sFAAsF;IACtF,+BAAW,CAAA;IAEX,2FAA2F;IAC3F,qCAAiB,CAAA;IAEjB,iEAAiE;IACjE,iCAAa,CAAA;IAEb,wFAAwF;IACxF,oDAAgC,CAAA;IAEhC,4FAA4F;IAC5F,qCAAiB,CAAA;IAEjB,iFAAiF;IACjF,4CAAwB,CAAA;IAExB,8DAA8D;IAC9D,wCAAoB,CAAA;IAEpB,yEAAyE;IACzE,4CAAwB,CAAA;IAExB,oFAAoF;IACpF,sDAAkC,CAAA;IAElC,wEAAwE;IACxE,kDAA8B,CAAA;IAE9B,wFAAwF;IACxF,sDAAkC,CAAA;IAElC,+DAA+D;IAC/D,uDAAmC,CAAA;IAEnC,oEAAoE;IACpE,mDAA+B,CAAA;IAE/B,8DAA8D;IAC9D,uDAAmC,CAAA;IAEnC,sEAAsE;IACtE,0CAAsB,CAAA;IAEtB,8FAA8F;IAC9F,8CAA0B,CAAA;IAE1B,6EAA6E;IAC7E,4CAAwB,CAAA;IAExB,sEAAsE;IACtE,2DAAuC,CAAA;IAEvC,mFAAmF;IACnF,iEAA6C,CAAA;IAE7C,yEAAyE;IACzE,mEAA+C,CAAA;AACjD,CAAC,EA9EW,gBAAgB,gCAAhB,gBAAgB,QA8E3B","sourcesContent":["/**\n * Discriminator for every part that can appear in an AI prompt stream.\n *\n * Lifecycle order, broadly:\n *   Start → (StartStep → step events → FinishStep)+ → Finish\n *\n * Within a step, text / reasoning / tool-input events come in matched\n * start → delta… → end triples sharing the same `id`.\n */\nexport enum AiStreamPartType {\n  /** Emitted once before any other parts, the overall response is starting. */\n  Start = 'start',\n\n  /** Emitted once at the very end, overall response is complete, with aggregate usage. */\n  Finish = 'finish',\n\n  /** A single generation step (one round-trip to the model) has started. */\n  StartStep = 'start-step',\n\n  /** The current generation step ended, with the step's finish reason and usage. */\n  FinishStep = 'finish-step',\n\n  /** The stream was aborted (e.g. abort signal, client disconnect). */\n  Abort = 'abort',\n\n  /** A non-fatal streaming error. `streamText` swallows errors by default; this surfaces them. */\n  Error = 'error',\n\n  /** A provider-specific raw chunk, passed through for debugging or custom handling. */\n  Raw = 'raw',\n\n  /** The model cited a source (URL or document), used for grounded / RAG-style responses. */\n  Source = 'source',\n\n  /** The model produced a file artifact (e.g. generated image). */\n  File = 'file',\n\n  /** The model produced a reasoning file artifact (e.g. an encrypted reasoning trace). */\n  ReasoningFile = 'reasoning-file',\n\n  /** A provider-specific custom event, identified by `kind`, with no higher-level mapping. */\n  Custom = 'custom',\n\n  /** Beginning of a contiguous text block. Pair with `TextEnd` via shared `id`. */\n  TextStart = 'text-start',\n\n  /** End of the text block opened by a matching `TextStart`. */\n  TextEnd = 'text-end',\n\n  /** An incremental chunk of text inside the currently open text block. */\n  TextDelta = 'text-delta',\n\n  /** Beginning of a model reasoning / \"thinking\" block (extended-thinking models). */\n  ReasoningStart = 'reasoning-start',\n\n  /** End of the reasoning block opened by a matching `ReasoningStart`. */\n  ReasoningEnd = 'reasoning-end',\n\n  /** An incremental chunk of reasoning text inside the currently open reasoning block. */\n  ReasoningDelta = 'reasoning-delta',\n\n  /** The model has begun streaming arguments for a tool call. */\n  ToolInputStart = 'tool-input-start',\n\n  /** The model has finished streaming arguments for the tool call. */\n  ToolInputEnd = 'tool-input-end',\n\n  /** An incremental chunk of the (JSON) tool-call arguments. */\n  ToolInputDelta = 'tool-input-delta',\n\n  /** A fully-assembled tool call, arguments are complete and parsed. */\n  ToolCall = 'tool-call',\n\n  /** A tool finished executing successfully. Includes the original `input` and the `output`. */\n  ToolResult = 'tool-result',\n\n  /** A tool threw while executing. `message` carries the stringified error. */\n  ToolError = 'tool-error',\n\n  /** The caller denied executing the tool after an approval request. */\n  ToolOutputDenied = 'tool-output-denied',\n\n  /** The model is requesting permission to execute a tool, awaiting approve/deny. */\n  ToolApprovalRequest = 'tool-approval-request',\n\n  /** The approve/deny decision for a prior {@link ToolApprovalRequest}. */\n  ToolApprovalResponse = 'tool-approval-response',\n}\n"]}

package/lib/commonjs/actions/ai/types/AiStreamRaw.d.ts

@@ -2,8 +2,8 @@ import { AiStreamPartType } from './AiStreamPartType';
 /**
  * A provider-specific raw chunk that didn't map to any higher-level part.
  *
- * The raw payload is not forwarded — this part exists as a marker for debugging or telemetry.
+ * The raw payload is not forwarded, this part exists as a marker for debugging or telemetry.
  */
-export interface AiStreamRaw {
+export type AiStreamRaw = {
     type: AiStreamPartType.Raw;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamRaw.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamRaw.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamRaw.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * A provider-specific raw chunk that didn't map to any higher-level part.\n *\n * The raw payload is not forwarded — this part exists as a marker for debugging or telemetry.\n */\nexport interface AiStreamRaw {\n  type: AiStreamPartType.Raw;\n}\n"]}
+{"version":3,"file":"AiStreamRaw.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamRaw.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * A provider-specific raw chunk that didn't map to any higher-level part.\n *\n * The raw payload is not forwarded, this part exists as a marker for debugging or telemetry.\n */\nexport type AiStreamRaw = {\n  type: AiStreamPartType.Raw;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamReasoningDelta.d.ts

@@ -4,10 +4,10 @@ import { AiStreamPartType } from './AiStreamPartType';
  *
  * Concatenate all deltas sharing the same `id` to reconstruct the block's full reasoning.
  */
-export interface AiStreamReasoningDelta {
+export type AiStreamReasoningDelta = {
     type: AiStreamPartType.ReasoningDelta;
     /** Identifier of the reasoning block this delta belongs to. */
     id: string;
     /** The new reasoning fragment to append. */
     text: string;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamReasoningDelta.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamReasoningDelta.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamReasoningDelta.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * An incremental chunk of reasoning text inside an open reasoning block.\n *\n * Concatenate all deltas sharing the same `id` to reconstruct the block's full reasoning.\n */\nexport interface AiStreamReasoningDelta {\n  type: AiStreamPartType.ReasoningDelta;\n  /** Identifier of the reasoning block this delta belongs to. */\n  id: string;\n  /** The new reasoning fragment to append. */\n  text: string;\n}\n"]}
+{"version":3,"file":"AiStreamReasoningDelta.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamReasoningDelta.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * An incremental chunk of reasoning text inside an open reasoning block.\n *\n * Concatenate all deltas sharing the same `id` to reconstruct the block's full reasoning.\n */\nexport type AiStreamReasoningDelta = {\n  type: AiStreamPartType.ReasoningDelta;\n  /** Identifier of the reasoning block this delta belongs to. */\n  id: string;\n  /** The new reasoning fragment to append. */\n  text: string;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamReasoningEnd.d.ts

@@ -2,8 +2,8 @@ import { AiStreamPartType } from './AiStreamPartType';
 /**
  * End of the reasoning block opened by a matching {@link AiStreamReasoningStart} (same `id`).
  */
-export interface AiStreamReasoningEnd {
+export type AiStreamReasoningEnd = {
     type: AiStreamPartType.ReasoningEnd;
     /** Identifier of the reasoning block being closed. */
     id: string;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamReasoningEnd.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamReasoningEnd.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamReasoningEnd.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * End of the reasoning block opened by a matching {@link AiStreamReasoningStart} (same `id`).\n */\nexport interface AiStreamReasoningEnd {\n  type: AiStreamPartType.ReasoningEnd;\n  /** Identifier of the reasoning block being closed. */\n  id: string;\n}\n"]}
+{"version":3,"file":"AiStreamReasoningEnd.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamReasoningEnd.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * End of the reasoning block opened by a matching {@link AiStreamReasoningStart} (same `id`).\n */\nexport type AiStreamReasoningEnd = {\n  type: AiStreamPartType.ReasoningEnd;\n  /** Identifier of the reasoning block being closed. */\n  id: string;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamReasoningFilePart.d.ts

@@ -3,7 +3,7 @@ import { AiStreamPartType } from './AiStreamPartType';
 /**
  * The model produced a reasoning file artifact (e.g. an encrypted reasoning trace).
  */
-export interface AiStreamReasoningFilePart {
+export type AiStreamReasoningFilePart = {
     type: AiStreamPartType.ReasoningFile;
     file: AiStreamFile;
-}
+};

package/lib/commonjs/actions/ai/types/AiStreamReasoningFilePart.js.map

@@ -1 +1 @@
-{"version":3,"file":"AiStreamReasoningFilePart.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamReasoningFilePart.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFile } from './AiStreamFile';\nimport { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * The model produced a reasoning file artifact (e.g. an encrypted reasoning trace).\n */\nexport interface AiStreamReasoningFilePart {\n  type: AiStreamPartType.ReasoningFile;\n  file: AiStreamFile;\n}\n"]}
+{"version":3,"file":"AiStreamReasoningFilePart.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamReasoningFilePart.ts"],"names":[],"mappings":"","sourcesContent":["import { AiStreamFile } from './AiStreamFile';\nimport { AiStreamPartType } from './AiStreamPartType';\n\n/**\n * The model produced a reasoning file artifact (e.g. an encrypted reasoning trace).\n */\nexport type AiStreamReasoningFilePart = {\n  type: AiStreamPartType.ReasoningFile;\n  file: AiStreamFile;\n};\n"]}

package/lib/commonjs/actions/ai/types/AiStreamReasoningStart.d.ts

@@ -1,11 +1,11 @@
 import { AiStreamPartType } from './AiStreamPartType';
 /**
- * Beginning of a reasoning ("thinking") block — emitted by extended-thinking models.
+ * Beginning of a reasoning ("thinking") block, emitted by extended-thinking models.
  *
  * Reasoning text is the model's internal scratchpad; render it separately from visible text.
  */
-export interface AiStreamReasoningStart {
+export type AiStreamReasoningStart = {
     type: AiStreamPartType.ReasoningStart;
     /** Identifier shared by the matching `ReasoningDelta` / `ReasoningEnd` parts. */
     id: string;
-}
+};