deepline 0.1.288 → 0.1.290

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

@@ -443,6 +443,8 @@ export type RunsListOptions = {
   play?: string;
   status?: string;
   limit?: number;
+  /** Zero-based page offset. Requires `play` because status-only inventory is not paginated. */
+  offset?: number;
 };
 
 /** Options for `client.runs.get(...)`. */
@@ -2952,6 +2954,21 @@ export class DeeplineClient {
     if (typeof options.limit === 'number' && Number.isFinite(options.limit)) {
       params.set('limit', String(Math.max(1, Math.floor(options.limit))));
     }
+    if (options.offset !== undefined) {
+      if (
+        !Number.isFinite(options.offset) ||
+        !Number.isInteger(options.offset) ||
+        options.offset < 0
+      ) {
+        throw new Error(
+          'runs.list options.offset must be a non-negative integer.',
+        );
+      }
+      if (!playName && options.offset > 0) {
+        throw new Error('runs.list options.offset requires options.play.');
+      }
+      params.set('offset', String(options.offset));
+    }
     if (!playName && !status) {
       throw new Error('runs.list requires options.play or options.status.');
     }

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

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.288',
+  version: '0.1.290',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-lifecycle.ts

@@ -27,7 +27,8 @@ const DAYTONA_NETWORK_ALLOW_LIST_ENV = 'DEEPLINE_DAYTONA_NETWORK_ALLOW_LIST';
 
 export const DAYTONA_CANCELLED_ERROR = 'Daytona play runner cancelled';
 
-export type DaytonaClient = Pick<Daytona, 'create'>;
+export type DaytonaClient = Pick<Daytona, 'create'> &
+  Partial<Pick<Daytona, 'get'>>;
 export type DaytonaSandbox = Awaited<ReturnType<DaytonaClient['create']>>;
 export type DaytonaExecutionContext = PlayRunnerExecutionConfig['context'];
 export type DaytonaStageEmitter = (
@@ -37,6 +38,7 @@ export type DaytonaStageEmitter = (
 
 export type AcquiredDaytonaSandbox = {
   sandbox: DaytonaSandbox;
+  daytonaOrganizationId: string;
   billingStartedAt: number;
   billingEndedAt?: number;
 };
@@ -56,6 +58,22 @@ type DaytonaCreateResult = {
   attemptElapsedMs: number;
 };
 
+async function rejectAcquiredSandbox(
+  sandbox: DaytonaSandbox,
+  reason: string,
+): Promise<never> {
+  try {
+    await sandbox.delete(30);
+  } catch (error) {
+    const cleanupError = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `${reason} Defensive deletion of Daytona sandbox ${sandbox.id} also failed: ${cleanupError}`,
+      { cause: error },
+    );
+  }
+  throw new Error(reason);
+}
+
 function normalizeLabelValue(value: string | null | undefined): string | null {
   const trimmed = value?.trim();
   return trimmed ? trimmed.slice(0, 63) : null;
@@ -233,7 +251,15 @@ async function createRetriedOneShotDaytonaSandbox(input: {
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       errors.push(message);
+      input.emitStage('create:attempt_failed', {
+        attempt,
+        elapsedMs: Date.now() - input.startedAt,
+        attemptElapsedMs: Date.now() - attemptStartedAt,
+        error: message,
+      });
       console.warn('[play-runner.daytona.create_attempt_failed]', {
+        workflowId: input.context.workflowId ?? null,
+        runId: input.context.runId ?? null,
         attempt,
         error: message,
       });
@@ -265,11 +291,46 @@ async function acquireOneShotDaytonaSandbox(input: {
     granted.diskGiB !== DAYTONA_SANDBOX_DISK_GIB ||
     granted.gpu !== DAYTONA_SANDBOX_GPU
   ) {
-    await result.sandbox.delete(30).catch(() => undefined);
-    throw new Error(
+    await rejectAcquiredSandbox(
+      result.sandbox,
       `Daytona sandbox resource boundary mismatch: expected cpu=${DAYTONA_SANDBOX_CPU} memoryGiB=${DAYTONA_SANDBOX_MEMORY_GIB} diskGiB=${DAYTONA_SANDBOX_DISK_GIB} gpu=${DAYTONA_SANDBOX_GPU}, granted cpu=${granted.cpu} memoryGiB=${granted.memoryGiB} diskGiB=${granted.diskGiB} gpu=${granted.gpu}`,
     );
   }
+  const configuredOrganizationId =
+    process.env.DAYTONA_ORGANIZATION_ID?.trim() || null;
+  const observedOrganizationId = result.sandbox.organizationId?.trim() || null;
+  if (
+    configuredOrganizationId &&
+    observedOrganizationId &&
+    configuredOrganizationId !== observedOrganizationId
+  ) {
+    await rejectAcquiredSandbox(
+      result.sandbox,
+      'Daytona sandbox organization routing mismatch. Refusing to run customer code in a sandbox whose observed organization differs from the configured organization.',
+    );
+  }
+  let lookupOrganizationId: string | null = null;
+  if (
+    !observedOrganizationId &&
+    !configuredOrganizationId &&
+    input.daytona.get
+  ) {
+    try {
+      const lookedUpSandbox = await input.daytona.get(result.sandbox.id);
+      lookupOrganizationId = lookedUpSandbox.organizationId?.trim() || null;
+    } catch {
+      // The failure below is intentionally about the invariant, not the
+      // provider response. The newly created sandbox is still deleted.
+    }
+  }
+  const daytonaOrganizationId =
+    observedOrganizationId ?? configuredOrganizationId ?? lookupOrganizationId;
+  if (!daytonaOrganizationId) {
+    return await rejectAcquiredSandbox(
+      result.sandbox,
+      'Daytona sandbox organization routing identity is missing. Refusing to run customer code without a durable cleanup routing domain.',
+    );
+  }
   const billingStartedAt = Date.now();
   const sandbox = result.sandbox;
   input.emitStage('create:done', {
@@ -281,7 +342,7 @@ async function acquireOneShotDaytonaSandbox(input: {
     memoryGiB: granted.memoryGiB,
     diskGiB: granted.diskGiB,
   });
-  return { sandbox, billingStartedAt };
+  return { sandbox, daytonaOrganizationId, billingStartedAt };
 }
 
 export function createOneShotDaytonaSandboxLifecycle(input: {

package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-payload-transport.ts

@@ -61,6 +61,7 @@ export type StagedDaytonaPayload = {
   command: string;
   outputPath: string;
   exitCodePath: string;
+  runtimeCompletedPath: string;
   progressEventPath: string;
 };
 
@@ -557,6 +558,7 @@ export async function stageDaytonaRunnerPayload(input: {
     command,
     outputPath,
     exitCodePath,
+    runtimeCompletedPath,
     progressEventPath,
   };
 }

package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona.ts

@@ -289,27 +289,161 @@ export async function inspectDetachedDaytonaRunner(input: {
   }
 }
 
-export async function deleteDaytonaSandboxById(input: {
+/** Read the runner's exact customer-code completion fence before terminal GC. */
+export async function readDetachedDaytonaRuntimeCompletion(input: {
+  sandboxId: string;
+  runtimeCompletedPath: string;
+}): Promise<number | null> {
+  try {
+    const { clientOptions } = loadDaytonaRequiredConfig();
+    const sandbox = (await daytonaSdkClientFactory
+      .createFull(clientOptions)
+      .get(input.sandboxId)) as DaytonaSandbox;
+    const marker = JSON.parse(
+      (await sandbox.fs.downloadFile(input.runtimeCompletedPath, 5)).toString(
+        'utf-8',
+      ),
+    ) as { at?: unknown };
+    return typeof marker.at === 'number' && Number.isFinite(marker.at)
+      ? marker.at
+      : null;
+  } catch (error) {
+    console.warn(
+      '[play-runner.daytona.runtime_completion_marker_unavailable]',
+      {
+        sandboxId: input.sandboxId,
+        // Path is generated per attempt and contains no customer data.
+        runtimeCompletedPath: input.runtimeCompletedPath,
+        error: error instanceof Error ? error.message : String(error),
+      },
+    );
+    return null;
+  }
+}
+
+export type DaytonaSandboxDeleteOutcome =
+  | {
+      kind: 'deleted' | 'already_absent';
+      organizationId: string | null;
+    }
+  | {
+      kind: 'timed_out' | 'rate_limited' | 'failed';
+      organizationId: string | null;
+      code: string;
+      detail: string;
+    };
+
+export async function deleteDaytonaSandboxByIdWithOutcome(input: {
   sandboxId: string;
   timeoutSeconds?: number;
-}): Promise<boolean> {
+  expectedOrganizationId?: string | null;
+  allowUnscopedAlreadyAbsent?: boolean;
+}): Promise<DaytonaSandboxDeleteOutcome> {
   const sandboxId = input.sandboxId?.trim();
-  if (!sandboxId) return false;
+  const expectedOrganizationId = input.expectedOrganizationId?.trim() || null;
+  if (!sandboxId) {
+    return {
+      kind: 'failed',
+      organizationId: expectedOrganizationId,
+      code: 'invalid_sandbox_id',
+      detail: 'Sandbox ID is required.',
+    };
+  }
   try {
     const { clientOptions } = loadDaytonaRequiredConfig();
     const daytona = daytonaSdkClientFactory.createFull(clientOptions);
     const sandbox = await daytona.get(sandboxId);
+    const observedOrganizationId = sandbox.organizationId?.trim() || null;
+    if (
+      expectedOrganizationId &&
+      observedOrganizationId !== expectedOrganizationId
+    ) {
+      return {
+        kind: 'failed',
+        organizationId: observedOrganizationId,
+        code: 'wrong_routing_domain',
+        detail: 'Sandbox belongs to a different Daytona organization.',
+      };
+    }
     await daytona.delete(sandbox, input.timeoutSeconds ?? 30);
-    return true;
+    return {
+      kind: 'deleted',
+      organizationId: observedOrganizationId,
+    };
   } catch (error) {
+    const failure = describeDaytonaLookupFailure(error);
+    // Cleanup is an idempotent "ensure absent" operation. Daytona returning
+    // not-found means another cleanup owner already satisfied the obligation.
+    // The durable expected organization came from the sandbox returned by the
+    // same organization-scoped credential at creation time. When an explicit
+    // worker organization is configured it must still match that evidence;
+    // deployments which rely only on the provider-returned organization retain
+    // that durable creation-domain proof. Legacy eager cleanup retains its
+    // previous unscoped behavior through the explicit compatibility option.
+    if (failure.httpStatus === 404) {
+      const configuredOrganizationId =
+        process.env.DAYTONA_ORGANIZATION_ID?.trim() || null;
+      if (
+        !input.allowUnscopedAlreadyAbsent &&
+        (!expectedOrganizationId ||
+          (configuredOrganizationId &&
+            configuredOrganizationId !== expectedOrganizationId))
+      ) {
+        return {
+          kind: 'failed',
+          organizationId: configuredOrganizationId,
+          code: expectedOrganizationId
+            ? 'wrong_routing_domain'
+            : 'missing_routing_domain',
+          detail:
+            'Daytona returned not-found without an exact creation-domain match.',
+        };
+      }
+      console.info('[play-runner.daytona.reclaim_sandbox_already_absent]', {
+        sandboxId,
+      });
+      return {
+        kind: 'already_absent',
+        organizationId:
+          configuredOrganizationId ?? expectedOrganizationId ?? null,
+      };
+    }
     console.warn('[play-runner.daytona.reclaim_sandbox_delete_failed]', {
       sandboxId,
-      error: error instanceof Error ? error.message : String(error),
+      failure,
     });
-    return false;
+    const timedOut =
+      failure.httpStatus === 408 ||
+      /(?:timeout|timed out|ETIMEDOUT)/i.test(
+        `${failure.errorCode ?? ''} ${failure.detail}`,
+      );
+    return {
+      kind:
+        failure.httpStatus === 429
+          ? 'rate_limited'
+          : timedOut
+            ? 'timed_out'
+            : 'failed',
+      organizationId: expectedOrganizationId,
+      code:
+        failure.errorCode ??
+        (failure.httpStatus ? `http_${failure.httpStatus}` : 'delete_failed'),
+      detail: failure.detail,
+    };
   }
 }
 
+export async function deleteDaytonaSandboxById(input: {
+  sandboxId: string;
+  timeoutSeconds?: number;
+}): Promise<boolean> {
+  const outcome = await deleteDaytonaSandboxByIdWithOutcome({
+    ...input,
+    allowUnscopedAlreadyAbsent: true,
+  });
+  return outcome.kind === 'deleted' || outcome.kind === 'already_absent';
+}
+
 function formatDaytonaExecutionError(error: unknown): string {
   const message = formatDaytonaError(error);
   return isConfiguredDaytonaRuntimeLimit(error)
@@ -630,6 +764,7 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
     let cancellationCleanupStarted = false;
     let activeAcquiredResource: {
       sandbox: DaytonaSandbox;
+      daytonaOrganizationId: string;
       billingStartedAt: number;
       billingEndedAt?: number;
     } | null = null;
@@ -639,6 +774,7 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
     const runtimeResourceReportErrors = new Set<unknown>();
     const reportRuntimeResource = async (acquired: {
       sandbox: DaytonaSandbox;
+      daytonaOrganizationId: string;
       billingStartedAt: number;
       billingEndedAt?: number;
     }) => {
@@ -658,6 +794,7 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
             process.env.DEEPLINE_RUNTIME_ENVIRONMENT === 'preview'
               ? 'preview'
               : 'production',
+          daytonaOrganizationId: acquired.daytonaOrganizationId,
           billingStartedAt: acquired.billingStartedAt,
           billingEndedAt,
           cpu: typeof sandbox.cpu === 'number' ? sandbox.cpu : null,
@@ -673,6 +810,7 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
     };
     const reportRetiringRuntimeResource = async (acquired: {
       sandbox: DaytonaSandbox;
+      daytonaOrganizationId: string;
       billingStartedAt: number;
       billingEndedAt?: number;
     }) => {
@@ -929,6 +1067,7 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
               cmdId: start.cmdId,
               outputPath: stagedPayload.outputPath,
               exitCodePath: stagedPayload.exitCodePath,
+              runtimeCompletedPath: stagedPayload.runtimeCompletedPath,
               startedAtMs: Date.now(),
               ceilingMs: DAYTONA_DETACHED_CEILING_SECONDS * 1_000,
             },
@@ -988,8 +1127,28 @@ export const daytonaPlayRunnerBackend: PlayRunnerBackend = {
       // Resource persistence belongs to the scheduler control plane. Preserve
       // its typed capacity/fence errors so Absurd can defer or fence the
       // attempt; converting them into a runner failure would terminally fail a
-      // play that never began executing customer code.
-      if (runtimeResourceReportErrors.has(error)) throw error;
+      // play that never began executing customer code. The sandbox exists
+      // before that durable callback can succeed, so synchronously delete it
+      // before returning the control-plane error. The old fire-and-forget
+      // cleanup path was skipped by this rethrow and leaked the acquisition.
+      if (runtimeResourceReportErrors.has(error)) {
+        const sandbox = sandboxCleanup.currentSandbox();
+        if (sandbox) {
+          try {
+            await sandbox.delete(30);
+            console.info(
+              '[play-runner.daytona.resource_report_failure_cleanup_done]',
+              { sandboxId: sandbox.id },
+            );
+          } catch (cleanupError) {
+            throw new AggregateError(
+              [error, cleanupError],
+              `Failed to persist or delete acquired Daytona sandbox ${sandbox.id}.`,
+            );
+          }
+        }
+        throw error;
+      }
       emitDaytonaStage(callbacks, config.context, 'execute:error', {
         sandboxId: sandboxCleanup.currentSandbox()?.id ?? null,
         error: formatDaytonaError(error),

package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/types.ts

@@ -13,6 +13,8 @@ export type PlayRunnerRuntimeResource = {
   kind: 'daytona_sandbox';
   sandboxId: string;
   daytonaEnvironment?: 'preview' | 'production';
+  /** Stable, non-secret provider ownership domain returned by Daytona. */
+  daytonaOrganizationId?: string;
   billingStartedAt: number;
   billingEndedAt?: number | null;
   terminalReason?: RuntimeResourceTerminalReason | null;

package/dist/bundling-sources/shared_libs/play-runtime/suspension.ts

@@ -39,6 +39,8 @@ export type PlayExecutionSuspension =
        * timeout-wake salvage verification. */
       outputPath: string;
       exitCodePath: string;
+      /** Exact customer-code completion fence inside the Daytona sandbox. */
+      runtimeCompletedPath?: string;
       startedAtMs: number;
       /** Overall run ceiling; the park timeout. */
       ceilingMs: number;

package/dist/bundling-sources/shared_libs/plays/legacy-webhook-drain.ts

@@ -0,0 +1,110 @@
+export const LEGACY_WEBHOOK_RETRY_CODES = [
+  'ACTIVE_CONCURRENCY_LIMIT',
+  'SCHEDULER_CAPACITY',
+  'TRANSIENT_LAUNCH_FAILURE',
+] as const;
+
+export type LegacyWebhookRetryCode =
+  (typeof LEGACY_WEBHOOK_RETRY_CODES)[number];
+
+export const LEGACY_WEBHOOK_QUARANTINE_CODES = [
+  'PLAY_DEFINITION_MISSING',
+  'PLAY_BINDING_MISSING',
+  'PLAY_BINDING_DISABLED',
+  'PLAY_REVISION_MISSING',
+  'PLAY_REVISION_MISMATCH',
+  'ARTIFACT_RUNTIME_INCOMPATIBLE',
+  'ARTIFACT_REFERENCE_MISSING',
+  'WEBHOOK_PAYLOAD_INVALID',
+  'PLAY_PRE_RUN_VALIDATION_FAILED',
+  'RUN_IDENTITY_CONFLICT',
+  'MAX_DELIVERY_ATTEMPTS_EXCEEDED',
+] as const;
+
+export type LegacyWebhookQuarantineCode =
+  (typeof LEGACY_WEBHOOK_QUARANTINE_CODES)[number];
+
+export function isLegacyWebhookQuarantineCode(
+  value: unknown,
+): value is LegacyWebhookQuarantineCode {
+  return (
+    typeof value === 'string' &&
+    (LEGACY_WEBHOOK_QUARANTINE_CODES as readonly string[]).includes(value)
+  );
+}
+
+export type LegacyWebhookQuarantineFailure =
+  | { code: 'PLAY_DEFINITION_MISSING' }
+  | { code: 'PLAY_BINDING_MISSING' }
+  | { code: 'PLAY_BINDING_DISABLED'; actualStatus: string }
+  | { code: 'PLAY_REVISION_MISSING' }
+  | {
+      code: 'PLAY_REVISION_MISMATCH';
+      expectedDefinitionId: string;
+      actualDefinitionId: string;
+    }
+  | {
+      code: 'ARTIFACT_RUNTIME_INCOMPATIBLE';
+      expectedArtifactKind: 'cjs_node20';
+      actualArtifactKind: string;
+    }
+  | { code: 'ARTIFACT_REFERENCE_MISSING' }
+  | {
+      code: 'WEBHOOK_PAYLOAD_INVALID';
+      reason: 'unsupported_shape';
+    }
+  | { code: 'PLAY_PRE_RUN_VALIDATION_FAILED' }
+  | { code: 'RUN_IDENTITY_CONFLICT' }
+  | { code: 'MAX_DELIVERY_ATTEMPTS_EXCEEDED' };
+
+export type LegacyWebhookDrainState =
+  | { kind: 'pending' }
+  | {
+      kind: 'leased';
+      leaseOwner: string;
+      leaseExpiresAt: number;
+      attempts: number;
+    }
+  | {
+      kind: 'retry';
+      failureCode: LegacyWebhookRetryCode;
+      retryAt: number;
+      attempts: number;
+      error: string;
+    }
+  | {
+      kind: 'quarantined';
+      failure: LegacyWebhookQuarantineFailure;
+      quarantinedAt: number;
+      attempts: number;
+      error: string;
+    }
+  | { kind: 'launched'; launchedAt: number }
+  | {
+      kind: 'migrated';
+      migratedAt: number;
+      migratedWebhookEventId: string;
+      migratedAbsurdTaskId: string;
+    }
+  | {
+      kind: 'retired';
+      retiredAt: number;
+      retiredBy: string;
+      reason: string;
+    };
+
+export type LegacyWebhookDrainOutcome =
+  | { kind: 'started' }
+  | { kind: 'quarantined'; failure: LegacyWebhookQuarantineFailure }
+  | { kind: 'retry'; failureCode: LegacyWebhookRetryCode }
+  | { kind: 'lease_lost' };
+
+export function isLegacyWebhookPayload(
+  value: unknown,
+): value is Record<string, unknown> | unknown[] {
+  return Array.isArray(value) || (value !== null && typeof value === 'object');
+}
+
+export function assertNever(value: never, context: string): never {
+  throw new Error(`${context}: ${JSON.stringify(value)}`);
+}

package/dist/bundling-sources/shared_libs/plays/secret-guardrails.ts

@@ -8,6 +8,8 @@ const ASSIGNMENT_SECRET_LITERAL_PATTERN =
 const HIGH_ENTROPY_LITERAL_PATTERN = /['"]([A-Za-z0-9+/=_-]{32,})['"]/g;
 const UUID_IDENTIFIER_PATTERN =
   /^((?:[A-Za-z0-9]+[-_])*)?([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
+const BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN =
+  /^bootstrap-[0-9a-f]{32}(?:\/[a-z0-9][a-z0-9_-]{0,127})?$/i;
 const SECRET_LABEL_PATTERN =
   /(?:^|[-_])(?:api|auth|access|secret|token|key|password|credential|bearer|sk|pk|live)(?:[-_]|$)/i;
 
@@ -27,6 +29,10 @@ function isNonSecretUuidIdentifier(value: string): boolean {
   return !SECRET_LABEL_PATTERN.test(label);
 }
 
+function isNonSecretBootstrapResourceIdentifier(value: string): boolean {
+  return BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN.test(value);
+}
+
 /**
  * Returns the inline-secret findings in a string (empty if none). The throwing
  * validator below and the workflows→plays migration validator both call this so
@@ -49,6 +55,10 @@ export function collectInlineSecretFindings(sourceCode: string): string[] {
     // UUID-bearing resource names are structured identifiers, not opaque
     // credentials. Keep secret-looking labels on the conservative path.
     if (isNonSecretUuidIdentifier(literal)) continue;
+    // Named CI orgs use a deterministic public `bootstrap-<sha256-prefix>`
+    // slug. It is an address, not a credential, and owner-qualified ctx.runPlay
+    // references must embed it as a literal for static child resolution.
+    if (isNonSecretBootstrapResourceIdentifier(literal)) continue;
     if (literal.length >= 40 && shannonEntropy(literal) >= 4.2) {
       findings.push('high-entropy string literal');
       break;

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.288",
+  version: "0.1.290",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -4424,6 +4424,17 @@ var DeeplineClient = class {
     if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
       params.set("limit", String(Math.max(1, Math.floor(options.limit))));
     }
+    if (options.offset !== void 0) {
+      if (!Number.isFinite(options.offset) || !Number.isInteger(options.offset) || options.offset < 0) {
+        throw new Error(
+          "runs.list options.offset must be a non-negative integer."
+        );
+      }
+      if (!playName && options.offset > 0) {
+        throw new Error("runs.list options.offset requires options.play.");
+      }
+      params.set("offset", String(options.offset));
+    }
     if (!playName && !status) {
       throw new Error("runs.list requires options.play or options.status.");
     }
@@ -16754,9 +16765,11 @@ async function handleRunGet(args) {
   return 0;
 }
 async function handleRunsList(args) {
-  const usage = "Usage: deepline runs list [--play <play-name>] [--status <status>] [--json]";
+  const usage = "Usage: deepline runs list [--play <play-name>] [--status <status>] [--limit <count>] [--offset <count>] [--json]";
   let playName = null;
   let statusFilter = null;
+  let limit;
+  let offset;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--play" || arg === "--name") && args[index + 1]) {
@@ -16767,6 +16780,24 @@ async function handleRunsList(args) {
       statusFilter = args[++index].trim().toLowerCase();
       continue;
     }
+    if (arg === "--limit" || arg === "--offset") {
+      const rawValue = args[index + 1];
+      const parsed = rawValue && /^\d+$/.test(rawValue) ? Number.parseInt(rawValue, 10) : Number.NaN;
+      const valid = Number.isSafeInteger(parsed) && (arg === "--limit" ? parsed > 0 : parsed >= 0);
+      if (!valid) {
+        console.error(
+          `${arg} must be ${arg === "--limit" ? "a positive" : "a non-negative"} integer.`
+        );
+        return 1;
+      }
+      if (arg === "--limit") {
+        limit = parsed;
+      } else {
+        offset = parsed;
+      }
+      index += 1;
+      continue;
+    }
     if (arg === "--json" || arg === "--compact") {
       continue;
     }
@@ -16775,10 +16806,16 @@ async function handleRunsList(args) {
     console.error(usage);
     return 1;
   }
+  if ((offset ?? 0) > 0 && !playName) {
+    console.error("--offset requires --play.");
+    return 1;
+  }
   const client2 = new DeeplineClient();
   const runs = (await client2.runs.list({
     ...playName ? { play: playName } : {},
-    ...statusFilter ? { status: statusFilter } : {}
+    ...statusFilter ? { status: statusFilter } : {},
+    ...limit !== void 0 ? { limit } : {},
+    ...offset !== void 0 ? { offset } : {}
   })).map((run) => ({
     runId: run.workflowId,
     workflowId: run.workflowId,
@@ -18335,10 +18372,12 @@ Examples:
   deepline runs list --play my-play --status failed --compact --json
   deepline runs list --status running --compact --json
 `
-  ).option("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+  ).option("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--limit <count>", "Maximum runs to return").option("--offset <count>", "Zero-based page offset (requires --play)").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
     process.exitCode = await handleRunsList([
       ...options.play ? ["--play", options.play] : [],
       ...options.status ? ["--status", options.status] : [],
+      ...options.limit ? ["--limit", options.limit] : [],
+      ...options.offset ? ["--offset", options.offset] : [],
       ...options.compact ? ["--compact"] : [],
       ...options.json ? ["--json"] : []
     ]);
@@ -29296,6 +29335,7 @@ var BEARER_LITERAL_PATTERN = /\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/i;
 var ASSIGNMENT_SECRET_LITERAL_PATTERN = /\b(?:api[_-]?key|token|secret|password)\b\s*[:=]\s*['"][^'"]{12,}['"]/i;
 var HIGH_ENTROPY_LITERAL_PATTERN = /['"]([A-Za-z0-9+/=_-]{32,})['"]/g;
 var UUID_IDENTIFIER_PATTERN = /^((?:[A-Za-z0-9]+[-_])*)?([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
+var BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN = /^bootstrap-[0-9a-f]{32}(?:\/[a-z0-9][a-z0-9_-]{0,127})?$/i;
 var SECRET_LABEL_PATTERN = /(?:^|[-_])(?:api|auth|access|secret|token|key|password|credential|bearer|sk|pk|live)(?:[-_]|$)/i;
 function shannonEntropy(value) {
   const counts = /* @__PURE__ */ new Map();
@@ -29311,6 +29351,9 @@ function isNonSecretUuidIdentifier(value) {
   const label = match[1] ?? "";
   return !SECRET_LABEL_PATTERN.test(label);
 }
+function isNonSecretBootstrapResourceIdentifier(value) {
+  return BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN.test(value);
+}
 function collectInlineSecretFindings(sourceCode) {
   const findings = [];
   for (const match of sourceCode.matchAll(SECRET_ENV_PATTERN)) {
@@ -29325,6 +29368,7 @@ function collectInlineSecretFindings(sourceCode) {
   for (const match of sourceCode.matchAll(HIGH_ENTROPY_LITERAL_PATTERN)) {
     const literal = match[1] ?? "";
     if (isNonSecretUuidIdentifier(literal)) continue;
+    if (isNonSecretBootstrapResourceIdentifier(literal)) continue;
     if (literal.length >= 40 && shannonEntropy(literal) >= 4.2) {
       findings.push("high-entropy string literal");
       break;

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.288",
+  version: "0.1.290",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -4409,6 +4409,17 @@ var DeeplineClient = class {
     if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
       params.set("limit", String(Math.max(1, Math.floor(options.limit))));
     }
+    if (options.offset !== void 0) {
+      if (!Number.isFinite(options.offset) || !Number.isInteger(options.offset) || options.offset < 0) {
+        throw new Error(
+          "runs.list options.offset must be a non-negative integer."
+        );
+      }
+      if (!playName && options.offset > 0) {
+        throw new Error("runs.list options.offset requires options.play.");
+      }
+      params.set("offset", String(options.offset));
+    }
     if (!playName && !status) {
       throw new Error("runs.list requires options.play or options.status.");
     }
@@ -16783,9 +16794,11 @@ async function handleRunGet(args) {
   return 0;
 }
 async function handleRunsList(args) {
-  const usage = "Usage: deepline runs list [--play <play-name>] [--status <status>] [--json]";
+  const usage = "Usage: deepline runs list [--play <play-name>] [--status <status>] [--limit <count>] [--offset <count>] [--json]";
   let playName = null;
   let statusFilter = null;
+  let limit;
+  let offset;
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--play" || arg === "--name") && args[index + 1]) {
@@ -16796,6 +16809,24 @@ async function handleRunsList(args) {
       statusFilter = args[++index].trim().toLowerCase();
       continue;
     }
+    if (arg === "--limit" || arg === "--offset") {
+      const rawValue = args[index + 1];
+      const parsed = rawValue && /^\d+$/.test(rawValue) ? Number.parseInt(rawValue, 10) : Number.NaN;
+      const valid = Number.isSafeInteger(parsed) && (arg === "--limit" ? parsed > 0 : parsed >= 0);
+      if (!valid) {
+        console.error(
+          `${arg} must be ${arg === "--limit" ? "a positive" : "a non-negative"} integer.`
+        );
+        return 1;
+      }
+      if (arg === "--limit") {
+        limit = parsed;
+      } else {
+        offset = parsed;
+      }
+      index += 1;
+      continue;
+    }
     if (arg === "--json" || arg === "--compact") {
       continue;
     }
@@ -16804,10 +16835,16 @@ async function handleRunsList(args) {
     console.error(usage);
     return 1;
   }
+  if ((offset ?? 0) > 0 && !playName) {
+    console.error("--offset requires --play.");
+    return 1;
+  }
   const client2 = new DeeplineClient();
   const runs = (await client2.runs.list({
     ...playName ? { play: playName } : {},
-    ...statusFilter ? { status: statusFilter } : {}
+    ...statusFilter ? { status: statusFilter } : {},
+    ...limit !== void 0 ? { limit } : {},
+    ...offset !== void 0 ? { offset } : {}
   })).map((run) => ({
     runId: run.workflowId,
     workflowId: run.workflowId,
@@ -18364,10 +18401,12 @@ Examples:
   deepline runs list --play my-play --status failed --compact --json
   deepline runs list --status running --compact --json
 `
-  ).option("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
+  ).option("--play <name>", "Play name to filter runs").option("--status <status>", "Filter by run status").option("--limit <count>", "Maximum runs to return").option("--offset <count>", "Zero-based page offset (requires --play)").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (options) => {
     process.exitCode = await handleRunsList([
       ...options.play ? ["--play", options.play] : [],
       ...options.status ? ["--status", options.status] : [],
+      ...options.limit ? ["--limit", options.limit] : [],
+      ...options.offset ? ["--offset", options.offset] : [],
       ...options.compact ? ["--compact"] : [],
       ...options.json ? ["--json"] : []
     ]);
@@ -29344,6 +29383,7 @@ var BEARER_LITERAL_PATTERN = /\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/i;
 var ASSIGNMENT_SECRET_LITERAL_PATTERN = /\b(?:api[_-]?key|token|secret|password)\b\s*[:=]\s*['"][^'"]{12,}['"]/i;
 var HIGH_ENTROPY_LITERAL_PATTERN = /['"]([A-Za-z0-9+/=_-]{32,})['"]/g;
 var UUID_IDENTIFIER_PATTERN = /^((?:[A-Za-z0-9]+[-_])*)?([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
+var BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN = /^bootstrap-[0-9a-f]{32}(?:\/[a-z0-9][a-z0-9_-]{0,127})?$/i;
 var SECRET_LABEL_PATTERN = /(?:^|[-_])(?:api|auth|access|secret|token|key|password|credential|bearer|sk|pk|live)(?:[-_]|$)/i;
 function shannonEntropy(value) {
   const counts = /* @__PURE__ */ new Map();
@@ -29359,6 +29399,9 @@ function isNonSecretUuidIdentifier(value) {
   const label = match[1] ?? "";
   return !SECRET_LABEL_PATTERN.test(label);
 }
+function isNonSecretBootstrapResourceIdentifier(value) {
+  return BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN.test(value);
+}
 function collectInlineSecretFindings(sourceCode) {
   const findings = [];
   for (const match of sourceCode.matchAll(SECRET_ENV_PATTERN)) {
@@ -29373,6 +29416,7 @@ function collectInlineSecretFindings(sourceCode) {
   for (const match of sourceCode.matchAll(HIGH_ENTROPY_LITERAL_PATTERN)) {
     const literal = match[1] ?? "";
     if (isNonSecretUuidIdentifier(literal)) continue;
+    if (isNonSecretBootstrapResourceIdentifier(literal)) continue;
     if (literal.length >= 40 && shannonEntropy(literal) >= 4.2) {
       findings.push("high-entropy string literal");
       break;

package/dist/index.d.mts

@@ -1717,6 +1717,8 @@ type RunsListOptions = {
     play?: string;
     status?: string;
     limit?: number;
+    /** Zero-based page offset. Requires `play` because status-only inventory is not paginated. */
+    offset?: number;
 };
 /** Options for `client.runs.get(...)`. */
 type RunsGetOptions = {

package/dist/index.d.ts

@@ -1717,6 +1717,8 @@ type RunsListOptions = {
     play?: string;
     status?: string;
     limit?: number;
+    /** Zero-based page offset. Requires `play` because status-only inventory is not paginated. */
+    offset?: number;
 };
 /** Options for `client.runs.get(...)`. */
 type RunsGetOptions = {

package/dist/index.js

@@ -438,7 +438,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.288",
+  version: "0.1.290",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -4144,6 +4144,17 @@ var DeeplineClient = class {
     if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
       params.set("limit", String(Math.max(1, Math.floor(options.limit))));
     }
+    if (options.offset !== void 0) {
+      if (!Number.isFinite(options.offset) || !Number.isInteger(options.offset) || options.offset < 0) {
+        throw new Error(
+          "runs.list options.offset must be a non-negative integer."
+        );
+      }
+      if (!playName && options.offset > 0) {
+        throw new Error("runs.list options.offset requires options.play.");
+      }
+      params.set("offset", String(options.offset));
+    }
     if (!playName && !status) {
       throw new Error("runs.list requires options.play or options.status.");
     }

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.288",
+  version: "0.1.290",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -4073,6 +4073,17 @@ var DeeplineClient = class {
     if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
       params.set("limit", String(Math.max(1, Math.floor(options.limit))));
     }
+    if (options.offset !== void 0) {
+      if (!Number.isFinite(options.offset) || !Number.isInteger(options.offset) || options.offset < 0) {
+        throw new Error(
+          "runs.list options.offset must be a non-negative integer."
+        );
+      }
+      if (!playName && options.offset > 0) {
+        throw new Error("runs.list options.offset requires options.play.");
+      }
+      params.set("offset", String(options.offset));
+    }
     if (!playName && !status) {
       throw new Error("runs.list requires options.play or options.status.");
     }

package/dist/plays/bundle-play-file.mjs

@@ -70,6 +70,7 @@ var BEARER_LITERAL_PATTERN = /\bBearer\s+[A-Za-z0-9._~+/=-]{16,}/i;
 var ASSIGNMENT_SECRET_LITERAL_PATTERN = /\b(?:api[_-]?key|token|secret|password)\b\s*[:=]\s*['"][^'"]{12,}['"]/i;
 var HIGH_ENTROPY_LITERAL_PATTERN = /['"]([A-Za-z0-9+/=_-]{32,})['"]/g;
 var UUID_IDENTIFIER_PATTERN = /^((?:[A-Za-z0-9]+[-_])*)?([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})$/i;
+var BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN = /^bootstrap-[0-9a-f]{32}(?:\/[a-z0-9][a-z0-9_-]{0,127})?$/i;
 var SECRET_LABEL_PATTERN = /(?:^|[-_])(?:api|auth|access|secret|token|key|password|credential|bearer|sk|pk|live)(?:[-_]|$)/i;
 function shannonEntropy(value) {
   const counts = /* @__PURE__ */ new Map();
@@ -85,6 +86,9 @@ function isNonSecretUuidIdentifier(value) {
   const label = match[1] ?? "";
   return !SECRET_LABEL_PATTERN.test(label);
 }
+function isNonSecretBootstrapResourceIdentifier(value) {
+  return BOOTSTRAP_RESOURCE_IDENTIFIER_PATTERN.test(value);
+}
 function collectInlineSecretFindings(sourceCode) {
   const findings = [];
   for (const match of sourceCode.matchAll(SECRET_ENV_PATTERN)) {
@@ -99,6 +103,7 @@ function collectInlineSecretFindings(sourceCode) {
   for (const match of sourceCode.matchAll(HIGH_ENTROPY_LITERAL_PATTERN)) {
     const literal = match[1] ?? "";
     if (isNonSecretUuidIdentifier(literal)) continue;
+    if (isNonSecretBootstrapResourceIdentifier(literal)) continue;
     if (literal.length >= 40 && shannonEntropy(literal) >= 4.2) {
       findings.push("high-entropy string literal");
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.288",
+  "version": "0.1.290",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {