@cargo-ai/cdk 1.0.8 → 1.0.9

package/build/src/cli/commands/inputTypes.d.ts

@@ -15,6 +15,14 @@ export declare function printJsonSchemaInput(schema: unknown): string;
  * workflow builder Refs). Used by `cargo-ai cdk types`.
  */
 export declare function printJsonSchemaType(schema: unknown): string;
+/**
+ * Print an integration action's static output JSON Schema as a plain TS type —
+ * no `Ref<T> | T` widening and no `EncryptionRef`. Returns `undefined` when
+ * the schema is missing or too loose to be useful; the caller falls back to
+ * `any`, which stays usable everywhere a nested `Ref<Record<string, unknown>>`
+ * would not.
+ */
+export declare function printJsonSchemaOutput(schema: unknown): string | undefined;
 /**
  * Print a tool release's `formFields` as a TS input type. Returns
  * `undefined` when the fields can't be interpreted (caller falls back to

package/build/src/cli/commands/inputTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputTypes.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/inputTypes.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAE+D,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAM5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQ3D;AAmTD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAU5E"}
+{"version":3,"file":"inputTypes.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/inputTypes.ts"],"names":[],"mappings":"AAqCA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAE+D,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAM5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAQ3D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQzE;AAmUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAU5E"}

package/build/src/cli/commands/inputTypes.js

@@ -1,17 +1,19 @@
-// TypeScript input-type printers for `cargo-ai workflow sync` codegen.
+// TypeScript type printers for `cargo-ai workflow sync` codegen.
 //
-// Three sources of truth, three printers:
+// Sources of truth:
 //   - Integration actions expose their config as JSON Schema on
-//     `connection.integration.list` (`action.config.schema`).
+//     `connection.integration.list` (`action.config.schema`), and — for
+//     actions with a static output — their output as `action.output.schema`.
 //   - Workspace tools expose their input as `formFields` on the tool
 //     workflow's deployed release (`orchestration.release.getDeployed`).
 //   - Agent nodes accept a single global shape (`{ prompt, output? }`) —
 //     the engine validates every agent node against `AiUtils.agentConfig`.
 //
-// All printers run in "input mode": each top-level property is widened to
-// `Ref<T> | T` so callers can pass either a builder Ref or a literal.
-// Anything unrecognized falls back to `unknown` — codegen must never abort
-// on a schema edge case.
+// Input printers run in "input mode": each top-level property is widened to
+// `Ref<T> | T` so callers can pass either a builder Ref or a literal. The
+// output printer emits plain types (outputs come back as a `Ref` the caller
+// dot-accesses). Anything unrecognized falls back to `unknown` — codegen must
+// never abort on a schema edge case.
 //
 // Mirrors `packages/workflow-sdk/scripts/lib/jsonSchemaToTs.ts` (which is a
 // build-time-only script the CLI can't import).
@@ -47,6 +49,22 @@ export function printJsonSchemaType(schema) {
     const printed = printSchema(schema, false, true);
     return printed === "unknown" ? "Record<string, unknown>" : printed;
 }
+/**
+ * Print an integration action's static output JSON Schema as a plain TS type —
+ * no `Ref<T> | T` widening and no `EncryptionRef`. Returns `undefined` when
+ * the schema is missing or too loose to be useful; the caller falls back to
+ * `any`, which stays usable everywhere a nested `Ref<Record<string, unknown>>`
+ * would not.
+ */
+export function printJsonSchemaOutput(schema) {
+    if (schema === null || typeof schema !== "object") {
+        return undefined;
+    }
+    const printed = printSchema(schema, false, false);
+    return printed === "unknown" || printed === "Record<string, unknown>"
+        ? undefined
+        : printed;
+}
 // The platform's shared `encryption` schema definition: an object with a `type`
 // const/enum of "encryption" plus `isEncrypted` and `value`. In CDK config types
 // these positions become `EncryptionRef` (see printObject).
@@ -65,6 +83,10 @@ function isEncryptionSchema(schema) {
 }
 function printSchema(schema, topLevel, encRef) {
     if (Array.isArray(schema.type)) {
+        // zod's `z.any()` lowers to the full list of JSON types; print `unknown`
+        // instead of a noisy 7-member union.
+        if (isAnyTypeList(schema.type))
+            return "unknown";
         return uniqueUnion(schema.type.map((t) => printPrimitive(t, schema, false, encRef)));
     }
     if (schema.enum !== undefined && schema.enum.length > 0) {
@@ -103,6 +125,17 @@ function printSchema(schema, topLevel, encRef) {
         return "unknown";
     return printPrimitive(schema.type, schema, topLevel, encRef);
 }
+const ANY_TYPE_LIST = [
+    "string",
+    "number",
+    "boolean",
+    "object",
+    "array",
+    "null",
+];
+function isAnyTypeList(types) {
+    return ANY_TYPE_LIST.every((t) => types.includes(t));
+}
 function printPrimitive(type, schema, topLevel, encRef) {
     switch (type) {
         case "string":

package/build/src/cli/commands/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiHzC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAgE7E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwHzC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI,CAgE7E"}

package/build/src/cli/commands/types.js

@@ -1,7 +1,7 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { resolve } from "node:path";
 import { handleApiCall, info, success } from "../io.js";
-import { printJsonSchemaInput, printJsonSchemaType } from "./inputTypes.js";
+import { printJsonSchemaInput, printJsonSchemaOutput, printJsonSchemaType, } from "./inputTypes.js";
 // Composite natives surfaced via dedicated SDK syntax / scope helpers —
 // excluded so we don't double-register them. Mirrors the codegen exclusion
 // list in `packages/workflow-sdk/scripts/generateNativeIntegration.ts`
@@ -186,12 +186,13 @@ function collectIntegrations(integrations) {
             continue;
         const actions = actionEntries.map(([slug, raw]) => {
             const meta = raw;
-            const { config } = meta;
+            const { config, output } = meta;
             return {
                 slug,
                 name: trimOrUndefined(meta.name),
                 description: trimOrUndefined(meta.description),
                 inputTypeSrc: printJsonSchemaInput(config !== undefined ? config.schema : undefined),
+                outputTypeSrc: printJsonSchemaOutput(output !== undefined ? output.schema : undefined),
             };
         });
         out.push({
@@ -308,10 +309,12 @@ function renderTypes(payload) {
                 }, "      ");
                 if (actionDoc !== "")
                     wfLines.push(actionDoc.trimEnd());
-                // Action outputs aren't schema-typed, so `any` (not `Record<string,
+                // Actions with a static output schema get a real output type; the rest
+                // (dynamic or absent outputs) fall back to `any` (not `Record<string,
                 // unknown>`, which lowers to an unusable nested `Ref`) — the result is
                 // then usable as a string, an object, or in any typed slot.
-                wfLines.push(`      ${jsonKey(action.slug)}: IntegrationAction<${action.inputTypeSrc}, any>;`);
+                const outputSrc = action.outputTypeSrc !== undefined ? action.outputTypeSrc : "any";
+                wfLines.push(`      ${jsonKey(action.slug)}: IntegrationAction<${action.inputTypeSrc}, ${outputSrc}>;`);
             }
             wfLines.push(`    };`);
         }