deepline 0.3.460 → 0.3.462

package/dist/cli/{chunk-LJTFZOHU.js → chunk-OPJAJBD4.js}

@@ -3,15 +3,15 @@
 var _chunkZM2YPJQJjs = require('./chunk-ZM2YPJQJ.js');
 
 
-var _chunkVTODQWQAjs = require('./chunk-VTODQWQA.js');
+var _chunkJF3TLIMQjs = require('./chunk-JF3TLIMQ.js');
 
 
 
-var _chunkBHGII2D6js = require('./chunk-BHGII2D6.js');
+var _chunk3ACMRZRVjs = require('./chunk-3ACMRZRV.js');
 
 
 
-var _chunkQJLKYYPXjs = require('./chunk-QJLKYYPX.js');
+var _chunkY4DPU4OMjs = require('./chunk-Y4DPU4OM.js');
 
 
 
@@ -5713,7 +5713,7 @@ var _fs = require('fs');
 var _path = require('path');
 var SEARCH_REF_TTL_MS = 15 * 6e4;
 function lastSearchPath() {
-  return _path.join.call(void 0, _chunkQJLKYYPXjs.sdkCliStateDirPath.call(void 0, _chunkQJLKYYPXjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
+  return _path.join.call(void 0, _chunkY4DPU4OMjs.sdkCliStateDirPath.call(void 0, _chunkY4DPU4OMjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
 }
 function rememberSearchRef(searchRef) {
   try {
@@ -5877,7 +5877,7 @@ var OPTIONAL_COLUMNS = [
 ];
 function renderSearchResults(result, summaryWidth = DEFAULT_SUMMARY_WIDTH) {
   if (result.results.length === 0)
-    return _chunkBHGII2D6js.renderCommandEnvelopeText.call(void 0, result);
+    return _chunk3ACMRZRVjs.renderCommandEnvelopeText.call(void 0, result);
   const rows = result.results.map((item) => searchRow(item, summaryWidth));
   const kinds = new Set(rows.map((row) => row.kind));
   const onlyTools = kinds.size === 1 && kinds.has("tool");
@@ -5902,7 +5902,7 @@ function renderSearchResults(result, summaryWidth = DEFAULT_SUMMARY_WIDTH) {
     actions: _optionalChain([render, 'optionalAccess', _12 => _12.actions])
   };
   const followUps = _optionalChain([remaining, 'access', _13 => _13.sections, 'optionalAccess', _14 => _14.length]) || _optionalChain([remaining, 'access', _15 => _15.actions, 'optionalAccess', _16 => _16.length]) ? `
-${_chunkBHGII2D6js.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
+${_chunk3ACMRZRVjs.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
   const notes = rows.flatMap(
     (row) => row.notes.map((note) => `  ${row.id}: ${note}`)
   );
@@ -5929,7 +5929,7 @@ var SEARCH_TYPES = [
   "prebuilts",
   "custom"
 ];
-var USAGE = "Usage: deepline search [task] [--type <types>] [--categories <categories>] [--search_terms <terms>] [--json]";
+var USAGE = 'Usage: deepline search "<task>" [--type <types>] [--json]';
 function parseTypes(flag, raw) {
   const names = (_nullishCoalesce(raw, () => ( ""))).split(",").map((name) => name.trim().toLowerCase()).filter(Boolean);
   const unknown = names.filter(
@@ -5949,16 +5949,17 @@ function appendCsv(value, previous) {
   return previous ? `${previous},${value}` : value;
 }
 function addSearchOptions(command) {
+  const hidden = (flags) => new (0, _commander.Option)(flags).hideHelp();
   return command.option(
     "--categories <categories>",
-    "Comma-separated tool categories; may be used without a task"
-  ).option(
-    "--search_terms <terms>",
-    "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(
+    "Only tools in these categories, comma-separated"
+  ).addOption(hidden("--search_terms <terms>")).addOption(hidden("--search-terms <terms>")).addOption(hidden("--task <sentence>")).option("--limit <count>", "Results per page, 1-50").option("--offset <count>", "Results to skip, for the next page").option(
     "--summary-width <chars>",
-    `Characters of each description shown in the readable list (default ${DEFAULT_SUMMARY_WIDTH})`
-  ).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");
+    `Description characters per result (default ${DEFAULT_SUMMARY_WIDTH})`
+  ).addOption(hidden("--search-mode <mode>")).addOption(hidden("--include-search-debug")).option("--json", "Print JSON instead of the readable list");
+}
+function asRun(command) {
+  return command.replace(/^deepline (?:tools execute|plays run) /, "deepline run ").replace(/ --watch\b/, "");
 }
 function pointAtDescribe(result) {
   const old = /`deepline (tools|plays) describe [^`]*`/;
@@ -5973,6 +5974,15 @@ function pointAtDescribe(result) {
   const templates = result.commandTemplates;
   for (const template of Object.values(_nullishCoalesce(templates, () => ( {})))) {
     if (template.describe) template.describe = "deepline describe <id>";
+    for (const key of ["execute", "run"]) {
+      if (template[key]) template[key] = asRun(template[key]);
+    }
+  }
+  const results = Array.isArray(result.results) ? result.results : [];
+  for (const item of results) {
+    for (const key of ["executeCommand", "runCommand"]) {
+      if (typeof item[key] === "string") item[key] = asRun(item[key]);
+    }
   }
 }
 async function runSearch(queryInput, options, types, exclude = []) {
@@ -5987,7 +5997,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
     console.error("--summary-width must be an integer of at least 2.");
     return 1;
   }
-  const { search_ref: searchRef, ...result } = await new (0, _chunkVTODQWQAjs.DeeplineClient)().search({
+  const { search_ref: searchRef, ...result } = await new (0, _chunkJF3TLIMQjs.DeeplineClient)().search({
     query,
     types,
     exclude,
@@ -6001,7 +6011,7 @@ async function runSearch(queryInput, options, types, exclude = []) {
   });
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
-  _chunkBHGII2D6js.printCommandEnvelope.call(void 0, result, {
+  _chunk3ACMRZRVjs.printCommandEnvelope.call(void 0, result, {
     json: options.json === true,
     text: renderSearchResults(result, summaryWidth)
   });
@@ -6033,49 +6043,13 @@ function registerSearchCommand(program) {
   addSearchOptions(
     program.command("search [task]").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.
-  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, 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.
-  RATE LIMIT is the tightest request rate Deepline paces the tool at; a dash
-  means none is declared, not that the tool is unlimited.
-
-Examples:
-  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(
       "--type <types>",
-      `Kinds to search, comma-separated or repeated: ${SEARCH_TYPES.join(", ")}`,
+      "Only these kinds, comma-separated: tools, plays, monitors",
       appendCsv
     ).option(
       "--exclude <types>",
-      "Kinds to leave out, comma-separated or repeated; the opposite of --type",
+      "Leave these kinds out, comma-separated",
       appendCsv
     )
   ).action(async (query, options) => {

package/dist/cli/{chunk-MLFR6DVF.mjs → chunk-PHSEINNH.mjs}

@@ -1,19 +1,19 @@
 import {
   npmSupportsAllowScripts,
   readNpmVersion
-} from "./chunk-S4Q2XCGM.mjs";
+} from "./chunk-3KZCFOZ6.mjs";
 import {
   runSkillsCommand
-} from "./chunk-NH6JSJW6.mjs";
+} from "./chunk-V3MEA7NB.mjs";
 import {
   resolveShellSpawn
-} from "./chunk-RZSTT45F.mjs";
+} from "./chunk-S42YIQNE.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-526R2HON.mjs";
+} from "./chunk-NHRWZPWZ.mjs";
 import {
   autoDetectBaseUrl
-} from "./chunk-OMM54B3X.mjs";
+} from "./chunk-D6DXOUTO.mjs";
 
 // src/cli/commands/update.ts
 import { spawn, spawnSync } from "child_process";

package/dist/cli/{chunk-3DNKFH2G.mjs → chunk-PKHVSIJG.mjs}

@@ -1,3 +1,11 @@
+import {
+  PlayClient
+} from "./chunk-UDRPEZ5F.mjs";
+import {
+  HttpClient,
+  resolveConfig
+} from "./chunk-D6DXOUTO.mjs";
+
 // src/plays/local-play-execution.ts
 function importedNodes(graph) {
   const visited = /* @__PURE__ */ new Set();
@@ -127,7 +135,17 @@ async function pinLocalPlayImports(client, graph) {
   return { root, nodes };
 }
 
+// src/plays/client.ts
+function createPlayClient(options) {
+  const config = resolveConfig(options);
+  return new PlayClient(
+    new HttpClient(config),
+    config.environment ?? process.env
+  );
+}
+
 export {
   planLocalPlayExecution,
-  pinLocalPlayImports
+  pinLocalPlayImports,
+  createPlayClient
 };

package/dist/cli/{chunk-WIYWSYDS.mjs → chunk-Q2EIZKVX.mjs}

@@ -9,7 +9,7 @@ var DEEPLINE_GTM_STARTER_PROMPTS = [
     prebuilt: "prebuilt/starter-funded-ai-founders",
     defaultInput: { target_count: 3, days: 30 },
     requiredInputs: [],
-    runCommand: "deepline plays run prebuilt/starter-funded-ai-founders --input '{}' --watch"
+    runCommand: "deepline run prebuilt/starter-funded-ai-founders"
   },
   {
     id: "contact-email-enrichment",
@@ -18,7 +18,7 @@ var DEEPLINE_GTM_STARTER_PROMPTS = [
     prebuilt: "prebuilt/starter-b2b-saas-ctos",
     defaultInput: { target_count: 10 },
     requiredInputs: [],
-    runCommand: "deepline plays run prebuilt/starter-b2b-saas-ctos --input '{}' --watch"
+    runCommand: "deepline run prebuilt/starter-b2b-saas-ctos"
   },
   {
     // Preserve the historical opaque SDK choice ID.
@@ -28,7 +28,7 @@ var DEEPLINE_GTM_STARTER_PROMPTS = [
     prebuilt: "prebuilt/starter-fintech-hiring-growth",
     defaultInput: { target_count: 3 },
     requiredInputs: [],
-    runCommand: "deepline plays run prebuilt/starter-fintech-hiring-growth --input '{}' --watch"
+    runCommand: "deepline run prebuilt/starter-fintech-hiring-growth"
   }
 ];
 var DEEPLINE_GTM_PRIMARY_STARTER_PROMPT = DEEPLINE_GTM_STARTER_PROMPTS[0].prompt;

package/dist/cli/{chunk-VJAEA4CS.js → chunk-QJZ6WNWD.js}

@@ -1,10 +1,10 @@
 "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 _chunkBHGII2D6js = require('./chunk-BHGII2D6.js');
+var _chunk3ACMRZRVjs = require('./chunk-3ACMRZRV.js');
 
 
-var _chunkQJLKYYPXjs = require('./chunk-QJLKYYPX.js');
+var _chunkYT5EODJOjs = require('./chunk-YT5EODJO.js');
 
 // src/cli/commands/sessions.ts
 
@@ -139,7 +139,7 @@ function currentSessionFile(agent) {
   const newestFirst = listSessionFiles(agent).sort(
     (a, b) => b.mtimeMs - a.mtimeMs
   );
-  const sessionId = _chunkQJLKYYPXjs.agentSessionIdFromEnvironment.call(void 0, 
+  const sessionId = _chunkYT5EODJOjs.agentSessionIdFromEnvironment.call(void 0, 
     process.env,
     agent === "auto" ? void 0 : agent === "claude" ? "claude_code" : "codex"
   );
@@ -451,7 +451,7 @@ function buildSessionUploadContent(raw) {
   return { encodedContent: encoded, needsChunking: true };
 }
 async function uploadPayload(path, payload) {
-  const { http } = _chunkBHGII2D6js.getAuthedHttpClient.call(void 0, );
+  const { http } = _chunk3ACMRZRVjs.getAuthedHttpClient.call(void 0, );
   return await http.post(path, payload);
 }
 async function uploadChunkedSessions(sessions, options) {
@@ -484,7 +484,7 @@ async function uploadChunkedSessions(sessions, options) {
     ...options.rating ? { rating: options.rating } : {}
   });
   const sessionIds = sessions.map((session) => session.sessionId);
-  _chunkBHGII2D6js.printCommandEnvelope.call(void 0, 
+  _chunk3ACMRZRVjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -516,7 +516,7 @@ async function handleSessionsSend(options) {
       filename: _path.basename.call(void 0, filePath),
       ...rating ? { rating } : {}
     });
-    _chunkBHGII2D6js.printCommandEnvelope.call(void 0, 
+    _chunk3ACMRZRVjs.printCommandEnvelope.call(void 0, 
       {
         ...response2,
         ok: true,
@@ -566,7 +566,7 @@ async function handleSessionsSend(options) {
     ...rating ? { rating } : {}
   });
   const sessionIds = built.map((session) => session.sessionId);
-  _chunkBHGII2D6js.printCommandEnvelope.call(void 0, 
+  _chunk3ACMRZRVjs.printCommandEnvelope.call(void 0, 
     {
       ...response,
       ok: true,
@@ -674,7 +674,7 @@ ${refreshMeta}
 </body>
 </html>`;
   _fs.writeFileSync.call(void 0, outputPath, html, "utf8");
-  _chunkBHGII2D6js.printCommandEnvelope.call(void 0, 
+  _chunk3ACMRZRVjs.printCommandEnvelope.call(void 0, 
     {
       ok: true,
       file: outputPath,

package/dist/cli/{chunk-EIMG75BT.mjs → chunk-S3A4IXBQ.mjs}

@@ -3,8 +3,8 @@ var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the col
 
 // src/plays/input-example.ts
 function playInputExampleArgs(schema) {
-  if (!schema) return " --input '@<input.json>'";
-  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
+  if (!schema) return " --input-file <input.json>";
+  if (schema.$ref || schema.allOf) return " --input-file <input.json>";
   const csv = schema.csvInput;
   const csvField = typeof csv?.inputField === "string" ? csv.inputField : null;
   const required = Array.isArray(schema.required) ? schema.required : [];
@@ -16,14 +16,13 @@ function playInputExampleArgs(schema) {
     return Array.isArray(keys) && keys.includes(csvField) && keys.every((key) => key === csvField);
   });
   if (csvField && csvOnlyRequired && (!alternatives || hasCsvAlternative)) {
-    if (csvField === "csv") return " --csv '<contacts.csv>'";
     const value = JSON.stringify({ [csvField]: "<contacts.csv>" });
     return ` --input '${value.replace(/'/g, "'\\''")}'`;
   }
   if (Array.isArray(schema.required) && !required.length && !csv && !alternatives) {
     return "";
   }
-  return " --input '@<input.json>'";
+  return " --input-file <input.json>";
 }
 
 // src/plays/play-description.ts
@@ -70,7 +69,7 @@ function describePlayListItem(play, options = {}) {
   const csvInput = schemaMetadata(play.inputSchema, "csvInput");
   const rowOutputSchema = schemaMetadata(play.outputSchema, "rowOutputSchema");
   const description = play.description?.trim() || play.currentRevision?.description?.trim() || play.liveRevision?.description?.trim() || null;
-  const runCommand = `deepline plays run ${play.reference || play.name}${playInputExampleArgs(play.inputSchema)}`;
+  const runCommand = `deepline run ${play.reference || play.name}${playInputExampleArgs(play.inputSchema)}`;
   const starter = cloneEditStarter(play);
   return {
     name: play.name,

package/dist/cli/{chunk-RZSTT45F.mjs → chunk-S42YIQNE.mjs}

@@ -1,15 +1,10 @@
 import {
   getActiveCliProgress
-} from "./chunk-OJ6RUKVT.mjs";
+} from "./chunk-ZUK6LIJB.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
-  SDK_API_CONTRACT,
-  SDK_API_MAJOR,
-  SDK_VERSION,
   autoDetectBaseUrl,
-  deploymentProtectionHeaders,
-  detectAgentRuntime,
   hasActivePluginSkills,
   readSdkSkillsLocalVersion,
   resolveApiKeyForBaseUrl,
@@ -17,13 +12,21 @@ import {
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-OMM54B3X.mjs";
+} from "./chunk-D6DXOUTO.mjs";
+import {
+  SDK_API_CONTRACT,
+  SDK_API_MAJOR,
+  SDK_VERSION,
+  agentSessionIdFromEnvironment,
+  deploymentProtectionHeaders,
+  detectAgentRuntime
+} from "./chunk-6RNQGWFD.mjs";
 import {
   DeeplineError
 } from "./chunk-HBL4PM5Q.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-EJGBLXDZ.mjs";
+} from "./chunk-XZAFIOUQ.mjs";
 
 // src/compat.ts
 import { randomUUID } from "crypto";
@@ -614,8 +617,10 @@ function buildEnvironmentContext() {
   return context;
 }
 function failureReportHeaders(apiKey) {
+  const agentSessionId = agentSessionIdFromEnvironment();
   return {
     ...deploymentProtectionHeaders(),
+    ...agentSessionId ? { "X-Deepline-Agent-Session-Id": agentSessionId } : {},
     Authorization: `Bearer ${apiKey}`,
     "Content-Type": "application/json",
     "User-Agent": `deepline-ts-sdk/${SDK_VERSION}`,

package/dist/cli/{chunk-YULBYKAK.mjs → chunk-S6UAJR6V.mjs}

@@ -2,10 +2,10 @@ import {
   getAuthedHttpClient,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-526R2HON.mjs";
+} from "./chunk-NHRWZPWZ.mjs";
 import {
   resolveBaseUrlOnly
-} from "./chunk-OMM54B3X.mjs";
+} from "./chunk-D6DXOUTO.mjs";
 
 // src/cli/commands/git.ts
 function shellQuote(value) {
@@ -399,7 +399,7 @@ async function handleDeploymentCancel(id, options) {
             title: payload.cancelled ? "cancelled" : "already cancelled",
             lines: [
               payload.deployment ? renderDeployment(payload.deployment) : `Deployment ${id} cancelled.`,
-              "The build stops at its next step and nothing from it goes live."
+              "The build stops at its next step. Completed Monitor changes remain in effect. Inspect the deployment and Monitor Jobs before retrying."
             ]
           }
         ]

package/dist/cli/{chunk-G7L27KZB.mjs → chunk-TKAQR3IB.mjs}

@@ -3,7 +3,7 @@ import {
   formatModelDescription,
   publicToolSchemas,
   toolMetadataJsonForDescribe
-} from "./chunk-SLEUWLJE.mjs";
+} from "./chunk-MSY22NQW.mjs";
 import {
   buildPlayDashboardUrl,
   byokLines,
@@ -13,7 +13,7 @@ import {
   examples,
   schemaLines,
   topLevelField
-} from "./chunk-HDFRJ4IT.mjs";
+} from "./chunk-JVHOS3K3.mjs";
 import {
   DeeplineError
 } from "./chunk-HBL4PM5Q.mjs";
@@ -88,6 +88,7 @@ var FILTER_OF = {
   prebuilt_play: "prebuilts",
   custom_play: "custom"
 };
+var DEEPLINE_NAMESPACE = "deepline/";
 async function found(lookup) {
   try {
     return await lookup;
@@ -106,46 +107,49 @@ function describeLookupsFor(client) {
     baseUrl: client.baseUrl
   };
 }
-async function describeName(name, options, lookups) {
-  const maintainedOnly = options.prebuilt === true || options.tool === true;
+async function findNamed(reference, options, lookups) {
+  const deeplineOwned = reference.startsWith(DEEPLINE_NAMESPACE);
+  const name = deeplineOwned ? reference.slice(DEEPLINE_NAMESPACE.length) : reference;
+  const maintainedOnly = deeplineOwned || options.prebuilt === true || options.tool === true;
   const wants = (filter) => (!options.kinds || options.kinds.includes(filter)) && !(maintainedOnly && filter === "custom");
-  const play = async (reference) => {
-    const record2 = await lookups.play(reference);
-    if (!record2) return null;
+  const play = async (reference2) => {
+    const record = await lookups.play(reference2);
+    if (!record) return null;
     return {
-      described: describedPlay(record2),
-      record: { ...record2 },
+      described: describedPlay(record),
+      record: { ...record },
       schemas: {
-        inputSchema: record2.inputSchema ?? null,
-        outputSchema: record2.outputSchema ?? null
+        inputSchema: record.inputSchema ?? null,
+        outputSchema: record.outputSchema ?? null
       }
     };
   };
   const tool = async () => {
-    const record2 = await lookups.tool(name);
-    if (!record2) return null;
-    const { byok } = record2;
-    const features = toolFeatures(record2);
+    const record = await lookups.tool(name);
+    if (!record) return null;
+    const { byok } = record;
+    const features = toolFeatures(record);
     return {
       described: {
-        ...describedTool(record2, name),
+        ...describedTool(record, name),
         // Shown when the tool runs only on your own credentials; otherwise
         // it is a feature, described with --feature byok.
         ...byok?.required === true ? { byok } : {},
         ...features.length ? { features: features.map(({ view: _view, ...feature }) => feature) } : {}
       },
       record: toolMetadataJsonForDescribe(
-        record2,
+        record,
         name,
         lookups.seedStarterScript
       ),
-      schemas: publicToolSchemas(record2),
+      schemas: publicToolSchemas(record),
       feature: (featureName, value) => {
         const feature = features.find(({ name: name2 }) => name2 === featureName);
-        return feature ? describeFeature(record2, feature, value, {
+        return feature ? describeFeature(record, feature, value, {
           describeModel: (model) => lookups.describeModel(model)
         }) : null;
-      }
+      },
+      tool: record
     };
   };
   const sources = name.includes("/") ? [{ kinds: ["prebuilts", "custom"], find: () => play(name) }] : [
@@ -161,11 +165,15 @@ async function describeName(name, options, lookups) {
     })
   );
   const [chosen, shadowed] = matches.filter((match) => match !== null);
+  return { chosen, shadowed };
+}
+async function describeName(name, options, lookups) {
+  const { chosen, shadowed } = await findNamed(name, options, lookups);
   if (!chosen) return { status: "missing" };
   const { described, record } = chosen;
   const shadows = described.kind === "custom_play" && shadowed ? {
     kind: shadowed.described.kind,
-    describeCommand: `deepline describe ${name} --prebuilt`
+    describeCommand: `deepline describe ${DEEPLINE_NAMESPACE}${name}`
   } : null;
   const note = shadows ? `Showing your workspace play "${name}". It has the same name as a Deepline ${shadows.kind.replace("_", " ")}; see that one with: ${shadows.describeCommand}` : null;
   const verbose = options.verbose === true;
@@ -281,6 +289,8 @@ async function describeName(name, options, lookups) {
 }
 
 export {
+  DEEPLINE_NAMESPACE,
   describeLookupsFor,
+  findNamed,
   describeName
 };

package/dist/cli/{chunk-QWRHGGUH.js → chunk-UAJFWWZE.js}

@@ -1,4 +1,12 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/plays/local-play-execution.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkBGTPIMSMjs = require('./chunk-BGTPIMSM.js');
+
+
+
+var _chunkY4DPU4OMjs = require('./chunk-Y4DPU4OM.js');
+
+// src/plays/local-play-execution.ts
 function importedNodes(graph) {
   const visited = /* @__PURE__ */ new Set();
   const visiting = /* @__PURE__ */ new Set();
@@ -127,7 +135,17 @@ async function pinLocalPlayImports(client, graph) {
   return { root, nodes };
 }
 
+// src/plays/client.ts
+function createPlayClient(options) {
+  const config = _chunkY4DPU4OMjs.resolveConfig.call(void 0, options);
+  return new (0, _chunkBGTPIMSMjs.PlayClient)(
+    new (0, _chunkY4DPU4OMjs.HttpClient)(config),
+    _nullishCoalesce(config.environment, () => ( process.env))
+  );
+}
+
+
 
 
 
-exports.planLocalPlayExecution = planLocalPlayExecution; exports.pinLocalPlayImports = pinLocalPlayImports;
+exports.planLocalPlayExecution = planLocalPlayExecution; exports.pinLocalPlayImports = pinLocalPlayImports; exports.createPlayClient = createPlayClient;