@onkernel/cua-agent 0.0.1 → 0.2.0

package/dist/vendor/pi-agent-core/types.d.ts.map

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

package/dist/vendor/pi-agent-core/types.js

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

package/dist/vendor/pi-agent-core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/vendor/pi-agent-core/types.ts"],"names":[],"mappings":""}

package/examples/agent-openai-smoke.ts

@@ -1,6 +1,7 @@
 import Kernel from "@onkernel/sdk";
 import { requireCuaEnvApiKeyForModel, type CuaModelRef } from "@onkernel/cua-ai";
 import { CuaAgent } from "../src/index";
+import { logAgentEvent, logAssistant } from "./shared/logging";
 import { SCENARIOS } from "./shared/scenarios";
 
 const modelRef = (process.env.MODEL_REF as CuaModelRef | undefined) ?? "openai:gpt-5.5";
@@ -19,20 +20,13 @@ async function main(): Promise<void> {
 			initialState: { model: modelRef },
 		});
 
-		agent.subscribe((event) => {
-			if (event.type === "tool_execution_start") {
-				console.log(`[tool:start] ${event.toolName}`);
-			}
-			if (event.type === "tool_execution_end") {
-				console.log(`[tool:end] ${event.toolName} error=${event.isError}`);
-			}
-		});
+		agent.subscribe(logAgentEvent);
 
 		const scenario = SCENARIOS[0]!;
-		console.log(`running scenario: ${scenario.name}`);
+		console.log(`running scenario: ${scenario.name} model=${modelRef}`);
 		await agent.prompt(scenario.prompt);
 		const assistant = [...agent.state.messages].reverse().find((message) => message.role === "assistant");
-		console.log("assistant stopReason:", assistant?.role === "assistant" ? assistant.stopReason : "unknown");
+		logAssistant(assistant?.role === "assistant" ? assistant : undefined);
 	} finally {
 		await client.browsers.deleteByID(browser.session_id);
 	}

package/examples/agent-provider-matrix.ts

@@ -1,6 +1,7 @@
 import Kernel from "@onkernel/sdk";
 import { requireCuaEnvApiKeyForModel, type CuaModelRef } from "@onkernel/cua-ai";
 import { CuaAgent } from "../src/index";
+import { logAgentEvent, logAssistant } from "./shared/logging";
 import { SCENARIOS } from "./shared/scenarios";
 
 const modelRef = (process.env.MODEL_REF as CuaModelRef | undefined) ?? "openai:gpt-5.5";
@@ -20,8 +21,11 @@ async function main(): Promise<void> {
 			client,
 			initialState: { model: modelRef },
 		});
+		agent.subscribe(logAgentEvent);
 		console.log(`model=${modelRef} scenario=${scenario.name}`);
 		await agent.prompt(scenario.prompt);
+		const assistant = [...agent.state.messages].reverse().find((message) => message.role === "assistant");
+		logAssistant(assistant?.role === "assistant" ? assistant : undefined);
 	} finally {
 		await client.browsers.deleteByID(browser.session_id);
 	}

package/examples/harness-openai-smoke.ts

@@ -1,6 +1,7 @@
 import Kernel from "@onkernel/sdk";
 import { requireCuaEnvApiKeyForModel, type CuaModelRef } from "@onkernel/cua-ai";
-import { CuaHarness } from "../src/index";
+import { CuaAgentHarness, InMemorySessionRepo, NodeExecutionEnv } from "../src/index";
+import { logAgentEvent, logAssistant } from "./shared/logging";
 import { SCENARIOS } from "./shared/scenarios";
 
 const modelRef = (process.env.MODEL_REF as CuaModelRef | undefined) ?? "openai:gpt-5.5";
@@ -13,28 +14,28 @@ async function main(): Promise<void> {
 	const browser = await client.browsers.create({ stealth: true });
 
 	try {
-		const harness = new CuaHarness({
+		const sessionRepo = new InMemorySessionRepo();
+		const session = await sessionRepo.create({ id: "harness-openai-smoke" });
+		const harness = new CuaAgentHarness({
 			browser,
 			client,
+			env: new NodeExecutionEnv({ cwd: process.cwd() }),
 			model: modelRef,
+			session,
 		});
 
-		harness.subscribe((event) => {
-			if (event.type === "tool_execution_start") {
-				console.log(`[tool:start] ${event.toolName}`);
-			}
-			if (event.type === "tool_execution_end") {
-				console.log(`[tool:end] ${event.toolName} error=${event.isError}`);
-			}
-		});
+		harness.subscribe(logAgentEvent);
 
 		const scenario = SCENARIOS[0]!;
-		console.log(`running scenario: ${scenario.name}`);
-		await harness.prompt(scenario.prompt);
-		const transcript = harness.getTranscript();
-		const lastAssistant = [...transcript].reverse().find((message) => message.role === "assistant");
-		console.log("transcript messages:", transcript.length);
-		console.log("assistant stopReason:", lastAssistant?.role === "assistant" ? lastAssistant.stopReason : "unknown");
+		console.log(`running scenario: ${scenario.name} model=${modelRef}`);
+		const response = await harness.prompt(scenario.prompt);
+		const branch = await session.getBranch();
+		const lastAssistant = [...branch]
+			.reverse()
+			.flatMap((entry) =>
+				entry.type === "message" && entry.message.role === "assistant" ? [entry.message] : [],
+			)[0];
+		logAssistant(lastAssistant ?? response);
 	} finally {
 		await client.browsers.deleteByID(browser.session_id);
 	}

package/examples/harness-provider-matrix.ts

@@ -1,6 +1,7 @@
 import Kernel from "@onkernel/sdk";
 import { requireCuaEnvApiKeyForModel, type CuaModelRef } from "@onkernel/cua-ai";
-import { CuaHarness } from "../src/index";
+import { CuaAgentHarness, InMemorySessionRepo, NodeExecutionEnv } from "../src/index";
+import { logAgentEvent, logAssistant } from "./shared/logging";
 import { SCENARIOS } from "./shared/scenarios";
 
 const modelRef = (process.env.MODEL_REF as CuaModelRef | undefined) ?? "openai:gpt-5.5";
@@ -15,14 +16,25 @@ async function main(): Promise<void> {
 	const scenario = SCENARIOS.find((entry) => entry.name === scenarioName) ?? SCENARIOS[0]!;
 
 	try {
-		const harness = new CuaHarness({
+		const sessionRepo = new InMemorySessionRepo();
+		const session = await sessionRepo.create({ id: `harness-provider-matrix-${scenario.name}` });
+		const harness = new CuaAgentHarness({
 			browser,
 			client,
+			env: new NodeExecutionEnv({ cwd: process.cwd() }),
 			model: modelRef,
+			session,
 		});
+		harness.subscribe(logAgentEvent);
 		console.log(`model=${modelRef} scenario=${scenario.name}`);
-		await harness.prompt(scenario.prompt);
-		console.log("transcript messages:", harness.getTranscript().length);
+		const response = await harness.prompt(scenario.prompt);
+		const branch = await session.getBranch();
+		const lastAssistant = [...branch]
+			.reverse()
+			.flatMap((entry) =>
+				entry.type === "message" && entry.message.role === "assistant" ? [entry.message] : [],
+			)[0];
+		logAssistant(lastAssistant ?? response);
 	} finally {
 		await client.browsers.deleteByID(browser.session_id);
 	}

package/examples/shared/logging.ts

@@ -0,0 +1,37 @@
+import type { AgentEvent, AgentHarnessEvent } from "../../src/index";
+
+type AssistantLike = {
+	content: Array<{ type: string; text?: string }>;
+	stopReason?: string;
+};
+
+export function logAgentEvent(event: AgentEvent | AgentHarnessEvent): void {
+	if (event.type === "tool_execution_start") {
+		console.log(`[tool:start] ${event.toolName} args=${formatJson(event.args)}`);
+		return;
+	}
+	if (event.type === "tool_execution_end") {
+		const result = event.result as { details?: unknown } | undefined;
+		console.log(`[tool:end] ${event.toolName} error=${event.isError}${formatDetails(result?.details)}`);
+	}
+}
+
+export function logAssistant(assistant: AssistantLike | undefined): void {
+	const text =
+		assistant?.content
+			.flatMap((block) => (block.type === "text" && typeof block.text === "string" ? [block.text] : []))
+			.join("")
+			.trim() ?? "";
+	console.log("assistant stopReason:", assistant?.stopReason ?? "unknown");
+	console.log("assistant text:", text || "(no text)");
+}
+
+function formatDetails(details: unknown): string {
+	if (!details) return "";
+	return ` details=${formatJson(details)}`;
+}
+
+function formatJson(value: unknown): string {
+	const text = JSON.stringify(value, null, 2) ?? "undefined";
+	return text.length > 1200 ? `${text.slice(0, 1197)}...` : text;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/cua-agent",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Kernel browser computer-use Agent and AgentHarness classes built on pi-agent-core",
   "license": "MIT",
   "type": "module",
@@ -26,7 +26,9 @@
     "dist",
     "examples",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "src/vendor/pi-agent-core/LICENSE",
+    "src/vendor/pi-agent-core/README.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -39,10 +41,10 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@earendil-works/pi-agent-core": "^0.74.0",
     "@earendil-works/pi-ai": "^0.74.0",
-    "@onkernel/cua-ai": "0.0.1",
-    "@onkernel/sdk": "0.49.0"
+    "@onkernel/cua-ai": "0.1.0",
+    "@onkernel/sdk": "0.49.0",
+    "typebox": "^1.1.38"
   },
   "devDependencies": {
     "vitest": "^3.2.4"

package/src/vendor/pi-agent-core/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/src/vendor/pi-agent-core/README.md

@@ -0,0 +1,15 @@
+# Vendored pi agent core
+
+These files are copied from `earendil-works/pi` so `@onkernel/cua-agent` can use
+pi's `AgentHarness` and `prepareNextTurn` support before the upstream npm
+package includes them.
+
+Source: https://github.com/earendil-works/pi/tree/40c05f55391663024a6a05ad33249b616a04e7a1/packages/agent/src
+
+License: MIT. See `LICENSE`, copied from the same pinned commit.
+
+Regenerate with:
+
+```bash
+npx tsx packages/agent/scripts/vendor-pi-agent-harness.ts
+```