deepline 0.1.79 → 0.1.81

package/dist/index.d.ts

@@ -305,6 +305,10 @@ interface ToolDefinition {
     operationId?: string;
     /** Alternative names that resolve to this tool. */
     operationAliases?: string[];
+    /** Whether detailed input schema is available from `tools describe`. */
+    hasInputSchema?: boolean;
+    /** Whether detailed output schema is available from `tools describe`. */
+    hasOutputSchema?: boolean;
     /** JSON Schema describing the tool's input parameters. */
     inputSchema?: Record<string, unknown>;
     /** JSON Schema describing the tool's output shape. */
@@ -796,6 +800,7 @@ interface PlayListItem {
     currentPublishedVersion?: number | null;
     tableNamespace?: string | null;
     isDraftDirty?: boolean;
+    hasInputSchema?: boolean;
     inputSchema?: Record<string, unknown> | null;
     outputSchema?: Record<string, unknown> | null;
     staticPipeline?: unknown;
@@ -1263,6 +1268,7 @@ declare class DeeplineClient {
         categories?: string;
         grep?: string;
         grepMode?: 'all' | 'any' | 'phrase';
+        compact?: boolean;
     }): Promise<ToolDefinition[]>;
     /**
      * Search available tools using Deepline's ranked backend search.
@@ -1676,7 +1682,9 @@ declare class DeeplineClient {
      * @param name - Play name
      * @returns Version list (newest first)
      */
-    listPlayVersions(name: string): Promise<PlayRevisionSummary[]>;
+    listPlayVersions(name: string, options?: {
+        full?: boolean;
+    }): Promise<PlayRevisionSummary[]>;
     /**
      * Make a play revision live.
      *

package/dist/index.js

@@ -241,10 +241,10 @@ var import_node_path2 = require("path");
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.79",
+  version: "0.1.81",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.79",
+    latest: "0.1.81",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -881,6 +881,7 @@ var DeeplineClient = class {
       params.set("grep", options.grep.trim());
       params.set("grep_mode", options.grepMode ?? "all");
     }
+    params.set("compact", options?.compact === true ? "true" : "false");
     const suffix = params.toString() ? `?${params.toString()}` : "";
     const res = await this.http.get(
       `/api/v2/tools${suffix}`
@@ -1320,7 +1321,7 @@ var DeeplineClient = class {
     }
     const query = params.size > 0 ? `?${params.toString()}` : "";
     const response = await this.http.get(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}${query}`
+      `/api/v2/runs/${encodeURIComponent(workflowId)}${query}`
     );
     return normalizePlayStatus(response);
   }
@@ -1332,10 +1333,10 @@ var DeeplineClient = class {
    */
   async *streamPlayRunEvents(workflowId, options) {
     const headers = options?.lastEventId && options.lastEventId.trim() ? { "Last-Event-ID": options.lastEventId.trim() } : void 0;
-    const params = new URLSearchParams({ stream: "true" });
+    const params = new URLSearchParams();
     params.set("mode", options?.mode ?? "cli");
     for await (const event of this.http.streamSse(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}?${params.toString()}`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
       { signal: options?.signal, headers }
     )) {
       if (event.scope === "play") {
@@ -1357,7 +1358,7 @@ var DeeplineClient = class {
    */
   async cancelPlay(workflowId) {
     await this.http.request(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}/stop`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/stop`,
       { method: "POST" }
     );
   }
@@ -1369,7 +1370,7 @@ var DeeplineClient = class {
    */
   async stopPlay(workflowId, options) {
     return this.http.post(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}/stop`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/stop`,
       options?.reason ? { reason: options.reason } : {}
     );
   }
@@ -1436,6 +1437,7 @@ var DeeplineClient = class {
     if (status) {
       params.set("status", status);
     }
+    params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
     );
@@ -1488,7 +1490,7 @@ var DeeplineClient = class {
    * ```
    */
   async getRunLogs(runId, options) {
-    const status = await this.getRunStatus(runId);
+    const status = await this.getRunStatus(runId, { full: true });
     const logs = status.progress?.logs ?? [];
     const limit = typeof options?.limit === "number" && Number.isFinite(options.limit) ? Math.max(0, Math.trunc(options.limit)) : 200;
     const entries = logs.slice(Math.max(0, logs.length - limit));
@@ -1600,10 +1602,11 @@ var DeeplineClient = class {
    * @param name - Play name
    * @returns Version list (newest first)
    */
-  async listPlayVersions(name) {
+  async listPlayVersions(name, options) {
     const encodedName = encodeURIComponent(name);
+    const suffix = options?.full ? "?full=true" : "";
     const response = await this.http.get(
-      `/api/v2/plays/${encodedName}/versions`
+      `/api/v2/plays/${encodedName}/versions${suffix}`
     );
     return response.versions ?? [];
   }

package/dist/index.mjs

@@ -179,10 +179,10 @@ import { join as join2 } from "path";
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.79",
+  version: "0.1.81",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.79",
+    latest: "0.1.81",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -819,6 +819,7 @@ var DeeplineClient = class {
       params.set("grep", options.grep.trim());
       params.set("grep_mode", options.grepMode ?? "all");
     }
+    params.set("compact", options?.compact === true ? "true" : "false");
     const suffix = params.toString() ? `?${params.toString()}` : "";
     const res = await this.http.get(
       `/api/v2/tools${suffix}`
@@ -1258,7 +1259,7 @@ var DeeplineClient = class {
     }
     const query = params.size > 0 ? `?${params.toString()}` : "";
     const response = await this.http.get(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}${query}`
+      `/api/v2/runs/${encodeURIComponent(workflowId)}${query}`
     );
     return normalizePlayStatus(response);
   }
@@ -1270,10 +1271,10 @@ var DeeplineClient = class {
    */
   async *streamPlayRunEvents(workflowId, options) {
     const headers = options?.lastEventId && options.lastEventId.trim() ? { "Last-Event-ID": options.lastEventId.trim() } : void 0;
-    const params = new URLSearchParams({ stream: "true" });
+    const params = new URLSearchParams();
     params.set("mode", options?.mode ?? "cli");
     for await (const event of this.http.streamSse(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}?${params.toString()}`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
       { signal: options?.signal, headers }
     )) {
       if (event.scope === "play") {
@@ -1295,7 +1296,7 @@ var DeeplineClient = class {
    */
   async cancelPlay(workflowId) {
     await this.http.request(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}/stop`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/stop`,
       { method: "POST" }
     );
   }
@@ -1307,7 +1308,7 @@ var DeeplineClient = class {
    */
   async stopPlay(workflowId, options) {
     return this.http.post(
-      `/api/v2/plays/run/${encodeURIComponent(workflowId)}/stop`,
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/stop`,
       options?.reason ? { reason: options.reason } : {}
     );
   }
@@ -1374,6 +1375,7 @@ var DeeplineClient = class {
     if (status) {
       params.set("status", status);
     }
+    params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
     );
@@ -1426,7 +1428,7 @@ var DeeplineClient = class {
    * ```
    */
   async getRunLogs(runId, options) {
-    const status = await this.getRunStatus(runId);
+    const status = await this.getRunStatus(runId, { full: true });
     const logs = status.progress?.logs ?? [];
     const limit = typeof options?.limit === "number" && Number.isFinite(options.limit) ? Math.max(0, Math.trunc(options.limit)) : 200;
     const entries = logs.slice(Math.max(0, logs.length - limit));
@@ -1538,10 +1540,11 @@ var DeeplineClient = class {
    * @param name - Play name
    * @returns Version list (newest first)
    */
-  async listPlayVersions(name) {
+  async listPlayVersions(name, options) {
     const encodedName = encodeURIComponent(name);
+    const suffix = options?.full ? "?full=true" : "";
     const response = await this.http.get(
-      `/api/v2/plays/${encodedName}/versions`
+      `/api/v2/plays/${encodedName}/versions${suffix}`
     );
     return response.versions ?? [];
   }

package/dist/repo/apps/play-runner-workers/src/child-play-await.ts

@@ -0,0 +1,192 @@
+/**
+ * Child-play terminal await — the race between a Cloudflare Workflow
+ * `waitForEvent('child_play_terminal:...')` and a coordinator terminal-state
+ * poll, extracted from entry.ts so the runtime keeps a small, testable surface
+ * for "block until this child run reaches a terminal state".
+ *
+ * Behavior is identical to the inline implementation it replaces: arm the
+ * workflow event wait, race it against `pollParentChildTerminalState`, and
+ * resolve on whichever reports the child's terminal status first. The poll
+ * never resolves on a non-terminal/absent state (it returns a never-settling
+ * promise on timeout) so the event wait remains the primary path and the poll
+ * is a coordinator-side safety net for missed signals.
+ */
+
+export type WorkflowStepLike = {
+  waitForEvent: (
+    name: string,
+    options: { type: string; timeout: string },
+  ) => Promise<{ payload: unknown }>;
+};
+
+export type ChildTerminalCoordinator = {
+  readChildTerminalState(
+    parentRunId: string,
+    eventKey: string,
+    timeoutMs?: number,
+  ): Promise<{ data?: unknown } | null>;
+};
+
+export type ChildPlayTerminalWaitResult = {
+  output: unknown;
+  source: 'workflow_event' | 'parent_child_terminal_cache';
+  attempts?: number;
+  waitMs: number;
+};
+
+export interface AwaitChildTerminalInput {
+  parentRunId: string;
+  workflowStep: WorkflowStepLike | undefined;
+  workflowId: string;
+  playName: string;
+  key: string;
+  timeoutMs: number;
+  /** Coordinator binding for the terminal-state poll. Null disables the poll. */
+  coordinator: ChildTerminalCoordinator | null;
+  now: () => number;
+  /** SHA-256 hex digest helper (same canonical hash entry.ts uses). */
+  hashJson: (value: unknown) => Promise<string>;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function workflowEventType(name: string): string {
+  const normalized = name
+    .trim()
+    .replace(/[^A-Za-z0-9_-]+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .slice(0, 100);
+  return normalized || 'deepline_event';
+}
+
+function integrationEventType(eventKey: string): string {
+  return workflowEventType(`integration_event_${eventKey}`);
+}
+
+function workflowTimeoutFromMs(timeoutMs: number): string {
+  const seconds = Math.max(1, Math.ceil(timeoutMs / 1000));
+  return `${seconds} second${seconds === 1 ? '' : 's'}`;
+}
+
+function readChildTerminalPayload(value: unknown): Record<string, unknown> {
+  if (!isRecord(value)) return {};
+  const data = value.data;
+  return isRecord(data) ? data : value;
+}
+
+function extractChildPlayOutput(status: Record<string, unknown>): unknown {
+  const result = status.result;
+  if (isRecord(result) && 'output' in result) {
+    return result.output;
+  }
+  return result ?? null;
+}
+
+async function childPlayEventKey(input: {
+  key: string;
+  workflowId: string;
+  hashJson: (value: unknown) => Promise<string>;
+}): Promise<string> {
+  const readableKey = workflowEventType(input.key).slice(0, 40);
+  const digest = (
+    await input.hashJson({ key: input.key, workflowId: input.workflowId })
+  ).slice(0, 32);
+  return `child_play_${digest}_${readableKey}`;
+}
+
+async function pollParentChildTerminalState(input: {
+  coordinator: ChildTerminalCoordinator | null;
+  parentRunId: string;
+  eventKey: string;
+  timeoutMs: number;
+  now: () => number;
+}): Promise<{
+  source: 'parent_child_terminal_cache';
+  payload: Record<string, unknown>;
+  attempts: number;
+}> {
+  const { coordinator, parentRunId } = input;
+  if (!coordinator?.readChildTerminalState || !parentRunId) {
+    return await new Promise(() => undefined);
+  }
+  const startedAt = input.now();
+  let attempts = 0;
+  while (input.now() - startedAt < input.timeoutMs) {
+    attempts += 1;
+    const remainingMs = Math.max(
+      0,
+      input.timeoutMs - (input.now() - startedAt),
+    );
+    const waitMs = Math.min(remainingMs, 30_000);
+    const state = await coordinator
+      .readChildTerminalState(parentRunId, input.eventKey, waitMs)
+      .catch(() => null);
+    if (isRecord(state?.data)) {
+      return {
+        source: 'parent_child_terminal_cache',
+        payload: state.data,
+        attempts,
+      };
+    }
+  }
+  return await new Promise(() => undefined);
+}
+
+/**
+ * Block until the child run reaches a terminal state, via the workflow event
+ * wait raced against the coordinator terminal-state poll. Throws on a non-
+ * completed terminal status.
+ */
+export async function awaitChildTerminal(
+  input: AwaitChildTerminalInput,
+): Promise<ChildPlayTerminalWaitResult> {
+  if (!input.workflowStep) {
+    throw new Error(
+      'ctx.runPlay child waits require the cf-workflows runtime event scheduler.',
+    );
+  }
+  const waitStartedAt = input.now();
+  const eventKey = await childPlayEventKey({
+    key: input.key,
+    workflowId: input.workflowId,
+    hashJson: input.hashJson,
+  });
+  const eventPromise = input.workflowStep
+    .waitForEvent(`child_play_terminal:${eventKey}`, {
+      type: integrationEventType(eventKey),
+      timeout: workflowTimeoutFromMs(input.timeoutMs),
+    })
+    .then((event) => ({
+      source: 'workflow_event' as const,
+      payload: readChildTerminalPayload(event.payload),
+      attempts: undefined as number | undefined,
+    }));
+  const terminal = await Promise.race([
+    eventPromise,
+    pollParentChildTerminalState({
+      coordinator: input.coordinator,
+      parentRunId: input.parentRunId,
+      eventKey,
+      timeoutMs: Math.min(input.timeoutMs, 30_000),
+      now: input.now,
+    }),
+  ]);
+  const payload = terminal.payload;
+  const status = String(payload.status ?? '').toLowerCase();
+  if (status === 'completed') {
+    return {
+      output: extractChildPlayOutput(payload),
+      source: terminal.source,
+      attempts: terminal.attempts,
+      waitMs: input.now() - waitStartedAt,
+    };
+  }
+  const error = isRecord(payload.error) ? payload.error : null;
+  const message =
+    (typeof error?.message === 'string' && error.message.trim()) ||
+    (typeof payload.error === 'string' && payload.error.trim()) ||
+    `Child play ${input.playName} (${input.workflowId}) finished with status ${status || 'unknown'}.`;
+  throw new Error(message);
+}