deepline 0.1.272 → 0.1.274

package/README.md

@@ -113,7 +113,7 @@ surfaces we exercise in CI:
    - `client.runs.list({ play: name })`
    - `client.runs.tail(runId)`
    - `client.runs.stop(runId, { reason })`
-3. High-level SDK handles
+3. Connected SDK context (outside a running play)
    - `ctx.play(name).run(...)`
    - `ctx.play(name).runSync(...)`
    - `ctx.runPlay(name, input)`
@@ -122,7 +122,9 @@ surfaces we exercise in CI:
    - `GET /api/v2/runs/:runId`
    - `GET /api/v2/runs/:runId/tail`
 5. In-play composition
-   - `ctx.runPlay(...)`
+   - `ctx.runPlay(key, playRef, input, { description })`
+   - Org-owned `playRef` accepts a bare name, `self/<play>`, or the canonical
+     `<orgSlug>/<play>` returned by `plays get`.
 
 Internal / advanced only:
 

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

@@ -117,7 +117,7 @@ import type { ToolExecution } from './client.js';
 export type PlayCallExecution = 'inline' | 'child-workflow';
 
 export interface PlayCallOptions {
-  description?: string;
+  description: string;
   execution?: PlayCallExecution;
 }
 
@@ -903,7 +903,7 @@ export interface DeeplinePlayRuntimeContext {
     key: string,
     playRef: string | PlayReferenceLike,
     input: Record<string, unknown>,
-    options?: PlayCallOptions,
+    options: PlayCallOptions,
   ): Promise<TOutput>;
 
   /**

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

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.272',
+  version: '0.1.274',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/context.ts

@@ -6731,6 +6731,15 @@ export class PlayContextImpl {
   ): Promise<TOutput> {
     assertNoSecretTaint(input, 'ctx.runPlay input');
     const normalizedKey = this.normalizeContextKey(key, 'runPlay');
+    if (
+      arguments.length === 3 &&
+      typeof playRef === 'object' &&
+      playRef !== null
+    ) {
+      throw new Error(
+        'ctx.runPlay(...) signature is ctx.runPlay(key, playRef, input, { description }). Add a stable call key as the first argument.',
+      );
+    }
     const resolvedName =
       typeof playRef === 'string'
         ? playRef

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.272",
+  version: "0.1.274",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -27124,6 +27124,9 @@ function isPlayLikeTool(tool) {
   const toolId = typeof record.toolId === "string" ? record.toolId : "";
   return toolId.endsWith("_waterfall");
 }
+function isMonitorTypeTool(tool) {
+  return stringField2(tool, "kind") === "monitor_type";
+}
 function playReferenceForTool(tool) {
   const record = tool;
   const declared = stringField2(record, "playReference", "play_reference");
@@ -27540,7 +27543,100 @@ function extractionContractEntries(entries) {
     return name && expression ? [{ name, expression }] : [];
   });
 }
+function printMonitorTypeFilters(tool) {
+  const schema = recordField2(tool, "payload_schema", "payloadSchema");
+  const properties = recordField2(schema, "properties");
+  const required = new Set(
+    arrayField2(schema, "required").filter(
+      (v) => typeof v === "string"
+    )
+  );
+  const names = Object.keys(properties);
+  if (!names.length) {
+    console.log("Deploy filters: none");
+    return;
+  }
+  console.log("Deploy filters (set in the monitor payload):");
+  for (const name of names) {
+    const field = isRecord8(properties[name]) ? properties[name] : {};
+    const star = required.has(name) ? "*" : "";
+    const enumVals = arrayField2(field, "enum").filter(
+      (v) => typeof v === "string"
+    );
+    const type = enumVals.length ? `one of [${enumVals.join(", ")}]` : stringField2(field, "type") || "string";
+    const desc = stringField2(field, "description");
+    console.log(`- ${name}${star}: ${type}${desc ? ` - ${desc}` : ""}`);
+  }
+}
+function printMonitorTypeStreams(tool) {
+  const streams = arrayField2(tool, "streams", "output_streams").filter(isRecord8);
+  if (!streams.length) return;
+  console.log("");
+  console.log("Filter columns (a play's sqlListeners.where, per stream):");
+  for (const stream of streams) {
+    const name = stringField2(stream, "stream");
+    const cols = arrayField2(stream, "columns").filter(isRecord8).map((col) => stringField2(col, "name")).filter(Boolean);
+    console.log(`- ${name}: ${cols.join(", ")}`);
+  }
+}
+function printMonitorTypePricing(tool) {
+  const pricing = recordField2(tool, "pricing");
+  const byType = recordField2(
+    pricing,
+    "pricing_by_radar_type",
+    "pricingByRadarType"
+  );
+  const keys = Object.keys(byType);
+  if (!keys.length) {
+    console.log("Pricing: Deepline credits per accepted event (see --json)");
+    return;
+  }
+  console.log("Pricing (Deepline credits per accepted event):");
+  for (const key of keys) {
+    const entry = isRecord8(byType[key]) ? byType[key] : {};
+    const credits = numberField2(entry, "deepline_credits", "deeplineCredits");
+    const display = stringField2(entry, "display");
+    const shown = display || (credits !== null ? `${formatDecimal(credits)} credits/event` : "see --json");
+    console.log(`- ${key}: ${shown}`);
+  }
+}
+function printMonitorTypeDeploy(tool) {
+  const deploy = recordField2(tool, "deploy");
+  const toolId = stringField2(tool, "toolId");
+  const example = stringField2(deploy, "example") || `deepline monitors deploy '{"key":"...","tool":"${toolId}","payload":{...}}'`;
+  console.log("Deploy (a monitor type is deployed, not executed):");
+  console.log(`  ${example}`);
+}
+function printMonitorTypeContract(tool, requestedToolId) {
+  const toolId = stringField2(tool, "toolId") || requestedToolId;
+  console.log(toolId);
+  const displayName = stringField2(tool, "displayName");
+  if (displayName) console.log(`Best for: ${displayName}`);
+  const description = stringField2(tool, "description");
+  if (description) console.log(`Description: ${description}`);
+  const categories = arrayField2(tool, "categories").filter(
+    (v) => typeof v === "string"
+  );
+  if (categories.length) console.log(`Tags: ${categories.join(", ")}`);
+  console.log("");
+  console.log(
+    "Monitor type \u2014 streams a provider's events into your warehouse. Deploy it, don't execute it."
+  );
+  console.log("");
+  printMonitorTypeFilters(tool);
+  printMonitorTypeStreams(tool);
+  console.log("");
+  printMonitorTypePricing(tool);
+  console.log("");
+  printMonitorTypeDeploy(tool);
+  console.log("");
+  console.log(`More: deepline tools get ${toolId} --json`);
+}
 function printCompactToolContract(tool, requestedToolId) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypeContract(tool, requestedToolId);
+    return;
+  }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
   const cost = isRecord8(contract.cost) ? contract.cost : {};
   const getters = isRecord8(contract.getters) ? contract.getters : {};
@@ -27606,6 +27702,10 @@ function printCompactToolContract(tool, requestedToolId) {
   );
 }
 function printToolPricingOnly(tool, requestedToolId, options = {}) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypePricing(tool);
+    return;
+  }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
   const cost = isRecord8(contract.cost) ? contract.cost : {};
   const pricingModel = stringField2(cost, "pricingModel") || "unknown";
@@ -27618,6 +27718,11 @@ function printToolPricingOnly(tool, requestedToolId, options = {}) {
   console.log(`Billing: ${billingMode}`);
 }
 function printToolSchemaOnly(tool, requestedToolId) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypeFilters(tool);
+    printMonitorTypeStreams(tool);
+    return;
+  }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
   const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
   console.log(`Schema: ${contract.toolId}`);
@@ -27640,6 +27745,10 @@ function printToolSchemaOnly(tool, requestedToolId) {
   }
 }
 function printToolExamplesOnly(tool, requestedToolId, options = {}) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypeDeploy(tool);
+    return;
+  }
   if (isPlayLikeTool(tool)) {
     printPlayLikeToolUsage(tool, requestedToolId);
     return;

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.272",
+  version: "0.1.274",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -27172,6 +27172,9 @@ function isPlayLikeTool(tool) {
   const toolId = typeof record.toolId === "string" ? record.toolId : "";
   return toolId.endsWith("_waterfall");
 }
+function isMonitorTypeTool(tool) {
+  return stringField2(tool, "kind") === "monitor_type";
+}
 function playReferenceForTool(tool) {
   const record = tool;
   const declared = stringField2(record, "playReference", "play_reference");
@@ -27588,7 +27591,100 @@ function extractionContractEntries(entries) {
     return name && expression ? [{ name, expression }] : [];
   });
 }
+function printMonitorTypeFilters(tool) {
+  const schema = recordField2(tool, "payload_schema", "payloadSchema");
+  const properties = recordField2(schema, "properties");
+  const required = new Set(
+    arrayField2(schema, "required").filter(
+      (v) => typeof v === "string"
+    )
+  );
+  const names = Object.keys(properties);
+  if (!names.length) {
+    console.log("Deploy filters: none");
+    return;
+  }
+  console.log("Deploy filters (set in the monitor payload):");
+  for (const name of names) {
+    const field = isRecord8(properties[name]) ? properties[name] : {};
+    const star = required.has(name) ? "*" : "";
+    const enumVals = arrayField2(field, "enum").filter(
+      (v) => typeof v === "string"
+    );
+    const type = enumVals.length ? `one of [${enumVals.join(", ")}]` : stringField2(field, "type") || "string";
+    const desc = stringField2(field, "description");
+    console.log(`- ${name}${star}: ${type}${desc ? ` - ${desc}` : ""}`);
+  }
+}
+function printMonitorTypeStreams(tool) {
+  const streams = arrayField2(tool, "streams", "output_streams").filter(isRecord8);
+  if (!streams.length) return;
+  console.log("");
+  console.log("Filter columns (a play's sqlListeners.where, per stream):");
+  for (const stream of streams) {
+    const name = stringField2(stream, "stream");
+    const cols = arrayField2(stream, "columns").filter(isRecord8).map((col) => stringField2(col, "name")).filter(Boolean);
+    console.log(`- ${name}: ${cols.join(", ")}`);
+  }
+}
+function printMonitorTypePricing(tool) {
+  const pricing = recordField2(tool, "pricing");
+  const byType = recordField2(
+    pricing,
+    "pricing_by_radar_type",
+    "pricingByRadarType"
+  );
+  const keys = Object.keys(byType);
+  if (!keys.length) {
+    console.log("Pricing: Deepline credits per accepted event (see --json)");
+    return;
+  }
+  console.log("Pricing (Deepline credits per accepted event):");
+  for (const key of keys) {
+    const entry = isRecord8(byType[key]) ? byType[key] : {};
+    const credits = numberField2(entry, "deepline_credits", "deeplineCredits");
+    const display = stringField2(entry, "display");
+    const shown = display || (credits !== null ? `${formatDecimal(credits)} credits/event` : "see --json");
+    console.log(`- ${key}: ${shown}`);
+  }
+}
+function printMonitorTypeDeploy(tool) {
+  const deploy = recordField2(tool, "deploy");
+  const toolId = stringField2(tool, "toolId");
+  const example = stringField2(deploy, "example") || `deepline monitors deploy '{"key":"...","tool":"${toolId}","payload":{...}}'`;
+  console.log("Deploy (a monitor type is deployed, not executed):");
+  console.log(`  ${example}`);
+}
+function printMonitorTypeContract(tool, requestedToolId) {
+  const toolId = stringField2(tool, "toolId") || requestedToolId;
+  console.log(toolId);
+  const displayName = stringField2(tool, "displayName");
+  if (displayName) console.log(`Best for: ${displayName}`);
+  const description = stringField2(tool, "description");
+  if (description) console.log(`Description: ${description}`);
+  const categories = arrayField2(tool, "categories").filter(
+    (v) => typeof v === "string"
+  );
+  if (categories.length) console.log(`Tags: ${categories.join(", ")}`);
+  console.log("");
+  console.log(
+    "Monitor type \u2014 streams a provider's events into your warehouse. Deploy it, don't execute it."
+  );
+  console.log("");
+  printMonitorTypeFilters(tool);
+  printMonitorTypeStreams(tool);
+  console.log("");
+  printMonitorTypePricing(tool);
+  console.log("");
+  printMonitorTypeDeploy(tool);
+  console.log("");
+  console.log(`More: deepline tools get ${toolId} --json`);
+}
 function printCompactToolContract(tool, requestedToolId) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypeContract(tool, requestedToolId);
+    return;
+  }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
   const cost = isRecord8(contract.cost) ? contract.cost : {};
   const getters = isRecord8(contract.getters) ? contract.getters : {};
@@ -27654,6 +27750,10 @@ function printCompactToolContract(tool, requestedToolId) {
   );
 }
 function printToolPricingOnly(tool, requestedToolId, options = {}) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypePricing(tool);
+    return;
+  }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
   const cost = isRecord8(contract.cost) ? contract.cost : {};
   const pricingModel = stringField2(cost, "pricingModel") || "unknown";
@@ -27666,6 +27766,11 @@ function printToolPricingOnly(tool, requestedToolId, options = {}) {
   console.log(`Billing: ${billingMode}`);
 }
 function printToolSchemaOnly(tool, requestedToolId) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypeFilters(tool);
+    printMonitorTypeStreams(tool);
+    return;
+  }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
   const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
   console.log(`Schema: ${contract.toolId}`);
@@ -27688,6 +27793,10 @@ function printToolSchemaOnly(tool, requestedToolId) {
   }
 }
 function printToolExamplesOnly(tool, requestedToolId, options = {}) {
+  if (isMonitorTypeTool(tool)) {
+    printMonitorTypeDeploy(tool);
+    return;
+  }
   if (isPlayLikeTool(tool)) {
     printPlayLikeToolUsage(tool, requestedToolId);
     return;

package/dist/index.d.mts

@@ -3595,7 +3595,7 @@ type PreviousCell<Value = unknown> = {
 
 type PlayCallExecution = 'inline' | 'child-workflow';
 interface PlayCallOptions {
-    description?: string;
+    description: string;
     execution?: PlayCallExecution;
 }
 /**
@@ -4231,7 +4231,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 140 ctx.runPlay(key, playRef, input, options)
      */
-    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options?: PlayCallOptions): Promise<TOutput>;
+    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: PlayCallOptions): Promise<TOutput>;
     /**
      * Emit a log line visible in `play tail` and the play's progress logs.
      *

package/dist/index.d.ts

@@ -3595,7 +3595,7 @@ type PreviousCell<Value = unknown> = {
 
 type PlayCallExecution = 'inline' | 'child-workflow';
 interface PlayCallOptions {
-    description?: string;
+    description: string;
     execution?: PlayCallExecution;
 }
 /**
@@ -4231,7 +4231,7 @@ interface DeeplinePlayRuntimeContext {
      *
      * @sdkReference runtime 140 ctx.runPlay(key, playRef, input, options)
      */
-    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options?: PlayCallOptions): Promise<TOutput>;
+    runPlay<TOutput = unknown>(key: string, playRef: string | PlayReferenceLike, input: Record<string, unknown>, options: PlayCallOptions): Promise<TOutput>;
     /**
      * Emit a log line visible in `play tail` and the play's progress logs.
      *

package/dist/index.js

@@ -438,7 +438,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.272",
+  version: "0.1.274",
   contracts: {
     api: {
       name: "sdk-http-api",

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.272",
+  version: "0.1.274",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.272",
+  "version": "0.1.274",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {