deepline 0.3.342 → 0.3.344

package/dist/cli/{chunk-VZHA6YHU.mjs → chunk-CIV43IXR.mjs}

@@ -1,17 +1,17 @@
 import {
   npmSupportsAllowScripts,
   readNpmVersion
-} from "./chunk-IDTUEEF4.mjs";
+} from "./chunk-M5FYGL42.mjs";
 import {
   resolveShellSpawn,
   runSkillsCommand
-} from "./chunk-4LPBIUQ2.mjs";
+} from "./chunk-2MSG6WCC.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-OJH4W52K.mjs";
+} from "./chunk-DRHVFFMJ.mjs";
 import {
   autoDetectBaseUrl
-} from "./chunk-G6TM2GK2.mjs";
+} from "./chunk-J5NN6XCF.mjs";
 
 // src/cli/commands/update.ts
 import { spawn, spawnSync } from "child_process";

package/dist/cli/{chunk-GEGCG7MG.mjs → chunk-CMK6UNJA.mjs}

@@ -10,7 +10,7 @@ import {
 import {
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-GAQGAH34.mjs";
+} from "./chunk-QZMF7VDU.mjs";
 import {
   extractSummaryFields,
   projectRowOutput,
@@ -22,7 +22,7 @@ import {
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-SBXCXMYT.mjs";
+} from "./chunk-23D4YCM6.mjs";
 import {
   beginToolExecuteCommand,
   getToolExecuteInvocationId,
@@ -36,11 +36,11 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-OJH4W52K.mjs";
+} from "./chunk-DRHVFFMJ.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-G6TM2GK2.mjs";
+} from "./chunk-J5NN6XCF.mjs";
 import {
   playToolListGetterMode
 } from "./chunk-NTVTZAVZ.mjs";
@@ -857,7 +857,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 search --type tools "<query>" --json'
+    'Or search provider tools only with: deepline search "<input you have -> result you need>" --type tools --json'
   ].join("\n");
 }
 function printPlayLikeToolExecuteError(toolId, tool) {
@@ -883,7 +883,7 @@ Concepts:
   through the plays namespace.
 
 Common commands:
-  deepline search --type tools email --json
+  deepline search "name and company domain -> work email" --type tools --json
   deepline describe hunter_email_verifier
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline billing usage --request-id <job_id> --json
@@ -915,7 +915,7 @@ Examples:
   deepline tools list email_finder
   deepline tools list email_finder --json
   deepline tools list --categories email_finder --json
-  deepline search --type tools email --json
+  deepline search "name and company domain -> work email" --type tools --json
 `
   ).option(
     "--categories <categories>",
@@ -1029,7 +1029,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-X5WLZXOS.mjs");
+      const { describeAnything } = await import("./describe-4SC5G2FG.mjs");
       process.exitCode = await describeAnything(
         toolId,
         { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },

package/dist/cli/{chunk-OJH4W52K.mjs → chunk-DRHVFFMJ.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-G6TM2GK2.mjs";
+} from "./chunk-J5NN6XCF.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -131,6 +131,95 @@ import { homedir, tmpdir, userInfo } from "os";
 import { dirname, join, resolve } from "path";
 import * as childProcess from "child_process";
 import { parse } from "csv-parse/sync";
+
+// ../plays/csv-text-repair.ts
+var CP1252_HIGH_TO_BYTE = /* @__PURE__ */ new Map([
+  [8364, 128],
+  [8218, 130],
+  [402, 131],
+  [8222, 132],
+  [8230, 133],
+  [8224, 134],
+  [8225, 135],
+  [710, 136],
+  [8240, 137],
+  [352, 138],
+  [8249, 139],
+  [338, 140],
+  [381, 142],
+  [8216, 145],
+  [8217, 146],
+  [8220, 147],
+  [8221, 148],
+  [8226, 149],
+  [8211, 150],
+  [8212, 151],
+  [732, 152],
+  [8482, 153],
+  [353, 154],
+  [8250, 155],
+  [339, 156],
+  [382, 158],
+  [376, 159]
+]);
+var MAC_ROMAN_HIGH = "\xC4\xC5\xC7\xC9\xD1\xD6\xDC\xE1\xE0\xE2\xE4\xE3\xE5\xE7\xE9\xE8\xEA\xEB\xED\xEC\xEE\xEF\xF1\xF3\xF2\xF4\xF6\xF5\xFA\xF9\xFB\xFC\u2020\xB0\xA2\xA3\xA7\u2022\xB6\xDF\xAE\xA9\u2122\xB4\xA8\u2260\xC6\xD8\u221E\xB1\u2264\u2265\xA5\xB5\u2202\u2211\u220F\u03C0\u222B\xAA\xBA\u03A9\xE6\xF8\xBF\xA1\xAC\u221A\u0192\u2248\u2206\xAB\xBB\u2026\xA0\xC0\xC3\xD5\u0152\u0153\u2013\u2014\u201C\u201D\u2018\u2019\xF7\u25CA\xFF\u0178\u2044\u20AC\u2039\u203A\uFB01\uFB02\u2021\xB7\u201A\u201E\u2030\xC2\xCA\xC1\xCB\xC8\xCD\xCE\xCF\xCC\xD3\xD4\uF8FF\xD2\xDA\xDB\xD9\u0131\u02C6\u02DC\xAF\u02D8\u02D9\u02DA\xB8\u02DD\u02DB\u02C7";
+var MAC_ROMAN_TO_BYTE = new Map(
+  [...MAC_ROMAN_HIGH].map((ch, i) => [ch.codePointAt(0), 128 + i])
+);
+var STRICT_UTF8 = new TextDecoder("utf-8", { fatal: true });
+function cp1252Byte(code) {
+  if (code < 256) return code;
+  return CP1252_HIGH_TO_BYTE.get(code) ?? null;
+}
+function macRomanByte(code) {
+  if (code < 128) return code;
+  return MAC_ROMAN_TO_BYTE.get(code) ?? null;
+}
+function decodeAs(run, toByte) {
+  const bytes = new Uint8Array(run.length);
+  let i = 0;
+  for (const ch of run) {
+    const byte = toByte(ch.codePointAt(0));
+    if (byte === null) return null;
+    bytes[i++] = byte;
+  }
+  if (!bytes.subarray(0, i).some((b) => b >= 194 && b <= 244)) return null;
+  try {
+    return STRICT_UTF8.decode(bytes.subarray(0, i));
+  } catch {
+    return null;
+  }
+}
+var NON_ASCII_RUN = /[^\u0000-\u007f]+/g;
+function repairMisdecodedText(value) {
+  if (!/[^\u0000-\u007f]/.test(value)) return value;
+  let changed = false;
+  const repaired = value.replace(NON_ASCII_RUN, (run) => {
+    const fixed = decodeAs(run, cp1252Byte) ?? decodeAs(run, macRomanByte);
+    if (fixed === null || fixed === run) return run;
+    changed = true;
+    return fixed;
+  });
+  return changed ? repaired : value;
+}
+function repairRecordText(record) {
+  for (const key of Object.keys(record)) {
+    const value = record[key];
+    if (typeof value === "string") {
+      record[key] = repairMisdecodedText(value);
+    }
+  }
+  return record;
+}
+function csvInputTextOptions() {
+  return {
+    bom: true,
+    columns: (header) => header.map(repairMisdecodedText),
+    on_record: repairRecordText
+  };
+}
+
+// src/cli/utils.ts
 import { stringify } from "csv-stringify/sync";
 var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
@@ -504,11 +593,10 @@ function collectLocalEnvInfo() {
 function readCsvRows(csvPath) {
   const raw = readFileSync(resolve(csvPath), "utf-8");
   return parse(raw, {
-    // `csv-parse` otherwise treats a BOM before an opening quote as a field
-    // value, then rejects the quote as invalid. A UTF-8 BOM is a valid file
-    // prefix and must not become part of the first column name either.
-    bom: true,
-    columns: true,
+    // Strips the UTF-8 BOM (`csv-parse` otherwise treats one before an opening
+    // quote as a field value) and repairs mis-decoded UTF-8 in headers and
+    // cells, matching what the Play runtime does with the same file.
+    ...csvInputTextOptions(),
     skip_empty_lines: true
   });
 }

package/dist/cli/{chunk-ERC3XIUO.js → chunk-FHCBNR7M.js}

@@ -1,21 +1,24 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkKM3JYG56js = require('./chunk-KM3JYG56.js');
+var _chunkTYPYDSNYjs = require('./chunk-TYPYDSNY.js');
 
 
 
-var _chunkDL5YQFZ6js = require('./chunk-DL5YQFZ6.js');
+var _chunkVL5IYXS3js = require('./chunk-VL5IYXS3.js');
 
 
 
-var _chunk3BGGXEO5js = require('./chunk-3BGGXEO5.js');
+var _chunkSJIF45BKjs = require('./chunk-SJIF45BK.js');
+
+// src/cli/commands/search.ts
+var _commander = require('commander');
 
 // src/cli/search-ref.ts
 var _fs = require('fs');
 var _path = require('path');
 var SEARCH_REF_TTL_MS = 15 * 6e4;
 function lastSearchPath() {
-  return _path.join.call(void 0, _chunk3BGGXEO5js.sdkCliStateDirPath.call(void 0, _chunk3BGGXEO5js.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
+  return _path.join.call(void 0, _chunkSJIF45BKjs.sdkCliStateDirPath.call(void 0, _chunkSJIF45BKjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
 }
 function rememberSearchRef(searchRef) {
   try {
@@ -127,7 +130,7 @@ function searchRow(item) {
 }
 function renderSearchResults(result) {
   if (result.results.length === 0)
-    return _chunkDL5YQFZ6js.renderCommandEnvelopeText.call(void 0, result);
+    return _chunkVL5IYXS3js.renderCommandEnvelopeText.call(void 0, result);
   const rows = result.results.map(searchRow);
   const kinds = new Set(rows.map((row) => row.kind));
   const onlyTools = kinds.size === 1 && kinds.has("tool");
@@ -144,7 +147,7 @@ function renderSearchResults(result) {
     actions: _optionalChain([render, 'optionalAccess', _9 => _9.actions])
   };
   const followUps = _optionalChain([remaining, 'access', _10 => _10.sections, 'optionalAccess', _11 => _11.length]) || _optionalChain([remaining, 'access', _12 => _12.actions, 'optionalAccess', _13 => _13.length]) ? `
-${_chunkDL5YQFZ6js.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
+${_chunkVL5IYXS3js.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
   const notes = rows.flatMap(
     (row) => row.notes.map((note) => `  ${row.id}: ${note}`)
   );
@@ -171,7 +174,7 @@ var SEARCH_TYPES = [
   "prebuilts",
   "custom"
 ];
-var USAGE = "Usage: deepline search [query] [--type <types>] [--categories <categories>] [--search_terms <terms>] [--json]";
+var USAGE = "Usage: deepline search [task] [--type <types>] [--categories <categories>] [--search_terms <terms>] [--json]";
 function parseTypes(flag, raw) {
   const names = (_nullishCoalesce(raw, () => ( ""))).split(",").map((name) => name.trim().toLowerCase()).filter(Boolean);
   const unknown = names.filter(
@@ -193,14 +196,11 @@ function appendCsv(value, previous) {
 function addSearchOptions(command) {
   return command.option(
     "--categories <categories>",
-    "Comma-separated tool categories; may be used without a query"
+    "Comma-separated tool categories; may be used without a task"
   ).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");
+    "Comma-separated structured search terms; may be used without a task"
+  ).option("--search-terms <terms>", "Alias for --search_terms").addOption(new (0, _commander.Option)("--task <sentence>").hideHelp()).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");
 }
 function pointAtDescribe(result) {
   const old = /`deepline (tools|plays) describe [^`]*`/;
@@ -224,7 +224,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
     console.error(USAGE);
     return 1;
   }
-  const { search_ref: searchRef, ...result } = await new (0, _chunkKM3JYG56js.DeeplineClient)().search({
+  const { search_ref: searchRef, ...result } = await new (0, _chunkTYPYDSNYjs.DeeplineClient)().search({
     query,
     types,
     exclude,
@@ -238,7 +238,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
   });
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
-  _chunkDL5YQFZ6js.printCommandEnvelope.call(void 0, result, {
+  _chunkVL5IYXS3js.printCommandEnvelope.call(void 0, result, {
     json: options.json === true,
     text: renderSearchResults(result)
   });
@@ -247,7 +247,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
 function registerDeprecatedSearchCommand(parent, typesFor) {
   const name = `deepline ${parent.name()} search`;
   addSearchOptions(
-    parent.command("search [query]").description(`Deprecated. Use deepline search --type <types>.`).addHelpText(
+    parent.command("search [task]").description(`Deprecated. Use deepline search --type <types>.`).addHelpText(
       "after",
       `
 Notes:
@@ -255,7 +255,7 @@ Notes:
   matching --type and returns the same results envelope.
 
 Examples:
-  deepline search email --type ${typesFor({}).join(",")}
+  deepline search "name and company domain -> work email" --type ${typesFor({}).join(",")}
 `
     ).option("--all", "Include plays your workspace created").option("--compact", "Accepted for compatibility; results are compact")
   ).action(async (query, options) => {
@@ -268,7 +268,7 @@ Examples:
 }
 function registerSearchCommand(program) {
   addSearchOptions(
-    program.command("search [query]").description(
+    program.command("search [task]").description(
       "Search tools, monitors, and plays together, ranked by intent."
     ).addHelpText(
       "after",
@@ -287,22 +287,21 @@ Notes:
   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.
+  The task is one sentence on what you are trying to accomplish, written as
+  the input you have -> the result you need. Do not send keywords: the
+  sentence is what ranks the results. 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.
   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.
   Readable prices are Deepline credits with a per-row unit. Estimates and
   observed historical charges are labelled; usage-based prices are not quotes.
 
 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 "first name, last name and company domain -> verified work email"
+  deepline search "200 LinkedIn profile URLs -> each person's current title and company" --type tools --limit 10
+  deepline search "company domain -> contacts in sales leadership" --type plays
+  deepline search "company domain -> headcount, funding and industry" --exclude monitors,custom
   deepline search --type tools --categories company_search --search_terms "investors,funding"
 `
     ).option(

package/dist/cli/{chunk-BIA27ZNI.mjs → chunk-GJYCHN2L.mjs}

@@ -2,10 +2,10 @@ import {
   getAuthedHttpClient,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-OJH4W52K.mjs";
+} from "./chunk-DRHVFFMJ.mjs";
 import {
   resolveBaseUrlOnly
-} from "./chunk-G6TM2GK2.mjs";
+} from "./chunk-J5NN6XCF.mjs";
 
 // src/cli/commands/git.ts
 function shellQuote(value) {

package/dist/cli/{chunk-G6TM2GK2.mjs → chunk-J5NN6XCF.mjs}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DLIRSHV6.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-AC7QCWXV.mjs";
+} from "./chunk-RN7NIZIL.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
@@ -1383,6 +1383,10 @@ var HttpClient = class {
     if (skillsVersion) {
       headers["X-Deepline-Skills-Version"] = skillsVersion;
     }
+    const agentSessionId = agentSessionIdFromEnvironment();
+    if (agentSessionId) {
+      headers["X-Deepline-Agent-Session-Id"] = agentSessionId;
+    }
     const playArtifactR2Prefix = typeof process !== "undefined" ? process.env?.DEEPLINE_PLAY_ARTIFACT_R2_PREFIX : void 0;
     if (playArtifactR2Prefix) {
       headers["x-deepline-play-artifact-r2-prefix"] = playArtifactR2Prefix;