@notis_ai/cli 0.2.0-beta.196.1 → 0.2.0-beta.197.1

package/README.md

@@ -810,25 +810,25 @@ For plain HTML, use the installed HTML Space and its linked saving Skill. Its ge
 
 ## Hand-over
 
-Give the branch you are on to a Notis agent, which continues the work in a git worktree on the Notis cloud computer. `--route` picks the agent: the hosted Notis agent, or the user's own Codex/Claude Code in the cloud sandbox or on their Mac. `--branch-mode same` makes the agent commit onto your branch; the default cuts a new branch from it.
+Give the branch you are on to a Notis agent, which continues the work in a git worktree on the Notis cloud computer. By default Notis picks the agent (`--route auto`); `--route notis`, `--route codex` or `--route claude` names one instead. `--branch-mode same` makes the agent commit onto your branch; the default cuts a new branch from it.
 
 ### `npx --package @notis_ai/cli@latest -- notis handover start <task>`
 
 Hand the current branch to a Notis agent and keep working.
 
-When to use: Use this when you want Notis to continue work on the branch you are on -- long refactors, test fixing, or anything that should keep running after you close the laptop. Pick the agent with --route.
+When to use: Use this when you want Notis to continue work on the branch you are on -- long refactors, test fixing, or anything that should keep running after you close the laptop. Notis picks the agent unless you name one with --route.
 
 Options:
 - `--branch-mode <mode>` — same = the agent commits onto your branch. new = the agent cuts a new branch from it (default).
-- `--route <target>` — Which agent runs it: notis (hosted, default), codex_cloud, claude_cloud, codex_local, claude_local, or auto.
+- `--route <target>` — Which agent runs it: auto (default, Notis picks the agent), notis, codex or claude.
 - `--repo <slug>` — Configured repository slug on the cloud computer, when you know it.
 - `--no-wip` — Refuse on a dirty tree instead of committing the changes first.
 
 Examples:
 - `npx --package @notis_ai/cli@latest -- notis handover start "fix the failing auth tests"`
-- `npx --package @notis_ai/cli@latest -- notis handover start "finish the migration" --branch-mode same --route codex_cloud`
-- `npx --package @notis_ai/cli@latest -- notis handover start "add integration tests" --route claude_cloud`
-- `npx --package @notis_ai/cli@latest -- notis handover start "review and clean up this branch" --route claude_local`
+- `npx --package @notis_ai/cli@latest -- notis handover start "finish the migration" --branch-mode same --route codex`
+- `npx --package @notis_ai/cli@latest -- notis handover start "add integration tests" --route claude`
+- `npx --package @notis_ai/cli@latest -- notis handover start "review and clean up this branch" --route notis`
 
 ### `npx --package @notis_ai/cli@latest -- notis handover status`
 

package/config/portal-route-roots.json

@@ -1,5 +1,4 @@
 [
-  ".well-known",
   "api",
   "apps",
   "auth",

package/dist/agent-hooks/notis-agent-hook.mjs

@@ -41494,10 +41494,24 @@ function pushBranch(repository, branch) {
 // src/command-specs/handover.js
 var HAND_OVER_TOOL = "LOCAL_NOTIS_HAND_OVER";
 var SEARCH_THREADS_TOOL = "LOCAL_NOTIS_SEARCH_CODING_AGENT_THREADS";
-var ROUTES = ["notis", "auto", "codex_cloud", "claude_cloud", "codex_local", "claude_local"];
+var ROUTES = ["auto", "notis", "codex", "claude"];
+var LEGACY_ROUTES = /* @__PURE__ */ new Map([
+  ["codex_cloud", "codex"],
+  ["codex_local", "codex"],
+  ["claude_cloud", "claude"],
+  ["claude_local", "claude"]
+]);
+var ROUTE_LABELS = { notis: "Notis", codex: "Codex", claude: "Claude" };
 var BRANCH_MODES = ["new", "same"];
 var HANDOVER_TIMEOUT_MS = 12e4;
 var HANDOVER_UNAVAILABLE_CODES = /* @__PURE__ */ new Set(["usage_error", "forbidden"]);
+function normalizeRoute(route) {
+  return LEGACY_ROUTES.get(route) || route;
+}
+function describeRoute(route) {
+  if (route === "auto") return "Notis, which picks the agent";
+  return ROUTE_LABELS[route] || route;
+}
 function shellSingleQuote(value) {
   return `'${String(value).replace(/'/g, "'\\''")}'`;
 }
@@ -41548,8 +41562,8 @@ async function handoverStartHandler(ctx) {
   if (!BRANCH_MODES.includes(branchMode)) {
     throw usageError(`--branch-mode must be one of: ${BRANCH_MODES.join(", ")}`, { branchMode });
   }
-  const route = ctx.options.route || "notis";
-  if (!ROUTES.includes(route)) {
+  const route = ctx.options.route || "auto";
+  if (!ROUTES.includes(route) && !LEGACY_ROUTES.has(route)) {
     throw usageError(`--route must be one of: ${ROUTES.join(", ")}`, { route });
   }
   const repository = inspectRepository(ctx.options.cwd || process.cwd());
@@ -41618,7 +41632,10 @@ async function handoverStartHandler(ctx) {
     branchMode,
     repoSlug: ctx.options.repo || null
   });
-  ctx.output.emitProgress({ phase: "handover", message: `Handing over to ${route}` });
+  ctx.output.emitProgress({
+    phase: "handover",
+    message: `Handing over to ${describeRoute(normalizeRoute(route))}`
+  });
   const result = await runToolCommand({
     runtime: {
       ...ctx.runtime,
@@ -41646,14 +41663,16 @@ async function handoverStartHandler(ctx) {
     branch_mode: branchMode,
     head: repository.head,
     wip_commit: wipCommit,
-    agent_routing: payload.agent_routing || route,
+    // The server answers with auto, notis, codex or claude. An older server
+    // may echo a legacy value back, so map it here too.
+    agent_routing: normalizeRoute(payload.agent_routing || route),
     interaction_id: payload.interaction_id || null,
     thread_id: payload.thread_id || null
   };
   return ctx.output.emitSuccess({
     command: "handover start",
     data,
-    humanSummary: `Handed ${data.branch} over to ${data.agent_routing} (${branchMode === "same" ? "continuing the branch" : "new branch from it"}).`,
+    humanSummary: `Handed ${data.branch} over to ${describeRoute(data.agent_routing)} (${branchMode === "same" ? "continuing the branch" : "new branch from it"}).`,
     hints: [
       { command: "notis handover status", reason: "See what the agent is doing" },
       {
@@ -41693,7 +41712,7 @@ var handoverCommandSpecs = [
   {
     command_path: ["handover", "start"],
     summary: "Hand the current branch to a Notis agent and keep working.",
-    when_to_use: "Use this when you want Notis to continue work on the branch you are on -- long refactors, test fixing, or anything that should keep running after you close the laptop. Pick the agent with --route.",
+    when_to_use: "Use this when you want Notis to continue work on the branch you are on -- long refactors, test fixing, or anything that should keep running after you close the laptop. Notis picks the agent unless you name one with --route.",
     args_schema: {
       arguments: [{ token: "<task>", description: "What the agent should do, in plain language." }],
       options: [
@@ -41704,7 +41723,7 @@ var handoverCommandSpecs = [
         },
         {
           flags: "--route <target>",
-          description: "Which agent runs it: notis (hosted, default), codex_cloud, claude_cloud, codex_local, claude_local, or auto."
+          description: "Which agent runs it: auto (default, Notis picks the agent), notis, codex or claude."
         },
         { flags: "--repo <slug>", description: "Configured repository slug on the cloud computer, when you know it." },
         {
@@ -41715,11 +41734,11 @@ var handoverCommandSpecs = [
     },
     examples: [
       'notis handover start "fix the failing auth tests"',
-      'notis handover start "finish the migration" --branch-mode same --route codex_cloud',
-      'notis handover start "add integration tests" --route claude_cloud',
-      'notis handover start "review and clean up this branch" --route claude_local'
+      'notis handover start "finish the migration" --branch-mode same --route codex',
+      'notis handover start "add integration tests" --route claude',
+      'notis handover start "review and clean up this branch" --route notis'
     ],
-    output_schema: "Returns the branch, the resolved routing target, and the interaction/thread ids of the started run.",
+    output_schema: "Returns the branch, the agent routing (auto when Notis picks, otherwise notis, codex or claude), and the interaction/thread ids of the started run.",
     mutates: true,
     idempotent: false,
     require_auth: true,
@@ -42518,7 +42537,6 @@ init_errors();
 
 // config/portal-route-roots.json
 var portal_route_roots_default = [
-  ".well-known",
   "api",
   "apps",
   "auth",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notis_ai/cli",
-  "version": "0.2.0-beta.196.1",
+  "version": "0.2.0-beta.197.1",
   "description": "Agent-first Notis CLI for apps and generic tool execution",
   "type": "module",
   "bin": {

package/skills/notis-cli/AGENT_INSTRUCTIONS.md

@@ -15,7 +15,7 @@ Relevant Notis long-term memory may be injected into a turn inside `<notis_relev
 4. Execute: `notis tools exec <TOOL> --arguments '<json>'`; batch independent calls with `notis tools exec-parallel '<json-array>'`.
 5. If an integration is not connected, `notis tools link <toolkit>` prints a connection URL to give the user.
 
-Tool name shapes: `LOCAL_NOTIS_*` (native Notis), `LOCAL_NOTIS_DATABASE_*` (databases and notes), `LOCAL_MCP_*` (the user's connected MCP servers), and integration tools such as `GMAIL_*`, `NOTION_*`, and `GOOGLECALENDAR_*`.
+Tool name shapes: `LOCAL_NOTIS_*` (native Notis), `LOCAL_NOTIS_DATABASE_*` (databases and notes), `CUSTOM_*` (the user's remote MCP servers), `LOCAL_MCP_*` (MCP servers on the user's computer), and integration tools such as `GMAIL_*`, `NOTION_*`, and `GOOGLECALENDAR_*`.
 
 ### Main features
 

package/src/command-specs/handover.js

@@ -2,9 +2,10 @@
  * `notis handover` -- give the branch you are on to a Notis agent.
  *
  * The coding agent already sitting in the user's terminal is the caller here.
- * It pushes the branch, then hands the task to whichever agent the user picked:
- * the hosted Notis agent, or their own Codex/Claude Code running in the Notis
- * cloud sandbox or on their Mac.
+ * It pushes the branch, then hands the task to Notis. By default (`auto`) Notis
+ * picks the agent itself; `--route notis|codex|claude` names one instead, and
+ * the server turns that into a plain sentence in the task ("Use Codex for this
+ * task."), so the user's choice wins like it does in a chat message.
  *
  * The CLI deliberately does not create the cloud workspace itself. Doing so
  * would hard-code the Conductor app's database schema and script paths into the
@@ -28,7 +29,18 @@ import { fetchToolSchema, nextIdempotencyKey, runToolCommand } from './helpers.j
 const HAND_OVER_TOOL = 'LOCAL_NOTIS_HAND_OVER';
 const SEARCH_THREADS_TOOL = 'LOCAL_NOTIS_SEARCH_CODING_AGENT_THREADS';
 
-const ROUTES = ['notis', 'auto', 'codex_cloud', 'claude_cloud', 'codex_local', 'claude_local'];
+// What --route accepts and advertises. `auto` lets Notis pick the agent.
+const ROUTES = ['auto', 'notis', 'codex', 'claude'];
+// Values from before Notis picked the agent itself. Still accepted, so scripts
+// and agents that learned them keep working, but never shown in help, examples
+// or errors. They are sent as typed; the server maps them to codex or claude.
+const LEGACY_ROUTES = new Map([
+  ['codex_cloud', 'codex'],
+  ['codex_local', 'codex'],
+  ['claude_cloud', 'claude'],
+  ['claude_local', 'claude'],
+]);
+const ROUTE_LABELS = { notis: 'Notis', codex: 'Codex', claude: 'Claude' };
 const BRANCH_MODES = ['new', 'same'];
 
 // A cloud coding agent takes minutes to start, and the hand-over POST itself
@@ -44,6 +56,17 @@ const HANDOVER_TIMEOUT_MS = 120_000;
  */
 const HANDOVER_UNAVAILABLE_CODES = new Set(['usage_error', 'forbidden']);
 
+/** A legacy route as the agent it now means; anything else unchanged. */
+function normalizeRoute(route) {
+  return LEGACY_ROUTES.get(route) || route;
+}
+
+/** Who the hand-over went to, in words, for progress lines and the summary. */
+function describeRoute(route) {
+  if (route === 'auto') return 'Notis, which picks the agent';
+  return ROUTE_LABELS[route] || route;
+}
+
 /**
  * Quote a value for the command line the receiving agent is told to run.
  *
@@ -121,8 +144,8 @@ async function handoverStartHandler(ctx) {
     throw usageError(`--branch-mode must be one of: ${BRANCH_MODES.join(', ')}`, { branchMode });
   }
 
-  const route = ctx.options.route || 'notis';
-  if (!ROUTES.includes(route)) {
+  const route = ctx.options.route || 'auto';
+  if (!ROUTES.includes(route) && !LEGACY_ROUTES.has(route)) {
     throw usageError(`--route must be one of: ${ROUTES.join(', ')}`, { route });
   }
 
@@ -223,7 +246,10 @@ async function handoverStartHandler(ctx) {
     repoSlug: ctx.options.repo || null,
   });
 
-  ctx.output.emitProgress({ phase: 'handover', message: `Handing over to ${route}` });
+  ctx.output.emitProgress({
+    phase: 'handover',
+    message: `Handing over to ${describeRoute(normalizeRoute(route))}`,
+  });
   const result = await runToolCommand({
     runtime: {
       ...ctx.runtime,
@@ -255,7 +281,9 @@ async function handoverStartHandler(ctx) {
     branch_mode: branchMode,
     head: repository.head,
     wip_commit: wipCommit,
-    agent_routing: payload.agent_routing || route,
+    // The server answers with auto, notis, codex or claude. An older server
+    // may echo a legacy value back, so map it here too.
+    agent_routing: normalizeRoute(payload.agent_routing || route),
     interaction_id: payload.interaction_id || null,
     thread_id: payload.thread_id || null,
   };
@@ -264,7 +292,7 @@ async function handoverStartHandler(ctx) {
     command: 'handover start',
     data,
     humanSummary:
-      `Handed ${data.branch} over to ${data.agent_routing} ` +
+      `Handed ${data.branch} over to ${describeRoute(data.agent_routing)} ` +
       `(${branchMode === 'same' ? 'continuing the branch' : 'new branch from it'}).`,
     hints: [
       { command: 'notis handover status', reason: 'See what the agent is doing' },
@@ -313,8 +341,8 @@ export const handoverCommandSpecs = [
     summary: 'Hand the current branch to a Notis agent and keep working.',
     when_to_use:
       'Use this when you want Notis to continue work on the branch you are on -- long refactors, ' +
-      'test fixing, or anything that should keep running after you close the laptop. Pick the agent ' +
-      'with --route.',
+      'test fixing, or anything that should keep running after you close the laptop. Notis picks ' +
+      'the agent unless you name one with --route.',
     args_schema: {
       arguments: [{ token: '<task>', description: 'What the agent should do, in plain language.' }],
       options: [
@@ -327,7 +355,7 @@ export const handoverCommandSpecs = [
         {
           flags: '--route <target>',
           description:
-            'Which agent runs it: notis (hosted, default), codex_cloud, claude_cloud, codex_local, claude_local, or auto.',
+            'Which agent runs it: auto (default, Notis picks the agent), notis, codex or claude.',
         },
         { flags: '--repo <slug>', description: 'Configured repository slug on the cloud computer, when you know it.' },
         {
@@ -338,12 +366,13 @@ export const handoverCommandSpecs = [
     },
     examples: [
       'notis handover start "fix the failing auth tests"',
-      'notis handover start "finish the migration" --branch-mode same --route codex_cloud',
-      'notis handover start "add integration tests" --route claude_cloud',
-      'notis handover start "review and clean up this branch" --route claude_local',
+      'notis handover start "finish the migration" --branch-mode same --route codex',
+      'notis handover start "add integration tests" --route claude',
+      'notis handover start "review and clean up this branch" --route notis',
     ],
     output_schema:
-      'Returns the branch, the resolved routing target, and the interaction/thread ids of the started run.',
+      'Returns the branch, the agent routing (auto when Notis picks, otherwise notis, codex or claude), ' +
+      'and the interaction/thread ids of the started run.',
     mutates: true,
     idempotent: false,
     require_auth: true,