@cargo-ai/cdk 1.0.3 → 1.0.4

package/build/src/cli/typesCommand.js

@@ -0,0 +1,385 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { printJsonSchemaInput, printJsonSchemaType } from "./inputTypes.js";
+import { handleApiCall, info, success } from "./io.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`
+// (everything in the `logic` category gets dedicated syntax instead of
+// going through `native.<slug>`).
+const COMPOSITE_NATIVE = new Set([
+    "start",
+    "end",
+    "agent",
+    "balance",
+    "branch",
+    "delay",
+    "filter",
+    "group",
+    "humanReview",
+    "memory",
+    "split",
+    "switch",
+    "tool",
+    "variables",
+]);
+// Native actions the SDK already ships typed declarations + registrations
+// for (platform-level, identical in every workspace) — skipped so the
+// synced `.d.ts` doesn't redeclare `Native` properties with conflicting
+// (looser) types. Source of truth lives in
+// `packages/workflow-sdk/src/native/manifest.generated.ts`.
+const BUNDLED_NATIVE = new Set([
+    "note",
+    "python",
+    "scoring",
+    "script",
+]);
+export function registerTypesCommand(parent, getApi) {
+    parent
+        .command("types")
+        .description("Generate per-workspace TypeScript types for the Cargo CDK — typed defineConnector/defineModel config + integration actions in workflow bodies")
+        .option("--dir <path>", "Repo root the generated files are written into (default: cwd)")
+        .option("--out <dir>", "Output subdirectory for generated files (default: .cargo-ai)", ".cargo-ai")
+        .action(async (opts) => {
+        const api = getApi();
+        // Match the other `cdk` commands: `--dir` selects the repo root, and the
+        // generated `.cargo-ai` lands there (not wherever the CLI happens to run).
+        if (opts.dir !== undefined)
+            process.chdir(opts.dir);
+        const baseDir = process.cwd();
+        const outDir = resolve(baseDir, opts.out);
+        info(`Fetching workspace surface…`);
+        const payload = await fetchWorkspaceSurface(api);
+        mkdirSync(outDir, { recursive: true });
+        const typesPath = resolve(outDir, "cargo-types.d.ts");
+        writeFileSync(typesPath, renderTypes(payload));
+        success(`Wrote ${relativeToBase(baseDir, typesPath)}`);
+        const eagerPath = resolve(outDir, "cargo-register.ts");
+        writeFileSync(eagerPath, renderEagerRegistration(payload));
+        success(`Wrote ${relativeToBase(baseDir, eagerPath)}`);
+        info(``);
+        info([
+            `Next steps:`,
+            `  1. Add "${relativeToBase(baseDir, outDir)}/**/*.d.ts" to your tsconfig`,
+            `     include so the types are picked up (a bare dot-dir path is ignored by`,
+            `     TypeScript). Enables typed defineConnector/defineModel config.`,
+            `  2. To also type integration actions inside workflow bodies, add`,
+            `     \`import "./${relativeToBase(baseDir, eagerPath).replace(/\.ts$/, ".js")}";\``,
+            `     to your entry file so the workspace's integrations register at runtime.`,
+        ].join("\n"));
+        info(``);
+        const extractorCount = payload.extractorConfigs.reduce((n, e) => n + e.extractors.length, 0);
+        info(`Typed ${String(payload.connectorConfigs.length)} connector config(s), ${String(extractorCount)} extractor config(s), ${String(payload.integrations.length)} integration(s), ${String(payload.native.length)} native action(s).`);
+    });
+}
+async function fetchWorkspaceSurface(api) {
+    const integrationsResult = await handleApiCall(() => api.connection.integration.list({}));
+    const nativeIntegrationResult = await handleApiCall(() => api.connection.nativeIntegration.get());
+    const rawIntegrations = integrationsResult.integrations;
+    const integrations = collectIntegrations(rawIntegrations);
+    const native = collectNative(nativeIntegrationResult.nativeIntegration.actions);
+    const connectorConfigs = collectConnectorConfigs(rawIntegrations);
+    const extractorConfigs = collectExtractorConfigs(rawIntegrations);
+    return { integrations, native, connectorConfigs, extractorConfigs };
+}
+// integrationSlug → connector config type. Skips integrations whose schema
+// prints as a bare record (no typing gained — the builder already falls back to
+// that), keeping the generated file to connectors that actually add types.
+function collectConnectorConfigs(integrations) {
+    const out = [];
+    for (const integration of integrations) {
+        const schema = integration.connector?.config?.schema;
+        if (schema === undefined)
+            continue;
+        const typeSrc = printJsonSchemaType(schema);
+        if (typeSrc === "Record<string, unknown>")
+            continue;
+        out.push({
+            slug: integration.slug,
+            name: trimOrUndefined(integration.name),
+            typeSrc,
+        });
+    }
+    out.sort((a, b) => a.slug.localeCompare(b.slug));
+    return out;
+}
+// integrationSlug → its extractors' config types. Skips extractors whose schema
+// prints as a bare record, and integrations left with none.
+function collectExtractorConfigs(integrations) {
+    const out = [];
+    for (const integration of integrations) {
+        const extractors = [];
+        for (const [slug, extractor] of Object.entries(integration.extractors ?? {}).sort(([a], [b]) => a.localeCompare(b))) {
+            const schema = extractor.config?.schema;
+            if (schema === undefined)
+                continue;
+            const typeSrc = printJsonSchemaType(schema);
+            if (typeSrc === "Record<string, unknown>")
+                continue;
+            extractors.push({ slug, typeSrc });
+        }
+        if (extractors.length === 0)
+            continue;
+        out.push({ integrationSlug: integration.slug, extractors });
+    }
+    out.sort((a, b) => a.integrationSlug.localeCompare(b.integrationSlug));
+    return out;
+}
+function collectIntegrations(integrations) {
+    const out = [];
+    for (const integration of integrations) {
+        const actionEntries = Object.entries(integration.actions ?? {}).sort(([a], [b]) => a.localeCompare(b));
+        if (actionEntries.length === 0)
+            continue;
+        const actions = actionEntries.map(([slug, raw]) => {
+            const meta = raw;
+            return {
+                slug,
+                name: trimOrUndefined(meta.name),
+                description: trimOrUndefined(meta.description),
+                inputTypeSrc: printJsonSchemaInput(meta.config?.schema),
+            };
+        });
+        out.push({
+            slug: integration.slug,
+            name: trimOrUndefined(integration.name),
+            description: trimOrUndefined(integration.description),
+            actions,
+        });
+    }
+    out.sort((a, b) => a.slug.localeCompare(b.slug));
+    return out;
+}
+function collectNative(actions) {
+    const out = [];
+    for (const [slug, meta] of Object.entries(actions)) {
+        if (COMPOSITE_NATIVE.has(slug))
+            continue;
+        if (BUNDLED_NATIVE.has(slug))
+            continue;
+        const name = meta.name.length > 0 ? meta.name : slug;
+        out.push({
+            slug,
+            name,
+            description: trimOrUndefined(meta.description),
+        });
+    }
+    out.sort((a, b) => a.slug.localeCompare(b.slug));
+    return out;
+}
+function trimOrUndefined(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+const GENERATED_AT = new Date().toISOString();
+const HEADER = `// THIS FILE IS GENERATED by \`cargo-ai cdk types\`. Do not edit by hand.
+// Re-run the command to refresh after adding/removing workspace integrations
+// or connectors.
+// Last regenerated: ${GENERATED_AT}
+
+`;
+function renderTypes(payload) {
+    const blocks = [];
+    // ── @cargo-ai/cdk — typed define* config (connector + extractor schemas) ──
+    const cdkLines = [];
+    if (payload.connectorConfigs.length > 0) {
+        cdkLines.push(`  interface ConnectorConfigs {`);
+        for (const c of payload.connectorConfigs) {
+            const doc = formatJsDoc({ name: c.name ?? c.slug, updatedAt: GENERATED_AT }, "    ");
+            if (doc !== "")
+                cdkLines.push(doc.trimEnd());
+            cdkLines.push(`    ${jsonKey(c.slug)}: ${c.typeSrc};`);
+        }
+        cdkLines.push(`  }`);
+    }
+    if (payload.extractorConfigs.length > 0) {
+        cdkLines.push(`  interface ExtractorConfigs {`);
+        for (const e of payload.extractorConfigs) {
+            cdkLines.push(`    ${jsonKey(e.integrationSlug)}: {`);
+            for (const x of e.extractors) {
+                cdkLines.push(`      ${jsonKey(x.slug)}: ${x.typeSrc};`);
+            }
+            cdkLines.push(`    };`);
+        }
+        cdkLines.push(`  }`);
+    }
+    if (cdkLines.length > 0) {
+        blocks.push([`declare module "@cargo-ai/cdk" {`, ...cdkLines, `}`].join("\n"));
+    }
+    // ── @cargo-ai/workflow-sdk — integration actions + natives (workflow bodies) ──
+    const wfLines = [];
+    if (payload.integrations.length > 0) {
+        wfLines.push(`  interface Integrations {`);
+        for (const c of payload.integrations) {
+            const intDoc = formatJsDoc({
+                name: c.name ?? c.slug,
+                description: c.description,
+                updatedAt: GENERATED_AT,
+            }, "    ");
+            if (intDoc !== "")
+                wfLines.push(intDoc.trimEnd());
+            wfLines.push(`    ${jsonKey(c.slug)}: {`);
+            for (const action of c.actions) {
+                const actionDoc = formatJsDoc({
+                    name: action.name,
+                    description: action.description,
+                    category: c.slug,
+                    updatedAt: GENERATED_AT,
+                }, "      ");
+                if (actionDoc !== "")
+                    wfLines.push(actionDoc.trimEnd());
+                wfLines.push(`      ${jsonKey(action.slug)}: IntegrationAction<${action.inputTypeSrc}, Record<string, unknown>>;`);
+            }
+            wfLines.push(`    };`);
+        }
+        wfLines.push(`  }`);
+    }
+    if (payload.native.length > 0) {
+        wfLines.push(`  interface Native {`);
+        for (const n of payload.native) {
+            const doc = formatJsDoc({ name: n.name, description: n.description, updatedAt: GENERATED_AT }, "    ");
+            if (doc !== "")
+                wfLines.push(doc.trimEnd());
+            wfLines.push(`    ${jsonKey(n.slug)}: NativeAction<Record<string, unknown>, Record<string, unknown>>;`);
+        }
+        wfLines.push(`  }`);
+    }
+    // The workflow-sdk augmentation needs its builder types imported; `Ref` only
+    // when a typed action input references it.
+    const preamble = [];
+    // The cdk augmentation references `EncryptionRef` at encryption-typed fields.
+    if (cdkLines.some((l) => l.includes("EncryptionRef"))) {
+        preamble.push(`import type { EncryptionRef } from "@cargo-ai/cdk";`);
+    }
+    if (wfLines.length > 0) {
+        const wfBody = wfLines.join("\n");
+        const imports = [
+            "IntegrationAction",
+            "NativeAction",
+            ...(wfBody.includes("Ref<") ? ["Ref"] : []),
+        ];
+        preamble.push([
+            `import type {`,
+            ...imports.map((name) => `  ${name},`),
+            `} from "@cargo-ai/workflow-sdk";`,
+        ].join("\n"));
+        blocks.push([`declare module "@cargo-ai/workflow-sdk" {`, wfBody, `}`].join("\n"));
+    }
+    // `declare module` only *augments* an existing module when this file is itself
+    // a module. The workflow-sdk import makes it one; when only the cdk block is
+    // emitted there's no import, so force module mode with an empty export.
+    if (preamble.length === 0)
+        preamble.push(`export {};`);
+    return `${HEADER.trim()}\n\n${[...preamble, ...blocks].join("\n\n")}\n`;
+}
+function renderEagerRegistration(payload) {
+    const lines = [];
+    lines.push(HEADER.trim());
+    const imports = [];
+    if (payload.integrations.length > 0)
+        imports.push("registerIntegration");
+    if (payload.native.length > 0)
+        imports.push("registerNative");
+    if (imports.length === 0) {
+        lines.push(``);
+        lines.push(`// Workspace surface is empty (no custom integrations / natives).`);
+        lines.push(``);
+        return lines.join("\n");
+    }
+    lines.push(`import { ${imports.join(", ")} } from "@cargo-ai/workflow-sdk";`);
+    lines.push(``);
+    for (const c of payload.integrations) {
+        lines.push(`registerIntegration(${JSON.stringify(c.slug)}, {`);
+        for (const action of c.actions) {
+            const displayName = action.name !== undefined && action.name.length > 0
+                ? action.name
+                : `${capitalize(c.slug)} ${humanize(action.slug)}`;
+            lines.push(`  ${jsonKey(action.slug)}: { name: ${JSON.stringify(displayName)} },`);
+        }
+        lines.push(`});`);
+    }
+    for (const n of payload.native) {
+        lines.push(`registerNative(${JSON.stringify(n.slug)}, ${JSON.stringify(n.name)});`);
+    }
+    lines.push(``);
+    return lines.join("\n");
+}
+function jsonKey(key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+}
+// Render a JSDoc block above a generated declaration so editors surface the
+// entry's metadata on hover. Returns "" when there's nothing to document.
+function formatJsDoc(doc, indent) {
+    const body = [];
+    if (doc.name !== undefined && doc.name.trim().length > 0) {
+        body.push(doc.name.trim());
+    }
+    if (doc.description !== undefined && doc.description.trim().length > 0) {
+        if (body.length > 0)
+            body.push("");
+        for (const line of doc.description.split("\n")) {
+            body.push(line.trimEnd());
+        }
+    }
+    const tags = [];
+    if (doc.category !== undefined) {
+        const cats = Array.isArray(doc.category)
+            ? doc.category.join(", ")
+            : String(doc.category);
+        if (cats.trim().length > 0) {
+            tags.push(`@category ${cats}`);
+        }
+    }
+    if (doc.author !== undefined && doc.author.trim().length > 0) {
+        tags.push(`@author ${doc.author.trim()}`);
+    }
+    if (doc.version !== undefined && String(doc.version).length > 0) {
+        tags.push(`@version ${String(doc.version)}`);
+    }
+    if (doc.updatedAt !== undefined && doc.updatedAt !== null) {
+        const date = doc.updatedAt instanceof Date ? doc.updatedAt : new Date(doc.updatedAt);
+        if (!Number.isNaN(date.getTime())) {
+            tags.push(`@updated ${date.toISOString().slice(0, 10)}`);
+        }
+    }
+    if (doc.see !== undefined && doc.see.trim().length > 0) {
+        tags.push(`@see ${doc.see.trim()}`);
+    }
+    if (body.length > 0 && tags.length > 0) {
+        body.push("");
+    }
+    body.push(...tags);
+    if (body.length === 0)
+        return "";
+    const out = [`${indent}/**`];
+    for (const line of body) {
+        const safe = line.replace(/\*\//g, "*\\/");
+        out.push(safe.length > 0 ? `${indent} * ${safe}` : `${indent} *`);
+    }
+    out.push(`${indent} */`);
+    return `${out.join("\n")}\n`;
+}
+function capitalize(s) {
+    if (s.length === 0)
+        return s;
+    const first = s[0];
+    if (first === undefined)
+        return s;
+    return first.toUpperCase() + s.slice(1);
+}
+function humanize(slug) {
+    return slug
+        .replace(/([A-Z])/g, " $1")
+        .replace(/[_-]+/g, " ")
+        .trim()
+        .toLowerCase();
+}
+function relativeToBase(base, path) {
+    if (path.startsWith(base)) {
+        const rel = path.slice(base.length);
+        return rel.startsWith("/") ? rel.slice(1) : rel;
+    }
+    return path;
+}

package/build/src/cli/version.d.ts

@@ -0,0 +1,2 @@
+export declare function packageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/build/src/cli/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/cli/version.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,IAAI,MAAM,CAkBvC"}

package/build/src/cli/version.js

@@ -0,0 +1,25 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+// Read this package's version by walking up to the nearest `@cargo-ai/cdk`
+// package.json — a walk (not a fixed relative path) so it's independent of build
+// layout depth.
+export function packageVersion() {
+    let cursor = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 8; i += 1) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(cursor, "package.json"), "utf-8"));
+            if (pkg.name === "@cargo-ai/cdk" && typeof pkg.version === "string") {
+                return pkg.version;
+            }
+        }
+        catch {
+            // no package.json here (or unreadable) — keep walking up
+        }
+        const parent = dirname(cursor);
+        if (parent === cursor)
+            break;
+        cursor = parent;
+    }
+    return "0.0.0";
+}

package/build/src/deploy/executors.live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executors.live.d.ts","sourceRoot":"","sources":["../../../src/deploy/executors.live.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,YAAY,CAAC;AA4BrD,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAkqBjD"}
+{"version":3,"file":"executors.live.d.ts","sourceRoot":"","sources":["../../../src/deploy/executors.live.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,YAAY,CAAC;AA4BrD,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CA4qBjD"}

package/build/src/deploy/executors.live.js

@@ -2,6 +2,8 @@
 // Each executor receives the token-resolved spec (real uuids in place of tokens)
 // and the prior state entry, and decides: prior uuid → update; else (connector/
 // model, which have addressable slugs) exists-by-slug → adopt; else create.
+// Explicit connector adopt (`adopt: true`) links the integration's default
+// connector first, falling back to a slug match.
 //
 // This is the only file that imports @cargo-ai/api. Workspace is implicit — the
 // authenticated client already sends the selected-workspace-uuid header.
@@ -61,15 +63,25 @@ export function liveExecutors(api) {
                 }
                 return out;
             }
-            const adopt = spec["adopt"] === true ||
+            const explicitAdopt = spec["adopt"] === true;
+            const adopt = explicitAdopt ||
                 (await api.connection.connector.existsBySlug({ slug })).exists;
             if (adopt) {
                 const { connectors } = await api.connection.connector.list({
                     integrationSlug,
                 });
-                const found = connectors.find((c) => c.slug === slug);
+                // Explicit adopt (the OAuth escape hatch) links whatever connector the
+                // workspace already treats as default for this integration, falling back
+                // to a slug match. Implicit adopt (a same-slug connector already exists)
+                // recovers that exact slot, so it stays a strict slug match.
+                const found = explicitAdopt
+                    ? (connectors.find((c) => c.isDefault === true) ??
+                        connectors.find((c) => c.slug === slug))
+                    : connectors.find((c) => c.slug === slug);
                 if (found === undefined) {
-                    throw new Error(`connector "${slug}" reported to exist but was not found`);
+                    throw new Error(explicitAdopt
+                        ? `no connector found to adopt for integration "${integrationSlug}"`
+                        : `connector "${slug}" reported to exist but was not found`);
                 }
                 // Mark as adopted — the CDK linked an existing connector it didn't
                 // create, so destroy must release it rather than delete it.

package/build/src/resources/bundle.d.ts

@@ -7,9 +7,11 @@ export declare function readBundle(root: string): SourceFile[];
 /**
  * Fail at define time (not after a multi-minute server build) when a worker/app
  * bundle is missing a file the hosting build requires. `label` names the kind in
- * the error message.
+ * the error message. When `anyOf` is provided, at least one of those files must
+ * also exist — used for entrypoints that may live at more than one path (e.g. a
+ * worker's `src/index.ts` TS source or a pre-built `index.js`).
  */
-export declare function assertBundleFiles(root: string, label: string, required: string[]): void;
+export declare function assertBundleFiles(root: string, label: string, required: string[], anyOf?: string[]): void;
 /** A content hash over the whole bundle — changes when any file changes. */
 export declare function bundleHash(root: string): string;
 //# sourceMappingURL=bundle.d.ts.map

package/build/src/resources/bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/resources/bundle.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAmB3D,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAOrD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,GACjB,IAAI,CAYN;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS/C"}
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/resources/bundle.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAmB3D,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAOrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,EAClB,KAAK,CAAC,EAAE,MAAM,EAAE,GACf,IAAI,CAqBN;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS/C"}

package/build/src/resources/bundle.js

@@ -35,9 +35,11 @@ export function readBundle(root) {
 /**
  * Fail at define time (not after a multi-minute server build) when a worker/app
  * bundle is missing a file the hosting build requires. `label` names the kind in
- * the error message.
+ * the error message. When `anyOf` is provided, at least one of those files must
+ * also exist — used for entrypoints that may live at more than one path (e.g. a
+ * worker's `src/index.ts` TS source or a pre-built `index.js`).
  */
-export function assertBundleFiles(root, label, required) {
+export function assertBundleFiles(root, label, required, anyOf) {
     const base = isAbsolute(root) ? root : resolve(process.cwd(), root);
     if (!existsSync(base)) {
         throw new Error(`${label} code path not found: ${base}`);
@@ -47,6 +49,13 @@ export function assertBundleFiles(root, label, required) {
         throw new Error(`${label} bundle at "${root}" is missing required file(s): ${missing.join(", ")}. ` +
             `A ${label} bundle must contain ${required.join(", ")} at its root.`);
     }
+    if (anyOf !== undefined && anyOf.length > 0) {
+        const hasEntrypoint = anyOf.some((file) => existsSync(join(base, file)));
+        if (!hasEntrypoint) {
+            throw new Error(`${label} bundle at "${root}" is missing an entrypoint. ` +
+                `Expected one of: ${anyOf.join(", ")}.`);
+        }
+    }
 }
 /** A content hash over the whole bundle — changes when any file changes. */
 export function bundleHash(root) {

package/build/src/resources/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/resources/connector.ts"],"names":[],"mappings":"AAWA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC9B,CAAC;AAQF,MAAM,WAAW,gBAAgB;CAAG;AAEpC,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,gBAAgB,GACxE,gBAAgB,CAAC,CAAC,CAAC,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACrD,WAAW,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B;;mEAE+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,CAuBpB"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/resources/connector.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC9B,CAAC;AAQF,MAAM,WAAW,gBAAgB;CAAG;AAEpC,KAAK,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,gBAAgB,GACxE,gBAAgB,CAAC,CAAC,CAAC,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACrD,WAAW,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B;;mEAE+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,CAuBpB"}

package/build/src/resources/connector.js

@@ -6,8 +6,9 @@
 // slug is known at define time, so it's a plain value on the handle.
 //
 // Two modes: create (config-based integrations, secrets via env) or adopt
-// (`adopt: true`) to link an already-authenticated connector by slug — the
-// escape hatch for OAuth integrations whose tokens can't live in a repo.
+// (`adopt: true`) to link an already-authenticated connector — the escape hatch
+// for OAuth integrations whose tokens can't live in a repo. Adopt links the
+// integration's default connector first, falling back to a slug match.
 import { register, resourceId, token } from "../core.js";
 export function defineConnector(slug, spec) {
     const id = resourceId("connector", slug);

package/build/src/resources/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/resources/worker.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAWhD,MAAM,MAAM,UAAU,GAAG;IACvB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAkBzE"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/resources/worker.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAmBhD,MAAM,MAAM,UAAU,GAAG;IACvB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAkBzE"}

package/build/src/resources/worker.js

@@ -5,17 +5,24 @@
 import { register, resourceId, token } from "../core.js";
 import { refUuid } from "../refs.js";
 import { assertBundleFiles, bundleHash } from "./bundle.js";
-// Files the hosting worker build requires at the bundle root: a built entry
-// (esbuild bundles it — no TS transpile), a manifest, and an npm-ci'able project.
-const WORKER_REQUIRED = [
+// Files the hosting worker build always requires at the bundle root: a manifest
+// and an npm-ci'able project. Like an app, a worker is uploaded as *source* and
+// built server-side — the hosting build runs `npm ci` then esbuilds the
+// entrypoint (esbuild transpiles TypeScript natively).
+const WORKER_REQUIRED = ["manifest.json", "package.json", "package-lock.json"];
+// The entrypoint may be authored in TypeScript (`src/index.ts`) — the same way
+// an app ships `src/main.tsx` and is built with Vite — or shipped pre-built as
+// `index.js`. At least one of these must exist; the hosting build resolves them
+// in this order.
+const WORKER_ENTRYPOINTS = [
+    "src/index.ts",
+    "src/index.js",
+    "index.ts",
     "index.js",
-    "manifest.json",
-    "package.json",
-    "package-lock.json",
 ];
 export function defineWorker(slug, spec) {
     const id = resourceId("worker", slug);
-    assertBundleFiles(spec.path, "worker", WORKER_REQUIRED);
+    assertBundleFiles(spec.path, "worker", WORKER_REQUIRED, WORKER_ENTRYPOINTS);
     register({
         id,
         kind: "worker",