deepline 0.3.394 → 0.3.396

package/dist/cli/{chunk-QIQBYKLB.js → chunk-ME6XRFLY.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 _chunkMLPU5SMZjs = require('./chunk-MLPU5SMZ.js');
+var _chunkDC6LTULTjs = require('./chunk-DC6LTULT.js');
 
 
 
-var _chunk4P27AXEAjs = require('./chunk-4P27AXEA.js');
+var _chunkRMTASUAKjs = require('./chunk-RMTASUAK.js');
 
 
-var _chunkKGNTKMRGjs = require('./chunk-KGNTKMRG.js');
+var _chunkRTO5QZWTjs = require('./chunk-RTO5QZWT.js');
 
 
-var _chunkCS6RAIVYjs = require('./chunk-CS6RAIVY.js');
+var _chunkV7UP2F4Ujs = require('./chunk-V7UP2F4U.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 = _chunk4P27AXEAjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
+    const plan = _chunkRMTASUAKjs.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 ? _chunkMLPU5SMZjs.readNpmVersion.call(void 0, env) : options.npmVersion;
-  const npmGlobalInstallFlags = _chunkMLPU5SMZjs.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
+  const npmVersion = options.npmVersion === void 0 ? _chunkDC6LTULTjs.readNpmVersion.call(void 0, env) : options.npmVersion;
+  const npmGlobalInstallFlags = _chunkDC6LTULTjs.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()]) || _chunkCS6RAIVYjs.autoDetectBaseUrl.call(void 0, )
+    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunkV7UP2F4Ujs.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 = _chunk4P27AXEAjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
+    const plan = _chunkRMTASUAKjs.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, () => ( _chunkCS6RAIVYjs.autoDetectBaseUrl));
+  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunkV7UP2F4Ujs.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 _chunk4P27AXEAjs.runSkillsCommand.call(void 0, { json: true });
+      const exitCode = await _chunkRMTASUAKjs.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) {
-    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
     return 0;
   }
   if (options.printCommand) {
-    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
       {
         ...plan,
         render: {
@@ -1174,7 +1174,7 @@ async function runUpdateCommand(options, dependencies = {}) {
     return 0;
   }
   if (plan.kind === "source" || plan.kind === "homebrew") {
-    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
+    _chunkRTO5QZWTjs.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
     );
   }
   if (options.executeWithJson && options.json) {
-    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
+    _chunkRTO5QZWTjs.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         pinnedVersion

package/dist/cli/{chunk-JHIJIHFB.mjs → chunk-MR6XCBQJ.mjs}

@@ -14,6 +14,10 @@ import {
   stagePlayFiles,
   startPlayRun
 } from "./chunk-JI2B4RZP.mjs";
+import {
+  describePlayDetail,
+  describePlayListItem
+} from "./chunk-EIMG75BT.mjs";
 import {
   COORDINATOR_INTERNAL_TOKEN_HEADER,
   CustomerDbQueryOutcomeUnknownError,
@@ -21,7 +25,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-VE3U3SQC.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,
@@ -29,9 +33,6 @@ import {
   ToolExecutionError
 } from "./chunk-NXGCO4JB.mjs";
 
-// src/csv-header-matching.ts
-var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
-
 // src/pagination.ts
 async function* iterateCursorPages(fetchPage) {
   let cursor = null;
@@ -1835,31 +1836,6 @@ function playTriggerConfigPath(playName) {
   return `/api/v2/plays/${encodeURIComponent(playName)}/triggers`;
 }
 
-// src/plays/input-example.ts
-function playInputExampleArgs(schema) {
-  if (!schema) return " --input '@<input.json>'";
-  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
-  const csv = schema.csvInput;
-  const csvField = typeof csv?.inputField === "string" ? csv.inputField : null;
-  const required = Array.isArray(schema.required) ? schema.required : [];
-  const csvOnlyRequired = required.every((key) => key === csvField);
-  const alternatives = schema.oneOf ?? schema.anyOf;
-  const hasCsvAlternative = Array.isArray(alternatives) && alternatives.some((branch) => {
-    if (!branch || typeof branch !== "object") return false;
-    const keys = branch.required;
-    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>'";
-}
-
 // ../product-notifications/configuration.ts
 var PRODUCT_NOTIFICATION_EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function normalizeProductNotificationEmail(value) {
@@ -3365,101 +3341,6 @@ var DeeplineClient = class _DeeplineClient {
   get baseUrl() {
     return this.config.baseUrl;
   }
-  compactSchema(schema) {
-    if (!schema) return null;
-    const fields = 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 fields.length > 0 ? { fields } : schema;
-  }
-  schemaMetadata(schema, key) {
-    if (!isRecord2(schema)) return null;
-    const value = schema[key];
-    return isRecord2(value) ? value : null;
-  }
-  playRunCommand(play) {
-    const target = play.reference || play.name;
-    return `deepline plays run ${target}${playInputExampleArgs(play.inputSchema)}`;
-  }
-  starterPlayPath(play) {
-    const target = play.reference || play.name;
-    const unqualifiedName = target.split("/").pop() || play.name;
-    const safeName = unqualifiedName.trim().toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-    return `./${safeName || "play"}.play.ts`;
-  }
-  playCloneEditStarter(play) {
-    const readonlyPrebuilt = (play.origin === "prebuilt" || play.ownerType === "deepline") && !play.canEdit;
-    if (!play.canClone && !readonlyPrebuilt) return void 0;
-    const target = play.reference || play.name;
-    const path = this.starterPlayPath(play);
-    return {
-      path,
-      command: `deepline plays get ${target} --source --out ${path}`,
-      checkCommand: `deepline plays check ${path}`
-    };
-  }
-  summarizePlayListItem(play, options) {
-    const aliases = play.aliases?.length ? play.aliases : [play.name];
-    const csvInput = this.schemaMetadata(play.inputSchema, "csvInput");
-    const rowOutputSchema = this.schemaMetadata(
-      play.outputSchema,
-      "rowOutputSchema"
-    );
-    const description = play.description?.trim() || play.currentRevision?.description?.trim() || play.liveRevision?.description?.trim() || null;
-    const runCommand = this.playRunCommand(play);
-    const cloneEditStarter = this.playCloneEditStarter(play);
-    return {
-      name: play.name,
-      // playKey and triggerStatus were projected away here, so `describe`
-      // was strictly less informative than `plays list` for the same play — no
-      // stable key, and no way to see that a cron was armed.
-      ...play.playKey ? { playKey: play.playKey } : {},
-      ...play.reference ? { reference: play.reference } : {},
-      ...play.displayName ? { displayName: play.displayName } : {},
-      ...description ? { description } : {},
-      ...play.guidance ? { guidance: play.guidance } : {},
-      pinned: Boolean(play.pinned),
-      toolCategories: play.toolCategories ?? [],
-      origin: play.origin,
-      ownerType: play.ownerType,
-      canEdit: play.canEdit,
-      canClone: play.canClone,
-      aliases,
-      inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
-      outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
-      staticPipeline: isRecord2(play.staticPipeline) ? play.staticPipeline : isRecord2(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord2(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
-      ...csvInput ? {
-        csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
-      } : {},
-      ...rowOutputSchema ? { rowOutputSchema } : {},
-      runCommand,
-      examples: [runCommand],
-      ...cloneEditStarter ? { cloneEditStarter } : {},
-      currentPublishedVersion: play.currentPublishedVersion ?? null,
-      // Read the live version off the live revision. It was previously only
-      // ever written by the publish/live routes, so every list and describe
-      // payload reported liveVersion: null even for an actively serving play.
-      liveVersion: play.liveRevision?.version ?? null,
-      ...play.triggerStatus ? { triggerStatus: play.triggerStatus } : {},
-      isDraftDirty: play.isDraftDirty
-    };
-  }
-  summarizePlayDetail(detail, options) {
-    const play = detail.play;
-    return {
-      ...this.summarizePlayListItem(play, options),
-      currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
-      ...play.triggerMetadata ? { triggerMetadata: play.triggerMetadata } : {},
-      ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
-      ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {},
-      ...play.observedCost ? { observedCost: play.observedCost } : {}
-    };
-  }
   // ——————————————————————————————————————————————————————————
   // Secrets
   // ——————————————————————————————————————————————————————————
@@ -5369,7 +5250,7 @@ var DeeplineClient = class _DeeplineClient {
       }
     );
     const plays = (response.plays ?? []).map(
-      (play) => this.summarizePlayListItem(play, options)
+      (play) => describePlayListItem(play, { ...options, pipeline: true })
     );
     if (scope === "prebuilt") {
       return plays.filter(isPrebuiltPlayDescription);
@@ -5421,11 +5302,24 @@ var DeeplineClient = class _DeeplineClient {
    * Get a normalized play description suitable for agents and CLIs.
    *
    * The description includes runnable examples, input/output summaries, clone
-   * guidance, revision state, and latest run metadata when available.
+   * guidance, revision state, and latest run metadata when available. Pass
+   * `{ pipeline: true }` to include the compiled pipeline, which can be
+   * hundreds of kilobytes and is otherwise left out.
    */
-  async describePlay(name, options) {
-    const detail = await this.getPlay(name, { guidance: true });
-    return this.summarizePlayDetail(detail, options);
+  async describePlay(name, options = {}) {
+    if (options.pipeline) {
+      return describePlayDetail(
+        await this.getPlay(name, { guidance: true }),
+        options
+      );
+    }
+    const params = new URLSearchParams({
+      include: "guidance",
+      view: "description",
+      ...options.compact ? { compact: "1" } : {}
+    });
+    const body = await this.http.get(`/api/v2/plays/${encodeURIComponent(name)}?${params.toString()}`);
+    return "description" in body ? body.description : describePlayDetail(body, options);
   }
   /**
    * Clear run history and durable sheet/result data for a play without deleting
@@ -6596,9 +6490,7 @@ var DeeplineClient = class _DeeplineClient {
 };
 
 export {
-  CSV_HEADER_MATCHING_NOTE,
   iterateCursorPages,
-  playInputExampleArgs,
   requireBillingIdempotencyKey,
   planCustomerDbQuery,
   validateExecutionIdempotencyKey,

package/dist/cli/{chunk-TJI2EN6K.mjs → chunk-NHB5YUCS.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.394",
+  version: "0.3.396",
   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,

package/dist/cli/{chunk-ZMVJSS6N.js → chunk-NSOTASOP.js}

@@ -2,6 +2,9 @@
 
 var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
+
+var _chunkKXMNM4AQjs = require('./chunk-KXMNM4AQ.js');
+
 // src/cli/described.ts
 var SHAPE = "{}";
 var RECORD = "Record<string, ";
@@ -617,42 +620,66 @@ function describedJson(described, view) {
     ...hidden.length ? { hidden } : {}
   };
 }
-
-// src/cli/execution-observation.ts
-var _fs = require('fs');
-function writeObservation(observation) {
-  const path = process.env.DEEPLINE_EXECUTION_OBSERVATION_PATH;
-  const invocationId = process.env.DEEPLINE_EXECUTION_OBSERVATION_ID;
-  if (!path || !invocationId) return;
-  const pending = `${path}.pending`;
-  _fs.writeFileSync.call(void 0, 
-    pending,
-    JSON.stringify({
-      schema_version: 1,
-      invocation_id: invocationId,
-      ...observation
-    }),
-    { mode: 384 }
-  );
-  _fs.renameSync.call(void 0, pending, path);
-}
-function recordApiResponse(observation) {
-  writeObservation({
-    kind: "api_response",
-    received_at_ms: observation.receivedAtMs,
-    state: observation.state,
-    http_status: observation.httpStatus
-  });
+function buildPlayDashboardUrl(baseUrl, playName) {
+  const trimmedBase = baseUrl.replace(/\/$/, "");
+  const encodedPlayName = encodeURIComponent(playName);
+  return `${trimmedBase}/dashboard/plays/${encodedPlayName}`;
 }
-function recordPlayTermination(run) {
-  if (typeof run.id !== "string" || !["completed", "failed", "cancelled", "canceled"].includes(
-    String(run.status)
-  ) || typeof run.finishedAt !== "number" || !Number.isSafeInteger(run.finishedAt) || run.finishedAt <= 0)
-    return;
-  writeObservation({
-    kind: "play_terminal",
-    run: { id: run.id, status: run.status, finishedAt: run.finishedAt }
+function describedPlay(play) {
+  const reference = play.reference || play.name;
+  const starter = _nullishCoalesce(play.cloneEditStarter, () => ( _chunkKXMNM4AQjs.cloneEditStarter.call(void 0, play)));
+  const csv = _nullishCoalesce(play.csvInput, () => ( {}));
+  const csvField = typeof csv.inputField === "string" ? csv.inputField : "csv";
+  const alongside = /* @__PURE__ */ new Set([
+    csvField,
+    "columns",
+    ...Array.isArray(csv.runLevelControlFields) ? csv.runLevelControlFields.map(String) : []
+  ]);
+  const declared = schemaFields(play.inputSchema).map((field) => field.name);
+  const rowNames = schemaFields(csv.rowInputSchema).map((field) => field.name);
+  const replaced = play.csvInput ? (rowNames.length > 0 ? rowNames : declared).filter(
+    (name) => declared.includes(name) && !alongside.has(name)
+  ) : [];
+  const exclusive = replaced.length ? { field: csvField, with: replaced } : void 0;
+  const headers = isRecord(csv.defaultColumns) ? csv.defaultColumns : {};
+  const rowInputs = schemaFields(csv.rowInputSchema).map((field) => {
+    const header = [headers[field.name]].flat().filter((name) => name && name !== field.name).join(" or ");
+    return header ? {
+      ...field,
+      description: [field.description, `CSV header: ${header}`].filter(Boolean).join(" - ")
+    } : field;
   });
+  const rowOutput = _nullishCoalesce(play.rowOutputSchema, () => ( {}));
+  const added = isRecord(rowOutput.addedColumns) ? rowOutput.addedColumns : {};
+  const rowOutputs = schemaFields(
+    Object.keys(added).length ? { properties: added } : rowOutput
+  ).map((field) => ({ ...field, required: true }));
+  return {
+    kind: play.ownerType === "deepline" ? "prebuilt_play" : "custom_play",
+    id: reference,
+    ...play.displayName && play.displayName !== play.name ? { displayName: play.displayName } : {},
+    ...play.description ? { description: play.description } : {},
+    ...play.observedCost ? { cost: play.observedCost.displayText } : {},
+    guidance: [],
+    inputs: schemaFields(play.inputSchema),
+    outputs: schemaFields(play.outputSchema),
+    ...rowInputs.length ? { rowInputs } : {},
+    ...typeof csv.inputField === "string" ? { csvInput: csv.inputField } : {},
+    ...rowOutputs.length ? {
+      rowOutputs,
+      rowOutputsAddToSource: Object.keys(added).length > 0 || rowOutput.preservesSourceColumns === true
+    } : {},
+    runner: {
+      via: "play",
+      reference,
+      // A CSV play's run command is built by the server around its columns.
+      ...play.csvInput ? { cli: play.runCommand } : {}
+    },
+    ...starter ? { source: starter.command } : {},
+    ...exclusive ? { exclusive } : {},
+    // A prebuilt's cost is what its recent runs were charged; there is no rate.
+    ..._optionalChain([play, 'access', _12 => _12.observedCost, 'optionalAccess', _13 => _13.displayText]) ? { cost: play.observedCost.displayText } : {}
+  };
 }
 
 // src/cli/describe-options.ts
@@ -697,6 +724,45 @@ function addDescribeOptions(command, options = {}) {
   return command;
 }
 
+// src/cli/execution-observation.ts
+var _fs = require('fs');
+function writeObservation(observation) {
+  const path = process.env.DEEPLINE_EXECUTION_OBSERVATION_PATH;
+  const invocationId = process.env.DEEPLINE_EXECUTION_OBSERVATION_ID;
+  if (!path || !invocationId) return;
+  const pending = `${path}.pending`;
+  _fs.writeFileSync.call(void 0, 
+    pending,
+    JSON.stringify({
+      schema_version: 1,
+      invocation_id: invocationId,
+      ...observation
+    }),
+    { mode: 384 }
+  );
+  _fs.renameSync.call(void 0, pending, path);
+}
+function recordApiResponse(observation) {
+  writeObservation({
+    kind: "api_response",
+    received_at_ms: observation.receivedAtMs,
+    state: observation.state,
+    http_status: observation.httpStatus
+  });
+}
+function recordPlayTermination(run) {
+  if (typeof run.id !== "string" || !["completed", "failed", "cancelled", "canceled"].includes(
+    String(run.status)
+  ) || typeof run.finishedAt !== "number" || !Number.isSafeInteger(run.finishedAt) || run.finishedAt <= 0)
+    return;
+  writeObservation({
+    kind: "play_terminal",
+    run: { id: run.id, status: run.status, finishedAt: run.finishedAt }
+  });
+}
+
+
+
 
 
 
@@ -711,4 +777,4 @@ function addDescribeOptions(command, options = {}) {
 
 
 
-exports.byokLines = byokLines; exports.SCHEMA_LINE_LIMIT = SCHEMA_LINE_LIMIT; exports.schemaField = schemaField; exports.schemaFields = schemaFields; exports.rateLimitSummary = rateLimitSummary; exports.schemaLines = schemaLines; exports.examples = examples; exports.describedLines = describedLines; exports.topLevelField = topLevelField; exports.describedJson = describedJson; exports.recordApiResponse = recordApiResponse; exports.recordPlayTermination = recordPlayTermination; exports.addDescribeOptions = addDescribeOptions;
+exports.byokLines = byokLines; exports.SCHEMA_LINE_LIMIT = SCHEMA_LINE_LIMIT; exports.schemaField = schemaField; exports.schemaFields = schemaFields; exports.rateLimitSummary = rateLimitSummary; exports.schemaLines = schemaLines; exports.examples = examples; exports.describedLines = describedLines; exports.topLevelField = topLevelField; exports.describedJson = describedJson; exports.buildPlayDashboardUrl = buildPlayDashboardUrl; exports.describedPlay = describedPlay; exports.addDescribeOptions = addDescribeOptions; exports.recordApiResponse = recordApiResponse; exports.recordPlayTermination = recordPlayTermination;

package/dist/cli/{chunk-ZYBGA4AR.mjs → chunk-QHGPA362.mjs}

@@ -1,14 +1,14 @@
 import {
   DeeplineClient
-} from "./chunk-JHIJIHFB.mjs";
+} from "./chunk-MR6XCBQJ.mjs";
 import {
   printCommandEnvelope,
   renderCommandEnvelopeText
-} from "./chunk-NR3DFKNF.mjs";
+} from "./chunk-XKZXO7D3.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-VE3U3SQC.mjs";
 
 // src/cli/commands/search.ts
 import { Option } from "commander";
@@ -238,6 +238,11 @@ function rateLimitDisplay(item) {
   );
   return tightest ? `${tightest.requestsPerWindow}/${RATE_WINDOW_UNITS[tightest.windowMs] ?? `${tightest.windowMs / 1e3}s`}` : "\u2014";
 }
+function failureRateDisplay(rate) {
+  if (typeof rate !== "number") return "\u2014";
+  const percent = Math.round(rate * 100);
+  return percent === 0 && rate > 0 ? "<1%" : `${percent}%`;
+}
 function searchRow(item) {
   const { cost, notes } = pricingDisplay(item);
   const observedMax = item.billingSource === "own_provider_credentials" ? "" : observedMaxText(item.pricing);
@@ -253,6 +258,9 @@ function searchRow(item) {
     kind: item.kind,
     cost,
     rateLimit: rateLimitDisplay(item),
+    // Production share of errored or rate-limited calls; absent when too few
+    // calls or orgs used the tool to say.
+    failureRate: failureRateDisplay(item.failureRate),
     summary: clipSummary(item.description ?? ""),
     notes
   };
@@ -274,6 +282,13 @@ function renderSearchResults(result) {
         alignment: "right"
       }
     ] : [],
+    ...rows.some((row) => row.failureRate !== "\u2014") ? [
+      {
+        header: "FAILURES",
+        value: (row) => row.failureRate,
+        alignment: "right"
+      }
+    ] : [],
     { header: "SUMMARY", value: (row) => row.summary }
   ];
   const render = result.render;