@dassi_ai/cli 0.7.0 → 0.7.1

package/README.md

@@ -138,20 +138,20 @@ dassi launch --stop dev
 
 Launch supports `--dist`, `--chrome`, `--profile-dir`, `--load-mode auto|pipe|flag`, and Chrome arguments after `--`. Branded Chrome uses a detached helper holding a CDP pipe for the unpacked extension; Chromium/Chrome for Testing can use `--load-extension` directly.
 
-CLI 0.7 requires the current extension with live tool discovery, and CLI protocol 3 for task submission. Incompatible clients, daemons, and extensions fail before a task is submitted, in either upgrade order. After upgrading the CLI, finish any old CLI calls and restart an older daemon if prompted (its PID is in `~/.dassi/default.pid`). Browser conversations survive a daemon restart. This package is not auto-published by a source change.
+CLI 0.7 requires the current extension with live tool discovery, and CLI protocol 3 for task submission. Incompatible clients, daemons, and extensions fail before a task is submitted, in either upgrade order. After upgrading the CLI, finish any old CLI calls and restart an older daemon if prompted (its PID is in `~/.dassi/default.pid`). Browser conversations survive a daemon restart. Merging a `cli/package.json` version bump to `main` publishes this package (`.github/workflows/publish-cli.yml`, npm trusted publishing); an extension release is blocked until the CLI on npm speaks the protocol it requires.
 
 `run --timeout` is rejected with migration instructions. Use `--wait` to observe and `stop` to cancel. Scripts must check task status and explicitly stop a task if they impose an execution budget. `--session`/`DASSI_SESSION` are retained for development compatibility; they select a daemon socket, not a browser or conversation. Normal use needs neither. `DASSI_BRIDGE_PORT` configures an isolated development bridge.
 
 The daemon routes short requests. Native runtime admission controls each conversation; the daemon does not serialize unrelated profiles or hold a connection for a task's lifetime. Startup requires no sign-in. The native conversation owns admission, cancellation, recovery, and transcript. Status reads its transcript and state in one storage transaction; a single last-run summary survives later compaction. There is no per-prompt task ledger.
 
-Before promoting a CLI release to npm `latest`, make its compatible extension available in the Chrome Web Store. Check the packed npm artifact in a fresh global prefix, then verify setup against that store installation: extension confirmation, signed-out browser access, profile choice, agent discovery, an initial tab listing, and resume after interruption. Local builds and injected browser responses do not establish that store-to-npm release path.
+A protocol bump ships CLI first: the CLI publishes on merge, and the extension release refuses to tag until npm `latest` declares that protocol (`scripts/check-cli-on-npm.sh` reads `dassi.protocol` from `cli/package.json` via `npm view`). While the matching extension is still in Chrome Web Store review, a freshly installed CLI reports that the extension is older and must be updated; CLIs already installed keep working against the store build. Check the packed npm artifact in a fresh global prefix, then verify setup against that store installation: extension confirmation, signed-out browser access, profile choice, agent discovery, an initial tab listing, and resume after interruption. Local builds and injected browser responses do not establish that store-to-npm release path.
 
 ## Output for scripts
 
 Browser and task commands with `--json` write their response to stdout, including argument, setup, and connection failures:
 
 ```json
-{"success": false, "error": "An older Dassi daemon is running. Finish active tasks, restart the daemon, then retry with this CLI."}
+{"success": false, "error": "An older Dassi daemon is running. Finish active tasks, stop it (kill the PID in ~/.dassi/default.pid), then retry with this CLI."}
 ```
 
 Parse stdout even on a nonzero exit. Successful responses contain `data`; failures contain `error`. Direct group tools return an array of `{tabId, response}`. Task status, rather than exit zero alone, tells you whether delegated work finished. `--help`, `--version`, and `skill` also support JSON, with a string in `data`. Development `launch` commands use terminal output.

package/daemon-client.mjs

@@ -9,6 +9,7 @@ import {
   getSocketPath,
   CLI_PROTOCOL_VERSION,
   getReadyFile,
+  getPidFile,
   isDaemonRunning,
   parseReadyPayload,
   CHROME_WEB_STORE_URL,
@@ -156,7 +157,8 @@ export async function ensureDaemonReady(session) {
   }
 
   if (ready.status === 'error') throw new Error(ready.error);
-  if (ready.protocolVersion !== CLI_PROTOCOL_VERSION) throw new Error('An older Dassi daemon is running. Finish active tasks, restart the daemon, then retry with this CLI.');
+  if (ready.protocolVersion > CLI_PROTOCOL_VERSION) throw new Error(`A newer Dassi daemon is running (protocol ${ready.protocolVersion}, this CLI speaks ${CLI_PROTOCOL_VERSION}). Run \`npm install -g @dassi_ai/cli@latest\` and retry.`);
+  if (ready.protocolVersion !== CLI_PROTOCOL_VERSION) throw new Error(`An older Dassi daemon is running. Finish active tasks, stop it (kill the PID in ${getPidFile(session)}), then retry with this CLI.`);
 
   return socketPath;
 }

package/dassi-daemon.mjs

@@ -182,11 +182,15 @@ export async function dispatchToExtension(cmd, reg = registry) {
 }
 
 /** Discovery is independent of authentication and in-flight agent work. */
+const session = validateSession(process.env.DASSI_SESSION ?? 'default');
+
 export async function routeCommand(cmd, reg = registry, dispatch = dispatchToExtension) {
   let resolvedProfile;
   const call = (command) => dispatch(command, reg);
   try {
-    if (['run', 'task_status', 'task_stop'].includes(cmd.action) && cmd.protocolVersion !== CLI_PROTOCOL_VERSION) throw new Error('Incompatible CLI. Update Dassi CLI and restart its daemon.');
+    if (['run', 'task_status', 'task_stop'].includes(cmd.action) && cmd.protocolVersion !== CLI_PROTOCOL_VERSION) throw new Error(cmd.protocolVersion > CLI_PROTOCOL_VERSION
+      ? `This Dassi daemon is older than the CLI (daemon protocol ${CLI_PROTOCOL_VERSION}, CLI ${cmd.protocolVersion}). Stop it (kill the PID in ${getPidFile(session)}) and retry.`
+      : `Incompatible CLI (protocol ${cmd.protocolVersion ?? 'none'}, this daemon speaks ${CLI_PROTOCOL_VERSION}). Run \`npm install -g @dassi_ai/cli@latest\` and retry.`);
     let target = cmd.target ?? null;
     let localTaskId = cmd.taskId;
     if (cmd.action === 'task_status' || cmd.action === 'task_stop' || (cmd.action === 'run' && cmd.taskId)) {
@@ -347,7 +351,6 @@ function startIdleShutdown(server, session, getLastCommandAt) {
  * @returns {Promise<void>}
  */
 export async function startDaemon() {
-  const session = validateSession(process.env.DASSI_SESSION ?? 'default');
   const { socketPath, readyFile } = initDaemonProcess(session);
 
   try {

package/dassi-shared.mjs

@@ -1,4 +1,3 @@
-export const CLI_PROTOCOL_VERSION = 3;
 /**
  * Dassi CLI Shared Utilities
  *
@@ -10,6 +9,12 @@ export const CLI_PROTOCOL_VERSION = 3;
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
+import { fileURLToPath } from 'url';
+
+const PACKAGE = JSON.parse(fs.readFileSync(path.join(path.dirname(fileURLToPath(import.meta.url)), 'package.json'), 'utf8'));
+export const CLI_VERSION = PACKAGE.version;
+/** Lives in package.json so the extension release gate can read it from npm (`npm view … dassi.protocol`) without downloading the tarball. */
+export const CLI_PROTOCOL_VERSION = PACKAGE.dassi.protocol;
 
 // ─── Extension identity ───────────────────────────────────────────────────────
 

package/dassi.mjs

@@ -9,7 +9,7 @@ import * as path from 'path';
 import * as child_process from 'child_process';
 import { randomUUID } from 'node:crypto';
 import { fileURLToPath, pathToFileURL } from 'url';
-import { getSocketPath, validateSession, getAppDir, getLaunchesFile } from './dassi-shared.mjs';
+import { getSocketPath, validateSession, getAppDir, getLaunchesFile, CLI_VERSION } from './dassi-shared.mjs';
 import { ensureDaemonRunning, sendCommand, sendAndWait, ensureDaemonReady } from './daemon-client.mjs';
 import { dispatchLaunch } from './launch.mjs';
 import { parseToolCommand, requireTarget, parseStrictInt, parseTarget, parseWait } from './tool-commands.mjs';
@@ -18,7 +18,6 @@ import { formatResponse } from './format-response.mjs';
 import { HELP_TEXT } from './help-text.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8')).version;
 
 // ─── Arg parsing ──────────────────────────────────────────────────────────────
 
@@ -243,7 +242,7 @@ function consumeFlag(args, flag) {
 
 function handleImmediateAction({ action, params, json }) {
   let text;
-  if (action === 'version') text = VERSION;
+  if (action === 'version') text = CLI_VERSION;
   else if (action === 'help') text = HELP_TEXT;
   else if (action === 'skill') {
     const skillDir = path.join(__dirname, 'skills', 'dassi');

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@dassi_ai/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "CLI for the Dassi Chrome extension \u2014 run browser automation from the terminal",
   "type": "module",
+  "dassi": {
+    "protocol": 3
+  },
   "bin": {
     "dassi": "./dassi.mjs"
   },