deepline 0.3.110 → 0.3.112

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

@@ -1,4 +1,5 @@
 import { iterateCursorPages } from './pagination.js';
+import type { ToolResultBilling } from '../../shared_libs/plays/tool-result-types.js';
 /**
  * The main API client for interacting with the Deepline platform.
  *
@@ -583,7 +584,7 @@ export type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
   };
   extractedLists?: Record<string, unknown>;
   extractedValues?: Record<string, unknown>;
-  billing?: Record<string, unknown>;
+  billing?: ToolResultBilling;
   [key: string]: unknown;
 };
 

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

@@ -303,6 +303,7 @@ export type {
   StepProgramResolver,
   StepResolver,
   ToolExecuteResult,
+  ToolResultBilling,
   ToolExecutionRequest,
   DeeplineEmailStatusGetterValue,
   DeeplineExtractorTarget,

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

@@ -268,6 +268,7 @@ export type {
   ToolExecuteResult,
   ToolExecuteResultAccessors,
   ToolExecuteResultBase,
+  ToolResultBilling,
   ToolResultEnvelope,
   ToolResultListAccessor,
   ToolResultTargetAccessor as ToolExtractedValue,
@@ -1546,6 +1547,7 @@ function toolExecutionEnvelopeToResult(
         source: 'live',
       },
       meta: isRecord(response.meta) ? response.meta : undefined,
+      billing: response.billing,
     }),
     options,
   );

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.110',
+  version: '0.3.112',
   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/scheduled-jobs.json

@@ -805,9 +805,9 @@
     "locator": "observe operational queue health",
     "owner": "reliability",
     "criticality": "critical",
-    "purpose": "Measure every durable queue through the scheduler-neutral depth, age, flow, and DLQ contract.",
-    "successDefinition": "Every cataloged queue publishes a complete measurement and the observer completes.",
-    "failureDefinition": "The observer is missed/stuck, a queue is silently omitted, or snapshots cannot persist.",
+    "purpose": "Measure every Convex-owned durable queue through the scheduler-neutral depth, age, flow, and DLQ contract; Runtime Postgres/Absurd queues are published by their owning adapter.",
+    "successDefinition": "Every Convex-owned catalog queue publishes a complete measurement and the observer completes; external runtime queues publish through their owning adapter.",
+    "failureDefinition": "The observer is missed/stuck, a Convex-owned queue is silently omitted, or snapshots cannot persist.",
     "startGraceMs": 120000,
     "runTimeoutMs": 1800000,
     "failureAlert": "convex_action_wrapper",

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

@@ -5029,6 +5029,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           toolResponse: execution.toolResponse,
           metadata: execution.metadata,
           meta: execution.meta,
+          billing: execution.billing,
           requestInput: input.dispatchPayload,
           execution: toolExecutionMetadataForOutcome({
             kind: 'live',
@@ -5941,6 +5942,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
     result: unknown;
     metadata?: ToolResultMetadataInput | null;
     meta?: Record<string, unknown>;
+    billing?: ParsedToolExecuteResponse['billing'];
     toolResponse?: {
       raw?: unknown;
       rawV2?: unknown;
@@ -5987,6 +5989,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
           (await this.resolveToolResultMetadata(input.toolId)),
         execution: input.execution,
         meta: input.meta,
+        billing: input.billing,
       }),
     );
   }
@@ -10363,6 +10366,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
                 toolResponse: execution.toolResponse,
                 metadata: execution.metadata,
                 meta: execution.meta,
+                billing: execution.billing,
                 requestInput: input,
                 execution: toolExecutionMetadataForOutcome({
                   kind: 'live',
@@ -12657,6 +12661,7 @@ export class PlayContextImpl implements ScalarPlayAuthoringRuntimeContext {
                     toolResponse: execution.toolResponse,
                     metadata: execution.metadata,
                     meta: execution.meta,
+                    billing: execution.billing,
                     requestInput: call.payload,
                     execution: toolExecutionMetadataForOutcome({
                       kind: 'live',

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-queue-health.ts

@@ -409,26 +409,26 @@ function absurdProjectionQuery(queueTable: string): string {
       FROM ${table}
       WHERE state = 'pending' AND available_at <= $1::timestamptz
       ORDER BY available_at, run_id
-      LIMIT $2)
+      LIMIT $2::int)
       UNION ALL
       (SELECT 'delayed'::text, available_at
       FROM ${table}
       WHERE state = 'sleeping'
       ORDER BY available_at, run_id
-      LIMIT $2)
+      LIMIT $2::int)
       UNION ALL
       (SELECT 'delayed'::text, available_at
       FROM ${table}
       WHERE state = 'pending' AND available_at > $1::timestamptz
       ORDER BY available_at, run_id
-      LIMIT $2)
+      LIMIT $2::int)
       UNION ALL
       (SELECT 'in_flight'::text, coalesce(started_at, created_at)
       FROM ${table}
       WHERE state = 'running'
         AND (claim_expires_at IS NULL OR claim_expires_at > $1::timestamptz)
       ORDER BY available_at, run_id
-      LIMIT $2)
+      LIMIT $2::int)
       UNION ALL
       (SELECT 'blocked'::text, coalesce(claim_expires_at, started_at, created_at)
       FROM ${table}
@@ -436,13 +436,13 @@ function absurdProjectionQuery(queueTable: string): string {
         AND claim_expires_at IS NOT NULL
         AND claim_expires_at <= $1::timestamptz
       ORDER BY claim_expires_at, run_id
-      LIMIT $2)
+      LIMIT $2::int)
       UNION ALL
       (SELECT 'dead_lettered'::text, coalesce(failed_at, created_at)
       FROM ${table}
       WHERE state = 'failed'
       ORDER BY available_at, run_id
-      LIMIT $2)
+      LIMIT $2::int)
     )
     SELECT
       least(count(*) FILTER (WHERE bucket = 'ready'), $3) AS ready,
@@ -493,13 +493,13 @@ function outboxProjectionQuery(schema: string): string {
       FROM ${table}
       WHERE delivered_at IS NULL AND failed_at IS NULL
       ORDER BY coalesce(next_attempt_at, created_at), created_at, event_id
-      LIMIT $2
+      LIMIT $2::int
     ), dead_sample AS (
       SELECT 'dead_lettered'::text AS bucket, coalesce(failed_at, created_at) AS age_at
       FROM ${table}
       WHERE delivered_at IS NULL AND failed_at IS NOT NULL
       ORDER BY failed_at, event_id
-      LIMIT $2
+      LIMIT $2::int
     ), sampled AS (
       SELECT * FROM pending_sample
       UNION ALL
@@ -556,7 +556,7 @@ function cleanupProjectionQuery(schema: string): string {
       FROM ${table}
       WHERE status <> 'deleted'
       ORDER BY available_at, created_at, provider, sandbox_id
-      LIMIT $2
+      LIMIT $2::int
     )
     SELECT
       least(count(*) FILTER (WHERE bucket = 'ready'), $3) AS ready,
@@ -623,27 +623,34 @@ export async function readRuntimeQueueHealthFromClient(
       RUNTIME_QUEUE_HEALTH_MAX_ABSURD_QUEUES,
     ),
   );
-  const requestedNames = input.absurdQueueNames?.length
-    ? [
-        ...new Set(
-          input.absurdQueueNames.map((name) => name.trim()).filter(Boolean),
-        ),
-      ]
-    : undefined;
+  // `undefined` deliberately means "inspect the registry" for diagnostics.
+  // An explicit empty list means the control plane found no live lanes; never
+  // turn that into a scan of historical queues.
+  const requestedNames =
+    input.absurdQueueNames === undefined
+      ? undefined
+      : [
+          ...new Set(
+            input.absurdQueueNames.map((name) => name.trim()).filter(Boolean),
+          ),
+        ];
   if (requestedNames && requestedNames.length > maxQueues) {
     throw new Error(
       `Requested ${requestedNames.length} Absurd queues, exceeding the ${maxQueues} queue health limit.`,
     );
   }
-  const registry = requestedNames
-    ? await client.query<{ queue_name: string }>(
-        `SELECT queue_name FROM absurd.queues WHERE queue_name = ANY($1::text[]) ORDER BY queue_name LIMIT $2`,
-        [requestedNames, maxQueues],
-      )
-    : await client.query<{ queue_name: string }>(
-        `SELECT queue_name FROM absurd.queues ORDER BY queue_name LIMIT $1`,
-        [maxQueues],
-      );
+  const registry =
+    requestedNames?.length === 0
+      ? { rows: [] }
+      : requestedNames
+        ? await client.query<{ queue_name: string }>(
+            `SELECT queue_name FROM absurd.queues WHERE queue_name = ANY($1::text[]) ORDER BY queue_name LIMIT $2::int`,
+            [requestedNames, maxQueues],
+          )
+        : await client.query<{ queue_name: string }>(
+            `SELECT queue_name FROM absurd.queues ORDER BY queue_name LIMIT $1::int`,
+            [maxQueues],
+          );
   const queueNames = registry.rows.map((row) => row.queue_name);
   if (requestedNames) {
     const found = new Set(queueNames);

package/dist/bundling-sources/shared_libs/play-runtime/tool-result.ts

@@ -1,6 +1,7 @@
 export type {
   SerializedToolExecuteResult,
   ToolExecuteResult,
+  ToolResultBilling,
   ToolResultExecutionMetadata,
   ToolResultMetadata,
   ToolResultMetadataInput,
@@ -29,6 +30,7 @@ import {
 import type {
   SerializedToolExecuteResult,
   ToolExecuteResult,
+  ToolResultBilling,
   ToolResultExecutionMetadata,
   ToolResultExtractorDescriptor,
   ToolResultListAccessor,
@@ -215,6 +217,7 @@ export type ParsedToolExecuteResponse = {
   status: string;
   jobId?: string;
   meta?: Record<string, unknown>;
+  billing?: ToolResultBilling;
   toolResponse?: {
     raw?: unknown;
     rawV2?: unknown;
@@ -243,6 +246,7 @@ export function parseToolExecuteResponse(
     status,
     jobId: typeof body.job_id === 'string' ? body.job_id : undefined,
     meta: isRecord(body.meta) ? body.meta : undefined,
+    billing: isRecord(body.billing) ? body.billing : undefined,
     toolResponse: (() => {
       const output = parseV2ToolExecuteOutput(body);
       return output
@@ -1182,6 +1186,7 @@ export function createToolExecuteResult<TResult = unknown>(input: {
   metadata: ToolResultMetadataInput;
   execution: ToolResultExecutionMetadata;
   meta?: Record<string, unknown>;
+  billing?: ToolResultBilling;
   response?: {
     rawV2?: unknown;
     view?: 'data' | 'rawV2';
@@ -1238,6 +1243,7 @@ export function createToolExecuteResult<TResult = unknown>(input: {
     status: input.status,
     ...(input.jobId ? { job_id: input.jobId } : {}),
     ...(input.meta ? { meta: input.meta } : {}),
+    ...(input.billing ? { billing: input.billing } : {}),
     toolResponse,
     extractedValues,
     extractedLists,
@@ -1847,6 +1853,7 @@ export function serializeToolExecuteResult(
       status: value.status,
       ...(typeof value.job_id === 'string' ? { job_id: value.job_id } : {}),
       ...(isRecord(value.meta) ? { meta: value.meta } : {}),
+      ...(isRecord(value.billing) ? { billing: value.billing } : {}),
       toolResponse: {
         rawV2,
         view,
@@ -1864,6 +1871,7 @@ export function serializeToolExecuteResult(
     status: value.status,
     ...(typeof value.job_id === 'string' ? { job_id: value.job_id } : {}),
     ...(isRecord(value.meta) ? { meta: value.meta } : {}),
+    ...(isRecord(value.billing) ? { billing: value.billing } : {}),
     toolResponse: {
       raw: serializedRaw,
       ...(value.toolResponse.meta ? { meta: value.toolResponse.meta } : {}),
@@ -1926,6 +1934,7 @@ export function deserializeToolExecuteResult(
           metadata: value.metadata,
           execution: value.execution,
           meta: value.meta,
+          billing: value.billing,
         }),
         value.targetValues,
       ),
@@ -1945,6 +1954,7 @@ export function deserializeToolExecuteResult(
         metadata: value.metadata,
         execution: value.execution,
         meta: value.meta,
+        billing: value.billing,
       }),
       value.targetValues,
     ),

package/dist/bundling-sources/shared_libs/plays/deploy/control-plane-types.ts

@@ -68,6 +68,7 @@ export type PlayDeploymentDoc = {
   results?: unknown;
   buildSeconds?: number;
   startedAt?: number;
+  promotedAt?: number;
   finishedAt?: number;
   error?: string;
   createdAt: number;

package/dist/bundling-sources/shared_libs/plays/deploy/project-serializer.ts

@@ -59,6 +59,8 @@ export type SerializedPlayDeployment = {
   error: string | null;
   createdAt: number;
   startedAt: number | null;
+  /** Set once the live-pointer flip committed; the status may still be in flight. */
+  promotedAt: number | null;
   finishedAt: number | null;
 };
 
@@ -82,6 +84,7 @@ export function serializePlayDeployment(
     error: deployment.error ?? null,
     createdAt: deployment.createdAt,
     startedAt: deployment.startedAt ?? null,
+    promotedAt: deployment.promotedAt ?? null,
     finishedAt: deployment.finishedAt ?? null,
   };
 }

package/dist/bundling-sources/shared_libs/plays/tool-result-types.ts

@@ -2,6 +2,24 @@ import type { EmailStatusExtractorConfig } from './email-status';
 import type { DeeplineGetterValueMap } from './extractor-targets';
 import type { PlayDataset, SerializedPlayDataset } from './dataset';
 
+/**
+ * Customer pricing reported by the execution API, never provider spend.
+ * `credits_charged` and `cost_usd` describe the price of the original call;
+ * they do not acknowledge durable handoff or wallet posting. Receipt replay
+ * preserves this observation and does not imply a new charge or fresher state.
+ */
+export type ToolResultBilling = {
+  credits_charged?: number;
+  cost_usd?: number;
+  /** Missing on historical responses. Pending pricing has no final amount. */
+  pricing_status?: 'final' | 'pending';
+  settlement_status?: 'pending' | 'queued' | 'settled' | 'requires_recovery';
+  estimated_credits?: number;
+  estimated_cost_usd?: number;
+  /** Preserve additive public pricing details across runtime/deployment skew. */
+  [key: string]: unknown;
+};
+
 export type ToolResultExecutionMetadata = {
   idempotent: true;
   cached: boolean;
@@ -81,6 +99,7 @@ export type SerializedToolExecuteResultV1 = {
   job_id?: string;
   /** Deepline-owned execution/result metadata. */
   meta?: Record<string, unknown>;
+  billing?: ToolResultBilling;
   toolResponse: {
     /**
      * Raw provider/tool data with declared row-list payloads clipped to bounded
@@ -139,6 +158,7 @@ export type ToolExecuteResultBase<
   job_id?: string;
   /** Deepline-owned execution/result metadata. */
   meta?: Record<string, unknown>;
+  billing?: ToolResultBilling;
   toolResponse: ToolResponseEnvelope<TResult, TMeta>;
   extractedValues: Record<string, ToolResultTargetAccessor>;
   extractedLists: Record<string, ToolResultListAccessor>;

package/dist/cli/index.js

@@ -1298,7 +1298,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.110",
+  version: "0.3.112",
   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
@@ -37487,6 +37487,28 @@ async function handleDeploymentGet(id, options) {
     { json: options.json }
   );
 }
+async function handleDeploymentCancel(id, options) {
+  const { http } = getAuthedHttpClient();
+  const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
+  printCommandEnvelope(
+    {
+      cancelled: payload.cancelled,
+      deployment: payload.deployment,
+      render: {
+        sections: [
+          {
+            title: payload.cancelled ? "cancelled" : "already cancelled",
+            lines: [
+              payload.deployment ? renderDeployment(payload.deployment) : `Deployment ${id} cancelled.`,
+              "The build stops at its next step and nothing from it goes live."
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
 function registerGitCommands(program) {
   const git = program.command("git", { hidden: !cliFeatureEnabled(GIT_DEPLOY_FEATURE) }).alias("projects").description(
     "Git deploys: link repositories to this workspace and deploy plays on push."
@@ -37501,6 +37523,7 @@ Examples:
   deepline git set <id> --branch release
   deepline git unlink <id>
   deepline git deployments --repo <id>
+  deepline git cancel <deployment-id>
 `
   );
   git.command("connect").description("Connect a GitHub installation (browser step).").option("--json", "Emit JSON output").action(async (options) => handleConnect(options));
@@ -37541,6 +37564,11 @@ Examples:
   git.command("deployments").description("Deployment history; pass an id for one deployment.").argument("[id]", "Deployment id (omit to list)").option("--repo <id>", "Filter to one repository link").option("--limit <n>", "Max rows (default 50)").option("--json", "Emit JSON output").action(
     async (id, options) => id ? handleDeploymentGet(id, options) : handleDeploymentsList(options)
   );
+  git.command("cancel").description(
+    "Cancel a queued or running deployment before its plays go live (admin)."
+  ).argument("<id>", "Deployment id").option("--json", "Emit JSON output").action(
+    async (id, options) => handleDeploymentCancel(id, options)
+  );
   const deployments = program.command("deployments", { hidden: true });
   deployments.command("list").option("--project <id>", "Filter to one repository link").option("--limit <n>", "Max rows (default 50)").option("--json", "Emit JSON output").action(
     async (options) => handleDeploymentsList({ ...options, repo: options.project })

package/dist/cli/index.mjs

@@ -1271,7 +1271,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.110",
+  version: "0.3.112",
   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
@@ -37550,6 +37550,28 @@ async function handleDeploymentGet(id, options) {
     { json: options.json }
   );
 }
+async function handleDeploymentCancel(id, options) {
+  const { http } = getAuthedHttpClient();
+  const payload = await http.post(`/api/v2/deployments/${encodeURIComponent(id)}/cancel`, {});
+  printCommandEnvelope(
+    {
+      cancelled: payload.cancelled,
+      deployment: payload.deployment,
+      render: {
+        sections: [
+          {
+            title: payload.cancelled ? "cancelled" : "already cancelled",
+            lines: [
+              payload.deployment ? renderDeployment(payload.deployment) : `Deployment ${id} cancelled.`,
+              "The build stops at its next step and nothing from it goes live."
+            ]
+          }
+        ]
+      }
+    },
+    { json: options.json }
+  );
+}
 function registerGitCommands(program) {
   const git = program.command("git", { hidden: !cliFeatureEnabled(GIT_DEPLOY_FEATURE) }).alias("projects").description(
     "Git deploys: link repositories to this workspace and deploy plays on push."
@@ -37564,6 +37586,7 @@ Examples:
   deepline git set <id> --branch release
   deepline git unlink <id>
   deepline git deployments --repo <id>
+  deepline git cancel <deployment-id>
 `
   );
   git.command("connect").description("Connect a GitHub installation (browser step).").option("--json", "Emit JSON output").action(async (options) => handleConnect(options));
@@ -37604,6 +37627,11 @@ Examples:
   git.command("deployments").description("Deployment history; pass an id for one deployment.").argument("[id]", "Deployment id (omit to list)").option("--repo <id>", "Filter to one repository link").option("--limit <n>", "Max rows (default 50)").option("--json", "Emit JSON output").action(
     async (id, options) => id ? handleDeploymentGet(id, options) : handleDeploymentsList(options)
   );
+  git.command("cancel").description(
+    "Cancel a queued or running deployment before its plays go live (admin)."
+  ).argument("<id>", "Deployment id").option("--json", "Emit JSON output").action(
+    async (id, options) => handleDeploymentCancel(id, options)
+  );
   const deployments = program.command("deployments", { hidden: true });
   deployments.command("list").option("--project <id>", "Filter to one repository link").option("--limit <n>", "Max rows (default 50)").option("--json", "Emit JSON output").action(
     async (options) => handleDeploymentsList({ ...options, repo: options.project })