deepline 0.3.452 → 0.3.454

package/dist/cli/index.mjs

@@ -7,26 +7,25 @@ import {
   maybeAutoUpdateAndRelaunch,
   runDeferredAutoUpdate,
   runToolExecuteStage
-} from "./chunk-X4IMX5AO.mjs";
-import "./chunk-2GMAPSJU.mjs";
-import "./chunk-ELULDUX3.mjs";
-import "./chunk-R7YZKHN5.mjs";
+} from "./chunk-LVHRP7XM.mjs";
+import "./chunk-EXWKHMMP.mjs";
+import "./chunk-5OQMUDPM.mjs";
+import "./chunk-THJ7ORNM.mjs";
 import {
   usesInlinePlayAdmission
-} from "./chunk-TXN27XQQ.mjs";
+} from "./chunk-27NNEBIS.mjs";
 import {
   isCliTraceEnabled,
   parseCliMaintenancePolicy,
   recordCliTrace,
   resolveCliMaintenancePolicy,
   traceCliSpan
-} from "./chunk-JJOSUZMS.mjs";
+} from "./chunk-UT6W675P.mjs";
 import {
   SDK_COMPATIBILITY_FAST_DEADLINE_MS,
   SKILLS_AUTO_SYNC_COMMAND,
   checkSdkCompatibility,
   claimUpdateAdvisory,
-  createCliProgress,
   enforceSdkCompatibilityResponse,
   failureReportHeaders,
   flushDeferredSkillsSyncNotices,
@@ -39,7 +38,10 @@ import {
   resolveSdkCliFailureExitCode,
   sanitizeCommand,
   syncSdkSkillsIfNeeded
-} from "./chunk-UGPGB4C6.mjs";
+} from "./chunk-G6ZOZQXT.mjs";
+import {
+  createCliProgress
+} from "./chunk-2I7GE7KB.mjs";
 import {
   addJsonNotice,
   errorToJsonPayload,
@@ -52,7 +54,7 @@ import {
   printJson,
   shouldEmitJson,
   takeSilentJsonFailureMessage
-} from "./chunk-PBQSX6ES.mjs";
+} from "./chunk-RDAUQGPG.mjs";
 import {
   HttpClient,
   SDK_VERSION,
@@ -62,13 +64,13 @@ import {
   resolveApiKeyForBaseUrl,
   resolveBaseUrlOnly,
   resolveConfig
-} from "./chunk-SM5RZ5JC.mjs";
+} from "./chunk-TECW24CR.mjs";
 import {
   AuthError
 } from "./chunk-4QF2K7TM.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-HBL4PM5Q.mjs";
-import "./chunk-RFDIXLRX.mjs";
+import "./chunk-LWYOJG66.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import {
   commandDocKey,
@@ -138,48 +140,48 @@ import { Command as Command2 } from "commander";
 var COMMAND_GROUPS = [
   {
     names: ["auth"],
-    load: async () => (await import("./auth-DKZLB6GN.mjs")).registerAuthCommands
+    load: async () => (await import("./auth-YNPT3IER.mjs")).registerAuthCommands
   },
   {
     names: ["providers"],
-    load: async () => (await import("./providers-MBTMUEGX.mjs")).registerProviderCommands
+    load: async () => (await import("./providers-6QGGDOWK.mjs")).registerProviderCommands
   },
   {
     names: ["search"],
-    load: async () => (await import("./search-4PQZYRQO.mjs")).registerSearchCommand
+    load: async () => (await import("./search-6PKFZ2JD.mjs")).registerSearchCommand
   },
   {
     names: ["describe"],
-    load: async () => (await import("./describe-4RBUIHR7.mjs")).registerDescribeCommand
+    load: async () => (await import("./describe-EZDVJDPQ.mjs")).registerDescribeCommand
   },
   {
     names: ["tools"],
-    load: async () => (await import("./tools-G3VYZKTO.mjs")).registerToolsCommands
+    load: async () => (await import("./tools-SQUTVLPO.mjs")).registerToolsCommands
   },
   {
     names: ["executions"],
-    load: async () => (await import("./executions-WOBIMQ7H.mjs")).registerExecutionsCommands
+    load: async () => (await import("./executions-W5KR56KP.mjs")).registerExecutionsCommands
   },
   {
     names: ["plays", "runs"],
-    load: async () => (await import("./play-EAYGEAMI.mjs")).registerPlayCommands
+    load: async () => (await import("./play-PXISXZ2P.mjs")).registerPlayCommands
   },
   {
     names: ["sessions"],
-    load: async () => (await import("./sessions-T6XVN737.mjs")).registerSessionsCommands
+    load: async () => (await import("./sessions-SVYTBNRJ.mjs")).registerSessionsCommands
   },
   {
     names: ["workflows"],
-    load: async () => (await import("./workflow-EUMRVXU7.mjs")).registerWorkflowCommands
+    load: async () => (await import("./workflow-VBCZPKVF.mjs")).registerWorkflowCommands
   },
   {
     names: ["secrets"],
-    load: async () => (await import("./secrets-S55UCYYR.mjs")).registerSecretsCommands
+    load: async () => (await import("./secrets-QBWRVZCT.mjs")).registerSecretsCommands
   },
   {
     names: ["settings", "notifications"],
     load: async () => {
-      const commands = await import("./settings-CGP7XMJZ.mjs");
+      const commands = await import("./settings-FH4XZ7FE.mjs");
       return (p) => {
         commands.registerSettingsCommands(p);
         commands.registerNotificationCommands(p);
@@ -188,51 +190,51 @@ var COMMAND_GROUPS = [
   },
   {
     names: ["billing"],
-    load: async () => (await import("./billing-DOFXWAZR.mjs")).registerBillingCommands
+    load: async () => (await import("./billing-TLRVAOXB.mjs")).registerBillingCommands
   },
   {
     names: ["monitors"],
-    load: async () => (await import("./monitors-HLIW4AIL.mjs")).registerMonitorsCommands
+    load: async () => (await import("./monitors-CEU6SP2B.mjs")).registerMonitorsCommands
   },
   {
     names: ["org"],
-    load: async () => (await import("./org-X4MVTSKM.mjs")).registerOrgCommands
+    load: async () => (await import("./org-RRKAJM5V.mjs")).registerOrgCommands
   },
   {
     names: ["git", "projects", "deployments"],
-    load: async () => (await import("./git-SZ6RSLFN.mjs")).registerGitCommands
+    load: async () => (await import("./git-JXH64LI4.mjs")).registerGitCommands
   },
   {
     names: ["csv"],
-    load: async () => (await import("./csv-QUNUQZYC.mjs")).registerCsvCommands
+    load: async () => (await import("./csv-I4CAAV6A.mjs")).registerCsvCommands
   },
   {
     names: ["db"],
-    load: async () => (await import("./db-WYWDUYXS.mjs")).registerDbCommands
+    load: async () => (await import("./db-EQP24K3B.mjs")).registerDbCommands
   },
   {
     names: ["feedback"],
-    load: async () => (await import("./feedback-VCGVROTY.mjs")).registerFeedbackCommands
+    load: async () => (await import("./feedback-6UTOLSFP.mjs")).registerFeedbackCommands
   },
   {
     names: ["enrich", "session", "backend"],
-    load: async () => (await import("./legacy-noops-UGLTI2ZY.mjs")).registerDeprecatedCommands
+    load: async () => (await import("./legacy-noops-NYMLGQNX.mjs")).registerDeprecatedCommands
   },
   {
     names: ["update"],
-    load: async () => (await import("./update-C7CLWWIW.mjs")).registerUpdateCommand
+    load: async () => (await import("./update-AFYEREBX.mjs")).registerUpdateCommand
   },
   {
     names: ["skills", "skills-auto-sync"],
-    load: async () => (await import("./skills-2JS3SNFA.mjs")).registerSkillsCommand
+    load: async () => (await import("./skills-HITZS5EJ.mjs")).registerSkillsCommand
   },
   {
     names: ["setup", "doctor"],
-    load: async () => (await import("./setup-U66NZQXB.mjs")).registerSetupCommands
+    load: async () => (await import("./setup-ISCNCB4W.mjs")).registerSetupCommands
   },
   {
     names: ["quickstart"],
-    load: async () => (await import("./quickstart-MDW2NMAS.mjs")).registerQuickstartCommands
+    load: async () => (await import("./quickstart-MKJ7TYQZ.mjs")).registerQuickstartCommands
   }
 ];
 async function registerDeeplineCommandGroups(program, requestedCommand) {
@@ -596,7 +598,7 @@ async function runPlayRunnerHealthCheck() {
     });
     let exitCode = 1;
     try {
-      const { handlePlayRun } = await import("./play-EAYGEAMI.mjs");
+      const { handlePlayRun } = await import("./play-PXISXZ2P.mjs");
       exitCode = await handlePlayRun([
         file,
         "--input",
@@ -1044,7 +1046,7 @@ Examples:
       return;
     }
     try {
-      const { httpJson, readStatusBanner, statusBannerLine } = await import("./auth-DKZLB6GN.mjs");
+      const { httpJson, readStatusBanner, statusBannerLine } = await import("./auth-YNPT3IER.mjs");
       const baseUrl = resolveBaseUrlOnly();
       const [{ status, data }, banner] = await Promise.all([
         httpJson("GET", `${baseUrl}/api/v2/health`, null),
@@ -1132,7 +1134,7 @@ Examples:
     const helpArgs = process.argv.slice(2);
     const helpPositionals = helpArgs.filter((arg) => !arg.startsWith("-"));
     if (helpPositionals.length === 0 ? helpArgs.includes("--help") || helpArgs.includes("-h") : helpPositionals.length === 1 && helpPositionals[0] === "help") {
-      const { authStatusLine } = await import("./auth-DKZLB6GN.mjs");
+      const { authStatusLine } = await import("./auth-YNPT3IER.mjs");
       rootHelpStatus = `Version: ${SDK_VERSION}
 ${await authStatusLine()}
 `;

package/dist/cli/{legacy-noops-TXZ75CWS.js → legacy-noops-5XTXIPU2.js}

@@ -1,17 +1,17 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkZH6HFV7Yjs = require('./chunk-ZH6HFV7Y.js');
+var _chunkFKGXZXRPjs = require('./chunk-FKGXZXRP.js');
 
 
 var _chunk3XX5TEA4js = require('./chunk-3XX5TEA4.js');
 
 
-var _chunkZKGK2JU3js = require('./chunk-ZKGK2JU3.js');
-require('./chunk-ETFVH7PO.js');
+var _chunkSJH66N73js = require('./chunk-SJH66N73.js');
+require('./chunk-VXBEHDM6.js');
 require('./chunk-ALJJRZNJ.js');
 require('./chunk-XNYIZMNQ.js');
 require('./chunk-DIAWYWT5.js');
-require('./chunk-7JSZOUNU.js');
+require('./chunk-7V3OKSB2.js');
 require('./chunk-OG64RBAC.js');
 require('./chunk-COGTRVWW.js');
 
@@ -52,7 +52,7 @@ function deprecatedCommandEnvelope(input) {
   };
 }
 function printDeprecatedCommand(input) {
-  _chunkZKGK2JU3js.printCommandEnvelope.call(void 0, deprecatedCommandEnvelope(input), {
+  _chunkSJH66N73js.printCommandEnvelope.call(void 0, deprecatedCommandEnvelope(input), {
     json: input.options.json
   });
   process.exitCode = 2;
@@ -72,7 +72,7 @@ function registerDeprecatedCommands(program) {
   program.command("enrich", { hidden: true }).description("Deprecated CSV enrichment command.").allowUnknownOption(true).allowExcessArguments(true).option("--json", "Emit JSON output").argument("[args...]").addHelpText("after", `
 ${_chunk3XX5TEA4js.ENRICH_COMMAND_DEPRECATION_MESSAGE}
 `).action((_args, options) => {
-    _chunkZKGK2JU3js.printCommandEnvelope.call(void 0, 
+    _chunkSJH66N73js.printCommandEnvelope.call(void 0, 
       {
         ok: false,
         command: "deepline enrich",
@@ -115,7 +115,7 @@ Examples:
       options
     });
   });
-  _chunkZH6HFV7Yjs.registerSessionSendRenderCommands.call(void 0, session, "session");
+  _chunkFKGXZXRPjs.registerSessionSendRenderCommands.call(void 0, session, "session");
   for (const subcommand of SESSION_SUBCOMMANDS) {
     addDeprecatedSubcommand(
       session,

package/dist/cli/{legacy-noops-UGLTI2ZY.mjs → legacy-noops-NYMLGQNX.mjs}

@@ -1,17 +1,17 @@
 import {
   registerSessionSendRenderCommands
-} from "./chunk-FIQ2F5LA.mjs";
+} from "./chunk-5GJH2BYN.mjs";
 import {
   ENRICH_COMMAND_DEPRECATION_MESSAGE
 } from "./chunk-ITOFSXIU.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-PBQSX6ES.mjs";
-import "./chunk-SM5RZ5JC.mjs";
+} from "./chunk-RDAUQGPG.mjs";
+import "./chunk-TECW24CR.mjs";
 import "./chunk-4QF2K7TM.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-HBL4PM5Q.mjs";
-import "./chunk-RFDIXLRX.mjs";
+import "./chunk-LWYOJG66.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 

package/dist/cli/{monitors-HLIW4AIL.mjs → monitors-CEU6SP2B.mjs}

@@ -1,7 +1,7 @@
 import "./chunk-EXMLR72R.mjs";
 import {
   DeeplineClient
-} from "./chunk-2SICEJBN.mjs";
+} from "./chunk-YXCLG3KB.mjs";
 import "./chunk-L2VKAASU.mjs";
 import "./chunk-FAG4DFUC.mjs";
 import "./chunk-EIMG75BT.mjs";
@@ -14,13 +14,16 @@ import "./chunk-4MBOJQPL.mjs";
 import {
   lintMonitorBatchInput
 } from "./chunk-MI6ZP7XI.mjs";
+import {
+  createCliProgress
+} from "./chunk-2I7GE7KB.mjs";
 import {
   errorToJsonPayload,
   printCommandEnvelope,
   printJson,
   shouldEmitJson
-} from "./chunk-PBQSX6ES.mjs";
-import "./chunk-SM5RZ5JC.mjs";
+} from "./chunk-RDAUQGPG.mjs";
+import "./chunk-TECW24CR.mjs";
 import {
   AuthError
 } from "./chunk-4QF2K7TM.mjs";
@@ -28,7 +31,7 @@ import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-HBL4PM5Q.mjs";
-import "./chunk-RFDIXLRX.mjs";
+import "./chunk-LWYOJG66.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 
@@ -735,6 +738,115 @@ async function handleMonitorsCheck(definition, options) {
   );
   printCommandEnvelope(payload, { json: options.json });
 }
+function previewText(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : "-";
+}
+function renderMonitorPreviewText(payload) {
+  const updates = Array.isArray(payload.updates) ? payload.updates : [];
+  const charge = asRecord(payload.charge) ?? {};
+  const lines = [
+    `Preview of ${previewText(payload.tool)}: ${updates.length} of ${String(payload.limit ?? "?")} requested matches.`
+  ];
+  for (const item of updates) {
+    const content = asRecord(asRecord(item)?.content) ?? {};
+    lines.push(
+      `  ${previewText(content.full_name)} | ${previewText(content.title)} | started ${previewText(content.start_date)} | ${previewText(content.seniority)}`
+    );
+  }
+  const credits = typeof charge.credits === "number" ? charge.credits : 0;
+  const perUpdate = charge.credits_per_update;
+  switch (charge.status) {
+    case "queued":
+    case "settled":
+      lines.push(
+        payload.replayed === true ? `Saved result: this preview charged ${credits} credits when it first ran, and this rerun charged nothing.` : `Charged ${credits} credits (${String(perUpdate)} per returned update).`
+      );
+      break;
+    case "free":
+      lines.push("No matches came back, so nothing was charged.");
+      break;
+    case "unconfirmed":
+      lines.push(
+        `The charge could not be confirmed: up to ${credits} credits may still post. Check deepline billing usage.`
+      );
+      break;
+    default:
+      lines.push("This preview was not charged.");
+  }
+  if (Array.isArray(payload.ignored_fields) && payload.ignored_fields.length) {
+    lines.push(
+      `Ignored for the preview: ${payload.ignored_fields.join(", ")} (still used on deploy).`
+    );
+  }
+  if (typeof payload.note === "string") lines.push(payload.note);
+  lines.push(`Preview key: ${String(payload.idempotency_key)}`);
+  return `${lines.join("\n")}
+`;
+}
+async function handleMonitorsPreview(definition, options) {
+  const body = resolveMonitorJsonBody({
+    positional: definition,
+    file: options.file,
+    argLabel: "<definition>",
+    command: "deepline monitors preview"
+  });
+  const limit = options.limit === void 0 ? void 0 : Number(options.limit);
+  if (limit !== void 0 && !Number.isInteger(limit)) {
+    throw new MonitorsUsageError("--limit must be a whole number from 1 to 3.");
+  }
+  const wantsJson = shouldEmitJson(options.json);
+  if (options.idempotencyKey === void 0 && wantsJson) {
+    throw new MonitorsUsageError(
+      "--json requires --idempotency-key <key>. Choose a new key for each new preview and keep it: rerunning with the same key returns the result without paying again."
+    );
+  }
+  const idempotencyKey = options.idempotencyKey ?? `monitor-preview-${randomUUID()}`;
+  const progress = createCliProgress(!wantsJson);
+  progress.phase(`Preview key: ${idempotencyKey}`);
+  try {
+    const payload = await new DeeplineClient().monitors.preview(
+      body,
+      { idempotencyKey, ...limit === void 0 ? {} : { limit } }
+    );
+    progress.complete();
+    printCommandEnvelope(payload, {
+      json: options.json,
+      text: renderMonitorPreviewText(payload)
+    });
+  } catch (error) {
+    progress.fail();
+    if (previewRetryableWithSameKey(error)) {
+      process.stderr.write(
+        `To get this preview's result without paying again, rerun the same command with --idempotency-key ${idempotencyKey}. A new key runs a new, paid preview.
+`
+      );
+    }
+    throw error;
+  }
+}
+var MONITOR_PREVIEW_SAME_KEY_RETRY_CODES = /* @__PURE__ */ new Set([
+  "EXECUTION_IN_PROGRESS",
+  "EXECUTION_RECOVERY_UNAVAILABLE",
+  "BILLING_UNAVAILABLE",
+  "monitor_preview_rate_limited",
+  "monitor_preview_provider_unavailable"
+]);
+var MONITOR_PREVIEW_NEW_KEY_CODES = /* @__PURE__ */ new Set([
+  "EXECUTION_OUTCOME_UNKNOWN",
+  "monitor_preview_outcome_unknown"
+]);
+function previewRetryableWithSameKey(error) {
+  if (!(error instanceof DeeplineError)) return true;
+  const code = error.code;
+  if (code !== void 0 && MONITOR_PREVIEW_NEW_KEY_CODES.has(code)) {
+    return false;
+  }
+  if (code !== void 0 && MONITOR_PREVIEW_SAME_KEY_RETRY_CODES.has(code)) {
+    return true;
+  }
+  const status = error.statusCode;
+  return status === void 0 || status === 0 || status >= 500;
+}
 async function handleMonitorsDeploy(definition, options) {
   const body = resolveMonitorJsonBody({
     positional: definition,
@@ -2807,6 +2919,10 @@ Notes:
   \`deepline describe deepline_native.company_radar\`.
   Operational controls are Deepline-managed. Bind downstream automation in a
   Play with sqlListeners; monitor definitions never name Plays.
+  When the definition can be previewed, the response includes a "preview"
+  object with its price and the exact \`monitors preview\` command. A preview
+  costs credits; check itself never does. "available": false means this
+  definition has no preview. No "preview" field means the tool has none.
 
 Examples:
   deepline monitors check '{"key":"job-openings","tool":"deepline_native.company_radar","payload":{"domain":"stripe.com","radar_type":"company_job_openings"}}'
@@ -2818,6 +2934,42 @@ Examples:
       "Read the definition JSON from a file, or - for stdin"
     )
   ).action(monitorsAction(handleMonitorsCheck));
+  withJsonOption(
+    monitors.command("preview [definition]").description(
+      "Sample a few recent matches for a monitor definition before deploying it. Costs credits."
+    ).addHelpText(
+      "after",
+      `
+Notes:
+  Takes the same definition as check and deploy. Nothing is created.
+  Available today only for deepline_native.company_radar with radar_type
+  company_new_hires. Any other tool or radar type answers
+  monitor_preview_unavailable without spending anything: run check, then deploy.
+  Each returned match costs the same as one match the deployed monitor would
+  deliver. An empty preview is free. --limit is 1-3 (default 3).
+  Run previews one at a time. A preview is a sample: it can miss matches, and
+  an empty one does not mean the monitor will find nothing. Read "updates".
+  payload.updates_since is ignored for the preview and still used on deploy.
+  Deploy the same definition without --limit when the sample looks right.
+  Every preview has a key, printed before it is sent. If the connection drops,
+  rerun with --idempotency-key <key> to get the original result without paying
+  again. A new key runs a new, paid preview. --json prints nothing before the
+  result, so it requires --idempotency-key: choose the key yourself and keep it.
+
+Examples:
+  deepline monitors preview '{"key":"eng-hires","tool":"deepline_native.company_radar","payload":{"domain":"stripe.com","radar_type":"company_new_hires","departments":["Engineering"]}}'
+  deepline monitors preview --file monitor.json --limit 2
+  deepline monitors preview --file monitor.json --idempotency-key monitor-preview-<key>
+  deepline monitors preview --file monitor.json --idempotency-key eng-hires-sample-1 --json
+`
+    ).option(
+      "-f, --file <path>",
+      "Read the definition JSON from a file, or - for stdin"
+    ).option("--limit <n>", "Matches to sample, 1-3 (default 3)").option(
+      "--idempotency-key <key>",
+      "Recover an earlier preview's result without paying again. Required with --json"
+    )
+  ).action(monitorsAction(handleMonitorsPreview));
   withJsonOption(
     monitors.command("deploy [definition]").description("Deploy a monitor from a definition.").addHelpText(
       "after",