Merge origin/main into hypeship/unified-cua-template

Bring in main branch template updates and resolve the registry overlap by keeping both the unified CUA and Tzafon template entries.

Made-with: Cursor

Author: masnwilliams

.github/workflows/semgrep.yml

@@ -0,0 +1,17 @@
+name: Semgrep
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  scan:
+    uses: kernel/security-workflows/.github/workflows/semgrep.yml@main
+    with:
+      extra-configs: '--config p/golang --config p/trailofbits'
+      codebase-description: 'Kernel CLI tool authenticating with customer API keys'
+    secrets: inherit

.semgrepignore

@@ -0,0 +1,5 @@
+node_modules/
+vendor/
+dist/
+*_test.go
+go.sum

cmd/browsers.go

@@ -15,6 +15,7 @@ import (
 	"strconv"
 	"strings"
 
+	"github.com/kernel/cli/pkg/table"
 	"github.com/kernel/cli/pkg/util"
 	"github.com/kernel/kernel-go-sdk"
 	"github.com/kernel/kernel-go-sdk/option"
@@ -3256,6 +3257,9 @@ func runBrowsersComputerWriteClipboard(cmd *cobra.Command, args []string) error
 }
 
 func truncateURL(url string, maxLen int) string {
+	if !table.IsStdoutTTY() {
+		return url
+	}
 	if len(url) <= maxLen {
 		return url
 	}

pkg/create/templates.go

@@ -20,6 +20,7 @@ const (
 	TemplateClaudeAgentSDK       = "claude-agent-sdk"
 	TemplateYutoriComputerUse    = "yutori"
 	TemplateUnifiedCUA           = "cua"
+	TemplateTzafonComputerUse    = "tzafon"
 )
 
 type TemplateInfo struct {
@@ -96,6 +97,11 @@ var Templates = map[string]TemplateInfo{
 		Description: "Multi-provider computer use agent with Anthropic/OpenAI/Gemini fallback",
 		Languages:   []string{LanguageTypeScript, LanguagePython},
 	},
+	TemplateTzafonComputerUse: {
+		Name:        "Tzafon Northstar Computer Use",
+		Description: "Implements a Tzafon Northstar CUA Fast computer use agent",
+		Languages:   []string{LanguageTypeScript, LanguagePython},
+	},
 }
 
 // GetSupportedTemplatesForLanguage returns a list of all supported template names for a given language
@@ -122,6 +128,10 @@ func GetSupportedTemplatesForLanguage(language string) TemplateKeyValues {
 				return 2
 			case TemplateYutoriComputerUse:
 				return 3
+			case TemplateTzafonComputerUse:
+				return 4
+			case TemplateUnifiedCUA:
+				return 5
 			default:
 				return 10
 			}
@@ -224,6 +234,11 @@ var Commands = map[string]map[string]DeployConfig{
 			NeedsEnvFile:  true,
 			InvokeCommand: `kernel invoke ts-cua cua-task --payload '{"query": "Go to https://news.ycombinator.com and get the top 5 stories"}'`,
 		},
+		TemplateTzafonComputerUse: {
+			EntryPoint:    "index.ts",
+			NeedsEnvFile:  true,
+			InvokeCommand: `kernel invoke ts-tzafon-cua cua-task --payload '{"query": "Go to wikipedia.org and search for Alan Turing"}'`,
+		},
 	},
 	LanguagePython: {
 		TemplateSampleApp: {
@@ -276,6 +291,11 @@ var Commands = map[string]map[string]DeployConfig{
 			NeedsEnvFile:  true,
 			InvokeCommand: `kernel invoke python-cua cua-task --payload '{"query": "Go to https://news.ycombinator.com and get the top 5 stories"}'`,
 		},
+		TemplateTzafonComputerUse: {
+			EntryPoint:    "main.py",
+			NeedsEnvFile:  true,
+			InvokeCommand: `kernel invoke python-tzafon-cua cua-task --payload '{"query": "Go to wikipedia.org and search for Alan Turing"}'`,
+		},
 	},
 }
 

pkg/table/table.go

@@ -1,10 +1,12 @@
 package table
 
 import (
+	"os"
 	"strings"
 	"unicode/utf8"
 
 	"github.com/pterm/pterm"
+	"golang.org/x/term"
 )
 
 // PrintTableNoPad renders a table similar to pterm.DefaultTable, but it avoids
@@ -17,12 +19,15 @@ func PrintTableNoPad(data pterm.TableData, hasHeader bool) {
 		return
 	}
 
-	// Get terminal width and truncate data to fit
-	termWidth := pterm.GetTerminalWidth()
-	if termWidth <= 0 {
-		termWidth = 80 // fallback
+	// Only truncate columns when outputting to a terminal.
+	// When piped (non-TTY), output full values so grep/awk/etc. work correctly.
+	if term.IsTerminal(int(os.Stdout.Fd())) {
+		termWidth := pterm.GetTerminalWidth()
+		if termWidth <= 0 {
+			termWidth = 80 // fallback
+		}
+		data = truncateTableData(data, termWidth)
 	}
-	data = truncateTableData(data, termWidth)
 
 	// Determine number of columns from the first row
 	numCols := len(data[0])
@@ -90,6 +95,11 @@ func PrintTableNoPad(data pterm.TableData, hasHeader bool) {
 	pterm.Print(b.String())
 }
 
+// IsStdoutTTY reports whether stdout is connected to a terminal.
+func IsStdoutTTY() bool {
+	return term.IsTerminal(int(os.Stdout.Fd()))
+}
+
 // truncateTableData intelligently truncates table cells to fit within terminal width
 func truncateTableData(data pterm.TableData, termWidth int) pterm.TableData {
 	if len(data) == 0 {

pkg/templates/python/tzafon/.env.example

@@ -0,0 +1 @@
+TZAFON_API_KEY=your-tzafon-api-key

pkg/templates/python/tzafon/README.md

@@ -0,0 +1,57 @@
+# Kernel Python Sample App - Tzafon Northstar Computer Use
+
+This is a Kernel application that implements a CUA (computer use agent) loop using Tzafon's Northstar CUA Fast model with Kernel's Computer Controls API. The model is accessed via Tzafon's [Lightcone](https://docs.lightcone.ai) API platform.
+
+[Northstar CUA Fast](https://docs.lightcone.ai) is a vision language model trained with reinforcement learning for computer use tasks.
+
+## Setup
+
+1. Get your API keys:
+   - **Kernel**: [dashboard.onkernel.com](https://dashboard.onkernel.com)
+   - **Tzafon**: [tzafon.ai](https://www.tzafon.ai)
+
+2. Deploy the app:
+```bash
+kernel login
+cp .env.example .env  # Add your TZAFON_API_KEY
+kernel deploy main.py --env-file .env
+```
+
+## Usage
+
+```bash
+kernel invoke python-tzafon-cua cua-task --payload '{"query": "Go to wikipedia.org and search for Alan Turing"}'
+```
+
+## Recording Replays
+
+> **Note:** Replay recording is only available to Kernel users on paid plans.
+
+Add `"record_replay": true` to your payload to capture a video of the browser session:
+
+```bash
+kernel invoke python-tzafon-cua cua-task --payload '{"query": "Navigate to https://example.com", "record_replay": true}'
+```
+
+When enabled, the response will include a `replay_url` field with a link to view the recorded session.
+
+## Viewport Configuration
+
+Northstar CUA Fast works well with a **1280x800** viewport, which is the default.
+
+## Supported Actions
+
+| Action | Description |
+|--------|-------------|
+| `click` | Left or right mouse click at coordinates |
+| `double_click` | Double-click at coordinates |
+| `point_and_type` | Click at coordinates then type text (with optional Enter) |
+| `key` | Press key combo (e.g. `Enter`, `ctrl+a`) |
+| `scroll` | Scroll at coordinates |
+| `drag` | Click-and-drag from start to end coordinates |
+| `done` | Signal task completion with a result summary |
+
+## Resources
+
+- [Lightcone API Documentation](https://docs.lightcone.ai)
+- [Kernel Documentation](https://www.kernel.sh/docs/quickstart)

pkg/templates/python/tzafon/_gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.py[cod]
+*$py.class
+.env
+*.log
+.venv/
+venv/