laohuang 0.3.2 → 0.4.0

package/dist/model-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../src/model-selection.ts"],"names":[],"mappings":"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"}

package/dist/model-stream.d.ts

@@ -0,0 +1,128 @@
+/**
+ * OpenAI-compatible Chat Completions stream assembly and validation.
+ *
+ * One streamed completion is buffered into a provisional {@link ModelAttempt};
+ * the attempt only produces a {@link StreamResult} (the unit the agent commits
+ * to history, atomically, per turn) after the whole stream validates. Late
+ * deltas for a superseded request are dropped via `isRequestActive`, and a
+ * cancelled attempt flushes its partial text for display but never validates,
+ * so the caller has nothing to commit.
+ */
+import { CancelToken } from "./cancellation.ts";
+/** Raised when a streamed model response is incomplete or invalid. */
+export declare class ModelStreamError extends Error {
+    /** True when the stream had already delivered deltas before failing. */
+    hadDelta: boolean;
+    constructor(message: string, options?: {
+        hadDelta?: boolean;
+        cause?: unknown;
+    });
+}
+/** Raised when a model stream is cooperatively cancelled. */
+export declare class ModelStreamCancelled extends ModelStreamError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Raised when chunks arrive for a request which is no longer active. */
+export declare class StaleModelRequest extends ModelStreamCancelled {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export type AttemptState = "provisional" | "validated" | "aborted";
+export interface AssembledFunction {
+    readonly name: string;
+    readonly arguments: string;
+}
+export interface AssembledToolCall {
+    readonly id: string;
+    readonly type: string;
+    readonly function: AssembledFunction;
+}
+/** Chat Completions wire shape for one assistant tool call. */
+export declare function toolCallToDict(toolCall: AssembledToolCall): Record<string, unknown>;
+/** Assemble fragmented Chat Completions tool calls by their index. */
+export declare class ToolCallAccumulator {
+    readonly index: number;
+    private readonly idParts;
+    private readonly typeParts;
+    private readonly nameParts;
+    private readonly argumentParts;
+    constructor(index: number);
+    add(fragment: unknown): void;
+    build(): AssembledToolCall;
+}
+/** A fully validated assistant turn, ready to commit to history. */
+export declare class StreamResult {
+    readonly requestId: string;
+    readonly content: string | null;
+    readonly reasoningContent: string | null;
+    readonly toolCalls: readonly AssembledToolCall[];
+    readonly finishReason: string;
+    readonly usage: unknown;
+    constructor(init: {
+        requestId: string;
+        content: string | null;
+        reasoningContent: string | null;
+        toolCalls: readonly AssembledToolCall[];
+        finishReason: string;
+        usage?: unknown;
+    });
+    /** Assistant message in Chat Completions wire shape (nulls stripped). */
+    messageDict(): Record<string, unknown>;
+}
+export interface DeltaEvent {
+    kind: string;
+    payload: Record<string, unknown>;
+}
+/** A provisional response which can be atomically committed after validation. */
+export declare class ModelAttempt {
+    readonly requestId: string;
+    readonly contentParts: string[];
+    readonly reasoningParts: string[];
+    readonly toolCalls: Map<number, ToolCallAccumulator>;
+    finishReason: string | null;
+    usage: unknown;
+    receivedDelta: boolean;
+    state: AttemptState;
+    constructor(requestId: string);
+    get content(): string;
+    get reasoningContent(): string;
+    addChoice(choice: unknown): DeltaEvent[];
+    validate(): StreamResult;
+    abort(): void;
+}
+export type DeltaCallback = (kind: string, payload: Record<string, unknown>) => void;
+/**
+ * Minimal structural view of `client.chat.completions` from the openai SDK.
+ * `create` may return the response/stream directly or a promise of it.
+ */
+export interface ChatCompletionsEndpoint {
+    create(request: Record<string, unknown>): unknown;
+}
+export interface CompleteOptions {
+    model: string;
+    messages: Array<Record<string, unknown>>;
+    tools: Array<Record<string, unknown>>;
+    toolChoice?: string | Record<string, unknown> | null;
+    requestId?: string;
+    cancelToken?: CancelToken | null;
+    isRequestActive?: ((requestId: string) => boolean) | null;
+    onDelta?: DeltaCallback | null;
+    onRequestOpened?: (() => boolean | void) | null;
+    maxPreDeltaRetries?: number;
+    /** Provider-specific extra request fields, merged into the wire request. */
+    extraBody?: Record<string, unknown> | null;
+}
+/** Create and assemble one OpenAI-compatible streaming completion. */
+export declare class ChatCompletionStreamer {
+    private readonly completions;
+    constructor(completions: ChatCompletionsEndpoint);
+    complete(options: CompleteOptions): Promise<StreamResult>;
+    /**
+     * Compatibility path for fake clients and OpenAI-compatible endpoints
+     * which answer a streaming request with a plain completion object.
+     */
+    private static fromNonStream;
+}