deepline 0.3.157 → 0.3.159

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.157',
+  version: '0.3.159',
   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/monitors/http-error-response.ts

@@ -194,15 +194,24 @@ export function monitorErrorNextAction(payload: MonitorErrorPayload): string {
   if (code === 'monitor_already_exists') {
     const existingMonitor = asRecord(nestedError(payload)?.existing_monitor);
     const existing = existingMonitor?.key;
+    const fleetId = existingMonitor?.fleet_id;
     if (existingMonitor?.status === 'provisioning') {
       return 'An in-progress provider operation owns this identity. Do not deploy another key or delete and redeploy. Wait for it to finish, then rerun this check; if the conflict remains, contact Deepline support with the returned tool and identity.';
     }
+    if (typeof existing === 'string' && typeof fleetId === 'string') {
+      return `Run \`deepline monitors fleets get ${fleetId} --json\` to inspect the Fleet that owns this identity, then \`deepline monitors get ${existing} --json\` to inspect its monitor state. Change or reuse the owning Fleet member instead of deploying a second key.`;
+    }
     return typeof existing === 'string'
       ? `Run \`deepline monitors get ${existing} --json\` to inspect the monitor that owns this identity. Reuse it or contact Deepline support before replacing it; do not delete and redeploy blindly.`
       : 'Inspect the returned existing_monitor.key with `deepline monitors get <key> --json`. Reuse that monitor or contact Deepline support before replacing it; do not delete and redeploy blindly.';
   }
   if (code === 'upstream_monitor_conflict_unresolved') {
-    const existing = asRecord(nestedError(payload)?.existing_monitor)?.key;
+    const existingMonitor = asRecord(nestedError(payload)?.existing_monitor);
+    const existing = existingMonitor?.key;
+    const fleetId = existingMonitor?.fleet_id;
+    if (typeof existing === 'string' && typeof fleetId === 'string') {
+      return `Run \`deepline monitors fleets get ${fleetId} --json\` to inspect the Fleet that owns this identity, then report the upstream 409 with the returned monitor key and identity. Do not retry blindly.`;
+    }
     return typeof existing === 'string'
       ? `Run \`deepline monitors get ${existing} --json\` to inspect the matching managed monitor, then report this upstream 409 to Deepline support. Do not retry blindly.`
       : 'Report this upstream 409 to Deepline support with the returned tool and identity. Do not retry blindly.';

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

@@ -202,6 +202,23 @@ export const QUEUE_ITEM_STATES = [
 
 export type QueueItemState = (typeof QUEUE_ITEM_STATES)[number];
 
+export function isQueueItemState(value: unknown): value is QueueItemState {
+  return (
+    typeof value === 'string' &&
+    (QUEUE_ITEM_STATES as readonly string[]).includes(value)
+  );
+}
+
+/** Proof that a filtered item page was read from the queue owner's index. */
+export type QueueItemStateFilter = {
+  readonly kind: 'indexed-state';
+  readonly state: QueueItemState;
+  readonly index: string;
+  readonly nativeStates: readonly string[];
+  readonly indexed: true;
+  readonly cursorBound: true;
+};
+
 /** Operator disposition is an overlay on native source state. Retiring an
  * item removes it from active operational views without pretending the owner
  * completed, deleted, or replayed the source row. */
@@ -282,10 +299,53 @@ export type QueueItem = {
   /** Native failure timestamp when the owner can provide it. */
   readonly failedAt?: string;
   readonly summary?: string;
+  /** Bounded, owner-projected explanation for a queue item. */
+  readonly diagnosis?: QueueItemDiagnosis;
   readonly retiredAt?: string;
   readonly retirementReason?: string;
 };
 
+export type QueueItemDiagnosis = {
+  readonly version: 1;
+  readonly kind: 'charge-reservation';
+  readonly reasonCode: string | null;
+  readonly parkedAt: string | null;
+  readonly lastCheckedAt: string | null;
+  readonly reconciliation: {
+    readonly attemptCount: number;
+    readonly outcome: string | null;
+    readonly errorClass: string | null;
+    readonly httpStatus: number | null;
+    readonly responseClass: string | null;
+    readonly nextRetryAt: string | null;
+    readonly latestAttempt: {
+      readonly attemptNumber: number;
+      readonly initiator: string;
+      readonly outcome: string | null;
+      readonly errorClass: string | null;
+      readonly httpStatus: number | null;
+      readonly responseClass: string | null;
+      readonly safeErrorSummary: string | null;
+    } | null;
+  };
+  readonly settlement: {
+    readonly usageRecorded: boolean;
+    readonly settled: boolean;
+    readonly settleCount: number;
+    readonly relatedLedgerSampleCount: number;
+    readonly relatedLedgerSampleNetDeeplineCredits: number;
+    readonly relatedLedgerWindowTruncated: boolean;
+  };
+  readonly latestOperatorAction: {
+    readonly action: string;
+    readonly phase: string;
+    readonly result: string;
+    readonly at: string;
+  } | null;
+  readonly attemptsTruncated: boolean;
+  readonly auditTruncated: boolean;
+};
+
 /** Keep old DLQ verbs working at the boundary while exposing a smaller,
  * operator-readable control vocabulary. */
 export function normalizeQueueItemAction(
@@ -329,7 +389,7 @@ export type QueueItemEvidence = {
 };
 
 export type QueueItemUnavailable = {
-  readonly code: 'item_reader_unavailable';
+  readonly code: 'item_reader_unavailable' | 'state_filter_unavailable';
   readonly reason: string;
 };
 
@@ -365,6 +425,8 @@ export type QueueItemList = {
   readonly nextCursor: string | null;
   readonly limit: number;
   readonly cursor: string | null;
+  /** Present only when an indexed normalized-state filter was applied. */
+  readonly stateFilter?: QueueItemStateFilter;
   /** Present only for a successfully measured indexed failure-time range. */
   readonly failedTimeRange?: QueueItemFailedTimeRange;
   /** Present only for a successfully measured indexed creation-time range. */
@@ -461,6 +523,7 @@ export type QueueItemConnectorContext = {
   readonly now: number;
   readonly limit: number;
   readonly cursor?: string;
+  readonly state?: QueueItemState;
   readonly actorId?: string;
   readonly operationId?: string;
 };
@@ -510,24 +573,67 @@ export function normalizeQueueItemState(nativeState: string): QueueItemState {
   if (
     state === 'in_flight' ||
     state === 'in-flight' ||
-    state === 'processing'
+    state === 'processing' ||
+    state === 'leased' ||
+    state === 'building' ||
+    state === 'publishing' ||
+    state === 'cancelling'
   ) {
     return 'running';
   }
-  if (state === 'open') return 'ready';
-  if (state === 'parked') return 'blocked';
+  if (
+    state === 'open' ||
+    state === 'pending' ||
+    state === 'queued' ||
+    state === 'active' ||
+    state === 'received' ||
+    state === 'partial'
+  ) {
+    return 'ready';
+  }
+  if (state === 'parked' || state === 'blocked') return 'blocked';
+  if (state === 'needs_review' || state === 'inactive') return 'held';
+  if (
+    state === 'retry_scheduled' ||
+    state === 'retryable' ||
+    state === 'rate_limited' ||
+    state === 'delayed'
+  ) {
+    return 'delayed';
+  }
   if (
     state === 'failed' ||
     state === 'dead_lettered' ||
     state === 'dead-lettered' ||
+    state === 'dead' ||
+    state === 'reconcile_failed' ||
     state === 'dlq'
   ) {
     return 'quarantined';
   }
-  if (state === 'done' || state === 'succeeded' || state === 'success') {
+  if (
+    state === 'done' ||
+    state === 'succeeded' ||
+    state === 'succeeded_with_warnings' ||
+    state === 'success' ||
+    state === 'completed' ||
+    state === 'processed' ||
+    state === 'admitted' ||
+    state === 'published' ||
+    state === 'delivered'
+  ) {
     return 'completed';
   }
   if (state === 'canceled' || state === 'aborted') return 'cancelled';
+  if (
+    state === 'settled' ||
+    state === 'released' ||
+    state === 'suppressed' ||
+    state === 'expired' ||
+    state === 'superseded'
+  ) {
+    return 'archived';
+  }
   return 'unknown';
 }
 
@@ -538,6 +644,7 @@ export function unavailableQueueItemList(input: {
   reason: string;
   limit?: number;
   cursor?: string | null;
+  code?: QueueItemUnavailable['code'];
 }): QueueItemList {
   return {
     contractVersion: QUEUE_ITEM_CONTROL_CONTRACT_VERSION,
@@ -548,7 +655,10 @@ export function unavailableQueueItemList(input: {
     nextCursor: null,
     limit: input.limit ?? 50,
     cursor: input.cursor ?? null,
-    unavailable: { code: 'item_reader_unavailable', reason: input.reason },
+    unavailable: {
+      code: input.code ?? 'item_reader_unavailable',
+      reason: input.reason,
+    },
   };
 }
 

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.157",
+  version: "0.3.159",
   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/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.157",
+  version: "0.3.159",
   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.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.157",
+  version: "0.3.159",
   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.157",
+  version: "0.3.159",
   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.157";
+    readonly version: "0.3.159";
     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.157";
+    readonly version: "0.3.159";
     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.157",
+  version: "0.3.159",
   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.157",
+  version: "0.3.159",
   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.157",
+  "version": "0.3.159",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",