deepline 0.3.368 → 0.3.370

package/dist/cli/{chunk-IG7OYVS7.mjs → chunk-BKHNCIQD.mjs}

@@ -19,11 +19,11 @@ import {
 } from "./chunk-EDWJY6T4.mjs";
 import {
   registerDeprecatedSearchCommand
-} from "./chunk-7PQTQSJY.mjs";
+} from "./chunk-BGXG3GEI.mjs";
 import {
   handleDeploymentGet,
   handleDeploymentsList
-} from "./chunk-ZS2YQ4YK.mjs";
+} from "./chunk-A5RFERJQ.mjs";
 import {
   pinLocalPlayImports,
   planLocalPlayExecution
@@ -42,7 +42,7 @@ import {
   normalizeRunEventOperationRequest,
   parseLogLevel,
   playInputExampleArgs
-} from "./chunk-THO6F53F.mjs";
+} from "./chunk-H4IQJRFC.mjs";
 import {
   CSV_DATA_INPUT_KEY,
   buildNamedPlayRunRequest,
@@ -75,10 +75,10 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-S3MDB6SI.mjs";
+} from "./chunk-GGRVNAOH.mjs";
 import {
   fetchWithDeploymentProtection
-} from "./chunk-EZUGGC5A.mjs";
+} from "./chunk-LJWOPNJJ.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -16476,7 +16476,7 @@ Examples:
         process.exitCode = await ownView();
         return;
       }
-      const { describeAnything } = await import("./describe-N2KSBPOR.mjs");
+      const { describeAnything } = await import("./describe-XMWXEFMS.mjs");
       process.exitCode = await describeAnything(
         name,
         {

package/dist/cli/{chunk-QILHWZFP.js → chunk-CTMA3C3N.js}

@@ -417,7 +417,8 @@ When:
 Input:
   The tool id. Prints readable text by default, also when piped; read that
   form and pass --json only for a program. --pricing-only, --schema-only,
-  --examples-only, --getters-only print one section. --out <path> saves the
+  --examples-only, --getters-only print one section. --byok prints only
+  whether you can use your own provider credentials and how to connect them. --out <path> saves the
   output to a file. get is an alias of describe, and deepline describe <id>
   is the same read for a tool, a play, or a monitor type.
 Output (JSON):
@@ -456,6 +457,11 @@ Output fields:
   connected              false means the provider needs a connected account or
                          key in this workspace; execute will fail with 3.
   credentialStatus       detail for connected false.
+  byok                   only with --byok. supported: you can connect your
+                         own provider credentials; required: the tool runs
+                         only on them. setup and setupUrl say where to
+                         connect them. With byok optional and nothing
+                         connected, Deepline's managed credentials are used.
   extractors / targetGetters  JSON paths the CLI uses to turn the raw provider
                          response into rows; the same paths appear in tools
                          execute output as output_preview.listSourcePath.

package/dist/cli/{chunk-NZHVJB2W.js → chunk-DFJDVQMH.js}

@@ -1,6 +1,6 @@
 "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 _chunkGJO4H3NNjs = require('./chunk-GJO4H3NN.js');
+var _chunkA6DJC2RCjs = require('./chunk-A6DJC2RC.js');
 
 // src/cli/npm-script-policy.ts
 var _child_process = require('child_process');
@@ -13,7 +13,7 @@ function npmSupportsAllowScripts(version) {
 }
 function readNpmVersion(env) {
   try {
-    const plan = _chunkGJO4H3NNjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
+    const plan = _chunkA6DJC2RCjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,

package/dist/cli/{chunk-S3MDB6SI.mjs → chunk-GGRVNAOH.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-EZUGGC5A.mjs";
+} from "./chunk-LJWOPNJJ.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";

package/dist/cli/{chunk-THO6F53F.mjs → chunk-H4IQJRFC.mjs}

@@ -21,7 +21,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-EZUGGC5A.mjs";
+} from "./chunk-LJWOPNJJ.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,

package/dist/cli/{chunk-XUMWO4ST.mjs → chunk-HHH4MPFY.mjs}

@@ -1,17 +1,17 @@
 import {
   npmSupportsAllowScripts,
   readNpmVersion
-} from "./chunk-LEZWRLB3.mjs";
+} from "./chunk-LNEBKWXM.mjs";
 import {
   resolveShellSpawn,
   runSkillsCommand
-} from "./chunk-ENGMDXHN.mjs";
+} from "./chunk-5DUTNG37.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-S3MDB6SI.mjs";
+} from "./chunk-GGRVNAOH.mjs";
 import {
   autoDetectBaseUrl
-} from "./chunk-EZUGGC5A.mjs";
+} from "./chunk-LJWOPNJJ.mjs";
 
 // src/cli/commands/update.ts
 import { spawn, spawnSync } from "child_process";

package/dist/cli/{chunk-PU53IS6H.mjs → chunk-IDBLJSLL.mjs}

@@ -2,7 +2,7 @@ import {
   argsWantJson,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-S3MDB6SI.mjs";
+} from "./chunk-GGRVNAOH.mjs";
 import {
   ACTIVE_ORG_ID_ENV,
   ACTIVE_ORG_NAME_ENV,
@@ -25,7 +25,7 @@ import {
   saveHostEnvValues,
   saveProjectDeeplineEnvValues,
   storedHostApiKey
-} from "./chunk-EZUGGC5A.mjs";
+} from "./chunk-LJWOPNJJ.mjs";
 
 // src/cli/commands/auth.ts
 import {

package/dist/cli/{chunk-EZUGGC5A.mjs → chunk-LJWOPNJJ.mjs}

@@ -14,7 +14,7 @@ import {
 } from "./chunk-NXGCO4JB.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-GHZUH33K.mjs";
+} from "./chunk-NEY2M4EZ.mjs";
 
 // src/errors.ts
 var CustomerDbQueryOutcomeUnknownError = class extends DeeplineError {

package/dist/cli/{chunk-LEZWRLB3.mjs → chunk-LNEBKWXM.mjs}

@@ -1,6 +1,6 @@
 import {
   resolveShellSpawn
-} from "./chunk-ENGMDXHN.mjs";
+} from "./chunk-5DUTNG37.mjs";
 
 // src/cli/npm-script-policy.ts
 import { spawnSync } from "child_process";

package/dist/cli/{chunk-SNENR3BL.js → chunk-MKFHZDBO.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkGTC2KAZQjs = require('./chunk-GTC2KAZQ.js');
+var _chunkSFI7U6CAjs = require('./chunk-SFI7U6CA.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
@@ -225,8 +225,8 @@ var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
 var defaultBrowserCommandRunner = childProcess;
 function getAuthedHttpClient() {
-  const config = _chunkGTC2KAZQjs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkGTC2KAZQjs.HttpClient)(config) };
+  const config = _chunkSFI7U6CAjs.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunkSFI7U6CAjs.HttpClient)(config) };
 }
 function stableOsUserId() {
   try {
@@ -566,7 +566,7 @@ function collectLocalEnvInfo() {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
     home_dir: homeDir,
-    agent_runtime: _chunkGTC2KAZQjs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunkSFI7U6CAjs.detectAgentRuntime.call(void 0, )
   };
   const env = process.env;
   const optional = {
@@ -813,9 +813,9 @@ function markdownTableFromRows(rows, preferredColumns = []) {
 }
 function withAgentCommandContext(value) {
   const valueRecord = value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-  return _chunkGTC2KAZQjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunkSFI7U6CAjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkGTC2KAZQjs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunkSFI7U6CAjs.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {

package/dist/cli/{chunk-GHZUH33K.mjs → chunk-NEY2M4EZ.mjs}

@@ -49,7 +49,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.368",
+  version: "0.3.370",
   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
@@ -93,6 +93,11 @@ var SDK_RELEASE = {
         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: "describe",
+        introducedIn: "0.3.312",
+        reason: "deepline describe was added in SDK CLI 0.3.312 as the one describe for tools, monitor types, and plays. On an older version run deepline tools describe or deepline plays describe, or update."
+      },
       {
         command: "notifications",
         introducedIn: "0.2.40",

package/dist/cli/{chunk-HZT2Y7WB.js → chunk-NHB3UWTZ.js}

@@ -1,17 +1,17 @@
 "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 _chunkNZHVJB2Wjs = require('./chunk-NZHVJB2W.js');
+var _chunkDFJDVQMHjs = require('./chunk-DFJDVQMH.js');
 
 
 
-var _chunkGJO4H3NNjs = require('./chunk-GJO4H3NN.js');
+var _chunkA6DJC2RCjs = require('./chunk-A6DJC2RC.js');
 
 
-var _chunkSNENR3BLjs = require('./chunk-SNENR3BL.js');
+var _chunkMKFHZDBOjs = require('./chunk-MKFHZDBO.js');
 
 
-var _chunkGTC2KAZQjs = require('./chunk-GTC2KAZQ.js');
+var _chunkSFI7U6CAjs = require('./chunk-SFI7U6CA.js');
 
 // src/cli/commands/update.ts
 var _child_process = require('child_process');
@@ -489,7 +489,7 @@ function normalizedNpmPrefix(value) {
 }
 function resolveNpmGlobalPrefix(env) {
   try {
-    const plan = _chunkGJO4H3NNjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
+    const plan = _chunkA6DJC2RCjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,
@@ -545,8 +545,8 @@ function resolveUpdatePlan(options = {}) {
   const npmGlobalPrefix = options.npmGlobalPrefix !== void 0 ? options.npmGlobalPrefix : resolveNpmGlobalPrefix(env);
   const hasVerifiedNpmOwnership = inferredInstallPrefix !== null && normalizedNpmPrefix(inferredInstallPrefix) === normalizedNpmPrefix(npmGlobalPrefix);
   const installPrefix = options.requireVerifiedNpmOwnership ? hasVerifiedNpmOwnership ? inferredInstallPrefix : null : inferredInstallPrefix;
-  const npmVersion = options.npmVersion === void 0 ? _chunkNZHVJB2Wjs.readNpmVersion.call(void 0, env) : options.npmVersion;
-  const npmGlobalInstallFlags = _chunkNZHVJB2Wjs.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
+  const npmVersion = options.npmVersion === void 0 ? _chunkDFJDVQMHjs.readNpmVersion.call(void 0, env) : options.npmVersion;
+  const npmGlobalInstallFlags = _chunkDFJDVQMHjs.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
   const args = installPrefix ? [
     "install",
     "-g",
@@ -556,7 +556,7 @@ function resolveUpdatePlan(options = {}) {
     packageSpec
   ] : ["install", "-g", ...npmGlobalInstallFlags, packageSpec];
   const fallbackRegistryUrl = options.npmFallbackRegistryUrl !== void 0 ? options.npmFallbackRegistryUrl : publicNpmFallbackRegistryUrl(
-    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunkGTC2KAZQjs.autoDetectBaseUrl.call(void 0, )
+    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunkSFI7U6CAjs.autoDetectBaseUrl.call(void 0, )
   );
   return {
     kind: "npm-global",
@@ -703,7 +703,7 @@ function sidecarInstallFailure(versionDir) {
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveResult) => {
     let output = "";
-    const plan = _chunkGJO4H3NNjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
+    const plan = _chunkA6DJC2RCjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
     const child = _child_process.spawn.call(void 0, plan.command, plan.args, {
       stdio: ["inherit", "pipe", "pipe"],
       shell: plan.shell,
@@ -1079,14 +1079,14 @@ async function publishedVersionSupportsPin(version, fallbackRegistryUrl) {
   throw _nullishCoalesce(lastError, () => ( new Error("No npm registry was available")));
 }
 async function runUpdateCommand(options, dependencies = {}) {
-  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunkGTC2KAZQjs.autoDetectBaseUrl));
+  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunkSFI7U6CAjs.autoDetectBaseUrl));
   const resolvePlan = _nullishCoalesce(dependencies.resolvePlan, () => ( resolveUpdatePlan));
   const runPlan = _nullishCoalesce(dependencies.runPlan, () => ( runUpdatePlan));
   const syncSkills = _nullishCoalesce(dependencies.syncSkillsIfNeeded, () => ( (async () => {
     const originalWrite = process.stdout.write.bind(process.stdout);
     process.stdout.write = (() => true);
     try {
-      const exitCode = await _chunkGJO4H3NNjs.runSkillsCommand.call(void 0, { json: true });
+      const exitCode = await _chunkA6DJC2RCjs.runSkillsCommand.call(void 0, { json: true });
       if (exitCode !== 0) {
         throw new Error(
           `Deepline skills update failed with exit ${exitCode}.`
@@ -1157,11 +1157,11 @@ async function runUpdateCommand(options, dependencies = {}) {
     ]
   };
   if (options.json && !options.executeWithJson) {
-    _chunkSNENR3BLjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
+    _chunkMKFHZDBOjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
     return 0;
   }
   if (options.printCommand) {
-    _chunkSNENR3BLjs.printCommandEnvelope.call(void 0, 
+    _chunkMKFHZDBOjs.printCommandEnvelope.call(void 0, 
       {
         ...plan,
         render: {
@@ -1174,7 +1174,7 @@ async function runUpdateCommand(options, dependencies = {}) {
     return 0;
   }
   if (plan.kind === "source" || plan.kind === "homebrew") {
-    _chunkSNENR3BLjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
+    _chunkMKFHZDBOjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
     return 0;
   }
   stderr.write(`Updating Deepline SDK/CLI with: ${plan.manualCommand}
@@ -1204,7 +1204,7 @@ To retry with full installer output, run: deepline skills --json
     );
   }
   if (options.executeWithJson && options.json) {
-    _chunkSNENR3BLjs.printCommandEnvelope.call(void 0, 
+    _chunkMKFHZDBOjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         pinnedVersion