deepline 0.3.452 → 0.3.453

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

@@ -1285,6 +1285,18 @@ export type MonitorsListOptions = {
  * plans, dependents) and it must not require an SDK bump to evolve.
  */
 export type MonitorCheckResult = Record<string, unknown>;
+
+export type MonitorPreviewOptions = {
+  /** Sample size, 1-3. The server default is 3. */
+  limit?: number;
+  /** Reuse to recover one preview's result; a new key is a new, paid preview. */
+  idempotencyKey?: string;
+};
+
+/** A preview's sample and charge, plus the key that identifies it. */
+export type MonitorPreviewResult = Record<string, unknown> & {
+  idempotency_key: string;
+};
 export type MonitorDeployResult = Record<string, unknown>;
 /** Field-level monitor capability spec returned by `client.monitors.get(...)`. */
 export type MonitorSpec = {
@@ -1868,6 +1880,15 @@ export type MonitorsNamespace = {
   ) => Promise<MonitorsAvailableResult>;
   /** Validate a monitor definition without deploying it (no spend). */
   check: (definition: MonitorDefinition) => Promise<MonitorCheckResult>;
+  /**
+   * Sample a few recent matches for a definition before deploying it. Spends
+   * Deepline credits per returned update. Reuse `idempotencyKey` to recover a
+   * lost result without paying again; omit it for a new preview.
+   */
+  preview: (
+    definition: MonitorDefinition,
+    options?: MonitorPreviewOptions,
+  ) => Promise<MonitorPreviewResult>;
   /** Deploy a monitor from a definition. May spend Deepline credits. */
   deploy: (
     definition: MonitorDefinition,
@@ -2850,6 +2871,8 @@ export class DeeplineClient {
       available: (toolIdOrOptions, options) =>
         this.getMonitorsAvailable(toolIdOrOptions, options),
       check: (definition) => this.checkMonitor(definition),
+      preview: (definition, options) =>
+        this.previewMonitor(definition, options),
       deploy: (definition, options) => this.deployMonitor(definition, options),
       sync: (definition, options) =>
         options?.dryRun
@@ -6686,6 +6709,48 @@ export class DeeplineClient {
     });
   }
 
+  /**
+   * Run one paid preview. Prefer `client.monitors.preview(...)`.
+   *
+   * The key is fixed before the request is sent and returned on the result
+   * and on any error (`error.idempotencyKey`), so a caller that loses the
+   * response can repeat the call with it and get the original result without
+   * a second charge. The submission is never replayed automatically.
+   */
+  async previewMonitor(
+    definition: MonitorDefinition,
+    options?: MonitorPreviewOptions,
+  ): Promise<MonitorPreviewResult> {
+    const idempotencyKey =
+      options?.idempotencyKey ??
+      `monitor-preview-${
+        globalThis.crypto?.randomUUID?.() ??
+        `${Date.now()}-${Math.random().toString(36).slice(2)}`
+      }`;
+    try {
+      const result = await this.http.request<Record<string, unknown>>(
+        '/api/v2/monitors/preview',
+        {
+          method: 'POST',
+          body: {
+            ...definition,
+            ...(options?.limit === undefined ? {} : { limit: options.limit }),
+          },
+          headers: { 'Idempotency-Key': idempotencyKey },
+          maxRetries: 0,
+          exactUrlOnly: true,
+          preserveRateLimitResponse: true,
+        },
+      );
+      return { ...result, idempotency_key: idempotencyKey };
+    } catch (error) {
+      if (error && typeof error === 'object') {
+        Object.assign(error, { idempotencyKey });
+      }
+      throw error;
+    }
+  }
+
   /**
    * Deploy a monitor from a definition. `dryRun` validates via the check
    * endpoint and returns the plan without deploying. Prefer

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

@@ -1036,7 +1036,8 @@ function isMonitorRateLimitEnvelope(parsed: unknown): boolean {
   const response = asRecord(parsed);
   const error = asRecord(response?.error);
   return (
-    error?.code === 'monitor_upstream_rate_limited' &&
+    (error?.code === 'monitor_upstream_rate_limited' ||
+      error?.code === 'monitor_preview_rate_limited') &&
     typeof error.message === 'string'
   );
 }

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

@@ -140,6 +140,8 @@ export type {
   LegacyMonitorStatusFilter,
   MonitorListEntry,
   MonitorCheckResult,
+  MonitorPreviewOptions,
+  MonitorPreviewResult,
   MonitorDeployResult,
   MonitorDetail,
   MonitorSpec,

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

@@ -205,7 +205,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.452',
+  version: '0.3.453',
   updateSummary: {
     introducedIn: '0.3.90',
     summary:

package/dist/bundling-sources/shared_libs/monitors/provider-monitor-capability.ts

@@ -286,6 +286,15 @@ export type ProviderMonitorCapabilityDefinition = {
       maxIds: number;
       rateLimitId: string;
     };
+    /**
+     * Optional paid sample: a few recent matches for the definition being
+     * considered, with nothing created. Only payloads whose `payloadField`
+     * value is listed can be previewed; every other payload of this capability,
+     * and every capability without this field, has no preview. `action` must
+     * also appear in `supportActions`, which is what registers it for
+     * execution.
+     */
+    preview?: ProviderMonitorPreviewDescriptor;
     // Declares that this monitor delivers data to Deepline via an inbound
     // webhook callback (handled by the provider-callbacks route). Webhook
     // subscription monitors are inherently inbound; native monitors must set
@@ -349,6 +358,43 @@ const UNLOCKED_ENTITLEMENT_STATUS: ProviderMonitorCapabilityEntitlementStatus =
     locked: false,
   };
 
+export type ProviderMonitorPreviewDescriptor = {
+  action: string;
+  payloadField: string;
+  supportedValues: readonly string[];
+  defaultLimit: number;
+  maxLimit: number;
+};
+
+export type ProviderMonitorPreviewResolution =
+  | { available: true; descriptor: ProviderMonitorPreviewDescriptor }
+  | { available: false; reason: string };
+
+/**
+ * Whether this payload of this capability can be previewed. `null` means the
+ * capability declares no preview at all, so callers omit preview entirely
+ * rather than saying "unavailable" for every monitor.
+ */
+export function resolveProviderMonitorPreview(input: {
+  capability: Pick<
+    ProviderMonitorCapabilityDefinition,
+    'providerCapability' | 'runtime'
+  >;
+  payload: Record<string, unknown>;
+}): ProviderMonitorPreviewResolution | null {
+  const descriptor = input.capability.runtime.preview;
+  if (!descriptor) return null;
+  const value = input.payload[descriptor.payloadField];
+  if (typeof value === 'string' && descriptor.supportedValues.includes(value)) {
+    return { available: true, descriptor };
+  }
+  const label = typeof value === 'string' && value ? value : 'this payload';
+  return {
+    available: false,
+    reason: `Preview isn't available for ${label} yet. Run monitors check, then deploy.`,
+  };
+}
+
 export type ProviderMonitorCapabilitySerializable = {
   provider: string;
   tool: string;
@@ -381,6 +427,11 @@ export type ProviderMonitorCapabilitySerializable = {
     included_active_monitors?: number | null;
     reason?: string;
   };
+  /** Present only when the capability declares a paid preview. */
+  preview?: {
+    available_for: Record<string, string[]>;
+    max_limit: number;
+  };
   next_commands: string[];
 };
 
@@ -604,6 +655,18 @@ export function serializeProviderMonitorCapability(
         : {}),
       ...(entitlement.reason ? { reason: entitlement.reason } : {}),
     },
+    ...(capability.runtime.preview
+      ? {
+          preview: {
+            available_for: {
+              [capability.runtime.preview.payloadField]: [
+                ...capability.runtime.preview.supportedValues,
+              ],
+            },
+            max_limit: capability.runtime.preview.maxLimit,
+          },
+        }
+      : {}),
     next_commands: [],
   };
 }

package/dist/cli/{auth-DKZLB6GN.mjs → auth-6CXS55CN.mjs}

@@ -13,13 +13,13 @@ import {
   reportSetupCompleted,
   resolvePendingAuthClaimForResume,
   statusBannerLine
-} from "./chunk-KQUDU3ZE.mjs";
-import "./chunk-PBQSX6ES.mjs";
-import "./chunk-SM5RZ5JC.mjs";
+} from "./chunk-7557D4FM.mjs";
+import "./chunk-FS2RMEJ7.mjs";
+import "./chunk-X2LUT22I.mjs";
 import "./chunk-4QF2K7TM.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-HBL4PM5Q.mjs";
-import "./chunk-RFDIXLRX.mjs";
+import "./chunk-IXVABCNA.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 export {

package/dist/cli/auth-AICIA232.js

@@ -0,0 +1,40 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkRNCIPLU5js = require('./chunk-RNCIPLU5.js');
+require('./chunk-WTTHH2K3.js');
+require('./chunk-RTR2KUU6.js');
+require('./chunk-ALJJRZNJ.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-DIAWYWT5.js');
+require('./chunk-RG644LJU.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.EXIT_WORKSPACE_MISMATCH = _chunkRNCIPLU5js.EXIT_WORKSPACE_MISMATCH; exports.authStatusLine = _chunkRNCIPLU5js.authStatusLine; exports.clearPendingClaim = _chunkRNCIPLU5js.clearPendingClaim; exports.clearSatisfiedPendingClaim = _chunkRNCIPLU5js.clearSatisfiedPendingClaim; exports.handleRegister = _chunkRNCIPLU5js.handleRegister; exports.handleStatus = _chunkRNCIPLU5js.handleStatus; exports.handleWait = _chunkRNCIPLU5js.handleWait; exports.httpJson = _chunkRNCIPLU5js.httpJson; exports.readPendingAuthClaim = _chunkRNCIPLU5js.readPendingAuthClaim; exports.readStatusBanner = _chunkRNCIPLU5js.readStatusBanner; exports.registerAuthCommands = _chunkRNCIPLU5js.registerAuthCommands; exports.reportSetupCompleted = _chunkRNCIPLU5js.reportSetupCompleted; exports.resolvePendingAuthClaimForResume = _chunkRNCIPLU5js.resolvePendingAuthClaimForResume; exports.statusBannerLine = _chunkRNCIPLU5js.statusBannerLine;