@qpqjs/core 0.3.0 → 0.5.0

package/lib/esm/actions/platform/askPlatformDelay.js

@@ -0,0 +1,7 @@
+import { createActionRequester } from '../../logic/actions';
+import { PlatformActionType } from './PlatformActionType';
+export const askPlatformDelay = createActionRequester()({
+    actionType: PlatformActionType.Delay,
+    getPayload: (timeMs) => ({ timeMs }),
+});
+//# sourceMappingURL=askPlatformDelay.js.map

package/lib/esm/actions/platform/askPlatformDelay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askPlatformDelay.js","sourceRoot":"","sources":["../../../../src/actions/platform/askPlatformDelay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,EAAQ,CAAC;IAC5D,UAAU,EAAE,kBAAkB,CAAC,KAAK;IACpC,UAAU,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7C,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { PlatformActionType } from './PlatformActionType';\n\nexport const askPlatformDelay = createActionRequester<void>()({\n  actionType: PlatformActionType.Delay,\n  getPayload: (timeMs: number) => ({ timeMs }),\n});\n"]}

package/lib/esm/actions/platform/askPlatformGetName.d.ts

@@ -5,4 +5,4 @@ import { PlatformActionType } from './PlatformActionType';
  * platform cannot do (a smoke test with no local equivalent, say). Never branch on it
  * for ordinary logic; that is what action processors are for.
  */
-export declare const askPlatformGetName: import("../../types").ActionRequesterFunction<PlatformActionType.GetName, [], {}, string, never>;
+export declare const askPlatformGetName: import("../..").ActionRequesterFunction<PlatformActionType.GetName, [], undefined, string, never>;

package/lib/esm/actions/platform/askPlatformGetName.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types';
+import { createActionRequester } from '../../logic/actions';
 import { PlatformActionType } from './PlatformActionType';
 /**
  * The name of the runtime executing the story, as its action processor set declares it.
@@ -8,6 +8,5 @@ import { PlatformActionType } from './PlatformActionType';
  */
 export const askPlatformGetName = createActionRequester()({
     actionType: PlatformActionType.GetName,
-    getPayload: () => ({}),
 });
 //# sourceMappingURL=askPlatformGetName.js.map

package/lib/esm/actions/platform/askPlatformGetName.js.map

@@ -1 +1 @@
-{"version":3,"file":"askPlatformGetName.js","sourceRoot":"","sources":["../../../../src/actions/platform/askPlatformGetName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,EAAU,CAAC;IAChE,UAAU,EAAE,kBAAkB,CAAC,OAAO;IACtC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;CACvB,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { PlatformActionType } from './PlatformActionType';\n\n/**\n * The name of the runtime executing the story, as its action processor set declares it.\n * An opaque string a story compares against a known constant to skip or degrade work a\n * platform cannot do (a smoke test with no local equivalent, say). Never branch on it\n * for ordinary logic; that is what action processors are for.\n */\nexport const askPlatformGetName = createActionRequester<string>()({\n  actionType: PlatformActionType.GetName,\n  getPayload: () => ({}),\n});\n"]}
+{"version":3,"file":"askPlatformGetName.js","sourceRoot":"","sources":["../../../../src/actions/platform/askPlatformGetName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,EAAU,CAAC;IAChE,UAAU,EAAE,kBAAkB,CAAC,OAAO;CACvC,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { PlatformActionType } from './PlatformActionType';\n\n/**\n * The name of the runtime executing the story, as its action processor set declares it.\n * An opaque string a story compares against a known constant to skip or degrade work a\n * platform cannot do (a smoke test with no local equivalent, say). Never branch on it\n * for ordinary logic; that is what action processors are for.\n */\nexport const askPlatformGetName = createActionRequester<string>()({\n  actionType: PlatformActionType.GetName,\n});\n"]}

package/lib/esm/actions/platform/index.d.ts

@@ -1,3 +1,3 @@
-export * from './askDelay';
+export * from './askPlatformDelay';
 export * from './askPlatformGetName';
 export * from './PlatformActionType';

package/lib/esm/actions/platform/index.js

@@ -1,4 +1,4 @@
-export * from './askDelay';
+export * from './askPlatformDelay';
 export * from './askPlatformGetName';
 export * from './PlatformActionType';
 //# sourceMappingURL=index.js.map

package/lib/esm/actions/platform/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC","sourcesContent":["export * from './askDelay';\nexport * from './askPlatformGetName';\nexport * from './PlatformActionType';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/platform/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC","sourcesContent":["export * from './askPlatformDelay';\nexport * from './askPlatformGetName';\nexport * from './PlatformActionType';\n"]}

package/lib/esm/actions/queue/QueueActionType.d.ts

@@ -1,3 +1,3 @@
 export declare enum QueueActionType {
-    SendMessages = "@quidproquo-core/Queue/SendMessage"
+    SendMessage = "@quidproquo-core/Queue/SendMessage"
 }

package/lib/esm/actions/queue/QueueActionType.js

@@ -1,5 +1,5 @@
 export var QueueActionType;
 (function (QueueActionType) {
-    QueueActionType["SendMessages"] = "@quidproquo-core/Queue/SendMessage";
+    QueueActionType["SendMessage"] = "@quidproquo-core/Queue/SendMessage";
 })(QueueActionType || (QueueActionType = {}));
 //# sourceMappingURL=QueueActionType.js.map

package/lib/esm/actions/queue/QueueActionType.js.map

@@ -1 +1 @@
-{"version":3,"file":"QueueActionType.js","sourceRoot":"","sources":["../../../../src/actions/queue/QueueActionType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,sEAAmD,CAAA;AACrD,CAAC,EAFW,eAAe,KAAf,eAAe,QAE1B","sourcesContent":["export enum QueueActionType {\n  SendMessages = '@quidproquo-core/Queue/SendMessage',\n}\n"]}
+{"version":3,"file":"QueueActionType.js","sourceRoot":"","sources":["../../../../src/actions/queue/QueueActionType.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,eAEX;AAFD,WAAY,eAAe;IACzB,qEAAkD,CAAA;AACpD,CAAC,EAFW,eAAe,KAAf,eAAe,QAE1B","sourcesContent":["export enum QueueActionType {\n  SendMessage = '@quidproquo-core/Queue/SendMessage',\n}\n"]}

package/lib/esm/actions/queue/askQueueSendMessages.d.ts

@@ -10,5 +10,14 @@ export type QueueMessage<T> = CrossModuleMessage<T> & {
 export declare const askQueueSendMessagesBase: import("../../types").ActionRequesterFunction<QueueActionType, [queueName: string, queueMessages: QueueMessage<any>[]], {
     queueMessages: QueueMessage<any>[];
     queueName: string;
-}, void, "AccessDenied" | "ServiceUnavailable" | "QueueNotFound">;
-export declare function askQueueSendMessages<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void>;
+}, void, "Throttled" | "AccessDenied" | "QueueNotFound">;
+declare function askQueueSendMessagesTyped<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void>;
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askQueueSendMessages: typeof askQueueSendMessagesTyped & {
+    errorType: {
+        Throttled: string;
+        AccessDenied: string;
+        QueueNotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/queue/askQueueSendMessages.js

@@ -1,16 +1,18 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { QueueActionType } from './QueueActionType';
 export const askQueueSendMessagesBase = createActionRequester()({
-    actionType: QueueActionType.SendMessages,
+    actionType: QueueActionType.SendMessage,
     errorTypes: [
         'AccessDenied', // caller lacks permission to send to the queue
-        'QueueNotFound', // the SQS queue does not exist
-        'ServiceUnavailable', // SQS internal error / throttling
+        'QueueNotFound', // the queue does not exist
+        'Throttled', // the queue is throttling or failed internally; transient
     ],
     getPayload: (queueName, queueMessages) => ({ queueMessages, queueName }),
 });
 // Generic so callers can pin the message body shape at the call site.
-export function* askQueueSendMessages(queueName, ...queueMessages) {
+function* askQueueSendMessagesTyped(queueName, ...queueMessages) {
     return yield* askQueueSendMessagesBase(queueName, queueMessages);
 }
+/** Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askQueueSendMessages = Object.assign(askQueueSendMessagesTyped, { errorType: askQueueSendMessagesBase.errorType });
 //# sourceMappingURL=askQueueSendMessages.js.map

package/lib/esm/actions/queue/askQueueSendMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"askQueueSendMessages.js","sourceRoot":"","sources":["../../../../src/actions/queue/askQueueSendMessages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,EAAQ,CAAC;IACpE,UAAU,EAAE,eAAe,CAAC,YAAY;IACxC,UAAU,EAAE;QACV,cAAc,EAAE,+CAA+C;QAC/D,eAAe,EAAE,+BAA+B;QAChD,oBAAoB,EAAE,kCAAkC;KACzD;IACD,UAAU,EAAE,CAAC,SAAiB,EAAE,aAAkC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;CACtG,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,SAAS,CAAC,CAAC,oBAAoB,CAA8B,SAAiB,EAAE,GAAG,aAAkB;IACzG,OAAO,KAAK,CAAC,CAAC,wBAAwB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import { CrossModuleMessage } from '../../types';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { QueueActionType } from './QueueActionType';\n\nexport type QueueMessage<T> = CrossModuleMessage<T> & {\n  /** FIFO queues only: message group for ordering. Defaults to the queue name (global ordering). */\n  groupId?: string;\n\n  /** FIFO queues only: dedup id (5-min SQS window). Defaults to a generated uuid (no dedup). */\n  deduplicationId?: string;\n};\n\nexport const askQueueSendMessagesBase = createActionRequester<void>()({\n  actionType: QueueActionType.SendMessages,\n  errorTypes: [\n    'AccessDenied', // caller lacks permission to send to the queue\n    'QueueNotFound', // the SQS queue does not exist\n    'ServiceUnavailable', // SQS internal error / throttling\n  ],\n  getPayload: (queueName: string, queueMessages: QueueMessage<any>[]) => ({ queueMessages, queueName }),\n});\n\n// Generic so callers can pin the message body shape at the call site.\nexport function* askQueueSendMessages<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void> {\n  return yield* askQueueSendMessagesBase(queueName, queueMessages);\n}\n"]}
+{"version":3,"file":"askQueueSendMessages.js","sourceRoot":"","sources":["../../../../src/actions/queue/askQueueSendMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,EAAQ,CAAC;IACpE,UAAU,EAAE,eAAe,CAAC,WAAW;IACvC,UAAU,EAAE;QACV,cAAc,EAAE,+CAA+C;QAC/D,eAAe,EAAE,2BAA2B;QAC5C,WAAW,EAAE,0DAA0D;KACxE;IACD,UAAU,EAAE,CAAC,SAAiB,EAAE,aAAkC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;CACtG,CAAC,CAAC;AAEH,sEAAsE;AACtE,QAAQ,CAAC,CAAC,yBAAyB,CAA8B,SAAiB,EAAE,GAAG,aAAkB;IACvG,OAAO,KAAK,CAAC,CAAC,wBAAwB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACnE,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,EAAE,SAAS,EAAE,wBAAwB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { CrossModuleMessage } from '../../types';\nimport { AskResponse } from '../../types/StorySession';\nimport { QueueActionType } from './QueueActionType';\n\nexport type QueueMessage<T> = CrossModuleMessage<T> & {\n  /** FIFO queues only: message group for ordering. Defaults to the queue name (global ordering). */\n  groupId?: string;\n\n  /** FIFO queues only: dedup id (5-min SQS window). Defaults to a generated uuid (no dedup). */\n  deduplicationId?: string;\n};\n\nexport const askQueueSendMessagesBase = createActionRequester<void>()({\n  actionType: QueueActionType.SendMessage,\n  errorTypes: [\n    'AccessDenied', // caller lacks permission to send to the queue\n    'QueueNotFound', // the queue does not exist\n    'Throttled', // the queue is throttling or failed internally; transient\n  ],\n  getPayload: (queueName: string, queueMessages: QueueMessage<any>[]) => ({ queueMessages, queueName }),\n});\n\n// Generic so callers can pin the message body shape at the call site.\nfunction* askQueueSendMessagesTyped<T extends QueueMessage<any>>(queueName: string, ...queueMessages: T[]): AskResponse<void> {\n  return yield* askQueueSendMessagesBase(queueName, queueMessages);\n}\n\n/** Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askQueueSendMessages = Object.assign(askQueueSendMessagesTyped, { errorType: askQueueSendMessagesBase.errorType });\n"]}

package/lib/esm/actions/secureToken/askSecureTokenGenerate.d.ts

@@ -5,6 +5,6 @@ import { SecureTokenActionType } from './SecureTokenActionType';
  * characters). The admin log redaction treats the result as a secret: it's blanked in this action's
  * entry and swept from every other string in the story's log.
  */
-export declare const askSecureTokenGenerate: import("../../types").ActionRequesterFunction<SecureTokenActionType, [byteLength?: number | undefined], {
+export declare const askSecureTokenGenerate: import("../..").ActionRequesterFunction<SecureTokenActionType, [byteLength?: number | undefined], {
     byteLength: number;
 }, string, "InvalidByteLength" | "RandomSourceUnavailable">;

package/lib/esm/actions/secureToken/askSecureTokenGenerate.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types';
+import { createActionRequester } from '../../logic/actions';
 import { SecureTokenActionType } from './SecureTokenActionType';
 /**
  * A new random token to use as a secret (a signing link, an API secret): `byteLength` bytes from the

package/lib/esm/actions/secureToken/askSecureTokenGenerate.js.map

@@ -1 +1 @@
-{"version":3,"file":"askSecureTokenGenerate.js","sourceRoot":"","sources":["../../../../src/actions/secureToken/askSecureTokenGenerate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,EAAU,CAAC;IACpE,UAAU,EAAE,qBAAqB,CAAC,QAAQ;IAC1C,UAAU,EAAE;QACV,mBAAmB,EAAE,4DAA4D;QACjF,yBAAyB,EAAE,oCAAoC;KAChE;IACD,UAAU,EAAE,CAAC,aAAqB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1D,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { SecureTokenActionType } from './SecureTokenActionType';\n\n/**\n * A new random token to use as a secret (a signing link, an API secret): `byteLength` bytes from the\n * platform's secure random source, as lowercase hex (so 32 bytes, the default and 256 bits, is 64\n * characters). The admin log redaction treats the result as a secret: it's blanked in this action's\n * entry and swept from every other string in the story's log.\n */\nexport const askSecureTokenGenerate = createActionRequester<string>()({\n  actionType: SecureTokenActionType.Generate,\n  errorTypes: [\n    'InvalidByteLength', // not a whole number from 1 to SECURE_TOKEN_MAX_BYTE_LENGTH\n    'RandomSourceUnavailable', // no Web Crypto API in this runtime\n  ],\n  getPayload: (byteLength: number = 32) => ({ byteLength }),\n});\n"]}
+{"version":3,"file":"askSecureTokenGenerate.js","sourceRoot":"","sources":["../../../../src/actions/secureToken/askSecureTokenGenerate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,EAAU,CAAC;IACpE,UAAU,EAAE,qBAAqB,CAAC,QAAQ;IAC1C,UAAU,EAAE;QACV,mBAAmB,EAAE,4DAA4D;QACjF,yBAAyB,EAAE,oCAAoC;KAChE;IACD,UAAU,EAAE,CAAC,aAAqB,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;CAC1D,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { SecureTokenActionType } from './SecureTokenActionType';\n\n/**\n * A new random token to use as a secret (a signing link, an API secret): `byteLength` bytes from the\n * platform's secure random source, as lowercase hex (so 32 bytes, the default and 256 bits, is 64\n * characters). The admin log redaction treats the result as a secret: it's blanked in this action's\n * entry and swept from every other string in the story's log.\n */\nexport const askSecureTokenGenerate = createActionRequester<string>()({\n  actionType: SecureTokenActionType.Generate,\n  errorTypes: [\n    'InvalidByteLength', // not a whole number from 1 to SECURE_TOKEN_MAX_BYTE_LENGTH\n    'RandomSourceUnavailable', // no Web Crypto API in this runtime\n  ],\n  getPayload: (byteLength: number = 32) => ({ byteLength }),\n});\n"]}

package/lib/esm/actions/state/askStateDispatch.d.ts

@@ -1,13 +1,8 @@
-import { Action } from '../../types/Action';
 import { AskResponse } from '../../types/StorySession';
 import { StateActionType } from './StateActionType';
 export type StateDispatchActionPayload<T> = {
     action: T;
 };
-export interface StateDispatchAction<T> extends Action<StateDispatchActionPayload<T>> {
-    type: StateActionType.Dispatch;
-    payload: StateDispatchActionPayload<T>;
-}
 export declare const askStateDispatchBase: import("../..").ActionRequesterFunction<StateActionType.Dispatch, [action: unknown], {
     action: unknown;
 }, void, never>;

package/lib/esm/actions/state/askStateDispatch.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { StateActionType } from './StateActionType';
 export const askStateDispatchBase = createActionRequester()({
     actionType: StateActionType.Dispatch,

package/lib/esm/actions/state/askStateDispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStateDispatch.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateDispatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,EAAQ,CAAC;IAChE,UAAU,EAAE,eAAe,CAAC,QAAQ;IACpC,UAAU,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9C,CAAC,CAAC;AAEH,4FAA4F;AAC5F,MAAM,SAAS,CAAC,CAAC,gBAAgB,CAAI,MAAS;IAC5C,OAAO,KAAK,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { StateActionType } from './StateActionType';\n\nexport type StateDispatchActionPayload<T> = {\n  action: T;\n};\n\nexport interface StateDispatchAction<T> extends Action<StateDispatchActionPayload<T>> {\n  type: StateActionType.Dispatch;\n  payload: StateDispatchActionPayload<T>;\n}\n\nexport const askStateDispatchBase = createActionRequester<void>()({\n  actionType: StateActionType.Dispatch,\n  getPayload: (action: unknown) => ({ action }),\n});\n\n// Generic so callers can pin the effect/action shape they are dispatching at the call site.\nexport function* askStateDispatch<T>(action: T): AskResponse<void> {\n  return yield* askStateDispatchBase(action);\n}\n"]}
+{"version":3,"file":"askStateDispatch.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateDispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAElF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,EAAQ,CAAC;IAChE,UAAU,EAAE,eAAe,CAAC,QAAQ;IACpC,UAAU,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9C,CAAC,CAAC;AAEH,4FAA4F;AAC5F,MAAM,SAAS,CAAC,CAAC,gBAAgB,CAAI,MAAS;IAC5C,OAAO,KAAK,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { StateActionType } from './StateActionType';\n\nexport type StateDispatchActionPayload<T> = {\n  action: T;\n};\n\nexport const askStateDispatchBase = createActionRequester<void>()({\n  actionType: StateActionType.Dispatch,\n  getPayload: (action: unknown) => ({ action }),\n});\n\n// Generic so callers can pin the effect/action shape they are dispatching at the call site.\nexport function* askStateDispatch<T>(action: T): AskResponse<void> {\n  return yield* askStateDispatchBase(action);\n}\n"]}

package/lib/esm/actions/state/askStateRead.d.ts

@@ -1,13 +1,8 @@
-import { Action } from '../../types/Action';
 import { AskResponse } from '../../types/StorySession';
 import { StateActionType } from './StateActionType';
 export type StateReadActionPayload = {
     path?: string;
 };
-export interface StateReadAction extends Action<StateReadActionPayload> {
-    type: StateActionType.Read;
-    payload: StateReadActionPayload;
-}
 export declare const askStateReadBase: import("../..").ActionRequesterFunction<StateActionType.Read, [path?: string | undefined], {
     path: string | undefined;
 }, unknown, never>;

package/lib/esm/actions/state/askStateRead.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { StateActionType } from './StateActionType';
 export const askStateReadBase = createActionRequester()({
     actionType: StateActionType.Read,

package/lib/esm/actions/state/askStateRead.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStateRead.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateRead.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,EAAW,CAAC;IAC/D,UAAU,EAAE,eAAe,CAAC,IAAI;IAChC,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH,uFAAuF;AACvF,+DAA+D;AAC/D,MAAM,SAAS,CAAC,CAAC,YAAY,CAAI,IAAa;IAC5C,OAAO,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAM,CAAC;AAC9C,CAAC","sourcesContent":["import { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { StateActionType } from './StateActionType';\n\nexport type StateReadActionPayload = {\n  path?: string;\n};\n\nexport interface StateReadAction extends Action<StateReadActionPayload> {\n  type: StateActionType.Read;\n  payload: StateReadActionPayload;\n}\n\nexport const askStateReadBase = createActionRequester<unknown>()({\n  actionType: StateActionType.Read,\n  getPayload: (path?: string) => ({ path }),\n});\n\n// The state's shape at the given path is only known to the caller, so the base returns\n// unknown and this story casts it to what the caller declared.\nexport function* askStateRead<R>(path?: string): AskResponse<R> {\n  return (yield* askStateReadBase(path)) as R;\n}\n"]}
+{"version":3,"file":"askStateRead.js","sourceRoot":"","sources":["../../../../src/actions/state/askStateRead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAElF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,EAAW,CAAC;IAC/D,UAAU,EAAE,eAAe,CAAC,IAAI;IAChC,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH,uFAAuF;AACvF,+DAA+D;AAC/D,MAAM,SAAS,CAAC,CAAC,YAAY,CAAI,IAAa;IAC5C,OAAO,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAM,CAAC;AAC9C,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { StateActionType } from './StateActionType';\n\nexport type StateReadActionPayload = {\n  path?: string;\n};\n\nexport const askStateReadBase = createActionRequester<unknown>()({\n  actionType: StateActionType.Read,\n  getPayload: (path?: string) => ({ path }),\n});\n\n// The state's shape at the given path is only known to the caller, so the base returns\n// unknown and this story casts it to what the caller declared.\nexport function* askStateRead<R>(path?: string): AskResponse<R> {\n  return (yield* askStateReadBase(path)) as R;\n}\n"]}

package/lib/esm/actions/stream/askStreamClose.d.ts

@@ -1,5 +1,5 @@
 import { StreamHandle } from '../../types/StreamRegistry';
 import { StreamActionType } from './StreamActionType';
-export declare const askStreamClose: import("../../types").ActionRequesterFunction<StreamActionType.Close, [handle: StreamHandle<import("../../types").StreamEncoding, unknown>], {
+export declare const askStreamClose: import("../..").ActionRequesterFunction<StreamActionType.Close, [handle: StreamHandle], {
     streamId: string;
 }, void, never>;

package/lib/esm/actions/stream/askStreamClose.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types';
+import { createActionRequester } from '../../logic/actions';
 import { StreamActionType } from './StreamActionType';
 export const askStreamClose = createActionRequester()({
     actionType: StreamActionType.Close,

package/lib/esm/actions/stream/askStreamClose.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStreamClose.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamClose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,EAAQ,CAAC;IAC1D,UAAU,EAAE,gBAAgB,CAAC,KAAK;IAClC,UAAU,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;CAChE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { StreamActionType } from './StreamActionType';\n\nexport const askStreamClose = createActionRequester<void>()({\n  actionType: StreamActionType.Close,\n  getPayload: (handle: StreamHandle) => ({ streamId: handle.id }),\n});\n"]}
+{"version":3,"file":"askStreamClose.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamClose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,EAAQ,CAAC;IAC1D,UAAU,EAAE,gBAAgB,CAAC,KAAK;IAClC,UAAU,EAAE,CAAC,MAAoB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;CAChE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { StreamHandle } from '../../types/StreamRegistry';\nimport { StreamActionType } from './StreamActionType';\n\nexport const askStreamClose = createActionRequester<void>()({\n  actionType: StreamActionType.Close,\n  getPayload: (handle: StreamHandle) => ({ streamId: handle.id }),\n});\n"]}

package/lib/esm/actions/stream/askStreamRead.d.ts

@@ -4,5 +4,13 @@ import { StreamActionType } from './StreamActionType';
 export declare const askStreamReadBase: import("../..").ActionRequesterFunction<StreamActionType.Read, [streamId: string, noWait?: boolean | undefined], {
     streamId: string;
     noWait: boolean | undefined;
-}, StreamChunk<string>, never>;
-export declare function askStreamRead<E extends StreamEncoding, T = unknown>(handle: StreamHandle<E, T>, noWait?: boolean): AskResponse<StreamChunk<StreamDataType<E, T>>>;
+}, StreamChunk<string>, "StreamNotFound" | "StreamFailed">;
+declare function askStreamReadTyped<E extends StreamEncoding, T = unknown>(handle: StreamHandle<E, T>, noWait?: boolean): AskResponse<StreamChunk<StreamDataType<E, T>>>;
+/** Reads the next chunk of a stream in the shape its handle's encoding promises. Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askStreamRead: typeof askStreamReadTyped & {
+    errorType: {
+        StreamNotFound: string;
+        StreamFailed: string;
+    };
+};
+export {};

package/lib/esm/actions/stream/askStreamRead.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { StreamActionType } from './StreamActionType';
 const decodeBase64ToUint8Array = (base64) => {
     const binary = atob(base64);
@@ -12,9 +12,13 @@ const decodeBase64ToUint8Array = (base64) => {
 // the shape the handle's encoding promises.
 export const askStreamReadBase = createActionRequester()({
     actionType: StreamActionType.Read,
+    errorTypes: [
+        'StreamNotFound', // no open stream has this id: it was never registered, already finished, failed or was closed
+        'StreamFailed', // the stream's producer threw; its message is relayed in errorText
+    ],
     getPayload: (streamId, noWait) => ({ streamId, noWait }),
 });
-export function* askStreamRead(handle, noWait) {
+function* askStreamReadTyped(handle, noWait) {
     const rawChunk = yield* askStreamReadBase(handle.id, noWait);
     if (!rawChunk.data || rawChunk.done || rawChunk.skipped) {
         return rawChunk;
@@ -27,4 +31,6 @@ export function* askStreamRead(handle, noWait) {
     }
     return rawChunk;
 }
+/** Reads the next chunk of a stream in the shape its handle's encoding promises. Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askStreamRead = Object.assign(askStreamReadTyped, { errorType: askStreamReadBase.errorType });
 //# sourceMappingURL=askStreamRead.js.map

package/lib/esm/actions/stream/askStreamRead.js.map

@@ -1 +1 @@
-{"version":3,"file":"askStreamRead.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamRead.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAc,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,oFAAoF;AACpF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,EAAuB,CAAC;IAC5E,UAAU,EAAE,gBAAgB,CAAC,IAAI;IACjC,UAAU,EAAE,CAAC,QAAgB,EAAE,MAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC3E,CAAC,CAAC;AAEH,MAAM,SAAS,CAAC,CAAC,aAAa,CAC5B,MAA0B,EAC1B,MAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7D,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxD,OAAO,QAA6C,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAuC,CAAC;IAC7G,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAuC,CAAC;IAC/F,CAAC;IAED,OAAO,QAA6C,CAAC;AACvD,CAAC","sourcesContent":["import { AskResponse } from '../../types/StorySession';\nimport { StreamChunk, StreamDataType, StreamEncoding, StreamHandle } from '../../types/StreamRegistry';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { StreamActionType } from './StreamActionType';\n\nconst decodeBase64ToUint8Array = (base64: string): Uint8Array => {\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n};\n\n// Chunks always cross the runtime boundary as strings; this story decodes them into\n// the shape the handle's encoding promises.\nexport const askStreamReadBase = createActionRequester<StreamChunk<string>>()({\n  actionType: StreamActionType.Read,\n  getPayload: (streamId: string, noWait?: boolean) => ({ streamId, noWait }),\n});\n\nexport function* askStreamRead<E extends StreamEncoding, T = unknown>(\n  handle: StreamHandle<E, T>,\n  noWait?: boolean,\n): AskResponse<StreamChunk<StreamDataType<E, T>>> {\n  const rawChunk = yield* askStreamReadBase(handle.id, noWait);\n\n  if (!rawChunk.data || rawChunk.done || rawChunk.skipped) {\n    return rawChunk as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'binary') {\n    return { ...rawChunk, data: decodeBase64ToUint8Array(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'json') {\n    return { ...rawChunk, data: JSON.parse(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  return rawChunk as StreamChunk<StreamDataType<E, T>>;\n}\n"]}
+{"version":3,"file":"askStreamRead.js","sourceRoot":"","sources":["../../../../src/actions/stream/askStreamRead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAc,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,oFAAoF;AACpF,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,EAAuB,CAAC;IAC5E,UAAU,EAAE,gBAAgB,CAAC,IAAI;IACjC,UAAU,EAAE;QACV,gBAAgB,EAAE,8FAA8F;QAChH,cAAc,EAAE,mEAAmE;KACpF;IACD,UAAU,EAAE,CAAC,QAAgB,EAAE,MAAgB,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC3E,CAAC,CAAC;AAEH,QAAQ,CAAC,CAAC,kBAAkB,CAC1B,MAA0B,EAC1B,MAAgB;IAEhB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE7D,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxD,OAAO,QAA6C,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAuC,CAAC;IAC7G,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAuC,CAAC;IAC/F,CAAC;IAED,OAAO,QAA6C,CAAC;AACvD,CAAC;AAED,iKAAiK;AACjK,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,SAAS,EAAE,iBAAiB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { AskResponse } from '../../types/StorySession';\nimport { StreamChunk, StreamDataType, StreamEncoding, StreamHandle } from '../../types/StreamRegistry';\nimport { StreamActionType } from './StreamActionType';\n\nconst decodeBase64ToUint8Array = (base64: string): Uint8Array => {\n  const binary = atob(base64);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  return bytes;\n};\n\n// Chunks always cross the runtime boundary as strings; this story decodes them into\n// the shape the handle's encoding promises.\nexport const askStreamReadBase = createActionRequester<StreamChunk<string>>()({\n  actionType: StreamActionType.Read,\n  errorTypes: [\n    'StreamNotFound', // no open stream has this id: it was never registered, already finished, failed or was closed\n    'StreamFailed', // the stream's producer threw; its message is relayed in errorText\n  ],\n  getPayload: (streamId: string, noWait?: boolean) => ({ streamId, noWait }),\n});\n\nfunction* askStreamReadTyped<E extends StreamEncoding, T = unknown>(\n  handle: StreamHandle<E, T>,\n  noWait?: boolean,\n): AskResponse<StreamChunk<StreamDataType<E, T>>> {\n  const rawChunk = yield* askStreamReadBase(handle.id, noWait);\n\n  if (!rawChunk.data || rawChunk.done || rawChunk.skipped) {\n    return rawChunk as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'binary') {\n    return { ...rawChunk, data: decodeBase64ToUint8Array(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  if (handle.encoding === 'json') {\n    return { ...rawChunk, data: JSON.parse(rawChunk.data) } as StreamChunk<StreamDataType<E, T>>;\n  }\n\n  return rawChunk as StreamChunk<StreamDataType<E, T>>;\n}\n\n/** Reads the next chunk of a stream in the shape its handle's encoding promises. Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askStreamRead = Object.assign(askStreamReadTyped, { errorType: askStreamReadBase.errorType });\n"]}

package/lib/esm/actions/system/askBatch.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { SystemActionType } from './SystemActionType';
 export const askBatchBase = createActionRequester()({
     actionType: SystemActionType.Batch,
@@ -11,8 +11,9 @@ export function* askBatch(actions) {
     }
     // If we only have one action, just execute it directly
     // No need to batch it
-    if (actions.length === 1) {
-        return [yield actions[0]];
+    const only = actions[0];
+    if (actions.length === 1 && only) {
+        return [yield only];
     }
     // Otherwise, batch the actions
     return (yield* askBatchBase(actions));

package/lib/esm/actions/system/askBatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"askBatch.js","sourceRoot":"","sources":["../../../../src/actions/system/askBatch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,EAAS,CAAC;IACzD,UAAU,EAAE,gBAAgB,CAAC,KAAK;IAClC,UAAU,EAAE,CAAC,OAAsB,EAA4B,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,SAAS,CAAC,CAAC,QAAQ,CAAqC,OAAsB;IAClF,0EAA0E;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAwB,CAAC;IAClC,CAAC;IAED,uDAAuD;IACvD,sBAAsB;IACtB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAY,CAAC;IACvC,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAY,CAAC;AACnD,CAAC","sourcesContent":["import { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { SystemActionType } from './SystemActionType';\n\nexport type SystemBatchActionPayload = {\n  actions: Action<any>[];\n};\n\nexport const askBatchBase = createActionRequester<any[]>()({\n  actionType: SystemActionType.Batch,\n  getPayload: (actions: Action<any>[]): SystemBatchActionPayload => ({ actions }),\n});\n\nexport function* askBatch<TReturn extends Array<any> = any[]>(actions: Action<any>[]): AskResponse<TReturn> {\n  // Nothing to batch, don't pollute the story log with a no-op Batch action\n  if (actions.length === 0) {\n    return [] as unknown as TReturn;\n  }\n\n  // If we only have one action, just execute it directly\n  // No need to batch it\n  if (actions.length === 1) {\n    return [yield actions[0]] as TReturn;\n  }\n\n  // Otherwise, batch the actions\n  return (yield* askBatchBase(actions)) as TReturn;\n}\n"]}
+{"version":3,"file":"askBatch.js","sourceRoot":"","sources":["../../../../src/actions/system/askBatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAMtD,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,EAAS,CAAC;IACzD,UAAU,EAAE,gBAAgB,CAAC,KAAK;IAClC,UAAU,EAAE,CAAC,OAAsB,EAA4B,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,SAAS,CAAC,CAAC,QAAQ,CAAqC,OAAsB;IAClF,0EAA0E;IAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAwB,CAAC;IAClC,CAAC;IAED,uDAAuD;IACvD,sBAAsB;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,IAAI,CAAY,CAAC;IACjC,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAY,CAAC;AACnD,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { Action } from '../../types/Action';\nimport { AskResponse } from '../../types/StorySession';\nimport { SystemActionType } from './SystemActionType';\n\nexport type SystemBatchActionPayload = {\n  actions: Action<any>[];\n};\n\nexport const askBatchBase = createActionRequester<any[]>()({\n  actionType: SystemActionType.Batch,\n  getPayload: (actions: Action<any>[]): SystemBatchActionPayload => ({ actions }),\n});\n\nexport function* askBatch<TReturn extends Array<any> = any[]>(actions: Action<any>[]): AskResponse<TReturn> {\n  // Nothing to batch, don't pollute the story log with a no-op Batch action\n  if (actions.length === 0) {\n    return [] as unknown as TReturn;\n  }\n\n  // If we only have one action, just execute it directly\n  // No need to batch it\n  const only = actions[0];\n  if (actions.length === 1 && only) {\n    return [yield only] as TReturn;\n  }\n\n  // Otherwise, batch the actions\n  return (yield* askBatchBase(actions)) as TReturn;\n}\n"]}

package/lib/esm/actions/system/askExecuteStory.d.ts

@@ -5,5 +5,12 @@ export declare const askExecuteStoryBase: import("../../types").ActionRequesterF
     runtime: QpqFunctionRuntime;
     params: unknown[];
     storySession: StorySession | undefined;
-}, unknown, never>;
-export declare function askExecuteStory<StoryInput extends Array<any>, StoryOutput>(runtime: QpqFunctionRuntime, params: StoryInput, storySession?: StorySession): AskResponse<StoryOutput>;
+}, unknown, "NotFound">;
+declare function askExecuteStoryTyped<StoryInput extends Array<any>, StoryOutput>(runtime: QpqFunctionRuntime, params: StoryInput, storySession?: StorySession): AskResponse<StoryOutput>;
+/** Runs another story by its runtime pointer. Carries the base requester's `errorType` catalog so callers can match on it. */
+export declare const askExecuteStory: typeof askExecuteStoryTyped & {
+    errorType: {
+        NotFound: string;
+    };
+};
+export {};

package/lib/esm/actions/system/askExecuteStory.js

@@ -1,12 +1,17 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { SystemActionType } from './SystemActionType';
 export const askExecuteStoryBase = createActionRequester()({
     actionType: SystemActionType.ExecuteStory,
+    errorTypes: [
+        'NotFound', // the runtime could not be dynamically loaded
+    ],
     getPayload: (runtime, params, storySession) => ({ runtime, params, storySession }),
 });
 // The target story's params and result are only known to the caller, so the base takes
 // and returns unknown and this story casts to what the caller declared.
-export function* askExecuteStory(runtime, params, storySession) {
+function* askExecuteStoryTyped(runtime, params, storySession) {
     return (yield* askExecuteStoryBase(runtime, params, storySession));
 }
+/** Runs another story by its runtime pointer. Carries the base requester's `errorType` catalog so callers can match on it. */
+export const askExecuteStory = Object.assign(askExecuteStoryTyped, { errorType: askExecuteStoryBase.errorType });
 //# sourceMappingURL=askExecuteStory.js.map

package/lib/esm/actions/system/askExecuteStory.js.map

@@ -1 +1 @@
-{"version":3,"file":"askExecuteStory.js","sourceRoot":"","sources":["../../../../src/actions/system/askExecuteStory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,EAAW,CAAC;IAClE,UAAU,EAAE,gBAAgB,CAAC,YAAY;IACzC,UAAU,EAAE,CAAC,OAA2B,EAAE,MAAiB,EAAE,YAA2B,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;CACjI,CAAC,CAAC;AAEH,uFAAuF;AACvF,wEAAwE;AACxE,MAAM,SAAS,CAAC,CAAC,eAAe,CAC9B,OAA2B,EAC3B,MAAkB,EAClB,YAA2B;IAE3B,OAAO,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAgB,CAAC;AACpF,CAAC","sourcesContent":["import { QpqFunctionRuntime, StorySession } from '../../types';\nimport { AskResponse } from '../../types/StorySession';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { SystemActionType } from './SystemActionType';\n\nexport const askExecuteStoryBase = createActionRequester<unknown>()({\n  actionType: SystemActionType.ExecuteStory,\n  getPayload: (runtime: QpqFunctionRuntime, params: unknown[], storySession?: StorySession) => ({ runtime, params, storySession }),\n});\n\n// The target story's params and result are only known to the caller, so the base takes\n// and returns unknown and this story casts to what the caller declared.\nexport function* askExecuteStory<StoryInput extends Array<any>, StoryOutput>(\n  runtime: QpqFunctionRuntime,\n  params: StoryInput,\n  storySession?: StorySession,\n): AskResponse<StoryOutput> {\n  return (yield* askExecuteStoryBase(runtime, params, storySession)) as StoryOutput;\n}\n"]}
+{"version":3,"file":"askExecuteStory.js","sourceRoot":"","sources":["../../../../src/actions/system/askExecuteStory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,EAAW,CAAC;IAClE,UAAU,EAAE,gBAAgB,CAAC,YAAY;IACzC,UAAU,EAAE;QACV,UAAU,EAAE,8CAA8C;KAC3D;IACD,UAAU,EAAE,CAAC,OAA2B,EAAE,MAAiB,EAAE,YAA2B,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;CACjI,CAAC,CAAC;AAEH,uFAAuF;AACvF,wEAAwE;AACxE,QAAQ,CAAC,CAAC,oBAAoB,CAC5B,OAA2B,EAC3B,MAAkB,EAClB,YAA2B;IAE3B,OAAO,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,CAAgB,CAAC;AACpF,CAAC;AAED,8HAA8H;AAC9H,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,mBAAmB,CAAC,SAAS,EAAE,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { QpqFunctionRuntime, StorySession } from '../../types';\nimport { AskResponse } from '../../types/StorySession';\nimport { SystemActionType } from './SystemActionType';\n\nexport const askExecuteStoryBase = createActionRequester<unknown>()({\n  actionType: SystemActionType.ExecuteStory,\n  errorTypes: [\n    'NotFound', // the runtime could not be dynamically loaded\n  ],\n  getPayload: (runtime: QpqFunctionRuntime, params: unknown[], storySession?: StorySession) => ({ runtime, params, storySession }),\n});\n\n// The target story's params and result are only known to the caller, so the base takes\n// and returns unknown and this story casts to what the caller declared.\nfunction* askExecuteStoryTyped<StoryInput extends Array<any>, StoryOutput>(\n  runtime: QpqFunctionRuntime,\n  params: StoryInput,\n  storySession?: StorySession,\n): AskResponse<StoryOutput> {\n  return (yield* askExecuteStoryBase(runtime, params, storySession)) as StoryOutput;\n}\n\n/** Runs another story by its runtime pointer. Carries the base requester's `errorType` catalog so callers can match on it. */\nexport const askExecuteStory = Object.assign(askExecuteStoryTyped, { errorType: askExecuteStoryBase.errorType });\n"]}

package/lib/esm/actions/system/askGetRuntimeCorrelation.d.ts

@@ -1,2 +1,2 @@
 import { SystemActionType } from './SystemActionType';
-export declare const askGetRuntimeCorrelation: import("../../types").ActionRequesterFunction<SystemActionType.GetRuntimeCorrelation, [], undefined, string, never>;
+export declare const askGetRuntimeCorrelation: import("../..").ActionRequesterFunction<SystemActionType.GetRuntimeCorrelation, [], undefined, string, never>;

package/lib/esm/actions/system/askGetRuntimeCorrelation.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types';
+import { createActionRequester } from '../../logic/actions';
 import { SystemActionType } from './SystemActionType';
 // Returns the correlation guid for the currently executing story. The correlation
 // links all of a story's actions (and its sub-stories) together in the logs, so it

package/lib/esm/actions/system/askGetRuntimeCorrelation.js.map

@@ -1 +1 @@
-{"version":3,"file":"askGetRuntimeCorrelation.js","sourceRoot":"","sources":["../../../../src/actions/system/askGetRuntimeCorrelation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,kFAAkF;AAClF,mFAAmF;AACnF,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,EAAU,CAAC;IACtE,UAAU,EAAE,gBAAgB,CAAC,qBAAqB;CACnD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { SystemActionType } from './SystemActionType';\n\n// Returns the correlation guid for the currently executing story. The correlation\n// links all of a story's actions (and its sub-stories) together in the logs, so it\n// is the handle to store when you want to link back to admin / execution history.\nexport const askGetRuntimeCorrelation = createActionRequester<string>()({\n  actionType: SystemActionType.GetRuntimeCorrelation,\n});\n"]}
+{"version":3,"file":"askGetRuntimeCorrelation.js","sourceRoot":"","sources":["../../../../src/actions/system/askGetRuntimeCorrelation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,kFAAkF;AAClF,mFAAmF;AACnF,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,EAAU,CAAC;IACtE,UAAU,EAAE,gBAAgB,CAAC,qBAAqB;CACnD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { SystemActionType } from './SystemActionType';\n\n// Returns the correlation guid for the currently executing story. The correlation\n// links all of a story's actions (and its sub-stories) together in the logs, so it\n// is the handle to store when you want to link back to admin / execution history.\nexport const askGetRuntimeCorrelation = createActionRequester<string>()({\n  actionType: SystemActionType.GetRuntimeCorrelation,\n});\n"]}

package/lib/esm/actions/system/askGetRuntimeRemainingTime.d.ts

@@ -4,4 +4,4 @@ import { SystemActionType } from './SystemActionType';
  * (agentic AI turns, batch sweeps) check this between steps and hand off before the
  * hard cutoff. Runtimes with no execution limit return Number.MAX_SAFE_INTEGER.
  */
-export declare const askGetRuntimeRemainingTime: import("../../types").ActionRequesterFunction<SystemActionType.GetRuntimeRemainingTime, [], undefined, number, never>;
+export declare const askGetRuntimeRemainingTime: import("../..").ActionRequesterFunction<SystemActionType.GetRuntimeRemainingTime, [], undefined, number, never>;

package/lib/esm/actions/system/askGetRuntimeRemainingTime.js

@@ -1,4 +1,4 @@
-import { createActionRequester } from '../../types';
+import { createActionRequester } from '../../logic/actions';
 import { SystemActionType } from './SystemActionType';
 /**
  * Milliseconds left before the platform kills the current execution. Long loops

package/lib/esm/actions/system/askGetRuntimeRemainingTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"askGetRuntimeRemainingTime.js","sourceRoot":"","sources":["../../../../src/actions/system/askGetRuntimeRemainingTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,EAAU,CAAC;IACxE,UAAU,EAAE,gBAAgB,CAAC,uBAAuB;CACrD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../types';\nimport { SystemActionType } from './SystemActionType';\n\n/**\n * Milliseconds left before the platform kills the current execution. Long loops\n * (agentic AI turns, batch sweeps) check this between steps and hand off before the\n * hard cutoff. Runtimes with no execution limit return Number.MAX_SAFE_INTEGER.\n */\nexport const askGetRuntimeRemainingTime = createActionRequester<number>()({\n  actionType: SystemActionType.GetRuntimeRemainingTime,\n});\n"]}
+{"version":3,"file":"askGetRuntimeRemainingTime.js","sourceRoot":"","sources":["../../../../src/actions/system/askGetRuntimeRemainingTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,EAAU,CAAC;IACxE,UAAU,EAAE,gBAAgB,CAAC,uBAAuB;CACrD,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions';\nimport { SystemActionType } from './SystemActionType';\n\n/**\n * Milliseconds left before the platform kills the current execution. Long loops\n * (agentic AI turns, batch sweeps) check this between steps and hand off before the\n * hard cutoff. Runtimes with no execution limit return Number.MAX_SAFE_INTEGER.\n */\nexport const askGetRuntimeRemainingTime = createActionRequester<number>()({\n  actionType: SystemActionType.GetRuntimeRemainingTime,\n});\n"]}

package/lib/esm/actions/system/askParallelDEPRECATED.js

@@ -12,7 +12,7 @@ import { askBatch } from './askBatch';
  */
 export function* askParallelDEPRECATED(stories) {
     const itt = stories.map((s) => s[0](...s.slice(1)));
-    let actions = itt.map((i) => i.next());
+    const actions = itt.map((i) => i.next());
     let values = actions.map((a) => a.value);
     while (true) {
         // Batch any actions that we have not processed yet

package/lib/esm/actions/system/askParallelDEPRECATED.js.map

@@ -1 +1 @@
-{"version":3,"file":"askParallelDEPRECATED.js","sourceRoot":"","sources":["../../../../src/actions/system/askParallelDEPRECATED.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,SAAS,CAAC,CAAC,qBAAqB,CAAC,OAAmB;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,MAAM,GAAe,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD,OAAO,IAAI,EAAE,CAAC;QACZ,mDAAmD;QACnD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEtE,+EAA+E;QAC/E,8EAA8E;QAC9E,uEAAuE;QACvE,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAE7D,kDAAkD;QAClD,8EAA8E;QAC9E,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAEvD,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACrB,IAAI,GAAG,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["// NOTE: System actions have no platform specific processors and/or requestors\n// and therefore do not need to implement a SystemActionProcessor.ts\n\nimport { AskResponse } from '../../types/StorySession';\nimport { askBatch } from './askBatch';\n\n/**\n * @deprecated since version X.X. Please use {@link askRunParallel} instead.\n * Runs n number of stories in parallel. This function is deprecated and has been replaced\n * by a more efficient and type-supported version. The replacement function provides\n * improved performance and better type support.\n *\n * @param {Array<any>} stories - An array of stories to be run in parallel.\n * @returns {AskResponse<any[]>} The result of each story, in the order they were given.\n */\nexport function* askParallelDEPRECATED(stories: Array<any>): AskResponse<any[]> {\n  const itt = stories.map((s: any) => s[0](...s.slice(1)));\n  let actions = itt.map((i: any) => i.next());\n  let values: Array<any> = actions.map((a) => a.value);\n\n  while (true) {\n    // Batch any actions that we have not processed yet\n    const actionsToBatch = actions.map((a) => (!a.done ? a.value : null));\n\n    // Only send the still-pending actions to the runtime: a story that has already\n    // finished leaves a null hole, and a null action crashes the batch processor.\n    // Results are scattered back into their original positions afterwards.\n    const pendingActions = actionsToBatch.filter((atb) => !!atb);\n\n    // Only batch actions when there are some to batch\n    // People may batch stories together that actually dont have actions in them!?\n    if (pendingActions.length) {\n      const pendingResults = yield* askBatch(pendingActions);\n\n      let pendingIndex = 0;\n      values = actionsToBatch.map((atb) => (atb ? pendingResults[pendingIndex++] : undefined));\n    }\n\n    // Calculate real values\n    let done = true;\n    for (let i = 0; i < stories.length; i++) {\n      if (!actions[i].done) {\n        actions[i] = itt[i].next(values[i]);\n        if (!actions[i].done) {\n          done = false;\n        }\n      }\n    }\n\n    if (done) {\n      return actions.map((a) => a.value);\n    }\n  }\n}\n"]}
+{"version":3,"file":"askParallelDEPRECATED.js","sourceRoot":"","sources":["../../../../src/actions/system/askParallelDEPRECATED.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,SAAS,CAAC,CAAC,qBAAqB,CAAC,OAAmB;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,MAAM,GAAe,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAErD,OAAO,IAAI,EAAE,CAAC;QACZ,mDAAmD;QACnD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEtE,+EAA+E;QAC/E,8EAA8E;QAC9E,uEAAuE;QACvE,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAE7D,kDAAkD;QAClD,8EAA8E;QAC9E,IAAI,cAAc,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAEvD,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACrB,IAAI,GAAG,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["// NOTE: System actions have no platform specific processors and/or requestors\n// and therefore do not need to implement a SystemActionProcessor.ts\n\nimport { AskResponse } from '../../types/StorySession';\nimport { askBatch } from './askBatch';\n\n/**\n * @deprecated since version X.X. Please use {@link askRunParallel} instead.\n * Runs n number of stories in parallel. This function is deprecated and has been replaced\n * by a more efficient and type-supported version. The replacement function provides\n * improved performance and better type support.\n *\n * @param {Array<any>} stories - An array of stories to be run in parallel.\n * @returns {AskResponse<any[]>} The result of each story, in the order they were given.\n */\nexport function* askParallelDEPRECATED(stories: Array<any>): AskResponse<any[]> {\n  const itt = stories.map((s: any) => s[0](...s.slice(1)));\n  const actions = itt.map((i: any) => i.next());\n  let values: Array<any> = actions.map((a) => a.value);\n\n  while (true) {\n    // Batch any actions that we have not processed yet\n    const actionsToBatch = actions.map((a) => (!a.done ? a.value : null));\n\n    // Only send the still-pending actions to the runtime: a story that has already\n    // finished leaves a null hole, and a null action crashes the batch processor.\n    // Results are scattered back into their original positions afterwards.\n    const pendingActions = actionsToBatch.filter((atb) => !!atb);\n\n    // Only batch actions when there are some to batch\n    // People may batch stories together that actually dont have actions in them!?\n    if (pendingActions.length) {\n      const pendingResults = yield* askBatch(pendingActions);\n\n      let pendingIndex = 0;\n      values = actionsToBatch.map((atb) => (atb ? pendingResults[pendingIndex++] : undefined));\n    }\n\n    // Calculate real values\n    let done = true;\n    for (let i = 0; i < stories.length; i++) {\n      if (!actions[i].done) {\n        actions[i] = itt[i].next(values[i]);\n        if (!actions[i].done) {\n          done = false;\n        }\n      }\n    }\n\n    if (done) {\n      return actions.map((a) => a.value);\n    }\n  }\n}\n"]}

package/lib/esm/actions/system/askTraceStory.d.ts

@@ -1,12 +1,12 @@
 import { QpqExecutionTrace, StoryResult } from '../../types';
 import { SystemActionType } from './SystemActionType';
-export interface SystemTraceStoryActionPayload {
+export type SystemTraceStoryActionPayload = {
     storyResult: StoryResult<any>;
     scriptPatterns?: string[];
     onlyOwnCode?: boolean;
-}
-export declare const askTraceStory: import("../../types").ActionRequesterFunction<SystemActionType.TraceStory, [storyResult: StoryResult<any, any>, scriptPatterns?: string[] | undefined, onlyOwnCode?: boolean | undefined], {
-    storyResult: StoryResult<any, any>;
+};
+export declare const askTraceStory: import("../../types").ActionRequesterFunction<SystemActionType.TraceStory, [storyResult: StoryResult<any>, scriptPatterns?: string[] | undefined, onlyOwnCode?: boolean | undefined], {
+    storyResult: StoryResult<any>;
     scriptPatterns: string[] | undefined;
     onlyOwnCode: boolean | undefined;
-}, QpqExecutionTrace, never>;
+}, QpqExecutionTrace, "NotFound" | "BadRequest">;

package/lib/esm/actions/system/askTraceStory.js

@@ -1,7 +1,11 @@
-import { createActionRequester } from '../../types/utils/createActionRequester';
+import { createActionRequester } from '../../logic/actions/createActionRequester';
 import { SystemActionType } from './SystemActionType';
 export const askTraceStory = createActionRequester()({
     actionType: SystemActionType.TraceStory,
+    errorTypes: [
+        'BadRequest', // the story result carries no runtime info, so its code cannot be located
+        'NotFound', // the story's runtime could not be dynamically loaded
+    ],
     getPayload: (storyResult, scriptPatterns, onlyOwnCode) => ({ storyResult, scriptPatterns, onlyOwnCode }),
 });
 //# sourceMappingURL=askTraceStory.js.map

package/lib/esm/actions/system/askTraceStory.js.map

@@ -1 +1 @@
-{"version":3,"file":"askTraceStory.js","sourceRoot":"","sources":["../../../../src/actions/system/askTraceStory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAetD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,EAAqB,CAAC;IACtE,UAAU,EAAE,gBAAgB,CAAC,UAAU;IACvC,UAAU,EAAE,CAAC,WAA6B,EAAE,cAAyB,EAAE,WAAqB,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;CAChJ,CAAC,CAAC","sourcesContent":["import { QpqExecutionTrace, StoryResult } from '../../types';\nimport { createActionRequester } from '../../types/utils/createActionRequester';\nimport { SystemActionType } from './SystemActionType';\n\nexport interface SystemTraceStoryActionPayload {\n  storyResult: StoryResult<any>;\n\n  // Regex sources matched against script urls to trace in addition to the story\n  // function's own script (bundles split across chunks).\n  scriptPatterns?: string[];\n\n  // Only break on statements whose source-mapped origin is the service's own code —\n  // positions mapping into node_modules (framework/deps) get no breakpoints, so the\n  // step budget is spent entirely on user statements.\n  onlyOwnCode?: boolean;\n}\n\nexport const askTraceStory = createActionRequester<QpqExecutionTrace>()({\n  actionType: SystemActionType.TraceStory,\n  getPayload: (storyResult: StoryResult<any>, scriptPatterns?: string[], onlyOwnCode?: boolean) => ({ storyResult, scriptPatterns, onlyOwnCode }),\n});\n"]}
+{"version":3,"file":"askTraceStory.js","sourceRoot":"","sources":["../../../../src/actions/system/askTraceStory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAetD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,EAAqB,CAAC;IACtE,UAAU,EAAE,gBAAgB,CAAC,UAAU;IACvC,UAAU,EAAE;QACV,YAAY,EAAE,0EAA0E;QACxF,UAAU,EAAE,sDAAsD;KACnE;IACD,UAAU,EAAE,CAAC,WAA6B,EAAE,cAAyB,EAAE,WAAqB,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;CAChJ,CAAC,CAAC","sourcesContent":["import { createActionRequester } from '../../logic/actions/createActionRequester';\nimport { QpqExecutionTrace, StoryResult } from '../../types';\nimport { SystemActionType } from './SystemActionType';\n\nexport type SystemTraceStoryActionPayload = {\n  storyResult: StoryResult<any>;\n\n  // Regex sources matched against script urls to trace in addition to the story\n  // function's own script (bundles split across chunks).\n  scriptPatterns?: string[];\n\n  // Only break on statements whose source-mapped origin is the service's own code ,\n  // positions mapping into node_modules (framework/deps) get no breakpoints, so the\n  // step budget is spent entirely on user statements.\n  onlyOwnCode?: boolean;\n};\n\nexport const askTraceStory = createActionRequester<QpqExecutionTrace>()({\n  actionType: SystemActionType.TraceStory,\n  errorTypes: [\n    'BadRequest', // the story result carries no runtime info, so its code cannot be located\n    'NotFound', // the story's runtime could not be dynamically loaded\n  ],\n  getPayload: (storyResult: StoryResult<any>, scriptPatterns?: string[], onlyOwnCode?: boolean) => ({ storyResult, scriptPatterns, onlyOwnCode }),\n});\n"]}