deepline 0.3.271 → 0.3.272

package/dist/index.mjs

@@ -1229,7 +1229,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.271",
+  version: "0.3.272",
   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
@@ -2881,6 +2881,425 @@ var ledgerIngressRedactor = createSecretRedactionContext();
 var utf8Encoder = new TextEncoder();
 var PLAY_DATASET_BRAND = Symbol.for("deepline.play.dataset");
 
+// ../play-runtime/run-event-catalog.ts
+var RUN_EVENT_KIND = {
+  runCreated: "run.created",
+  runStarted: "run.started",
+  runWaiting: "run.waiting",
+  runResumed: "run.resumed",
+  runCompleted: "run.completed",
+  runFailed: "run.failed",
+  runCancelled: "run.cancelled",
+  stepStarted: "step.started",
+  stepProgress: "step.progress",
+  stepCompleted: "step.completed",
+  stepFailed: "step.failed",
+  stepSkipped: "step.skipped",
+  logAppended: "log.appended",
+  datasetLifecycle: "dataset.lifecycle",
+  activityObserved: "activity.observed",
+  workCounters: "work.counters"
+};
+var SEARCHABLE_EVENT_FIELDS = [
+  "kind",
+  "runId",
+  "playName",
+  "source",
+  "occurredAt"
+];
+var RUN_SNAPSHOT_DESTINATION = {
+  searchIndex: "planet_scale_runtime_event_index",
+  markedRunStore: "planet_scale",
+  planetScaleContent: "event_payload",
+  convexProjection: "run_snapshot",
+  convexRetainedFacts: ["saved_play_rollup_if_eligible"],
+  legacyConvexDestination: "run_ledger_history",
+  explanation: "PlanetScale retains the complete event. Convex reduces it into bounded current run state and keeps only selected saved-Play rollup facts when eligible; unmarked legacy runs retain Convex event history."
+};
+var RUN_CREATED_DESTINATION = {
+  ...RUN_SNAPSHOT_DESTINATION,
+  convexRetainedFacts: ["admission_fence", "saved_play_rollup_if_eligible"],
+  explanation: "PlanetScale retains the complete event. Convex uses it for the live run snapshot, retains the admission fence, and may retain a saved-Play rollup fact; unmarked legacy runs retain Convex event history."
+};
+var RUN_LOG_DESTINATION = {
+  searchIndex: "planet_scale_runtime_event_index",
+  markedRunStore: "planet_scale",
+  planetScaleContent: "log_body",
+  convexProjection: null,
+  convexRetainedFacts: [],
+  legacyConvexDestination: "run_log_stream",
+  explanation: "PlanetScale retains the canonical log line and its search metadata. Marked-run log bodies are not copied into Convex; unmarked legacy runs continue to use the Convex Run Log Stream."
+};
+var RUN_EVENT_KIND_CATALOG = {
+  [RUN_EVENT_KIND.runCreated]: {
+    description: "The run was admitted and received its run ID.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.created"],
+    destination: RUN_CREATED_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runCreated,
+      seq: 1
+    }
+  },
+  [RUN_EVENT_KIND.runStarted]: {
+    description: "The run began execution.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.started"],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runStarted,
+      seq: 2
+    }
+  },
+  [RUN_EVENT_KIND.runWaiting]: {
+    description: "The run entered a durable wait.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.waiting"],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runWaiting,
+      waitKind: "sleep"
+    }
+  },
+  [RUN_EVENT_KIND.runResumed]: {
+    description: "The run resumed after a durable wait.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.resumed"],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runResumed
+    }
+  },
+  [RUN_EVENT_KIND.runCompleted]: {
+    description: "The run completed successfully.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.completed", "runner.logs"],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runCompleted
+    }
+  },
+  [RUN_EVENT_KIND.runFailed]: {
+    description: "The run ended with a failure.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.failed", "runner.logs"],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runFailed,
+      error: "Request timed out"
+    }
+  },
+  [RUN_EVENT_KIND.runCancelled]: {
+    description: "The run was cancelled.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: ["run.cancelled"],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.runCancelled
+    }
+  },
+  [RUN_EVENT_KIND.stepStarted]: {
+    description: "A named step began execution.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.stepStarted,
+      stepId: "lookup"
+    }
+  },
+  [RUN_EVENT_KIND.stepProgress]: {
+    description: "A named step reported progress.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.stepProgress,
+      stepId: "lookup"
+    }
+  },
+  [RUN_EVENT_KIND.stepCompleted]: {
+    description: "A named step completed.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.stepCompleted,
+      stepId: "lookup"
+    }
+  },
+  [RUN_EVENT_KIND.stepFailed]: {
+    description: "A named step failed.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.stepFailed,
+      stepId: "lookup"
+    }
+  },
+  [RUN_EVENT_KIND.stepSkipped]: {
+    description: "A named step was skipped.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.stepSkipped,
+      stepId: "lookup"
+    }
+  },
+  [RUN_EVENT_KIND.logAppended]: {
+    description: "A text log line was appended to the unified run history and log view.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.waiting",
+      "run.resumed",
+      "run.completed",
+      "run.failed",
+      "runner.logs",
+      "run.wait_timeout"
+    ],
+    destination: RUN_LOG_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.logAppended,
+      lines: ["Waiting for integration_event:contact.updated."]
+    }
+  },
+  [RUN_EVENT_KIND.datasetLifecycle]: {
+    description: "A run dataset was registered, made available, or failed.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.datasetLifecycle,
+      phase: "available"
+    }
+  },
+  [RUN_EVENT_KIND.activityObserved]: {
+    description: "The runtime recorded an activity observation.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.activityObserved
+    }
+  },
+  [RUN_EVENT_KIND.workCounters]: {
+    description: "A work segment reported logical call, provider request, and rate-limit counters.",
+    searchableFields: SEARCHABLE_EVENT_FIELDS,
+    outboxCarriers: [
+      "run.events",
+      "run.completed",
+      "run.failed",
+      "runner.logs"
+    ],
+    destination: RUN_SNAPSHOT_DESTINATION,
+    example: {
+      runId: "play/enrich/run/abc123",
+      type: RUN_EVENT_KIND.workCounters,
+      attempt: 1,
+      logicalCalls: 4,
+      providerRequests: 4,
+      provider429s: 0,
+      final: true
+    }
+  }
+};
+var RUN_EVENT_KINDS = Object.freeze(
+  Object.keys(RUN_EVENT_KIND_CATALOG)
+);
+var RUN_SCHEDULER_OUTBOX_EVENT_TYPE = {
+  runCreated: RUN_EVENT_KIND.runCreated,
+  runStarted: RUN_EVENT_KIND.runStarted,
+  runWaiting: RUN_EVENT_KIND.runWaiting,
+  runResumed: RUN_EVENT_KIND.runResumed,
+  runCompleted: RUN_EVENT_KIND.runCompleted,
+  runFailed: RUN_EVENT_KIND.runFailed,
+  runCancelled: RUN_EVENT_KIND.runCancelled,
+  runEvents: "run.events",
+  runnerLogs: "runner.logs",
+  runWaitTimeout: "run.wait_timeout"
+};
+var RUN_SCHEDULER_OUTBOX_EVENT_TYPES = Object.freeze(
+  Object.values(RUN_SCHEDULER_OUTBOX_EVENT_TYPE)
+);
+var RUN_SCHEDULER_OUTBOX_START_EVENT_TYPES = [
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCreated,
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runStarted
+];
+var RUN_SCHEDULER_OUTBOX_PREFIX_STOP_EVENT_TYPES = [
+  ...RUN_SCHEDULER_OUTBOX_START_EVENT_TYPES,
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runEvents
+];
+var RUN_SCHEDULER_OUTBOX_TERMINAL_EVENT_TYPES = [
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCompleted,
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runFailed,
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCancelled
+];
+var RUN_EVENT_CONVEX_INTERNAL_KIND = {
+  rollupMembershipAdded: "rollup.membership.added",
+  rollupMembershipRemoved: "rollup.membership.removed"
+};
+var RUN_RECEIPT_SEARCH_KIND = {
+  completed: "receipt.completed",
+  failed: "receipt.failed",
+  skipped: "receipt.skipped"
+};
+var RUN_RECEIPT_SEARCH_KIND_CATALOG = {
+  [RUN_RECEIPT_SEARCH_KIND.completed]: {
+    description: "A durable work receipt completed.",
+    searchIndex: "planet_scale_runtime_event_index",
+    payloadStore: "authoritative_work_receipt"
+  },
+  [RUN_RECEIPT_SEARCH_KIND.failed]: {
+    description: "A durable work receipt failed.",
+    searchIndex: "planet_scale_runtime_event_index",
+    payloadStore: "authoritative_work_receipt"
+  },
+  [RUN_RECEIPT_SEARCH_KIND.skipped]: {
+    description: "A durable work receipt was skipped.",
+    searchIndex: "planet_scale_runtime_event_index",
+    payloadStore: "authoritative_work_receipt"
+  }
+};
+var RUN_EVENT_SEARCH_FALLBACK_KIND = "runtime.event";
+var RUN_EVENT_SEARCH_KIND_VALUES = Object.freeze([
+  ...RUN_EVENT_KINDS,
+  ...Object.keys(RUN_RECEIPT_SEARCH_KIND_CATALOG),
+  RUN_EVENT_SEARCH_FALLBACK_KIND
+]);
+var RUN_EVENT_TERMINAL_KIND_VALUES = [
+  RUN_EVENT_KIND.runCompleted,
+  RUN_EVENT_KIND.runFailed,
+  RUN_EVENT_KIND.runCancelled
+];
+var RUN_LOG_RETENTION_MAX_BYTES = 5 * 1024 * 1024;
+function sqlStringLiteral(value) {
+  return "'" + value.replaceAll("'", "''") + "'";
+}
+var RUN_EVENT_KNOWN_KIND_SQL_LIST = RUN_EVENT_KINDS.map(sqlStringLiteral).join(", ");
+var RUN_EVENT_LIFECYCLE_KIND_SQL_LIST = [
+  RUN_EVENT_KIND.runCreated,
+  RUN_EVENT_KIND.runStarted,
+  RUN_EVENT_KIND.runWaiting,
+  RUN_EVENT_KIND.runResumed,
+  RUN_EVENT_KIND.runCompleted,
+  RUN_EVENT_KIND.runFailed,
+  RUN_EVENT_KIND.runCancelled
+].map(sqlStringLiteral).join(", ");
+var RUN_EVENT_SNAPSHOT_KIND_SQL_LIST = RUN_EVENT_KINDS.filter(
+  (kind) => kind !== RUN_EVENT_KIND.logAppended
+).map(sqlStringLiteral).join(", ");
+var RUN_EVENT_KIND_SQL_LITERAL = {
+  runCreated: sqlStringLiteral(RUN_EVENT_KIND.runCreated),
+  runStarted: sqlStringLiteral(RUN_EVENT_KIND.runStarted),
+  runWaiting: sqlStringLiteral(RUN_EVENT_KIND.runWaiting),
+  runResumed: sqlStringLiteral(RUN_EVENT_KIND.runResumed),
+  runCompleted: sqlStringLiteral(RUN_EVENT_KIND.runCompleted),
+  runFailed: sqlStringLiteral(RUN_EVENT_KIND.runFailed),
+  runCancelled: sqlStringLiteral(RUN_EVENT_KIND.runCancelled),
+  stepStarted: sqlStringLiteral(RUN_EVENT_KIND.stepStarted),
+  stepProgress: sqlStringLiteral(RUN_EVENT_KIND.stepProgress),
+  stepCompleted: sqlStringLiteral(RUN_EVENT_KIND.stepCompleted),
+  stepFailed: sqlStringLiteral(RUN_EVENT_KIND.stepFailed),
+  stepSkipped: sqlStringLiteral(RUN_EVENT_KIND.stepSkipped),
+  logAppended: sqlStringLiteral(RUN_EVENT_KIND.logAppended),
+  datasetLifecycle: sqlStringLiteral(RUN_EVENT_KIND.datasetLifecycle),
+  activityObserved: sqlStringLiteral(RUN_EVENT_KIND.activityObserved),
+  workCounters: sqlStringLiteral(RUN_EVENT_KIND.workCounters)
+};
+var RUN_SCHEDULER_OUTBOX_EVENT_TYPE_SQL_LITERAL = {
+  runCreated: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCreated),
+  runStarted: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runStarted),
+  runWaiting: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runWaiting),
+  runResumed: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runResumed),
+  runCompleted: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCompleted),
+  runFailed: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runFailed),
+  runCancelled: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCancelled),
+  runEvents: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runEvents),
+  runnerLogs: sqlStringLiteral(RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runnerLogs),
+  runWaitTimeout: sqlStringLiteral(
+    RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runWaitTimeout
+  )
+};
+var RUN_EVENT_CONVEX_INTERNAL_KIND_SQL_LITERAL = {
+  rollupMembershipAdded: sqlStringLiteral(
+    RUN_EVENT_CONVEX_INTERNAL_KIND.rollupMembershipAdded
+  ),
+  rollupMembershipRemoved: sqlStringLiteral(
+    RUN_EVENT_CONVEX_INTERNAL_KIND.rollupMembershipRemoved
+  )
+};
+var RUN_EVENT_TERMINAL_LOG_CARRIER_SQL_LIST = [
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runCompleted,
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runFailed,
+  RUN_SCHEDULER_OUTBOX_EVENT_TYPE.runnerLogs
+].map(sqlStringLiteral).join(", ");
+var RUN_SCHEDULER_OUTBOX_TERMINAL_EVENT_TYPE_SQL_LIST = [
+  ...RUN_SCHEDULER_OUTBOX_TERMINAL_EVENT_TYPES
+].map(sqlStringLiteral).join(", ");
+var RUN_EVENT_SEARCH_FALLBACK_KIND_SQL_LITERAL = sqlStringLiteral(
+  RUN_EVENT_SEARCH_FALLBACK_KIND
+);
+
+// ../play-runtime/run-ledger.ts
+var TERMINAL_STATUS_BY_EVENT_TYPE = {
+  [RUN_EVENT_KIND.runCompleted]: "completed",
+  [RUN_EVENT_KIND.runFailed]: "failed",
+  [RUN_EVENT_KIND.runCancelled]: "cancelled"
+};
+
 // ../play-runtime/run-lifecycle-policy.ts
 var TERMINAL_PLAY_RUN_STATUSES = /* @__PURE__ */ new Set([
   "completed",

package/dist/install-integrity.json

@@ -303,6 +303,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/receipt-status.ts",
     "dist/bundling-sources/shared_libs/play-runtime/resource-governor.ts",
     "dist/bundling-sources/shared_libs/play-runtime/row-isolation.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/run-event-catalog.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-execution-scope.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-execution-state.ts",
     "dist/bundling-sources/shared_libs/play-runtime/run-failure.ts",

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.271";
+    readonly version: "0.3.272";
     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.271";
+    readonly version: "0.3.272";
     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.271",
+  version: "0.3.272",
   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.271",
+  version: "0.3.272",
   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.271",
+  "version": "0.3.272",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",