deepline 0.3.266 → 0.3.268

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

@@ -114,6 +114,7 @@ import type {
   CustomerDbQueryResult,
   DeeplineAgentModelDescription,
   InferenceQuote,
+  ChildRunSummary,
 } from './types.js';
 import { isStopAllPlayRunsDryRunResult } from './types.js';
 import type { MonitorDefinition } from './monitors.js';
@@ -662,6 +663,22 @@ export type RunsGetOptions = {
   failedLogLimit?: number;
 };
 
+export type RunsChildrenOptions = {
+  /** Required authored `ctx.runPlayAsync` launch key. */
+  launchKey: string;
+  /** Opaque cursor returned by the preceding page. */
+  cursor?: string;
+  /** Rows to request (1–50; defaults to 50). */
+  limit?: number;
+};
+
+/** One bounded page of direct child Runs for one async launch. */
+export type RunChildrenPage = {
+  children: ChildRunSummary[];
+  nextCursor: string | null;
+  hasMore: boolean;
+};
+
 export type RunGetStatus =
   | {
       available: false;
@@ -890,6 +907,11 @@ export type RunsNamespace = {
   ) => Promise<import('./runs/receipts').RunToolReceiptsResponse>;
   /** Get current run status by public run id. */
   get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
+  /** Read one bounded page of direct children for an async launch. */
+  children: (
+    parentRunId: string,
+    options: RunsChildrenOptions,
+  ) => Promise<RunChildrenPage>;
   /**
    * @deprecated Use `client.runs.get(runId)` for status, progress, logs, and results.
    * This scalar-only reader remains for compatibility with existing callers.
@@ -2648,6 +2670,8 @@ export class DeeplineClient {
     this.runs = {
       getReceipts: (runId, options) => this.getRunReceipts(runId, options),
       get: (runId, options) => this.getRunStatus(runId, options),
+      children: (parentRunId, options) =>
+        this.getRunChildren(parentRunId, options),
       status: (runId) => this.getRunLifecycleStatus(runId),
       list: (options) => this.listRuns(options),
       listPage: (options) => this.listRunsPage(options),
@@ -4220,6 +4244,39 @@ export class DeeplineClient {
     };
   }
 
+  /** Read one paginated, launch-scoped page of direct child Runs. */
+  async getRunChildren(
+    parentRunId: string,
+    options: RunsChildrenOptions,
+  ): Promise<RunChildrenPage> {
+    const launchKey = options.launchKey.trim();
+    if (!launchKey) {
+      throw new DeeplineError(
+        'runs.children requires a nonempty launchKey.',
+        undefined,
+        'INVALID_CHILD_RUN_LAUNCH_KEY',
+      );
+    }
+    if (
+      options.limit !== undefined &&
+      (!Number.isInteger(options.limit) ||
+        options.limit < 1 ||
+        options.limit > 50)
+    ) {
+      throw new DeeplineError(
+        'runs.children limit must be an integer from 1 to 50.',
+        undefined,
+        'INVALID_CHILD_RUN_PAGE_LIMIT',
+      );
+    }
+    const params = new URLSearchParams({ launchKey });
+    if (options.cursor !== undefined) params.set('cursor', options.cursor);
+    if (options.limit !== undefined) params.set('limit', String(options.limit));
+    return this.http.get<RunChildrenPage>(
+      `/api/v2/runs/${encodeURIComponent(parentRunId)}/children?${params.toString()}`,
+    );
+  }
+
   /** Fetch only the legacy scalar lifecycle status for a run.
    *
    * @deprecated Use `client.runs.get(runId)` for the canonical run read.

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

@@ -144,6 +144,8 @@ export type {
   PlaysListPage,
   RunsLogsOptions,
   RunsLogsResult,
+  RunChildrenPage,
+  RunsChildrenOptions,
   RunsEventSearchOptions,
   RunsEventSearchEntry,
   RunsEventSearchResult,
@@ -156,6 +158,7 @@ export type {
   ExecutionRecovery,
   ExecutionByKeyResult,
 } from './client.js';
+export type { ChildRunSummary } from './types.js';
 
 // ——— Monitors framework ———
 export { defineMonitor } from './monitors.js';

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.266',
+  version: '0.3.268',
   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/play-runtime/app-runtime-api.ts

@@ -265,6 +265,7 @@ type RuntimeApiRequest =
       schedulerBackend?: string | null;
       schedulerSchema?: string | null;
       runLogStore?: 'planet_scale';
+      runEventStore?: 'planet_scale';
       executionProfile?: string | null;
       runtimeReleaseId?: string | null;
       runtimeDeployVersion?: string | null;

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

@@ -25,7 +25,10 @@ import type {
   PlayRunnerRuntimeTiming,
 } from '../protocol';
 import { PROD_DEFAULT_RUNTIME_SCHEDULER_SCHEMA } from '../runtime-scheduler-topology';
-import { RUNTIME_EVENT_SEARCH_OUTBOX_PROJECTION_MARKER } from './runtime-event-search';
+import {
+  RUNTIME_EVENT_CANONICAL_RETENTION_INDEX_READY_MARKER,
+  RUNTIME_EVENT_SEARCH_OUTBOX_PROJECTION_MARKER,
+} from './runtime-event-search';
 import type { PlayRunnerRuntimeResource } from '../runner-backends/types';
 import {
   RuntimeSandboxOperationState,
@@ -317,7 +320,9 @@ const POSTGRES_SCHEDULER_SCHEMA_INIT_STATEMENT_TIMEOUT_MS = 60_000;
 // v53 refreshes the indexed runtime log reconciliation projection. Its query
 // indexes remain operator-prepared concurrently, outside shared bootstrap.
 // v54 expands the optional per-run canonical event-store marker.
-export const POSTGRES_SCHEDULER_SCHEMA_VERSION = 54;
+// v55 refreshes the unified event journal projection. The canonical retention
+// index stays operator-prepared concurrently before marked-run admission.
+export const POSTGRES_SCHEDULER_SCHEMA_VERSION = 55;
 const POSTGRES_SCHEDULER_SCHEMA_MIGRATIONS_TABLE =
   'scheduler_schema_migrations';
 export const POSTGRES_SCHEDULER_OPEN_RECOVERY_INDEX =
@@ -985,6 +990,36 @@ function newRunLogStoreSql(
   ) THEN 'planet_scale' END`;
 }
 
+/** Only new immutable admissions opt into the full typed event journal. */
+function newRunEventStoreSql(
+  launchSql: 'launch_payload.launch_json',
+  options?: Pick<PostgresSchedulerOptions, 'schema'>,
+): string {
+  return `CASE WHEN ${launchSql} ? 'playReference' AND EXISTS (
+    SELECT 1 FROM pg_proc AS proc
+    JOIN pg_namespace AS namespace ON namespace.oid = proc.pronamespace
+    WHERE namespace.nspname = '${schemaName(options).replace(/'/g, "''")}'
+      AND proc.proname = 'search_outbox_event'
+      AND obj_description(proc.oid, 'pg_proc') = '${RUNTIME_EVENT_SEARCH_OUTBOX_PROJECTION_MARKER.replace(/'/g, "''")}'
+  ) AND EXISTS (
+    SELECT 1 FROM pg_index AS index_row
+      WHERE index_row.indexrelid = to_regclass('runtime_observability.runtime_events_canonical_retention_idx')
+        AND index_row.indisready AND index_row.indisvalid
+        AND obj_description(index_row.indexrelid, 'pg_class') = '${RUNTIME_EVENT_CANONICAL_RETENTION_INDEX_READY_MARKER.replace(/'/g, "''")}'
+  ) AND to_regclass('runtime_observability.runtime_event_order_seq') IS NOT NULL
+    AND EXISTS (
+      SELECT 1 FROM pg_attribute AS event_column
+       WHERE event_column.attrelid = to_regclass('runtime_observability.events')
+         AND event_column.attname = 'event_seq' AND event_column.attnum > 0
+         AND NOT event_column.attisdropped
+    ) AND EXISTS (
+      SELECT 1 FROM pg_attribute AS payload_column
+       WHERE payload_column.attrelid = to_regclass('runtime_observability.events')
+         AND payload_column.attname = 'event_payload' AND payload_column.attnum > 0
+         AND NOT payload_column.attisdropped
+  ) THEN 'planet_scale' END`;
+}
+
 function tableName(
   table: string,
   options?: Pick<PostgresSchedulerOptions, 'schema'>,
@@ -5041,7 +5076,8 @@ async function submitPostgresSchedulerRunTransaction(
           status,
           absurd_task_id,
           admission_json,
-          run_log_store
+          run_log_store,
+          run_event_store
         )
         SELECT $1, $2, $3, $4, $5, $6, $7, launch_payload.launch_json, coalesce(nullif(launch_payload.launch_json -> 'input', 'null'::jsonb), '{}'::jsonb), 'queued',
                (SELECT task_id FROM task_spawn),
@@ -5054,7 +5090,8 @@ async function submitPostgresSchedulerRunTransaction(
                  'coordinatorInternalToken',
                  'vercelProtectionBypassToken'
                ]::text[],
-               ${newRunLogStoreSql('launch_payload.launch_json', options)}
+               ${newRunLogStoreSql('launch_payload.launch_json', options)},
+               ${newRunEventStoreSql('launch_payload.launch_json', options)}
         FROM admission
         CROSS JOIN launch_payload
         WHERE NOT existing_run
@@ -5062,7 +5099,7 @@ async function submitPostgresSchedulerRunTransaction(
           AND parent_accepting
           AND NOT ${existingOnlySql}
         ON CONFLICT (run_id) DO NOTHING
-        RETURNING run_id, absurd_task_id, run_log_store
+        RETURNING run_id, absurd_task_id, run_log_store, run_event_store
       ), run_recovery AS (
         UPDATE ${tableName('runs', options)} AS runs
         SET absurd_task_id = (SELECT task_id FROM task_spawn),
@@ -5111,6 +5148,7 @@ async function submitPostgresSchedulerRunTransaction(
             'schedulerBackend', launch_payload.launch_json ->> 'schedulerBackend',
             'schedulerSchema', COALESCE(launch_payload.launch_json ->> 'schedulerSchema', '${schemaName(options)}'),
             'runLogStore', run_insert.run_log_store,
+            'runEventStore', run_insert.run_event_store,
             'executionProfile', launch_payload.launch_json ->> 'executionProfile',
             'runtimeReleaseId', launch_payload.launch_json ->> 'runtimeReleaseId',
             'runtimeDeployVersion', launch_payload.launch_json ->> 'runtimeDeployVersion',
@@ -6113,7 +6151,7 @@ export async function firePostgresSchedulerCronSchedule(
         INSERT INTO ${tableName('runs', options)} (
           run_id, org_id, play_id, play_name, graph_hash, runtime_profile,
           artifact_storage_key, launch_json, input_json, status,
-          absurd_task_id, admission_json, run_log_store
+          absurd_task_id, admission_json, run_log_store, run_event_store
         )
         SELECT $5::text,
                launch_payload.launch_json ->> 'orgId',
@@ -6135,12 +6173,13 @@ export async function firePostgresSchedulerCronSchedule(
                  'coordinatorInternalToken',
                  'vercelProtectionBypassToken'
                ]::text[],
-               ${newRunLogStoreSql('launch_payload.launch_json', options)}
+               ${newRunLogStoreSql('launch_payload.launch_json', options)},
+               ${newRunEventStoreSql('launch_payload.launch_json', options)}
         FROM occurrence
         CROSS JOIN launch_payload
         WHERE occurrence.schedule_current
           AND NOT occurrence.existing_run
-        RETURNING run_id, run_log_store
+        RETURNING run_id, run_log_store, run_event_store
       ), occurrence_admitted AS MATERIALIZED (
         SELECT true AS admitted
         FROM occurrence
@@ -6188,6 +6227,7 @@ export async function firePostgresSchedulerCronSchedule(
             'schedulerBackend', launch_payload.launch_json ->> 'schedulerBackend',
             'schedulerSchema', COALESCE(launch_payload.launch_json ->> 'schedulerSchema', '${schemaName(options)}'),
             'runLogStore', run_insert.run_log_store,
+            'runEventStore', run_insert.run_event_store,
             'executionProfile', launch_payload.launch_json ->> 'executionProfile',
             'runtimeReleaseId', launch_payload.launch_json ->> 'runtimeReleaseId',
             'runtimeDeployVersion', launch_payload.launch_json ->> 'runtimeDeployVersion',
@@ -18040,18 +18080,23 @@ export async function markPostgresSchedulerOutboxDeliveredRows(
   }>(
     `
       WITH delivered AS (
-        UPDATE ${tableName('outbox', options)}
+        UPDATE ${tableName('outbox', options)} AS outbox
         SET delivered_at = now(),
             next_attempt_at = NULL,
             last_error_json = NULL,
             lease_owner = NULL,
-            lease_expires_at = NULL
-        WHERE event_id = ANY($1::text[])
-          AND delivered_at IS NULL
-          AND ($2::text IS NULL OR lease_owner = $2)
-        RETURNING event_id,
-                  event_type,
-                  (extract(epoch FROM (delivered_at - created_at)) * 1000)::float8
+            lease_expires_at = NULL,
+            payload_json = CASE WHEN EXISTS (
+              SELECT 1 FROM ${tableName('runs', options)} AS run
+               WHERE run.run_id = outbox.run_id
+                 AND run.run_event_store = 'planet_scale'
+            ) THEN '{}'::jsonb ELSE outbox.payload_json END
+        WHERE outbox.event_id = ANY($1::text[])
+          AND outbox.delivered_at IS NULL
+          AND ($2::text IS NULL OR outbox.lease_owner = $2)
+        RETURNING outbox.event_id,
+                  outbox.event_type,
+                  (extract(epoch FROM (outbox.delivered_at - outbox.created_at)) * 1000)::float8
                     AS lag_ms
       )
       SELECT event_id,
@@ -19238,6 +19283,9 @@ async function projectPostgresSchedulerCreatedEvent(
     ...(value('runLogStore') === 'planet_scale'
       ? { runLogStore: 'planet_scale' as const }
       : {}),
+    ...(value('runEventStore') === 'planet_scale'
+      ? { runEventStore: 'planet_scale' as const }
+      : {}),
     executionProfile: value('executionProfile'),
     runtimeReleaseId: value('runtimeReleaseId'),
     runtimeDeployVersion: value('runtimeDeployVersion'),