@onkernel/cua-ai 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+- Provider-qualified CUA model catalog with support annotations and curated overrides.
+- Unified runtime-spec resolution for provider defaults (tools, prompts, payload middleware).
+- Registers CUA provider adapters and exports canonical computer-use schemas/tool definitions.

package/README.md

@@ -0,0 +1,229 @@
+# `@onkernel/cua-ai`
+
+Extension of [`@earendil-works/pi-ai`](https://www.npmjs.com/package/@earendil-works/pi-ai)'s
+unified LLM API with computer-use specific models, providers, and tool schemas
+for building CUA agents on Kernel.
+
+## Installation
+
+```bash
+npm install @onkernel/cua-ai
+```
+
+## Quick Start
+
+```ts
+import { readFile } from "node:fs/promises";
+import { complete, getCuaModel, openai } from "@onkernel/cua-ai";
+
+const screenshot = await readFile("examples/screenshot.png");
+
+const model = getCuaModel("openai:gpt-5.5");
+
+const response = await complete(model, {
+  systemPrompt: "You are a browser automation agent.",
+  messages: [
+    {
+      role: "user",
+      content: [
+        { type: "text", text: "Click the Login button in this screenshot." },
+        { type: "image", data: screenshot.toString("base64"), mimeType: "image/png" },
+      ],
+      timestamp: Date.now(),
+    },
+  ],
+  tools: openai.createComputerToolDefinitions({ actions: ["click"] }),
+});
+
+for (const block of response.content) {
+  if (block.type === "toolCall" && block.name === "click_mouse") {
+    console.log("click:", block.arguments);
+  }
+}
+```
+
+## Core Concepts
+
+`@onkernel/cua-ai` re-exports the core primitives of
+[`@earendil-works/pi-ai`](https://github.com/earendil-works/pi/tree/main/packages/ai):
+`Model`, `Context`, `Message`, `Tool`, `complete`, `stream`, `completeSimple`,
+`streamSimple`, `Type`, `Static`, `TSchema`, and the event/validation helpers
+that pi-ai exposes. Some familiarity with pi-ai is assumed; Kernel adds the
+computer-use model catalog and provider/tool metadata.
+
+### Model Refs
+
+`getCuaModel()` accepts only provider-qualified model refs of the form
+`<provider>:<model-id>`:
+
+```ts
+getCuaModel("openai:gpt-5.5");
+getCuaModel("anthropic:claude-opus-4-7");
+getCuaModel("google:gemini-2.5-computer-use-preview-10-2025");
+getCuaModel("tzafon:tzafon.northstar-cua-fast");
+getCuaModel("yutori:n1.5-latest");
+```
+
+`getCuaModel(ref)` returns a pi-ai `Model<Api>` you can pass to `complete()`
+or `stream()`.
+
+See [`docs/supported-models.md`](./docs/supported-models.md) for the current
+list of CUA-supporting models per provider.
+
+### CuaProvider
+
+`CuaProvider` is the string union of provider IDs this package targets:
+
+```ts
+type CuaProvider = "openai" | "anthropic" | "google" | "tzafon" | "yutori";
+```
+
+The IDs match pi-ai's `Model.provider` values exactly. `providerForModel(model)`
+narrows a pi-ai `Model<Api>` to a `CuaProvider`.
+
+### Listing Models
+
+`listCuaModels(provider?)` returns every CUA-supporting model, optionally
+filtered to one provider:
+
+```ts
+interface CuaModelInfo {
+  ref: CuaModelRef;
+  provider: CuaProvider;
+  model: string;
+  name: string;
+}
+```
+
+### Exports
+
+Top-level exports:
+
+- `getCuaModel(ref: CuaModelRef): Model<Api>`
+- `listCuaModels(provider?: CuaProvider): CuaModelInfo[]`
+- `providerForModel(model: Model<Api>): CuaProvider`
+- `resolveCuaRuntimeSpec(input: CuaModelRef | Model<Api>): CuaRuntimeSpec`
+- `CUA_PROVIDERS: readonly CuaProvider[]`
+- `CuaBatchSchema`, `CuaActionSchema`, `CuaNavigationSchema` TypeBox schemas
+- `createCuaActionSchema(actions?)`, `createCuaBatchSchema(actions?)`
+
+`resolveCuaRuntimeSpec()` centralizes provider-specific defaults for
+runtime consumers:
+
+- canonical provider id
+- canonical CUA tool definitions
+- default system prompt text
+- optional provider payload middleware (for protocol quirks)
+
+Provider namespaces expose `createComputerToolDefinitions({ actions? })` for
+building model-facing pi-ai `Tool[]` definitions. Omit `actions` for the
+provider's default computer tool set, or pass an action subset to narrow the
+schema for a single `complete()` call:
+
+```ts
+import { openai } from "@onkernel/cua-ai";
+
+const allComputerTools = openai.createComputerToolDefinitions();
+const clickOnlyTools = openai.createComputerToolDefinitions({ actions: ["click"] });
+```
+
+Every provider namespace synthesizes a `batch_computer_actions` tool definition.
+That gives models a consistent way to plan ordered browser actions even when the
+provider's native computer-use API has a different shape. Provider namespaces
+are still used so the definitions can diverge over time where provider protocol
+differences matter.
+
+Provider namespaces also expose `COMPUTER_TOOL_COORDINATES`, which describes
+the coordinates the provider's computer tool calls are expected to emit:
+
+```ts
+openai.COMPUTER_TOOL_COORDINATES
+// { type: "pixel" }
+
+gemini.COMPUTER_TOOL_COORDINATES
+// { type: "normalized", range: [0, 999] }
+```
+
+Current coordinate contracts:
+
+- `openai`: pixel coordinates
+- `anthropic`: pixel coordinates
+- `gemini`: normalized coordinates in the 0-999 range ([source](https://ai.google.dev/gemini-api/docs/computer-use))
+- `yutori`: normalized coordinates in the 0-1000 range ([source](https://docs.yutori.com/reference/navigator), [SDK helper](https://github.com/yutori-ai/yutori-sdk-python/blob/main/yutori/navigator/coordinates.py))
+- `tzafon`: normalized coordinates in the 0-999 range ([source](https://docs.lightcone.ai/guides/coordinates/), [model card](https://huggingface.co/Tzafon/Northstar-CUA-Fast))
+
+The action vocabulary is intentionally provider-neutral and OpenAI-shaped
+because it maps cleanly to most browser computer-use APIs:
+
+```ts
+type CuaAction =
+  | CuaActionClick
+  | CuaActionDoubleClick
+  | CuaActionMouseDown
+  | CuaActionMouseUp
+  | CuaActionTypeText
+  | CuaActionKeypress
+  | CuaActionScroll
+  | CuaActionMove
+  | CuaActionDrag
+  | CuaActionWait
+  | CuaActionScreenshot
+  | CuaActionGoto
+  | CuaActionBack
+  | CuaActionForward
+  | CuaActionUrl
+  | CuaActionCursorPosition;
+```
+
+For example:
+
+```ts
+type CuaActionClick = {
+  type: "click";
+  x: number;
+  y: number;
+  button?: string;
+  hold_keys?: string[];
+};
+
+type CuaActionGoto = {
+  type: "goto";
+  url: string;
+};
+```
+
+The provider namespace `createComputerToolDefinitions()` emits a
+`batch_computer_actions` tool whose input is:
+
+```ts
+type CuaBatchInput = {
+  actions: CuaAction[];
+};
+```
+
+The model can plan several writes and reads in one call. Read actions such as
+`screenshot`, `url`, and `cursor_position` can be interleaved with writes so
+your executor can return fresh state in the same order.
+
+When `actions` is omitted, the OpenAI namespace also emits a `computer_use_extra`
+navigation tool whose input is:
+
+```ts
+type CuaNavigationInput = {
+  action: "goto" | "back" | "forward" | "url";
+  url?: string;
+};
+```
+
+Provider namespaces:
+
+- `openai`: `createComputerToolDefinitions`, `COMPUTER_TOOL_COORDINATES`, OpenAI CUA action schemas, and `OPENAI_BATCH_INSTRUCTIONS`
+- `anthropic`: `createComputerToolDefinitions`, `COMPUTER_TOOL_COORDINATES`, prompt helpers, and CUA batch schema aliases
+- `gemini`: `createComputerToolDefinitions`, `COMPUTER_TOOL_COORDINATES`, prompt helpers, and CUA batch schema aliases
+- `tzafon`: `createComputerToolDefinitions`, `COMPUTER_TOOL_COORDINATES`, prompt helpers, and local `tzafon-responses` stream adapter
+- `yutori`: Yutori prompt helpers, local `yutori-chat-completions` stream
+  adapter, `createComputerToolDefinitions`, `COMPUTER_TOOL_COORDINATES`, and
+  `yutoriBuiltinToolsOnPayload`
+
+This package does not execute browser actions. Use `@onkernel/cua-agent` when
+you want model tool calls executed against a Kernel browser.

package/dist/api-keys.d.ts

@@ -0,0 +1,8 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { type CuaModelRef } from "./models.js";
+export declare function cuaApiKeyEnvVarsForProvider(provider: string): readonly string[];
+export declare function getCuaEnvApiKey(provider: string): string | undefined;
+export declare function requireCuaEnvApiKey(provider: string): string;
+export declare function getCuaEnvApiKeyForModel(input: CuaModelRef | Model<Api>): string | undefined;
+export declare function requireCuaEnvApiKeyForModel(input: CuaModelRef | Model<Api>): string;
+//# sourceMappingURL=api-keys.d.ts.map

package/dist/api-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../src/api-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAsC,KAAK,WAAW,EAAoB,MAAM,UAAU,CAAC;AAiBlG,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAK/E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMpE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,SAAS,CAG3F;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,CAGnF"}

package/dist/api-keys.js

@@ -0,0 +1,48 @@
+import { parseCuaModelRef, providerForModel } from "./models";
+/**
+ * Environment variables accepted for each CUA provider.
+ *
+ * This mirrors pi-ai's approach: model lookup is pure, while auth is resolved
+ * when streaming. These helpers let callers share one readable convention for
+ * explicit `getApiKey` wiring (especially useful for `google` vs `gemini`).
+ */
+const CUA_PROVIDER_API_KEY_ENV_VARS = {
+    openai: ["OPENAI_API_KEY"],
+    anthropic: ["ANTHROPIC_OAUTH_TOKEN", "ANTHROPIC_API_KEY"],
+    google: ["GOOGLE_API_KEY", "GEMINI_API_KEY"],
+    tzafon: ["TZAFON_API_KEY"],
+    yutori: ["YUTORI_API_KEY"],
+};
+export function cuaApiKeyEnvVarsForProvider(provider) {
+    if (provider === "gemini") {
+        return CUA_PROVIDER_API_KEY_ENV_VARS.google;
+    }
+    return CUA_PROVIDER_API_KEY_ENV_VARS[provider] ?? [];
+}
+export function getCuaEnvApiKey(provider) {
+    for (const envVar of cuaApiKeyEnvVarsForProvider(provider)) {
+        const value = process.env[envVar];
+        if (value?.trim())
+            return value;
+    }
+    return undefined;
+}
+export function requireCuaEnvApiKey(provider) {
+    const apiKey = getCuaEnvApiKey(provider);
+    if (apiKey)
+        return apiKey;
+    const envVars = cuaApiKeyEnvVarsForProvider(provider);
+    if (envVars.length === 0) {
+        throw new Error(`No known API key environment variables for provider "${provider}"`);
+    }
+    throw new Error(`Missing API key for "${provider}". Set one of: ${envVars.join(", ")}`);
+}
+export function getCuaEnvApiKeyForModel(input) {
+    const provider = typeof input === "string" ? parseCuaModelRef(input).provider : providerForModel(input);
+    return getCuaEnvApiKey(provider);
+}
+export function requireCuaEnvApiKeyForModel(input) {
+    const provider = typeof input === "string" ? parseCuaModelRef(input).provider : providerForModel(input);
+    return requireCuaEnvApiKey(provider);
+}
+//# sourceMappingURL=api-keys.js.map

package/dist/api-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-keys.js","sourceRoot":"","sources":["../src/api-keys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAsC,MAAM,UAAU,CAAC;AAElG;;;;;;GAMG;AACH,MAAM,6BAA6B,GAA2C;IAC7E,MAAM,EAAE,CAAC,gBAAgB,CAAC;IAC1B,SAAS,EAAE,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IACzD,MAAM,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,MAAM,EAAE,CAAC,gBAAgB,CAAC;IAC1B,MAAM,EAAE,CAAC,gBAAgB,CAAC;CAC1B,CAAC;AAEF,MAAM,UAAU,2BAA2B,CAAC,QAAgB;IAC3D,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,6BAA6B,CAAC,MAAM,CAAC;IAC7C,CAAC;IACD,OAAO,6BAA6B,CAAC,QAAsD,CAAC,IAAI,EAAE,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC/C,KAAK,MAAM,MAAM,IAAI,2BAA2B,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IACnD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,OAAO,GAAG,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wDAAwD,QAAQ,GAAG,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAA+B;IACtE,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxG,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAA+B;IAC1E,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxG,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "@earendil-works/pi-ai";
+export * from "./models.js";
+export * from "./api-keys.js";
+export * from "./runtime-spec.js";
+export * from "./providers/common.js";
+export * as anthropic from "./providers/anthropic/index.js";
+export * as gemini from "./providers/gemini/index.js";
+export * as openai from "./providers/openai/index.js";
+export * as tzafon from "./providers/tzafon/index.js";
+export * as yutori from "./providers/yutori/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,uBAAuB,CAAC;AAEtC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,SAAS,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { registerCuaProviders } from "./providers";
+export * from "@earendil-works/pi-ai";
+export * from "./models";
+export * from "./api-keys";
+export * from "./runtime-spec";
+export * from "./providers/common";
+export * as anthropic from "./providers/anthropic/index";
+export * as gemini from "./providers/gemini/index";
+export * as openai from "./providers/openai/index";
+export * as tzafon from "./providers/tzafon/index";
+export * as yutori from "./providers/yutori/index";
+registerCuaProviders();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,cAAc,uBAAuB,CAAC;AAEtC,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,SAAS,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,0BAA0B,CAAC;AAEnD,oBAAoB,EAAE,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,33 @@
+import { type Api, type Model } from "@earendil-works/pi-ai";
+export type CuaProvider = "openai" | "anthropic" | "google" | "tzafon" | "yutori";
+export type CuaModelRef = `${CuaProvider}:${string}`;
+export interface CuaModelInfo {
+    ref: CuaModelRef;
+    provider: CuaProvider;
+    model: string;
+    name: string;
+}
+export declare const CUA_PROVIDERS: readonly CuaProvider[];
+export type CuaModelMatch = {
+    readonly kind: "exact";
+    readonly id: string;
+} | {
+    readonly kind: "family";
+    readonly family: string;
+};
+export interface CuaModelAnnotation {
+    readonly match: CuaModelMatch;
+    readonly source: string;
+}
+export declare const CUA_MODEL_ANNOTATIONS: Record<CuaProvider, readonly CuaModelAnnotation[]>;
+export declare function parseCuaModelRef(ref: string): {
+    provider: CuaProvider;
+    model: string;
+};
+export declare function formatCuaModelRef(provider: CuaProvider, model: string): CuaModelRef;
+export declare function listCuaModels(provider?: CuaProvider): CuaModelInfo[];
+export declare function getCuaModel(ref: CuaModelRef): Model<Api>;
+export declare function providerForModel(model: Model<Api>): CuaProvider;
+export declare function isCuaProvider(value: string): value is CuaProvider;
+export declare function findCuaAnnotation(provider: CuaProvider, modelId: string): CuaModelAnnotation | undefined;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,GAAG,EACR,KAAK,KAAK,EAGV,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAClF,MAAM,MAAM,WAAW,GAAG,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC;AAErD,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAA0D,CAAC;AAiB3G,MAAM,MAAM,aAAa,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAyBpF,CAAC;AA2BF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWtF;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAEnF;AAED,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE,CAuBpE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAUxD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,WAAW,CAK/D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAWxG"}

package/dist/models.js

@@ -0,0 +1,159 @@
+import { getModel, getModels, } from "@earendil-works/pi-ai";
+export const CUA_PROVIDERS = ["openai", "anthropic", "google", "tzafon", "yutori"];
+export const CUA_MODEL_ANNOTATIONS = {
+    openai: [
+        { match: { kind: "family", family: "gpt-5.4" }, source: "https://developers.openai.com/api/docs/models/gpt-5.4" },
+        { match: { kind: "family", family: "gpt-5.5" }, source: "https://developers.openai.com/api/docs/models/gpt-5.5" },
+    ],
+    anthropic: [
+        { match: { kind: "family", family: "claude-3-7-sonnet" }, source: "https://docs.anthropic.com/en/docs/build-with-claude/computer-use" },
+        { match: { kind: "family", family: "claude-opus-4" }, source: "https://docs.anthropic.com/en/docs/build-with-claude/computer-use" },
+        { match: { kind: "family", family: "claude-sonnet-4" }, source: "https://docs.anthropic.com/en/docs/build-with-claude/computer-use" },
+        { match: { kind: "family", family: "claude-haiku-4" }, source: "https://docs.anthropic.com/en/docs/build-with-claude/computer-use" },
+    ],
+    google: [
+        { match: { kind: "exact", id: "gemini-3-flash-preview" }, source: "https://ai.google.dev/gemini-api/docs/computer-use" },
+        { match: { kind: "exact", id: "gemini-3-pro-preview" }, source: "https://ai.google.dev/gemini-api/docs/computer-use" },
+        { match: { kind: "exact", id: "gemini-2.5-computer-use-preview-10-2025" }, source: "https://ai.google.dev/gemini-api/docs/computer-use" },
+    ],
+    tzafon: [
+        { match: { kind: "exact", id: "tzafon.northstar-cua-fast" }, source: "https://huggingface.co/Tzafon/Northstar-CUA-Fast" },
+    ],
+    yutori: [
+        { match: { kind: "exact", id: "n1-latest" }, source: "https://docs.yutori.com/reference/navigator" },
+        { match: { kind: "exact", id: "n1-20260203" }, source: "https://docs.yutori.com/reference/navigator" },
+        { match: { kind: "exact", id: "n1.5-latest" }, source: "https://docs.yutori.com/reference/navigator" },
+        { match: { kind: "exact", id: "n1.5-20260428" }, source: "https://docs.yutori.com/reference/navigator" },
+    ],
+};
+// Models that CUA supports which pi-ai's registry does not yet carry. Each
+// entry is a complete Model<Api> so getCuaModel() can return it directly
+// without synthesizing fields at call time. Add an entry here when a provider
+// ships a new model before pi-ai picks it up — and add a matching annotation
+// in CUA_MODEL_ANNOTATIONS above so the support filter recognizes it.
+const CUA_MODEL_OVERRIDES = {
+    openai: [
+        cuaModel("openai", "gpt-5.5", "GPT-5.5"),
+        cuaModel("openai", "gpt-5.5-2026-04-23", "GPT-5.5 (2026-04-23)"),
+    ],
+    anthropic: [],
+    google: [
+        cuaModel("google", "gemini-2.5-computer-use-preview-10-2025", "Gemini 2.5 Computer Use Preview"),
+    ],
+    tzafon: [
+        cuaModel("tzafon", "tzafon.northstar-cua-fast", "Tzafon Northstar CUA Fast"),
+    ],
+    yutori: [
+        cuaModel("yutori", "n1.5-latest", "Yutori Navigator n1.5"),
+        cuaModel("yutori", "n1.5-20260428", "Yutori Navigator n1.5 (2026-04-28)"),
+        cuaModel("yutori", "n1-latest", "Yutori Navigator n1"),
+        cuaModel("yutori", "n1-20260203", "Yutori Navigator n1 (2026-02-03)"),
+    ],
+};
+export function parseCuaModelRef(ref) {
+    const idx = ref.indexOf(":");
+    if (idx <= 0 || idx === ref.length - 1) {
+        throw new Error(`CUA model ref must be provider-qualified as "<provider>:<model>"; got "${ref}"`);
+    }
+    const provider = ref.slice(0, idx);
+    const model = ref.slice(idx + 1);
+    if (!isCuaProvider(provider)) {
+        throw new Error(`unsupported CUA provider "${provider}"`);
+    }
+    return { provider, model };
+}
+export function formatCuaModelRef(provider, model) {
+    return `${provider}:${model}`;
+}
+export function listCuaModels(provider) {
+    const providers = provider ? [provider] : [...CUA_PROVIDERS];
+    const byRef = new Map();
+    for (const p of providers) {
+        for (const model of CUA_MODEL_OVERRIDES[p]) {
+            const ref = formatCuaModelRef(p, model.id);
+            byRef.set(ref, { ref, provider: p, model: model.id, name: model.name });
+        }
+        for (const model of getModels(p)) {
+            if (!supportsCuaProvider(p, model.id))
+                continue;
+            const ref = formatCuaModelRef(p, model.id);
+            if (byRef.has(ref))
+                continue;
+            byRef.set(ref, {
+                ref,
+                provider: p,
+                model: model.id,
+                name: model.name,
+            });
+        }
+    }
+    return [...byRef.values()].sort(compareCuaModels);
+}
+export function getCuaModel(ref) {
+    const { provider, model: modelId } = parseCuaModelRef(ref);
+    if (!supportsCuaProvider(provider, modelId)) {
+        throw new Error(`unsupported CUA model "${ref}"`);
+    }
+    const fromRegistry = getModel(provider, modelId);
+    if (fromRegistry)
+        return fromRegistry;
+    const override = CUA_MODEL_OVERRIDES[provider].find((m) => m.id === modelId);
+    if (override)
+        return override;
+    throw new Error(`CUA model "${ref}" is supported but not registered. Add it to pi-ai (models.dev) or CUA_MODEL_OVERRIDES.`);
+}
+export function providerForModel(model) {
+    if (!isCuaProvider(model.provider)) {
+        throw new Error(`unsupported CUA model provider "${model.provider}"`);
+    }
+    return model.provider;
+}
+export function isCuaProvider(value) {
+    return CUA_PROVIDERS.includes(value);
+}
+function supportsCuaProvider(provider, modelId) {
+    return findCuaAnnotation(provider, modelId) !== undefined;
+}
+export function findCuaAnnotation(provider, modelId) {
+    const id = modelId.toLowerCase();
+    for (const annotation of CUA_MODEL_ANNOTATIONS[provider]) {
+        if (annotation.match.kind === "exact") {
+            if (id === annotation.match.id.toLowerCase())
+                return annotation;
+        }
+        else {
+            const family = annotation.match.family.toLowerCase();
+            if (id === family || id.startsWith(`${family}-`))
+                return annotation;
+        }
+    }
+    return undefined;
+}
+function cuaModel(provider, id, name) {
+    const base = {
+        id,
+        name,
+        provider,
+        reasoning: provider === "openai" || provider === "anthropic" || provider === "google",
+        input: ["text", "image"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+    };
+    switch (provider) {
+        case "openai":
+            return { ...base, api: "openai-responses", baseUrl: "https://api.openai.com/v1", contextWindow: 400_000, maxTokens: 32_768 };
+        case "anthropic":
+            return { ...base, api: "anthropic-messages", baseUrl: "https://api.anthropic.com", contextWindow: 200_000, maxTokens: 64_000 };
+        case "google":
+            return { ...base, api: "google-generative-ai", baseUrl: "https://generativelanguage.googleapis.com/v1beta", contextWindow: 1_048_576, maxTokens: 65_536 };
+        case "tzafon":
+            return { ...base, api: "tzafon-responses", baseUrl: "https://api.lightcone.ai", contextWindow: 128_000, maxTokens: 4_096 };
+        case "yutori":
+            return { ...base, api: "yutori-chat-completions", baseUrl: "https://api.yutori.com/v1", contextWindow: 128_000, maxTokens: 4_096 };
+    }
+}
+function compareCuaModels(a, b) {
+    if (a.provider !== b.provider)
+        return CUA_PROVIDERS.indexOf(a.provider) - CUA_PROVIDERS.indexOf(b.provider);
+    return a.model.localeCompare(b.model);
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

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

@@ -0,0 +1,10 @@
+export { CUA_ACTION_TYPES as ANTHROPIC_CUA_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as ANTHROPIC_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as ANTHROPIC_BATCH_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as AnthropicBatchSchema, } from "../common.js";
+export type { CuaAction as AnthropicAction, CreateComputerToolDefinitionsOptions, CuaBatchInput as AnthropicBatchInput, } from "../common.js";
+export declare const COMPUTER_TOOL_COORDINATES: {
+    readonly type: "pixel";
+};
+export declare const ANTHROPIC_COMPUTER_INSTRUCTIONS = "You control a Kernel cloud browser through computer-use tools. Use batched actions for predictable browser interaction, keyboard navigation where possible, and explicit screenshot or url reads when you need to inspect state.";
+export declare function buildAnthropicSystemPrompt(opts?: {
+    suffix?: string;
+}): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/anthropic/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,0BAA0B,EAC9C,0BAA0B,IAAI,2BAA2B,EACzD,mBAAmB,IAAI,yBAAyB,EAChD,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,oBAAoB,GACtC,MAAM,WAAW,CAAC;AACnB,YAAY,EACX,SAAS,IAAI,eAAe,EAC5B,oCAAoC,EACpC,aAAa,IAAI,mBAAmB,GACpC,MAAM,WAAW,CAAC;AAWnB,eAAO,MAAM,yBAAyB;;CAAoE,CAAC;AAE3G,eAAO,MAAM,+BAA+B,qOAAqO,CAAC;AAElR,wBAAgB,0BAA0B,CAAC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAEjF"}

package/dist/providers/anthropic/index.js

@@ -0,0 +1,16 @@
+export { CUA_ACTION_TYPES as ANTHROPIC_CUA_ACTION_TYPES, CUA_BATCH_TOOL_DESCRIPTION as ANTHROPIC_BATCH_DESCRIPTION, CUA_BATCH_TOOL_NAME as ANTHROPIC_BATCH_TOOL_NAME, createComputerToolDefinitions, createCuaActionSchema as createActionSchema, createCuaBatchSchema as createBatchSchema, CuaBatchSchema as AnthropicBatchSchema, } from "../common.js";
+// Provider-native action vocabulary emitted on `tool_use.input.action`. Latest
+// tool version is `computer_20251124`, which extends earlier dated versions:
+//   computer_20241022: key, type, mouse_move, left_click, left_click_drag,
+//                      right_click, middle_click, double_click, screenshot,
+//                      cursor_position
+//   computer_20250124: + left_mouse_down, left_mouse_up, scroll, hold_key,
+//                        wait, triple_click
+//   computer_20251124: + zoom
+// Source: https://github.com/anthropics/anthropic-quickstarts/blob/main/computer-use-demo/computer_use_demo/tools/computer.py
+export const COMPUTER_TOOL_COORDINATES = { type: "pixel" };
+export const ANTHROPIC_COMPUTER_INSTRUCTIONS = `You control a Kernel cloud browser through computer-use tools. Use batched actions for predictable browser interaction, keyboard navigation where possible, and explicit screenshot or url reads when you need to inspect state.`;
+export function buildAnthropicSystemPrompt(opts = {}) {
+    return [ANTHROPIC_COMPUTER_INSTRUCTIONS, opts.suffix].filter(Boolean).join("\n\n");
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/anthropic/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,gBAAgB,IAAI,0BAA0B,EAC9C,0BAA0B,IAAI,2BAA2B,EACzD,mBAAmB,IAAI,yBAAyB,EAChD,6BAA6B,EAC7B,qBAAqB,IAAI,kBAAkB,EAC3C,oBAAoB,IAAI,iBAAiB,EACzC,cAAc,IAAI,oBAAoB,GACtC,MAAM,WAAW,CAAC;AAOnB,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,4EAA4E;AAC5E,uCAAuC;AACvC,2EAA2E;AAC3E,4CAA4C;AAC5C,8BAA8B;AAC9B,8HAA8H;AAC9H,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,IAAI,EAAE,OAAO,EAAkD,CAAC;AAE3G,MAAM,CAAC,MAAM,+BAA+B,GAAG,kOAAkO,CAAC;AAElR,MAAM,UAAU,0BAA0B,CAAC,OAA4B,EAAE;IACxE,OAAO,CAAC,+BAA+B,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACpF,CAAC"}