deepline 0.3.286 → 0.3.287

package/dist/cli/index.mjs

@@ -1951,7 +1951,7 @@ configureProxyFromEnv();
 
 // src/cli/index.ts
 import { mkdtemp as mkdtemp3, rm as rm3, writeFile as writeFile6 } from "fs/promises";
-import { join as join28 } from "path";
+import { join as join29 } from "path";
 import { tmpdir as tmpdir6 } from "os";
 import { Command as Command6 } from "commander";
 
@@ -3510,7 +3510,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.286",
+  version: "0.3.287",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -3544,6 +3544,11 @@ var SDK_RELEASE = {
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.3.1",
     commandIntroducedIn: [
+      {
+        command: "search",
+        introducedIn: "0.3.91",
+        reason: "deepline search was added in SDK CLI 0.3.91 as the one search across tools, monitors, and plays. On an older version run deepline tools search or deepline plays search, or update."
+      },
       {
         command: "notifications",
         introducedIn: "0.2.40",
@@ -7209,6 +7214,27 @@ function chunkRegisterPlayArtifacts(artifacts) {
   }
   return chunks;
 }
+function searchParams(options) {
+  const params = new URLSearchParams();
+  params.set("q", options.query?.trim() ?? "");
+  params.set(
+    "include_search_debug",
+    options.includeSearchDebug ? "true" : "false"
+  );
+  params.set("search_mode", options.searchMode ?? "v2");
+  if (options.limit !== void 0) params.set("limit", String(options.limit));
+  if (options.offset !== void 0) {
+    params.set("offset", String(options.offset));
+  }
+  if (options.categories?.trim()) {
+    params.set("categories", options.categories.trim());
+  }
+  if (options.searchTerms?.trim()) {
+    params.set("search_terms", options.searchTerms.trim());
+  }
+  if (options.task?.trim()) params.set("task", options.task.trim());
+  return params;
+}
 var RUNS_FAILED_LOG_LIMIT = 20;
 var RUN_LOGS_PAGE_LIMIT = 1e3;
 function requireTargetBillingIdempotencyKey(value) {
@@ -7689,33 +7715,30 @@ var DeeplineClient = class _DeeplineClient {
    * tool metadata, categories, agent guidance, and input schema fields.
    */
   async searchTools(options = {}) {
-    const params = new URLSearchParams();
-    const query = options.query?.trim() ?? "";
-    params.set("q", query);
-    params.set(
-      "include_search_debug",
-      options.includeSearchDebug ? "true" : "false"
-    );
-    params.set("search_mode", options.searchMode ?? "v2");
-    if (options.limit !== void 0) {
-      params.set("limit", String(options.limit));
-    }
-    if (options.offset !== void 0) {
-      params.set("offset", String(options.offset));
-    }
-    if (options.categories?.trim()) {
-      params.set("categories", options.categories.trim());
-    }
-    if (options.searchTerms?.trim()) {
-      params.set("search_terms", options.searchTerms.trim());
-    }
-    if (options.task?.trim()) {
-      params.set("task", options.task.trim());
-    }
     return this.http.get(
-      `/api/v2/tools/search?${params.toString()}`
+      `/api/v2/tools/search?${searchParams(options).toString()}`
     );
   }
+  /**
+   * Search everything Deepline can run or deploy in one ranked list: tools,
+   * monitor types, prebuilt plays, and your workspace's own plays.
+   *
+   * @example
+   * ```typescript
+   * const { results } = await client.search({
+   *   query: 'find work email',
+   *   types: ['tools', 'prebuilts'],
+   * });
+   * ```
+   */
+  async search(options = {}) {
+    const params = searchParams(options);
+    if (options.types?.length) params.set("types", options.types.join(","));
+    if (options.exclude?.length) {
+      params.set("exclude", options.exclude.join(","));
+    }
+    return this.http.get(`/api/v2/search?${params.toString()}`);
+  }
   /**
    * Get detailed metadata for a single tool.
    *
@@ -22630,12 +22653,12 @@ ${JSON.stringify(value, null, 2)}` : `${key}: ${String(value)}`
 // src/cli/commands/play.ts
 import {
   existsSync as existsSync11,
-  mkdirSync as mkdirSync9,
-  readFileSync as readFileSync13,
+  mkdirSync as mkdirSync10,
+  readFileSync as readFileSync14,
   readdirSync as readdirSync3,
   realpathSync as realpathSync3,
   statSync as statSync4,
-  writeFileSync as writeFileSync14
+  writeFileSync as writeFileSync15
 } from "fs";
 import {
   lstat,
@@ -22647,9 +22670,9 @@ import {
 } from "fs/promises";
 import {
   basename as basename4,
-  dirname as dirname11,
+  dirname as dirname12,
   isAbsolute as isAbsolute5,
-  join as join16,
+  join as join17,
   relative as relative5,
   resolve as resolve15
 } from "path";
@@ -27715,24 +27738,198 @@ function formatRunHitCountLines(tables) {
   return lines;
 }
 
+// src/cli/search-ref.ts
+import { mkdirSync as mkdirSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync12 } from "fs";
+import { dirname as dirname8, join as join9 } from "path";
+var SEARCH_REF_TTL_MS = 15 * 6e4;
+function lastSearchPath() {
+  return join9(sdkCliStateDirPath(resolveConfig().baseUrl), "last-search.json");
+}
+function rememberSearchRef(searchRef) {
+  try {
+    mkdirSync9(dirname8(lastSearchPath()), { recursive: true });
+    writeFileSync12(
+      lastSearchPath(),
+      JSON.stringify({ searchRef, at: Date.now() }),
+      { mode: 384 }
+    );
+  } catch {
+  }
+}
+function recentSearchRef() {
+  try {
+    const saved = JSON.parse(readFileSync12(lastSearchPath(), "utf8"));
+    return typeof saved.searchRef === "string" && typeof saved.at === "number" && Date.now() - saved.at < SEARCH_REF_TTL_MS ? saved.searchRef : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
+// src/cli/commands/search.ts
+var SEARCH_TYPES = [
+  "tools",
+  "plays",
+  "monitors",
+  "prebuilts",
+  "custom"
+];
+var USAGE = "Usage: deepline search [query] [--type <types>] [--categories <categories>] [--search_terms <terms>] [--json]";
+function parseTypes(flag, raw) {
+  const names = (raw ?? "").split(",").map((name) => name.trim().toLowerCase()).filter(Boolean);
+  const unknown = names.filter(
+    (name) => !SEARCH_TYPES.includes(name)
+  );
+  if (unknown.length > 0) {
+    throw new Error(
+      `Unknown ${flag} ${unknown.join(", ")}. Use any of: ${SEARCH_TYPES.join(", ")}.`
+    );
+  }
+  return names;
+}
+function optionalInteger(raw) {
+  return raw === void 0 ? void 0 : Number.parseInt(raw, 10);
+}
+function appendCsv(value, previous) {
+  return previous ? `${previous},${value}` : value;
+}
+function addSearchOptions(command) {
+  return command.option(
+    "--categories <categories>",
+    "Comma-separated tool categories; may be used without a query"
+  ).option(
+    "--search_terms <terms>",
+    "Comma-separated structured search terms; may be used without a query"
+  ).option("--search-terms <terms>", "Alias for --search_terms").option(
+    "--task <sentence>",
+    "What you are trying to accomplish: input you have -> result you need"
+  ).option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--json", "Emit JSON output instead of the readable default");
+}
+async function runSearch(queryInput, options, types, exclude = []) {
+  const query = queryInput?.trim() ?? "";
+  const searchTerms = options.searchTerms ?? options.search_terms;
+  if (!query && !options.categories?.trim() && !searchTerms?.trim()) {
+    console.error(USAGE);
+    return 1;
+  }
+  const { search_ref: searchRef, ...result } = await new DeeplineClient().search({
+    query,
+    types,
+    exclude,
+    categories: options.categories,
+    searchTerms,
+    task: options.task,
+    limit: optionalInteger(options.limit),
+    offset: optionalInteger(options.offset),
+    searchMode: options.searchMode === "v1" || options.searchMode === "v2" ? options.searchMode : void 0,
+    includeSearchDebug: Boolean(options.includeSearchDebug)
+  });
+  if (searchRef) rememberSearchRef(searchRef);
+  printCommandEnvelope(result, {
+    json: options.json === true
+  });
+  return 0;
+}
+function registerDeprecatedSearchCommand(parent, typesFor) {
+  const name = `deepline ${parent.name()} search`;
+  addSearchOptions(
+    parent.command("search [query]").description(`Deprecated. Use deepline search --type <types>.`).addHelpText(
+      "after",
+      `
+Notes:
+  Deprecated alias for the unified search. It runs deepline search with the
+  matching --type and returns the same results envelope.
+
+Examples:
+  deepline search email --type ${typesFor({}).join(",")}
+`
+    ).option("--all", "Include plays your workspace created").option("--compact", "Accepted for compatibility; results are compact")
+  ).action(async (query, options) => {
+    const types = typesFor(options);
+    console.error(
+      `${name} is deprecated. Use: deepline search${query ? ` ${JSON.stringify(query)}` : ""} --type ${types.join(",")}`
+    );
+    process.exitCode = await runSearch(query, options, types);
+  });
+}
+function registerSearchCommand(program) {
+  addSearchOptions(
+    program.command("search [query]").description(
+      "Search tools, monitors, and plays together, ranked by intent."
+    ).addHelpText(
+      "after",
+      `
+Notes:
+  One ranked search across everything Deepline can run, deploy, or explain.
+  Every result carries a kind: tool, monitor_type, prebuilt_play, custom_play
+  (a play your workspace created), or doc. Narrow with --type, a
+  comma-separated list of:
+    tools      atomic provider operations (deepline tools execute)
+    monitors   monitor types you can deploy
+    prebuilts  Deepline-maintained plays
+    custom     plays your workspace created
+    plays      prebuilts and custom together
+  --exclude takes the same names and leaves those kinds out instead.
+  Ranking uses a third-party AI relevance model. For plays your workspace
+  created it is sent only the play name and description, never play code.
+  Both flags may be repeated: --type tools --type prebuilts.
+  Provide a query, or omit it only when --categories and/or --search_terms is
+  supplied. Use --limit and --offset to page (limit 1-50, offset zero-based);
+  JSON includes next_offset. Pass --task with one sentence on what you are
+  trying to accomplish: the input you have and the result you need. It
+  materially improves ranking, especially for short queries.
+  Search prints a readable result list by default, piped or not, and that is
+  the recommended form. Pass --json only when a program parses the result.
+
+Examples:
+  deepline search "find work email"
+  deepline search "find work email" --type tools --limit 10
+  deepline search "company to contacts" --type plays
+  deepline search "enrich a company" --exclude monitors,custom
+  deepline search linkedin --task "I have 200 LinkedIn profile URLs and need each person's current title and company"
+  deepline search --type tools --categories company_search --search_terms "investors,funding"
+`
+    ).option(
+      "--type <types>",
+      `Kinds to search, comma-separated or repeated: ${SEARCH_TYPES.join(", ")}`,
+      appendCsv
+    ).option(
+      "--exclude <types>",
+      "Kinds to leave out, comma-separated or repeated; the opposite of --type",
+      appendCsv
+    )
+  ).action(async (query, options) => {
+    let types;
+    let exclude;
+    try {
+      types = parseTypes("--type", options.type);
+      exclude = parseTypes("--exclude", options.exclude);
+    } catch (error) {
+      console.error(error instanceof Error ? error.message : String(error));
+      process.exitCode = 1;
+      return;
+    }
+    process.exitCode = await runSearch(query, options, types, exclude);
+  });
+}
+
 // src/plays/bundle-play-file.ts
 import { tmpdir as tmpdir3 } from "os";
-import { dirname as dirname10, join as join11, resolve as resolve11 } from "path";
+import { dirname as dirname11, join as join12, resolve as resolve11 } from "path";
 import { fileURLToPath } from "url";
 import { existsSync as existsSync10 } from "fs";
 import { realpath as realpath2 } from "fs/promises";
 
 // ../plays/bundling/index.ts
 import { createHash as createHash3 } from "crypto";
-import { existsSync as existsSync9, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync13 } from "fs";
 import { mkdir as mkdir3, readFile as readFile2, realpath, stat, writeFile as writeFile4 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
 import {
   basename as basename2,
-  dirname as dirname8,
+  dirname as dirname9,
   extname,
   isAbsolute as isAbsolute3,
-  join as join9,
+  join as join10,
   relative as relative2,
   resolve as resolve9,
   sep
@@ -29604,7 +29801,7 @@ var MAX_PLAY_BUNDLE_BYTES = 30 * 1024 * 1024;
 
 // ../plays/bundling/index.ts
 var PLAY_BUNDLE_CACHE_NAMESPACE = "deepline-play-artifacts-docflow-jsdoc";
-var PLAY_ARTIFACT_CACHE_DIR = join9(tmpdir2(), PLAY_BUNDLE_CACHE_NAMESPACE);
+var PLAY_ARTIFACT_CACHE_DIR = join10(tmpdir2(), PLAY_BUNDLE_CACHE_NAMESPACE);
 var SOURCE_EXTENSIONS = [
   ".ts",
   ".tsx",
@@ -30223,10 +30420,10 @@ import { createHash as createHash4 } from "crypto";
 import { readFile as readFile3, stat as stat2 } from "fs/promises";
 import {
   basename as basename3,
-  dirname as dirname9,
+  dirname as dirname10,
   extname as extname2,
   isAbsolute as isAbsolute4,
-  join as join10,
+  join as join11,
   relative as relative3,
   resolve as resolve10
 } from "path";
@@ -30248,7 +30445,7 @@ var EXPLICIT_IMPORT_EXTENSIONS2 = /* @__PURE__ */ new Set([
 ]);
 
 // src/plays/bundle-play-file.ts
-var MODULE_DIR = dirname10(fileURLToPath(import.meta.url));
+var MODULE_DIR = dirname11(fileURLToPath(import.meta.url));
 var SDK_PACKAGE_ROOT = resolve11(MODULE_DIR, "..", "..");
 var SOURCE_REPO_ROOT = resolve11(SDK_PACKAGE_ROOT, "..", "..");
 var HAS_SOURCE_BUNDLING_SOURCES = existsSync10(
@@ -30275,7 +30472,7 @@ var SDK_ENTRY_FILE = resolve11(SDK_SOURCE_ROOT, "index.ts");
 var SDK_TYPES_ENTRY_FILE = HAS_SOURCE_BUNDLING_SOURCES ? SDK_ENTRY_FILE : resolve11(SDK_PACKAGE_ROOT, "dist", "index.d.ts");
 
 // src/cli/run-dataset-csv.ts
-import { writeFileSync as writeFileSync12 } from "fs";
+import { writeFileSync as writeFileSync13 } from "fs";
 import { resolve as resolve12 } from "path";
 
 // ../plays/table-csv.ts
@@ -30384,7 +30581,7 @@ var RunDatasetCsv = class _RunDatasetCsv {
   write(outPath) {
     const absolutePath = resolve12(outPath);
     const { rows, columns } = this.#projection;
-    writeFileSync12(
+    writeFileSync13(
       absolutePath,
       tableCsvText(
         columns,
@@ -31023,7 +31220,7 @@ function extractCanonicalRowsInfo(statusOrResult) {
 }
 
 // src/cli/run-dataset-selection.ts
-import { writeFileSync as writeFileSync13 } from "fs";
+import { writeFileSync as writeFileSync14 } from "fs";
 import { resolve as resolve13 } from "path";
 var Run = class _Run {
   #datasets;
@@ -31151,7 +31348,7 @@ var RunDataset = class _RunDataset {
     }
     if (options.format === "json") {
       const absolutePath = resolve13(outPath);
-      writeFileSync13(
+      writeFileSync14(
         absolutePath,
         `${JSON.stringify(orderRunExportJson(this.rows), null, 2)}
 `,
@@ -32115,10 +32312,10 @@ function normalizeFixtureScopeValue(value, maxLength) {
 import { randomUUID as randomUUID6 } from "crypto";
 import { mkdtemp as mkdtemp2, realpath as realpath3, rm as rm2 } from "fs/promises";
 import { tmpdir as tmpdir4 } from "os";
-import { join as join15, resolve as resolve14 } from "path";
+import { join as join16, resolve as resolve14 } from "path";
 
 // ../plays/deploy/run-deployment.ts
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 import { mkdir as mkdir4, mkdtemp, rm } from "fs/promises";
 
 // ../plays/deployment-status.ts
@@ -32292,7 +32489,7 @@ var DeployApiClient = class {
 // ../plays/deploy/manifest.ts
 var import_picomatch = __toESM(require_picomatch2(), 1);
 import { readdir, readFile as readFile4, stat as stat3 } from "fs/promises";
-import { join as join12, relative as relative4 } from "path";
+import { join as join13, relative as relative4 } from "path";
 var DEFAULT_PLAY_GLOBS = ["**/*.play.ts"];
 var DEFAULT_MONITOR_GLOBS = ["**/*.monitor.json"];
 var MAX_DISCOVERED_FILES = 200;
@@ -32355,7 +32552,7 @@ var DEFAULT_MANIFEST_FILE = "deepline.json";
 async function readDeeplineManifest(projectRoot, manifestFile = DEFAULT_MANIFEST_FILE) {
   let raw = null;
   try {
-    raw = await readFile4(join12(projectRoot, manifestFile), "utf8");
+    raw = await readFile4(join13(projectRoot, manifestFile), "utf8");
   } catch (error) {
     const code = error.code;
     if (code !== "ENOENT" && code !== "ENOTDIR") {
@@ -32386,7 +32583,7 @@ async function discoverDeploymentFiles(input2) {
     const entries = await readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.name.startsWith(".") && entry.name !== ".") continue;
-      const absolute = join12(dir, entry.name);
+      const absolute = join13(dir, entry.name);
       if (entry.isDirectory()) {
         if (IGNORED_DIRECTORIES.has(entry.name)) continue;
         await walk(absolute);
@@ -32417,7 +32614,7 @@ var discoverPlayFiles = discoverDeploymentFiles;
 
 // ../plays/deploy/monitor-files.ts
 import { readFile as readFile5 } from "fs/promises";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 async function readMonitorFiles(input2) {
   const files = await discoverDeploymentFiles(input2);
   if (files.length > 100) {
@@ -32428,7 +32625,7 @@ async function readMonitorFiles(input2) {
   return Promise.all(
     files.map(async (file) => {
       const sourcePath = input2.rootDirectory ? `${input2.rootDirectory}/${file}` : file;
-      const raw = await readFile5(join13(input2.projectRoot, file), "utf8");
+      const raw = await readFile5(join14(input2.projectRoot, file), "utf8");
       try {
         return { file: sourcePath, definition: JSON.parse(raw) };
       } catch {
@@ -32721,7 +32918,7 @@ async function runDeployment(params, hooks) {
     };
   };
   await mkdir4(hooks.workRoot, { recursive: true });
-  const workDir = await mkdtemp(join14(hooks.workRoot, "deploy-"));
+  const workDir = await mkdtemp(join15(hooks.workRoot, "deploy-"));
   const postCheck = async (postCheckOnce, input2) => {
     let lastError;
     for (let attempt = 0; ; attempt += 1) {
@@ -32847,7 +33044,7 @@ async function runDeployment(params, hooks) {
       if (superseded) return superseded;
     }
     const { repoRoot } = await source.open(workDir);
-    const projectRoot = target.rootDirectory ? join14(repoRoot, target.rootDirectory) : repoRoot;
+    const projectRoot = target.rootDirectory ? join15(repoRoot, target.rootDirectory) : repoRoot;
     const manifestFile = target.manifestPath || DEFAULT_MANIFEST_FILE;
     let manifest;
     let playFiles;
@@ -32941,7 +33138,7 @@ async function runDeployment(params, hooks) {
       annotations.push(annotationForFailure({ file, message }));
     };
     for (const file of playFiles) {
-      const entryFile = join14(projectRoot, file);
+      const entryFile = join15(projectRoot, file);
       const result = await hooks.bundle(entryFile, {
         sourceIdentityRoot: projectRoot
       });
@@ -33441,7 +33638,7 @@ async function handlePlaysDeploy(directory, options) {
     ...options.commit ? { commit: options.commit } : {}
   });
   const { bundleDeployPlayFile } = await loadPlayBundler();
-  const workRoot = await mkdtemp2(join15(tmpdir4(), "deepline-deploy-"));
+  const workRoot = await mkdtemp2(join16(tmpdir4(), "deepline-deploy-"));
   const consoleInfo = console.info;
   console.info = console.error;
   try {
@@ -34077,8 +34274,8 @@ async function pathExistsIncludingSymlink(path) {
   }
 }
 function runIdFileTempPath(destination) {
-  return join16(
-    dirname11(destination),
+  return join17(
+    dirname12(destination),
     `.${basename4(destination)}.${process.pid}.${randomUUID7()}.tmp`
   );
 }
@@ -34172,7 +34369,7 @@ async function writePlayRunIdFile(destination, runId, options = {}) {
       }
     }
     if (process.platform !== "win32") {
-      const directory = await open(dirname11(destination), "r");
+      const directory = await open(dirname12(destination), "r");
       try {
         await directory.sync();
       } finally {
@@ -34369,7 +34566,7 @@ function buildPlayReferenceNotFoundMessage(input2) {
     lines.push(
       "",
       "Search visible plays:",
-      `  deepline plays search ${shellQuote4(searchQuery)} --all --json`
+      `  deepline search --type plays ${shellQuote4(searchQuery)} --json`
     );
   }
   return lines.join("\n");
@@ -34505,12 +34702,12 @@ function materializeRemotePlaySource(input2) {
           `Refusing to materialize unsafe Play source path ${JSON.stringify(logicalPath)}.`
         );
       }
-      mkdirSync9(dirname11(outputPath2), { recursive: true });
+      mkdirSync10(dirname12(outputPath2), { recursive: true });
       if (!existsSync11(outputPath2)) {
-        writeFileSync14(outputPath2, sourceCode, "utf-8");
+        writeFileSync15(outputPath2, sourceCode, "utf-8");
         created += 1;
-      } else if (readFileSync13(outputPath2, "utf-8") !== sourceCode) {
-        writeFileSync14(outputPath2, sourceCode, "utf-8");
+      } else if (readFileSync14(outputPath2, "utf-8") !== sourceCode) {
+        writeFileSync15(outputPath2, sourceCode, "utf-8");
         updated += 1;
       }
     }
@@ -34523,14 +34720,14 @@ function materializeRemotePlaySource(input2) {
   }
   const outputPath = input2.outPath ?? defaultMaterializedPlayPath(input2.playName);
   if (existsSync11(outputPath)) {
-    const existingSource = readFileSync13(outputPath, "utf-8");
+    const existingSource = readFileSync14(outputPath, "utf-8");
     if (existingSource === entrySource) {
       return { path: outputPath, status: "unchanged", created: false };
     }
-    writeFileSync14(outputPath, entrySource, "utf-8");
+    writeFileSync15(outputPath, entrySource, "utf-8");
     return { path: outputPath, status: "updated", created: false };
   }
-  writeFileSync14(outputPath, entrySource, "utf-8");
+  writeFileSync15(outputPath, entrySource, "utf-8");
   return { path: outputPath, status: "created", created: true };
 }
 function formatLoadedPlayMessage(materializedFile) {
@@ -34604,7 +34801,7 @@ function parsePositiveInteger3(value, flagName) {
   return parsed;
 }
 function parseJsonInput(raw, flag = "--input") {
-  const source = raw.startsWith("@") ? readFileSync13(resolve15(raw.slice(1)), "utf-8") : raw;
+  const source = raw.startsWith("@") ? readFileSync14(resolve15(raw.slice(1)), "utf-8") : raw;
   let parsed;
   try {
     parsed = JSON.parse(source);
@@ -34780,7 +34977,7 @@ function preflightLocalFileInputs(runtimeInput) {
 function preflightCsvDataInput(ref, absolutePath) {
   let content;
   try {
-    content = readFileSync13(absolutePath, "utf-8");
+    content = readFileSync14(absolutePath, "utf-8");
   } catch (error) {
     throw new DeeplineError(
       `Input ${ref.inputPath} CSV ${ref.value} is not readable: ${error instanceof Error ? error.message : String(error)}. No run was created.`,
@@ -34811,7 +35008,7 @@ async function stageFileInputArgs(input2) {
       const absolutePath = resolve15(value);
       return {
         logicalPath: basename4(absolutePath),
-        read: async () => readFileSync13(absolutePath)
+        read: async () => readFileSync14(absolutePath)
       };
     },
     onStaging: (fileCount) => input2.progress.phase(
@@ -34820,7 +35017,7 @@ async function stageFileInputArgs(input2) {
   });
 }
 function stageFile(logicalPath, absolutePath) {
-  const buffer = readFileSync13(absolutePath);
+  const buffer = readFileSync14(absolutePath);
   return {
     logicalPath,
     contentBase64: buffer.toString("base64"),
@@ -39311,7 +39508,7 @@ async function handlePlayCheck(args) {
     }
   }
   const absolutePlayPath = resolve15(options.target);
-  const sourceCode = readFileSync13(absolutePlayPath, "utf-8");
+  const sourceCode = readFileSync14(absolutePlayPath, "utf-8");
   const exportNames = resolvePlayCheckExportNames(sourceCode);
   const outcomes = [];
   for (const exportName of exportNames) {
@@ -39440,7 +39637,7 @@ async function handleFileBackedRun(options, hooks) {
   const sourceCode = traceCliSync(
     "cli.play_file_read_source",
     { targetKind: "file" },
-    () => readFileSync13(absolutePlayPath, "utf-8")
+    () => readFileSync14(absolutePlayPath, "utf-8")
   );
   const runtimeInput = options.input ? { ...options.input } : {};
   try {
@@ -39859,7 +40056,7 @@ async function handlePlayRun(args, hooks) {
     }
     const resolved = resolve15(options.target.path);
     console.error(`File not found: ${resolved}`);
-    const dir = dirname11(resolved);
+    const dir = dirname12(resolved);
     if (existsSync11(dir)) {
       const base = basename4(resolved);
       try {
@@ -39869,7 +40066,7 @@ async function handlePlayRun(args, hooks) {
         if (siblings.length > 0) {
           console.error(`Did you mean one of these?`);
           for (const s of siblings.slice(0, 5)) {
-            console.error(`  ${join16(dir, s)}`);
+            console.error(`  ${join17(dir, s)}`);
           }
         }
       } catch {
@@ -40674,7 +40871,7 @@ async function handleRunLogs(args) {
   if (outPath) {
     const result2 = await client2.runs.logs(runId, { all: true });
     const logs = result2.entries.filter((line) => logLevelReaches(classifyLogLine(line).level, logLevel)).map((line) => classifyLogLine(line).line);
-    writeFileSync14(outPath, `${logs.join("\n")}${logs.length > 0 ? "\n" : ""}`);
+    writeFileSync15(outPath, `${logs.join("\n")}${logs.length > 0 ? "\n" : ""}`);
     printCommandEnvelope(
       {
         runId: result2.runId,
@@ -41301,7 +41498,7 @@ async function handleRunExport(args) {
     payload.actions
   );
   if (metadataOutPath) {
-    writeFileSync14(
+    writeFileSync15(
       metadataOutPath,
       `${JSON.stringify(payload, null, 2)}
 `,
@@ -41373,7 +41570,7 @@ async function handlePlayGet(args) {
     );
     return 2;
   }
-  const playName = isFileTarget(target) ? extractPlayName(readFileSync13(resolve15(target), "utf-8"), resolve15(target)) : parseReferencedPlayTarget2(target).playName;
+  const playName = isFileTarget(target) ? extractPlayName(readFileSync14(resolve15(target), "utf-8"), resolve15(target)) : parseReferencedPlayTarget2(target).playName;
   const includeSource = sourceOutput || outPath !== null;
   const detail = isFileTarget(target) ? await client2.getPlay(
     playName,
@@ -41664,23 +41861,6 @@ async function handlePlayPin(args, pinned) {
   else console.log(`${result.pinned ? "Pinned" : "Unpinned"} ${result.name}.`);
   return 0;
 }
-function parsePlaySearchOptions(args) {
-  const query = args[0]?.trim();
-  if (!query) {
-    throw new Error(
-      "Usage: deepline plays search <query> [--all] [--compact] [--json]"
-    );
-  }
-  return {
-    query,
-    jsonOutput: argsWantJson(args),
-    compact: args.includes("--compact"),
-    scope: args.includes("--all") && !args.includes("--prebuilt") ? "all" : "prebuilt"
-  };
-}
-function playSearchDisclaimer(scope) {
-  return scope === "all" ? "Prebuilt-first search: Deepline-managed prebuilts are trusted, robust plays with maintained contracts, so they are listed before plays you created. Use created-play results only when you are specifically looking for one." : "Prebuilt-first search: Deepline-managed prebuilts are trusted, robust plays with maintained contracts. Plays you created are omitted by default; add --all only when you are specifically looking for one.";
-}
 function csvColumnLines(csvInput) {
   const rowSchema = isRecord7(csvInput.rowInputSchema) ? csvInput.rowInputSchema : {};
   const columns = isRecord7(rowSchema.properties) ? Object.keys(rowSchema.properties) : [];
@@ -41779,45 +41959,6 @@ function printPlayDescription(play) {
     console.log(`  Check starter: ${cloneEditStarter.checkCommand}`);
   }
 }
-function inputFieldNames(schema) {
-  const fields2 = Array.isArray(schema?.fields) ? schema.fields : [];
-  return fields2.map(
-    (field) => field && typeof field === "object" ? String(field.name ?? "").trim() : ""
-  ).filter(Boolean);
-}
-function printCompactPlaySearchResult(play) {
-  const reference = formatPlayListReference(play);
-  const aliases = play.aliases.slice(0, 6).join(", ");
-  console.log(`Play: ${reference}`);
-  if (play.displayName && play.displayName !== play.name) {
-    console.log(`  Display name: ${play.displayName}`);
-  }
-  if (play.description) {
-    console.log(`  Description: ${play.description}`);
-  }
-  if (aliases) {
-    console.log(`  Aliases: ${aliases}`);
-  }
-  const fields2 = inputFieldNames(play.inputSchema);
-  if (fields2.length > 0) {
-    console.log(`  Inputs: ${fields2.join(", ")}`);
-  } else if (play.inputSchema) {
-    console.log("  Inputs: see describe");
-  }
-  console.log(`  Describe: deepline plays describe ${reference} --json`);
-  console.log(`  Run: ${play.runCommand}`);
-}
-function compactPlaySchema(schema) {
-  if (!schema) return null;
-  const fields2 = Array.isArray(schema.fields) ? schema.fields.map(
-    (field) => field && typeof field === "object" ? {
-      name: String(field.name ?? ""),
-      type: field.type ?? void 0,
-      required: field.required ?? void 0
-    } : null
-  ).filter((field) => Boolean(field?.name)) : [];
-  return fields2.length > 0 ? { fields: fields2 } : schema;
-}
 function summarizePlayGrepResult(play) {
   const reference = formatPlayListReference(play);
   return {
@@ -41830,61 +41971,6 @@ function summarizePlayGrepResult(play) {
 function formatPlayGrepMatches(matches) {
   return matches.map((match) => `${match.field}: ${match.terms.join(", ")}`).join("; ");
 }
-async function handlePlaySearch(args) {
-  let options;
-  try {
-    options = parsePlaySearchOptions(args);
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    return 1;
-  }
-  const client2 = new DeeplineClient();
-  const plays = await client2.searchPlays({
-    query: options.query,
-    compact: options.compact,
-    scope: options.scope
-  });
-  const disclaimer = playSearchDisclaimer(options.scope);
-  if (options.jsonOutput) {
-    const jsonPlays = options.scope === "prebuilt" ? plays.map((play) => ({
-      ...play,
-      inputSchema: compactPlaySchema(play.inputSchema)
-    })) : plays;
-    printCompactJson({
-      disclaimer,
-      search_policy: {
-        default_scope: "prebuilt",
-        included_origins: options.scope === "all" ? ["prebuilt", "owned"] : ["prebuilt"],
-        owned_plays_omitted: options.scope === "prebuilt",
-        include_owned_flag: "--all"
-      },
-      plays: jsonPlays,
-      total: jsonPlays.length,
-      truncated: false
-    });
-    return 0;
-  }
-  const displayPlays = options.scope === "prebuilt" ? plays.slice(0, 5) : plays;
-  process.stdout.write(`${disclaimer}
-`);
-  process.stdout.write(
-    `${plays.length} plays found${options.scope === "prebuilt" && plays.length > displayPlays.length ? `; showing top ${displayPlays.length}` : ""}:
-
-`
-  );
-  for (const play of displayPlays) {
-    if (options.scope === "prebuilt") {
-      printCompactPlaySearchResult(play);
-    } else {
-      printPlayDescription(play);
-    }
-    console.log("");
-  }
-  if (options.scope === "prebuilt" && plays.length > displayPlays.length) {
-    console.log("Use --json for the full machine-readable result set.");
-  }
-  return 0;
-}
 async function handlePlayGrep(args) {
   const query = args[0]?.trim();
   if (!query) {
@@ -41942,7 +42028,7 @@ async function handlePlayDescribe(args) {
     const definedName = isFileTarget(playName) ? (() => {
       try {
         return extractPlayName(
-          readFileSync13(resolve15(playName), "utf-8"),
+          readFileSync14(resolve15(playName), "utf-8"),
           playName
         );
       } catch {
@@ -42487,7 +42573,7 @@ Authoring:
   Play work unless the caller explicitly asks to leave the inferred graph.
 
 Common commands:
-  deepline plays search email --json
+  deepline search --type prebuilts email --json
   deepline plays describe prebuilt/person-linkedin-to-email --json
   deepline plays check prebuilt/name-and-domain-to-email-waterfall-batch
   deepline plays run prebuilt/person-linkedin-to-email --input '{"linkedin_url":"..."}'
@@ -42794,7 +42880,7 @@ Notes:
 Examples:
   deepline plays list
   deepline plays list --tag smb --json
-  deepline plays search email --json
+  deepline search --type prebuilts email --json
 `
   ).option("--limit <count>", "Page size").option("--cursor <cursor>", "Continue a previous page").option("--show-cost", "Include the per-row or per-run cost estimate").option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
     "--categories <categories>",
@@ -42863,40 +42949,10 @@ Examples:
       false
     );
   });
-  const addPlaySearchCommand = (command) => command.description("Search Deepline prebuilt plays by task.").option(
-    "--prebuilt",
-    "Only show Deepline-managed prebuilt plays (default)"
-  ).option(
-    "--all",
-    "Also include plays you created after Deepline-managed prebuilts"
-  ).addHelpText(
-    "after",
-    `
-Notes:
-  Ranked discovery for workflows. Search defaults to Deepline-managed prebuilts
-  because they are trusted, robust plays with maintained contracts. Use describe
-  on a result before running it.
-  Add --all only when you are specifically looking for a play you created.
-  Use plays grep to search active org-owned Plays through Convex's indexed
-  authored corpus. It does not search prebuilt or archived Plays.
-
-Examples:
-  deepline plays search email
-  deepline plays search email --all
-  deepline plays grep "linkedin to email" --json
-  deepline plays describe prebuilt/person-linkedin-to-email --json
-  deepline plays describe prebuilt/person-linkedin-to-email --json inputSchema,runCommand
-`
-  ).option("--compact", "Emit compact schemas").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (query, options) => {
-    process.exitCode = await handlePlaySearch([
-      query,
-      ...options.prebuilt ? ["--prebuilt"] : [],
-      ...options.all ? ["--all"] : [],
-      ...options.compact ? ["--compact"] : [],
-      ...options.json ? ["--json"] : []
-    ]);
-  });
-  addPlaySearchCommand(play.command("search <query>"));
+  registerDeprecatedSearchCommand(
+    play,
+    (options) => options.all ? ["plays"] : ["prebuilts"]
+  );
   play.command("grep <query>").description(
     "Search active org-owned Plays through Convex full-text search."
   ).addHelpText(
@@ -44321,23 +44377,23 @@ import { spawnSync as spawnSync3 } from "child_process";
 import {
   existsSync as existsSync15,
   lstatSync as lstatSync2,
-  mkdirSync as mkdirSync12,
-  readFileSync as readFileSync17,
+  mkdirSync as mkdirSync13,
+  readFileSync as readFileSync18,
   realpathSync as realpathSync5,
-  writeFileSync as writeFileSync17
+  writeFileSync as writeFileSync18
 } from "fs";
 import { homedir as homedir9 } from "os";
-import { dirname as dirname15, join as join20, resolve as resolve17 } from "path";
+import { dirname as dirname16, join as join21, resolve as resolve17 } from "path";
 
 // src/cli/installation-lifecycle.ts
 import {
   existsSync as existsSync12,
   lstatSync,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   realpathSync as realpathSync4,
   rmSync as rmSync4
 } from "fs";
-import { basename as basename5, dirname as dirname12, join as join17, relative as relative6, resolve as resolve16 } from "path";
+import { basename as basename5, dirname as dirname13, join as join18, relative as relative6, resolve as resolve16 } from "path";
 var nodeFileSystem = {
   exists: existsSync12,
   isSymbolicLink(path) {
@@ -44349,7 +44405,7 @@ var nodeFileSystem = {
   },
   read(path) {
     try {
-      return readFileSync14(path, "utf8");
+      return readFileSync15(path, "utf8");
     } catch {
       return "";
     }
@@ -44393,25 +44449,25 @@ var CliInstallation = class _CliInstallation {
     });
   }
   static isNpmPackagePath(path) {
-    return path?.includes(`${join17("node_modules", "deepline")}`) ?? false;
+    return path?.includes(`${join18("node_modules", "deepline")}`) ?? false;
   }
   launcher(path) {
     return inspectLauncher(path, this.input.fileSystem);
   }
   retiredArtifacts() {
-    const hostDir = join17(
+    const hostDir = join18(
       this.input.home,
       ".local",
       "deepline",
       this.input.baseUrlSlug
     );
-    const legacyLauncherPath = join17(
+    const legacyLauncherPath = join18(
       this.input.home,
       ".local",
       "bin",
       "deepline"
     );
-    const installerCommandPath = this.input.fileSystem.read(join17(hostDir, "sdk", ".command-path")).trim();
+    const installerCommandPath = this.input.fileSystem.read(join18(hostDir, "sdk", ".command-path")).trim();
     const ownedInstallerCommand = isOwnedInstallerCommandPath({
       hostDir,
       commandPath: installerCommandPath
@@ -44419,16 +44475,16 @@ var CliInstallation = class _CliInstallation {
     const legacyLauncher = this.launcher(legacyLauncherPath);
     const candidates = [
       ...legacyLauncher.ownership === "installer_legacy" ? [legacyLauncherPath] : [],
-      join17(this.input.home, ".local", "bin", "deepline-real"),
-      join17(hostDir, "bin", "deepline"),
-      join17(hostDir, "bin", "deepline-real"),
-      join17(hostDir, "cli", ".install-method"),
-      join17(hostDir, "cli", ".version"),
-      join17(hostDir, "sdk", ".install-method"),
-      join17(hostDir, "sdk", ".command-path"),
+      join18(this.input.home, ".local", "bin", "deepline-real"),
+      join18(hostDir, "bin", "deepline"),
+      join18(hostDir, "bin", "deepline-real"),
+      join18(hostDir, "cli", ".install-method"),
+      join18(hostDir, "cli", ".version"),
+      join18(hostDir, "sdk", ".install-method"),
+      join18(hostDir, "sdk", ".command-path"),
       ...ownedInstallerCommand ? [
         installerCommandPath,
-        join17(dirname12(installerCommandPath), "deepline-sdk")
+        join18(dirname13(installerCommandPath), "deepline-sdk")
       ] : []
     ];
     return {
@@ -44459,9 +44515,9 @@ function isOwnedInstallerCommandPath(input2) {
 
 // src/cli/commands/skills.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync14, mkdirSync as mkdirSync11, readFileSync as readFileSync16, writeFileSync as writeFileSync16 } from "fs";
+import { existsSync as existsSync14, mkdirSync as mkdirSync12, readFileSync as readFileSync17, writeFileSync as writeFileSync17 } from "fs";
 import { homedir as homedir8 } from "os";
-import { dirname as dirname14, join as join19 } from "path";
+import { dirname as dirname15, join as join20 } from "path";
 
 // contracts/install-commands.json
 var install_commands_default = {
@@ -44580,15 +44636,15 @@ import { gunzipSync } from "zlib";
 import {
   appendFileSync,
   existsSync as existsSync13,
-  mkdirSync as mkdirSync10,
+  mkdirSync as mkdirSync11,
   readdirSync as readdirSync4,
-  readFileSync as readFileSync15,
+  readFileSync as readFileSync16,
   renameSync,
   rmSync as rmSync5,
   unlinkSync as unlinkSync2,
-  writeFileSync as writeFileSync15
+  writeFileSync as writeFileSync16
 } from "fs";
-import { dirname as dirname13, join as join18 } from "path";
+import { dirname as dirname14, join as join19 } from "path";
 
 // src/cli/windows-arg-escape.ts
 var CMD_META_CHARS = /([()\][%!^"`<>&|;, *?])/g;
@@ -44998,7 +45054,7 @@ function shouldSkipSkillsSync() {
   return value === "1" || value === "true" || value === "yes" || value === "on";
 }
 function unavailableSkillsNoticePath(baseUrl) {
-  return join18(sdkCliStateDirPath(baseUrl), "skills-sync-unavailable-version");
+  return join19(sdkCliStateDirPath(baseUrl), "skills-sync-unavailable-version");
 }
 var SKILLS_SYNC_IN_PROGRESS_TTL_MS = 10 * 60 * 1e3;
 var SKILLS_SYNC_IN_PROGRESS_PID_CAP_MS = 6 * 60 * 60 * 1e3;
@@ -45008,21 +45064,21 @@ function sortedLeaseAgents(agents) {
   return [...new Set(expanded)].sort((a, b) => a.localeCompare(b));
 }
 function inProgressSkillsSyncPath(baseUrl, agent) {
-  return join18(
+  return join19(
     sdkCliStateDirPath(baseUrl),
     `skills-sync-in-progress-${agentLeaseSegment(agent)}`
   );
 }
 function readInProgressSkillsSyncLeaseFromDir(dir) {
-  const claim = readMarkedSkillsSyncVersion(join18(dir, "claim"));
+  const claim = readMarkedSkillsSyncVersion(join19(dir, "claim"));
   const [version = "", startedAt = ""] = claim.split(" ");
-  const pidRaw = readMarkedSkillsSyncVersion(join18(dir, "pid"));
+  const pidRaw = readMarkedSkillsSyncVersion(join19(dir, "pid"));
   return {
     claimToken: version && startedAt ? `${version} ${startedAt}` : "",
     version,
     startedAt: Number(startedAt),
     pid: /^\d+$/.test(pidRaw) ? Number(pidRaw) : null,
-    owner: readMarkedSkillsSyncVersion(join18(dir, "owner"))
+    owner: readMarkedSkillsSyncVersion(join19(dir, "owner"))
   };
 }
 function readInProgressSkillsSyncLease(baseUrl, agent) {
@@ -45079,10 +45135,10 @@ function claimOneInProgressSkillsSync(baseUrl, remoteVersion, agent, owner) {
   const create = () => {
     const claimToken = `${remoteVersion} ${Date.now()}`;
     const staging = `${dir}.staging-${process.pid}-${Date.now()}`;
-    mkdirSync10(staging);
-    writeFileSync15(join18(staging, "claim"), `${claimToken}
+    mkdirSync11(staging);
+    writeFileSync16(join19(staging, "claim"), `${claimToken}
 `, "utf-8");
-    writeFileSync15(join18(staging, "owner"), `${owner}
+    writeFileSync16(join19(staging, "owner"), `${owner}
 `, "utf-8");
     try {
       renameSync(staging, dir);
@@ -45096,7 +45152,7 @@ function claimOneInProgressSkillsSync(baseUrl, remoteVersion, agent, owner) {
     return { state: "claimed", claimToken };
   };
   try {
-    mkdirSync10(dirname13(dir), { recursive: true });
+    mkdirSync11(dirname14(dir), { recursive: true });
     return create();
   } catch (error) {
     if (errorCode(error) !== "EEXIST") return { state: "unavailable" };
@@ -45155,8 +45211,8 @@ function recordOwnPidOnInProgressSkillsSync(baseUrl, leases) {
   for (const [agent, lease] of leases) {
     if (!lease.claimToken) continue;
     try {
-      writeFileSync15(
-        join18(inProgressSkillsSyncPath(baseUrl, agent), "pid"),
+      writeFileSync16(
+        join19(inProgressSkillsSyncPath(baseUrl, agent), "pid"),
         `${process.pid}
 `,
         "utf-8"
@@ -45225,7 +45281,7 @@ function skillsInstallLeasePath(baseUrl, agents) {
   return sortedLeaseAgents(agents).map((agent) => inProgressSkillsSyncPath(baseUrl, agent)).join(", ");
 }
 function deferredSkillsNoticePath(baseUrl, agents) {
-  return join18(
+  return join19(
     sdkCliStateDirPath(baseUrl),
     `skills-sync-notice-${sortedLeaseAgents(agents).map(agentLeaseSegment).join("-")}`
   );
@@ -45234,7 +45290,7 @@ function deferSkillsNotice(baseUrl, agents) {
   const path = deferredSkillsNoticePath(baseUrl, agents);
   return (text) => {
     try {
-      mkdirSync10(dirname13(path), { recursive: true });
+      mkdirSync11(dirname14(path), { recursive: true });
       appendFileSync(path, `${text.trimEnd()}
 `, "utf-8");
     } catch {
@@ -45248,7 +45304,7 @@ function flushDeferredSkillsNotices(baseUrl, agents) {
   if (!tombstone) return;
   let text = "";
   try {
-    text = readFileSync15(tombstone, "utf-8");
+    text = readFileSync16(tombstone, "utf-8");
   } catch {
     return;
   } finally {
@@ -45276,7 +45332,7 @@ function spawnDetachedSkillsSyncChild(argv, onSpawnError) {
   child.unref();
 }
 function failedSkillsSyncPath(baseUrl, agents) {
-  return join18(
+  return join19(
     sdkCliStateDirPath(baseUrl),
     `skills-sync-failed-${sortedLeaseAgents(agents).map(agentLeaseSegment).join("-")}-version`
   );
@@ -45286,15 +45342,15 @@ function hasMarkedSkillsSyncVersion(path, version) {
 }
 function readMarkedSkillsSyncVersion(path) {
   try {
-    return existsSync13(path) ? readFileSync15(path, "utf-8").trim() : "";
+    return existsSync13(path) ? readFileSync16(path, "utf-8").trim() : "";
   } catch {
     return "";
   }
 }
 function writeMarkedSkillsSyncVersion(path, version) {
   try {
-    mkdirSync10(dirname13(path), { recursive: true });
-    writeFileSync15(path, `${version}
+    mkdirSync11(dirname14(path), { recursive: true });
+    writeFileSync16(path, `${version}
 `, "utf-8");
     return true;
   } catch {
@@ -45403,7 +45459,7 @@ function safeSkillFilePath(value) {
 }
 function installedSkillFiles(root, prefix = "") {
   const files = [];
-  for (const entry of readdirSync4(join18(root, prefix), {
+  for (const entry of readdirSync4(join19(root, prefix), {
     withFileTypes: true
   })) {
     const relativePath = prefix ? `${prefix}/${entry.name}` : entry.name;
@@ -45523,11 +45579,11 @@ async function verifyDefaultAgentSkillsInstall(baseUrl, remoteVersion, skillName
     controller.abort();
   }
   const home = homedir7();
-  const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join18(home, ".claude");
+  const claudeConfigDir = process.env.CLAUDE_CONFIG_DIR?.trim() || join19(home, ".claude");
   for (const [name, { files }] of published) {
     for (const root of [
-      join18(home, ".agents", "skills", name),
-      join18(claudeConfigDir, "skills", name)
+      join19(home, ".agents", "skills", name),
+      join19(claudeConfigDir, "skills", name)
     ]) {
       const installed = installedSkillFiles(root);
       if (installed.length !== files.length || installed.some((file, index2) => file !== files[index2])) {
@@ -45535,7 +45591,7 @@ async function verifyDefaultAgentSkillsInstall(baseUrl, remoteVersion, skillName
       }
       for (const file of files) {
         const publishedContent = expected.get(`${name}/${file}`);
-        if (!publishedContent || !readFileSync15(join18(root, file)).equals(publishedContent)) {
+        if (!publishedContent || !readFileSync16(join19(root, file)).equals(publishedContent)) {
           throw new Error(`installed content differs for ${name}/${file}`);
         }
       }
@@ -45589,7 +45645,7 @@ function probeInstallers(timeoutMs) {
   };
 }
 function noInstallerProbePath(baseUrl) {
-  return join18(
+  return join19(
     sdkCliStateDirPath(baseUrl),
     "skills-sync-no-installer-unknown.json"
   );
@@ -45597,7 +45653,7 @@ function noInstallerProbePath(baseUrl) {
 function dueUnknownInstallerProbes(baseUrl, remoteVersion) {
   const path = noInstallerProbePath(baseUrl);
   try {
-    const cached = JSON.parse(readFileSync15(path, "utf-8"));
+    const cached = JSON.parse(readFileSync16(path, "utf-8"));
     if (cached.version === remoteVersion && typeof cached.checkedAt === "number" && cached.checkedAt <= Date.now() && Date.now() - cached.checkedAt < NEGATIVE_INSTALLER_PROBE_TTL_MS && (cached.probes?.bunx === "missing" || cached.probes?.bunx === "failed") && (cached.probes?.npx === "missing" || cached.probes?.npx === "failed")) {
       return cached.probes;
     }
@@ -45606,8 +45662,8 @@ function dueUnknownInstallerProbes(baseUrl, remoteVersion) {
   const probes = probeInstallers(INSTALLER_PROBE_TIMEOUT_MS);
   if (probes.bunx !== "available" && probes.npx !== "available") {
     try {
-      mkdirSync10(dirname13(path), { recursive: true });
-      writeFileSync15(
+      mkdirSync11(dirname14(path), { recursive: true });
+      writeFileSync16(
         path,
         JSON.stringify({
           version: remoteVersion,
@@ -46058,13 +46114,13 @@ function detectSkillsAgents(input2) {
   ];
   const detected = AGENT_MARKERS.filter(
     (marker) => roots.some(
-      (root) => marker.paths.some((path) => existsSync14(join19(root, path)))
+      (root) => marker.paths.some((path) => existsSync14(join20(root, path)))
     )
   ).map((marker) => marker.agent);
   return detected.length > 0 ? detected : ["*"];
 }
 function skillsStatePathForScope(baseUrl, scope, root) {
-  return scope === "local" && root ? join19(root, ".deepline", "setup", "skills.json") : join19(sdkCliStateDirPath(baseUrl), "skills-install.json");
+  return scope === "local" && root ? join20(root, ".deepline", "setup", "skills.json") : join20(sdkCliStateDirPath(baseUrl), "skills-install.json");
 }
 function buildSkillsPlan(input2) {
   const scopeArgs = input2.scope === "global" ? ["--global"] : [];
@@ -46131,7 +46187,7 @@ function isSkillsPlanCurrent(plan, state) {
 }
 function readSkillsInstallState(path) {
   try {
-    const parsed = JSON.parse(readFileSync16(path, "utf8"));
+    const parsed = JSON.parse(readFileSync17(path, "utf8"));
     return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
   } catch {
     return null;
@@ -46335,8 +46391,8 @@ async function runSkillsInstallWithLease(input2) {
 `
     );
   }
-  mkdirSync11(dirname14(plan.statePath), { recursive: true });
-  writeFileSync16(
+  mkdirSync12(dirname15(plan.statePath), { recursive: true });
+  writeFileSync17(
     plan.statePath,
     `${JSON.stringify(
       {
@@ -46525,7 +46581,7 @@ function phasesFromLegacyStatus(status) {
 function readSetupState(input2) {
   try {
     const parsed = JSON.parse(
-      readFileSync17(
+      readFileSync18(
         setupStatePath(input2.baseUrl, input2.scope, input2.root),
         "utf8"
       )
@@ -46614,7 +46670,7 @@ function buildPendingAuthorizationOutput(input2) {
   };
 }
 function setupStatePath(baseUrl, scope, root) {
-  return scope === "local" && root ? join20(root, ".deepline", "setup", "state.json") : join20(sdkCliStateDirPath(baseUrl), "setup.json");
+  return scope === "local" && root ? join21(root, ".deepline", "setup", "state.json") : join21(sdkCliStateDirPath(baseUrl), "setup.json");
 }
 async function captureStdout(run) {
   let stdout = "";
@@ -46643,7 +46699,7 @@ function asRecord4(value) {
 }
 function safeRead(path) {
   try {
-    return readFileSync17(path, "utf8");
+    return readFileSync18(path, "utf8");
   } catch {
     return "";
   }
@@ -46695,7 +46751,7 @@ function resolvePersistentGlobalCommand(dependencies = {}) {
   if (prefix.status !== 0) return null;
   const root = String(prefix.stdout ?? "").trim();
   if (!root) return null;
-  const candidates = platform3 === "win32" ? [join20(root, "deepline.cmd"), join20(root, "deepline")] : [join20(root, "bin", "deepline")];
+  const candidates = platform3 === "win32" ? [join21(root, "deepline.cmd"), join21(root, "deepline")] : [join21(root, "bin", "deepline")];
   return candidates.find((candidate) => pathExists(candidate)) ?? null;
 }
 function inspectGlobalCliAvailability(input2) {
@@ -46721,7 +46777,7 @@ function isKnownDeeplineCommand(path) {
   } catch {
   }
   if (entrypoint && resolvedPath === entrypoint) return true;
-  if (resolvedPath.includes(`${join20("node_modules", "deepline")}`)) return true;
+  if (resolvedPath.includes(`${join21("node_modules", "deepline")}`)) return true;
   const content = safeRead(path);
   return content.includes("node_modules/deepline") || content.includes("node_modules\\deepline") || content.includes("DEEPLINE_CONFIG_SCOPE") || content.includes("deepline-real");
 }
@@ -46731,7 +46787,7 @@ function inspectPathConflict() {
   try {
     if (lstatSync2(commandPath).isSymbolicLink()) {
       const target = realpathSync5(commandPath);
-      if (target.includes(`${join20("node_modules", "deepline")}`)) return null;
+      if (target.includes(`${join21("node_modules", "deepline")}`)) return null;
     }
   } catch {
   }
@@ -46739,8 +46795,8 @@ function inspectPathConflict() {
 }
 function writeSetupState(input2) {
   const path = setupStatePath(input2.baseUrl, input2.scope, input2.root);
-  mkdirSync12(dirname15(path), { recursive: true });
-  writeFileSync17(
+  mkdirSync13(dirname16(path), { recursive: true });
+  writeFileSync18(
     path,
     `${JSON.stringify(
       {
@@ -46780,7 +46836,7 @@ function failSetupPhase(phases, phase, code) {
   phases[phase] = { status: "failed", code };
 }
 function rollbackCommand(scope, root) {
-  const prefix = scope === "local" && root ? ` --prefix ${JSON.stringify(join20(root, ".deepline", "runtime"))}` : "";
+  const prefix = scope === "local" && root ? ` --prefix ${JSON.stringify(join21(root, ".deepline", "runtime"))}` : "";
   const allowScriptsFlag = npmSupportsAllowScripts(readNpmVersion(process.env)) ? " --allow-scripts=esbuild" : "";
   return `npm install -g${prefix} --no-audit --no-fund --include=optional${allowScriptsFlag} deepline@${SDK_VERSION}`;
 }
@@ -46875,7 +46931,7 @@ function buildDoctorAssessment(input2) {
   const pathGlobalCli = globalCli?.path ?? null;
   const cliPath = input2.scope === "global" ? pathGlobalCli : runningCliPath;
   const cliScopeOk = input2.scope === "global" ? Boolean(pathGlobalCli) : Boolean(
-    input2.root && runningCliPath?.includes(join20(input2.root, ".deepline", "runtime"))
+    input2.root && runningCliPath?.includes(join21(input2.root, ".deepline", "runtime"))
   );
   const checks = {
     cli: {
@@ -47491,19 +47547,19 @@ Examples:
 }
 
 // src/cli/commands/settings.ts
-import { readFileSync as readFileSync21 } from "fs";
+import { readFileSync as readFileSync22 } from "fs";
 
 // src/cli/update-preferences.ts
 import {
   existsSync as existsSync16,
-  mkdirSync as mkdirSync13,
-  readFileSync as readFileSync18,
+  mkdirSync as mkdirSync14,
+  readFileSync as readFileSync19,
   renameSync as renameSync2,
   rmSync as rmSync6,
-  writeFileSync as writeFileSync18
+  writeFileSync as writeFileSync19
 } from "fs";
 import { homedir as homedir10 } from "os";
-import { dirname as dirname16, join as join21 } from "path";
+import { dirname as dirname17, join as join22 } from "path";
 var UPDATE_PREFERENCES_SCHEMA_VERSION = 1;
 var CLI_UPDATE_MESSAGES = [
   {
@@ -47532,7 +47588,7 @@ function unreadablePreferences(path, error) {
   };
 }
 function cliUpdatePreferencesPath(homeDir2 = homedir10()) {
-  return join21(
+  return join22(
     homeDir2,
     ".local",
     "deepline",
@@ -47544,7 +47600,7 @@ function readCliUpdatePreferences(homeDir2 = homedir10()) {
   const path = cliUpdatePreferencesPath(homeDir2);
   if (!existsSync16(path)) return defaultPreferences();
   try {
-    const parsed = JSON.parse(readFileSync18(path, "utf8"));
+    const parsed = JSON.parse(readFileSync19(path, "utf8"));
     return {
       schemaVersion: UPDATE_PREFERENCES_SCHEMA_VERSION,
       autoUpdateEnabled: typeof parsed.autoUpdateEnabled === "boolean" ? parsed.autoUpdateEnabled : true,
@@ -47560,9 +47616,9 @@ function readCliUpdatePreferences(homeDir2 = homedir10()) {
 function writeCliUpdatePreferences(preferences, homeDir2 = homedir10()) {
   const path = cliUpdatePreferencesPath(homeDir2);
   const tempPath = `${path}.${process.pid}.tmp`;
-  mkdirSync13(dirname16(path), { recursive: true });
+  mkdirSync14(dirname17(path), { recursive: true });
   try {
-    writeFileSync18(tempPath, `${JSON.stringify(preferences, null, 2)}
+    writeFileSync19(tempPath, `${JSON.stringify(preferences, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
@@ -47621,28 +47677,28 @@ function consumePendingCliUpdateMessages(homeDir2 = homedir10()) {
 import { spawn as spawn4, spawnSync as spawnSync4 } from "child_process";
 import {
   existsSync as existsSync18,
-  mkdirSync as mkdirSync14,
+  mkdirSync as mkdirSync15,
   realpathSync as realpathSync6,
-  readFileSync as readFileSync20,
+  readFileSync as readFileSync21,
   renameSync as renameSync3,
   rmSync as rmSync7,
   unlinkSync as unlinkSync3,
-  writeFileSync as writeFileSync19
+  writeFileSync as writeFileSync20
 } from "fs";
 import { homedir as homedir11 } from "os";
 import {
   basename as basename6,
-  dirname as dirname17,
+  dirname as dirname18,
   isAbsolute as isAbsolute7,
-  join as join23,
+  join as join24,
   relative as relative8,
   resolve as resolve19
 } from "path";
 
 // src/cli/install-integrity.ts
 import { createRequire } from "module";
-import { existsSync as existsSync17, readFileSync as readFileSync19, statSync as statSync5 } from "fs";
-import { isAbsolute as isAbsolute6, join as join22, relative as relative7, resolve as resolve18 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync20, statSync as statSync5 } from "fs";
+import { isAbsolute as isAbsolute6, join as join23, relative as relative7, resolve as resolve18 } from "path";
 var SDK_SIDECAR_CRITICAL_PACKAGE_FILES = [
   "dist/cli/index.mjs",
   "dist/index.mjs",
@@ -47677,7 +47733,7 @@ function resolveContainedPath(root, value) {
   return target;
 }
 function parseJson(path) {
-  return JSON.parse(readFileSync19(path, "utf8"));
+  return JSON.parse(readFileSync20(path, "utf8"));
 }
 function isFile(path) {
   try {
@@ -47687,7 +47743,7 @@ function isFile(path) {
   }
 }
 function readManifest(packageRoot) {
-  const packageJsonPath = join22(packageRoot, "package.json");
+  const packageJsonPath = join23(packageRoot, "package.json");
   let packageJson;
   try {
     packageJson = parseJson(packageJsonPath);
@@ -47761,8 +47817,8 @@ function readManifest(packageRoot) {
   return { mode: "manifest", manifest };
 }
 function inspectSdkSidecarInstall(versionDir) {
-  const nodeModulesRoot = join22(versionDir, "node_modules");
-  const packageRoot = join22(nodeModulesRoot, "deepline");
+  const nodeModulesRoot = join23(versionDir, "node_modules");
+  const packageRoot = join23(nodeModulesRoot, "deepline");
   const manifestResult = readManifest(packageRoot);
   if ("invalidReason" in manifestResult) {
     return {
@@ -47773,8 +47829,8 @@ function inspectSdkSidecarInstall(versionDir) {
     };
   }
   const missing = [
-    ...manifestResult.manifest.packageFiles.filter((path) => !isFile(join22(packageRoot, path))).map((path) => `deepline/${path}`),
-    ...manifestResult.manifest.dependencyFiles.filter((path) => !isFile(join22(nodeModulesRoot, path))).map((path) => `node_modules/${path}`)
+    ...manifestResult.manifest.packageFiles.filter((path) => !isFile(join23(packageRoot, path))).map((path) => `deepline/${path}`),
+    ...manifestResult.manifest.dependencyFiles.filter((path) => !isFile(join23(nodeModulesRoot, path))).map((path) => `node_modules/${path}`)
   ];
   return {
     ok: missing.length === 0,
@@ -47785,7 +47841,7 @@ function inspectSdkSidecarInstall(versionDir) {
 }
 function probeSdkSidecarEsbuild(versionDir) {
   try {
-    const requireFromInstall = createRequire(join22(versionDir, "package.json"));
+    const requireFromInstall = createRequire(join23(versionDir, "package.json"));
     const esbuild = requireFromInstall("esbuild");
     if (typeof esbuild.transformSync !== "function") {
       return "esbuild does not export transformSync";
@@ -47854,7 +47910,7 @@ function sidecarStateDir(input2) {
   if (!scope || scope.includes("/") || scope.includes("\\")) {
     return null;
   }
-  return join23(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
+  return join24(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
 }
 function sidecarRegistryUrl(hostUrl) {
   let url;
@@ -47881,7 +47937,7 @@ function publicNpmFallbackRegistryUrl(hostUrl) {
 }
 function readOptionalText(path) {
   try {
-    return readFileSync20(path, "utf8").trim();
+    return readFileSync21(path, "utf8").trim();
   } catch {
     return "";
   }
@@ -47896,12 +47952,12 @@ function resolvePythonSidecarUpdatePlan(options) {
   if (!relativeEntrypoint || relativeEntrypoint.startsWith("..") || isAbsolute7(relativeEntrypoint)) {
     return null;
   }
-  const installMethod = readOptionalText(join23(stateDir, ".install-method"));
+  const installMethod = readOptionalText(join24(stateDir, ".install-method"));
   if (installMethod !== "python-sidecar") return null;
   const scope = options.env.DEEPLINE_CONFIG_SCOPE?.trim() || "";
   const hostUrl = options.env.DEEPLINE_HOST_URL?.trim() || "";
-  const nodeBin = readOptionalText(join23(stateDir, ".node-bin")) || process.execPath;
-  const sidecarPath = readOptionalText(join23(stateDir, ".command-path")) || join23(
+  const nodeBin = readOptionalText(join24(stateDir, ".node-bin")) || process.execPath;
+  const sidecarPath = readOptionalText(join24(stateDir, ".command-path")) || join24(
     stateDir,
     "bin",
     process.platform === "win32" ? "deepline-sdk.cmd" : "deepline-sdk"
@@ -47909,7 +47965,7 @@ function resolvePythonSidecarUpdatePlan(options) {
   const packageSpec = options.packageSpec || "deepline@latest";
   const npmCommand = "npm";
   const registryUrl = sidecarRegistryUrl(hostUrl);
-  const versionDir = join23(stateDir, "versions", "<version>");
+  const versionDir = join24(stateDir, "versions", "<version>");
   const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote6(versionDir)} --registry ${shellQuote6(registryUrl)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote6).join(" ")} ${shellQuote6(packageSpec)}`;
   return {
     kind: "python-sidecar",
@@ -47927,14 +47983,14 @@ function resolvePythonSidecarUpdatePlan(options) {
 function findRepoBackedSdkRoot(startPath) {
   let current = resolve19(startPath);
   while (true) {
-    if (existsSync18(join23(current, "package.json")) && existsSync18(join23(current, "bin", "deepline-dev.ts"))) {
-      const parent2 = dirname17(current);
-      return basename6(parent2) === "packages" && basename6(current) === "sdk" ? dirname17(parent2) : parent2;
+    if (existsSync18(join24(current, "package.json")) && existsSync18(join24(current, "bin", "deepline-dev.ts"))) {
+      const parent2 = dirname18(current);
+      return basename6(parent2) === "packages" && basename6(current) === "sdk" ? dirname18(parent2) : parent2;
     }
-    if (existsSync18(join23(current, "sdk", "package.json")) && existsSync18(join23(current, "sdk", "bin", "deepline-dev.ts"))) {
+    if (existsSync18(join24(current, "sdk", "package.json")) && existsSync18(join24(current, "sdk", "bin", "deepline-dev.ts"))) {
       return current;
     }
-    const parent = dirname17(current);
+    const parent = dirname18(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -47959,7 +48015,7 @@ function inferNpmGlobalPrefixFromEntrypoint(entrypoint, env) {
     const directPrefix = prefixParts.join("/").toLowerCase();
     const knownWindowsPrefixes = [
       env.npm_config_prefix,
-      env.APPDATA ? join23(env.APPDATA, "npm") : void 0
+      env.APPDATA ? join24(env.APPDATA, "npm") : void 0
     ].filter((value) => Boolean(value)).map((value) => resolve19(value).replace(/\\/g, "/").toLowerCase());
     if (!knownWindowsPrefixes.includes(
       resolve19(directPrefix).replace(/\\/g, "/").toLowerCase()
@@ -48013,7 +48069,7 @@ function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
   const homeDir2 = options.homeDir ?? homedir11();
   const entrypoint = options.entrypoint ?? (process.argv[1] ? resolve19(process.argv[1]) : "");
-  const sourceRoot = entrypoint ? findRepoBackedSdkRoot(dirname17(entrypoint)) : null;
+  const sourceRoot = entrypoint ? findRepoBackedSdkRoot(dirname18(entrypoint)) : null;
   if (sourceRoot) {
     return {
       kind: "source",
@@ -48066,9 +48122,9 @@ var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
 function autoUpdateFailurePath(plan) {
   if (plan.kind === "source" || plan.kind === "homebrew") return null;
   if (plan.kind === "python-sidecar") {
-    return join23(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
+    return join24(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
   }
-  return join23(
+  return join24(
     homedir11(),
     ".local",
     "deepline",
@@ -48086,7 +48142,7 @@ function readAutoUpdateFailure(plan) {
   if (!path) return null;
   try {
     const parsed = JSON.parse(
-      readFileSync20(path, "utf8")
+      readFileSync21(path, "utf8")
     );
     if ((parsed.kind === "npm-global" || parsed.kind === "python-sidecar") && typeof parsed.packageSpec === "string" && typeof parsed.failedAt === "string" && typeof parsed.exitCode === "number" && typeof parsed.manualCommand === "string") {
       return parsed;
@@ -48107,8 +48163,8 @@ function writeAutoUpdateFailure(plan, exitCode) {
     manualCommand: plan.manualCommand
   };
   try {
-    mkdirSync14(dirname17(path), { recursive: true });
-    writeFileSync19(path, `${JSON.stringify(marker, null, 2)}
+    mkdirSync15(dirname18(path), { recursive: true });
+    writeFileSync20(path, `${JSON.stringify(marker, null, 2)}
 `, "utf8");
   } catch {
   }
@@ -48155,7 +48211,7 @@ function safeVersionSegment(value) {
   return /^[0-9A-Za-z._-]+$/.test(normalized) ? normalized : "";
 }
 function entryPathInVersionDir(versionDir) {
-  return join23(
+  return join24(
     versionDir,
     "node_modules",
     "deepline",
@@ -48165,14 +48221,14 @@ function entryPathInVersionDir(versionDir) {
   );
 }
 function installedPackageVersion(versionDir) {
-  const packageJsonPath = join23(
+  const packageJsonPath = join24(
     versionDir,
     "node_modules",
     "deepline",
     "package.json"
   );
   try {
-    const parsed = JSON.parse(readFileSync20(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync21(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" ? safeVersionSegment(parsed.version) : "";
   } catch {
     return "";
@@ -48287,20 +48343,20 @@ async function runNpmInstallWithRegistryFallback(input2) {
   return first.exitCode;
 }
 function writeSidecarLauncher(input2) {
-  mkdirSync14(dirname17(input2.path), { recursive: true });
-  const packageRoot = dirname17(dirname17(dirname17(input2.entryPath)));
-  const versionDir = dirname17(dirname17(packageRoot));
+  mkdirSync15(dirname18(input2.path), { recursive: true });
+  const packageRoot = dirname18(dirname18(dirname18(input2.entryPath)));
+  const versionDir = dirname18(dirname18(packageRoot));
   const esbuildProbe = "const {createRequire}=require('node:module');const path=require('node:path');const req=createRequire(path.join(process.argv[1],'package.json'));const result=req('esbuild').transformSync('const value: number = 1;',{loader:'ts'});if(!result||typeof result.code!=='string')process.exit(3);";
   const criticalPaths = [
     ...SDK_SIDECAR_CRITICAL_PACKAGE_FILES.map(
-      (path) => join23(packageRoot, path)
+      (path) => join24(packageRoot, path)
     ),
     ...SDK_SIDECAR_CRITICAL_DEPENDENCY_FILES.map(
-      (path) => join23(versionDir, "node_modules", path)
+      (path) => join24(versionDir, "node_modules", path)
     )
   ];
   if (process.platform === "win32") {
-    writeFileSync19(
+    writeFileSync20(
       input2.path,
       [
         `@set DEEPLINE_HOST_URL=${input2.hostUrl.replace(/\r?\n/g, "")}`,
@@ -48323,7 +48379,7 @@ function writeSidecarLauncher(input2) {
     );
     return;
   }
-  writeFileSync19(
+  writeFileSync20(
     input2.path,
     [
       "#!/usr/bin/env sh",
@@ -48350,17 +48406,17 @@ function writeSidecarLauncher(input2) {
   );
 }
 async function runPythonSidecarUpdatePlan(plan) {
-  const versionsDir = join23(plan.stateDir, "versions");
-  const tempDir = join23(
+  const versionsDir = join24(plan.stateDir, "versions");
+  const tempDir = join24(
     versionsDir,
     `.tmp-sdk-update-${process.pid}-${Date.now()}`
   );
   rmSync7(tempDir, { recursive: true, force: true });
-  mkdirSync14(tempDir, { recursive: true });
-  writeFileSync19(join23(tempDir, "package.json"), NPM_SDK_SIDECAR_PACKAGE_JSON);
+  mkdirSync15(tempDir, { recursive: true });
+  writeFileSync20(join24(tempDir, "package.json"), NPM_SDK_SIDECAR_PACKAGE_JSON);
   const env = {
     ...process.env,
-    PATH: `${dirname17(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
+    PATH: `${dirname18(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
   };
   const installResult = await runCommand(
     plan.npmCommand,
@@ -48397,7 +48453,7 @@ async function runPythonSidecarUpdatePlan(plan) {
     rmSync7(tempDir, { recursive: true, force: true });
     return 1;
   }
-  const finalDir = join23(versionsDir, installedVersion);
+  const finalDir = join24(versionsDir, installedVersion);
   const finalEntryPath = entryPathInVersionDir(finalDir);
   const finalFailure = sidecarInstallFailure(finalDir);
   let backupDir = null;
@@ -48406,7 +48462,7 @@ async function runPythonSidecarUpdatePlan(plan) {
   } else {
     let shouldPublishTemp = true;
     if (existsSync18(finalDir)) {
-      backupDir = join23(
+      backupDir = join24(
         versionsDir,
         `.backup-${installedVersion}-${process.pid}-${Date.now()}`
       );
@@ -48480,28 +48536,28 @@ async function runPythonSidecarUpdatePlan(plan) {
     nodeBin: plan.nodeBin,
     entryPath: finalEntryPath
   });
-  writeFileSync19(
-    join23(plan.stateDir, ".version"),
+  writeFileSync20(
+    join24(plan.stateDir, ".version"),
     `${installedVersion}
 `,
     "utf8"
   );
-  writeFileSync19(
-    join23(plan.stateDir, ".install-method"),
+  writeFileSync20(
+    join24(plan.stateDir, ".install-method"),
     "python-sidecar\n",
     "utf8"
   );
-  writeFileSync19(
-    join23(plan.stateDir, ".command-path"),
+  writeFileSync20(
+    join24(plan.stateDir, ".command-path"),
     `${plan.sidecarPath}
 `,
     "utf8"
   );
-  writeFileSync19(join23(plan.stateDir, ".runner"), "node\n", "utf8");
-  writeFileSync19(join23(plan.stateDir, ".node-bin"), `${plan.nodeBin}
+  writeFileSync20(join24(plan.stateDir, ".runner"), "node\n", "utf8");
+  writeFileSync20(join24(plan.stateDir, ".node-bin"), `${plan.nodeBin}
 `, "utf8");
-  writeFileSync19(
-    join23(plan.stateDir, ".entry-path"),
+  writeFileSync20(
+    join24(plan.stateDir, ".entry-path"),
     `${finalEntryPath}
 `,
     "utf8"
@@ -49212,7 +49268,7 @@ function collectEvent(value, previous = []) {
 function collectNotificationTarget(value, previous = []) {
   return [...previous, value];
 }
-async function readNotificationConfigurationChange(source, read2 = (path, encoding) => readFileSync21(path, encoding)) {
+async function readNotificationConfigurationChange(source, read2 = (path, encoding) => readFileSync22(path, encoding)) {
   const label = source === "-" ? "stdin" : source;
   let text;
   try {
@@ -49554,13 +49610,12 @@ import { Option as Option5 } from "commander";
 import {
   chmodSync,
   existsSync as existsSync20,
-  mkdirSync as mkdirSync17,
   mkdtempSync,
-  readFileSync as readFileSync23,
-  writeFileSync as writeFileSync22
+  readFileSync as readFileSync24,
+  writeFileSync as writeFileSync23
 } from "fs";
 import { tmpdir as tmpdir5 } from "os";
-import { dirname as dirname20, join as join26, resolve as resolve20 } from "path";
+import { join as join27, resolve as resolve20 } from "path";
 
 // src/cli/tool-call-recovery.ts
 import { createHash as createHash7, randomUUID as randomUUID9 } from "crypto";
@@ -49585,12 +49640,12 @@ function stableStringify(value) {
 import {
   existsSync as existsSync19,
   linkSync,
-  mkdirSync as mkdirSync15,
-  readFileSync as readFileSync22,
+  mkdirSync as mkdirSync16,
+  readFileSync as readFileSync23,
   unlinkSync as unlinkSync4,
-  writeFileSync as writeFileSync20
+  writeFileSync as writeFileSync21
 } from "fs";
-import { dirname as dirname18, join as join24 } from "path";
+import { dirname as dirname19, join as join25 } from "path";
 var ToolCallRecovery = class _ToolCallRecovery {
   constructor(idempotencyKey, path) {
     this.idempotencyKey = idempotencyKey;
@@ -49610,20 +49665,20 @@ var ToolCallRecovery = class _ToolCallRecovery {
 function pendingToolExecutionPath(input2) {
   const config = resolveConfig();
   const fingerprint = createHash7("sha256").update(config.baseUrl).update("\0").update(createHash7("sha256").update(config.apiKey).digest("hex")).update("\0").update(input2.toolId).update("\0").update(stableStringify(input2.params)).update("\0").update(input2.responseIntent).digest("hex");
-  return join24(
+  return join25(
     sdkCliStateDirPath(config.baseUrl),
     `pending-tool-execution-${fingerprint}.json`
   );
 }
 function loadOrCreatePendingToolExecution(path) {
-  mkdirSync15(dirname18(path), { recursive: true });
+  mkdirSync16(dirname19(path), { recursive: true });
   if (existsSync19(path)) {
     return readPendingToolExecution(path);
   }
   const idempotencyKey = randomUUID9();
   const temporaryPath = `${path}.${process.pid}.${randomUUID9()}.tmp`;
   try {
-    writeFileSync20(temporaryPath, `${JSON.stringify({ idempotencyKey })}
+    writeFileSync21(temporaryPath, `${JSON.stringify({ idempotencyKey })}
 `, {
       encoding: "utf8",
       flag: "wx",
@@ -49639,7 +49694,7 @@ function loadOrCreatePendingToolExecution(path) {
   }
 }
 function readPendingToolExecution(path) {
-  const saved = JSON.parse(readFileSync22(path, "utf8"));
+  const saved = JSON.parse(readFileSync23(path, "utf8"));
   if (typeof saved.idempotencyKey !== "string") {
     throw new Error(
       `Cannot resume the saved tool execution at ${path}: invalid recovery key.`
@@ -49675,13 +49730,13 @@ async function completePendingToolExecution(path, idempotencyKey) {
 // src/tool-output.ts
 import {
   closeSync as closeSync3,
-  mkdirSync as mkdirSync16,
+  mkdirSync as mkdirSync17,
   openSync as openSync3,
-  writeFileSync as writeFileSync21,
+  writeFileSync as writeFileSync22,
   writeSync
 } from "fs";
 import { homedir as homedir12 } from "os";
-import { dirname as dirname19, join as join25 } from "path";
+import { dirname as dirname20, join as join26 } from "path";
 function isPlainObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -49808,19 +49863,19 @@ function projectRowOutput(conversion) {
   };
 }
 function ensureOutputDir() {
-  const outputDir = join25(homedir12(), ".local", "share", "deepline", "data");
-  mkdirSync16(outputDir, { recursive: true });
+  const outputDir = join26(homedir12(), ".local", "share", "deepline", "data");
+  mkdirSync17(outputDir, { recursive: true });
   return outputDir;
 }
 function writeJsonOutputFile(payload, stem) {
   const outputDir = ensureOutputDir();
-  const outputPath = join25(outputDir, `${stem}_${Date.now()}.json`);
-  writeFileSync21(outputPath, JSON.stringify(payload, null, 2), "utf-8");
+  const outputPath = join26(outputDir, `${stem}_${Date.now()}.json`);
+  writeFileSync22(outputPath, JSON.stringify(payload, null, 2), "utf-8");
   return outputPath;
 }
 function writeCsvOutputFile(rows, stem, options) {
-  const outputPath = options?.outPath ? options.outPath : join25(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
-  mkdirSync16(dirname19(outputPath), { recursive: true });
+  const outputPath = options?.outPath ? options.outPath : join26(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
+  mkdirSync17(dirname20(outputPath), { recursive: true });
   const columns = columnsForRows(rows);
   const escapeCell = (value) => {
     const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
@@ -50122,7 +50177,7 @@ function zeroMatchToolGuidance(options) {
     ...query ? [
       {
         label: "Use ranked semantic search for intent-style queries",
-        command: `deepline tools search -- ${shellCommandArg(query)}`
+        command: `deepline search --type tools -- ${shellCommandArg(query)}`
       },
       ...options.mode === "all" ? [
         {
@@ -50138,7 +50193,7 @@ function zeroMatchToolGuidance(options) {
     ...query ? [
       {
         label: "Search composed Deepline plays separately",
-        command: `deepline plays search -- ${shellCommandArg(query)}`
+        command: `deepline search --type prebuilts -- ${shellCommandArg(query)}`
       }
     ] : []
   ];
@@ -50415,62 +50470,6 @@ async function listTools(category, options = {}) {
   }
   return listToolCategories(emitJson, compact);
 }
-var SEARCH_REF_TTL_MS = 15 * 6e4;
-function lastSearchPath() {
-  return join26(sdkCliStateDirPath(resolveConfig().baseUrl), "last-search.json");
-}
-function rememberSearchRef(searchRef) {
-  try {
-    mkdirSync17(dirname20(lastSearchPath()), { recursive: true });
-    writeFileSync22(
-      lastSearchPath(),
-      JSON.stringify({ searchRef, at: Date.now() }),
-      { mode: 384 }
-    );
-  } catch {
-  }
-}
-function recentSearchRef() {
-  try {
-    const saved = JSON.parse(readFileSync23(lastSearchPath(), "utf8"));
-    return typeof saved.searchRef === "string" && typeof saved.at === "number" && Date.now() - saved.at < SEARCH_REF_TTL_MS ? saved.searchRef : void 0;
-  } catch {
-    return void 0;
-  }
-}
-async function searchTools(queryInput, options = {}) {
-  const query = queryInput?.trim() ?? "";
-  const hasStructuredSearch = Boolean(
-    options.categories?.trim() || options.searchTerms?.trim()
-  );
-  if (!query && !hasStructuredSearch) {
-    console.error(
-      "Usage: deepline tools search [query] --categories <categories> [--search_terms <terms>] [--json]"
-    );
-    return 1;
-  }
-  const client2 = new DeeplineClient();
-  const { search_ref: searchRef, ...result } = await client2.searchTools({
-    query,
-    categories: options.categories,
-    searchTerms: options.searchTerms,
-    task: options.task,
-    limit: options.limit,
-    offset: options.offset,
-    searchMode: options.searchMode,
-    includeSearchDebug: options.includeSearchDebug
-  });
-  if (searchRef) rememberSearchRef(searchRef);
-  const shouldCompact = options.compact || !options.json;
-  const payload = shouldCompact && Array.isArray(result.tools) ? {
-    ...result,
-    tools: result.tools.slice(0, 8).map(compactTool)
-  } : result;
-  printCommandEnvelope(payload, {
-    json: options.json === true
-  });
-  return 0;
-}
 async function grepTools(queryInput, options = {}) {
   const query = queryInput.trim();
   if (!query) {
@@ -50606,7 +50605,7 @@ function playReferenceForTool(tool) {
   return null;
 }
 function playSearchCommandForToolId(toolId) {
-  return `deepline plays search ${JSON.stringify(toolId.replace(/_/g, " "))} --json`;
+  return `deepline search --type prebuilts ${JSON.stringify(toolId.replace(/_/g, " "))} --json`;
 }
 function playRunCommandForTool(tool, toolId, input2) {
   const playReference = playReferenceForTool(tool);
@@ -50620,7 +50619,7 @@ function playLikeToolExecuteErrorMessage(toolId, tool) {
   return [
     `${toolId} is a workflow/play entry, not an atomic provider tool.`,
     nextStep,
-    'Or search provider tools only with: deepline tools search "<query>" --json'
+    'Or search provider tools only with: deepline search --type tools "<query>" --json'
   ].join("\n");
 }
 function printPlayLikeToolExecuteError(toolId, tool) {
@@ -50637,7 +50636,7 @@ Concepts:
   through the plays namespace.
 
 Common commands:
-  deepline tools search email --json
+  deepline search --type tools email --json
   deepline tools describe hunter_email_verifier --json
   deepline tools describe hunter_email_verifier --pricing-only --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
@@ -50670,7 +50669,7 @@ Examples:
   deepline tools list email_finder
   deepline tools list email_finder --json
   deepline tools list --categories email_finder --json
-  deepline tools search email --json
+  deepline search --type tools email --json
 `
   ).option(
     "--categories <categories>",
@@ -50682,58 +50681,7 @@ Examples:
       json: Boolean(options.json)
     });
   });
-  const addToolSearchCommand = (command) => command.description(
-    "Search available tools by intent query or structured filters."
-  ).addHelpText(
-    "after",
-    `
-Notes:
-  Ranked discovery for atomic provider/API operations. Results include tool ids
-  that can be passed to deepline tools describe or deepline tools execute.
-  Provide a query, or omit it only when --categories and/or --search_terms is
-  supplied. Providing neither is a usage error. Both filters accept
-  comma-separated values. Use --limit and --offset to page through ranked
-  results (limit 1-50, offset is zero-based); JSON includes next_offset.
-  Pass --task with one sentence on what you are trying to accomplish right
-  now: the input you have and the result you need, not a restatement of the
-  query. It materially improves ranking, especially for short queries.
-  Use a provider name in the query; --prefix is not a supported option.
-  The grep alias is the same ranked retrieval surface with a more literal name
-  for agents that are filtering a registry rather than choosing a workflow.
-  Search prints a readable result list by default, piped or not, and that is
-  the recommended form. Pass --json only when a program parses the result.
-
-Examples:
-  deepline tools search email --limit 10
-  deepline tools search email --limit 10 --offset 10
-  deepline tools search linkedin --task "I have 200 LinkedIn profile URLs and need each person's current title and company"
-  deepline tools search --categories company_search --search_terms "investors,funding"
-  deepline tools grep "company enrichment" --categories enrichment --json
-  deepline tools search verifier --search-mode v2 --json
-`
-  ).option(
-    "--categories <categories>",
-    "Comma-separated categories; may be used without a query"
-  ).option(
-    "--search_terms <terms>",
-    "Comma-separated structured search terms; may be used without a query"
-  ).option("--search-terms <terms>", "Alias for --search_terms").option(
-    "--task <sentence>",
-    "What you are trying to accomplish: input you have -> result you need"
-  ).option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output instead of the readable default").action(async (query, options) => {
-    process.exitCode = await searchTools(query, {
-      json: options.json,
-      compact: options.compact,
-      limit: options.limit !== void 0 ? Number.parseInt(options.limit, 10) : void 0,
-      offset: options.offset !== void 0 ? Number.parseInt(options.offset, 10) : void 0,
-      categories: options.categories,
-      searchTerms: options.searchTerms ?? options.search_terms,
-      task: options.task,
-      searchMode: options.searchMode === "v1" || options.searchMode === "v2" ? options.searchMode : void 0,
-      includeSearchDebug: Boolean(options.includeSearchDebug)
-    });
-  });
-  addToolSearchCommand(tools.command("search [query]"));
+  registerDeprecatedSearchCommand(tools, () => ["tools", "monitors"]);
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -52139,7 +52087,7 @@ function readJsonArgument(raw, flagName) {
     throw new Error(`Invalid ${flagName} value: empty @file path.`);
   }
   try {
-    return readFileSync23(resolveAtFilePath(filePath), "utf8").replace(
+    return readFileSync24(resolveAtFilePath(filePath), "utf8").replace(
       /^\uFEFF/,
       ""
     );
@@ -52298,9 +52246,9 @@ function starterScriptJson(script) {
 function seedToolListScript(input2) {
   const stem = safeFileStem(input2.toolId);
   const fileName = `${stem}-workflow-seed-${Date.now()}.play.ts`;
-  const scriptDir = mkdtempSync(join26(tmpdir5(), "deepline-workflow-seed-"));
+  const scriptDir = mkdtempSync(join27(tmpdir5(), "deepline-workflow-seed-"));
   chmodSync(scriptDir, 448);
-  const scriptPath = join26(scriptDir, fileName);
+  const scriptPath = join27(scriptDir, fileName);
   const projectDir = `deepline/projects/${stem}-workflow`;
   const playName = `${stem}-workflow`;
   const sampleRows = input2.rows.length > 0 ? `${JSON.stringify(input2.rows.slice(0, 2)).replace(/\]$/, "")}, ...]` : "[]";
@@ -52343,7 +52291,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   description: ${JSON.stringify(`Seed ${input2.toolId} rows into a Deepline workflow-ready dataset.`)},
 });
 `;
-  writeFileSync22(scriptPath, script, { encoding: "utf-8", mode: 384 });
+  writeFileSync23(scriptPath, script, { encoding: "utf-8", mode: 384 });
   return {
     path: scriptPath,
     sourceCode: script,
@@ -52813,7 +52761,7 @@ Examples:
 
 // src/cli/commands/workflow.ts
 import { mkdir as mkdir5, readFile as readFile7, writeFile as writeFile5 } from "fs/promises";
-import { dirname as dirname21, join as join27, resolve as resolve21 } from "path";
+import { dirname as dirname22, join as join28, resolve as resolve21 } from "path";
 
 // src/cli/workflow-to-play.ts
 import { createHash as createHash8 } from "crypto";
@@ -54457,8 +54405,8 @@ async function transformOne(api, workflowId, outDir, publish) {
       revision.config,
       { workflowName: workflow.name, version: revision.version }
     );
-    const file = join27(resolve21(outDir), `${compiled.playName}.play.ts`);
-    await mkdir5(dirname21(file), { recursive: true });
+    const file = join28(resolve21(outDir), `${compiled.playName}.play.ts`);
+    await mkdir5(dirname22(file), { recursive: true });
     await writeFile5(file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
@@ -54719,6 +54667,7 @@ Notes:
 function registerDeeplineCommandGroups(program) {
   registerAuthCommands(program);
   registerProviderCommands(program);
+  registerSearchCommand(program);
   registerToolsCommands(program);
   registerExecutionsCommands(program);
   registerPlayCommands(program);
@@ -54969,10 +54918,11 @@ function shouldDeferSkillsSyncForCommand() {
   const args = process.argv.slice(2);
   const command = args[0];
   const subcommand = args[1];
-  if (command === "tools" && ["list", "search", "grep", "describe", "get"].includes(subcommand ?? "")) {
+  if (command === "tools" && ["list", "grep", "describe", "get"].includes(subcommand ?? "")) {
     return true;
   }
   if (command === "providers" && subcommand === "list") return true;
+  if (command === "search") return true;
   return (command === "play" || command === "plays") && subcommand === "run" && args.includes("--json");
 }
 function isDeprecatedCommandInvocation() {
@@ -55003,8 +54953,8 @@ function topLevelCommandKnown(program, commandName) {
   );
 }
 async function runPlayRunnerHealthCheck() {
-  const dir = await mkdtemp3(join28(tmpdir6(), "deepline-health-play-"));
-  const file = join28(dir, "health-check.play.ts");
+  const dir = await mkdtemp3(join29(tmpdir6(), "deepline-health-play-"));
+  const file = join29(dir, "health-check.play.ts");
   try {
     await writeFile6(
       file,
@@ -55225,7 +55175,7 @@ Common commands:
   deepline health
   deepline auth status --json
   deepline sessions send --current-session --json
-  deepline plays search email --json
+  deepline search --type prebuilts email --json
   deepline plays describe prebuilt/person-linkedin-to-email --json
   deepline plays run my.play.ts --input '{"domain":"stripe.com"}'
   deepline secrets check HUBSPOT_TOKEN