deepline 0.3.195 → 0.3.196

package/dist/cli/index.js

@@ -3051,7 +3051,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.195",
+  version: "0.3.196",
   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
@@ -9111,6 +9111,12 @@ var DeeplineClient = class _DeeplineClient {
     if (options?.categories || options?.includeToolCategories) {
       params.set("include_tool_categories", "1");
     }
+    if (options?.tags) {
+      params.set(
+        "tags",
+        Array.isArray(options.tags) ? options.tags.join(",") : options.tags
+      );
+    }
     if (options?.includeArchived) params.set("include_archived", "1");
     if (options?.includeCostEstimates) {
       params.set("include_cost_estimates", "1");
@@ -29385,12 +29391,35 @@ function formatPlayCostEstimate(estimate) {
   const source = estimate.source === "observed" ? `observed from ${estimate.sampleRunCount} ${estimate.sampleRunCount === 1 ? "run" : "runs"}` : "static estimate";
   return `${credits} Deepline credits per ${unit} (${source})`;
 }
+var PREBUILT_PLAY_TAG_KEYS = [
+  "smb",
+  "find-prospects",
+  "qualify",
+  "contact-info",
+  "signals"
+];
 async function handlePlayList(args) {
   const jsonOutput = argsWantJson(args);
   const showCost = args.includes("--show-cost");
   const client2 = new DeeplineClient();
   const categoriesIndex = args.indexOf("--categories");
   const categories = categoriesIndex >= 0 ? args[categoriesIndex + 1]?.trim() : void 0;
+  const tags = args.flatMap((arg, index) => arg === "--tag" ? [args[index + 1]] : []).flatMap((value) => (value ?? "").split(",")).map((value) => value.trim()).filter(Boolean);
+  if (args.includes("--tag") && tags.length === 0) {
+    console.error(
+      `Pass a tag after --tag. Known tags: ${PREBUILT_PLAY_TAG_KEYS.join(", ")}.`
+    );
+    return 2;
+  }
+  const unknownTags = tags.filter(
+    (tag) => !PREBUILT_PLAY_TAG_KEYS.includes(tag)
+  );
+  if (unknownTags.length > 0) {
+    console.error(
+      `Unknown play tag: ${unknownTags.join(", ")}. Known tags: ${PREBUILT_PLAY_TAG_KEYS.join(", ")}.`
+    );
+    return 2;
+  }
   const limitIndex = args.indexOf("--limit");
   const cursorIndex = args.indexOf("--cursor");
   const limit = limitIndex >= 0 ? Number(args[limitIndex + 1]) : void 0;
@@ -29401,13 +29430,20 @@ async function handlePlayList(args) {
   }
   const page = await client2.listPlaysPage({
     categories,
+    ...tags.length > 0 ? { tags } : {},
     includeToolCategories: true,
     ...showCost ? { includeCostEstimates: true } : {},
     limit,
     cursor
   });
   const plays = page.plays;
-  const nextPage = page.hasMore && page.cursor ? `deepline plays list${categories ? ` --categories ${shellQuote3(categories)}` : ""}${limit ? ` --limit ${limit}` : ""}${showCost ? " --show-cost" : ""} --cursor ${shellQuote3(page.cursor)} --json` : null;
+  if (tags.length > 0 && plays.length > 0 && plays.every((play) => play.tags === void 0)) {
+    console.error(
+      "This Deepline server does not support --tag and returned unfiltered results. Update the server, or filter with --categories."
+    );
+    return 1;
+  }
+  const nextPage = page.hasMore && page.cursor ? `deepline plays list${categories ? ` --categories ${shellQuote3(categories)}` : ""}${tags.map((tag) => ` --tag ${shellQuote3(tag)}`).join("")}${limit ? ` --limit ${limit}` : ""}${showCost ? " --show-cost" : ""} --cursor ${shellQuote3(page.cursor)} --json` : null;
   if (page.hasMore && !nextPage) {
     throw new Error(
       "Play list reported more results without a continuation cursor"
@@ -29417,6 +29453,7 @@ async function handlePlayList(args) {
   for (const play of plays) {
     const flags = [
       play.pinned ? "pinned" : null,
+      ...(play.tags ?? []).map((tag) => `tag:${tag}`),
       ...(play.toolCategories ?? []).map((category) => `category:${category}`),
       play.origin === "prebuilt" || play.ownerType === "deepline" ? "prebuilt" : "owned",
       play.canEdit ? "editable" : "readonly",
@@ -30536,19 +30573,28 @@ Notes:
   is_truncated, next_cursor, and a next-page command. Use --limit to choose
   the page size and --cursor to continue with the same filters.
 
+  --tag filters by the job a prebuilt play does; --categories filters by the
+  tools it calls. Known tags: smb, find-prospects, qualify, contact-info,
+  signals. Repeat --tag or pass a comma-separated list to widen the result.
+
 Examples:
   deepline plays list
+  deepline plays list --tag smb --json
   deepline plays search email --json
 `
   ).option("--limit <count>", "Page size").option("--cursor <cursor>", "Continue a previous page").option("--show-cost", "Include the per-row or per-run cost estimate").option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
     "--categories <categories>",
     "Filter by comma-separated canonical tool categories"
+  ).option(
+    "--tag <tag...>",
+    "Filter by the job the play does: smb, find-prospects, qualify, contact-info, signals"
   ).action(async (options) => {
     process.exitCode = await handlePlayList([
       ...options.limit ? ["--limit", options.limit] : [],
       ...options.cursor ? ["--cursor", options.cursor] : [],
       ...options.showCost ? ["--show-cost"] : [],
       ...options.categories ? ["--categories", options.categories] : [],
+      ...(options.tag ?? []).flatMap((tag) => ["--tag", tag]),
       ...options.json ? ["--json"] : []
     ]);
   });

package/dist/cli/index.mjs

@@ -3046,7 +3046,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.195",
+  version: "0.3.196",
   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
@@ -9106,6 +9106,12 @@ var DeeplineClient = class _DeeplineClient {
     if (options?.categories || options?.includeToolCategories) {
       params.set("include_tool_categories", "1");
     }
+    if (options?.tags) {
+      params.set(
+        "tags",
+        Array.isArray(options.tags) ? options.tags.join(",") : options.tags
+      );
+    }
     if (options?.includeArchived) params.set("include_archived", "1");
     if (options?.includeCostEstimates) {
       params.set("include_cost_estimates", "1");
@@ -29457,12 +29463,35 @@ function formatPlayCostEstimate(estimate) {
   const source = estimate.source === "observed" ? `observed from ${estimate.sampleRunCount} ${estimate.sampleRunCount === 1 ? "run" : "runs"}` : "static estimate";
   return `${credits} Deepline credits per ${unit} (${source})`;
 }
+var PREBUILT_PLAY_TAG_KEYS = [
+  "smb",
+  "find-prospects",
+  "qualify",
+  "contact-info",
+  "signals"
+];
 async function handlePlayList(args) {
   const jsonOutput = argsWantJson(args);
   const showCost = args.includes("--show-cost");
   const client2 = new DeeplineClient();
   const categoriesIndex = args.indexOf("--categories");
   const categories = categoriesIndex >= 0 ? args[categoriesIndex + 1]?.trim() : void 0;
+  const tags = args.flatMap((arg, index) => arg === "--tag" ? [args[index + 1]] : []).flatMap((value) => (value ?? "").split(",")).map((value) => value.trim()).filter(Boolean);
+  if (args.includes("--tag") && tags.length === 0) {
+    console.error(
+      `Pass a tag after --tag. Known tags: ${PREBUILT_PLAY_TAG_KEYS.join(", ")}.`
+    );
+    return 2;
+  }
+  const unknownTags = tags.filter(
+    (tag) => !PREBUILT_PLAY_TAG_KEYS.includes(tag)
+  );
+  if (unknownTags.length > 0) {
+    console.error(
+      `Unknown play tag: ${unknownTags.join(", ")}. Known tags: ${PREBUILT_PLAY_TAG_KEYS.join(", ")}.`
+    );
+    return 2;
+  }
   const limitIndex = args.indexOf("--limit");
   const cursorIndex = args.indexOf("--cursor");
   const limit = limitIndex >= 0 ? Number(args[limitIndex + 1]) : void 0;
@@ -29473,13 +29502,20 @@ async function handlePlayList(args) {
   }
   const page = await client2.listPlaysPage({
     categories,
+    ...tags.length > 0 ? { tags } : {},
     includeToolCategories: true,
     ...showCost ? { includeCostEstimates: true } : {},
     limit,
     cursor
   });
   const plays = page.plays;
-  const nextPage = page.hasMore && page.cursor ? `deepline plays list${categories ? ` --categories ${shellQuote3(categories)}` : ""}${limit ? ` --limit ${limit}` : ""}${showCost ? " --show-cost" : ""} --cursor ${shellQuote3(page.cursor)} --json` : null;
+  if (tags.length > 0 && plays.length > 0 && plays.every((play) => play.tags === void 0)) {
+    console.error(
+      "This Deepline server does not support --tag and returned unfiltered results. Update the server, or filter with --categories."
+    );
+    return 1;
+  }
+  const nextPage = page.hasMore && page.cursor ? `deepline plays list${categories ? ` --categories ${shellQuote3(categories)}` : ""}${tags.map((tag) => ` --tag ${shellQuote3(tag)}`).join("")}${limit ? ` --limit ${limit}` : ""}${showCost ? " --show-cost" : ""} --cursor ${shellQuote3(page.cursor)} --json` : null;
   if (page.hasMore && !nextPage) {
     throw new Error(
       "Play list reported more results without a continuation cursor"
@@ -29489,6 +29525,7 @@ async function handlePlayList(args) {
   for (const play of plays) {
     const flags = [
       play.pinned ? "pinned" : null,
+      ...(play.tags ?? []).map((tag) => `tag:${tag}`),
       ...(play.toolCategories ?? []).map((category) => `category:${category}`),
       play.origin === "prebuilt" || play.ownerType === "deepline" ? "prebuilt" : "owned",
       play.canEdit ? "editable" : "readonly",
@@ -30608,19 +30645,28 @@ Notes:
   is_truncated, next_cursor, and a next-page command. Use --limit to choose
   the page size and --cursor to continue with the same filters.
 
+  --tag filters by the job a prebuilt play does; --categories filters by the
+  tools it calls. Known tags: smb, find-prospects, qualify, contact-info,
+  signals. Repeat --tag or pass a comma-separated list to widen the result.
+
 Examples:
   deepline plays list
+  deepline plays list --tag smb --json
   deepline plays search email --json
 `
   ).option("--limit <count>", "Page size").option("--cursor <cursor>", "Continue a previous page").option("--show-cost", "Include the per-row or per-run cost estimate").option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
     "--categories <categories>",
     "Filter by comma-separated canonical tool categories"
+  ).option(
+    "--tag <tag...>",
+    "Filter by the job the play does: smb, find-prospects, qualify, contact-info, signals"
   ).action(async (options) => {
     process.exitCode = await handlePlayList([
       ...options.limit ? ["--limit", options.limit] : [],
       ...options.cursor ? ["--cursor", options.cursor] : [],
       ...options.showCost ? ["--show-cost"] : [],
       ...options.categories ? ["--categories", options.categories] : [],
+      ...(options.tag ?? []).flatMap((tag) => ["--tag", tag]),
       ...options.json ? ["--json"] : []
     ]);
   });

package/dist/{compiler-manifest-4bYusxBr.d.mts → compiler-manifest-Dpd2hEet.d.mts}

@@ -2895,6 +2895,16 @@ type PlayDocflowSubgraph = {
 type PlayDocflowBinding = {
     nodeId: string;
     line: number;
+    /**
+     * The file this annotation was written in, when it did not come from the play
+     * entry file. A play whose step program lives in a `-core` module has no
+     * statement in its `.play.ts` to annotate, so its boxes could only ever be
+     * sketches; annotations are read from the entry's import closure to fix that.
+     *
+     * `line` is only meaningful together with this: two files both have a line
+     * 42, so any positional comparison must agree on the path first.
+     */
+    sourcePath?: string;
     label?: string;
     kind?: PlayDocflowNodeKind;
     /** Symbolic values read by this business node. Never an arbitrary JS expression. */
@@ -3020,6 +3030,24 @@ interface PlayStaticSourceRange {
 type PlayStaticSubstepMetadata = {
     conditional?: boolean;
     disabled?: boolean;
+    /**
+     * Where this substep was REACHED FROM, when the extractor resolved it by
+     * following a call into another function — the range of the call expression
+     * itself, in the file that made the call.
+     *
+     * The extractor hops through `resolveLocalCallable`, which is TypeScript
+     * symbol resolution (`getSymbol()` / `getAliasedSymbol()`), so the callee may
+     * live anywhere in the import closure. Its `sourceRange` then points at the
+     * helper's body, which no annotation in the CALLING file can ever contain.
+     * That is why a binding on `const identity = await resolveCompanyIdentity(…)`
+     * could not reach the `ctx.tools.execute` inside it.
+     *
+     * Recorded as the OUTERMOST hop: unwinding stamps each level, so a tool three
+     * helpers deep ends up carrying the call site in the annotated function
+     * rather than an intermediate one. Absent whenever the substep was found
+     * directly in the function being analyzed.
+     */
+    callSiteRange?: PlayStaticSourceRange;
 };
 /**
  * One arm of a conditional `control_flow` substep — an `if`/`else if`/`else`

package/dist/{compiler-manifest-4bYusxBr.d.ts → compiler-manifest-Dpd2hEet.d.ts}

@@ -2895,6 +2895,16 @@ type PlayDocflowSubgraph = {
 type PlayDocflowBinding = {
     nodeId: string;
     line: number;
+    /**
+     * The file this annotation was written in, when it did not come from the play
+     * entry file. A play whose step program lives in a `-core` module has no
+     * statement in its `.play.ts` to annotate, so its boxes could only ever be
+     * sketches; annotations are read from the entry's import closure to fix that.
+     *
+     * `line` is only meaningful together with this: two files both have a line
+     * 42, so any positional comparison must agree on the path first.
+     */
+    sourcePath?: string;
     label?: string;
     kind?: PlayDocflowNodeKind;
     /** Symbolic values read by this business node. Never an arbitrary JS expression. */
@@ -3020,6 +3030,24 @@ interface PlayStaticSourceRange {
 type PlayStaticSubstepMetadata = {
     conditional?: boolean;
     disabled?: boolean;
+    /**
+     * Where this substep was REACHED FROM, when the extractor resolved it by
+     * following a call into another function — the range of the call expression
+     * itself, in the file that made the call.
+     *
+     * The extractor hops through `resolveLocalCallable`, which is TypeScript
+     * symbol resolution (`getSymbol()` / `getAliasedSymbol()`), so the callee may
+     * live anywhere in the import closure. Its `sourceRange` then points at the
+     * helper's body, which no annotation in the CALLING file can ever contain.
+     * That is why a binding on `const identity = await resolveCompanyIdentity(…)`
+     * could not reach the `ctx.tools.execute` inside it.
+     *
+     * Recorded as the OUTERMOST hop: unwinding stamps each level, so a tool three
+     * helpers deep ends up carrying the call site in the annotated function
+     * rather than an intermediate one. Absent whenever the substep was found
+     * directly in the function being analyzed.
+     */
+    callSiteRange?: PlayStaticSourceRange;
 };
 /**
  * One arm of a conditional `control_flow` substep — an `if`/`else if`/`else`

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, T as ToolResultBilling, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-4bYusxBr.mjs';
-export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-4bYusxBr.mjs';
+import { c as PlayCompilerManifest, T as ToolResultBilling, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-Dpd2hEet.mjs';
+export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-Dpd2hEet.mjs';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.mjs';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.mjs';
@@ -2246,6 +2246,14 @@ interface PlayListItem {
     description?: string | null;
     pinned?: boolean;
     toolCategories?: string[];
+    /**
+     * The job the play does, from Deepline's closed prebuilt tag vocabulary
+     * (`smb`, `find-prospects`, `qualify`, `contact-info`, `signals`) — a
+     * different question from `toolCategories`, which reports the tools it
+     * calls. Empty for org-owned plays; absent from a server too old to report
+     * it.
+     */
+    tags?: string[];
     origin?: 'prebuilt' | 'owned';
     ownerType?: 'deepline' | 'org';
     ownerSlug?: string;
@@ -2344,6 +2352,16 @@ interface PlayDescription {
     description?: string | null;
     pinned?: boolean;
     toolCategories?: string[];
+    /**
+     * What job this play does, as a closed vocabulary — `smb`,
+     * `find-prospects`, `qualify`, `contact-info`, `signals`.
+     *
+     * Distinct from `toolCategories`, which is derived from the tool ids a play
+     * calls and so describes its MACHINERY. A play that calls an email tool is
+     * not thereby an email play; every SMB play calls one and none of them is.
+     * Empty for org-owned plays, which carry no registry tag.
+     */
+    tags?: string[];
     origin?: 'prebuilt' | 'owned';
     ownerType?: 'deepline' | 'org';
     canEdit?: boolean;
@@ -3190,6 +3208,13 @@ type PlaysListOptions = {
      */
     grepMode?: 'all' | 'any' | 'phrase';
     categories?: string | string[];
+    /**
+     * Keep only plays carrying one of these tags — the job a play does, not the
+     * tools it calls. Deepline's closed vocabulary today: `smb`,
+     * `find-prospects`, `qualify`, `contact-info`, `signals`. Several tags widen
+     * the result rather than narrowing it, because a play carries exactly one.
+     */
+    tags?: string | string[];
     includeToolCategories?: boolean;
     includeArchived?: boolean;
     includeCostEstimates?: boolean;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, T as ToolResultBilling, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-4bYusxBr.js';
-export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-4bYusxBr.js';
+import { c as PlayCompilerManifest, T as ToolResultBilling, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-Dpd2hEet.js';
+export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-Dpd2hEet.js';
 import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
 export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.js';
 export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.js';
@@ -2246,6 +2246,14 @@ interface PlayListItem {
     description?: string | null;
     pinned?: boolean;
     toolCategories?: string[];
+    /**
+     * The job the play does, from Deepline's closed prebuilt tag vocabulary
+     * (`smb`, `find-prospects`, `qualify`, `contact-info`, `signals`) — a
+     * different question from `toolCategories`, which reports the tools it
+     * calls. Empty for org-owned plays; absent from a server too old to report
+     * it.
+     */
+    tags?: string[];
     origin?: 'prebuilt' | 'owned';
     ownerType?: 'deepline' | 'org';
     ownerSlug?: string;
@@ -2344,6 +2352,16 @@ interface PlayDescription {
     description?: string | null;
     pinned?: boolean;
     toolCategories?: string[];
+    /**
+     * What job this play does, as a closed vocabulary — `smb`,
+     * `find-prospects`, `qualify`, `contact-info`, `signals`.
+     *
+     * Distinct from `toolCategories`, which is derived from the tool ids a play
+     * calls and so describes its MACHINERY. A play that calls an email tool is
+     * not thereby an email play; every SMB play calls one and none of them is.
+     * Empty for org-owned plays, which carry no registry tag.
+     */
+    tags?: string[];
     origin?: 'prebuilt' | 'owned';
     ownerType?: 'deepline' | 'org';
     canEdit?: boolean;
@@ -3190,6 +3208,13 @@ type PlaysListOptions = {
      */
     grepMode?: 'all' | 'any' | 'phrase';
     categories?: string | string[];
+    /**
+     * Keep only plays carrying one of these tags — the job a play does, not the
+     * tools it calls. Deepline's closed vocabulary today: `smb`,
+     * `find-prospects`, `qualify`, `contact-info`, `signals`. Several tags widen
+     * the result rather than narrowing it, because a play carries exactly one.
+     */
+    tags?: string | string[];
     includeToolCategories?: boolean;
     includeArchived?: boolean;
     includeCostEstimates?: boolean;

package/dist/index.js

@@ -864,7 +864,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.195",
+  version: "0.3.196",
   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
@@ -6793,6 +6793,12 @@ var DeeplineClient = class _DeeplineClient {
     if (options?.categories || options?.includeToolCategories) {
       params.set("include_tool_categories", "1");
     }
+    if (options?.tags) {
+      params.set(
+        "tags",
+        Array.isArray(options.tags) ? options.tags.join(",") : options.tags
+      );
+    }
     if (options?.includeArchived) params.set("include_archived", "1");
     if (options?.includeCostEstimates) {
       params.set("include_cost_estimates", "1");

package/dist/index.mjs

@@ -768,7 +768,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.195",
+  version: "0.3.196",
   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
@@ -6697,6 +6697,12 @@ var DeeplineClient = class _DeeplineClient {
     if (options?.categories || options?.includeToolCategories) {
       params.set("include_tool_categories", "1");
     }
+    if (options?.tags) {
+      params.set(
+        "tags",
+        Array.isArray(options.tags) ? options.tags.join(",") : options.tags
+      );
+    }
     if (options?.includeArchived) params.set("include_archived", "1");
     if (options?.includeCostEstimates) {
       params.set("include_cost_estimates", "1");

package/dist/install-integrity.json

@@ -522,6 +522,7 @@
     "dist/bundling-sources/shared_libs/plays/ts-ast.ts",
     "dist/bundling-sources/shared_libs/plays/user-code-safety.ts",
     "dist/bundling-sources/shared_libs/plays/webhook-payload.ts",
+    "dist/bundling-sources/shared_libs/plays/workspace-bundle.ts",
     "dist/bundling-sources/shared_libs/product-notifications/catalog.ts",
     "dist/bundling-sources/shared_libs/product-notifications/configuration-draft.ts",
     "dist/bundling-sources/shared_libs/product-notifications/configuration.ts",
@@ -558,8 +559,8 @@
     "dist/cli/index.js",
     "dist/cli/index.mjs",
     "dist/cli/text-imports.d.ts",
-    "dist/compiler-manifest-4bYusxBr.d.mts",
-    "dist/compiler-manifest-4bYusxBr.d.ts",
+    "dist/compiler-manifest-Dpd2hEet.d.mts",
+    "dist/compiler-manifest-Dpd2hEet.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

package/dist/plays/bundle-play-file.d.mts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-4bYusxBr.mjs';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-4bYusxBr.mjs';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Dpd2hEet.mjs';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-Dpd2hEet.mjs';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/plays/bundle-play-file.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-4bYusxBr.js';
-export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-4bYusxBr.js';
+import { P as PlayArtifactKind, a as PlayBundleArtifact, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-Dpd2hEet.js';
+export { d as PLAY_ARTIFACT_KINDS, e as PlayArtifactCompatibility, f as PlayImportPolicy, g as PlayPackageImport, h as PlayRuntimeFeature } from '../compiler-manifest-Dpd2hEet.js';
 import '@sinclair/typebox';
 
 type ImportedPlayDependency = {

package/dist/plays/bundle-play-file.mjs

@@ -1818,6 +1818,7 @@ var PLAY_DOCFLOW_ARMS = [
 ];
 var FLOW_START = /^\s*(?:flowchart|graph)\s+(LR|RL|TB|TD|BT)\s*$/i;
 var MERMAID_NODE = /^\s*\/\/\s*@mermaid-node\s+([A-Za-z][\w-]*)(?:\s+(.*))?$/;
+var MERMAID_NODE_HINT = /@mermaid-node/;
 var ATTRIBUTE = /([A-Za-z][\w-]*)\s*:\s*"([^"\n]*)"/y;
 var MERMAID_NODE_ATTRIBUTES = ["label", "type", "in", "out", "arm"];
 var MERMAID_NODE_ID = /^[A-Za-z][\w-]*/;
@@ -2228,7 +2229,7 @@ function materializeDocflow(block) {
     ...block.ignoredDirectives.length ? { ignoredDirectives: block.ignoredDirectives } : {}
   };
 }
-function parsePlayDocflowFile(sourceCode) {
+function parsePlayDocflowFile(sourceCode, moduleSources) {
   const errors = [];
   const rawBlocks = [];
   JSDOC_BLOCK.lastIndex = 0;
@@ -2240,7 +2241,16 @@ function parsePlayDocflowFile(sourceCode) {
   }
   if (rawBlocks.length === 0) return { blocks: [], bindings: [], errors };
   const rejectedNodeIds = /* @__PURE__ */ new Set();
-  const bindings = parseDocflowBindings(sourceCode, errors, rejectedNodeIds);
+  const annotationSources = [{ sourceCode }];
+  for (const [sourcePath, moduleCode] of moduleSources ?? []) {
+    if (!MERMAID_NODE_HINT.test(moduleCode)) continue;
+    annotationSources.push({ sourceCode: moduleCode, sourcePath });
+  }
+  const bindings = parseDocflowBindings(
+    annotationSources,
+    errors,
+    rejectedNodeIds
+  );
   const parsedBlocks = [];
   for (const raw of rawBlocks) {
     const { exportName, diagram } = splitBlockExportHeader(raw.body);
@@ -2476,7 +2486,17 @@ function sourceLineStartsForDocflow(sourceCode) {
   }
   return starts;
 }
-function parseDocflowBindings(sourceCode, errors, rejectedNodeIds) {
+function parseDocflowBindings(sources, errors, rejectedNodeIds) {
+  const bindings = [];
+  for (const source of sources) {
+    bindings.push(
+      ...parseDocflowBindingsInSource(source, errors, rejectedNodeIds)
+    );
+  }
+  return bindings;
+}
+function parseDocflowBindingsInSource(source, errors, rejectedNodeIds) {
+  const { sourceCode, sourcePath } = source;
   const lines = sourceCode.split(/\r?\n/);
   const bindings = [];
   for (let index = 0; index < lines.length; index += 1) {
@@ -2546,6 +2566,7 @@ function parseDocflowBindings(sourceCode, errors, rejectedNodeIds) {
     bindings.push({
       nodeId: id,
       line: nextLine + 1,
+      ...sourcePath ? { sourcePath } : {},
       ...attributes.label ? { label: attributes.label } : {},
       ...kind ? { kind } : {},
       // Spread, never `arm: arm ?? undefined` — see `PlayDocflowEdge.arm`. An

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.195";
+    readonly version: "0.3.196";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.195";
+    readonly version: "0.3.196";
     readonly 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.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,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.195",
+  version: "0.3.196",
   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/release.mjs

@@ -48,7 +48,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.195",
+  version: "0.3.196",
   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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.195",
+  "version": "0.3.196",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",