deepline 0.3.36 → 0.3.37

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

@@ -199,7 +199,7 @@ export const SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: '0.3.36',
+  version: '0.3.37',
   updateSummary:
     'Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/observability/scheduled-work.ts

@@ -0,0 +1,165 @@
+export const SCHEDULED_WORK_OBSERVABILITY_VERSION = 1 as const;
+
+export type ScheduledWorkScheduler =
+  | 'convex_cron'
+  | 'convex_scheduled_action'
+  | 'github_actions'
+  | 'inngest'
+  | 'scheduled_play'
+  | 'vercel_cron';
+
+export type ScheduledWorkOutcome = 'running' | 'succeeded' | 'failed';
+
+export type ScheduledWorkVolume = {
+  unit: string;
+  attempted?: number;
+  completed?: number;
+  failed?: number;
+  skipped?: number;
+};
+
+/**
+ * The portable envelope emitted by every scheduler. Keep this deliberately
+ * small: it is both the durable health record and the Axiom graph contract.
+ */
+export type ScheduledWorkObservation = {
+  jobId: string;
+  jobName: string;
+  scheduler: ScheduledWorkScheduler;
+  owner: string;
+  criticality: string;
+  environment: string;
+  invocationId: string;
+  occurredAt: number;
+  outcome: ScheduledWorkOutcome;
+  expectedWithinMs: number;
+  durationMs?: number;
+  errorSummary?: string;
+  runUrl?: string;
+  volume?: ScheduledWorkVolume;
+};
+
+export function scheduledWorkTelemetryFields(
+  observation: ScheduledWorkObservation,
+): Record<string, string | number> {
+  return {
+    scheduledWorkSchemaVersion: SCHEDULED_WORK_OBSERVABILITY_VERSION,
+    scheduledWorkJobId: observation.jobId,
+    scheduledWorkJobName: observation.jobName,
+    scheduledWorkScheduler: observation.scheduler,
+    scheduledWorkOwner: observation.owner,
+    scheduledWorkCriticality: observation.criticality,
+    scheduledWorkOutcome: observation.outcome,
+    scheduledWorkInvocationId: observation.invocationId,
+    scheduledWorkExpectedWithinMs: observation.expectedWithinMs,
+    ...(observation.durationMs === undefined
+      ? {}
+      : { scheduledWorkDurationMs: observation.durationMs }),
+    ...(observation.errorSummary === undefined
+      ? {}
+      : { scheduledWorkErrorSummary: observation.errorSummary }),
+    ...(observation.runUrl === undefined
+      ? {}
+      : { scheduledWorkRunUrl: observation.runUrl }),
+    ...(observation.volume === undefined
+      ? {}
+      : scheduledWorkVolumeTelemetryFields(observation.volume)),
+  };
+}
+
+export function scheduledWorkVolumeTelemetryFields(
+  volume: ScheduledWorkVolume,
+): Record<string, string | number> {
+  const attempted = finiteNonNegative(volume.attempted);
+  const completed = finiteNonNegative(volume.completed);
+  const failed = finiteNonNegative(volume.failed);
+  const skipped = finiteNonNegative(volume.skipped);
+  const scale =
+    attempted ??
+    (completed === undefined && failed === undefined && skipped === undefined
+      ? 0
+      : (completed ?? 0) + (failed ?? 0) + (skipped ?? 0));
+  return {
+    scheduledWorkUnit: volume.unit,
+    ...(attempted === undefined ? {} : { scheduledWorkAttempted: attempted }),
+    ...(completed === undefined ? {} : { scheduledWorkCompleted: completed }),
+    ...(failed === undefined ? {} : { scheduledWorkFailed: failed }),
+    ...(skipped === undefined ? {} : { scheduledWorkSkipped: skipped }),
+    ...(scale > 0 && failed !== undefined
+      ? { scheduledWorkFailureRate: failed / scale }
+      : {}),
+  };
+}
+
+/**
+ * Safe default for existing roots. New roots should pass a domain-specific
+ * volume extractor, but familiar result shapes become useful immediately.
+ */
+export function inferScheduledWorkVolume(result: unknown): ScheduledWorkVolume {
+  if (!result || typeof result !== 'object' || Array.isArray(result)) {
+    return { unit: 'runs', attempted: 1, completed: 1 };
+  }
+  const record = result as Record<string, unknown>;
+  const attempted = firstFinite(record, [
+    'processed',
+    'scanned',
+    'orgsScanned',
+    'dueSubscriptions',
+    'queuedJobsFound',
+    'total',
+  ]);
+  const completed = firstFinite(record, [
+    'completed',
+    'processed',
+    'launched',
+    'started',
+    'queued',
+    'cleaned',
+    'deleted',
+  ]);
+  const failed = firstFinite(record, [
+    'failed',
+    'errorCount',
+    'error_count',
+    'scan_errors',
+    'notification_error_count',
+  ]);
+  const skipped = firstFinite(record, [
+    'skipped',
+    'deduped',
+    'skippedNotDue',
+    'skippedNoActiveSubscriptions',
+  ]);
+  if (
+    attempted === undefined &&
+    completed === undefined &&
+    failed === undefined &&
+    skipped === undefined
+  ) {
+    return { unit: 'runs', attempted: 1, completed: 1 };
+  }
+  return {
+    unit: 'items',
+    ...(attempted === undefined ? {} : { attempted }),
+    ...(completed === undefined ? {} : { completed }),
+    ...(failed === undefined ? {} : { failed }),
+    ...(skipped === undefined ? {} : { skipped }),
+  };
+}
+
+function firstFinite(
+  record: Record<string, unknown>,
+  keys: readonly string[],
+): number | undefined {
+  for (const key of keys) {
+    const value = finiteNonNegative(record[key]);
+    if (value !== undefined) return value;
+  }
+  return undefined;
+}
+
+function finiteNonNegative(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) && value >= 0
+    ? value
+    : undefined;
+}

package/dist/cli/index.js

@@ -1043,7 +1043,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.37",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/cli/index.mjs

@@ -1029,7 +1029,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.37",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.js

@@ -779,7 +779,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.37",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -702,7 +702,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.36",
+  version: "0.3.37",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/install-integrity.json

@@ -26,6 +26,7 @@
     "dist/bundling-sources/shared_libs/observability/node-tracing.ts",
     "dist/bundling-sources/shared_libs/observability/redaction.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-job-errors.ts",
+    "dist/bundling-sources/shared_libs/observability/scheduled-work.ts",
     "dist/bundling-sources/shared_libs/observability/telemetry.ts",
     "dist/bundling-sources/shared_libs/observability/tracing.ts",
     "dist/bundling-sources/shared_libs/observability/worker-telemetry.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.36",
+  "version": "0.3.37",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",