deepline 0.3.311 → 0.3.312

package/dist/cli/{chunk-ZDO3TO3M.js → chunk-OJ243ZA5.js}

@@ -89,6 +89,7 @@ var PLAY_SQL_LISTENER_WHERE_OPERATOR_SET = new Set(
 );
 var PLAY_AUTHORING_BINDING_FIELDS = {
   root: [
+    "displayName",
     "billing",
     "compatibility",
     "cron",
@@ -185,6 +186,22 @@ var SqlListenerFilterScalarSchema = _typebox.Type.Union([
   _typebox.Type.Null()
 ]);
 var PLAY_AUTHORING_FIELD_REGISTRY = {
+  displayName: {
+    schema: _typebox.Type.String(),
+    fixtures: {
+      valid: "Find verified emails",
+      invalid: 42,
+      absent: void 0,
+      unresolved: { expression: "displayName" },
+      edition1: "Legacy play"
+    },
+    referenceType: "string",
+    required: false,
+    resolution: "static-required",
+    issueCode: "play_authoring_binding_invalid",
+    description: "Optional human-readable Play name; empty uses the derived identifier.",
+    errorMessage: "displayName must be a static string."
+  },
   description: {
     schema: _typebox.Type.String({ minLength: 1 }),
     fixtures: {
@@ -1532,6 +1549,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "};",
   "export type PlayCronInput<TInput> = TInput extends readonly unknown[] ? never : TInput extends object ? TInput : never;",
   "export type PlayBindings<TInput = Record<string, unknown>> = {",
+  `  displayName?: ${cloudReferenceType("displayName")};`,
   `  description?: ${cloudReferenceType("description")};`,
   `  compatibility?: { toolErrorSchemaVersion?: ${cloudReferenceType("compatibility.toolErrorSchemaVersion")}; toolResponseReceiptRevision?: ${cloudReferenceType("compatibility.toolResponseReceiptRevision")} };`,
   `  inline?: ${cloudReferenceType("inline")};`,
@@ -1610,7 +1628,7 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "  log(message: string, options?: { level?: 'debug' | 'info' | 'warn' | 'error'; context?: Readonly<Record<string, string | number | boolean>> }): void;",
   `  sleep(ms: ${cloudReferenceType("ctx.sleep.ms")}): Promise<void>;`,
   "}",
-  "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",
+  "export type DefinePlayConfig<TInput, TOutput extends PlayReturnObject> = { id: string; displayName?: string; description?: string; input: PlayInputContract<TInput>; run: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>; bindings?: PlayBindings<TInput>; billing?: PlayBindings<TInput>['billing']; runtime?: PlayBindings<TInput>['runtime']; compatibility?: PlayBindings<TInput>['compatibility'] };",
   "export type DefinedPlay<TInput, TOutput extends PlayReturnObject> = ((ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>) & { readonly name: string; readonly __inputType?: TInput; readonly __outputType?: TOutput; readonly bindings?: PlayBindings<TInput>; readonly runtime?: PlayBindings<TInput>['runtime']; readonly compatibility?: PlayBindings<TInput>['compatibility'] };",
   "export type PlayHandlerInput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: infer TInput) => Promise<PlayReturnObject> ? TInput : never;",
   "export type PlayHandlerOutput<THandler> = THandler extends (context: DeeplinePlayRuntimeContext, input: unknown) => Promise<infer TOutput extends PlayReturnObject> ? TOutput : never;"

package/dist/cli/{tools-G4HGCHNQ.mjs → chunk-OV6IFAXH.mjs}

@@ -1,7 +1,13 @@
+import {
+  addDescribeOptions,
+  rateLimitSummary,
+  schemaField,
+  schemaFields
+} from "./chunk-76VKBPOC.mjs";
 import {
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-ICZB4GTY.mjs";
+} from "./chunk-MK4K5MQU.mjs";
 import {
   extractSummaryFields,
   projectRowOutput,
@@ -12,8 +18,7 @@ import {
 } from "./chunk-MIMASXO4.mjs";
 import {
   DeeplineClient
-} from "./chunk-5OVNL6LS.mjs";
-import "./chunk-CBVIJSHF.mjs";
+} from "./chunk-NWFE4PGX.mjs";
 import {
   beginToolExecuteCommand,
   getToolExecuteInvocationId,
@@ -28,19 +33,14 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-SPUTBCUR.mjs";
+} from "./chunk-ZH7KTVAB.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-Q3LYQTSO.mjs";
-import "./chunk-DLIRSHV6.mjs";
-import "./chunk-SGTSJCOA.mjs";
-import "./chunk-6IKARAYD.mjs";
+} from "./chunk-WPTUKXIF.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
-import "./chunk-WZYKRD7T.mjs";
-import "./chunk-KRD6H754.mjs";
 
 // src/cli/commands/tools.ts
 import { Option } from "commander";
@@ -333,7 +333,7 @@ function toolConnectionStatusMessage(input) {
 
 // src/cli/commands/tools.ts
 var TOOL_COMMAND_TEMPLATES = {
-  describe: "deepline tools describe <toolId>",
+  describe: "deepline describe <toolId>",
   execute: "deepline tools execute <toolId> --input '{...}'"
 };
 function toListedTool(tool) {
@@ -594,9 +594,7 @@ async function listToolsInCategory(category, emitJson) {
       },
       {
         title: "next",
-        lines: [
-          "Run `deepline tools describe <toolId>` for the full contract."
-        ]
+        lines: ["Run `deepline describe <toolId>` for the full contract."]
       }
     ]
   };
@@ -636,7 +634,7 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
       {
         title: "next",
         lines: [
-          "Run `deepline tools describe <toolId>` before executing a tool."
+          "Run `deepline describe <toolId>` before executing a tool."
         ]
       }
     ]
@@ -802,7 +800,7 @@ function playAliasToolErrorMessage(toolId, play) {
   const playName = play.reference ?? play.name;
   return `${toolId} is a play, not a tool.
 Use: deepline plays run ${playName} --input '{...}'
-Inspect its schema with: deepline plays describe ${playName} --json`;
+Inspect its schema with: deepline describe ${playName}`;
 }
 function printPlayAliasToolError(toolId, play) {
   console.error(playAliasToolErrorMessage(toolId, play));
@@ -847,6 +845,15 @@ function playLikeToolExecuteErrorMessage(toolId, tool) {
 function printPlayLikeToolExecuteError(toolId, tool) {
   console.error(playLikeToolExecuteErrorMessage(toolId, tool));
 }
+var TOOL_ONLY_VIEWS = [
+  "compact",
+  "contractJson",
+  "pricingOnly",
+  "examplesOnly",
+  "gettersOnly",
+  "model",
+  "estimatePayload"
+];
 function registerToolsCommands(program) {
   const tools = program.command("tools").description(
     "Search by intent or structured filters, describe, and execute atomic provider tools."
@@ -859,13 +866,12 @@ Concepts:
 
 Common commands:
   deepline search --type tools email --json
-  deepline tools describe hunter_email_verifier --json
-  deepline tools describe hunter_email_verifier --pricing-only --json
+  deepline describe hunter_email_verifier
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
   deepline billing usage --request-id <job_id> --json
 
 Output:
-  Use describe for tool contracts.
+  Use deepline describe for tool contracts.
   Use execute to run a tool.
   Read pricing before execution; use the returned next.billing command for its
   exact charge. Workspace balance changes also include other callers' activity.
@@ -955,7 +961,6 @@ Examples:
   deepline tools describe hunter_email_verifier
   deepline tools describe hunter_email_verifier --pricing-only
   deepline tools describe hunter_email_verifier --pricing-only --json
-  deepline tools describe hunter_email_verifier --schema-only
   deepline tools describe hunter_email_verifier --examples-only
   deepline tools describe hunter_email_verifier --json
   deepline tools describe deeplineagent --model openai/gpt-5.6-luna --json
@@ -969,7 +974,7 @@ Examples:
     ).option(
       "--estimate-payload <payload>",
       "Quote an ai_evaluate, ai_inference, or deeplineagent JSON payload (inline or @file)"
-    ).option("--pricing-only", "Only print pricing and billing semantics").option("--schema-only", "Only print input schema fields").option(
+    ).option("--pricing-only", "Only print pricing and billing semantics").option(
       "--examples-only",
       "Only print input payload and full Deepline execution response examples"
     ).option("--getters-only", "Only print extracted list/value getters").addOption(
@@ -985,7 +990,7 @@ Examples:
     ).action(async (toolId, options) => {
       const metadata = compatibilityMetadata;
       compatibilityMetadata = void 0;
-      process.exitCode = await getTool(
+      const narrowView = () => getTool(
         toolId,
         {
           json: Boolean(options.json),
@@ -1000,9 +1005,26 @@ Examples:
         },
         metadata
       );
+      const narrow = !toolId || TOOL_ONLY_VIEWS.some((view) => options[view] !== void 0);
+      if (narrow) {
+        process.exitCode = await narrowView();
+        return;
+      }
+      const { describeAnything } = await import("./describe-PAUHJF7H.mjs");
+      process.exitCode = await describeAnything(
+        toolId,
+        { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
+        // An unknown id keeps this command's own error and play hint.
+        narrowView
+      );
     });
   };
-  addToolMetadataCommand(tools.command("describe <toolId>").alias("get"));
+  addToolMetadataCommand(
+    addDescribeOptions(
+      tools.command("describe <toolId>", { hidden: true }).alias("get"),
+      { json: false }
+    )
+  );
   tools.command("execute <toolId>").description("Execute a tool by id.").addHelpText(
     "after",
     `
@@ -1011,14 +1033,14 @@ Notes:
   waterfalls, row maps, checkpoints, and retries.
   Calling a provider-backed tool can spend Deepline credits. Use --json for the
   stable result payload plus output preview and debugging helpers.
-  Read pricing first with tools describe <toolId> --pricing-only --json.
+  Read pricing first with deepline describe <toolId>.
   Use the returned next.billing command to look up this execution's exact charge;
   workspace balance changes also include other callers' activity.
   --timeout sets this CLI request's HTTP deadline; it does not cancel provider work.
 
 Examples:
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
-  deepline tools describe hunter_email_verifier --pricing-only --json
+  deepline describe hunter_email_verifier
   deepline billing usage --request-id <job_id> --json
   deepline tools execute bounceban_verify_bulk --input @batch.json --timeout 10m --json
   deepline tools execute hunter_email_verifier -p email=a@b.com
@@ -1459,7 +1481,127 @@ function printMonitorTypeContract(tool, requestedToolId) {
   console.log("");
   printMonitorTypeDeploy(tool);
   console.log("");
-  console.log(`More: deepline tools get ${toolId} --json`);
+  console.log(`More: deepline describe ${toolId}`);
+}
+function schemaNodeAt(schema, path) {
+  let node = schema;
+  for (const part of path.split(".").filter(Boolean)) {
+    const [key, ...indexes] = part.split("[");
+    node = recordField(isRecord(node) ? node : {}, "properties")[key];
+    for (const _index of indexes)
+      node = isRecord(node) ? node.items : void 0;
+  }
+  return node;
+}
+function jsonSchemaOf(wrapper) {
+  return isRecord(wrapper.jsonSchema) ? wrapper.jsonSchema : wrapper;
+}
+function publicToolSchemas(tool) {
+  const scrubbed = (...keys) => {
+    const schema = recordField(tool, ...keys);
+    if (Object.keys(schema).length === 0) return null;
+    const cleaned = publicToolInputSchemaForDescribe(schema);
+    return isRecord(cleaned.jsonSchema) ? cleaned.jsonSchema : cleaned;
+  };
+  const responseSchema = scrubbed("responseSchema", "response_schema");
+  return {
+    inputSchema: scrubbed(
+      "inputSchema",
+      "input_schema",
+      "payload_schema",
+      "payloadSchema"
+    ),
+    outputSchema: scrubbed("outputSchema", "output_schema"),
+    ...responseSchema ? { responseSchema } : {}
+  };
+}
+function describedTool(tool, requestedToolId) {
+  const id = stringField2(tool, "toolId") || requestedToolId;
+  const displayName = stringField2(tool, "displayName") || void 0;
+  const description = stringField2(tool, "description") || void 0;
+  if (isMonitorTypeTool(tool)) {
+    return {
+      kind: "monitor_type",
+      id,
+      displayName,
+      description,
+      cost: stringField2(recordField(tool, "pricing"), "displayText") || void 0,
+      guidance: [],
+      inputs: schemaFields(
+        recordField(tool, "payload_schema", "payloadSchema")
+      ),
+      outputs: [],
+      runner: {
+        via: "monitor",
+        deploy: stringField2(recordField(tool, "deploy"), "example") || `deepline monitors deploy '{"key":"...","tool":"${id}","payload":{...}}'`
+      }
+    };
+  }
+  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const cost = recordField(contract, "cost");
+  const billing = stringField2(cost, "billingSourceLabel");
+  const deprecation = recordField(contract, "deprecation");
+  const getters = recordField(contract, "getters");
+  const outputSchema = jsonSchemaOf(recordField(contract, "outputSchema"));
+  const toolResult = recordField(tool, "toolResult", "tool_result");
+  const getterDetails = (kind) => new Map(
+    arrayField2(toolResult, kind).filter(isRecord).map((item) => [
+      stringField2(item, "name"),
+      recordField(item, "details")
+    ])
+  );
+  const getterOutputs = (kind, roots) => {
+    const details = getterDetails(kind);
+    return arrayField2(getters, kind).filter(isRecord).map((entry) => {
+      const name = stringField2(entry, "name");
+      const paths = arrayField2(
+        details.get(name) ?? {},
+        "rawToolOutputPaths"
+      ).map((path) => String(path).replace(/^toolResponse\.raw\./, ""));
+      const node = roots.flatMap((root) => paths.map((path) => schemaNodeAt(root, path))).find(isRecord);
+      const { fields, ...typed } = schemaField(name, node, true);
+      const valueType = stringField2(details.get(name) ?? {}, "valueType");
+      const field = {
+        ...typed,
+        // A normalized value has a named type instead of the response's shape.
+        ...valueType ? { type: valueType } : fields ? { fields } : {},
+        // A list's row columns that matter are value getters of their own.
+        ...kind === "extractedLists" && fields ? { summarized: true } : {},
+        read: playResultExpression(entry)
+      };
+      return { field, node };
+    });
+  };
+  const lists = getterOutputs("extractedLists", [outputSchema]);
+  const values = getterOutputs("extractedValues", [
+    outputSchema,
+    ...lists.map(({ node }) => node?.items)
+  ]);
+  const playReference = isPlayLikeTool(tool) ? playReferenceForTool(tool) : null;
+  return {
+    kind: "tool",
+    id: String(contract.toolId),
+    displayName,
+    description,
+    cost: [
+      stringField2(cost, "displayText"),
+      // "Free (free)" says the same thing twice.
+      billing.toLowerCase() === stringField2(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`
+    ].filter(Boolean).join(" ") || void 0,
+    guidance: [
+      ...contract.deprecated === true ? [`Deprecated. ${stringField2(deprecation, "message")}`.trim()] : [],
+      ...Object.values(recordField(contract, "guidance")).filter(
+        (line) => typeof line === "string" && /[a-z0-9]/i.test(line)
+      )
+    ],
+    rateLimit: rateLimitSummary(
+      recordField(contract, "executionMetadata").configuredRateLimits
+    ),
+    inputs: schemaFields(jsonSchemaOf(recordField(contract, "inputSchema"))),
+    outputs: [...lists, ...values].map(({ field }) => field),
+    rawResponse: schemaFields(outputSchema),
+    runner: playReference ? { via: "play", reference: playReference } : { via: "tool", toolId: String(contract.toolId) }
+  };
 }
 function toolGuidanceLines(guidance) {
   const record = isRecord(guidance) ? guidance : {};
@@ -1516,7 +1658,7 @@ function printCompactToolContract(tool, requestedToolId) {
     }
     console.log("");
     console.log(
-      `More: deepline tools describe ${replacementToolId || contract.toolId} --json`
+      `More: deepline describe ${replacementToolId || contract.toolId} --json`
     );
     return;
   }
@@ -1574,9 +1716,7 @@ function printCompactToolContract(tool, requestedToolId) {
   console.log(
     "Provider-specific fields: inspect result.toolResponse.rawV2 and its observed envelope. Prefer the declared getters above."
   );
-  console.log(
-    `More: deepline tools describe ${contract.toolId} --pricing-only | --schema-only | --examples-only | --getters-only | --json`
-  );
+  console.log(`More: deepline describe ${contract.toolId} --json`);
 }
 function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
   if (isMonitorTypeTool(tool)) {
@@ -1718,7 +1858,7 @@ function printPlayLikeToolUsage(tool, requestedToolId) {
     )
   );
   if (playReference) {
-    console.log(`deepline plays describe ${playReference} --json`);
+    console.log(`deepline describe ${playReference}`);
   }
 }
 function printToolGettersOnly(tool, requestedToolId) {
@@ -2993,12 +3133,16 @@ async function executeTool(args) {
   }
   return delivered ? executeExitCode : 1;
 }
+
 export {
-  buildToolExecuteBaseEnvelope,
-  extractToolExecutionWarningMessages,
   isMonitorTypeTool,
-  printCompactToolContract,
-  printMonitorTypeContract,
   registerToolsCommands,
-  toolContractJsonForDescribe
+  toolContractJsonForDescribe,
+  printMonitorTypeContract,
+  publicToolSchemas,
+  describedTool,
+  printCompactToolContract,
+  toolMetadataJsonForDescribe,
+  extractToolExecutionWarningMessages,
+  buildToolExecuteBaseEnvelope
 };