quidproquo-core 0.0.263 → 0.1.0

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

@@ -1,4 +1,43 @@
-export interface AiMessage {
-    role: 'user' | 'assistant';
-    content: string;
+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/AiPromptActionRequester.d.ts

@@ -1,7 +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

@@ -8,6 +8,7 @@ function* askAiPrompt(model, prompt, options) {
         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

@@ -1,9 +1,11 @@
 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;
 }

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

@@ -3,7 +3,7 @@ import { StreamHandle } from '../../types/StreamRegistry';
 import { AiActionType } from './AiActionType';
 import { AiMessage } from './AiMessage';
 import { AiModel } from './AiModel';
-import { AiStreamPart } from './AiStreamPart';
+import { AiStreamPart } from './types';
 export interface AiPromptStreamActionPayload {
     model: AiModel;
     prompt: string;

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

@@ -5,4 +5,4 @@ export * from './AiPromptActionRequester';
 export * from './AiPromptActionTypes';
 export * from './AiPromptStreamActionRequester';
 export * from './AiPromptStreamActionTypes';
-export * from './AiStreamPart';
+export * from './types';

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

@@ -21,4 +21,4 @@ __exportStar(require("./AiPromptActionRequester"), exports);
 __exportStar(require("./AiPromptActionTypes"), exports);
 __exportStar(require("./AiPromptStreamActionRequester"), exports);
 __exportStar(require("./AiPromptStreamActionTypes"), exports);
-__exportStar(require("./AiStreamPart"), 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/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 });

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

@@ -0,0 +1,9 @@
+import { AiStreamPartType } from './AiStreamPartType';
+import { AiStreamSource } from './AiStreamSource';
+/**
+ * The model cited a source while generating its response — emitted for grounded / RAG answers.
+ */
+export interface AiStreamSourcePart {
+    type: AiStreamPartType.Source;
+    source: AiStreamSource;
+}

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

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

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

@@ -0,0 +1,7 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * Emitted once, before any other part — marks the beginning of the overall response.
+ */
+export interface AiStreamStart {
+    type: AiStreamPartType.Start;
+}

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

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

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

@@ -0,0 +1,9 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * A single generation step (one model round-trip) has started.
+ *
+ * Multi-step responses occur when the model invokes tools — each tool round-trip is a step.
+ */
+export interface AiStreamStartStep {
+    type: AiStreamPartType.StartStep;
+}

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

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

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

@@ -0,0 +1,14 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * An incremental chunk of visible model text inside an open text block.
+ *
+ * Concatenate all deltas sharing the same `id` to reconstruct the block's full text.
+ * This is the part to render in a typewriter-style UI.
+ */
+export interface AiStreamTextDelta {
+    type: AiStreamPartType.TextDelta;
+    /** Identifier of the text block this delta belongs to. */
+    id: string;
+    /** The new text fragment to append. */
+    text: string;
+}

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

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

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

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

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

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

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

@@ -0,0 +1,12 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * Beginning of a contiguous block of visible model text.
+ *
+ * Pair with the matching {@link AiStreamTextEnd} (same `id`). Deltas for this block
+ * arrive as {@link AiStreamTextDelta} with the same `id` in between.
+ */
+export interface AiStreamTextStart {
+    type: AiStreamPartType.TextStart;
+    /** Identifier shared by the matching `TextDelta` / `TextEnd` parts. */
+    id: string;
+}

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

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

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

@@ -0,0 +1,18 @@
+import { AiStreamPartType } from './AiStreamPartType';
+/**
+ * The model wants to execute a tool but the tool is configured to require approval.
+ *
+ * Respond with an approval message (or a `ToolOutputDenied`) keyed by `approvalId`
+ * before the model will proceed.
+ */
+export interface AiStreamToolApprovalRequest {
+    type: AiStreamPartType.ToolApprovalRequest;
+    /** Identifier the approve/deny response must reference. */
+    approvalId: string;
+    /** Id of the underlying tool call awaiting approval. */
+    toolCallId: string;
+    /** Name of the tool awaiting approval. */
+    toolName: string;
+    /** Arguments the tool would be called with if approved. */
+    input: unknown;
+}

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

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