deepline 0.1.164 → 0.1.166

package/dist/bundling-sources/sdk/src/agent-runtime.ts

@@ -35,9 +35,9 @@ export function isCoworkLikeSandbox(): boolean {
   const projectDir = Boolean(process.env.CLAUDE_PROJECT_DIR?.trim());
   const pluginRoot = Boolean(process.env.DEEPLINE_PLUGIN_ROOT?.trim());
   const home = process.env.HOME?.trim() || homedir();
-  const sessionHome = home.startsWith('/sessions/');
+  const sessionHome = home === '/sessions' || home.startsWith('/sessions/');
   return (
-    (pluginMode || pluginRoot) && (claudeRemote || projectDir || sessionHome)
+    claudeRemote || sessionHome || ((pluginMode || pluginRoot) && projectDir)
   );
 }
 

package/dist/bundling-sources/sdk/src/release.ts

@@ -104,10 +104,10 @@ export const SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: '0.1.164',
+  version: '0.1.166',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.164',
+    latest: '0.1.166',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/bundling-sources/sdk/src/types.ts

@@ -319,6 +319,15 @@ export interface ToolSearchResult {
   search_mode?: 'v1' | 'v2';
   /** Whether search fell back to category matching. */
   search_fallback_to_category?: boolean;
+  /** Explanation and next commands when filters/search succeed but match zero tools. */
+  emptyResult?: {
+    reason: string;
+    message: string;
+    suggestions: Array<{
+      label: string;
+      command: string;
+    }>;
+  };
   /** Hint explaining omitted play results when searching tools only. */
   omitted_plays_hint?: string;
   /** Copyable CLI command templates for follow-up discovery/execution. */

package/dist/bundling-sources/shared_libs/play-runtime/runtime-api.ts

@@ -16,7 +16,6 @@ import type {
 import type { PlayBundleArtifact } from '../plays/artifact-types';
 import {
   augmentSheetContractWithDatasetFields,
-  outputPhysicalSheetColumnNames,
   outputPhysicalSheetColumnProjections,
   physicalSheetColumnNames,
   physicalSheetColumnProjections,
@@ -1633,15 +1632,17 @@ function nextRuntimeSheetVersionExpression(
 
 function missingOutputCellSql(
   tableAlias: string,
-  outputPhysicalColumns: readonly string[],
+  outputPhysicalColumns: readonly PhysicalSheetColumnProjection[],
 ): string {
   if (outputPhysicalColumns.length === 0) {
     return 'false';
   }
   return outputPhysicalColumns
     .map((column) => {
-      const quoted = `${tableAlias}.${quoteIdentifier(column)}`;
-      return `(${quoted} IS NULL OR ${quoted} = 'null'::jsonb OR ${quoted} = '""'::jsonb)`;
+      const quoted = `${tableAlias}.${quoteIdentifier(column.sqlName)}`;
+      const staleAt = `${tableAlias}._cell_meta -> ${quoteLiteral(column.fieldName)} -> 'staleAt'`;
+      const staleAtMs = `(CASE WHEN jsonb_typeof(${staleAt}) = 'number' THEN (${staleAt})::text::double precision ELSE NULL END)`;
+      return `(${quoted} IS NULL OR ${quoted} = 'null'::jsonb OR ${quoted} = '""'::jsonb OR (${staleAtMs} IS NOT NULL AND ${staleAtMs} <= extract(epoch from now()) * 1000))`;
     })
     .join(' OR ');
 }
@@ -2186,7 +2187,7 @@ async function prepareRuntimeSheetDatasetRows(
     normalizedTableNamespace: string;
     physicalInsertColumnsSql: string;
     physicalInsertValuesSql: string;
-    outputPhysicalColumns: string[];
+    outputPhysicalColumns: PhysicalSheetColumnProjection[];
   },
 ): Promise<{ inserted: number; pendingKeys: string[] }> {
   let inserted = 0;
@@ -2363,7 +2364,6 @@ async function buildRuntimeSheetDatasetStartResult(
     timings?: RuntimeSheetTiming[];
   },
 ): Promise<PrepareRuntimeSheetResult> {
-  void input.pendingKeys;
   if (input.inserted === input.rowEntries.length) {
     const datasetFields = input.sheetContract.columns.flatMap((column) =>
       column.source === 'datasetColumn' && typeof column.field === 'string'
@@ -2390,47 +2390,55 @@ async function buildRuntimeSheetDatasetStartResult(
     };
   }
 
+  const pendingKeys = new Set(input.pendingKeys);
   const startedAt = Date.now();
   await markRuntimeRowsPendingForRecompute(client, session, {
-    keys: input.rowEntries.map((entry) => entry.key),
+    keys: [...pendingKeys],
     runId: input.runId,
     normalizedPlayName: input.normalizedPlayName,
     normalizedTableNamespace: input.normalizedTableNamespace,
   });
-  const persistedPendingRows = await readRuntimeRowsByKey(
+  const persistedRows = await readRuntimeRowsByKey(
     client,
     session,
     input.rowEntries.map((entry) => entry.key),
     input.sheetContract,
   );
   const persistedRowsByKey = new Map(
-    persistedPendingRows.map((row) => [row.key, row.data]),
+    persistedRows.map((row) => [row.key, row.data]),
   );
-  input.timings?.push({
-    phase: 'mark_rows_pending_for_recompute',
-    ms: Date.now() - startedAt,
-    rows: input.rowEntries.length,
-  });
+  if (pendingKeys.size > 0) {
+    input.timings?.push({
+      phase: 'mark_rows_pending_for_recompute',
+      ms: Date.now() - startedAt,
+      rows: pendingKeys.size,
+    });
+  }
+  const buildMergedRow = (entry: RuntimeDatasetRowEntry) => {
+    const merged = { ...entry.row };
+    for (const [field, value] of Object.entries(
+      persistedRowsByKey.get(entry.key) ?? {},
+    )) {
+      if (
+        value !== null ||
+        !Object.prototype.hasOwnProperty.call(merged, field)
+      ) {
+        merged[field] = value;
+      }
+    }
+    return {
+      ...merged,
+      __deeplineRowKey: entry.key,
+    };
+  };
+  const pendingRows: Record<string, unknown>[] = [];
+  for (const entry of input.rowEntries) {
+    pendingRows.push(buildMergedRow(entry));
+  }
   return {
     inserted: input.inserted,
     skipped: input.sourceRowsLength - input.rowEntries.length,
-    pendingRows: input.rowEntries.map((entry) => {
-      const merged = { ...entry.row };
-      for (const [field, value] of Object.entries(
-        persistedRowsByKey.get(entry.key) ?? {},
-      )) {
-        if (
-          value !== null ||
-          !Object.prototype.hasOwnProperty.call(merged, field)
-        ) {
-          merged[field] = value;
-        }
-      }
-      return {
-        ...merged,
-        __deeplineRowKey: entry.key,
-      };
-    }),
+    pendingRows,
     completedRows: [],
     tableNamespace: input.tableNamespace,
   };
@@ -3289,7 +3297,7 @@ export async function startRuntimeSheetDataset(
           .map((column) => `payload -> ${quoteLiteral(column)}`)
           .join(', ')}`
       : '';
-  const outputPhysicalColumns = outputPhysicalSheetColumnNames(
+  const outputPhysicalColumns = outputPhysicalSheetColumnProjections(
     input.sheetContract,
   );
   const normalizedPlayName = normalizePlayNameForSheet(playName);
@@ -4271,9 +4279,7 @@ export async function readRuntimeSheetDatasetRowKeys(
 ): Promise<{ keys: string[] }> {
   const keys = [
     ...new Set(
-      input.keys
-        .map((key) => key.trim())
-        .filter((key) => key.length > 0),
+      input.keys.map((key) => key.trim()).filter((key) => key.length > 0),
     ),
   ];
   if (keys.length === 0) {

package/dist/cli/index.js

@@ -622,10 +622,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.166",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.166",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -749,8 +749,8 @@ function isCoworkLikeSandbox2() {
   const projectDir = Boolean(process.env.CLAUDE_PROJECT_DIR?.trim());
   const pluginRoot = Boolean(process.env.DEEPLINE_PLUGIN_ROOT?.trim());
   const home = process.env.HOME?.trim() || (0, import_node_os2.homedir)();
-  const sessionHome = home.startsWith("/sessions/");
-  return (pluginMode || pluginRoot) && (claudeRemote || projectDir || sessionHome);
+  const sessionHome = home === "/sessions" || home.startsWith("/sessions/");
+  return claudeRemote || sessionHome || (pluginMode || pluginRoot) && projectDir;
 }
 function detectAgentRuntime(options = {}) {
   const explicit = normalizeAgentRuntime(process.env.DEEPLINE_AGENT_RUNTIME);
@@ -4419,10 +4419,11 @@ function sleep3(ms) {
   return new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
 }
 function collectLocalEnvInfo() {
+  const homeDir2 = process.env.HOME?.trim() || (0, import_node_os5.homedir)();
   const info = {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
-    home_dir: (0, import_node_os5.homedir)(),
+    home_dir: homeDir2,
     agent_runtime: detectAgentRuntime()
   };
   const env = process.env;
@@ -4442,7 +4443,7 @@ function collectLocalEnvInfo() {
   if (env.DEEPLINE_PLUGIN_SKILLS_DIR?.trim()) {
     info.deepline_plugin_skills_dir_present = "true";
   }
-  if (info.home_dir.startsWith("/sessions/")) {
+  if (info.home_dir === "/sessions" || info.home_dir.startsWith("/sessions/")) {
     info.home_scope = "sessions";
   }
   return info;
@@ -4707,6 +4708,27 @@ function clearPendingClaimToken(baseUrl) {
   } catch {
   }
 }
+function parseRegisterWaitMode(args) {
+  let mode = "auto";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--no-wait") {
+      mode = "no";
+    } else if (args[i] === "--wait" && args[i + 1]) {
+      const value = args[++i].trim().toLowerCase();
+      if (value === "auto" || value === "yes" || value === "no") {
+        mode = value;
+      } else {
+        throw new Error("--wait must be one of: auto, yes, no");
+      }
+    }
+  }
+  return mode;
+}
+function shouldWaitForRegisterClaim(mode) {
+  if (mode === "yes") return true;
+  if (mode === "no") return false;
+  return detectAgentRuntime() !== "claude_cowork";
+}
 function saveEnvValues(values, baseUrl) {
   const filtered = {
     ...values[HOST_URL_ENV] ? { [HOST_URL_ENV]: values[HOST_URL_ENV] } : {},
@@ -4835,11 +4857,16 @@ async function handleRegister(args) {
   const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
   let orgName = "";
   let agentName = "";
-  let noWait = false;
+  let waitMode;
+  try {
+    waitMode = parseRegisterWaitMode(args);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 2;
+  }
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--org-name" && args[i + 1]) orgName = args[++i];
     else if (args[i] === "--agent-name" && args[i + 1]) agentName = args[++i];
-    else if (args[i] === "--no-wait") noWait = true;
   }
   if (!agentName) {
     try {
@@ -4881,7 +4908,7 @@ async function handleRegister(args) {
   if (data.cli_message) {
     console.log(String(data.cli_message));
   }
-  if (noWait) return EXIT_OK;
+  if (!shouldWaitForRegisterClaim(waitMode)) return EXIT_OK;
   if (!claimToken) {
     console.error("Missing claim token from register response.");
     return EXIT_SERVER;
@@ -4949,7 +4976,7 @@ async function handleWait(args) {
       console.log("Already connected.");
       return EXIT_OK;
     }
-    console.error("No pending approval. Run: deepline auth register --no-wait");
+    console.error("No pending approval. Run: deepline auth register --wait no");
     return EXIT_AUTH;
   }
   const deadline = Date.now() + timeoutSeconds * 1e3;
@@ -5059,7 +5086,7 @@ async function handleStatus(args) {
         ...hostStatusPayload ?? { host: baseUrl },
         status: "not connected",
         connected: false,
-        next: "deepline auth register --no-wait && deepline auth wait",
+        next: "deepline auth register --wait auto && deepline auth wait",
         render: {
           sections: [
             {
@@ -5068,7 +5095,10 @@ async function handleStatus(args) {
             }
           ],
           actions: [
-            { label: "Register", command: "deepline auth register --no-wait" },
+            {
+              label: "Register",
+              command: "deepline auth register --wait auto"
+            },
             { label: "Wait", command: "deepline auth wait" }
           ]
         }
@@ -5092,7 +5122,7 @@ async function handleStatus(args) {
         ...hostStatusPayload ?? { host: baseUrl },
         status: "unauthorized",
         connected: false,
-        next: "deepline auth register --no-wait && deepline auth wait",
+        next: "deepline auth register --wait auto && deepline auth wait",
         render: {
           sections: [
             {
@@ -5101,7 +5131,10 @@ async function handleStatus(args) {
             }
           ],
           actions: [
-            { label: "Register", command: "deepline auth register --no-wait" },
+            {
+              label: "Register",
+              command: "deepline auth register --wait auto"
+            },
             { label: "Wait", command: "deepline auth wait" }
           ]
         }
@@ -5180,14 +5213,15 @@ function registerAuthCommands(program) {
     `
 Common commands:
   deepline auth register
-  deepline auth register --no-wait
+  deepline auth register --wait no
   deepline auth wait --timeout 300
   deepline auth status
   deepline auth status --json
 
 Notes:
-  Registration opens a browser approval page by default. Use --no-wait in CI
-  or agent runs, then finish with deepline auth wait.
+  Registration uses --wait auto by default: it waits locally and returns after
+  opening the approval page in Cowork. Use --wait no in CI or agent runs, then
+  finish with deepline auth wait.
   Auth status shows the target host and active workspace without printing secrets.
 `
   );
@@ -5197,26 +5231,27 @@ Notes:
     "after",
     `
 Notes:
-  Opens a browser approval page and waits for approval unless --no-wait is set.
+  Opens a browser approval page. --wait auto waits locally and returns after
+  opening the approval page in Cowork.
   The saved API key is scoped to the selected workspace and host.
 
 Examples:
   deepline auth register
   deepline auth register --org-name Acme --agent-name local-cli
-  deepline auth register --no-wait
+  deepline auth register --wait no
 `
-  ).option("--org-name <name>", "Workspace name to prefill").option("--agent-name <name>", "Agent name to register").option("--no-wait", "Return immediately after opening the approval page").action(async (options) => {
+  ).option("--org-name <name>", "Workspace name to prefill").option("--agent-name <name>", "Agent name to register").option("--wait <mode>", "Wait mode: auto, yes, or no", "auto").option("--no-wait", "Alias for --wait no").action(async (options) => {
     process.exitCode = await handleRegister([
       ...options.orgName ? ["--org-name", options.orgName] : [],
       ...options.agentName ? ["--agent-name", options.agentName] : [],
-      ...options.noWait || options.wait === false ? ["--no-wait"] : []
+      ...options.noWait || options.wait === false ? ["--wait", "no"] : ["--wait", String(options.wait ?? "auto")]
     ]);
   });
   auth.command("wait").description("Wait for a pending browser approval and save the API key.").addHelpText(
     "after",
     `
 Notes:
-  Completes a previous deepline auth register --no-wait flow.
+  Completes a previous deepline auth register --wait no flow.
   Saves the approved API key into the host auth file.
 
 Examples:
@@ -22039,6 +22074,63 @@ function matchesGrepQuery(value, query, mode) {
   if (mode === "any") return terms.some((term) => haystack.includes(term));
   return terms.every((term) => haystack.includes(term));
 }
+function shellCommandArg(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function zeroMatchToolGuidance(options) {
+  const categories = options.categories ?? [];
+  const query = options.query?.trim() ?? "";
+  const filterText = [
+    categories.length ? `categories=${categories.join(",")}` : null,
+    query ? `grep=${query}` : null,
+    query ? `grep_mode=${options.mode ?? "all"}` : null
+  ].filter(Boolean).join(" ");
+  const suggestions = [
+    ...query ? [
+      {
+        label: "Use ranked semantic search for intent-style queries",
+        command: `deepline tools search -- ${shellCommandArg(query)}`
+      },
+      ...options.mode === "all" ? [
+        {
+          label: "Relax literal grep from AND to OR matching",
+          command: `deepline tools grep --mode any -- ${shellCommandArg(query)}`
+        }
+      ] : []
+    ] : [],
+    {
+      label: "List the current atomic tool catalog",
+      command: "deepline tools list --json"
+    },
+    ...query ? [
+      {
+        label: "Search composed Deepline plays separately",
+        command: `deepline plays search -- ${shellCommandArg(query)}`
+      }
+    ] : []
+  ];
+  return {
+    reason: "filters_matched_no_atomic_tools",
+    message: `The tools catalog responded successfully, but no atomic provider tools matched ${filterText || "the current filters"}. This is a zero-match filter result, not a registry outage.`,
+    suggestions
+  };
+}
+function zeroMatchRender(emptyResult) {
+  return {
+    sections: [
+      {
+        title: "0 tools available:",
+        lines: [emptyResult.message]
+      },
+      {
+        title: "suggestions",
+        lines: emptyResult.suggestions.map(
+          (suggestion) => `${suggestion.label}: ${suggestion.command}`
+        )
+      }
+    ]
+  };
+}
 async function listTools(args) {
   const client2 = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
@@ -22053,8 +22145,9 @@ async function listTools(args) {
       (category) => item.categories.includes(category)
     )
   );
+  const emptyResult = items.length === 0 && requestedCategories.length > 0 ? zeroMatchToolGuidance({ categories: requestedCategories }) : null;
   const render = {
-    sections: [
+    sections: emptyResult ? zeroMatchRender(emptyResult).sections : [
       {
         title: `${items.length} tools available:`,
         lines: items.map((item) => {
@@ -22076,6 +22169,7 @@ async function listTools(args) {
     {
       tools: outputItems,
       count: outputItems.length,
+      ...emptyResult ? { emptyResult } : {},
       filters: {
         categories: requestedCategories
       },
@@ -22147,6 +22241,11 @@ async function grepTools(queryInput, options = {}) {
   );
   const shouldCompact = options.compact || !options.json;
   const outputTools = shouldCompact ? tools.slice(0, 8).map(compactTool) : tools;
+  const emptyResult = tools.length === 0 ? zeroMatchToolGuidance({
+    categories: requestedCategories,
+    query,
+    mode
+  }) : null;
   printCommandEnvelope(
     {
       tools: outputTools,
@@ -22159,6 +22258,10 @@ async function grepTools(queryInput, options = {}) {
       filters: {
         categories: requestedCategories
       },
+      ...emptyResult ? {
+        emptyResult,
+        render: zeroMatchRender(emptyResult)
+      } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
     { json: options.json || shouldEmitJson() }
@@ -24184,6 +24287,9 @@ function sdkNpmGlobalInstallCommand() {
 var CHECK_TIMEOUT_MS2 = 3e3;
 var attemptedSync = false;
 function shouldSkipSkillsSync() {
+  if (detectAgentRuntime() === "claude_cowork") {
+    return true;
+  }
   const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes" || value === "on";
 }
@@ -24409,6 +24515,7 @@ function runLegacySkillsCleanup() {
   for (const candidate of candidates) {
     const result = (0, import_node_child_process3.spawnSync)(candidate.command, candidate.args, {
       stdio: "ignore",
+      env: process.env,
       shell: process.platform === "win32"
     });
     if (result.status === 0) return;

package/dist/cli/index.mjs

@@ -607,10 +607,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.166",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.166",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -734,8 +734,8 @@ function isCoworkLikeSandbox2() {
   const projectDir = Boolean(process.env.CLAUDE_PROJECT_DIR?.trim());
   const pluginRoot = Boolean(process.env.DEEPLINE_PLUGIN_ROOT?.trim());
   const home = process.env.HOME?.trim() || homedir2();
-  const sessionHome = home.startsWith("/sessions/");
-  return (pluginMode || pluginRoot) && (claudeRemote || projectDir || sessionHome);
+  const sessionHome = home === "/sessions" || home.startsWith("/sessions/");
+  return claudeRemote || sessionHome || (pluginMode || pluginRoot) && projectDir;
 }
 function detectAgentRuntime(options = {}) {
   const explicit = normalizeAgentRuntime(process.env.DEEPLINE_AGENT_RUNTIME);
@@ -4416,10 +4416,11 @@ function sleep3(ms) {
   return new Promise((resolvePromise) => setTimeout(resolvePromise, ms));
 }
 function collectLocalEnvInfo() {
+  const homeDir2 = process.env.HOME?.trim() || homedir5();
   const info = {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
-    home_dir: homedir5(),
+    home_dir: homeDir2,
     agent_runtime: detectAgentRuntime()
   };
   const env = process.env;
@@ -4439,7 +4440,7 @@ function collectLocalEnvInfo() {
   if (env.DEEPLINE_PLUGIN_SKILLS_DIR?.trim()) {
     info.deepline_plugin_skills_dir_present = "true";
   }
-  if (info.home_dir.startsWith("/sessions/")) {
+  if (info.home_dir === "/sessions" || info.home_dir.startsWith("/sessions/")) {
     info.home_scope = "sessions";
   }
   return info;
@@ -4704,6 +4705,27 @@ function clearPendingClaimToken(baseUrl) {
   } catch {
   }
 }
+function parseRegisterWaitMode(args) {
+  let mode = "auto";
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--no-wait") {
+      mode = "no";
+    } else if (args[i] === "--wait" && args[i + 1]) {
+      const value = args[++i].trim().toLowerCase();
+      if (value === "auto" || value === "yes" || value === "no") {
+        mode = value;
+      } else {
+        throw new Error("--wait must be one of: auto, yes, no");
+      }
+    }
+  }
+  return mode;
+}
+function shouldWaitForRegisterClaim(mode) {
+  if (mode === "yes") return true;
+  if (mode === "no") return false;
+  return detectAgentRuntime() !== "claude_cowork";
+}
 function saveEnvValues(values, baseUrl) {
   const filtered = {
     ...values[HOST_URL_ENV] ? { [HOST_URL_ENV]: values[HOST_URL_ENV] } : {},
@@ -4832,11 +4854,16 @@ async function handleRegister(args) {
   const baseUrl = autoDetectBaseUrl().replace(/\/$/, "");
   let orgName = "";
   let agentName = "";
-  let noWait = false;
+  let waitMode;
+  try {
+    waitMode = parseRegisterWaitMode(args);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 2;
+  }
   for (let i = 0; i < args.length; i++) {
     if (args[i] === "--org-name" && args[i + 1]) orgName = args[++i];
     else if (args[i] === "--agent-name" && args[i + 1]) agentName = args[++i];
-    else if (args[i] === "--no-wait") noWait = true;
   }
   if (!agentName) {
     try {
@@ -4878,7 +4905,7 @@ async function handleRegister(args) {
   if (data.cli_message) {
     console.log(String(data.cli_message));
   }
-  if (noWait) return EXIT_OK;
+  if (!shouldWaitForRegisterClaim(waitMode)) return EXIT_OK;
   if (!claimToken) {
     console.error("Missing claim token from register response.");
     return EXIT_SERVER;
@@ -4946,7 +4973,7 @@ async function handleWait(args) {
       console.log("Already connected.");
       return EXIT_OK;
     }
-    console.error("No pending approval. Run: deepline auth register --no-wait");
+    console.error("No pending approval. Run: deepline auth register --wait no");
     return EXIT_AUTH;
   }
   const deadline = Date.now() + timeoutSeconds * 1e3;
@@ -5056,7 +5083,7 @@ async function handleStatus(args) {
         ...hostStatusPayload ?? { host: baseUrl },
         status: "not connected",
         connected: false,
-        next: "deepline auth register --no-wait && deepline auth wait",
+        next: "deepline auth register --wait auto && deepline auth wait",
         render: {
           sections: [
             {
@@ -5065,7 +5092,10 @@ async function handleStatus(args) {
             }
           ],
           actions: [
-            { label: "Register", command: "deepline auth register --no-wait" },
+            {
+              label: "Register",
+              command: "deepline auth register --wait auto"
+            },
             { label: "Wait", command: "deepline auth wait" }
           ]
         }
@@ -5089,7 +5119,7 @@ async function handleStatus(args) {
         ...hostStatusPayload ?? { host: baseUrl },
         status: "unauthorized",
         connected: false,
-        next: "deepline auth register --no-wait && deepline auth wait",
+        next: "deepline auth register --wait auto && deepline auth wait",
         render: {
           sections: [
             {
@@ -5098,7 +5128,10 @@ async function handleStatus(args) {
             }
           ],
           actions: [
-            { label: "Register", command: "deepline auth register --no-wait" },
+            {
+              label: "Register",
+              command: "deepline auth register --wait auto"
+            },
             { label: "Wait", command: "deepline auth wait" }
           ]
         }
@@ -5177,14 +5210,15 @@ function registerAuthCommands(program) {
     `
 Common commands:
   deepline auth register
-  deepline auth register --no-wait
+  deepline auth register --wait no
   deepline auth wait --timeout 300
   deepline auth status
   deepline auth status --json
 
 Notes:
-  Registration opens a browser approval page by default. Use --no-wait in CI
-  or agent runs, then finish with deepline auth wait.
+  Registration uses --wait auto by default: it waits locally and returns after
+  opening the approval page in Cowork. Use --wait no in CI or agent runs, then
+  finish with deepline auth wait.
   Auth status shows the target host and active workspace without printing secrets.
 `
   );
@@ -5194,26 +5228,27 @@ Notes:
     "after",
     `
 Notes:
-  Opens a browser approval page and waits for approval unless --no-wait is set.
+  Opens a browser approval page. --wait auto waits locally and returns after
+  opening the approval page in Cowork.
   The saved API key is scoped to the selected workspace and host.
 
 Examples:
   deepline auth register
   deepline auth register --org-name Acme --agent-name local-cli
-  deepline auth register --no-wait
+  deepline auth register --wait no
 `
-  ).option("--org-name <name>", "Workspace name to prefill").option("--agent-name <name>", "Agent name to register").option("--no-wait", "Return immediately after opening the approval page").action(async (options) => {
+  ).option("--org-name <name>", "Workspace name to prefill").option("--agent-name <name>", "Agent name to register").option("--wait <mode>", "Wait mode: auto, yes, or no", "auto").option("--no-wait", "Alias for --wait no").action(async (options) => {
     process.exitCode = await handleRegister([
       ...options.orgName ? ["--org-name", options.orgName] : [],
       ...options.agentName ? ["--agent-name", options.agentName] : [],
-      ...options.noWait || options.wait === false ? ["--no-wait"] : []
+      ...options.noWait || options.wait === false ? ["--wait", "no"] : ["--wait", String(options.wait ?? "auto")]
     ]);
   });
   auth.command("wait").description("Wait for a pending browser approval and save the API key.").addHelpText(
     "after",
     `
 Notes:
-  Completes a previous deepline auth register --no-wait flow.
+  Completes a previous deepline auth register --wait no flow.
   Saves the approved API key into the host auth file.
 
 Examples:
@@ -22085,6 +22120,63 @@ function matchesGrepQuery(value, query, mode) {
   if (mode === "any") return terms.some((term) => haystack.includes(term));
   return terms.every((term) => haystack.includes(term));
 }
+function shellCommandArg(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function zeroMatchToolGuidance(options) {
+  const categories = options.categories ?? [];
+  const query = options.query?.trim() ?? "";
+  const filterText = [
+    categories.length ? `categories=${categories.join(",")}` : null,
+    query ? `grep=${query}` : null,
+    query ? `grep_mode=${options.mode ?? "all"}` : null
+  ].filter(Boolean).join(" ");
+  const suggestions = [
+    ...query ? [
+      {
+        label: "Use ranked semantic search for intent-style queries",
+        command: `deepline tools search -- ${shellCommandArg(query)}`
+      },
+      ...options.mode === "all" ? [
+        {
+          label: "Relax literal grep from AND to OR matching",
+          command: `deepline tools grep --mode any -- ${shellCommandArg(query)}`
+        }
+      ] : []
+    ] : [],
+    {
+      label: "List the current atomic tool catalog",
+      command: "deepline tools list --json"
+    },
+    ...query ? [
+      {
+        label: "Search composed Deepline plays separately",
+        command: `deepline plays search -- ${shellCommandArg(query)}`
+      }
+    ] : []
+  ];
+  return {
+    reason: "filters_matched_no_atomic_tools",
+    message: `The tools catalog responded successfully, but no atomic provider tools matched ${filterText || "the current filters"}. This is a zero-match filter result, not a registry outage.`,
+    suggestions
+  };
+}
+function zeroMatchRender(emptyResult) {
+  return {
+    sections: [
+      {
+        title: "0 tools available:",
+        lines: [emptyResult.message]
+      },
+      {
+        title: "suggestions",
+        lines: emptyResult.suggestions.map(
+          (suggestion) => `${suggestion.label}: ${suggestion.command}`
+        )
+      }
+    ]
+  };
+}
 async function listTools(args) {
   const client2 = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
@@ -22099,8 +22191,9 @@ async function listTools(args) {
       (category) => item.categories.includes(category)
     )
   );
+  const emptyResult = items.length === 0 && requestedCategories.length > 0 ? zeroMatchToolGuidance({ categories: requestedCategories }) : null;
   const render = {
-    sections: [
+    sections: emptyResult ? zeroMatchRender(emptyResult).sections : [
       {
         title: `${items.length} tools available:`,
         lines: items.map((item) => {
@@ -22122,6 +22215,7 @@ async function listTools(args) {
     {
       tools: outputItems,
       count: outputItems.length,
+      ...emptyResult ? { emptyResult } : {},
       filters: {
         categories: requestedCategories
       },
@@ -22193,6 +22287,11 @@ async function grepTools(queryInput, options = {}) {
   );
   const shouldCompact = options.compact || !options.json;
   const outputTools = shouldCompact ? tools.slice(0, 8).map(compactTool) : tools;
+  const emptyResult = tools.length === 0 ? zeroMatchToolGuidance({
+    categories: requestedCategories,
+    query,
+    mode
+  }) : null;
   printCommandEnvelope(
     {
       tools: outputTools,
@@ -22205,6 +22304,10 @@ async function grepTools(queryInput, options = {}) {
       filters: {
         categories: requestedCategories
       },
+      ...emptyResult ? {
+        emptyResult,
+        render: zeroMatchRender(emptyResult)
+      } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
     { json: options.json || shouldEmitJson() }
@@ -24239,6 +24342,9 @@ function sdkNpmGlobalInstallCommand() {
 var CHECK_TIMEOUT_MS2 = 3e3;
 var attemptedSync = false;
 function shouldSkipSkillsSync() {
+  if (detectAgentRuntime() === "claude_cowork") {
+    return true;
+  }
   const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes" || value === "on";
 }
@@ -24464,6 +24570,7 @@ function runLegacySkillsCleanup() {
   for (const candidate of candidates) {
     const result = spawnSync2(candidate.command, candidate.args, {
       stdio: "ignore",
+      env: process.env,
       shell: process.platform === "win32"
     });
     if (result.status === 0) return;

package/dist/index.d.mts

@@ -295,6 +295,15 @@ interface ToolSearchResult {
     search_mode?: 'v1' | 'v2';
     /** Whether search fell back to category matching. */
     search_fallback_to_category?: boolean;
+    /** Explanation and next commands when filters/search succeed but match zero tools. */
+    emptyResult?: {
+        reason: string;
+        message: string;
+        suggestions: Array<{
+            label: string;
+            command: string;
+        }>;
+    };
     /** Hint explaining omitted play results when searching tools only. */
     omitted_plays_hint?: string;
     /** Copyable CLI command templates for follow-up discovery/execution. */

package/dist/index.d.ts

@@ -295,6 +295,15 @@ interface ToolSearchResult {
     search_mode?: 'v1' | 'v2';
     /** Whether search fell back to category matching. */
     search_fallback_to_category?: boolean;
+    /** Explanation and next commands when filters/search succeed but match zero tools. */
+    emptyResult?: {
+        reason: string;
+        message: string;
+        suggestions: Array<{
+            label: string;
+            command: string;
+        }>;
+    };
     /** Hint explaining omitted play results when searching tools only. */
     omitted_plays_hint?: string;
     /** Copyable CLI command templates for follow-up discovery/execution. */

package/dist/index.js

@@ -421,10 +421,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.166",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.166",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -548,8 +548,8 @@ function isCoworkLikeSandbox2() {
   const projectDir = Boolean(process.env.CLAUDE_PROJECT_DIR?.trim());
   const pluginRoot = Boolean(process.env.DEEPLINE_PLUGIN_ROOT?.trim());
   const home = process.env.HOME?.trim() || (0, import_node_os2.homedir)();
-  const sessionHome = home.startsWith("/sessions/");
-  return (pluginMode || pluginRoot) && (claudeRemote || projectDir || sessionHome);
+  const sessionHome = home === "/sessions" || home.startsWith("/sessions/");
+  return claudeRemote || sessionHome || (pluginMode || pluginRoot) && projectDir;
 }
 function detectAgentRuntime(options = {}) {
   const explicit = normalizeAgentRuntime(process.env.DEEPLINE_AGENT_RUNTIME);

package/dist/index.mjs

@@ -351,10 +351,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.166",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.166",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -478,8 +478,8 @@ function isCoworkLikeSandbox2() {
   const projectDir = Boolean(process.env.CLAUDE_PROJECT_DIR?.trim());
   const pluginRoot = Boolean(process.env.DEEPLINE_PLUGIN_ROOT?.trim());
   const home = process.env.HOME?.trim() || homedir2();
-  const sessionHome = home.startsWith("/sessions/");
-  return (pluginMode || pluginRoot) && (claudeRemote || projectDir || sessionHome);
+  const sessionHome = home === "/sessions" || home.startsWith("/sessions/");
+  return claudeRemote || sessionHome || (pluginMode || pluginRoot) && projectDir;
 }
 function detectAgentRuntime(options = {}) {
   const explicit = normalizeAgentRuntime(process.env.DEEPLINE_AGENT_RUNTIME);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.164",
+  "version": "0.1.166",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {