quidproquo-core 0.1.28 → 0.1.30

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

@@ -1,4 +1,5 @@
 export declare enum AiActionType {
     Prompt = "@quidproquo-core/Ai/Prompt",
-    PromptStream = "@quidproquo-core/Ai/PromptStream"
+    PromptStream = "@quidproquo-core/Ai/PromptStream",
+    GetModelRegions = "@quidproquo-core/Ai/GetModelRegions"
 }

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

@@ -5,5 +5,6 @@ var AiActionType;
 (function (AiActionType) {
     AiActionType["Prompt"] = "@quidproquo-core/Ai/Prompt";
     AiActionType["PromptStream"] = "@quidproquo-core/Ai/PromptStream";
+    AiActionType["GetModelRegions"] = "@quidproquo-core/Ai/GetModelRegions";
 })(AiActionType || (exports.AiActionType = AiActionType = {}));
 //# sourceMappingURL=AiActionType.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"AiActionType.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,qDAAqC,CAAA;IACrC,iEAAiD,CAAA;AACnD,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB","sourcesContent":["export enum AiActionType {\n  Prompt = '@quidproquo-core/Ai/Prompt',\n  PromptStream = '@quidproquo-core/Ai/PromptStream',\n}\n"]}
+{"version":3,"file":"AiActionType.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,qDAAqC,CAAA;IACrC,iEAAiD,CAAA;IACjD,uEAAuD,CAAA;AACzD,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB","sourcesContent":["export enum AiActionType {\n  Prompt = '@quidproquo-core/Ai/Prompt',\n  PromptStream = '@quidproquo-core/Ai/PromptStream',\n  GetModelRegions = '@quidproquo-core/Ai/GetModelRegions',\n}\n"]}

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

@@ -0,0 +1,12 @@
+/**
+ * How long a prompt cache entry should live once written. A request, not a guarantee: each
+ * provider maps it onto the lifetimes its models accept. `Dynamic` lets the provider pick the
+ * best lifetime for each cache point; `ProviderDefault` leaves every point on the provider's own
+ * default; the hour costs a dearer write and is only accepted by models that support it.
+ */
+export declare enum AiCacheTtl {
+    Dynamic = "dynamic",
+    ProviderDefault = "default",
+    FiveMinutes = "5m",
+    OneHour = "1h"
+}

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiCacheTtl = void 0;
+/**
+ * How long a prompt cache entry should live once written. A request, not a guarantee: each
+ * provider maps it onto the lifetimes its models accept. `Dynamic` lets the provider pick the
+ * best lifetime for each cache point; `ProviderDefault` leaves every point on the provider's own
+ * default; the hour costs a dearer write and is only accepted by models that support it.
+ */
+var AiCacheTtl;
+(function (AiCacheTtl) {
+    AiCacheTtl["Dynamic"] = "dynamic";
+    AiCacheTtl["ProviderDefault"] = "default";
+    AiCacheTtl["FiveMinutes"] = "5m";
+    AiCacheTtl["OneHour"] = "1h";
+})(AiCacheTtl || (exports.AiCacheTtl = AiCacheTtl = {}));
+//# sourceMappingURL=AiCacheTtl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AiCacheTtl.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiCacheTtl.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,yCAA2B,CAAA;IAC3B,gCAAkB,CAAA;IAClB,4BAAc,CAAA;AAChB,CAAC,EALW,UAAU,0BAAV,UAAU,QAKrB","sourcesContent":["/**\n * How long a prompt cache entry should live once written. A request, not a guarantee: each\n * provider maps it onto the lifetimes its models accept. `Dynamic` lets the provider pick the\n * best lifetime for each cache point; `ProviderDefault` leaves every point on the provider's own\n * default; the hour costs a dearer write and is only accepted by models that support it.\n */\nexport enum AiCacheTtl {\n  Dynamic = 'dynamic',\n  ProviderDefault = 'default',\n  FiveMinutes = '5m',\n  OneHour = '1h',\n}\n"]}

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

@@ -0,0 +1,5 @@
+/** Where a model's requests are processed, so a model picker can show where the data goes. */
+export declare enum AiDataRegion {
+    Australia = "australia",
+    Global = "global"
+}

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiDataRegion = void 0;
+/** Where a model's requests are processed, so a model picker can show where the data goes. */
+var AiDataRegion;
+(function (AiDataRegion) {
+    AiDataRegion["Australia"] = "australia";
+    AiDataRegion["Global"] = "global";
+})(AiDataRegion || (exports.AiDataRegion = AiDataRegion = {}));
+//# sourceMappingURL=AiDataRegion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AiDataRegion.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiDataRegion.ts"],"names":[],"mappings":";;;AAAA,8FAA8F;AAC9F,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;AACnB,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB","sourcesContent":["/** Where a model's requests are processed, so a model picker can show where the data goes. */\nexport enum AiDataRegion {\n  Australia = 'australia',\n  Global = 'global',\n}\n"]}

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

@@ -7,5 +7,13 @@ export declare enum AiModel {
     ClaudeSonnet45 = "claude-sonnet-4-5",
     ClaudeOpus45 = "claude-opus-4-5",
     ClaudeSonnet46 = "claude-sonnet-4-6",
-    ClaudeOpus46 = "claude-opus-4-6"
+    ClaudeOpus46 = "claude-opus-4-6",
+    ClaudeOpus47 = "claude-opus-4-7",
+    ClaudeOpus48 = "claude-opus-4-8",
+    ClaudeSonnet5 = "claude-sonnet-5",
+    ClaudeOpus5 = "claude-opus-5",
+    ClaudeOpus55 = "claude-opus-5-5",
+    ClaudeSonnet55 = "claude-sonnet-5-5",
+    ClaudeFable5 = "claude-fable-5",
+    ClaudeFable51 = "claude-fable-5-1"
 }

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

@@ -12,5 +12,13 @@ var AiModel;
     AiModel["ClaudeOpus45"] = "claude-opus-4-5";
     AiModel["ClaudeSonnet46"] = "claude-sonnet-4-6";
     AiModel["ClaudeOpus46"] = "claude-opus-4-6";
+    AiModel["ClaudeOpus47"] = "claude-opus-4-7";
+    AiModel["ClaudeOpus48"] = "claude-opus-4-8";
+    AiModel["ClaudeSonnet5"] = "claude-sonnet-5";
+    AiModel["ClaudeOpus5"] = "claude-opus-5";
+    AiModel["ClaudeOpus55"] = "claude-opus-5-5";
+    AiModel["ClaudeSonnet55"] = "claude-sonnet-5-5";
+    AiModel["ClaudeFable5"] = "claude-fable-5";
+    AiModel["ClaudeFable51"] = "claude-fable-5-1";
 })(AiModel || (exports.AiModel = AiModel = {}));
 //# sourceMappingURL=AiModel.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"AiModel.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiModel.ts"],"names":[],"mappings":";;;AAAA,IAAY,OAUX;AAVD,WAAY,OAAO;IACjB,6CAAkC,CAAA;IAClC,+CAAoC,CAAA;IACpC,4CAAiC,CAAA;IACjC,wCAA6B,CAAA;IAC7B,6CAAkC,CAAA;IAClC,+CAAoC,CAAA;IACpC,2CAAgC,CAAA;IAChC,+CAAoC,CAAA;IACpC,2CAAgC,CAAA;AAClC,CAAC,EAVW,OAAO,uBAAP,OAAO,QAUlB","sourcesContent":["export enum AiModel {\n  ClaudeHaiku35 = 'claude-3-5-haiku',\n  ClaudeSonnet35 = 'claude-3-5-sonnet',\n  ClaudeSonnet4 = 'claude-sonnet-4',\n  ClaudeOpus4 = 'claude-opus-4',\n  ClaudeHaiku45 = 'claude-haiku-4-5',\n  ClaudeSonnet45 = 'claude-sonnet-4-5',\n  ClaudeOpus45 = 'claude-opus-4-5',\n  ClaudeSonnet46 = 'claude-sonnet-4-6',\n  ClaudeOpus46 = 'claude-opus-4-6',\n}\n"]}
+{"version":3,"file":"AiModel.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiModel.ts"],"names":[],"mappings":";;;AAAA,IAAY,OAkBX;AAlBD,WAAY,OAAO;IACjB,6CAAkC,CAAA;IAClC,+CAAoC,CAAA;IACpC,4CAAiC,CAAA;IACjC,wCAA6B,CAAA;IAC7B,6CAAkC,CAAA;IAClC,+CAAoC,CAAA;IACpC,2CAAgC,CAAA;IAChC,+CAAoC,CAAA;IACpC,2CAAgC,CAAA;IAChC,2CAAgC,CAAA;IAChC,2CAAgC,CAAA;IAChC,4CAAiC,CAAA;IACjC,wCAA6B,CAAA;IAC7B,2CAAgC,CAAA;IAChC,+CAAoC,CAAA;IACpC,0CAA+B,CAAA;IAC/B,6CAAkC,CAAA;AACpC,CAAC,EAlBW,OAAO,uBAAP,OAAO,QAkBlB","sourcesContent":["export enum AiModel {\n  ClaudeHaiku35 = 'claude-3-5-haiku',\n  ClaudeSonnet35 = 'claude-3-5-sonnet',\n  ClaudeSonnet4 = 'claude-sonnet-4',\n  ClaudeOpus4 = 'claude-opus-4',\n  ClaudeHaiku45 = 'claude-haiku-4-5',\n  ClaudeSonnet45 = 'claude-sonnet-4-5',\n  ClaudeOpus45 = 'claude-opus-4-5',\n  ClaudeSonnet46 = 'claude-sonnet-4-6',\n  ClaudeOpus46 = 'claude-opus-4-6',\n  ClaudeOpus47 = 'claude-opus-4-7',\n  ClaudeOpus48 = 'claude-opus-4-8',\n  ClaudeSonnet5 = 'claude-sonnet-5',\n  ClaudeOpus5 = 'claude-opus-5',\n  ClaudeOpus55 = 'claude-opus-5-5',\n  ClaudeSonnet55 = 'claude-sonnet-5-5',\n  ClaudeFable5 = 'claude-fable-5',\n  ClaudeFable51 = 'claude-fable-5-1',\n}\n"]}

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

@@ -0,0 +1,4 @@
+import { AiDataRegion } from './AiDataRegion';
+import { AiModel } from './AiModel';
+/** The regions each model is offered in on the current platform; a model may be in several. */
+export type AiModelRegionMap = Record<AiModel, AiDataRegion[]>;

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

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AiModelRegionMap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AiModelRegionMap.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiModelRegionMap.ts"],"names":[],"mappings":"","sourcesContent":["import { AiDataRegion } from './AiDataRegion';\nimport { AiModel } from './AiModel';\n\n/** The regions each model is offered in on the current platform; a model may be in several. */\nexport type AiModelRegionMap = Record<AiModel, AiDataRegion[]>;\n"]}

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

@@ -1,8 +1,10 @@
+import { AiReasoningEffort } from './AiReasoningEffort';
 /**
- * Enables extended thinking for a prompt. Presence turns reasoning on; the
- * budget caps how many tokens the model may spend thinking before it answers.
- * Reasoning progress is surfaced as Reasoning* stream parts.
+ * Enables extended thinking for a prompt at the given effort. Presence turns thinking on. On
+ * Claude 4.6 and older the platform turns the effort into a thinking token budget; Opus 4.7 and
+ * newer and Sonnet 5 run adaptive thinking and take the effort directly. Reasoning progress is
+ * surfaced as Reasoning* stream parts.
  */
-export interface AiReasoningConfig {
-    budgetTokens?: number;
-}
+export type AiReasoningConfig = {
+    effort: AiReasoningEffort;
+};

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

@@ -1 +1 @@
-{"version":3,"file":"AiReasoningConfig.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiReasoningConfig.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Enables extended thinking for a prompt. Presence turns reasoning on; the\n * budget caps how many tokens the model may spend thinking before it answers.\n * Reasoning progress is surfaced as Reasoning* stream parts.\n */\nexport interface AiReasoningConfig {\n  budgetTokens?: number;\n}\n"]}
+{"version":3,"file":"AiReasoningConfig.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiReasoningConfig.ts"],"names":[],"mappings":"","sourcesContent":["import { AiReasoningEffort } from './AiReasoningEffort';\n\n/**\n * Enables extended thinking for a prompt at the given effort. Presence turns thinking on. On\n * Claude 4.6 and older the platform turns the effort into a thinking token budget; Opus 4.7 and\n * newer and Sonnet 5 run adaptive thinking and take the effort directly. Reasoning progress is\n * surfaced as Reasoning* stream parts.\n */\nexport type AiReasoningConfig = {\n  effort: AiReasoningEffort;\n};\n"]}

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

@@ -0,0 +1,8 @@
+/** How hard a model that runs adaptive thinking may think before it answers. */
+export declare enum AiReasoningEffort {
+    Low = "low",
+    Medium = "medium",
+    High = "high",
+    XHigh = "xhigh",
+    Max = "max"
+}

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiReasoningEffort = void 0;
+/** How hard a model that runs adaptive thinking may think before it answers. */
+var AiReasoningEffort;
+(function (AiReasoningEffort) {
+    AiReasoningEffort["Low"] = "low";
+    AiReasoningEffort["Medium"] = "medium";
+    AiReasoningEffort["High"] = "high";
+    AiReasoningEffort["XHigh"] = "xhigh";
+    AiReasoningEffort["Max"] = "max";
+})(AiReasoningEffort || (exports.AiReasoningEffort = AiReasoningEffort = {}));
+//# sourceMappingURL=AiReasoningEffort.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AiReasoningEffort.js","sourceRoot":"","sources":["../../../../src/actions/ai/AiReasoningEffort.ts"],"names":[],"mappings":";;;AAAA,gFAAgF;AAChF,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,gCAAW,CAAA;IACX,sCAAiB,CAAA;IACjB,kCAAa,CAAA;IACb,oCAAe,CAAA;IACf,gCAAW,CAAA;AACb,CAAC,EANW,iBAAiB,iCAAjB,iBAAiB,QAM5B","sourcesContent":["/** How hard a model that runs adaptive thinking may think before it answers. */\nexport enum AiReasoningEffort {\n  Low = 'low',\n  Medium = 'medium',\n  High = 'high',\n  XHigh = 'xhigh',\n  Max = 'max',\n}\n"]}

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

@@ -0,0 +1,8 @@
+import { AiActionType } from './AiActionType';
+import { AiModelRegionMap } from './AiModelRegionMap';
+/**
+ * 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.
+ */
+export declare const askAiGetModelRegions: import("../../types").ActionRequesterFunction<AiActionType.GetModelRegions, [], undefined, AiModelRegionMap, never>;

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askAiGetModelRegions = void 0;
+const types_1 = require("../../types");
+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)()({
+    actionType: AiActionType_1.AiActionType.GetModelRegions,
+});
+//# sourceMappingURL=askAiGetModelRegions.js.map

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

@@ -0,0 +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"]}

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

@@ -1,4 +1,6 @@
+import { AiStreamUsage } from './types/AiStreamUsage';
 import { AiActionType } from './AiActionType';
+import { AiCacheTtl } from './AiCacheTtl';
 import { AiMessage } from './AiMessage';
 import { AiModel } from './AiModel';
 import { AiReasoningConfig } from './AiReasoningConfig';
@@ -6,8 +8,13 @@ export type AskAiPromptOptions = {
     system?: string;
     aiName?: string;
     messages?: AiMessage[];
+    /** Per-request messages sent after `messages`. They never receive a cache point and the caller
+     *  never persists them; with only `prompt`, the prompt becomes the first user message. */
+    turnContext?: AiMessage[];
     reasoning?: AiReasoningConfig;
     caching?: boolean;
+    /** Requested lifetime of the request's cache points. Unset means `AiCacheTtl.Dynamic`. */
+    cacheTtl?: AiCacheTtl;
     /** Stop the tool loop between steps once this much wall-clock time has passed. The
      *  turn then finishes with `toolCalls` if the model still wanted to act, so it can be resumed. */
     maxDurationMs?: number;
@@ -18,17 +25,21 @@ export type AskAiPromptOptions = {
      *  large tool input plus reasoning can exceed; the step then finishes with `length`. */
     maxOutputTokens?: number;
 };
-export interface AiPromptActionResult {
+export type AiPromptActionResult = {
     text: string;
-}
+    /** 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], {
     model: AiModel;
     prompt: string;
     messages: AiMessage[] | undefined;
+    turnContext: AiMessage[] | undefined;
     system: string | undefined;
     aiName: string | undefined;
     reasoning: AiReasoningConfig | undefined;
     caching: boolean | undefined;
+    cacheTtl: AiCacheTtl | undefined;
     maxDurationMs: number | undefined;
     maxSteps: number | undefined;
     maxOutputTokens: number | undefined;

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

@@ -9,10 +9,12 @@ exports.askAiPrompt = (0, types_1.createActionRequester)()({
         model,
         prompt,
         messages: options === null || options === void 0 ? void 0 : options.messages,
+        turnContext: options === null || options === void 0 ? void 0 : options.turnContext,
         system: options === null || options === void 0 ? void 0 : options.system,
         aiName: options === null || options === void 0 ? void 0 : options.aiName,
         reasoning: options === null || options === void 0 ? void 0 : options.reasoning,
         caching: options === null || options === void 0 ? void 0 : options.caching,
+        cacheTtl: options === null || options === void 0 ? void 0 : options.cacheTtl,
         maxDurationMs: options === null || options === void 0 ? void 0 : options.maxDurationMs,
         maxSteps: options === null || options === void 0 ? void 0 : options.maxSteps,
         maxOutputTokens: options === null || options === void 0 ? void 0 : options.maxOutputTokens,

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;AACpD,iDAA8C;AA0BjC,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,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,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 { AiActionType } from './AiActionType';\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  reasoning?: AiReasoningConfig;\n  caching?: boolean;\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 interface AiPromptActionResult {\n  text: string;\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    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\n    maxDurationMs: options?.maxDurationMs,\n    maxSteps: options?.maxSteps,\n    maxOutputTokens: options?.maxOutputTokens,\n  }),\n});\n"]}
+{"version":3,"file":"askAiPrompt.js","sourceRoot":"","sources":["../../../../src/actions/ai/askAiPrompt.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AAEpD,iDAA8C;AAkCjC,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;KAC1C,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { AiStreamUsage } from './types/AiStreamUsage';\nimport { AiActionType } from './AiActionType';\nimport { AiCacheTtl } from './AiCacheTtl';\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};\n\nexport type AiPromptActionResult = {\n  text: string;\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  }),\n});\n"]}

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

@@ -1,5 +1,6 @@
 import { StreamHandle } from '../../types/StreamRegistry';
 import { AiActionType } from './AiActionType';
+import { AiCacheTtl } from './AiCacheTtl';
 import { AiMessage } from './AiMessage';
 import { AiModel } from './AiModel';
 import { AiReasoningConfig } from './AiReasoningConfig';
@@ -8,8 +9,13 @@ export type AskAiPromptStreamOptions = {
     system?: string;
     aiName?: string;
     messages?: AiMessage[];
+    /** Per-request messages sent after `messages`. They never receive a cache point and the caller
+     *  never persists them; with only `prompt`, the prompt becomes the first user message. */
+    turnContext?: AiMessage[];
     reasoning?: AiReasoningConfig;
     caching?: boolean;
+    /** Requested lifetime of the request's cache points. Unset means `AiCacheTtl.Dynamic`. */
+    cacheTtl?: AiCacheTtl;
     /** Stop the tool loop between steps once this much wall-clock time has passed. The
      *  turn then finishes with `toolCalls` if the model still wanted to act, so it can be resumed. */
     maxDurationMs?: number;
@@ -24,10 +30,12 @@ export declare const askAiPromptStream: import("../../types").ActionRequesterFun
     model: AiModel;
     prompt: string;
     messages: AiMessage[] | undefined;
+    turnContext: AiMessage[] | undefined;
     system: string | undefined;
     aiName: string | undefined;
     reasoning: AiReasoningConfig | undefined;
     caching: boolean | undefined;
+    cacheTtl: AiCacheTtl | undefined;
     maxDurationMs: number | undefined;
     maxSteps: number | undefined;
     maxOutputTokens: number | undefined;

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

@@ -9,10 +9,12 @@ exports.askAiPromptStream = (0, types_1.createActionRequester)()({
         model,
         prompt,
         messages: options === null || options === void 0 ? void 0 : options.messages,
+        turnContext: options === null || options === void 0 ? void 0 : options.turnContext,
         system: options === null || options === void 0 ? void 0 : options.system,
         aiName: options === null || options === void 0 ? void 0 : options.aiName,
         reasoning: options === null || options === void 0 ? void 0 : options.reasoning,
         caching: options === null || options === void 0 ? void 0 : options.caching,
+        cacheTtl: options === null || options === void 0 ? void 0 : options.cacheTtl,
         maxDurationMs: options === null || options === void 0 ? void 0 : options.maxDurationMs,
         maxSteps: options === null || options === void 0 ? void 0 : options.maxSteps,
         maxOutputTokens: options === null || options === void 0 ? void 0 : options.maxOutputTokens,

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;AAuBjC,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,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,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 { 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  reasoning?: AiReasoningConfig;\n  caching?: boolean;\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    system: options?.system,\n    aiName: options?.aiName,\n    reasoning: options?.reasoning,\n    caching: options?.caching,\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,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"]}

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

@@ -1,7 +1,13 @@
 export * from './AiActionType';
+export * from './AiCacheTtl';
+export * from './AiDataRegion';
 export * from './AiMessage';
 export * from './AiModel';
+export * from './AiModelRegionMap';
 export * from './AiReasoningConfig';
+export * from './AiReasoningEffort';
+export * from './askAiGetModelRegions';
 export * from './askAiPrompt';
 export * from './askAiPromptStream';
+export * from './sumAiStreamUsage';
 export * from './types';

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

@@ -15,10 +15,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AiActionType"), exports);
+__exportStar(require("./AiCacheTtl"), exports);
+__exportStar(require("./AiDataRegion"), exports);
 __exportStar(require("./AiMessage"), exports);
 __exportStar(require("./AiModel"), exports);
+__exportStar(require("./AiModelRegionMap"), exports);
 __exportStar(require("./AiReasoningConfig"), exports);
+__exportStar(require("./AiReasoningEffort"), exports);
+__exportStar(require("./askAiGetModelRegions"), exports);
 __exportStar(require("./askAiPrompt"), exports);
 __exportStar(require("./askAiPromptStream"), exports);
+__exportStar(require("./sumAiStreamUsage"), exports);
 __exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,sDAAoC;AACpC,gDAA8B;AAC9B,sDAAoC;AACpC,0CAAwB","sourcesContent":["export * from './AiActionType';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiReasoningConfig';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/ai/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,iDAA+B;AAC/B,8CAA4B;AAC5B,4CAA0B;AAC1B,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,gDAA8B;AAC9B,sDAAoC;AACpC,qDAAmC;AACnC,0CAAwB","sourcesContent":["export * from './AiActionType';\nexport * from './AiCacheTtl';\nexport * from './AiDataRegion';\nexport * from './AiMessage';\nexport * from './AiModel';\nexport * from './AiModelRegionMap';\nexport * from './AiReasoningConfig';\nexport * from './AiReasoningEffort';\nexport * from './askAiGetModelRegions';\nexport * from './askAiPrompt';\nexport * from './askAiPromptStream';\nexport * from './sumAiStreamUsage';\nexport * from './types';\n"]}

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

@@ -0,0 +1,6 @@
+import { AiStreamUsage } from './types/AiStreamUsage';
+/**
+ * Adds token usages together field by field, for a chat's cost or a turn that spanned several
+ * executions. A field no usage reported stays undefined rather than becoming zero.
+ */
+export declare const sumAiStreamUsage: (usages: readonly AiStreamUsage[]) => AiStreamUsage;

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sumAiStreamUsage = void 0;
+const USAGE_FIELDS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadInputTokens', 'cacheWriteInputTokens', 'noCacheInputTokens'];
+/**
+ * Adds token usages together field by field, for a chat's cost or a turn that spanned several
+ * executions. A field no usage reported stays undefined rather than becoming zero.
+ */
+const sumAiStreamUsage = (usages) => USAGE_FIELDS.reduce((sum, field) => {
+    const reported = usages.map((usage) => usage[field]).filter((value) => value !== undefined);
+    return reported.length > 0 ? Object.assign(Object.assign({}, sum), { [field]: reported.reduce((total, value) => total + value, 0) }) : sum;
+}, {});
+exports.sumAiStreamUsage = sumAiStreamUsage;
+//# sourceMappingURL=sumAiStreamUsage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sumAiStreamUsage.js","sourceRoot":"","sources":["../../../../src/actions/ai/sumAiStreamUsage.ts"],"names":[],"mappings":";;;AAEA,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,CAAU,CAAC;AAEpJ;;;GAGG;AACI,MAAM,gBAAgB,GAAG,CAAC,MAAgC,EAAiB,EAAE,CAClF,YAAY,CAAC,MAAM,CAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAE7G,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iCAAM,GAAG,KAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,IAAG,CAAC,CAAC,GAAG,CAAC;AAC9G,CAAC,EAAE,EAAE,CAAC,CAAC;AALI,QAAA,gBAAgB,oBAKpB","sourcesContent":["import { AiStreamUsage } from './types/AiStreamUsage';\n\nconst USAGE_FIELDS = ['inputTokens', 'outputTokens', 'totalTokens', 'cacheReadInputTokens', 'cacheWriteInputTokens', 'noCacheInputTokens'] as const;\n\n/**\n * Adds token usages together field by field, for a chat's cost or a turn that spanned several\n * executions. A field no usage reported stays undefined rather than becoming zero.\n */\nexport const sumAiStreamUsage = (usages: readonly AiStreamUsage[]): AiStreamUsage =>\n  USAGE_FIELDS.reduce<AiStreamUsage>((sum, field) => {\n    const reported = usages.map((usage) => usage[field]).filter((value): value is number => value !== undefined);\n\n    return reported.length > 0 ? { ...sum, [field]: reported.reduce((total, value) => total + value, 0) } : sum;\n  }, {});\n"]}

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

@@ -9,6 +9,8 @@ export interface AiStreamFinish {
     type: AiStreamPartType.Finish;
     /** Why the model stopped. `toolCalls` here means the loop was halted early and is resumable. */
     finishReason: AiStreamFinishReasonEnum;
+    /** The provider's own stop reason string, when it reported one; explains an `other` or `unknown` reason. */
+    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  /** 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 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"]}

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

@@ -10,6 +10,8 @@ export interface AiStreamFinishStep {
     type: AiStreamPartType.FinishStep;
     /** 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  /** 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 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"]}

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

@@ -9,6 +9,12 @@ export interface AiStreamUsage {
     inputTokens?: number;
     /** Completion tokens produced. */
     outputTokens?: number;
-    /** Total tokens — typically `inputTokens + outputTokens` (+ reasoning, when applicable). */
+    /** Total tokens, typically `inputTokens + outputTokens` (+ reasoning, when applicable). */
     totalTokens?: number;
+    /** Prompt tokens served from the prompt cache. */
+    cacheReadInputTokens?: number;
+    /** Prompt tokens written to the prompt cache by this request. */
+    cacheWriteInputTokens?: number;
+    /** Prompt tokens neither read from nor written to the cache. */
+    noCacheInputTokens?: number;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"AiStreamUsage.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamUsage.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Token usage reported by the model.\n *\n * Each field may be undefined if the underlying provider doesn't report it.\n * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).\n */\nexport interface AiStreamUsage {\n  /** Prompt tokens consumed. */\n  inputTokens?: number;\n  /** Completion tokens produced. */\n  outputTokens?: number;\n  /** Total tokens — typically `inputTokens + outputTokens` (+ reasoning, when applicable). */\n  totalTokens?: number;\n}\n"]}
+{"version":3,"file":"AiStreamUsage.js","sourceRoot":"","sources":["../../../../../src/actions/ai/types/AiStreamUsage.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Token usage reported by the model.\n *\n * Each field may be undefined if the underlying provider doesn't report it.\n * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).\n */\nexport interface AiStreamUsage {\n  /** Prompt tokens consumed. */\n  inputTokens?: number;\n  /** Completion tokens produced. */\n  outputTokens?: number;\n  /** Total tokens, typically `inputTokens + outputTokens` (+ reasoning, when applicable). */\n  totalTokens?: number;\n  /** Prompt tokens served from the prompt cache. */\n  cacheReadInputTokens?: number;\n  /** Prompt tokens written to the prompt cache by this request. */\n  cacheWriteInputTokens?: number;\n  /** Prompt tokens neither read from nor written to the cache. */\n  noCacheInputTokens?: number;\n}\n"]}

package/lib/commonjs/actions/index.d.ts

@@ -18,6 +18,7 @@ export * from './metric';
 export * from './network';
 export * from './platform';
 export * from './queue';
+export * from './secureToken';
 export * from './state';
 export * from './stream';
 export * from './system';

package/lib/commonjs/actions/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./metric"), exports);
 __exportStar(require("./network"), exports);
 __exportStar(require("./platform"), exports);
 __exportStar(require("./queue"), exports);
+__exportStar(require("./secureToken"), exports);
 __exportStar(require("./state"), exports);
 __exportStar(require("./stream"), exports);
 __exportStar(require("./system"), exports);

package/lib/commonjs/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB;AACrB,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,yCAAuB;AACvB,qDAAmC;AACnC,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,kDAAgC;AAChC,yCAAuB;AACvB,mDAAiC;AACjC,kDAAgC;AAChC,wCAAsB;AACtB,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,kDAAgC","sourcesContent":["export * from './ai';\nexport * from './config';\nexport * from './context';\nexport * from './crypto';\nexport * from './date';\nexport * from './dynamicFunctions';\nexport * from './error';\nexport * from './event';\nexport * from './eventBus';\nexport * from './file';\nexport * from './graphDatabase';\nexport * from './guid';\nexport * from './inlineFunction';\nexport * from './keyValueStore';\nexport * from './log';\nexport * from './math';\nexport * from './metric';\nexport * from './network';\nexport * from './platform';\nexport * from './queue';\nexport * from './state';\nexport * from './stream';\nexport * from './system';\nexport * from './userDirectory';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uCAAqB;AACrB,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB;AACzB,yCAAuB;AACvB,qDAAmC;AACnC,0CAAwB;AACxB,0CAAwB;AACxB,6CAA2B;AAC3B,yCAAuB;AACvB,kDAAgC;AAChC,yCAAuB;AACvB,mDAAiC;AACjC,kDAAgC;AAChC,wCAAsB;AACtB,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,6CAA2B;AAC3B,0CAAwB;AACxB,gDAA8B;AAC9B,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,kDAAgC","sourcesContent":["export * from './ai';\nexport * from './config';\nexport * from './context';\nexport * from './crypto';\nexport * from './date';\nexport * from './dynamicFunctions';\nexport * from './error';\nexport * from './event';\nexport * from './eventBus';\nexport * from './file';\nexport * from './graphDatabase';\nexport * from './guid';\nexport * from './inlineFunction';\nexport * from './keyValueStore';\nexport * from './log';\nexport * from './math';\nexport * from './metric';\nexport * from './network';\nexport * from './platform';\nexport * from './queue';\nexport * from './secureToken';\nexport * from './state';\nexport * from './stream';\nexport * from './system';\nexport * from './userDirectory';\n"]}

package/lib/commonjs/actions/log/LogActionType.d.ts

@@ -1,5 +1,6 @@
 export declare enum LogActionType {
     Create = "@quidproquo-core/Log/Create",
     DisableEventHistory = "@quidproquo-core/Log/DisableEventHistory",
-    TemplateLiteral = "@quidproquo-core/Log/TemplateLiteral"
+    TemplateLiteral = "@quidproquo-core/Log/TemplateLiteral",
+    RedactString = "@quidproquo-core/Log/RedactString"
 }

package/lib/commonjs/actions/log/LogActionType.js

@@ -6,5 +6,6 @@ var LogActionType;
     LogActionType["Create"] = "@quidproquo-core/Log/Create";
     LogActionType["DisableEventHistory"] = "@quidproquo-core/Log/DisableEventHistory";
     LogActionType["TemplateLiteral"] = "@quidproquo-core/Log/TemplateLiteral";
+    LogActionType["RedactString"] = "@quidproquo-core/Log/RedactString";
 })(LogActionType || (exports.LogActionType = LogActionType = {}));
 //# sourceMappingURL=LogActionType.js.map

package/lib/commonjs/actions/log/LogActionType.js.map

@@ -1 +1 @@
-{"version":3,"file":"LogActionType.js","sourceRoot":"","sources":["../../../../src/actions/log/LogActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,aAIX;AAJD,WAAY,aAAa;IACvB,uDAAsC,CAAA;IACtC,iFAAgE,CAAA;IAChE,yEAAwD,CAAA;AAC1D,CAAC,EAJW,aAAa,6BAAb,aAAa,QAIxB","sourcesContent":["export enum LogActionType {\n  Create = '@quidproquo-core/Log/Create',\n  DisableEventHistory = '@quidproquo-core/Log/DisableEventHistory',\n  TemplateLiteral = '@quidproquo-core/Log/TemplateLiteral',\n}\n"]}
+{"version":3,"file":"LogActionType.js","sourceRoot":"","sources":["../../../../src/actions/log/LogActionType.ts"],"names":[],"mappings":";;;AAAA,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,uDAAsC,CAAA;IACtC,iFAAgE,CAAA;IAChE,yEAAwD,CAAA;IACxD,mEAAkD,CAAA;AACpD,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB","sourcesContent":["export enum LogActionType {\n  Create = '@quidproquo-core/Log/Create',\n  DisableEventHistory = '@quidproquo-core/Log/DisableEventHistory',\n  TemplateLiteral = '@quidproquo-core/Log/TemplateLiteral',\n  RedactString = '@quidproquo-core/Log/RedactString',\n}\n"]}

package/lib/commonjs/actions/log/askRedactString.d.ts

@@ -0,0 +1,10 @@
+import { LogActionType } from './LogActionType';
+/**
+ * Marks a value as sensitive in this story's log: the admin log redaction removes it from every
+ * string in the log, including entries recorded before this call (and this call's own entry). Does
+ * nothing at runtime. Only this story's log is covered: a value handed to another service (in a
+ * queue message, an email, a service function) must be marked there too.
+ */
+export declare const askRedactString: import("../../types").ActionRequesterFunction<LogActionType.RedactString, [value: string], {
+    value: string;
+}, void, never>;

package/lib/commonjs/actions/log/askRedactString.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askRedactString = void 0;
+const types_1 = require("../../types");
+const LogActionType_1 = require("./LogActionType");
+/**
+ * Marks a value as sensitive in this story's log: the admin log redaction removes it from every
+ * string in the log, including entries recorded before this call (and this call's own entry). Does
+ * nothing at runtime. Only this story's log is covered: a value handed to another service (in a
+ * queue message, an email, a service function) must be marked there too.
+ */
+exports.askRedactString = (0, types_1.createActionRequester)()({
+    actionType: LogActionType_1.LogActionType.RedactString,
+    getPayload: (value) => ({ value }),
+});
+//# sourceMappingURL=askRedactString.js.map

package/lib/commonjs/actions/log/askRedactString.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askRedactString.js","sourceRoot":"","sources":["../../../../src/actions/log/askRedactString.ts"],"names":[],"mappings":";;;AAAA,uCAAoD;AACpD,mDAAgD;AAEhD;;;;;GAKG;AACU,QAAA,eAAe,GAAG,IAAA,6BAAqB,GAAQ,CAAC;IAC3D,UAAU,EAAE,6BAAa,CAAC,YAAY;IACtC,UAAU,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;CAC3C,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { LogActionType } from './LogActionType';\n\n/**\n * Marks a value as sensitive in this story's log: the admin log redaction removes it from every\n * string in the log, including entries recorded before this call (and this call's own entry). Does\n * nothing at runtime. Only this story's log is covered: a value handed to another service (in a\n * queue message, an email, a service function) must be marked there too.\n */\nexport const askRedactString = createActionRequester<void>()({\n  actionType: LogActionType.RedactString,\n  getPayload: (value: string) => ({ value }),\n});\n"]}

package/lib/commonjs/actions/log/index.d.ts

@@ -1,4 +1,5 @@
 export * from './askLogCreate';
 export * from './askLogDisableEventHistory';
 export * from './askLogTemplateLiteral';
+export * from './askRedactString';
 export * from './LogActionType';