deepline 0.3.394 → 0.3.396

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

@@ -13,9 +13,12 @@ import type {
 // Value import from the dependency-free module: the client is bundled into
 // authored Plays, where `zod` (the contract's schemas) cannot resolve.
 import { playTriggerConfigPath } from '../../shared_libs/plays/trigger-config-route';
-import { CSV_HEADER_MATCHING_NOTE } from './csv-header-matching';
 import { iterateCursorPages } from './pagination';
-import { playInputExampleArgs } from './plays/input-example';
+import {
+  describePlayDetail,
+  describePlayListItem,
+  type PlayDescriptionOptions,
+} from './plays/play-description';
 /**
  * The main API client for interacting with the Deepline platform.
  *
@@ -3101,161 +3104,6 @@ export class DeeplineClient {
     return this.config.baseUrl;
   }
 
-  private compactSchema(schema: Record<string, unknown> | null | undefined) {
-    if (!schema) return null;
-    const fields = Array.isArray(schema.fields)
-      ? schema.fields
-          .map((field) =>
-            field && typeof field === 'object'
-              ? {
-                  name: String((field as Record<string, unknown>).name ?? ''),
-                  type: (field as Record<string, unknown>).type ?? undefined,
-                  required:
-                    (field as Record<string, unknown>).required ?? undefined,
-                }
-              : null,
-          )
-          .filter((field) => Boolean(field?.name))
-      : [];
-    return fields.length > 0 ? { fields } : schema;
-  }
-
-  private schemaMetadata(
-    schema: Record<string, unknown> | null | undefined,
-    key: string,
-  ): Record<string, unknown> | null {
-    if (!isRecord(schema)) return null;
-    const value = schema[key];
-    return isRecord(value) ? value : null;
-  }
-
-  private playRunCommand(
-    play: Pick<PlayListItem, 'name' | 'reference' | 'inputSchema'>,
-  ): string {
-    const target = play.reference || play.name;
-    return `deepline plays run ${target}${playInputExampleArgs(play.inputSchema)}`;
-  }
-
-  private starterPlayPath(
-    play: Pick<PlayListItem, 'name' | 'reference'>,
-  ): string {
-    const target = play.reference || play.name;
-    const unqualifiedName = target.split('/').pop() || play.name;
-    const safeName = unqualifiedName
-      .trim()
-      .toLowerCase()
-      .replace(/[^a-z0-9-]/g, '-')
-      .replace(/-+/g, '-')
-      .replace(/^-|-$/g, '');
-    return `./${safeName || 'play'}.play.ts`;
-  }
-
-  private playCloneEditStarter(
-    play: Pick<
-      PlayListItem,
-      'name' | 'reference' | 'canClone' | 'canEdit' | 'origin' | 'ownerType'
-    >,
-  ): PlayDescription['cloneEditStarter'] | undefined {
-    const readonlyPrebuilt =
-      (play.origin === 'prebuilt' || play.ownerType === 'deepline') &&
-      !play.canEdit;
-    if (!play.canClone && !readonlyPrebuilt) return undefined;
-    const target = play.reference || play.name;
-    const path = this.starterPlayPath(play);
-    return {
-      path,
-      command: `deepline plays get ${target} --source --out ${path}`,
-      checkCommand: `deepline plays check ${path}`,
-    };
-  }
-
-  private summarizePlayListItem(
-    play: PlayListItem,
-    options?: { compact?: boolean },
-  ): PlayDescription {
-    const aliases = play.aliases?.length ? play.aliases : [play.name];
-    const csvInput = this.schemaMetadata(play.inputSchema, 'csvInput');
-    const rowOutputSchema = this.schemaMetadata(
-      play.outputSchema,
-      'rowOutputSchema',
-    );
-    const description =
-      play.description?.trim() ||
-      play.currentRevision?.description?.trim() ||
-      play.liveRevision?.description?.trim() ||
-      null;
-    const runCommand = this.playRunCommand(play);
-    const cloneEditStarter = this.playCloneEditStarter(play);
-    return {
-      name: play.name,
-      // playKey and triggerStatus were projected away here, so `describe`
-      // was strictly less informative than `plays list` for the same play — no
-      // stable key, and no way to see that a cron was armed.
-      ...(play.playKey ? { playKey: play.playKey } : {}),
-      ...(play.reference ? { reference: play.reference } : {}),
-      ...(play.displayName ? { displayName: play.displayName } : {}),
-      ...(description ? { description } : {}),
-      ...(play.guidance ? { guidance: play.guidance } : {}),
-      pinned: Boolean(play.pinned),
-      toolCategories: play.toolCategories ?? [],
-      origin: play.origin,
-      ownerType: play.ownerType,
-      canEdit: play.canEdit,
-      canClone: play.canClone,
-      aliases,
-      inputSchema: options?.compact
-        ? this.compactSchema(play.inputSchema)
-        : (play.inputSchema ?? null),
-      outputSchema: options?.compact
-        ? this.compactSchema(play.outputSchema)
-        : (play.outputSchema ?? null),
-      staticPipeline: isRecord(play.staticPipeline)
-        ? play.staticPipeline
-        : isRecord(play.currentRevision?.staticPipeline)
-          ? play.currentRevision.staticPipeline
-          : isRecord(play.liveRevision?.staticPipeline)
-            ? play.liveRevision.staticPipeline
-            : null,
-      ...(csvInput
-        ? {
-            csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE },
-          }
-        : {}),
-      ...(rowOutputSchema ? { rowOutputSchema } : {}),
-      runCommand,
-      examples: [runCommand],
-      ...(cloneEditStarter ? { cloneEditStarter } : {}),
-      currentPublishedVersion: play.currentPublishedVersion ?? null,
-      // Read the live version off the live revision. It was previously only
-      // ever written by the publish/live routes, so every list and describe
-      // payload reported liveVersion: null even for an actively serving play.
-      liveVersion: play.liveRevision?.version ?? null,
-      ...(play.triggerStatus ? { triggerStatus: play.triggerStatus } : {}),
-      isDraftDirty: play.isDraftDirty,
-    };
-  }
-
-  private summarizePlayDetail(
-    detail: PlayDetail,
-    options?: { compact?: boolean },
-  ): PlayDescription {
-    const play = detail.play;
-    return {
-      ...this.summarizePlayListItem(play, options),
-      currentPublishedVersion:
-        play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
-      ...(play.triggerMetadata
-        ? { triggerMetadata: play.triggerMetadata }
-        : {}),
-      ...(play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {}),
-      ...(play.activeScheduledPlays
-        ? { activeScheduledPlays: play.activeScheduledPlays }
-        : {}),
-      ...(play.observedCost ? { observedCost: play.observedCost } : {}),
-    };
-  }
-
   // ——————————————————————————————————————————————————————————
   // Secrets
   // ——————————————————————————————————————————————————————————
@@ -5862,7 +5710,7 @@ export class DeeplineClient {
       },
     );
     const plays = (response.plays ?? []).map((play) =>
-      this.summarizePlayListItem(play, options),
+      describePlayListItem(play, { ...options, pipeline: true }),
     );
     if (scope === 'prebuilt') {
       return plays.filter(isPrebuiltPlayDescription);
@@ -5954,14 +5802,34 @@ export class DeeplineClient {
    * Get a normalized play description suitable for agents and CLIs.
    *
    * The description includes runnable examples, input/output summaries, clone
-   * guidance, revision state, and latest run metadata when available.
+   * guidance, revision state, and latest run metadata when available. Pass
+   * `{ pipeline: true }` to include the compiled pipeline, which can be
+   * hundreds of kilobytes and is otherwise left out.
    */
   async describePlay(
     name: string,
-    options?: { compact?: boolean },
+    options: PlayDescriptionOptions = {},
   ): Promise<PlayDescription> {
-    const detail = await this.getPlay(name, { guidance: true });
-    return this.summarizePlayDetail(detail, options);
+    if (options.pipeline) {
+      return describePlayDetail(
+        await this.getPlay(name, { guidance: true }),
+        options,
+      );
+    }
+    // The API describes the play itself, so only the description crosses
+    // the wire; a definition carries source and pipelines on every revision.
+    const params = new URLSearchParams({
+      include: 'guidance',
+      view: 'description',
+      ...(options.compact ? { compact: '1' } : {}),
+    });
+    const body = await this.http.get<
+      PlayDetail | { description: PlayDescription }
+    >(`/api/v2/plays/${encodeURIComponent(name)}?${params.toString()}`);
+    // An API without the description view answers with the definition.
+    return 'description' in body
+      ? body.description
+      : describePlayDetail(body, options);
   }
 
   /**

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

@@ -89,6 +89,7 @@ export {
   pinLocalPlayImports,
 } from './plays/local-play-execution';
 export type { LocalPlayGraph } from './plays/local-play-execution';
+export type { PlayDescriptionOptions } from './plays/play-description';
 export { CtxFetchHttpError } from './play';
 export { RunObserveTransportUnavailableError } from './runs/observe-transport';
 export { RunEventQueryInputError } from '../../shared_libs/play-runtime/run-event-query';

package/dist/bundling-sources/sdk/src/plays/play-description.ts

@@ -0,0 +1,167 @@
+import { CSV_HEADER_MATCHING_NOTE } from '../csv-header-matching';
+import type { PlayDescription, PlayDetail, PlayListItem } from '../types';
+import { playInputExampleArgs } from './input-example';
+
+export type { PlayDescription, PlayDetail } from '../types';
+
+/**
+ * The description `deepline describe` and `plays describe` show for a Play,
+ * derived from its definition. The server computes it (`?view=description`)
+ * so a describe reads kilobytes; the SDK computes the same thing from a full
+ * definition when it asks for the compiled pipeline or talks to an older API.
+ */
+export type PlayDescriptionOptions = {
+  /** Field names only, in place of the full input and output schemas. */
+  compact?: boolean;
+  /** Include the compiled pipeline. It can be hundreds of kilobytes. */
+  pipeline?: boolean;
+};
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function compactSchema(schema: Record<string, unknown> | null | undefined) {
+  if (!schema) return null;
+  const fields = Array.isArray(schema.fields)
+    ? schema.fields
+        .map((field) =>
+          isRecord(field)
+            ? {
+                name: String(field.name ?? ''),
+                type: field.type ?? undefined,
+                required: field.required ?? undefined,
+              }
+            : null,
+        )
+        .filter((field) => Boolean(field?.name))
+    : [];
+  return fields.length > 0 ? { fields } : schema;
+}
+
+function schemaMetadata(
+  schema: Record<string, unknown> | null | undefined,
+  key: string,
+): Record<string, unknown> | null {
+  const value = isRecord(schema) ? schema[key] : null;
+  return isRecord(value) ? value : null;
+}
+
+function starterPlayPath(
+  play: Pick<PlayListItem, 'name' | 'reference'>,
+): string {
+  const target = play.reference || play.name;
+  const unqualifiedName = target.split('/').pop() || play.name;
+  const safeName = unqualifiedName
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+  return `./${safeName || 'play'}.play.ts`;
+}
+
+export function cloneEditStarter(
+  play: Pick<
+    PlayListItem,
+    'name' | 'reference' | 'canClone' | 'canEdit' | 'origin' | 'ownerType'
+  >,
+): PlayDescription['cloneEditStarter'] | undefined {
+  const readonlyPrebuilt =
+    (play.origin === 'prebuilt' || play.ownerType === 'deepline') &&
+    !play.canEdit;
+  if (!play.canClone && !readonlyPrebuilt) return undefined;
+  const target = play.reference || play.name;
+  const path = starterPlayPath(play);
+  return {
+    path,
+    command: `deepline plays get ${target} --source --out ${path}`,
+    checkCommand: `deepline plays check ${path}`,
+  };
+}
+
+function staticPipeline(play: PlayListItem): Record<string, unknown> | null {
+  return isRecord(play.staticPipeline)
+    ? play.staticPipeline
+    : isRecord(play.currentRevision?.staticPipeline)
+      ? play.currentRevision.staticPipeline
+      : isRecord(play.liveRevision?.staticPipeline)
+        ? play.liveRevision.staticPipeline
+        : null;
+}
+
+export function describePlayListItem(
+  play: PlayListItem,
+  options: PlayDescriptionOptions = {},
+): PlayDescription {
+  const aliases = play.aliases?.length ? play.aliases : [play.name];
+  const csvInput = schemaMetadata(play.inputSchema, 'csvInput');
+  const rowOutputSchema = schemaMetadata(play.outputSchema, 'rowOutputSchema');
+  const description =
+    play.description?.trim() ||
+    play.currentRevision?.description?.trim() ||
+    play.liveRevision?.description?.trim() ||
+    null;
+  const runCommand = `deepline plays run ${play.reference || play.name}${playInputExampleArgs(play.inputSchema)}`;
+  const starter = cloneEditStarter(play);
+  return {
+    name: play.name,
+    // playKey and triggerStatus were projected away here, so `describe`
+    // was strictly less informative than `plays list` for the same play — no
+    // stable key, and no way to see that a cron was armed.
+    ...(play.playKey ? { playKey: play.playKey } : {}),
+    ...(play.reference ? { reference: play.reference } : {}),
+    ...(play.displayName ? { displayName: play.displayName } : {}),
+    ...(description ? { description } : {}),
+    ...(play.guidance ? { guidance: play.guidance } : {}),
+    pinned: Boolean(play.pinned),
+    toolCategories: play.toolCategories ?? [],
+    origin: play.origin,
+    ownerType: play.ownerType,
+    canEdit: play.canEdit,
+    canClone: play.canClone,
+    aliases,
+    inputSchema: options.compact
+      ? compactSchema(play.inputSchema)
+      : (play.inputSchema ?? null),
+    outputSchema: options.compact
+      ? compactSchema(play.outputSchema)
+      : (play.outputSchema ?? null),
+    ...(options.pipeline ? { staticPipeline: staticPipeline(play) } : {}),
+    ...(csvInput
+      ? {
+          csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE },
+        }
+      : {}),
+    ...(rowOutputSchema ? { rowOutputSchema } : {}),
+    runCommand,
+    examples: [runCommand],
+    ...(starter ? { cloneEditStarter: starter } : {}),
+    currentPublishedVersion: play.currentPublishedVersion ?? null,
+    // Read the live version off the live revision. It was previously only
+    // ever written by the publish/live routes, so every list and describe
+    // payload reported liveVersion: null even for an actively serving play.
+    liveVersion: play.liveRevision?.version ?? null,
+    ...(play.triggerStatus ? { triggerStatus: play.triggerStatus } : {}),
+    isDraftDirty: play.isDraftDirty,
+  };
+}
+
+export function describePlayDetail(
+  detail: PlayDetail,
+  options: PlayDescriptionOptions = {},
+): PlayDescription {
+  const play = detail.play;
+  return {
+    ...describePlayListItem(play, options),
+    currentPublishedVersion:
+      play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
+    latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+    ...(play.triggerMetadata ? { triggerMetadata: play.triggerMetadata } : {}),
+    ...(play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {}),
+    ...(play.activeScheduledPlays
+      ? { activeScheduledPlays: play.activeScheduledPlays }
+      : {}),
+    ...(play.observedCost ? { observedCost: play.observedCost } : {}),
+  };
+}

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

@@ -202,7 +202,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.394',
+  version: '0.3.396',
   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/sdk/src/types.ts

@@ -1721,6 +1721,7 @@ export interface PlayDescription {
   aliases: string[];
   inputSchema?: Record<string, unknown> | null;
   outputSchema?: Record<string, unknown> | null;
+  /** The compiled pipeline; only when `describePlay(name, { pipeline: true })` asks. */
   staticPipeline?: Record<string, unknown> | null;
   csvInput?: Record<string, unknown> | null;
   rowOutputSchema?: Record<string, unknown> | null;

package/dist/bundling-sources/shared_libs/observability/scheduled-jobs.json

@@ -183,7 +183,7 @@
     "id": "github.fly-pr-preview-cleanup",
     "name": "Reconcile Fly PR Preview Capacity",
     "scheduler": "github_actions",
-    "cadence": "17 * * * *",
+    "cadence": "*/30 * * * *",
     "timezone": "UTC",
     "source": ".github/workflows/fly-pr-preview-cleanup.yml",
     "locator": "schedule:",

package/dist/cli/{auth-OSXDAVCF.mjs → auth-3LTD62VL.mjs}

@@ -13,12 +13,12 @@ import {
   reportSetupCompleted,
   resolvePendingAuthClaimForResume,
   statusBannerLine
-} from "./chunk-MFB2VKBO.mjs";
-import "./chunk-NR3DFKNF.mjs";
-import "./chunk-FJGW5GXU.mjs";
+} from "./chunk-JCN4DHF7.mjs";
+import "./chunk-XKZXO7D3.mjs";
+import "./chunk-VE3U3SQC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-NXGCO4JB.mjs";
-import "./chunk-TJI2EN6K.mjs";
+import "./chunk-NHB5YUCS.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 export {

package/dist/cli/auth-562JPKOM.js

@@ -0,0 +1,39 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkAVHLATIIjs = require('./chunk-AVHLATII.js');
+require('./chunk-RTO5QZWT.js');
+require('./chunk-V7UP2F4U.js');
+require('./chunk-XNYIZMNQ.js');
+require('./chunk-7P5AA3SN.js');
+require('./chunk-GNN4MY5X.js');
+require('./chunk-OG64RBAC.js');
+require('./chunk-COGTRVWW.js');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.EXIT_WORKSPACE_MISMATCH = _chunkAVHLATIIjs.EXIT_WORKSPACE_MISMATCH; exports.authStatusLine = _chunkAVHLATIIjs.authStatusLine; exports.clearPendingClaim = _chunkAVHLATIIjs.clearPendingClaim; exports.clearSatisfiedPendingClaim = _chunkAVHLATIIjs.clearSatisfiedPendingClaim; exports.handleRegister = _chunkAVHLATIIjs.handleRegister; exports.handleStatus = _chunkAVHLATIIjs.handleStatus; exports.handleWait = _chunkAVHLATIIjs.handleWait; exports.httpJson = _chunkAVHLATIIjs.httpJson; exports.readPendingAuthClaim = _chunkAVHLATIIjs.readPendingAuthClaim; exports.readStatusBanner = _chunkAVHLATIIjs.readStatusBanner; exports.registerAuthCommands = _chunkAVHLATIIjs.registerAuthCommands; exports.reportSetupCompleted = _chunkAVHLATIIjs.reportSetupCompleted; exports.resolvePendingAuthClaimForResume = _chunkAVHLATIIjs.resolvePendingAuthClaimForResume; exports.statusBannerLine = _chunkAVHLATIIjs.statusBannerLine;

package/dist/cli/{billing-ZNNKX3UR.mjs → billing-DP7ZAJBO.mjs}

@@ -2,9 +2,10 @@ import {
   DeeplineClient,
   iterateCursorPages,
   requireBillingIdempotencyKey
-} from "./chunk-JHIJIHFB.mjs";
+} from "./chunk-MR6XCBQJ.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-JI2B4RZP.mjs";
+import "./chunk-EIMG75BT.mjs";
 import "./chunk-UBKA33KY.mjs";
 import {
   createTimestampedName,
@@ -12,16 +13,16 @@ import {
   openInBrowser,
   printCommandEnvelope,
   shouldEmitJson
-} from "./chunk-NR3DFKNF.mjs";
+} from "./chunk-XKZXO7D3.mjs";
 import {
   AuthError,
   ConfigError
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-VE3U3SQC.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-TJI2EN6K.mjs";
+import "./chunk-NHB5YUCS.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";