quidproquo-core 0.0.263 → 0.1.0

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

@@ -0,0 +1,17 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * The approve/deny decision for a prior {@link AiStreamToolApprovalRequest}.
+ */
+export interface AiStreamToolApprovalResponse {
+    type: AiStreamPartType.ToolApprovalResponse;
+    /** Identifier of the approval request this response answers. */
+    approvalId: string;
+    /** Id of the underlying tool call the decision is for. */
+    toolCallId: string;
+    /** Name of the tool the decision is for. */
+    toolName: string;
+    /** Whether the tool call was approved. */
+    approved: boolean;
+    /** Optional reason for the approval or denial. */
+    reason?: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,16 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * A fully-formed tool call — the model finished producing arguments and they parsed cleanly.
+ *
+ * Execution still has to happen; a {@link AiStreamToolResult} or {@link AiStreamToolError}
+ * with the same `toolCallId` follows once it does.
+ */
+export interface AiStreamToolCall {
+    type: AiStreamPartType.ToolCall;
+    /** Unique id correlating this call with its later result / error / approval. */
+    toolCallId: string;
+    /** Name of the tool being invoked. */
+    toolName: string;
+    /** Parsed tool arguments (shape depends on the tool's schema). */
+    input: unknown;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,18 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * A tool threw while executing.
+ *
+ * `toolCallId` matches the originating {@link AiStreamToolCall}. The error is stringified
+ * into `message` so the part stays JSON-serializable.
+ */
+export interface AiStreamToolError {
+    type: AiStreamPartType.ToolError;
+    /** Id of the tool call that errored. */
+    toolCallId: string;
+    /** Name of the tool that threw. */
+    toolName: string;
+    /** The arguments the tool was called with. */
+    input: unknown;
+    /** Stringified error message. */
+    message: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,14 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * An incremental chunk of raw JSON arguments for an in-flight tool call.
+ *
+ * Concatenated deltas form partial-but-unparsed JSON — use only for previews. The fully
+ * parsed `input` arrives later on {@link AiStreamToolCall}.
+ */
+export interface AiStreamToolInputDelta {
+    type: AiStreamPartType.ToolInputDelta;
+    /** Identifier of the tool-argument stream this delta belongs to. */
+    id: string;
+    /** New JSON fragment to append. */
+    delta: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,11 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * The model has finished streaming arguments for a tool invocation.
+ *
+ * A {@link AiStreamToolCall} with the parsed arguments follows shortly.
+ */
+export interface AiStreamToolInputEnd {
+    type: AiStreamPartType.ToolInputEnd;
+    /** Identifier of the argument stream being closed. */
+    id: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,14 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * The model has started streaming the JSON arguments for a tool invocation.
+ *
+ * The fully-parsed call arrives later as {@link AiStreamToolCall}; use this if you want
+ * to show "preparing to call tool X…" before the arguments finish streaming.
+ */
+export interface AiStreamToolInputStart {
+    type: AiStreamPartType.ToolInputStart;
+    /** Identifier shared by the matching `ToolInputDelta` / `ToolInputEnd` parts. */
+    id: string;
+    /** Name of the tool the model intends to call. */
+    toolName: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,13 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * The caller denied executing a tool that the model requested via {@link AiStreamToolApprovalRequest}.
+ *
+ * The model will see the denial and continue without the tool's output.
+ */
+export interface AiStreamToolOutputDenied {
+    type: AiStreamPartType.ToolOutputDenied;
+    /** Id of the tool call that was denied. */
+    toolCallId: string;
+    /** Name of the tool that was denied. */
+    toolName: string;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,17 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * A tool finished executing successfully — the model will use `output` in its next step.
+ *
+ * `toolCallId` matches the originating {@link AiStreamToolCall}.
+ */
+export interface AiStreamToolResult {
+    type: AiStreamPartType.ToolResult;
+    /** Id of the tool call this result corresponds to. */
+    toolCallId: string;
+    /** Name of the tool that executed. */
+    toolName: string;
+    /** The arguments the tool was called with (echoed for convenience). */
+    input: unknown;
+    /** The tool's return value. */
+    output: unknown;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,14 @@
+/**
+ * Token usage reported by the model.
+ *
+ * Each field may be undefined if the underlying provider doesn't report it.
+ * `totalTokens` is the sum of input + output (plus any reasoning tokens, when applicable).
+ */
+export interface AiStreamUsage {
+    /** Prompt tokens consumed. */
+    inputTokens?: number;
+    /** Completion tokens produced. */
+    outputTokens?: number;
+    /** Total tokens — typically `inputTokens + outputTokens` (+ reasoning, when applicable). */
+    totalTokens?: number;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,31 @@
+export * from './AiStreamAbort';
+export * from './AiStreamCustom';
+export * from './AiStreamError';
+export * from './AiStreamFile';
+export * from './AiStreamFilePart';
+export * from './AiStreamFinish';
+export * from './AiStreamFinishStep';
+export * from './AiStreamPart';
+export * from './AiStreamPartType';
+export * from './AiStreamRaw';
+export * from './AiStreamReasoningDelta';
+export * from './AiStreamReasoningEnd';
+export * from './AiStreamReasoningFilePart';
+export * from './AiStreamReasoningStart';
+export * from './AiStreamSource';
+export * from './AiStreamSourcePart';
+export * from './AiStreamStart';
+export * from './AiStreamStartStep';
+export * from './AiStreamTextDelta';
+export * from './AiStreamTextEnd';
+export * from './AiStreamTextStart';
+export * from './AiStreamToolApprovalRequest';
+export * from './AiStreamToolApprovalResponse';
+export * from './AiStreamToolCall';
+export * from './AiStreamToolError';
+export * from './AiStreamToolInputDelta';
+export * from './AiStreamToolInputEnd';
+export * from './AiStreamToolInputStart';
+export * from './AiStreamToolOutputDenied';
+export * from './AiStreamToolResult';
+export * from './AiStreamUsage';

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

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AiStreamAbort"), exports);
+__exportStar(require("./AiStreamCustom"), exports);
+__exportStar(require("./AiStreamError"), exports);
+__exportStar(require("./AiStreamFile"), exports);
+__exportStar(require("./AiStreamFilePart"), exports);
+__exportStar(require("./AiStreamFinish"), exports);
+__exportStar(require("./AiStreamFinishStep"), exports);
+__exportStar(require("./AiStreamPart"), exports);
+__exportStar(require("./AiStreamPartType"), exports);
+__exportStar(require("./AiStreamRaw"), exports);
+__exportStar(require("./AiStreamReasoningDelta"), exports);
+__exportStar(require("./AiStreamReasoningEnd"), exports);
+__exportStar(require("./AiStreamReasoningFilePart"), exports);
+__exportStar(require("./AiStreamReasoningStart"), exports);
+__exportStar(require("./AiStreamSource"), exports);
+__exportStar(require("./AiStreamSourcePart"), exports);
+__exportStar(require("./AiStreamStart"), exports);
+__exportStar(require("./AiStreamStartStep"), exports);
+__exportStar(require("./AiStreamTextDelta"), exports);
+__exportStar(require("./AiStreamTextEnd"), exports);
+__exportStar(require("./AiStreamTextStart"), exports);
+__exportStar(require("./AiStreamToolApprovalRequest"), exports);
+__exportStar(require("./AiStreamToolApprovalResponse"), exports);
+__exportStar(require("./AiStreamToolCall"), exports);
+__exportStar(require("./AiStreamToolError"), exports);
+__exportStar(require("./AiStreamToolInputDelta"), exports);
+__exportStar(require("./AiStreamToolInputEnd"), exports);
+__exportStar(require("./AiStreamToolInputStart"), exports);
+__exportStar(require("./AiStreamToolOutputDenied"), exports);
+__exportStar(require("./AiStreamToolResult"), exports);
+__exportStar(require("./AiStreamUsage"), exports);

package/lib/commonjs/actions/claudeAi/ClaudeAiMessagesApiRequester.d.ts

@@ -1,3 +1,11 @@
 import Anthropic from '@anthropic-ai/sdk';
 import { ClaudeAiMessagesApiActionRequester } from './ClaudeAiMessagesApiActionTypes';
+export declare const ClaudeAiMessagesApiErrorTypeEnum: {
+    Unauthorized: string;
+    PermissionDenied: string;
+    InvalidRequest: string;
+    RateLimited: string;
+    ServerError: string;
+    ConnectionError: string;
+};
 export declare function askClaudeAiMessagesApi(body: Anthropic.Messages.MessageCreateParamsNonStreaming, apiKey: string): ClaudeAiMessagesApiActionRequester;

package/lib/commonjs/actions/claudeAi/ClaudeAiMessagesApiRequester.js

@@ -1,7 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeAiMessagesApiErrorTypeEnum = void 0;
 exports.askClaudeAiMessagesApi = askClaudeAiMessagesApi;
+const types_1 = require("../../types");
 const ClaudeAiActionType_1 = require("./ClaudeAiActionType");
+exports.ClaudeAiMessagesApiErrorTypeEnum = (0, types_1.createErrorEnumForAction)(ClaudeAiActionType_1.ClaudeAiActionType.MessagesApi, [
+    'Unauthorized', // the API key is missing or invalid (401)
+    'PermissionDenied', // the API key lacks permission for this request (403)
+    'InvalidRequest', // the request body was rejected as malformed or invalid (400 / 422)
+    'RateLimited', // the Anthropic API is rate limiting; the caller should back off and retry later (429)
+    'ServerError', // the Anthropic API returned a server error; a retry may succeed (5xx)
+    'ConnectionError', // could not reach the Anthropic API (network failure or timeout)
+]);
 function* askClaudeAiMessagesApi(body, apiKey) {
     return yield {
         type: ClaudeAiActionType_1.ClaudeAiActionType.MessagesApi,

package/lib/commonjs/actions/config/ConfigGetSecretActionRequester.d.ts

@@ -1,2 +1,6 @@
 import { ConfigGetSecretActionRequester } from './ConfigGetSecretActionTypes';
+export declare const ConfigGetSecretErrorTypeEnum: {
+    Throttling: string;
+    ResourceNotFound: string;
+};
 export declare function askConfigGetSecret(secretName: string): ConfigGetSecretActionRequester;

package/lib/commonjs/actions/config/ConfigGetSecretActionRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigGetSecretErrorTypeEnum = void 0;
 exports.askConfigGetSecret = askConfigGetSecret;
+const types_1 = require("../../types");
 const ConfigActionType_1 = require("./ConfigActionType");
+exports.ConfigGetSecretErrorTypeEnum = (0, types_1.createErrorEnumForAction)(ConfigActionType_1.ConfigActionType.GetSecret, [
+    'ResourceNotFound', // secret does not exist
+    'Throttling', // request rate exceeded
+]);
 function* askConfigGetSecret(secretName) {
     return yield { type: ConfigActionType_1.ConfigActionType.GetSecret, payload: { secretName } };
 }

package/lib/commonjs/actions/config/ConfigSetParameterActionRequester.d.ts

@@ -1,2 +1,6 @@
 import { ConfigSetParameterActionRequester } from './ConfigSetParameterActionTypes';
+export declare const ConfigSetParameterErrorTypeEnum: {
+    Throttling: string;
+    QuotaExceeded: string;
+};
 export declare function askConfigSetParameter(parameterName: string, parameterValue: string): ConfigSetParameterActionRequester;

package/lib/commonjs/actions/config/ConfigSetParameterActionRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigSetParameterErrorTypeEnum = void 0;
 exports.askConfigSetParameter = askConfigSetParameter;
+const types_1 = require("../../types");
 const ConfigActionType_1 = require("./ConfigActionType");
+exports.ConfigSetParameterErrorTypeEnum = (0, types_1.createErrorEnumForAction)(ConfigActionType_1.ConfigActionType.SetParameter, [
+    'Throttling', // request rate exceeded
+    'QuotaExceeded', // parameter store / storage limit hit
+]);
 function* askConfigSetParameter(parameterName, parameterValue) {
     return yield {
         type: ConfigActionType_1.ConfigActionType.SetParameter,

package/lib/commonjs/actions/eventBus/EventBusSendMessageActionRequester.d.ts

@@ -1,2 +1,7 @@
 import { EventBusSendMessageActionRequester, EventBusSendMessageOptions } from './EventBusSendMessageActionTypes';
+export declare const EventBusSendMessagesErrorTypeEnum: {
+    AccessDenied: string;
+    TopicNotFound: string;
+    ServiceUnavailable: string;
+};
 export declare function askEventBusSendMessages<T>(eventBusSendMessageOptions: EventBusSendMessageOptions<T>): EventBusSendMessageActionRequester<T>;

package/lib/commonjs/actions/eventBus/EventBusSendMessageActionRequester.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventBusSendMessagesErrorTypeEnum = void 0;
 exports.askEventBusSendMessages = askEventBusSendMessages;
+const types_1 = require("../../types");
 const EventBusActionType_1 = require("./EventBusActionType");
+exports.EventBusSendMessagesErrorTypeEnum = (0, types_1.createErrorEnumForAction)(EventBusActionType_1.EventBusActionType.SendMessages, [
+    'AccessDenied', // caller lacks permission to publish to the topic
+    'TopicNotFound', // the SNS topic does not exist
+    'ServiceUnavailable', // SNS internal error / throttling
+]);
 function* askEventBusSendMessages(eventBusSendMessageOptions) {
     yield {
         type: EventBusActionType_1.EventBusActionType.SendMessages,

package/lib/commonjs/actions/file/FileDeleteActionRequester.d.ts

@@ -1,2 +1,6 @@
 import { FileDeleteActionRequester } from './FileDeleteActionTypes';
+export declare const FileDeleteErrorTypeEnum: {
+    AccessDenied: string;
+    DriveNotFound: string;
+};
 export declare function askFileDelete(drive: string, filepaths: string[]): FileDeleteActionRequester;

package/lib/commonjs/actions/file/FileDeleteActionRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileDeleteErrorTypeEnum = void 0;
 exports.askFileDelete = askFileDelete;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileDeleteErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.Delete, [
+    'AccessDenied', // caller lacks permission to delete
+    'DriveNotFound', // storage drive does not exist
+]);
 function* askFileDelete(drive, filepaths) {
     return yield {
         type: FileActionType_1.FileActionType.Delete,

package/lib/commonjs/actions/file/FileExistsActionRequester.d.ts

@@ -1,2 +1,5 @@
 import { FileExistsActionRequester } from './FileExistsActionTypes';
+export declare const FileExistsErrorTypeEnum: {
+    AccessDenied: string;
+};
 export declare function askFileExists(drive: string, filepath: string): FileExistsActionRequester;

package/lib/commonjs/actions/file/FileExistsActionRequester.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileExistsErrorTypeEnum = void 0;
 exports.askFileExists = askFileExists;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileExistsErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.Exists, [
+    'AccessDenied', // caller lacks permission to check existence
+]);
 function* askFileExists(drive, filepath) {
     return yield {
         type: FileActionType_1.FileActionType.Exists,

package/lib/commonjs/actions/file/FileGenerateTemporarySecureUrlActionRequester.d.ts

@@ -1,2 +1,5 @@
 import { FileGenerateTemporarySecureUrlActionRequester } from './FileGenerateTemporarySecureUrlActionTypes';
+export declare const FileGenerateTemporarySecureUrlErrorTypeEnum: {
+    ExpirationTooLong: string;
+};
 export declare function askFileGenerateTemporarySecureUrl(drive: string, filepath: string, expirationMs: number): FileGenerateTemporarySecureUrlActionRequester;

package/lib/commonjs/actions/file/FileGenerateTemporarySecureUrlActionRequester.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileGenerateTemporarySecureUrlErrorTypeEnum = void 0;
 exports.askFileGenerateTemporarySecureUrl = askFileGenerateTemporarySecureUrl;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileGenerateTemporarySecureUrlErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.GenerateTemporarySecureUrl, [
+    'ExpirationTooLong', // requested expiry exceeds max length of time possible
+]);
 function* askFileGenerateTemporarySecureUrl(drive, filepath, expirationMs) {
     return yield {
         type: FileActionType_1.FileActionType.GenerateTemporarySecureUrl,

package/lib/commonjs/actions/file/FileGenerateTemporaryUploadSecureUrlActionRequester.d.ts

@@ -1,4 +1,7 @@
 import { FileGenerateTemporaryUploadSecureUrlActionPayload, FileGenerateTemporaryUploadSecureUrlActionRequester } from './FileGenerateTemporaryUploadSecureUrlActionTypes';
+export declare const FileGenerateTemporaryUploadSecureUrlErrorTypeEnum: {
+    ExpirationTooLong: string;
+};
 export declare function askFileGenerateTemporaryUploadSecureUrl(drive: string, filepath: string, expirationMs: number, advancedOptions?: {
     contentType?: FileGenerateTemporaryUploadSecureUrlActionPayload['contentType'];
 }): FileGenerateTemporaryUploadSecureUrlActionRequester;

package/lib/commonjs/actions/file/FileGenerateTemporaryUploadSecureUrlActionRequester.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileGenerateTemporaryUploadSecureUrlErrorTypeEnum = void 0;
 exports.askFileGenerateTemporaryUploadSecureUrl = askFileGenerateTemporaryUploadSecureUrl;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileGenerateTemporaryUploadSecureUrlErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.GenerateTemporaryUploadSecureUrl, [
+    'ExpirationTooLong', // requested expiry exceeds max length of time possible
+]);
 function* askFileGenerateTemporaryUploadSecureUrl(drive, filepath, expirationMs, advancedOptions) {
     return yield {
         type: FileActionType_1.FileActionType.GenerateTemporaryUploadSecureUrl,

package/lib/commonjs/actions/file/FileIsColdStorageActionRequester.d.ts

@@ -1,2 +1,7 @@
 import { FileIsColdStorageActionRequester } from './FileIsColdStorageActionTypes';
+export declare const FileIsColdStorageErrorTypeEnum: {
+    AccessDenied: string;
+    DriveNotFound: string;
+    FileNotFound: string;
+};
 export declare function askFileIsColdStorage(drive: string, filepath: string): FileIsColdStorageActionRequester;

package/lib/commonjs/actions/file/FileIsColdStorageActionRequester.js

@@ -1,7 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileIsColdStorageErrorTypeEnum = void 0;
 exports.askFileIsColdStorage = askFileIsColdStorage;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileIsColdStorageErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.IsColdStorage, [
+    'AccessDenied', // caller lacks permission to read the object metadata
+    'FileNotFound', // no object exists at the given filepath
+    'DriveNotFound', // storage drive does not exist
+]);
 function* askFileIsColdStorage(drive, filepath) {
     return yield {
         type: FileActionType_1.FileActionType.IsColdStorage,

package/lib/commonjs/actions/file/FileListDirectoryActionRequester.d.ts

@@ -1,5 +1,11 @@
 import { AskResponse } from '../../types/StorySession';
 import { FileInfo } from './FileActionType';
 import { FileListDirectoryActionRequester } from './FileListDirectoryActionTypes';
+export declare const FileListDirectoryErrorTypeEnum: {
+    AccessDenied: string;
+    DriveNotFound: string;
+    DirectoryNotFound: string;
+    NotADirectory: string;
+};
 export declare function askFileListDirectory(drive: string, folderPath: string, maxFiles?: number, pageToken?: string): FileListDirectoryActionRequester;
 export declare function askFileListAllDirectory(drive: string, folderPath: string): AskResponse<FileInfo[]>;

package/lib/commonjs/actions/file/FileListDirectoryActionRequester.js

@@ -1,8 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileListDirectoryErrorTypeEnum = void 0;
 exports.askFileListDirectory = askFileListDirectory;
 exports.askFileListAllDirectory = askFileListAllDirectory;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileListDirectoryErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.ListDirectory, [
+    'AccessDenied', // caller lacks permission to list the directory
+    'DirectoryNotFound', // no directory exists at the given folderPath
+    'NotADirectory', // the folderPath points at a file, not a directory
+    'DriveNotFound', // storage drive does not exist
+]);
 function* askFileListDirectory(drive, folderPath, maxFiles = 1000, pageToken) {
     return yield {
         type: FileActionType_1.FileActionType.ListDirectory,

package/lib/commonjs/actions/file/FileReadBinaryContentsActionRequester.d.ts

@@ -1,2 +1,6 @@
 import { FileReadBinaryContentsActionRequester } from './FileReadBinaryContentsActionTypes';
+export declare const FileReadBinaryContentsErrorTypeEnum: {
+    FileNotFound: string;
+    InvalidStorageClass: string;
+};
 export declare function askFileReadBinaryContents(drive: string, filepath: string): FileReadBinaryContentsActionRequester;

package/lib/commonjs/actions/file/FileReadBinaryContentsActionRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileReadBinaryContentsErrorTypeEnum = void 0;
 exports.askFileReadBinaryContents = askFileReadBinaryContents;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileReadBinaryContentsErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.ReadBinaryContents, [
+    'InvalidStorageClass', // object is in cold storage and cannot be read directly
+    'FileNotFound', // no object exists at the given filepath
+]);
 function* askFileReadBinaryContents(drive, filepath) {
     return yield {
         type: FileActionType_1.FileActionType.ReadBinaryContents,

package/lib/commonjs/actions/file/FileStreamOpenRequester.d.ts

@@ -1,3 +1,7 @@
 import { StreamEncoding } from '../../types/StreamRegistry';
 import { FileStreamOpenActionRequester } from './FileStreamOpenActionTypes';
+export declare const FileStreamOpenErrorTypeEnum: {
+    FileNotFound: string;
+    InvalidStorageClass: string;
+};
 export declare function askFileStreamOpen<E extends StreamEncoding = 'text'>(drive: string, filepath: string, encoding?: E, chunkSize?: number): FileStreamOpenActionRequester<E>;

package/lib/commonjs/actions/file/FileStreamOpenRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStreamOpenErrorTypeEnum = void 0;
 exports.askFileStreamOpen = askFileStreamOpen;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileStreamOpenErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.StreamOpen, [
+    'InvalidStorageClass', // object is in cold storage and cannot be streamed directly
+    'FileNotFound', // no object exists at the given filepath
+]);
 function* askFileStreamOpen(drive, filepath, encoding = 'text', chunkSize) {
     return yield {
         type: FileActionType_1.FileActionType.StreamOpen,

package/lib/commonjs/actions/file/FileWriteBinaryContentsActionRequester.d.ts

@@ -1,4 +1,8 @@
 import { QPQBinaryData } from '../../types/QPQBinaryData';
 import { StorageDriveAdvancedWriteOptions } from './FileActionType';
 import { FileWriteBinaryContentsActionRequester } from './FileWriteBinaryContentsActionTypes';
+export declare const FileWriteBinaryContentsErrorTypeEnum: {
+    AccessDenied: string;
+    DriveNotFound: string;
+};
 export declare function askFileWriteBinaryContents(drive: string, filepath: string, data: QPQBinaryData, storageDriveAdvancedWriteOptions?: StorageDriveAdvancedWriteOptions): FileWriteBinaryContentsActionRequester;

package/lib/commonjs/actions/file/FileWriteBinaryContentsActionRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileWriteBinaryContentsErrorTypeEnum = void 0;
 exports.askFileWriteBinaryContents = askFileWriteBinaryContents;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileWriteBinaryContentsErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.WriteBinaryContents, [
+    'AccessDenied', // caller lacks permission to write the file
+    'DriveNotFound', // storage drive does not exist
+]);
 function* askFileWriteBinaryContents(drive, filepath, data, storageDriveAdvancedWriteOptions) {
     return yield {
         type: FileActionType_1.FileActionType.WriteBinaryContents,

package/lib/commonjs/actions/file/FileWriteObjectJsonActionRequester.d.ts

@@ -1,3 +1,7 @@
 import { StorageDriveAdvancedWriteOptions } from './FileActionType';
 import { FileWriteObjectJsonActionRequester } from './FileWriteObjectJsonActionTypes';
+export declare const FileWriteObjectJsonErrorTypeEnum: {
+    AccessDenied: string;
+    DriveNotFound: string;
+};
 export declare function askFileWriteObjectJson<T extends object>(drive: string, filepath: string, data: T, storageDriveAdvancedWriteOptions?: StorageDriveAdvancedWriteOptions): FileWriteObjectJsonActionRequester<T>;

package/lib/commonjs/actions/file/FileWriteObjectJsonActionRequester.js

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileWriteObjectJsonErrorTypeEnum = void 0;
 exports.askFileWriteObjectJson = askFileWriteObjectJson;
+const types_1 = require("../../types");
 const FileActionType_1 = require("./FileActionType");
+exports.FileWriteObjectJsonErrorTypeEnum = (0, types_1.createErrorEnumForAction)(FileActionType_1.FileActionType.WriteObjectJson, [
+    'AccessDenied', // caller lacks permission to write the file
+    'DriveNotFound', // storage drive does not exist
+]);
 function* askFileWriteObjectJson(drive, filepath, data, storageDriveAdvancedWriteOptions) {
     return yield {
         type: FileActionType_1.FileActionType.WriteObjectJson,

package/lib/commonjs/actions/file/FileWriteTextContentsActionRequester.d.ts

@@ -1,3 +1,7 @@
 import { StorageDriveAdvancedWriteOptions } from './FileActionType';
 import { FileWriteTextContentsActionRequester } from './FileWriteTextContentsActionTypes';
+export declare const FileWriteTextContentsErrorTypeEnum: {
+    AccessDenied: string;
+    DriveNotFound: string;
+};
 export declare function askFileWriteTextContents(drive: string, filepath: string, data: string, storageDriveAdvancedWriteOptions?: StorageDriveAdvancedWriteOptions): FileWriteTextContentsActionRequester;