quidproquo-core 0.0.262 → 0.1.0

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

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

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiActionType = void 0;
+var AiActionType;
+(function (AiActionType) {
+    AiActionType["Prompt"] = "@quidproquo-core/Ai/Prompt";
+    AiActionType["PromptStream"] = "@quidproquo-core/Ai/PromptStream";
+})(AiActionType || (exports.AiActionType = AiActionType = {}));

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

@@ -0,0 +1,43 @@
+export interface AiTextPart {
+    type: 'text';
+    text: string;
+}
+export interface AiFilePart {
+    type: 'file';
+    url: string;
+    mediaType: string;
+    filename?: string;
+}
+export interface AiToolCallPart {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+}
+export interface AiReasoningPart {
+    type: 'reasoning';
+    text: string;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+export interface AiToolResultPart {
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+    isError?: boolean;
+}
+export type AiUserMessagePart = AiTextPart | AiFilePart;
+export type AiAssistantMessagePart = AiTextPart | AiFilePart | AiToolCallPart | AiReasoningPart;
+export type AiUserMessage = {
+    role: 'user';
+    content: string | AiUserMessagePart[];
+};
+export type AiAssistantMessage = {
+    role: 'assistant';
+    content: string | AiAssistantMessagePart[];
+};
+export type AiToolMessage = {
+    role: 'tool';
+    content: AiToolResultPart[];
+};
+export type AiMessage = AiUserMessage | AiAssistantMessage | AiToolMessage;

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

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

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

@@ -0,0 +1,11 @@
+export declare enum AiModel {
+    ClaudeHaiku35 = "claude-3-5-haiku",
+    ClaudeSonnet35 = "claude-3-5-sonnet",
+    ClaudeSonnet4 = "claude-sonnet-4",
+    ClaudeOpus4 = "claude-opus-4",
+    ClaudeHaiku45 = "claude-haiku-4-5",
+    ClaudeSonnet45 = "claude-sonnet-4-5",
+    ClaudeOpus45 = "claude-opus-4-5",
+    ClaudeSonnet46 = "claude-sonnet-4-6",
+    ClaudeOpus46 = "claude-opus-4-6"
+}

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiModel = void 0;
+var AiModel;
+(function (AiModel) {
+    AiModel["ClaudeHaiku35"] = "claude-3-5-haiku";
+    AiModel["ClaudeSonnet35"] = "claude-3-5-sonnet";
+    AiModel["ClaudeSonnet4"] = "claude-sonnet-4";
+    AiModel["ClaudeOpus4"] = "claude-opus-4";
+    AiModel["ClaudeHaiku45"] = "claude-haiku-4-5";
+    AiModel["ClaudeSonnet45"] = "claude-sonnet-4-5";
+    AiModel["ClaudeOpus45"] = "claude-opus-4-5";
+    AiModel["ClaudeSonnet46"] = "claude-sonnet-4-6";
+    AiModel["ClaudeOpus46"] = "claude-opus-4-6";
+})(AiModel || (exports.AiModel = AiModel = {}));

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

@@ -0,0 +1,9 @@
+import { AiMessage } from './AiMessage';
+import { AiModel } from './AiModel';
+import { AiPromptActionRequester } from './AiPromptActionTypes';
+export interface AskAiPromptOptions {
+    system?: string;
+    aiName?: string;
+    messages?: AiMessage[];
+}
+export declare function askAiPrompt(model: AiModel, prompt: string, options?: AskAiPromptOptions): AiPromptActionRequester;

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askAiPrompt = askAiPrompt;
+const AiActionType_1 = require("./AiActionType");
+function* askAiPrompt(model, prompt, options) {
+    return yield {
+        type: AiActionType_1.AiActionType.Prompt,
+        payload: {
+            model,
+            prompt,
+            messages: options === null || options === void 0 ? void 0 : options.messages,
+            system: options === null || options === void 0 ? void 0 : options.system,
+            aiName: options === null || options === void 0 ? void 0 : options.aiName,
+        },
+    };
+}

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

@@ -0,0 +1,20 @@
+import { Action, ActionProcessor, ActionRequester } from '../../types/Action';
+import { AiActionType } from './AiActionType';
+import { AiMessage } from './AiMessage';
+import { AiModel } from './AiModel';
+export interface AiPromptActionPayload {
+    model: AiModel;
+    prompt: string;
+    messages?: AiMessage[];
+    system?: string;
+    aiName?: string;
+}
+export interface AiPromptActionResult {
+    text: string;
+}
+export interface AiPromptAction extends Action<AiPromptActionPayload> {
+    type: AiActionType.Prompt;
+    payload: AiPromptActionPayload;
+}
+export type AiPromptActionProcessor = ActionProcessor<AiPromptAction, AiPromptActionResult>;
+export type AiPromptActionRequester = ActionRequester<AiPromptAction, AiPromptActionResult>;

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

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

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

@@ -0,0 +1,9 @@
+import { AiMessage } from './AiMessage';
+import { AiModel } from './AiModel';
+import { AiPromptStreamActionRequester } from './AiPromptStreamActionTypes';
+export interface AskAiPromptStreamOptions {
+    system?: string;
+    aiName?: string;
+    messages?: AiMessage[];
+}
+export declare function askAiPromptStream(model: AiModel, prompt: string, options?: AskAiPromptStreamOptions): AiPromptStreamActionRequester;

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askAiPromptStream = askAiPromptStream;
+const AiActionType_1 = require("./AiActionType");
+function* askAiPromptStream(model, prompt, options) {
+    return yield {
+        type: AiActionType_1.AiActionType.PromptStream,
+        payload: {
+            model,
+            prompt,
+            messages: options === null || options === void 0 ? void 0 : options.messages,
+            system: options === null || options === void 0 ? void 0 : options.system,
+            aiName: options === null || options === void 0 ? void 0 : options.aiName,
+        },
+    };
+}

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

@@ -0,0 +1,19 @@
+import { Action, ActionProcessor, ActionRequester } from '../../types/Action';
+import { StreamHandle } from '../../types/StreamRegistry';
+import { AiActionType } from './AiActionType';
+import { AiMessage } from './AiMessage';
+import { AiModel } from './AiModel';
+import { AiStreamPart } from './types';
+export interface AiPromptStreamActionPayload {
+    model: AiModel;
+    prompt: string;
+    messages?: AiMessage[];
+    system?: string;
+    aiName?: string;
+}
+export interface AiPromptStreamAction extends Action<AiPromptStreamActionPayload> {
+    type: AiActionType.PromptStream;
+    payload: AiPromptStreamActionPayload;
+}
+export type AiPromptStreamActionProcessor = ActionProcessor<AiPromptStreamAction, StreamHandle<'json'>>;
+export type AiPromptStreamActionRequester = ActionRequester<AiPromptStreamAction, StreamHandle<'json', AiStreamPart>>;

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

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

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

@@ -0,0 +1,8 @@
+export * from './AiActionType';
+export * from './AiMessage';
+export * from './AiModel';
+export * from './AiPromptActionRequester';
+export * from './AiPromptActionTypes';
+export * from './AiPromptStreamActionRequester';
+export * from './AiPromptStreamActionTypes';
+export * from './types';

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

@@ -0,0 +1,24 @@
+"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("./AiActionType"), exports);
+__exportStar(require("./AiMessage"), exports);
+__exportStar(require("./AiModel"), exports);
+__exportStar(require("./AiPromptActionRequester"), exports);
+__exportStar(require("./AiPromptActionTypes"), exports);
+__exportStar(require("./AiPromptStreamActionRequester"), exports);
+__exportStar(require("./AiPromptStreamActionTypes"), exports);
+__exportStar(require("./types"), exports);

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,12 @@
+/**
+ * A file artifact produced by the model (e.g. a generated image).
+ *
+ * The binary payload is delivered as base64 so the part can travel across
+ * the JSON-encoded stream. Decode with `mediaType` to interpret the bytes.
+ */
+export interface AiStreamFile {
+    /** File contents, base64-encoded. */
+    base64: string;
+    /** IANA media type — e.g. `'image/png'`. */
+    mediaType: string;
+}

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

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

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

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

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

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

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

@@ -0,0 +1,13 @@
+import { AiStreamPartType } from './AiStreamPartType';
+import { AiStreamUsage } from './AiStreamUsage';
+/**
+ * Emitted once at the very end of the response with the aggregate finish reason and total usage
+ * across every step. Use this (not `FinishStep`) for end-of-response accounting.
+ */
+export interface AiStreamFinish {
+    type: AiStreamPartType.Finish;
+    /** Why the model stopped — e.g. `'stop'`, `'length'`, `'tool-calls'`. */
+    finishReason: string;
+    /** Aggregate token usage across all steps. */
+    usage: AiStreamUsage;
+}

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

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

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

@@ -0,0 +1,14 @@
+import { AiStreamPartType } from './AiStreamPartType';
+import { AiStreamUsage } from './AiStreamUsage';
+/**
+ * The current generation step ended.
+ *
+ * For total-response accounting use {@link AiStreamFinish}; this carries the per-step slice only.
+ */
+export interface AiStreamFinishStep {
+    type: AiStreamPartType.FinishStep;
+    /** Why this step stopped — e.g. `'tool-calls'` between steps, `'stop'` on the final step. */
+    finishReason: string;
+    /** Token usage for this step only. */
+    usage: AiStreamUsage;
+}

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

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

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

@@ -0,0 +1,32 @@
+import { AiStreamAbort } from './AiStreamAbort';
+import { AiStreamCustom } from './AiStreamCustom';
+import { AiStreamError } from './AiStreamError';
+import { AiStreamFilePart } from './AiStreamFilePart';
+import { AiStreamFinish } from './AiStreamFinish';
+import { AiStreamFinishStep } from './AiStreamFinishStep';
+import { AiStreamRaw } from './AiStreamRaw';
+import { AiStreamReasoningDelta } from './AiStreamReasoningDelta';
+import { AiStreamReasoningEnd } from './AiStreamReasoningEnd';
+import { AiStreamReasoningFilePart } from './AiStreamReasoningFilePart';
+import { AiStreamReasoningStart } from './AiStreamReasoningStart';
+import { AiStreamSourcePart } from './AiStreamSourcePart';
+import { AiStreamStart } from './AiStreamStart';
+import { AiStreamStartStep } from './AiStreamStartStep';
+import { AiStreamTextDelta } from './AiStreamTextDelta';
+import { AiStreamTextEnd } from './AiStreamTextEnd';
+import { AiStreamTextStart } from './AiStreamTextStart';
+import { AiStreamToolApprovalRequest } from './AiStreamToolApprovalRequest';
+import { AiStreamToolApprovalResponse } from './AiStreamToolApprovalResponse';
+import { AiStreamToolCall } from './AiStreamToolCall';
+import { AiStreamToolError } from './AiStreamToolError';
+import { AiStreamToolInputDelta } from './AiStreamToolInputDelta';
+import { AiStreamToolInputEnd } from './AiStreamToolInputEnd';
+import { AiStreamToolInputStart } from './AiStreamToolInputStart';
+import { AiStreamToolOutputDenied } from './AiStreamToolOutputDenied';
+import { AiStreamToolResult } from './AiStreamToolResult';
+/**
+ * Discriminated union of every event that can be emitted from an AI prompt stream.
+ *
+ * Narrow on `type` (an {@link AiStreamPartType} value) to access the per-variant fields.
+ */
+export type AiStreamPart = AiStreamStart | AiStreamFinish | AiStreamStartStep | AiStreamFinishStep | AiStreamAbort | AiStreamError | AiStreamRaw | AiStreamSourcePart | AiStreamFilePart | AiStreamReasoningFilePart | AiStreamCustom | AiStreamTextStart | AiStreamTextEnd | AiStreamTextDelta | AiStreamReasoningStart | AiStreamReasoningEnd | AiStreamReasoningDelta | AiStreamToolInputStart | AiStreamToolInputEnd | AiStreamToolInputDelta | AiStreamToolCall | AiStreamToolResult | AiStreamToolError | AiStreamToolOutputDenied | AiStreamToolApprovalRequest | AiStreamToolApprovalResponse;

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

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

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

@@ -0,0 +1,63 @@
+/**
+ * Discriminator for every part that can appear in an AI prompt stream.
+ *
+ * Lifecycle order, broadly:
+ *   Start → (StartStep → step events → FinishStep)+ → Finish
+ *
+ * Within a step, text / reasoning / tool-input events come in matched
+ * start → delta… → end triples sharing the same `id`.
+ */
+export declare enum AiStreamPartType {
+    /** Emitted once before any other parts — the overall response is starting. */
+    Start = "start",
+    /** Emitted once at the very end — overall response is complete, with aggregate usage. */
+    Finish = "finish",
+    /** A single generation step (one round-trip to the model) has started. */
+    StartStep = "start-step",
+    /** The current generation step ended, with the step's finish reason and usage. */
+    FinishStep = "finish-step",
+    /** The stream was aborted (e.g. abort signal, client disconnect). */
+    Abort = "abort",
+    /** A non-fatal streaming error. `streamText` swallows errors by default; this surfaces them. */
+    Error = "error",
+    /** A provider-specific raw chunk — passed through for debugging or custom handling. */
+    Raw = "raw",
+    /** The model cited a source (URL or document) — used for grounded / RAG-style responses. */
+    Source = "source",
+    /** The model produced a file artifact (e.g. generated image). */
+    File = "file",
+    /** The model produced a reasoning file artifact (e.g. an encrypted reasoning trace). */
+    ReasoningFile = "reasoning-file",
+    /** A provider-specific custom event — identified by `kind`, with no higher-level mapping. */
+    Custom = "custom",
+    /** Beginning of a contiguous text block. Pair with `TextEnd` via shared `id`. */
+    TextStart = "text-start",
+    /** End of the text block opened by a matching `TextStart`. */
+    TextEnd = "text-end",
+    /** An incremental chunk of text inside the currently open text block. */
+    TextDelta = "text-delta",
+    /** Beginning of a model reasoning / "thinking" block (extended-thinking models). */
+    ReasoningStart = "reasoning-start",
+    /** End of the reasoning block opened by a matching `ReasoningStart`. */
+    ReasoningEnd = "reasoning-end",
+    /** An incremental chunk of reasoning text inside the currently open reasoning block. */
+    ReasoningDelta = "reasoning-delta",
+    /** The model has begun streaming arguments for a tool call. */
+    ToolInputStart = "tool-input-start",
+    /** The model has finished streaming arguments for the tool call. */
+    ToolInputEnd = "tool-input-end",
+    /** An incremental chunk of the (JSON) tool-call arguments. */
+    ToolInputDelta = "tool-input-delta",
+    /** A fully-assembled tool call — arguments are complete and parsed. */
+    ToolCall = "tool-call",
+    /** A tool finished executing successfully. Includes the original `input` and the `output`. */
+    ToolResult = "tool-result",
+    /** A tool threw while executing. `message` carries the stringified error. */
+    ToolError = "tool-error",
+    /** The caller denied executing the tool after an approval request. */
+    ToolOutputDenied = "tool-output-denied",
+    /** The model is requesting permission to execute a tool — awaiting approve/deny. */
+    ToolApprovalRequest = "tool-approval-request",
+    /** The approve/deny decision for a prior {@link ToolApprovalRequest}. */
+    ToolApprovalResponse = "tool-approval-response"
+}

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

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiStreamPartType = void 0;
+/**
+ * Discriminator for every part that can appear in an AI prompt stream.
+ *
+ * Lifecycle order, broadly:
+ *   Start → (StartStep → step events → FinishStep)+ → Finish
+ *
+ * Within a step, text / reasoning / tool-input events come in matched
+ * start → delta… → end triples sharing the same `id`.
+ */
+var AiStreamPartType;
+(function (AiStreamPartType) {
+    /** Emitted once before any other parts — the overall response is starting. */
+    AiStreamPartType["Start"] = "start";
+    /** Emitted once at the very end — overall response is complete, with aggregate usage. */
+    AiStreamPartType["Finish"] = "finish";
+    /** A single generation step (one round-trip to the model) has started. */
+    AiStreamPartType["StartStep"] = "start-step";
+    /** The current generation step ended, with the step's finish reason and usage. */
+    AiStreamPartType["FinishStep"] = "finish-step";
+    /** The stream was aborted (e.g. abort signal, client disconnect). */
+    AiStreamPartType["Abort"] = "abort";
+    /** A non-fatal streaming error. `streamText` swallows errors by default; this surfaces them. */
+    AiStreamPartType["Error"] = "error";
+    /** A provider-specific raw chunk — passed through for debugging or custom handling. */
+    AiStreamPartType["Raw"] = "raw";
+    /** The model cited a source (URL or document) — used for grounded / RAG-style responses. */
+    AiStreamPartType["Source"] = "source";
+    /** The model produced a file artifact (e.g. generated image). */
+    AiStreamPartType["File"] = "file";
+    /** The model produced a reasoning file artifact (e.g. an encrypted reasoning trace). */
+    AiStreamPartType["ReasoningFile"] = "reasoning-file";
+    /** A provider-specific custom event — identified by `kind`, with no higher-level mapping. */
+    AiStreamPartType["Custom"] = "custom";
+    /** Beginning of a contiguous text block. Pair with `TextEnd` via shared `id`. */
+    AiStreamPartType["TextStart"] = "text-start";
+    /** End of the text block opened by a matching `TextStart`. */
+    AiStreamPartType["TextEnd"] = "text-end";
+    /** An incremental chunk of text inside the currently open text block. */
+    AiStreamPartType["TextDelta"] = "text-delta";
+    /** Beginning of a model reasoning / "thinking" block (extended-thinking models). */
+    AiStreamPartType["ReasoningStart"] = "reasoning-start";
+    /** End of the reasoning block opened by a matching `ReasoningStart`. */
+    AiStreamPartType["ReasoningEnd"] = "reasoning-end";
+    /** An incremental chunk of reasoning text inside the currently open reasoning block. */
+    AiStreamPartType["ReasoningDelta"] = "reasoning-delta";
+    /** The model has begun streaming arguments for a tool call. */
+    AiStreamPartType["ToolInputStart"] = "tool-input-start";
+    /** The model has finished streaming arguments for the tool call. */
+    AiStreamPartType["ToolInputEnd"] = "tool-input-end";
+    /** An incremental chunk of the (JSON) tool-call arguments. */
+    AiStreamPartType["ToolInputDelta"] = "tool-input-delta";
+    /** A fully-assembled tool call — arguments are complete and parsed. */
+    AiStreamPartType["ToolCall"] = "tool-call";
+    /** A tool finished executing successfully. Includes the original `input` and the `output`. */
+    AiStreamPartType["ToolResult"] = "tool-result";
+    /** A tool threw while executing. `message` carries the stringified error. */
+    AiStreamPartType["ToolError"] = "tool-error";
+    /** The caller denied executing the tool after an approval request. */
+    AiStreamPartType["ToolOutputDenied"] = "tool-output-denied";
+    /** The model is requesting permission to execute a tool — awaiting approve/deny. */
+    AiStreamPartType["ToolApprovalRequest"] = "tool-approval-request";
+    /** The approve/deny decision for a prior {@link ToolApprovalRequest}. */
+    AiStreamPartType["ToolApprovalResponse"] = "tool-approval-response";
+})(AiStreamPartType || (exports.AiStreamPartType = AiStreamPartType = {}));

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

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

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

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

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

@@ -0,0 +1,13 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * An incremental chunk of reasoning text inside an open reasoning block.
+ *
+ * Concatenate all deltas sharing the same `id` to reconstruct the block's full reasoning.
+ */
+export interface AiStreamReasoningDelta {
+    type: AiStreamPartType.ReasoningDelta;
+    /** Identifier of the reasoning block this delta belongs to. */
+    id: string;
+    /** The new reasoning fragment to append. */
+    text: string;
+}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * A source the model cited while generating its response — used for grounded / RAG-style answers.
+ *
+ * `sourceType` is `'url'` for web sources and `'document'` for files/documents.
+ * URL sources populate `url` (and optionally `title`); document sources populate `mediaType`.
+ */
+export interface AiStreamSource {
+    /** Kind of source — typically `'url'` or `'document'`. */
+    sourceType: string;
+    /** Stable identifier for this source within the response. */
+    id: string;
+    /** URL of the source — present for `sourceType === 'url'`. */
+    url?: string;
+    /** Human-readable title for the source. */
+    title?: string;
+    /** IANA media type — present for `sourceType === 'document'`. */
+    mediaType?: string;
+    /** Optional filename — only set on document sources. */
+    filename?: string;
+}

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

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