@octomil/browser 1.0.0 → 1.1.0

package/dist/responses-runtime.d.ts

@@ -0,0 +1,13 @@
+import type { Response, ResponseRequest, ResponseStreamEvent } from "./responses.js";
+/**
+ * Pluggable local runtime for `responses.create()` / `responses.stream()`.
+ *
+ * Browser SDK callers can inject a concrete local LLM runtime here while the
+ * public SDK surface remains stable at the responses layer.
+ */
+export interface LocalResponsesRuntime {
+    create(request: ResponseRequest): Promise<Response>;
+    stream(request: ResponseRequest): AsyncGenerator<ResponseStreamEvent>;
+}
+export type LocalResponsesRuntimeResolver = (model: string) => LocalResponsesRuntime | null | undefined;
+//# sourceMappingURL=responses-runtime.d.ts.map

package/dist/responses-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-runtime.d.ts","sourceRoot":"","sources":["../src/responses-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,mBAAmB,EACpB,MAAM,gBAAgB,CAAC;AAExB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC;CACvE;AAED,MAAM,MAAM,6BAA6B,GAAG,CAC1C,KAAK,EAAE,MAAM,KACV,qBAAqB,GAAG,IAAI,GAAG,SAAS,CAAC"}

package/dist/responses-runtime.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=responses-runtime.js.map

package/dist/responses-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-runtime.js","sourceRoot":"","sources":["../src/responses-runtime.ts"],"names":[],"mappings":""}

package/dist/responses-tools.d.ts

@@ -0,0 +1,18 @@
+import type { Response, ResponseRequest, ResponseToolCall, ResponsesClient } from "./responses.js";
+export interface ToolResult {
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface ToolExecutor {
+    execute(call: ResponseToolCall): Promise<ToolResult>;
+}
+export declare class ToolRunner {
+    private readonly responses;
+    private readonly executor;
+    private readonly maxIterations;
+    constructor(responses: ResponsesClient, executor: ToolExecutor, maxIterations?: number);
+    run(request: ResponseRequest): Promise<Response>;
+    private normalizeInput;
+}
+//# sourceMappingURL=responses-tools.d.ts.map

package/dist/responses-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses-tools.d.ts","sourceRoot":"","sources":["../src/responses-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,eAAe,EAGhB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtD;AAuBD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAGrC,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,YAAY,EACtB,aAAa,SAAK;IAOd,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IA4CtD,OAAO,CAAC,cAAc;CAWvB"}

package/dist/responses-tools.js

@@ -0,0 +1,71 @@
+function extractToolCalls(output) {
+    return output
+        .filter((item) => item.type === "tool_call" && !!item.toolCall)
+        .map((item) => item.toolCall);
+}
+function assistantToolCallMessage(toolCalls) {
+    return {
+        role: "assistant",
+        content: toolCalls.map((toolCall) => ({
+            type: "tool_call",
+            toolCall,
+        })),
+    };
+}
+export class ToolRunner {
+    responses;
+    executor;
+    maxIterations;
+    constructor(responses, executor, maxIterations = 10) {
+        this.responses = responses;
+        this.executor = executor;
+        this.maxIterations = maxIterations;
+    }
+    async run(request) {
+        const currentInput = this.normalizeInput(request.input);
+        for (let iteration = 0; iteration < this.maxIterations; iteration++) {
+            const response = await this.responses.create({
+                ...request,
+                input: currentInput,
+            });
+            const toolCalls = extractToolCalls(response.output);
+            if (toolCalls.length === 0) {
+                return response;
+            }
+            currentInput.push(assistantToolCallMessage(toolCalls));
+            for (const toolCall of toolCalls) {
+                let result;
+                try {
+                    result = await this.executor.execute(toolCall);
+                }
+                catch (error) {
+                    result = {
+                        toolCallId: toolCall.id,
+                        content: error instanceof Error ? `Error: ${error.message}` : "Error",
+                        isError: true,
+                    };
+                }
+                currentInput.push({
+                    role: "tool",
+                    toolCallId: result.toolCallId,
+                    content: result.content,
+                });
+            }
+        }
+        return this.responses.create({
+            ...request,
+            input: currentInput,
+            tools: [],
+        });
+    }
+    normalizeInput(input) {
+        if (typeof input === "string") {
+            return [{ role: "user", content: input }];
+        }
+        if (input.every((item) => "role" in item)) {
+            return input.map((item) => ({ ...item }));
+        }
+        return [{ role: "user", content: input }];
+    }
+}
+//# sourceMappingURL=responses-tools.js.map

package/dist/responses-tools.js.map

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

package/dist/responses.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Responses namespace — structured response API (Layer 2).
+ * Matches SDK_FACADE_CONTRACT.md responses.create() and responses.stream().
+ */
+import type { TelemetryReporter } from "./telemetry.js";
+import type { DeviceContext } from "./device-context.js";
+import type { LocalResponsesRuntime, LocalResponsesRuntimeResolver } from "./responses-runtime.js";
+export interface ResponseRequest {
+    model: string;
+    input: string | ContentBlock[] | ResponseInputItem[];
+    tools?: ToolDef[];
+    instructions?: string;
+    previousResponseId?: string;
+    maxOutputTokens?: number;
+    temperature?: number;
+    topP?: number;
+    stop?: string[];
+    stream?: boolean;
+    metadata?: Record<string, string>;
+}
+export interface ContentBlock {
+    type: "text" | "image" | "audio" | "video" | "file";
+    text?: string;
+    /** Image URL for cloud inference */
+    imageUrl?: string;
+    /** Base64-encoded binary data */
+    data?: string;
+    /** MIME type (e.g. "image/png", "audio/wav", "video/mp4") */
+    mediaType?: string;
+}
+/**
+ * Chat-level content part for the OpenAI-compatible messages array.
+ * Supports text, image_url (images and video frames), and input_audio.
+ */
+export interface ChatContentPart {
+    type: "text" | "image_url" | "input_audio";
+    text?: string;
+    image_url?: {
+        url: string;
+    };
+    input_audio?: {
+        data: string;
+        format: string;
+    };
+}
+export interface ToolDef {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+    };
+}
+export interface ResponseToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+export interface ResponseOutput {
+    type: "text" | "tool_call";
+    text?: string;
+    toolCall?: ResponseToolCall;
+}
+export interface ResponseInputItem {
+    role: "system" | "user" | "assistant" | "tool";
+    content?: string | ContentBlock[] | ResponseOutput[] | null;
+    toolCallId?: string;
+}
+export interface Response {
+    id: string;
+    model: string;
+    output: ResponseOutput[];
+    finishReason: string;
+    usage?: ResponseUsage;
+}
+export interface ResponseUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+export interface TextDeltaEvent {
+    type: "text_delta";
+    delta: string;
+}
+export interface ToolCallDeltaEvent {
+    type: "tool_call_delta";
+    index: number;
+    id?: string;
+    name?: string;
+    argumentsDelta?: string;
+}
+export interface DoneEvent {
+    type: "done";
+    response: Response;
+}
+export type ResponseStreamEvent = TextDeltaEvent | ToolCallDeltaEvent | DoneEvent;
+export interface ResponsesClientOptions {
+    serverUrl?: string;
+    apiKey?: string;
+    telemetry?: TelemetryReporter | null;
+    deviceContext?: DeviceContext | null;
+    localRuntime?: LocalResponsesRuntime | LocalResponsesRuntimeResolver | null;
+}
+export declare class ResponsesClient {
+    private serverUrl;
+    private apiKey;
+    private readonly telemetry;
+    private readonly deviceContext;
+    private readonly localRuntime;
+    private responseCache;
+    private readonly MAX_CACHE;
+    constructor(options?: ResponsesClientOptions);
+    /**
+     * Non-streaming response creation.
+     */
+    create(request: ResponseRequest): Promise<Response>;
+    /**
+     * Streaming response creation. Returns async generator of events.
+     */
+    stream(request: ResponseRequest): AsyncGenerator<ResponseStreamEvent>;
+    private resolveLocalRuntime;
+    private cacheResponse;
+    private createLocal;
+    private streamLocal;
+    private buildEffectiveRequest;
+    private buildRequestBody;
+    private buildMessages;
+    private normalizeInput;
+    private isResponseInputItems;
+    private inputItemToMessage;
+    private assistantInputToMessage;
+    private isResponseOutputItems;
+    private inputContentToMessageContent;
+    private contentBlocksToParts;
+    /**
+     * Map a public ContentBlock to an OpenAI-compatible ChatContentPart.
+     */
+    private contentBlockToPart;
+    private parseResponse;
+}
+export declare function generateId(): string;
+//# sourceMappingURL=responses.d.ts.map

package/dist/responses.d.ts.map

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