deepline 0.3.142 → 0.3.144

package/dist/bundling-sources/sdk/src/release.ts

@@ -200,7 +200,7 @@ export const 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.142',
+  version: '0.3.144',
   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: {

package/dist/bundling-sources/shared_libs/observability/dlq.ts

@@ -330,6 +330,18 @@ export type QueueItemUnavailable = {
   readonly reason: string;
 };
 
+/** Server attestation that an item page came from the owner's bounded,
+ * indexed failed-time reader rather than the generic item listing. */
+export type QueueItemFailedTimeRange = {
+  readonly kind: 'failed-time-range';
+  readonly after: string | null;
+  readonly before: string;
+  readonly index: string;
+  readonly indexed: true;
+  /** Stable across every page in the same cursor-bound plan. */
+  readonly snapshotAt: string;
+};
+
 export type QueueItemList = {
   readonly contractVersion: typeof QUEUE_ITEM_CONTROL_CONTRACT_VERSION;
   readonly queueId: string;
@@ -339,6 +351,8 @@ export type QueueItemList = {
   readonly nextCursor: string | null;
   readonly limit: number;
   readonly cursor: string | null;
+  /** Present only for a successfully measured indexed failure-time range. */
+  readonly failedTimeRange?: QueueItemFailedTimeRange;
   readonly unavailable?: QueueItemUnavailable;
 };
 

package/dist/bundling-sources/shared_libs/product-notifications/catalog.ts

@@ -108,6 +108,13 @@ type ProductNotificationRuleDefinition = {
 type NotificationTypeRegistration = NotificationTypeDefinition & {
   catalog?: ProductNotificationTypeCatalogMetadata;
   rule?: ProductNotificationRuleDefinition;
+  /**
+   * A platform-emitted rule with no catalog entry: never listed, never
+   * accepted by a workspace mutation, regardless of caller. Distinct from an
+   * inert catalog-less type (e.g. one with no producer yet) because a shadow
+   * type still ships a `rule.default` and fires for every workspace.
+   */
+  shadow?: true;
 };
 
 function validateInsufficientCreditDisable(
@@ -643,29 +650,19 @@ const PRODUCT_NOTIFICATION_TYPE_REGISTRY = [
     eventName: ProductNotificationEvent.CreditsPurchaseCompleted,
     requiredFilter: {},
     allowedTriggers: ['threshold_crossing'],
-    catalog: {
-      name: 'Credit purchase thank-you',
-      category: 'credits',
-      description:
-        'Thank the workspace when a credit purchase of at least the chosen size completes.',
-      allowMultiple: false,
-      editor: {
-        kind: 'threshold',
-        label: 'Minimum credits',
-        defaultThreshold: 500,
-        minimum: 0,
-        suffix: 'credits',
-      },
-    },
+    // Credit purchase thank-you: fires for every workspace once a purchase
+    // reaches 500 credits. Not configurable — see the `shadow` field.
+    catalog: undefined,
+    shadow: true,
     rule: {
-      default: { ruleKey: 'default.credits_purchased', groupKey: 'default' },
-      create: (input, base, editor) => ({
+      default: { ruleKey: 'default.credits_purchased', groupKey: 'shadow' },
+      create: (input, base) => ({
         ...base,
         repeatMode: 'every_match',
         trigger: {
           kind: 'threshold_crossing',
           direction: 'at_or_above',
-          threshold: input.threshold ?? defaultThreshold(editor),
+          threshold: input.threshold ?? 500,
           unit: 'credits',
         },
       }),
@@ -707,15 +704,12 @@ const PRODUCT_NOTIFICATION_TYPE_REGISTRY = [
     eventName: ProductNotificationEvent.BillingPlanPurchased,
     requiredFilter: {},
     allowedTriggers: ['each_match'],
-    catalog: {
-      name: 'Plan welcome',
-      category: 'credits',
-      description: 'Thank the workspace when it purchases a plan.',
-      allowMultiple: false,
-      editor: { kind: 'none' },
-    },
+    // Plan welcome: fires for every workspace on plan purchase. Not
+    // configurable — see the `shadow` field.
+    catalog: undefined,
+    shadow: true,
     rule: {
-      default: { ruleKey: 'default.plan_purchased', groupKey: 'default' },
+      default: { ruleKey: 'default.plan_purchased', groupKey: 'shadow' },
       create: (_input, base) => ({
         ...base,
         repeatMode: 'every_match',
@@ -911,10 +905,10 @@ export function createProductNotificationRule(input: {
   };
   if (rule?.create) {
     const editor = registration.catalog?.editor;
-    if (!editor) {
+    if (!editor && !(registration as NotificationTypeRegistration).shadow) {
       throw new Error(`${input.notificationType} is not configurable.`);
     }
-    return rule.create(input, base, editor);
+    return rule.create(input, base, editor ?? { kind: 'none' });
   }
   throw new Error(
     `Notification type ${input.notificationType} has no rule builder.`,
@@ -927,6 +921,17 @@ export const PRODUCT_NOTIFICATION_TYPE_CATALOG: readonly ProductNotificationType
     catalog ? [{ id, ...catalog }] : [],
   );
 
+/**
+ * Platform-owned notification types with a default rule that fires for every
+ * workspace but is never listed or user-editable. A workspace mutation must
+ * reject any of these ids outright, not merely omit them from a listing.
+ */
+export const PRODUCT_NOTIFICATION_SHADOW_TYPES: ReadonlySet<string> = new Set(
+  PRODUCT_NOTIFICATION_TYPE_REGISTRY.filter(
+    (registration) => (registration as NotificationTypeRegistration).shadow,
+  ).map(({ id }) => id),
+);
+
 /** Code-owned defaults declared beside the notification types they enable. */
 export const PRODUCT_NOTIFICATION_DEFAULT_RULES =
   PRODUCT_NOTIFICATION_TYPE_REGISTRY.flatMap((registration) => {

package/dist/bundling-sources/shared_libs/product-notifications/default-policy.ts

@@ -14,7 +14,7 @@ import {
  * they create sparse copy-on-write overrides.
  */
 export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
-  version: 7,
+  version: 8,
   groups: [
     {
       groupKey: 'default',
@@ -22,6 +22,16 @@ export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
       enabled: true,
       deliveryTiming: DEFAULT_PRODUCT_NOTIFICATION_DELIVERY_TIMING,
     },
+    {
+      // Holds shadow (platform-owned, unconfigurable) rules. Kept in its own
+      // group so a customer save of the "default" group's rules never diffs
+      // against — and so never implicitly disables — a shadow rule it can't
+      // see. See PRODUCT_NOTIFICATION_SHADOW_TYPES.
+      groupKey: 'shadow',
+      name: 'Platform notifications',
+      enabled: true,
+      deliveryTiming: DEFAULT_PRODUCT_NOTIFICATION_DELIVERY_TIMING,
+    },
   ],
   destinations: [
     {
@@ -31,6 +41,13 @@ export const CURRENT_PRODUCT_NOTIFICATION_DEFAULT_POLICY = {
       enabled: true,
       settings: { kind: 'email_roles', roles: ['owner'] },
     },
+    {
+      destinationKey: 'shadow.roles',
+      groupKey: 'shadow',
+      name: 'Workspace owners',
+      enabled: true,
+      settings: { kind: 'email_roles', roles: ['owner'] },
+    },
   ],
   rules: PRODUCT_NOTIFICATION_DEFAULT_RULES,
 } satisfies ProductNotificationDefaultPolicy;

package/dist/cli/index.js

@@ -3068,7 +3068,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.142",
+  version: "0.3.144",
   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
@@ -47961,6 +47961,7 @@ Notes:
 Examples:
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline tools execute hunter_email_verifier -p email=a@b.com
+  deepline tools execute test_rate_limit --input '{"key":"smoke"}' --timeout 90s --json
   deepline tools execute test_rate_limit --input '{"key":"smoke"}' --json | jq '.status'
   deepline tools execute free_simple_company_search --input '{"sql":"SELECT company_name FROM companies LIMIT 10"}' --out companies.csv
 `
@@ -47981,6 +47982,9 @@ Examples:
   ).option(
     "--payload <payload>",
     "Merge a JSON object or @file path into the tool params"
+  ).option(
+    "--timeout <duration>",
+    "Execution HTTP deadline (for example 90s, 5m, or 1h; bare numbers are seconds)"
   ).option(
     "--output-format <format>",
     "Output format: auto, csv, csv_file, json, or json_file"
@@ -47995,6 +47999,7 @@ Examples:
       ...typeof options.json === "string" ? ["--json", options.json] : [],
       ...options.input ? ["--input", options.input] : [],
       ...options.payload ? ["--payload", options.payload] : [],
+      ...options.timeout ? ["--timeout", options.timeout] : [],
       ...options.outputFormat ? ["--output-format", options.outputFormat] : [],
       ...options.out ? ["--out", options.out] : [],
       ...options.preview === false ? ["--no-preview"] : []
@@ -48747,8 +48752,10 @@ function toolInputFieldsForDisplay(inputSchema) {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
       const minItems = typeof field.minItems === "number" ? field.minItems : jsonSchemaField?.minItems;
       const maxItems = typeof field.maxItems === "number" ? field.maxItems : jsonSchemaField?.maxItems;
+      const items = isRecord12(field.items) ? field.items : jsonSchemaField?.items;
       return {
         ...field,
+        ...isRecord12(items) ? { items } : {},
         ...typeof minItems === "number" ? { minItems } : {},
         ...typeof maxItems === "number" ? { maxItems } : {}
       };
@@ -48764,6 +48771,7 @@ function toolInputFieldsForDisplay(inputSchema) {
       type: typeof property.type === "string" ? property.type : "unknown",
       required: required.has(name),
       description: property.description,
+      ...isRecord12(property.items) ? { items: property.items } : {},
       ...typeof property.minItems === "number" ? { minItems: property.minItems } : {},
       ...typeof property.maxItems === "number" ? { maxItems: property.maxItems } : {},
       ...Object.prototype.hasOwnProperty.call(property, "default") ? { default: property.default } : {}
@@ -48883,6 +48891,7 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
         required,
         description: schema.description,
         ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
+        ...isRecord12(schema.items) ? { items: schema.items } : {},
         ...typeof schema.minItems === "number" ? { minItems: schema.minItems } : {},
         ...typeof schema.maxItems === "number" ? { maxItems: schema.maxItems } : {},
         ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
@@ -48917,25 +48926,31 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
   return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
 }
 function inputFieldJsonForDescribe(field) {
+  const publicItems = isRecord12(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
   return {
     name: field.name,
     type: field.type ?? "unknown",
     required: Boolean(field.required),
     ...field.description ? { description: field.description } : {},
+    ...isRecord12(publicItems) ? { items: publicItems } : {},
     ...typeof field.minItems === "number" ? { minItems: field.minItems } : {},
     ...typeof field.maxItems === "number" ? { maxItems: field.maxItems } : {},
     ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
   };
 }
 function arrayItemBoundsSuffix(field) {
+  const itemSchema = isRecord12(field.items) ? field.items : null;
+  const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord12(itemSchema.properties) ? "object" : "unknown" : null;
+  const itemEnum = Array.isArray(itemSchema?.enum) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
+  const itemTypeSuffix = itemType && itemType !== "unknown" ? ` items=${itemType}${itemEnum}` : "";
   const minItems = typeof field.minItems === "number" && Number.isFinite(field.minItems) ? field.minItems : null;
   const maxItems = typeof field.maxItems === "number" && Number.isFinite(field.maxItems) ? field.maxItems : null;
   if (minItems !== null && maxItems !== null) {
-    return ` items=${minItems}..${maxItems}`;
+    return itemTypeSuffix ? `${itemTypeSuffix} minItems=${minItems} maxItems=${maxItems}` : ` items=${minItems}..${maxItems}`;
   }
-  if (minItems !== null) return ` minItems=${minItems}`;
-  if (maxItems !== null) return ` maxItems=${maxItems}`;
-  return "";
+  if (minItems !== null) return `${itemTypeSuffix} minItems=${minItems}`;
+  if (maxItems !== null) return `${itemTypeSuffix} maxItems=${maxItems}`;
+  return itemTypeSuffix;
 }
 function printToolExecutionHints(value) {
   const batchCapabilityRecord = recordField2(
@@ -49224,13 +49239,14 @@ function parseExecuteOptions(args) {
   const toolId = args[0];
   if (!toolId) {
     throw new Error(
-      `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
+      `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--timeout <duration>] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
     );
   }
   const params = {};
   let outputFormat = "auto";
   let noPreview = false;
   let outPath = null;
+  let timeoutMs;
   for (let index = 1; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--param" || arg === "-p") && args[index + 1]) {
@@ -49254,6 +49270,10 @@ function parseExecuteOptions(args) {
       Object.assign(params, parseJsonObjectArgument(args[++index], arg));
       continue;
     }
+    if (arg === "--timeout" && args[index + 1]) {
+      timeoutMs = parseToolExecuteTimeout(args[++index]);
+      continue;
+    }
     if (arg === "--output-format" && args[index + 1]) {
       outputFormat = normalizeOutputFormat(args[++index]);
       continue;
@@ -49268,7 +49288,25 @@ function parseExecuteOptions(args) {
     }
     throw new Error(`Unknown option: ${arg}`);
   }
-  return { toolId, params, outputFormat, noPreview, outPath };
+  return { toolId, params, outputFormat, noPreview, outPath, timeoutMs };
+}
+function parseToolExecuteTimeout(raw) {
+  const match = /^(\d+)(ms|s|m|h)?$/i.exec(raw.trim());
+  if (!match) {
+    throw new Error(
+      "--timeout must be a duration like 500ms, 90s, 10m, or 1h (a bare number is seconds)."
+    );
+  }
+  const value = Number(match[1]);
+  const unit = (match[2] ?? "s").toLowerCase();
+  const factor = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5;
+  const timeoutMs = value * factor;
+  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2147483647) {
+    throw new Error(
+      "--timeout must be between 1ms and 2147483647ms (24d 20h 31m 23s)."
+    );
+  }
+  return timeoutMs;
 }
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
@@ -49571,7 +49609,8 @@ async function executeTool(args) {
     return 2;
   }
   const rawResponse = await client2.executeTool(parsed.toolId, parsed.params, {
-    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw"
+    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw",
+    ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {}
   });
   const listConversion = tryConvertToList(rawResponse, {
     listExtractorPaths: listExtractorPathsFromUsageGuidance(metadata)

package/dist/cli/index.mjs

@@ -3063,7 +3063,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.142",
+  version: "0.3.144",
   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
@@ -48103,6 +48103,7 @@ Notes:
 Examples:
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline tools execute hunter_email_verifier -p email=a@b.com
+  deepline tools execute test_rate_limit --input '{"key":"smoke"}' --timeout 90s --json
   deepline tools execute test_rate_limit --input '{"key":"smoke"}' --json | jq '.status'
   deepline tools execute free_simple_company_search --input '{"sql":"SELECT company_name FROM companies LIMIT 10"}' --out companies.csv
 `
@@ -48123,6 +48124,9 @@ Examples:
   ).option(
     "--payload <payload>",
     "Merge a JSON object or @file path into the tool params"
+  ).option(
+    "--timeout <duration>",
+    "Execution HTTP deadline (for example 90s, 5m, or 1h; bare numbers are seconds)"
   ).option(
     "--output-format <format>",
     "Output format: auto, csv, csv_file, json, or json_file"
@@ -48137,6 +48141,7 @@ Examples:
       ...typeof options.json === "string" ? ["--json", options.json] : [],
       ...options.input ? ["--input", options.input] : [],
       ...options.payload ? ["--payload", options.payload] : [],
+      ...options.timeout ? ["--timeout", options.timeout] : [],
       ...options.outputFormat ? ["--output-format", options.outputFormat] : [],
       ...options.out ? ["--out", options.out] : [],
       ...options.preview === false ? ["--no-preview"] : []
@@ -48889,8 +48894,10 @@ function toolInputFieldsForDisplay(inputSchema) {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
       const minItems = typeof field.minItems === "number" ? field.minItems : jsonSchemaField?.minItems;
       const maxItems = typeof field.maxItems === "number" ? field.maxItems : jsonSchemaField?.maxItems;
+      const items = isRecord12(field.items) ? field.items : jsonSchemaField?.items;
       return {
         ...field,
+        ...isRecord12(items) ? { items } : {},
         ...typeof minItems === "number" ? { minItems } : {},
         ...typeof maxItems === "number" ? { maxItems } : {}
       };
@@ -48906,6 +48913,7 @@ function toolInputFieldsForDisplay(inputSchema) {
       type: typeof property.type === "string" ? property.type : "unknown",
       required: required.has(name),
       description: property.description,
+      ...isRecord12(property.items) ? { items: property.items } : {},
       ...typeof property.minItems === "number" ? { minItems: property.minItems } : {},
       ...typeof property.maxItems === "number" ? { maxItems: property.maxItems } : {},
       ...Object.prototype.hasOwnProperty.call(property, "default") ? { default: property.default } : {}
@@ -49025,6 +49033,7 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
         required,
         description: schema.description,
         ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
+        ...isRecord12(schema.items) ? { items: schema.items } : {},
         ...typeof schema.minItems === "number" ? { minItems: schema.minItems } : {},
         ...typeof schema.maxItems === "number" ? { maxItems: schema.maxItems } : {},
         ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
@@ -49059,25 +49068,31 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
   return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
 }
 function inputFieldJsonForDescribe(field) {
+  const publicItems = isRecord12(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
   return {
     name: field.name,
     type: field.type ?? "unknown",
     required: Boolean(field.required),
     ...field.description ? { description: field.description } : {},
+    ...isRecord12(publicItems) ? { items: publicItems } : {},
     ...typeof field.minItems === "number" ? { minItems: field.minItems } : {},
     ...typeof field.maxItems === "number" ? { maxItems: field.maxItems } : {},
     ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
   };
 }
 function arrayItemBoundsSuffix(field) {
+  const itemSchema = isRecord12(field.items) ? field.items : null;
+  const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord12(itemSchema.properties) ? "object" : "unknown" : null;
+  const itemEnum = Array.isArray(itemSchema?.enum) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
+  const itemTypeSuffix = itemType && itemType !== "unknown" ? ` items=${itemType}${itemEnum}` : "";
   const minItems = typeof field.minItems === "number" && Number.isFinite(field.minItems) ? field.minItems : null;
   const maxItems = typeof field.maxItems === "number" && Number.isFinite(field.maxItems) ? field.maxItems : null;
   if (minItems !== null && maxItems !== null) {
-    return ` items=${minItems}..${maxItems}`;
+    return itemTypeSuffix ? `${itemTypeSuffix} minItems=${minItems} maxItems=${maxItems}` : ` items=${minItems}..${maxItems}`;
   }
-  if (minItems !== null) return ` minItems=${minItems}`;
-  if (maxItems !== null) return ` maxItems=${maxItems}`;
-  return "";
+  if (minItems !== null) return `${itemTypeSuffix} minItems=${minItems}`;
+  if (maxItems !== null) return `${itemTypeSuffix} maxItems=${maxItems}`;
+  return itemTypeSuffix;
 }
 function printToolExecutionHints(value) {
   const batchCapabilityRecord = recordField2(
@@ -49366,13 +49381,14 @@ function parseExecuteOptions(args) {
   const toolId = args[0];
   if (!toolId) {
     throw new Error(
-      `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
+      `Usage: deepline tools execute <toolId> [--param key=value ...] [--input '{"k":"v"}'] [--timeout <duration>] [--out rows.csv] [--output-format auto|csv|csv_file|json|json_file] [--no-preview]`
     );
   }
   const params = {};
   let outputFormat = "auto";
   let noPreview = false;
   let outPath = null;
+  let timeoutMs;
   for (let index = 1; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--param" || arg === "-p") && args[index + 1]) {
@@ -49396,6 +49412,10 @@ function parseExecuteOptions(args) {
       Object.assign(params, parseJsonObjectArgument(args[++index], arg));
       continue;
     }
+    if (arg === "--timeout" && args[index + 1]) {
+      timeoutMs = parseToolExecuteTimeout(args[++index]);
+      continue;
+    }
     if (arg === "--output-format" && args[index + 1]) {
       outputFormat = normalizeOutputFormat(args[++index]);
       continue;
@@ -49410,7 +49430,25 @@ function parseExecuteOptions(args) {
     }
     throw new Error(`Unknown option: ${arg}`);
   }
-  return { toolId, params, outputFormat, noPreview, outPath };
+  return { toolId, params, outputFormat, noPreview, outPath, timeoutMs };
+}
+function parseToolExecuteTimeout(raw) {
+  const match = /^(\d+)(ms|s|m|h)?$/i.exec(raw.trim());
+  if (!match) {
+    throw new Error(
+      "--timeout must be a duration like 500ms, 90s, 10m, or 1h (a bare number is seconds)."
+    );
+  }
+  const value = Number(match[1]);
+  const unit = (match[2] ?? "s").toLowerCase();
+  const factor = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5;
+  const timeoutMs = value * factor;
+  if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2147483647) {
+    throw new Error(
+      "--timeout must be between 1ms and 2147483647ms (24d 20h 31m 23s)."
+    );
+  }
+  return timeoutMs;
 }
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
@@ -49713,7 +49751,8 @@ async function executeTool(args) {
     return 2;
   }
   const rawResponse = await client2.executeTool(parsed.toolId, parsed.params, {
-    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw"
+    responseIntent: parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw",
+    ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {}
   });
   const listConversion = tryConvertToList(rawResponse, {
     listExtractorPaths: listExtractorPathsFromUsageGuidance(metadata)

package/dist/index.d.mts

@@ -770,45 +770,14 @@ declare const PRODUCT_NOTIFICATION_TYPE_REGISTRY: readonly [{
     readonly eventName: "credits.purchase.completed";
     readonly requiredFilter: {};
     readonly allowedTriggers: ["threshold_crossing"];
-    readonly catalog: {
-        readonly name: "Credit purchase thank-you";
-        readonly category: "credits";
-        readonly description: "Thank the workspace when a credit purchase of at least the chosen size completes.";
-        readonly allowMultiple: false;
-        readonly editor: {
-            readonly kind: "threshold";
-            readonly label: "Minimum credits";
-            readonly defaultThreshold: 500;
-            readonly minimum: 0;
-            readonly suffix: "credits";
-        };
-    };
+    readonly catalog: undefined;
+    readonly shadow: true;
     readonly rule: {
         readonly default: {
             readonly ruleKey: "default.credits_purchased";
-            readonly groupKey: "default";
+            readonly groupKey: "shadow";
         };
-        readonly create: (input: ProductNotificationRuleInput, base: ProductNotificationRuleBase, editor: {
-            kind: "threshold";
-            label: string;
-            defaultThreshold: number;
-            minimum: number;
-            maximum?: number;
-            suffix?: string;
-            /**
-             * When set, editors show and accept `remainingOf - threshold` (for
-             * example percent remaining) while the stored trigger stays in the
-             * runtime's "used" terms. Bounds and defaults are stored values.
-             */
-            remainingOf?: number;
-        } | {
-            kind: "play_failure";
-            defaultFailureCount: number;
-        } | {
-            kind: "play_scope";
-        } | {
-            kind: "none";
-        }) => {
+        readonly create: (input: ProductNotificationRuleInput, base: ProductNotificationRuleBase) => {
             repeatMode: "every_match";
             trigger: {
                 kind: "threshold_crossing";
@@ -859,19 +828,12 @@ declare const PRODUCT_NOTIFICATION_TYPE_REGISTRY: readonly [{
     readonly eventName: "billing.plan.purchased";
     readonly requiredFilter: {};
     readonly allowedTriggers: ["each_match"];
-    readonly catalog: {
-        readonly name: "Plan welcome";
-        readonly category: "credits";
-        readonly description: "Thank the workspace when it purchases a plan.";
-        readonly allowMultiple: false;
-        readonly editor: {
-            readonly kind: "none";
-        };
-    };
+    readonly catalog: undefined;
+    readonly shadow: true;
     readonly rule: {
         readonly default: {
             readonly ruleKey: "default.plan_purchased";
-            readonly groupKey: "default";
+            readonly groupKey: "shadow";
         };
         readonly create: (_input: ProductNotificationRuleInput, base: ProductNotificationRuleBase) => {
             repeatMode: "every_match";

package/dist/index.d.ts

@@ -770,45 +770,14 @@ declare const PRODUCT_NOTIFICATION_TYPE_REGISTRY: readonly [{
     readonly eventName: "credits.purchase.completed";
     readonly requiredFilter: {};
     readonly allowedTriggers: ["threshold_crossing"];
-    readonly catalog: {
-        readonly name: "Credit purchase thank-you";
-        readonly category: "credits";
-        readonly description: "Thank the workspace when a credit purchase of at least the chosen size completes.";
-        readonly allowMultiple: false;
-        readonly editor: {
-            readonly kind: "threshold";
-            readonly label: "Minimum credits";
-            readonly defaultThreshold: 500;
-            readonly minimum: 0;
-            readonly suffix: "credits";
-        };
-    };
+    readonly catalog: undefined;
+    readonly shadow: true;
     readonly rule: {
         readonly default: {
             readonly ruleKey: "default.credits_purchased";
-            readonly groupKey: "default";
+            readonly groupKey: "shadow";
         };
-        readonly create: (input: ProductNotificationRuleInput, base: ProductNotificationRuleBase, editor: {
-            kind: "threshold";
-            label: string;
-            defaultThreshold: number;
-            minimum: number;
-            maximum?: number;
-            suffix?: string;
-            /**
-             * When set, editors show and accept `remainingOf - threshold` (for
-             * example percent remaining) while the stored trigger stays in the
-             * runtime's "used" terms. Bounds and defaults are stored values.
-             */
-            remainingOf?: number;
-        } | {
-            kind: "play_failure";
-            defaultFailureCount: number;
-        } | {
-            kind: "play_scope";
-        } | {
-            kind: "none";
-        }) => {
+        readonly create: (input: ProductNotificationRuleInput, base: ProductNotificationRuleBase) => {
             repeatMode: "every_match";
             trigger: {
                 kind: "threshold_crossing";
@@ -859,19 +828,12 @@ declare const PRODUCT_NOTIFICATION_TYPE_REGISTRY: readonly [{
     readonly eventName: "billing.plan.purchased";
     readonly requiredFilter: {};
     readonly allowedTriggers: ["each_match"];
-    readonly catalog: {
-        readonly name: "Plan welcome";
-        readonly category: "credits";
-        readonly description: "Thank the workspace when it purchases a plan.";
-        readonly allowMultiple: false;
-        readonly editor: {
-            readonly kind: "none";
-        };
-    };
+    readonly catalog: undefined;
+    readonly shadow: true;
     readonly rule: {
         readonly default: {
             readonly ruleKey: "default.plan_purchased";
-            readonly groupKey: "default";
+            readonly groupKey: "shadow";
         };
         readonly create: (_input: ProductNotificationRuleInput, base: ProductNotificationRuleBase) => {
             repeatMode: "every_match";

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.142",
+  version: "0.3.144",
   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/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.142",
+  version: "0.3.144",
   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.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.142";
+    readonly version: "0.3.144";
     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.142";
+    readonly version: "0.3.144";
     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.142",
+  version: "0.3.144",
   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.142",
+  version: "0.3.144",
   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.142",
+  "version": "0.3.144",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",