deepline 0.1.277 → 0.1.279

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.277',
+  version: '0.1.279',
   contracts: {
     api: {
       name: 'sdk-http-api',

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

@@ -1225,6 +1225,16 @@ export class PlayContextImpl {
   private readonly executionScope: RunExecutionScope;
   private logBuffer: string[] = [];
   private checkpoint: PlayCheckpoint;
+  /**
+   * Durable tool receipts are the replay/cache authority for the execution
+   * paths the host supports. Keeping the same completed result in this
+   * checkpoint retained every provider payload for the lifetime of a run and
+   * copied it again while serializing the terminal. Paths without a matching
+   * receipt API keep the legacy checkpoint cache so local/in-process replay
+   * and bulk-only hosts' direct calls still work.
+   */
+  private readonly durableMappedToolResultsBackedByReceipts: boolean;
+  private readonly durableDirectToolResultsBackedByReceipts: boolean;
   private steps: PlayStep[] = [];
   private explicitMapInvocationKeys = new Set<string>();
   /** The map step currently being built — substeps go here instead of top-level. */
@@ -1383,6 +1393,24 @@ export class PlayContextImpl {
   constructor(options: ContextOptions) {
     this.#options = options;
     this.checkpoint = options.checkpoint ?? emptyCheckpoint();
+    this.durableMappedToolResultsBackedByReceipts = Boolean(
+      (options.claimRuntimeStepReceipt || options.claimRuntimeStepReceipts) &&
+        (options.getRuntimeStepReceipt || options.getRuntimeStepReceipts) &&
+        (options.completeRuntimeStepReceipt ||
+          options.completeRuntimeStepReceipts),
+    );
+    this.durableDirectToolResultsBackedByReceipts = Boolean(
+      options.claimRuntimeStepReceipt &&
+        options.getRuntimeStepReceipt &&
+        options.completeRuntimeStepReceipt,
+    );
+    if (this.durableDirectToolResultsBackedByReceipts) {
+      // A resumed durable runner may receive a legacy checkpoint containing
+      // full tool results. Drop that redundant copy immediately and recover
+      // through the receipt store below. Bulk-only receipt contexts retain the
+      // checkpoint because direct tool calls cannot use the bulk claim path.
+      this.checkpoint.completedToolBatches = {};
+    }
     // The governance play id keys durable ctx receipts (durableCtxKey), the
     // cycle guard, and per-parent child-call counters. It must be the STABLE
     // play name — not the per-run workflow id — so receipts written by one
@@ -3077,16 +3105,25 @@ export class PlayContextImpl {
   private getCachedToolResult(
     toolId: string,
     rowCacheKey: string,
+    path: 'mapped' | 'direct' = 'mapped',
   ): ToolBatchResult | undefined {
+    if (
+      path === 'direct'
+        ? this.durableDirectToolResultsBackedByReceipts
+        : this.durableMappedToolResultsBackedByReceipts
+    ) {
+      return undefined;
+    }
     return this.checkpoint.completedToolBatches[toolId]?.[rowCacheKey];
   }
 
   private getCachedToolResultCandidate(
     toolId: string,
     rowCacheKeys: readonly string[],
+    path: 'mapped' | 'direct' = 'mapped',
   ): { cacheKey: string; result: ToolBatchResult } | null {
     for (const rowCacheKey of rowCacheKeys) {
-      const cached = this.getCachedToolResult(toolId, rowCacheKey);
+      const cached = this.getCachedToolResult(toolId, rowCacheKey, path);
       if (cached?.done) {
         return { cacheKey: rowCacheKey, result: cached };
       }
@@ -3098,7 +3135,15 @@ export class PlayContextImpl {
     toolId: string,
     rowCacheKey: string,
     result: unknown | null,
+    path: 'mapped' | 'direct' = 'mapped',
   ): void {
+    if (
+      path === 'direct'
+        ? this.durableDirectToolResultsBackedByReceipts
+        : this.durableMappedToolResultsBackedByReceipts
+    ) {
+      return;
+    }
     if (!this.checkpoint.completedToolBatches[toolId]) {
       this.checkpoint.completedToolBatches[toolId] = {};
     }
@@ -6349,7 +6394,11 @@ export class PlayContextImpl {
           ? null
           : toolCachePolicy.force
             ? null
-            : this.getCachedToolResultCandidate(toolId, checkpointCacheKeys);
+            : this.getCachedToolResultCandidate(
+                toolId,
+                checkpointCacheKeys,
+                'direct',
+              );
         if (cached) {
           this.log(`Calling tool: ${toolId} recovered from checkpoint`);
           return await this.wrapToolExecutionResult({
@@ -6429,13 +6478,7 @@ export class PlayContextImpl {
           }),
         });
         if (cacheableToolResult) {
-          this.checkpoint.completedToolBatches[toolId] = {
-            ...(this.checkpoint.completedToolBatches[toolId] ?? {}),
-            [directCacheKey]: {
-              done: true,
-              result: wrapped,
-            },
-          };
+          this.cacheToolResult(toolId, directCacheKey, wrapped, 'direct');
           this.#options.onBatchComplete?.(this.checkpoint);
         }
         return wrapped;
@@ -7348,23 +7391,27 @@ export class PlayContextImpl {
     const toolSettlements = await Promise.allSettled(
       [...byTool.entries()].map(async ([toolId, requests]) => {
         this.log(`Executing tool batch ${toolId}: ${requests.length} calls`);
-        const liveStepResults = new Map<string, unknown>();
+        const successfulLiveStepCallIds = new Set<string>();
 
         const recordToolStep = (stepRequests: ToolCallRequest[]): void => {
           if (stepRequests.length === 0) return;
           const stepResults: PlayStepRowResult[] = stepRequests.map((req) => {
-            const hasLiveResult = liveStepResults.has(req.callId);
-            const result = hasLiveResult
-              ? liveStepResults.get(req.callId)
-              : this.getCachedToolResult(toolId, req.cacheKey)?.result;
+            const success =
+              successfulLiveStepCallIds.has(req.callId) ||
+              this.getCachedToolResult(toolId, req.cacheKey)?.result != null;
             return {
               rowId: req.rowId,
-              status: result != null ? 'completed' : 'failed',
-              success: result != null,
-              value: result,
-              error: result != null ? null : 'Tool call failed',
+              status: success ? 'completed' : 'failed',
+              success,
+              error: success ? null : 'Tool call failed',
             };
           });
+          // Step traces are lifecycle observability, not a second row/receipt
+          // store. Keep only call ids long enough to record their bounded
+          // status preview.
+          for (const request of stepRequests) {
+            successfulLiveStepCallIds.delete(request.callId);
+          }
           const toolStep = {
             type: 'tool' as const,
             toolId,
@@ -7643,6 +7690,7 @@ export class PlayContextImpl {
             });
             this.cacheToolResult(toolId, request.cacheKey, wrapped);
             for (const waitingRequest of requestsForKey) {
+              successfulLiveStepCallIds.add(waitingRequest.callId);
               const resolver = this.toolCallResolvers.get(
                 waitingRequest.callId,
               );
@@ -7822,7 +7870,9 @@ export class PlayContextImpl {
                   execution?.jobId,
                   execution?.meta,
                 );
-                liveStepResults.set(owner.callId, result);
+                if (result != null) {
+                  successfulLiveStepCallIds.add(owner.callId);
+                }
                 resolveLiveFollowers(owner, result);
                 recordToolStep([owner]);
                 this.#options.onBatchComplete?.(this.checkpoint);
@@ -8110,7 +8160,9 @@ export class PlayContextImpl {
                     index += 1
                   ) {
                     const request = entry.request.memberRequests[index]!;
-                    liveStepResults.set(request.callId, resolvedResults[index]);
+                    if (resolvedResults[index] != null) {
+                      successfulLiveStepCallIds.add(request.callId);
+                    }
                     resolveLiveFollowers(request, resolvedResults[index]);
                   }
                 }
@@ -8150,7 +8202,9 @@ export class PlayContextImpl {
                 for (let index = 0; index < entries.length; index += 1) {
                   const entry = entries[index]!;
                   const result = resolvedResults[index];
-                  liveStepResults.set(entry.request.callId, result);
+                  if (result != null) {
+                    successfulLiveStepCallIds.add(entry.request.callId);
+                  }
                   resolveLiveFollowers(entry.request, result);
                   entry.resolve(result);
                 }

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.277",
+  version: "0.1.279",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5831,7 +5831,21 @@ function readCsvRows(csvPath) {
   });
 }
 function csvStringFromRows(rows, columns) {
-  return (0, import_sync2.stringify)(rows.map(csvSafeRow), {
+  const effectiveColumns = columns?.length ? columns : Object.keys(rows[0] ?? {});
+  if (!effectiveColumns.length) {
+    return (0, import_sync2.stringify)(
+      rows.map(() => ({})),
+      { header: true }
+    );
+  }
+  const records = rows.map(
+    (row) => effectiveColumns.map(
+      (column) => csvSafeCell(
+        Object.prototype.hasOwnProperty.call(row, column) ? row[column] : void 0
+      )
+    )
+  );
+  return (0, import_sync2.stringify)(records, {
     header: true,
     cast: {
       boolean: (value) => value ? "true" : "false",
@@ -5840,14 +5854,9 @@ function csvStringFromRows(rows, columns) {
         return typeof cell === "string" ? cell : null;
       }
     },
-    ...columns?.length ? { columns } : {}
+    ...effectiveColumns.length ? { columns: effectiveColumns } : {}
   });
 }
-function csvSafeRow(row) {
-  return Object.fromEntries(
-    Object.entries(row).map(([key, value]) => [key, csvSafeCell(value)])
-  );
-}
 function csvSafeCell(value) {
   if (value === void 0) {
     return null;
@@ -27866,6 +27875,9 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
   const inputFields = toolInputFieldsForDisplay(
     recordField2(tool, "inputSchema", "input_schema")
   );
+  const inputSchema = publicToolInputSchemaForDescribe(
+    recordField2(tool, "inputSchema", "input_schema")
+  );
   const usageGuidance = recordField2(tool, "usageGuidance", "usage_guidance");
   const toolExecutionResult = recordField2(
     usageGuidance,
@@ -27911,6 +27923,7 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
       ...field.description ? { description: field.description } : {},
       ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
     })),
+    inputSchema,
     cost: {
       pricingModel: stringField2(cost, "pricingModel", "pricing_model") || null,
       billingMode: stringField2(cost, "billingMode", "billing_mode") || null,
@@ -28034,7 +28047,9 @@ function printCompactToolContract(tool, requestedToolId) {
   const getters = isRecord9(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
-  const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
+  const inputFields = recursiveToolInputFieldsForDisplay(
+    recordField2(contract, "inputSchema")
+  );
   console.log(String(contract.toolId));
   if (contract.displayName) console.log(`Best for: ${contract.displayName}`);
   if (typeof contract.description === "string" && contract.description.trim()) {
@@ -28054,8 +28069,14 @@ function printCompactToolContract(tool, requestedToolId) {
       const required = field.required ? "*" : "";
       const type = stringField2(field, "type") || "unknown";
       const description = stringField2(field, "description");
+      const enumValues = Array.isArray(field.enum) ? field.enum : [];
+      const enumSuffix = enumValues.length ? ` enum=${enumValues.map(String).join("|")}` : "";
+      const defaultSuffix = Object.prototype.hasOwnProperty.call(
+        field,
+        "default"
+      ) ? ` default=${JSON.stringify(field.default)}` : "";
       console.log(
-        `- ${name}${required}: ${type}${description ? ` - ${description}` : ""}`
+        `- ${name}${required}: ${type}${enumSuffix}${defaultSuffix}${description ? ` - ${description}` : ""}`
       );
     }
   }
@@ -28116,24 +28137,37 @@ function printToolSchemaOnly(tool, requestedToolId) {
     return;
   }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
+  const inputFields = recursiveToolInputFieldsForDisplay(
+    recordField2(contract, "inputSchema")
+  );
   console.log(`Schema: ${contract.toolId}`);
   if (!inputFields.length) {
     console.log("Inputs: none");
-    return;
+  } else {
+    console.log("Inputs:");
+    for (const field of inputFields) {
+      const name = typeof field.name === "string" ? field.name : "";
+      if (!name) continue;
+      const required = field.required ? "*" : "";
+      const type = typeof field.type === "string" ? field.type : "unknown";
+      const description = typeof field.description === "string" ? field.description : "";
+      const enumValues = Array.isArray(field.enum) ? field.enum : [];
+      const enumSuffix = enumValues.length ? ` enum=${enumValues.map(String).join("|")}` : "";
+      const defaultSuffix = Object.prototype.hasOwnProperty.call(
+        field,
+        "default"
+      ) ? ` default=${JSON.stringify(field.default)}` : "";
+      console.log(
+        `- ${name}${required}: ${type}${enumSuffix}${defaultSuffix}${description ? ` - ${description}` : ""}`
+      );
+    }
   }
-  console.log("Inputs:");
-  for (const field of inputFields) {
-    if (!isRecord9(field)) continue;
-    const name = stringField2(field, "name");
-    if (!name) continue;
-    const required = field.required ? "*" : "";
-    const type = stringField2(field, "type") || "unknown";
-    const description = stringField2(field, "description");
-    const defaultSuffix = Object.prototype.hasOwnProperty.call(field, "default") ? ` default=${JSON.stringify(field.default)}` : "";
-    console.log(
-      `- ${name}${required}: ${type}${defaultSuffix}${description ? ` - ${description}` : ""}`
-    );
+  const declaredSchema = declaredToolJsonSchema(
+    recordField2(contract, "inputSchema")
+  );
+  if (declaredSchema) {
+    console.log("Declared JSON Schema:");
+    console.log(JSON.stringify(declaredSchema, null, 2));
   }
 }
 function printToolExamplesOnly(tool, requestedToolId, options = {}) {
@@ -28378,6 +28412,126 @@ function toolInputFieldsForDisplay(inputSchema) {
     };
   });
 }
+function canonicalToolJsonSchema(inputSchema) {
+  return isRecord9(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
+}
+function declaredToolJsonSchema(inputSchema) {
+  if (isRecord9(inputSchema.jsonSchema)) {
+    return inputSchema.jsonSchema;
+  }
+  return Array.isArray(inputSchema.fields) ? null : inputSchema;
+}
+function publicToolInputSchemaForDescribe(inputSchema) {
+  const exposesProviderSpend = (description) => {
+    const withoutDeeplineCredits = description.replace(
+      /\bdeepline(?:-facing)?\s+credits?\b/gi,
+      ""
+    );
+    return /\bcredits?\b/i.test(withoutDeeplineCredits) || /\bprovider\s+(?:cost|spend|price|pricing|usage)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:costs?|charges?|priced at)\s+[$€£]\s*\d/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:costs?|charges?|priced at)\s+\d+(?:\.\d+)?\s*(?:usd|eur|gbp)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\battribute-priced\b/i.test(withoutDeeplineCredits) || /\b(?:cost|price|pricing)\s+(?:grows?|increases?|scales?|varies?)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:will be|are|is|be)\s+(?:billed|charged)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:additional|extra)\s+charges?\b/i.test(withoutDeeplineCredits) || /\bcharg(?:e|ed)\s+(?:double|per)\b/i.test(withoutDeeplineCredits) || /\bpricing page\b/i.test(withoutDeeplineCredits);
+  };
+  const stripDescriptions = (value) => {
+    if (Array.isArray(value)) return value.map(stripDescriptions);
+    if (!isRecord9(value)) return value;
+    return Object.fromEntries(
+      Object.entries(value).flatMap(([key, nested]) => {
+        if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
+          return [];
+        }
+        return [[key, stripDescriptions(nested)]];
+      })
+    );
+  };
+  return stripDescriptions(inputSchema);
+}
+function recursiveToolInputFieldsForDisplay(inputSchema) {
+  const root = canonicalToolJsonSchema(inputSchema);
+  const fields = /* @__PURE__ */ new Map();
+  const schemasById = /* @__PURE__ */ new Map();
+  const collectSchemaIds = (value) => {
+    if (Array.isArray(value)) {
+      for (const item of value) collectSchemaIds(item);
+      return;
+    }
+    if (!isRecord9(value)) return;
+    if (typeof value.$id === "string" && value.$id.trim()) {
+      schemasById.set(value.$id.trim(), value);
+    }
+    for (const nested of Object.values(value)) collectSchemaIds(nested);
+  };
+  collectSchemaIds(root);
+  const resolveRef = (schema) => {
+    const ref = typeof schema.$ref === "string" ? schema.$ref : "";
+    if (!ref.startsWith("#/")) return schemasById.get(ref) ?? schema;
+    let current = root;
+    for (const rawSegment of ref.slice(2).split("/")) {
+      const segment = rawSegment.replace(/~1/g, "/").replace(/~0/g, "~");
+      if (!isRecord9(current)) return schema;
+      current = current[segment];
+    }
+    return isRecord9(current) ? current : schema;
+  };
+  const addField = (field) => {
+    const name = typeof field.name === "string" ? field.name : "";
+    if (!name) return;
+    const existing = fields.get(name);
+    if (!existing || existing.type === "unknown") {
+      fields.set(name, field);
+    }
+  };
+  const visit = (unresolvedSchema, path, required, activeRefs = /* @__PURE__ */ new Set()) => {
+    const ref = typeof unresolvedSchema.$ref === "string" ? unresolvedSchema.$ref : "";
+    if (ref && activeRefs.has(ref)) return;
+    const schema = resolveRef(unresolvedSchema);
+    const nextActiveRefs = ref ? /* @__PURE__ */ new Set([...activeRefs, ref]) : activeRefs;
+    const type = Array.isArray(schema.type) ? schema.type.map(String).join("|") : typeof schema.type === "string" ? schema.type : isRecord9(schema.properties) ? "object" : schema.items ? "array" : "unknown";
+    if (path) {
+      addField({
+        name: path,
+        type,
+        required,
+        description: schema.description,
+        ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
+        ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
+      });
+    }
+    const properties = isRecord9(schema.properties) ? schema.properties : {};
+    const requiredNames = new Set(
+      Array.isArray(schema.required) ? schema.required.map(String) : []
+    );
+    for (const [name, value] of Object.entries(properties)) {
+      if (!isRecord9(value)) continue;
+      visit(
+        value,
+        path ? `${path}.${name}` : name,
+        requiredNames.has(name),
+        nextActiveRefs
+      );
+    }
+    if (isRecord9(schema.items)) {
+      visit(schema.items, `${path}[]`, false, nextActiveRefs);
+    }
+    for (const keyword of ["anyOf", "oneOf", "allOf"]) {
+      const branches = Array.isArray(schema[keyword]) ? schema[keyword] : [];
+      for (const branch of branches) {
+        if (isRecord9(branch)) {
+          visit(branch, path, required, nextActiveRefs);
+        }
+      }
+    }
+  };
+  visit(root, "", false);
+  return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
+}
 function printSamples(samples) {
   const requestPayload = samplePayload(samples, "request");
   const responsePayload = samplePayload(samples, "response");

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.277",
+  version: "0.1.279",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5828,7 +5828,21 @@ function readCsvRows(csvPath) {
   });
 }
 function csvStringFromRows(rows, columns) {
-  return stringify(rows.map(csvSafeRow), {
+  const effectiveColumns = columns?.length ? columns : Object.keys(rows[0] ?? {});
+  if (!effectiveColumns.length) {
+    return stringify(
+      rows.map(() => ({})),
+      { header: true }
+    );
+  }
+  const records = rows.map(
+    (row) => effectiveColumns.map(
+      (column) => csvSafeCell(
+        Object.prototype.hasOwnProperty.call(row, column) ? row[column] : void 0
+      )
+    )
+  );
+  return stringify(records, {
     header: true,
     cast: {
       boolean: (value) => value ? "true" : "false",
@@ -5837,14 +5851,9 @@ function csvStringFromRows(rows, columns) {
         return typeof cell === "string" ? cell : null;
       }
     },
-    ...columns?.length ? { columns } : {}
+    ...effectiveColumns.length ? { columns: effectiveColumns } : {}
   });
 }
-function csvSafeRow(row) {
-  return Object.fromEntries(
-    Object.entries(row).map(([key, value]) => [key, csvSafeCell(value)])
-  );
-}
 function csvSafeCell(value) {
   if (value === void 0) {
     return null;
@@ -27914,6 +27923,9 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
   const inputFields = toolInputFieldsForDisplay(
     recordField2(tool, "inputSchema", "input_schema")
   );
+  const inputSchema = publicToolInputSchemaForDescribe(
+    recordField2(tool, "inputSchema", "input_schema")
+  );
   const usageGuidance = recordField2(tool, "usageGuidance", "usage_guidance");
   const toolExecutionResult = recordField2(
     usageGuidance,
@@ -27959,6 +27971,7 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
       ...field.description ? { description: field.description } : {},
       ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
     })),
+    inputSchema,
     cost: {
       pricingModel: stringField2(cost, "pricingModel", "pricing_model") || null,
       billingMode: stringField2(cost, "billingMode", "billing_mode") || null,
@@ -28082,7 +28095,9 @@ function printCompactToolContract(tool, requestedToolId) {
   const getters = isRecord9(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
-  const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
+  const inputFields = recursiveToolInputFieldsForDisplay(
+    recordField2(contract, "inputSchema")
+  );
   console.log(String(contract.toolId));
   if (contract.displayName) console.log(`Best for: ${contract.displayName}`);
   if (typeof contract.description === "string" && contract.description.trim()) {
@@ -28102,8 +28117,14 @@ function printCompactToolContract(tool, requestedToolId) {
       const required = field.required ? "*" : "";
       const type = stringField2(field, "type") || "unknown";
       const description = stringField2(field, "description");
+      const enumValues = Array.isArray(field.enum) ? field.enum : [];
+      const enumSuffix = enumValues.length ? ` enum=${enumValues.map(String).join("|")}` : "";
+      const defaultSuffix = Object.prototype.hasOwnProperty.call(
+        field,
+        "default"
+      ) ? ` default=${JSON.stringify(field.default)}` : "";
       console.log(
-        `- ${name}${required}: ${type}${description ? ` - ${description}` : ""}`
+        `- ${name}${required}: ${type}${enumSuffix}${defaultSuffix}${description ? ` - ${description}` : ""}`
       );
     }
   }
@@ -28164,24 +28185,37 @@ function printToolSchemaOnly(tool, requestedToolId) {
     return;
   }
   const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
+  const inputFields = recursiveToolInputFieldsForDisplay(
+    recordField2(contract, "inputSchema")
+  );
   console.log(`Schema: ${contract.toolId}`);
   if (!inputFields.length) {
     console.log("Inputs: none");
-    return;
+  } else {
+    console.log("Inputs:");
+    for (const field of inputFields) {
+      const name = typeof field.name === "string" ? field.name : "";
+      if (!name) continue;
+      const required = field.required ? "*" : "";
+      const type = typeof field.type === "string" ? field.type : "unknown";
+      const description = typeof field.description === "string" ? field.description : "";
+      const enumValues = Array.isArray(field.enum) ? field.enum : [];
+      const enumSuffix = enumValues.length ? ` enum=${enumValues.map(String).join("|")}` : "";
+      const defaultSuffix = Object.prototype.hasOwnProperty.call(
+        field,
+        "default"
+      ) ? ` default=${JSON.stringify(field.default)}` : "";
+      console.log(
+        `- ${name}${required}: ${type}${enumSuffix}${defaultSuffix}${description ? ` - ${description}` : ""}`
+      );
+    }
   }
-  console.log("Inputs:");
-  for (const field of inputFields) {
-    if (!isRecord9(field)) continue;
-    const name = stringField2(field, "name");
-    if (!name) continue;
-    const required = field.required ? "*" : "";
-    const type = stringField2(field, "type") || "unknown";
-    const description = stringField2(field, "description");
-    const defaultSuffix = Object.prototype.hasOwnProperty.call(field, "default") ? ` default=${JSON.stringify(field.default)}` : "";
-    console.log(
-      `- ${name}${required}: ${type}${defaultSuffix}${description ? ` - ${description}` : ""}`
-    );
+  const declaredSchema = declaredToolJsonSchema(
+    recordField2(contract, "inputSchema")
+  );
+  if (declaredSchema) {
+    console.log("Declared JSON Schema:");
+    console.log(JSON.stringify(declaredSchema, null, 2));
   }
 }
 function printToolExamplesOnly(tool, requestedToolId, options = {}) {
@@ -28426,6 +28460,126 @@ function toolInputFieldsForDisplay(inputSchema) {
     };
   });
 }
+function canonicalToolJsonSchema(inputSchema) {
+  return isRecord9(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
+}
+function declaredToolJsonSchema(inputSchema) {
+  if (isRecord9(inputSchema.jsonSchema)) {
+    return inputSchema.jsonSchema;
+  }
+  return Array.isArray(inputSchema.fields) ? null : inputSchema;
+}
+function publicToolInputSchemaForDescribe(inputSchema) {
+  const exposesProviderSpend = (description) => {
+    const withoutDeeplineCredits = description.replace(
+      /\bdeepline(?:-facing)?\s+credits?\b/gi,
+      ""
+    );
+    return /\bcredits?\b/i.test(withoutDeeplineCredits) || /\bprovider\s+(?:cost|spend|price|pricing|usage)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:costs?|charges?|priced at)\s+[$€£]\s*\d/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:costs?|charges?|priced at)\s+\d+(?:\.\d+)?\s*(?:usd|eur|gbp)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\battribute-priced\b/i.test(withoutDeeplineCredits) || /\b(?:cost|price|pricing)\s+(?:grows?|increases?|scales?|varies?)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:will be|are|is|be)\s+(?:billed|charged)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:additional|extra)\s+charges?\b/i.test(withoutDeeplineCredits) || /\bcharg(?:e|ed)\s+(?:double|per)\b/i.test(withoutDeeplineCredits) || /\bpricing page\b/i.test(withoutDeeplineCredits);
+  };
+  const stripDescriptions = (value) => {
+    if (Array.isArray(value)) return value.map(stripDescriptions);
+    if (!isRecord9(value)) return value;
+    return Object.fromEntries(
+      Object.entries(value).flatMap(([key, nested]) => {
+        if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
+          return [];
+        }
+        return [[key, stripDescriptions(nested)]];
+      })
+    );
+  };
+  return stripDescriptions(inputSchema);
+}
+function recursiveToolInputFieldsForDisplay(inputSchema) {
+  const root = canonicalToolJsonSchema(inputSchema);
+  const fields = /* @__PURE__ */ new Map();
+  const schemasById = /* @__PURE__ */ new Map();
+  const collectSchemaIds = (value) => {
+    if (Array.isArray(value)) {
+      for (const item of value) collectSchemaIds(item);
+      return;
+    }
+    if (!isRecord9(value)) return;
+    if (typeof value.$id === "string" && value.$id.trim()) {
+      schemasById.set(value.$id.trim(), value);
+    }
+    for (const nested of Object.values(value)) collectSchemaIds(nested);
+  };
+  collectSchemaIds(root);
+  const resolveRef = (schema) => {
+    const ref = typeof schema.$ref === "string" ? schema.$ref : "";
+    if (!ref.startsWith("#/")) return schemasById.get(ref) ?? schema;
+    let current = root;
+    for (const rawSegment of ref.slice(2).split("/")) {
+      const segment = rawSegment.replace(/~1/g, "/").replace(/~0/g, "~");
+      if (!isRecord9(current)) return schema;
+      current = current[segment];
+    }
+    return isRecord9(current) ? current : schema;
+  };
+  const addField = (field) => {
+    const name = typeof field.name === "string" ? field.name : "";
+    if (!name) return;
+    const existing = fields.get(name);
+    if (!existing || existing.type === "unknown") {
+      fields.set(name, field);
+    }
+  };
+  const visit = (unresolvedSchema, path, required, activeRefs = /* @__PURE__ */ new Set()) => {
+    const ref = typeof unresolvedSchema.$ref === "string" ? unresolvedSchema.$ref : "";
+    if (ref && activeRefs.has(ref)) return;
+    const schema = resolveRef(unresolvedSchema);
+    const nextActiveRefs = ref ? /* @__PURE__ */ new Set([...activeRefs, ref]) : activeRefs;
+    const type = Array.isArray(schema.type) ? schema.type.map(String).join("|") : typeof schema.type === "string" ? schema.type : isRecord9(schema.properties) ? "object" : schema.items ? "array" : "unknown";
+    if (path) {
+      addField({
+        name: path,
+        type,
+        required,
+        description: schema.description,
+        ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
+        ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
+      });
+    }
+    const properties = isRecord9(schema.properties) ? schema.properties : {};
+    const requiredNames = new Set(
+      Array.isArray(schema.required) ? schema.required.map(String) : []
+    );
+    for (const [name, value] of Object.entries(properties)) {
+      if (!isRecord9(value)) continue;
+      visit(
+        value,
+        path ? `${path}.${name}` : name,
+        requiredNames.has(name),
+        nextActiveRefs
+      );
+    }
+    if (isRecord9(schema.items)) {
+      visit(schema.items, `${path}[]`, false, nextActiveRefs);
+    }
+    for (const keyword of ["anyOf", "oneOf", "allOf"]) {
+      const branches = Array.isArray(schema[keyword]) ? schema[keyword] : [];
+      for (const branch of branches) {
+        if (isRecord9(branch)) {
+          visit(branch, path, required, nextActiveRefs);
+        }
+      }
+    }
+  };
+  visit(root, "", false);
+  return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
+}
 function printSamples(samples) {
   const requestPayload = samplePayload(samples, "request");
   const responsePayload = samplePayload(samples, "response");

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.277",
+  version: "0.1.279",
   contracts: {
     api: {
       name: "sdk-http-api",

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.277",
+  version: "0.1.279",
   contracts: {
     api: {
       name: "sdk-http-api",

package/package.json

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