@onkernel/cua-ai 0.0.1

package/dist/providers/common.d.ts

@@ -0,0 +1,111 @@
+import { Type, type Static, type TSchema, type Tool } from "@earendil-works/pi-ai";
+export declare const CUA_ACTION_TYPES: readonly ["click", "double_click", "mouse_down", "mouse_up", "type", "keypress", "scroll", "move", "drag", "wait", "screenshot", "goto", "back", "forward", "url", "cursor_position"];
+export type CuaActionType = (typeof CUA_ACTION_TYPES)[number];
+export interface CuaActionClick {
+    type: "click";
+    x: number;
+    y: number;
+    button?: string;
+    hold_keys?: string[];
+}
+export interface CuaActionDoubleClick {
+    type: "double_click";
+    x: number;
+    y: number;
+    hold_keys?: string[];
+}
+export interface CuaActionMouseDown {
+    type: "mouse_down";
+    x: number;
+    y: number;
+    button?: string;
+    hold_keys?: string[];
+}
+export interface CuaActionMouseUp {
+    type: "mouse_up";
+    x: number;
+    y: number;
+    button?: string;
+    hold_keys?: string[];
+}
+export interface CuaActionTypeText {
+    type: "type";
+    text: string;
+}
+export interface CuaActionKeypress {
+    type: "keypress";
+    keys: string[];
+}
+export interface CuaActionScroll {
+    type: "scroll";
+    x?: number;
+    y?: number;
+    scroll_x?: number;
+    scroll_y?: number;
+    hold_keys?: string[];
+}
+export interface CuaActionMove {
+    type: "move";
+    x: number;
+    y: number;
+}
+export interface CuaActionDrag {
+    type: "drag";
+    path: Array<{
+        x: number;
+        y: number;
+    }>;
+    button?: string;
+    hold_keys?: string[];
+}
+export interface CuaActionWait {
+    type: "wait";
+    ms?: number;
+}
+export interface CuaActionScreenshot {
+    type: "screenshot";
+}
+export interface CuaActionGoto {
+    type: "goto";
+    url: string;
+}
+export interface CuaActionBack {
+    type: "back";
+}
+export interface CuaActionForward {
+    type: "forward";
+}
+export interface CuaActionUrl {
+    type: "url";
+}
+export interface CuaActionCursorPosition {
+    type: "cursor_position";
+}
+export type CuaAction = CuaActionClick | CuaActionDoubleClick | CuaActionMouseDown | CuaActionMouseUp | CuaActionTypeText | CuaActionKeypress | CuaActionScroll | CuaActionMove | CuaActionDrag | CuaActionWait | CuaActionScreenshot | CuaActionGoto | CuaActionBack | CuaActionForward | CuaActionUrl | CuaActionCursorPosition;
+export declare function createCuaActionSchema(actions?: readonly CuaActionType[]): TSchema;
+export declare const CuaActionSchema: Type.TSchema;
+export declare function createCuaBatchSchema(actions?: readonly CuaActionType[]): TSchema;
+export declare const CuaBatchSchema: Type.TSchema;
+export declare const CuaNavigationSchema: Type.TObject<{
+    action: Type.TUnion<[Type.TLiteral<"goto">, Type.TLiteral<"back">, Type.TLiteral<"forward">, Type.TLiteral<"url">]>;
+    url: Type.TOptional<Type.TString>;
+}>;
+export interface CuaBatchInput {
+    actions: CuaAction[];
+}
+export type CuaNavigationInput = Static<typeof CuaNavigationSchema>;
+export declare const CUA_BATCH_TOOL_NAME = "batch_computer_actions";
+export declare const CUA_NAVIGATION_TOOL_NAME = "computer_use_extra";
+export declare const CUA_BATCH_TOOL_DESCRIPTION: string;
+export declare const CUA_NAVIGATION_TOOL_DESCRIPTION = "High-level browser navigation helpers for goto, back, forward, and url.";
+export interface CreateComputerToolDefinitionsOptions {
+    actions?: readonly CuaActionType[];
+}
+export type ComputerToolCoordinateSystem = {
+    type: "pixel";
+} | {
+    type: "normalized";
+    range: readonly [number, number];
+};
+export declare function createComputerToolDefinitions(options?: CreateComputerToolDefinitionsOptions): Tool[];
+//# sourceMappingURL=common.d.ts.map

package/dist/providers/common.d.ts.map

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

package/dist/providers/common.js

@@ -0,0 +1,138 @@
+import { Type } from "@earendil-works/pi-ai";
+export const CUA_ACTION_TYPES = [
+    "click",
+    "double_click",
+    "mouse_down",
+    "mouse_up",
+    "type",
+    "keypress",
+    "scroll",
+    "move",
+    "drag",
+    "wait",
+    "screenshot",
+    "goto",
+    "back",
+    "forward",
+    "url",
+    "cursor_position",
+];
+const PointSchema = Type.Object({
+    x: Type.Number(),
+    y: Type.Number(),
+}, { additionalProperties: false });
+const CUA_ACTION_SCHEMA_BY_TYPE = {
+    click: Type.Object({
+        type: Type.Literal("click"),
+        x: Type.Number(),
+        y: Type.Number(),
+        button: Type.Optional(Type.String()),
+        hold_keys: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false }),
+    double_click: Type.Object({
+        type: Type.Literal("double_click"),
+        x: Type.Number(),
+        y: Type.Number(),
+        hold_keys: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false }),
+    mouse_down: Type.Object({
+        type: Type.Literal("mouse_down"),
+        x: Type.Number(),
+        y: Type.Number(),
+        button: Type.Optional(Type.String()),
+        hold_keys: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false }),
+    mouse_up: Type.Object({
+        type: Type.Literal("mouse_up"),
+        x: Type.Number(),
+        y: Type.Number(),
+        button: Type.Optional(Type.String()),
+        hold_keys: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false }),
+    type: Type.Object({
+        type: Type.Literal("type"),
+        text: Type.String(),
+    }, { additionalProperties: false }),
+    keypress: Type.Object({
+        type: Type.Literal("keypress"),
+        keys: Type.Array(Type.String()),
+    }, { additionalProperties: false }),
+    scroll: Type.Object({
+        type: Type.Literal("scroll"),
+        x: Type.Optional(Type.Number()),
+        y: Type.Optional(Type.Number()),
+        scroll_x: Type.Optional(Type.Number()),
+        scroll_y: Type.Optional(Type.Number()),
+        hold_keys: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false }),
+    move: Type.Object({
+        type: Type.Literal("move"),
+        x: Type.Number(),
+        y: Type.Number(),
+    }, { additionalProperties: false }),
+    drag: Type.Object({
+        type: Type.Literal("drag"),
+        path: Type.Array(PointSchema, { minItems: 2 }),
+        button: Type.Optional(Type.String()),
+        hold_keys: Type.Optional(Type.Array(Type.String())),
+    }, { additionalProperties: false }),
+    wait: Type.Object({
+        type: Type.Literal("wait"),
+        ms: Type.Optional(Type.Number()),
+    }, { additionalProperties: false }),
+    screenshot: Type.Object({ type: Type.Literal("screenshot") }, { additionalProperties: false }),
+    goto: Type.Object({
+        type: Type.Literal("goto"),
+        url: Type.String(),
+    }, { additionalProperties: false }),
+    back: Type.Object({ type: Type.Literal("back") }, { additionalProperties: false }),
+    forward: Type.Object({ type: Type.Literal("forward") }, { additionalProperties: false }),
+    url: Type.Object({ type: Type.Literal("url") }, { additionalProperties: false }),
+    cursor_position: Type.Object({ type: Type.Literal("cursor_position") }, { additionalProperties: false }),
+};
+export function createCuaActionSchema(actions = CUA_ACTION_TYPES) {
+    if (actions.length === 0)
+        throw new Error("actions must include at least one CUA action type");
+    if (actions.length === 1)
+        return CUA_ACTION_SCHEMA_BY_TYPE[actions[0]];
+    return Type.Union(actions.map((action) => CUA_ACTION_SCHEMA_BY_TYPE[action]));
+}
+export const CuaActionSchema = createCuaActionSchema();
+export function createCuaBatchSchema(actions) {
+    return Type.Object({
+        actions: Type.Array(createCuaActionSchema(actions), { description: "Ordered computer actions to execute." }),
+    });
+}
+export const CuaBatchSchema = createCuaBatchSchema();
+export const CuaNavigationSchema = Type.Object({
+    action: Type.Union([Type.Literal("goto"), Type.Literal("back"), Type.Literal("forward"), Type.Literal("url")]),
+    url: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+export const CUA_BATCH_TOOL_NAME = "batch_computer_actions";
+export const CUA_NAVIGATION_TOOL_NAME = "computer_use_extra";
+export const CUA_BATCH_TOOL_DESCRIPTION = [
+    "Execute multiple computer actions in sequence, including ordered read steps like url(), cursor_position(), and screenshot().",
+    "Prefer this tool for predictable browser interaction sequences such as click-then-type, typing a URL, keyboard navigation, drag paths, and mixed write/read batches.",
+    "If no explicit read step is included, the tool returns one fresh screenshot after execution.",
+].join("\n");
+export const CUA_NAVIGATION_TOOL_DESCRIPTION = "High-level browser navigation helpers for goto, back, forward, and url.";
+export function createComputerToolDefinitions(options = {}) {
+    const actions = options.actions;
+    return [
+        {
+            name: CUA_BATCH_TOOL_NAME,
+            description: CUA_BATCH_TOOL_DESCRIPTION,
+            parameters: createCuaBatchSchema(actions),
+        },
+        ...(actions === undefined
+            ? [
+                {
+                    name: CUA_NAVIGATION_TOOL_NAME,
+                    description: CUA_NAVIGATION_TOOL_DESCRIPTION,
+                    parameters: CuaNavigationSchema,
+                },
+            ]
+            : []),
+    ];
+}
+//# sourceMappingURL=common.js.map

package/dist/providers/common.js.map

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

package/dist/providers/gemini/index.d.ts

@@ -0,0 +1,11 @@
+export { CUA_ACTION_TYPES as GEMINI_CUA_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as GEMINI_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as GEMINI_BATCH_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as GeminiBatchSchema, } from "../common.js";
+export type { CuaAction as GeminiAction, CreateComputerToolDefinitionsOptions, CuaBatchInput as GeminiBatchInput, } from "../common.js";
+export declare const COMPUTER_TOOL_COORDINATES: {
+    readonly type: "normalized";
+    readonly range: readonly [0, 999];
+};
+export declare const GEMINI_INSTRUCTIONS_RAW = "You control a Kernel cloud browser through computer-use tools. Use pixel coordinates, batch predictable action sequences, and request screenshots or URL reads when state changes.";
+export declare function buildGeminiSystemPrompt(opts?: {
+    suffix?: string;
+}): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/gemini/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/gemini/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,uBAAuB,EAC3C,0BAA0B,IAAI,wBAAwB,EACtD,mBAAmB,IAAI,sBAAsB,EAC7C,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,iBAAiB,GACnC,MAAM,WAAW,CAAC;AACnB,YAAY,EACX,SAAS,IAAI,YAAY,EACzB,oCAAoC,EACpC,aAAa,IAAI,gBAAgB,GACjC,MAAM,WAAW,CAAC;AASnB,eAAO,MAAM,yBAAyB;;;CAA0F,CAAC;AAEjI,eAAO,MAAM,uBAAuB,uLAAuL,CAAC;AAE5N,wBAAgB,uBAAuB,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAE9E"}

package/dist/providers/gemini/index.js

@@ -0,0 +1,14 @@
+export { CUA_ACTION_TYPES as GEMINI_CUA_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as GEMINI_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as GEMINI_BATCH_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as GeminiBatchSchema, } from "../common.js";
+// Provider-native function names emitted on `functionCall.name` (PREDEFINED_COMPUTER_USE_FUNCTIONS):
+//   open_web_browser, click_at, hover_at, type_text_at, scroll_document,
+//   scroll_at, wait_5_seconds, go_back, go_forward, search, navigate,
+//   key_combination, drag_and_drop
+// Coordinates are normalized to 0-999 regardless of input image size.
+// Source: https://github.com/google/computer-use-preview/blob/main/agent.py
+// Docs: https://ai.google.dev/gemini-api/docs/computer-use
+export const COMPUTER_TOOL_COORDINATES = { type: "normalized", range: [0, 999] };
+export const GEMINI_INSTRUCTIONS_RAW = `You control a Kernel cloud browser through computer-use tools. Use pixel coordinates, batch predictable action sequences, and request screenshots or URL reads when state changes.`;
+export function buildGeminiSystemPrompt(opts = {}) {
+    return [GEMINI_INSTRUCTIONS_RAW, opts.suffix].filter(Boolean).join("\n\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/gemini/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/gemini/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,uBAAuB,EAC3C,0BAA0B,IAAI,wBAAwB,EACtD,mBAAmB,IAAI,sBAAsB,EAC7C,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,iBAAiB,GACnC,MAAM,WAAW,CAAC;AAOnB,qGAAqG;AACrG,yEAAyE;AACzE,sEAAsE;AACtE,mCAAmC;AACnC,sEAAsE;AACtE,4EAA4E;AAC5E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAkD,CAAC;AAEjI,MAAM,CAAC,MAAM,uBAAuB,GAAG,oLAAoL,CAAC;AAE5N,MAAM,UAAU,uBAAuB,CAAC,OAA4B,EAAE;IACrE,OAAO,CAAC,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC"}

package/dist/providers/openai/index.d.ts

@@ -0,0 +1,8 @@
+export { CUA_ACTION_TYPES as OPENAI_CUA_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as OPENAI_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as OPENAI_BATCH_TOOL_NAME, CUA_NAVIGATION_TOOL_DESCRIPTION as OPENAI_EXTRA_TOOL_DESCRIPTION, CUA_NAVIGATION_TOOL_NAME as OPENAI_EXTRA_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as OpenAIBatchSchema, CuaNavigationSchema as OpenAIExtraSchema, } from "../common";
+export type { CuaAction as OpenAIAction, CreateComputerToolDefinitionsOptions, CuaBatchInput as OpenAIBatchInput, CuaNavigationInput as OpenAIExtraInput, } from "../common";
+export declare const COMPUTER_TOOL_COORDINATES: {
+    readonly type: "pixel";
+};
+export declare const OPENAI_BATCH_INSTRUCTIONS = "You have two browser tools:\n1. batch_computer_actions for click, double_click, mouse_down, mouse_up, type, keypress, scroll, move, drag, wait, goto, back, forward, url, cursor_position, and screenshot.\n2. computer_use_extra for a single high-level goto, back, forward, or url action.\n\nPrefer batch_computer_actions for predictable multi-step browser interaction. Include explicit url(), cursor_position(), or screenshot() read steps when you need intermediate state.";
+export declare function openaiResponsesStoreOnPayload(payload: unknown): unknown | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/openai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/openai/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,uBAAuB,EAC3C,0BAA0B,IAAI,wBAAwB,EACtD,mBAAmB,IAAI,sBAAsB,EAC7C,+BAA+B,IAAI,6BAA6B,EAChE,wBAAwB,IAAI,sBAAsB,EAClD,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,iBAAiB,EACnC,mBAAmB,IAAI,iBAAiB,GACxC,MAAM,WAAW,CAAC;AACnB,YAAY,EACX,SAAS,IAAI,YAAY,EACzB,oCAAoC,EACpC,aAAa,IAAI,gBAAgB,EACjC,kBAAkB,IAAI,gBAAgB,GACtC,MAAM,WAAW,CAAC;AAKnB,eAAO,MAAM,yBAAyB;;CAAoE,CAAC;AAE3G,eAAO,MAAM,yBAAyB,2dAIgJ,CAAC;AAEvL,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAQnF"}

package/dist/providers/openai/index.js

@@ -0,0 +1,22 @@
+export { CUA_ACTION_TYPES as OPENAI_CUA_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as OPENAI_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as OPENAI_BATCH_TOOL_NAME, CUA_NAVIGATION_TOOL_DESCRIPTION as OPENAI_EXTRA_TOOL_DESCRIPTION, CUA_NAVIGATION_TOOL_NAME as OPENAI_EXTRA_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as OpenAIBatchSchema, CuaNavigationSchema as OpenAIExtraSchema, } from "../common";
+// Provider-native action vocabulary emitted on `computer_call.action.type`:
+//   click, double_click, drag, move, scroll, type, keypress, wait, screenshot
+// Source: https://github.com/openai/openai-cua-sample-app/blob/main/packages/runner-core/src/responses-loop.ts
+export const COMPUTER_TOOL_COORDINATES = { type: "pixel" };
+export const OPENAI_BATCH_INSTRUCTIONS = `You have two browser tools:
+1. batch_computer_actions for click, double_click, mouse_down, mouse_up, type, keypress, scroll, move, drag, wait, goto, back, forward, url, cursor_position, and screenshot.
+2. computer_use_extra for a single high-level goto, back, forward, or url action.
+
+Prefer batch_computer_actions for predictable multi-step browser interaction. Include explicit url(), cursor_position(), or screenshot() read steps when you need intermediate state.`;
+export function openaiResponsesStoreOnPayload(payload) {
+    if (!payload || typeof payload !== "object")
+        return undefined;
+    const current = payload;
+    if (current.store === true)
+        return undefined;
+    return {
+        ...current,
+        store: true,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/openai/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,uBAAuB,EAC3C,0BAA0B,IAAI,wBAAwB,EACtD,mBAAmB,IAAI,sBAAsB,EAC7C,+BAA+B,IAAI,6BAA6B,EAChE,wBAAwB,IAAI,sBAAsB,EAClD,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,iBAAiB,EACnC,mBAAmB,IAAI,iBAAiB,GACxC,MAAM,WAAW,CAAC;AAQnB,4EAA4E;AAC5E,8EAA8E;AAC9E,+GAA+G;AAC/G,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAkD,CAAC;AAE3G,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;sLAI6I,CAAC;AAEvL,MAAM,UAAU,6BAA6B,CAAC,OAAgB;IAC7D,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,OAAO,GAAG,OAAkC,CAAC;IACnD,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO;QACN,GAAG,OAAO;QACV,KAAK,EAAE,IAAI;KACX,CAAC;AACH,CAAC"}

package/dist/providers/tzafon/index.d.ts

@@ -0,0 +1,12 @@
+export { CUA_ACTION_TYPES as TZAFON_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as TZAFON_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as TZAFON_BATCH_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as TzafonBatchSchema, } from "../common.js";
+export type { CuaAction as TzafonAction, CreateComputerToolDefinitionsOptions, CuaBatchInput as TzafonBatchInput, } from "../common.js";
+export { TZAFON_RESPONSES_API, streamSimpleTzafonResponses, streamTzafonResponses, } from "./provider.js";
+export declare const COMPUTER_TOOL_COORDINATES: {
+    readonly type: "normalized";
+    readonly range: readonly [0, 999];
+};
+export declare const TZAFON_INSTRUCTIONS_RAW = "You control a Kernel cloud browser. Prefer batched computer actions for browser interaction and include screenshot or URL reads when you need updated state.";
+export declare function buildTzafonSystemPrompt(opts?: {
+    suffix?: string;
+}): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/tzafon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/tzafon/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,mBAAmB,EACvC,0BAA0B,IAAI,wBAAwB,EACtD,mBAAmB,IAAI,sBAAsB,EAC7C,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,iBAAiB,GACnC,MAAM,WAAW,CAAC;AACnB,YAAY,EACX,SAAS,IAAI,YAAY,EACzB,oCAAoC,EACpC,aAAa,IAAI,gBAAgB,GACjC,MAAM,WAAW,CAAC;AACnB,OAAO,EACN,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,YAAY,CAAC;AAYpB,eAAO,MAAM,yBAAyB;;;CAA0F,CAAC;AAEjI,eAAO,MAAM,uBAAuB,iKAAiK,CAAC;AAEtM,wBAAgB,uBAAuB,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAE9E"}

package/dist/providers/tzafon/index.js

@@ -0,0 +1,18 @@
+export { CUA_ACTION_TYPES as TZAFON_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as TZAFON_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as TZAFON_BATCH_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as TzafonBatchSchema, } from "../common.js";
+export { TZAFON_RESPONSES_API, streamSimpleTzafonResponses, streamTzafonResponses, } from "./provider.js";
+// Provider-native action vocabulary. The model card lists supported actions;
+// the Responses API loop dispatches on `action.type` and adds terminal control
+// types (`answer`, `done`).
+//   Model actions: click, double_click, triple_click, right_click, drag, type,
+//                  key, scroll, hscroll, navigate, wait, terminate
+//   Responses API `action.type` also includes: keypress, answer, done
+// Sources:
+//   https://huggingface.co/Tzafon/Northstar-CUA-Fast
+//   https://docs.lightcone.ai/guides/cua-protocol/
+//   https://docs.lightcone.ai/guides/coordinates/
+export const COMPUTER_TOOL_COORDINATES = { type: "normalized", range: [0, 999] };
+export const TZAFON_INSTRUCTIONS_RAW = `You control a Kernel cloud browser. Prefer batched computer actions for browser interaction and include screenshot or URL reads when you need updated state.`;
+export function buildTzafonSystemPrompt(opts = {}) {
+    return [TZAFON_INSTRUCTIONS_RAW, opts.suffix].filter(Boolean).join("\n\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/tzafon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/tzafon/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,mBAAmB,EACvC,0BAA0B,IAAI,wBAAwB,EACtD,mBAAmB,IAAI,sBAAsB,EAC7C,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,iBAAiB,GACnC,MAAM,WAAW,CAAC;AAMnB,OAAO,EACN,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACrB,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAC/E,mEAAmE;AACnE,sEAAsE;AACtE,WAAW;AACX,qDAAqD;AACrD,mDAAmD;AACnD,kDAAkD;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAkD,CAAC;AAEjI,MAAM,CAAC,MAAM,uBAAuB,GAAG,8JAA8J,CAAC;AAEtM,MAAM,UAAU,uBAAuB,CAAC,OAA4B,EAAE;IACrE,OAAO,CAAC,uBAAuB,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC"}

package/dist/providers/tzafon/provider.d.ts

@@ -0,0 +1,8 @@
+import { type SimpleStreamOptions, type StreamFunction, type StreamOptions } from "@earendil-works/pi-ai";
+export declare const TZAFON_RESPONSES_API = "tzafon-responses";
+export interface TzafonResponsesOptions extends StreamOptions {
+    maxOutputTokens?: number;
+}
+export declare const streamSimpleTzafonResponses: StreamFunction<string, SimpleStreamOptions>;
+export declare const streamTzafonResponses: StreamFunction<string, TzafonResponsesOptions>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/providers/tzafon/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/providers/tzafon/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAON,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,aAAa,EAIlB,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,2BAA2B,EAAE,cAAc,CAAC,MAAM,EAAE,mBAAmB,CAEnF,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,MAAM,EAAE,sBAAsB,CAsDhF,CAAC"}

package/dist/providers/tzafon/provider.js

@@ -0,0 +1,234 @@
+import { createAssistantMessageEventStream, } from "@earendil-works/pi-ai";
+import Lightcone from "@tzafon/lightcone";
+export const TZAFON_RESPONSES_API = "tzafon-responses";
+export const streamSimpleTzafonResponses = (model, context, options) => {
+    return streamTzafonResponses(model, context, options);
+};
+export const streamTzafonResponses = (model, context, options) => {
+    const stream = createAssistantMessageEventStream();
+    const output = initialAssistantMessage(model);
+    void (async () => {
+        try {
+            const apiKey = options?.apiKey || process.env.TZAFON_API_KEY;
+            if (!apiKey)
+                throw new Error(`No API key for provider: ${model.provider}`);
+            const client = new Lightcone({ apiKey });
+            const payload = {
+                model: model.id,
+                input: convertContextMessages(context),
+                tools: convertTools(context.tools ?? []),
+                instructions: context.systemPrompt,
+                temperature: options?.temperature ?? 0,
+                max_output_tokens: options?.maxOutputTokens ?? options?.maxTokens ?? model.maxTokens,
+            };
+            const nextPayload = await options?.onPayload?.(payload, model);
+            if (options?.signal?.aborted)
+                throw new Error("Request was aborted");
+            const response = await client.responses.create((nextPayload ?? payload), { signal: options?.signal });
+            if (options?.signal?.aborted)
+                throw new Error("Request was aborted");
+            stream.push({ type: "start", partial: output });
+            output.responseId = getString(response, "id") || undefined;
+            output.usage = usageFromTzafon(getValue(response, "usage"));
+            for (const item of getArray(response, "output")) {
+                const type = getString(item, "type");
+                if (type === "message") {
+                    const text = extractMessageText(item);
+                    if (text)
+                        emitText(stream, output, text);
+                    continue;
+                }
+                if (type === "function_call") {
+                    emitToolCall(stream, output, {
+                        type: "toolCall",
+                        id: getString(item, "call_id"),
+                        name: getString(item, "name"),
+                        arguments: parseArguments(getValue(item, "arguments")),
+                    });
+                }
+            }
+            output.stopReason = output.content.some((part) => part.type === "toolCall") ? "toolUse" : "stop";
+            stream.push({ type: "done", reason: output.stopReason, message: output });
+            stream.end();
+        }
+        catch (err) {
+            output.stopReason = options?.signal?.aborted ? "aborted" : "error";
+            output.errorMessage = err instanceof Error ? err.message : String(err);
+            stream.push({ type: "error", reason: output.stopReason, error: output });
+            stream.end();
+        }
+    })();
+    return stream;
+};
+function initialAssistantMessage(model) {
+    return {
+        role: "assistant",
+        content: [],
+        api: model.api,
+        provider: model.provider,
+        model: model.id,
+        usage: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            totalTokens: 0,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+        },
+        stopReason: "stop",
+        timestamp: Date.now(),
+    };
+}
+function emitText(stream, output, text) {
+    const contentIndex = output.content.length;
+    const content = { type: "text", text };
+    output.content.push(content);
+    stream.push({ type: "text_start", contentIndex, partial: output });
+    stream.push({ type: "text_delta", contentIndex, delta: text, partial: output });
+    stream.push({ type: "text_end", contentIndex, content: text, partial: output });
+}
+function emitToolCall(stream, output, toolCall) {
+    const contentIndex = output.content.length;
+    output.content.push(toolCall);
+    stream.push({ type: "toolcall_start", contentIndex, partial: output });
+    stream.push({ type: "toolcall_end", contentIndex, toolCall, partial: output });
+}
+function convertTools(tools) {
+    return tools.map((tool) => ({
+        type: "function",
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.parameters,
+    }));
+}
+function convertContextMessages(context) {
+    const items = [];
+    for (const message of context.messages) {
+        if (message.role === "user") {
+            items.push({ role: "user", content: convertUserContent(message.content) });
+            continue;
+        }
+        if (message.role === "assistant") {
+            const text = message.content
+                .filter((part) => part.type === "text")
+                .map((part) => part.text)
+                .join("\n")
+                .trim();
+            if (text)
+                items.push({ role: "assistant", content: text });
+            for (const part of message.content) {
+                if (part.type !== "toolCall")
+                    continue;
+                items.push({
+                    type: "function_call",
+                    call_id: part.id,
+                    name: part.name,
+                    arguments: JSON.stringify(part.arguments ?? {}),
+                });
+            }
+            continue;
+        }
+        if (message.role === "toolResult") {
+            const text = message.content
+                .filter((part) => part.type === "text")
+                .map((part) => part.text)
+                .join("\n")
+                .trim();
+            items.push({
+                type: "function_call_output",
+                call_id: message.toolCallId,
+                output: message.isError ? `Error: ${text || "tool execution failed"}` : text || "ok",
+            });
+            const image = [...message.content].reverse().find((part) => part.type === "image");
+            if (image) {
+                items.push({
+                    role: "user",
+                    content: [
+                        { type: "input_text", text: "screenshot" },
+                        { type: "input_image", image_url: `data:${image.mimeType};base64,${image.data}`, detail: "auto" },
+                    ],
+                });
+            }
+        }
+    }
+    return items;
+}
+function convertUserContent(content) {
+    if (typeof content === "string")
+        return [{ type: "input_text", text: content }];
+    return content.map((part) => {
+        if (part.type === "text")
+            return { type: "input_text", text: part.text };
+        return { type: "input_image", image_url: `data:${part.mimeType};base64,${part.data}`, detail: "auto" };
+    });
+}
+function extractMessageText(item) {
+    return getArray(item, "content")
+        .map((block) => getString(block, "text"))
+        .filter(Boolean)
+        .join("\n")
+        .trim();
+}
+function parseArguments(value) {
+    const top = typeof value === "string" && value.trim()
+        ? safeJsonParse(value)
+        : value && typeof value === "object"
+            ? value
+            : {};
+    if (!top || typeof top !== "object")
+        return {};
+    // Tzafon sometimes nests JSON-encoded arrays/objects inside the top-level argument object
+    // (observed: { "actions": "[{...}]" }). Unwrap one level so consumers get real values.
+    const out = {};
+    for (const [key, val] of Object.entries(top)) {
+        out[key] = typeof val === "string" && looksLikeJson(val) ? safeJsonParse(val) ?? val : val;
+    }
+    return out;
+}
+function safeJsonParse(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function looksLikeJson(value) {
+    const trimmed = value.trim();
+    return trimmed.startsWith("[") || trimmed.startsWith("{");
+}
+function usageFromTzafon(usage) {
+    const input = readNumber(usage, "input_tokens");
+    const output = readNumber(usage, "output_tokens");
+    const cacheRead = readNumber(getValue(usage, "input_tokens_details"), "cached_tokens");
+    const totalTokens = readNumber(usage, "total_tokens") || input + output;
+    return {
+        input,
+        output,
+        cacheRead,
+        cacheWrite: 0,
+        totalTokens,
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+    };
+}
+function readNumber(obj, key) {
+    if (!obj || typeof obj !== "object")
+        return 0;
+    const n = obj[key];
+    return typeof n === "number" && Number.isFinite(n) ? n : 0;
+}
+function getArray(obj, key) {
+    const value = getValue(obj, key);
+    return Array.isArray(value) ? value : [];
+}
+function getString(obj, key) {
+    const value = getValue(obj, key);
+    return typeof value === "string" ? value : "";
+}
+function getValue(obj, key) {
+    if (!obj || typeof obj !== "object")
+        return undefined;
+    return obj[key];
+}
+//# sourceMappingURL=provider.js.map