deepline 0.3.162 → 0.3.163

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.162',
+  version: '0.3.163',
   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/observability/dlq.ts

@@ -585,6 +585,7 @@ export function normalizeQueueItemState(nativeState: string): QueueItemState {
     state === 'open' ||
     state === 'pending' ||
     state === 'queued' ||
+    state === 'continuation_pending' ||
     state === 'active' ||
     state === 'received' ||
     state === 'partial'

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

@@ -0,0 +1,156 @@
+/**
+ * Owner-neutral control port for cataloged scheduled work.
+ *
+ * The shared operations surface routes by stable job id. Scheduler adapters
+ * own authorization details and durable execution; callers never invoke a
+ * GitHub workflow, Vercel route, Inngest function, or Convex root directly.
+ */
+export const SCHEDULED_WORK_CONTROL_CONTRACT_VERSION = 1 as const;
+
+export type ScheduledWorkControlAction = 'run';
+
+export type ScheduledWorkControlContext = {
+  readonly jobId: string;
+  readonly environment: string;
+  readonly requestedByUserId: string;
+  readonly requestedByEmail: string;
+  readonly reason: string;
+  readonly idempotencyKey: string;
+};
+
+export type ScheduledWorkRunResult = {
+  readonly operationId: string;
+  readonly status: 'queued' | 'running' | 'succeeded' | 'failed';
+  readonly replayed: boolean;
+};
+
+export type ScheduledWorkControlConnector = {
+  readonly id: string;
+  /** Stable implementation identity, such as `convex_cron` or `github_actions`. */
+  readonly scheduler: string;
+  readonly jobIds: readonly string[];
+  readonly actions: readonly ScheduledWorkControlAction[];
+  /** Registered owners may expose an honest read-only adapter before a safe
+   * mutation exists. These reasons are returned by the same capability API. */
+  readonly unavailableActions?: Partial<
+    Record<ScheduledWorkControlAction, string>
+  >;
+  run?: (
+    context: ScheduledWorkControlContext,
+  ) => Promise<ScheduledWorkRunResult>;
+};
+
+export type ScheduledWorkControlRegisterOptions = {
+  /** Permit replacing an explicitly read-only startup adapter with its owner. */
+  readonly replaceUnavailable?: boolean;
+};
+
+export type ScheduledWorkControlCapability =
+  | {
+      readonly available: true;
+      readonly action: ScheduledWorkControlAction;
+      readonly connectorId: string;
+      readonly scheduler: string;
+    }
+  | {
+      readonly available: false;
+      readonly action: ScheduledWorkControlAction;
+      readonly reason: string;
+    };
+
+/**
+ * Dispatch boundary shared by all scheduled-work implementations. Duplicate
+ * job ownership is a startup error so one scheduler cannot shadow another.
+ */
+export class ScheduledWorkControlRegistry {
+  private readonly connectorsByJobId = new Map<
+    string,
+    ScheduledWorkControlConnector
+  >();
+
+  register(
+    connector: ScheduledWorkControlConnector,
+    options: ScheduledWorkControlRegisterOptions = {},
+  ): this {
+    if (!connector.id.trim())
+      throw new Error('Scheduled-work connector id is required.');
+    if (!connector.scheduler.trim())
+      throw new Error('Scheduled-work connector scheduler is required.');
+    if (connector.jobIds.length === 0)
+      throw new Error(
+        `Scheduled-work connector ${connector.id} must own at least one job.`,
+      );
+    if (
+      connector.actions.includes('run') &&
+      typeof connector.run !== 'function'
+    ) {
+      throw new Error(
+        `Scheduled-work connector ${connector.id} declares run without an implementation.`,
+      );
+    }
+    if (
+      connector.actions.length === 0 &&
+      Object.keys(connector.unavailableActions ?? {}).length === 0
+    ) {
+      throw new Error(
+        `Scheduled-work connector ${connector.id} must declare a supported action or an explicit unavailable reason.`,
+      );
+    }
+    const jobIds = new Set<string>();
+    for (const jobId of connector.jobIds) {
+      if (!jobId.trim())
+        throw new Error(
+          `Scheduled-work connector ${connector.id} has an empty job id.`,
+        );
+      if (jobIds.has(jobId))
+        throw new Error(
+          `Scheduled-work connector ${connector.id} repeats job ${jobId}.`,
+        );
+      jobIds.add(jobId);
+      const existing = this.connectorsByJobId.get(jobId);
+      if (existing && !options.replaceUnavailable) {
+        throw new Error(
+          `Scheduled-work job ${jobId} is already owned by ${existing.id}.`,
+        );
+      }
+      if (
+        existing &&
+        options.replaceUnavailable &&
+        existing.actions.length > 0
+      ) {
+        throw new Error(
+          `Scheduled-work job ${jobId} is already owned by ${existing.id}; replacement is not allowed.`,
+        );
+      }
+    }
+    for (const jobId of jobIds) this.connectorsByJobId.set(jobId, connector);
+    return this;
+  }
+
+  get(jobId: string): ScheduledWorkControlConnector | undefined {
+    return this.connectorsByJobId.get(jobId);
+  }
+
+  capability(
+    jobId: string,
+    action: ScheduledWorkControlAction = 'run',
+  ): ScheduledWorkControlCapability {
+    const connector = this.get(jobId);
+    if (connector?.actions.includes(action)) {
+      return {
+        available: true,
+        action,
+        connectorId: connector.id,
+        scheduler: connector.scheduler,
+      };
+    }
+    return {
+      available: false,
+      action,
+      reason: connector
+        ? (connector.unavailableActions?.[action] ??
+          `Scheduler connector ${connector.id} does not support ${action}.`)
+        : `No shared control connector is registered for scheduler work ${jobId}.`,
+    };
+  }
+}

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.162",
+  version: "0.3.163",
   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.162",
+  version: "0.3.163",
   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.162",
+  version: "0.3.163",
   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.162",
+  version: "0.3.163",
   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/install-integrity.json

@@ -101,6 +101,7 @@
     "dist/bundling-sources/shared_libs/observability/runtime-console.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-job-errors.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-jobs.json",
+    "dist/bundling-sources/shared_libs/observability/scheduled-work-control.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-work-manual.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-work-v2.ts",
     "dist/bundling-sources/shared_libs/observability/scheduled-work.ts",

package/dist/release.d.mts

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