@cargo-ai/cdk 1.0.2 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cargo-ai/cdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Cargo CDK — define every Cargo resource (connectors, models, plays, tools, agents, MCP servers, folders, files, workers, apps) in code and deploy it declaratively: plan, apply, refresh, import and destroy over a repo of definitions.",
   "keywords": [
     "cargo",
@@ -20,6 +20,9 @@
     "node": "22.22.2"
   },
   "type": "module",
+  "bin": {
+    "cargo-cdk": "./build/src/cli/bin.js"
+  },
   "exports": {
     ".": {
       "types": "./build/src/index.d.ts",
@@ -29,6 +32,10 @@
       "types": "./build/src/deploy/index.d.ts",
       "default": "./build/src/deploy/index.js"
     },
+    "./cli": {
+      "types": "./build/src/cli/index.d.ts",
+      "default": "./build/src/cli/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -50,10 +57,13 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
-    "@cargo-ai/api": "^1.0.32",
-    "@cargo-ai/types": "^1.0.34",
-    "@cargo-ai/worker-sdk": "^1.0.2",
+    "@cargo-ai/api": "^1.0.33",
+    "@cargo-ai/types": "^1.0.36",
+    "@cargo-ai/worker-sdk": "^1.0.4",
     "@cargo-ai/workflow-sdk": "^1.0.1",
+    "commander": "^12.1.0",
+    "http-proxy-agent": "^9.1.0",
+    "https-proxy-agent": "^9.1.0",
     "tsx": "^4.19.3",
     "zod": "4.4.3"
   },

package/templates/blank/package.json

@@ -3,9 +3,9 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "types": "cargo-ai cdk types",
-    "plan": "cargo-ai cdk plan",
-    "deploy": "cargo-ai cdk deploy"
+    "types": "cargo-cdk types",
+    "plan": "cargo-cdk plan",
+    "deploy": "cargo-cdk deploy"
   },
   "dependencies": {
     "@cargo-ai/cdk": "^0.1.0",

package/templates/full/README.md

@@ -21,29 +21,30 @@ playbook (file)   webhook (worker)   dashboard (app)
 
 ## What each file shows
 
-| File                                    | Resource                        | Highlights                                                                                                            |
-| --------------------------------------- | ------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
-| `connectors/hubspot.ts`                 | `defineConnector`               | discriminated-union config + `secret()`; auto-creates a dataset                                                       |
-| `connectors/openai.ts`                  | `defineConnector`               | `adopt: true` to link an existing OAuth connector                                                                     |
-| `folders/crm.ts`                        | `defineFolder`                  | per-kind folders (model vs agent)                                                                                     |
-| `models/contacts.ts`                    | `defineModel`                   | `dataset` handle + `extractSlug` + cron schedule                                                                      |
-| `tools/enrich.ts`                       | `defineWorkflow` + `defineTool` | a tool backed by a workflow, with a cron trigger                                                                      |
-| `agents/enricher.ts`                    | `defineAgent`                   | a focused sub-agent (LLM via `connector`)                                                                             |
-| `agents/sdr.ts`                         | `defineAgent`                   | data model, sub-agent, trigger, evaluator                                                                             |
-| `plays/onboarding.ts`                   | `definePlay` + `defineWorkflow` | runs a per-row workflow as contacts change                                                                            |
-| `mcp/crm.ts`                            | `defineMcpServer`               | bundles tool + agent + model behind one endpoint                                                                      |
-| `context/context.ts` (+ `context/*.md`) | `defineContext`                 | syncs the GTM knowledge base (markdown/MDX) into the workspace's context repo                                         |
-| `files/playbook.ts`                     | `defineFile`                    | content uploaded from a local path                                                                                    |
-| `workers/webhook.ts` (+ `webhook/`)     | `defineWorker`                  | the worker _resource_; points at a built bundle (`index.js` + `manifest.json` + `package.json` + `package-lock.json`) |
-| `apps/dashboard.ts` (+ `dashboard/`)    | `defineApp`                     | a hosted Vite app (`index.html` + `package.json` + `package-lock.json`)                                               |
+| File                                    | Resource                        | Highlights                                                                                                                    |
+| --------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `connectors/hubspot.ts`                 | `defineConnector`               | discriminated-union config + `secret()`; auto-creates a dataset                                                               |
+| `connectors/openai.ts`                  | `defineConnector`               | `adopt: true` to link an existing OAuth connector                                                                             |
+| `folders/crm.ts`                        | `defineFolder`                  | per-kind folders (model vs agent)                                                                                             |
+| `models/contacts.ts`                    | `defineModel`                   | `dataset` handle + `extractSlug` + cron schedule                                                                              |
+| `tools/enrich.ts`                       | `defineWorkflow` + `defineTool` | a tool backed by a workflow, with a cron trigger                                                                              |
+| `agents/enricher.ts`                    | `defineAgent`                   | a focused sub-agent (LLM via `connector`)                                                                                     |
+| `agents/sdr.ts`                         | `defineAgent`                   | data model, sub-agent, trigger, evaluator                                                                                     |
+| `plays/onboarding.ts`                   | `definePlay` + `defineWorkflow` | runs a per-row workflow as contacts change                                                                                    |
+| `mcp/crm.ts`                            | `defineMcpServer`               | bundles tool + agent + model behind one endpoint                                                                              |
+| `context/context.ts` (+ `context/*.md`) | `defineContext`                 | syncs the GTM knowledge base (markdown/MDX) into the workspace's context repo                                                 |
+| `files/playbook.ts`                     | `defineFile`                    | content uploaded from a local path                                                                                            |
+| `workers/webhook.ts` (+ `webhook/`)     | `defineWorker`                  | the worker _resource_; points at a TS source bundle (`src/index.ts` + `manifest.json` + `package.json` + `package-lock.json`) |
+| `apps/dashboard.ts` (+ `dashboard/`)    | `defineApp`                     | a hosted Vite app (`index.html` + `package.json` + `package-lock.json`)                                                       |
 
 `defineWorker` vs `createWorker`: `defineWorker` is the deployable **resource**
 (the hosted slot). `createWorker` (from `@cargo-ai/worker-sdk`) is what you use to
-author the worker's **runtime code** — the hosting build esbuilds the bundle's
-`index.js`, so author in TS and build to `index.js` before deploying. The CDK
-checks the required bundle files exist at define time. The worker/app
-sub-directories each have their own `package.json`, so the loader treats them as
-bundles to upload, not as resource files to import.
+author the worker's **runtime code** at `src/index.ts`. Like an app, the worker
+is uploaded as source and built by Cargo Hosting (the build runs `npm ci` then
+esbuilds the entry — esbuild transpiles TypeScript natively), so there's no local
+build step. The CDK checks the required bundle files exist at define time. The
+worker/app sub-directories each have their own `package.json`, so the loader
+treats them as bundles to upload, not as resource files to import.
 
 ## Try it
 

package/templates/full/apps/dashboard/index.html

@@ -5,7 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Pipeline Dashboard</title>
   </head>
-  <body>
+  <body class="bg-background text-foreground">
     <div id="root"></div>
     <script type="module" src="/src/main.tsx"></script>
   </body>

package/templates/full/apps/dashboard/package.json

@@ -1,15 +1,30 @@
 {
   "name": "dashboard",
   "private": true,
+  "version": "1.0.0",
   "type": "module",
   "scripts": {
-    "build": "vite build"
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "type:check": "tsc --noEmit"
   },
   "dependencies": {
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1"
+    "@auth0/auth0-react": "^2.11.0",
+    "@cargo-ai/api": "^1.0.32",
+    "@cargo-ai/app-sdk": "^1.0.2",
+    "react": "18.3.1",
+    "react-dom": "18.3.1",
+    "react-router-dom": "^6.30.0"
   },
   "devDependencies": {
+    "@types/react": "^18.3.25",
+    "@types/react-dom": "^18.3.7",
+    "@vitejs/plugin-react": "^4.3.0",
+    "autoprefixer": "^10.4.21",
+    "postcss": "^8.5.10",
+    "tailwindcss": "^3.4.0",
+    "typescript": "5.3.2",
     "vite": "^5.4.0"
   }
 }

package/templates/full/apps/dashboard/src/App.tsx

@@ -0,0 +1,57 @@
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CargoEmpty,
+  CargoRefineApp,
+  CargoSiderLayout,
+  CargoWorkspaceBadge,
+  getCargoEnv,
+} from "@cargo-ai/app-sdk";
+import { LayoutDashboard } from "lucide-react";
+import React from "react";
+import { Route, Routes } from "react-router-dom";
+
+const resources = [
+  {
+    name: "pipeline",
+    list: "/",
+    meta: {
+      label: "Pipeline",
+      icon: <LayoutDashboard className="h-4 w-4" />,
+    },
+  },
+];
+
+const Home: React.FC = () => {
+  const env = getCargoEnv();
+
+  return (
+    <div className="flex flex-col gap-4 p-6">
+      <CargoWorkspaceBadge />
+      <Card>
+        <CardHeader>
+          <CardDescription>App UUID</CardDescription>
+        </CardHeader>
+        <CardContent className="font-mono text-xs">{env.appUuid}</CardContent>
+      </Card>
+      <CargoEmpty
+        title="Pipeline overview for the sales team"
+        description="Wire up `useCargoApi()` + react-query to render your pipeline here."
+      />
+    </div>
+  );
+};
+
+export const App: React.FC = () => {
+  return (
+    <CargoRefineApp resources={resources}>
+      <CargoSiderLayout title="Pipeline Dashboard">
+        <Routes>
+          <Route path="/" element={<Home />} />
+        </Routes>
+      </CargoSiderLayout>
+    </CargoRefineApp>
+  );
+};

package/templates/full/apps/dashboard/src/index.css

@@ -0,0 +1,4 @@
+@import "@cargo-ai/app-sdk/styles.css";
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/templates/full/apps/dashboard/src/main.tsx

@@ -1,12 +1,18 @@
-import { StrictMode } from "react";
-import { createRoot } from "react-dom/client";
+import React from "react";
+import ReactDOM from "react-dom/client";
 
-function App() {
-  return <h1>Pipeline Dashboard</h1>;
+import { App } from "./App";
+
+import "./index.css";
+
+const rootElement = document.getElementById("root");
+
+if (rootElement === null) {
+  throw new Error("Root element #root not found in index.html");
 }
 
-createRoot(document.getElementById("root")!).render(
-  <StrictMode>
+ReactDOM.createRoot(rootElement).render(
+  <React.StrictMode>
     <App />
-  </StrictMode>,
+  </React.StrictMode>,
 );

package/templates/full/apps/dashboard/tailwind.config.ts

@@ -0,0 +1,13 @@
+import cargoPreset from "@cargo-ai/app-sdk/tailwind-preset";
+import type { Config } from "tailwindcss";
+
+const config: Config = {
+  presets: [cargoPreset],
+  content: [
+    "./index.html",
+    "./src/**/*.{ts,tsx}",
+    "./node_modules/@cargo-ai/app-sdk/build/**/*.js",
+  ],
+};
+
+export default config;

package/templates/full/apps/dashboard/tsconfig.json

@@ -1,13 +1,20 @@
 {
   "compilerOptions": {
     "target": "ES2022",
+    "useDefineForClassFields": true,
     "lib": ["ES2022", "DOM", "DOM.Iterable"],
     "module": "ESNext",
-    "moduleResolution": "Bundler",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
     "jsx": "react-jsx",
     "strict": true,
-    "skipLibCheck": true,
-    "noEmit": true
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true
   },
   "include": ["src"]
 }

package/templates/full/apps/dashboard/vite.config.ts

@@ -0,0 +1,22 @@
+import react from "@vitejs/plugin-react";
+import autoprefixer from "autoprefixer";
+import tailwindcss from "tailwindcss";
+import { defineConfig } from "vite";
+
+// Cargo Hosting bakes VITE_APP_BASE_PATH into the env so apps can be served
+// from a subpath in dev. In production deployments base="/" works because each
+// app gets its own subdomain.
+const base =
+  process.env["VITE_APP_BASE_PATH"] !== undefined
+    ? process.env["VITE_APP_BASE_PATH"]
+    : "/";
+
+export default defineConfig({
+  plugins: [react()],
+  base,
+  css: {
+    postcss: {
+      plugins: [tailwindcss, autoprefixer],
+    },
+  },
+});

package/templates/full/package.json

@@ -3,9 +3,9 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "types": "cargo-ai cdk types",
-    "plan": "cargo-ai cdk plan",
-    "deploy": "cargo-ai cdk deploy"
+    "types": "cargo-cdk types",
+    "plan": "cargo-cdk plan",
+    "deploy": "cargo-cdk deploy"
   },
   "dependencies": {
     "@cargo-ai/cdk": "^0.1.0",

package/templates/full/workers/webhook/package.json

@@ -2,5 +2,16 @@
   "name": "webhook",
   "version": "1.0.0",
   "private": true,
-  "type": "module"
+  "type": "module",
+  "scripts": {
+    "type:check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@cargo-ai/worker-sdk": "^1.0.3",
+    "zod": "4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.8",
+    "typescript": "5.3.2"
+  }
 }

package/templates/full/workers/webhook/src/index.ts

@@ -0,0 +1,53 @@
+// The worker is uploaded as *source* and built by Cargo Hosting: the build
+// runs `npm ci` then esbuilds this entry (esbuild transpiles TypeScript
+// natively), so author in TS — no local build step needed.
+//
+// `createWorker` from @cargo-ai/worker-sdk (Hono + Chanfana) means every route
+// registered on `openapi` is described in the generated OpenAPI 3.1 spec
+// (served at `/openapi.json`) and browsable at `/docs`.
+import { type Context, createWorker, OpenAPIRoute } from "@cargo-ai/worker-sdk";
+import { z } from "zod";
+
+const { app, openapi } = createWorker({
+  title: "webhook",
+  description: "Receives inbound lead webhooks.",
+});
+
+class ReceiveLead extends OpenAPIRoute {
+  override schema = {
+    tags: ["leads"],
+    summary: "Receive an inbound lead.",
+    request: {
+      body: {
+        content: {
+          "application/json": {
+            schema: z.object({
+              email: z.string().email().describe("Lead's email address."),
+              name: z.string().optional().describe("Lead's full name."),
+              company: z.string().optional().describe("Lead's company."),
+            }),
+          },
+        },
+      },
+    },
+    responses: {
+      200: {
+        description: "Lead accepted.",
+        content: {
+          "application/json": {
+            schema: z.object({ accepted: z.literal(true) }),
+          },
+        },
+      },
+    },
+  };
+
+  override async handle(c: Context): Promise<Response> {
+    await this.getValidatedData<typeof this.schema>();
+    return c.json({ accepted: true as const });
+  }
+}
+
+openapi.post("/", ReceiveLead);
+
+export default app;

package/templates/full/workers/webhook/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "nodenext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/full/workers/webhook.ts

@@ -1,12 +1,14 @@
 import { defineWorker } from "@cargo-ai/cdk";
 
-// `defineWorker` is the *resource* — the hosted worker slot. Its `path` points to
-// a *built* bundle directory: a root `index.js` (the hosting build runs `npm ci`
-// then esbuild — no TS transpile), plus `manifest.json`, `package.json` and
-// `package-lock.json`. The CDK validates those exist at define time. Author in TS
-// with `createWorker` from @cargo-ai/worker-sdk and build to `index.js`. On
-// deploy the reconciler uploads the bundle, waits for the build, and promotes it.
-// The live URL is available as `webhook.url`.
+// `defineWorker` is the *resource* — the hosted worker slot. Its `path` points
+// to a worker source directory: a TS entry (`src/index.ts`) authored with
+// `createWorker` from @cargo-ai/worker-sdk, plus `manifest.json`,
+// `package.json` and `package-lock.json`. Like an app, the worker is uploaded
+// as source and built by Cargo Hosting (the build runs `npm ci` then esbuilds
+// the entry — esbuild transpiles TypeScript natively). The CDK validates those
+// files exist at define time. On deploy the reconciler uploads the bundle,
+// waits for the build, and promotes it. The live URL is available as
+// `webhook.url`.
 export const webhook = defineWorker("webhook", {
   path: new URL("./webhook", import.meta.url).pathname,
   description: "Receives inbound lead webhooks.",