Ajit/local connection

.changeset/calm-macs-connect.md

@@ -0,0 +1,6 @@
+---
+"@shellular/protocol": patch
+"shellular": patch
+---
+
+Add the authenticated local desktop control protocol and loopback CLI transport used by the native Shellular desktop app.

.changeset/real-towns-vanish.md

@@ -0,0 +1,6 @@
+---
+"@shellular/protocol": patch
+"shellular": patch
+---
+
+chore: update @agentclientprotocol/sdk to 1.4.0

cli/package.json

@@ -5,11 +5,13 @@
   "main": "dist/main.js",
   "scripts": {
     "dev": "cross-env SHELLULAR_DEV=true tsx --import ./scripts/register-sql-loader.mjs --watch src/main.ts",
+    "activate:local": "cross-env SHELLULAR_DEV=true tsx --import ./scripts/register-sql-loader.mjs src/main.ts --start-local --no-qr",
     "predev": "pnpm --dir ../protocol run build",
     "start": "tsx --import ./scripts/register-sql-loader.mjs src/main.ts",
     "prestart": "pnpm --dir ../protocol run build",
     "build": "pnpm run schema && tsc && tsup",
     "schema": "tsx scripts/generate-schema.ts",
+    "test": "pnpm run build && tsx --import ./scripts/register-sql-loader.mjs --test src/*.test.ts src/**/*.test.ts",
     "prepublishOnly": "pnpm run build",
     "ci:publish": "pnpm publish --access public",
     "try-run": "pnpm run build && node dist/main.js"
@@ -35,7 +37,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@agentclientprotocol/sdk": "^1.2.1",
+    "@agentclientprotocol/sdk": "^1.4.0",
     "@ff-labs/fff-node": "^0.10.5",
     "@inquirer/prompts": "^8.4.2",
     "@opencode-ai/sdk": "1.18.18",

cli/src/agents/index.ts

@@ -30,7 +30,7 @@ import {
 } from "@shellular/protocol";
 
 import { config } from "@/config";
-import type { Connection } from "@/connection";
+import type { HostConnection } from "@/connection";
 import { logger } from "@/logger";
 import { commandsExist } from "@/utils";
 import { BUILTIN_AGENT_DESCRIPTORS } from "./agents";
@@ -1942,7 +1942,7 @@ export class AgentsManager {
 		return () => this.subscribers.delete(emitter);
 	}
 
-	handleConnection(conn: Connection) {
+	handleConnection(conn: HostConnection) {
 		// This adapter keeps the current app protocol stable while the internals
 		// move to ACP. Future UI work can consume listAgents/connectAgent directly.
 		const unsubscribe = this.subscribe((clientId, backend, event) => {