@cargo-ai/cdk 0.1.1

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

@@ -0,0 +1,31 @@
+import { type ConnectorRef, type ResourceRef } from "../refs.js";
+/** Options shared by every action an agent or MCP server can call. */
+export type ActionOptions = {
+    /** Override the action's display name. */
+    readonly name?: string;
+    readonly description?: string;
+    /** Allow the action to run in bulk. Defaults to false. */
+    readonly isBulkAllowed?: boolean;
+    /** Block until the action finishes before continuing. Defaults to true. */
+    readonly waitUntilFinished?: boolean;
+};
+/** A tool to call — the tool handle / `toolRef(uuid)`, bare or `{ ref, …options }`. */
+export type ToolUse = ResourceRef<"tool"> | (ActionOptions & {
+    readonly ref: ResourceRef<"tool">;
+});
+/** Another agent to call — the agent handle / `agentRef(uuid)`, bare or wrapped. */
+export type AgentUse = ResourceRef<"agent"> | (ActionOptions & {
+    readonly ref: ResourceRef<"agent">;
+});
+/** A connector action to call (e.g. an enrichment endpoint). */
+export type ConnectorActionSpec = ActionOptions & {
+    integration: string;
+    actionSlug: string;
+    /** The connector (handle or `connectorRef(uuid)`); omit for native actions. */
+    connector?: ConnectorRef;
+    config?: Record<string, unknown>;
+};
+export declare function normalizeTools(uses: readonly ToolUse[] | undefined): unknown[];
+export declare function normalizeSubAgents(uses: readonly AgentUse[] | undefined): unknown[];
+export declare function normalizeConnectorActions(refs: readonly ConnectorActionSpec[] | undefined): unknown[];
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/resources/actions.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,YAAY,EAAW,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1E,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,OAAO,GACf,WAAW,CAAC,MAAM,CAAC,GACnB,CAAC,aAAa,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAE5D,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAChB,WAAW,CAAC,OAAO,CAAC,GACpB,CAAC,aAAa,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAC;AAE7D,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAgCF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GACnC,OAAO,EAAE,CAKX;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,GACpC,OAAO,EAAE,CAKX;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,GAC/C,OAAO,EAAE,CAQX"}

package/build/src/resources/actions.js

@@ -0,0 +1,44 @@
+// Action references shared by `defineAgent` and `defineMcpServer`: both expose
+// the same tools / sub-agents / connector actions, each with the same per-call
+// options. A tool/agent is referenced by handle or `xxRef(uuid)` — bare when it
+// needs no options, or wrapped `{ ref, …options }`. Normalized here (defaults
+// baked in) so the stored spec — and the content hash — is stable.
+import { refUuid } from "../refs.js";
+function normalizeOptions(opts) {
+    return {
+        name: opts.name === undefined ? null : opts.name,
+        description: opts.description === undefined ? null : opts.description,
+        isBulkAllowed: opts.isBulkAllowed === undefined ? false : opts.isBulkAllowed,
+        waitUntilFinished: opts.waitUntilFinished === undefined ? true : opts.waitUntilFinished,
+    };
+}
+// Split a use into its uuid + options, whether it's a bare handle/ref or a
+// `{ ref, …options }` wrapper.
+function splitUse(use) {
+    if ("ref" in use) {
+        const { ref, ...options } = use;
+        return { uuid: refUuid(ref), options };
+    }
+    return { uuid: refUuid(use), options: {} };
+}
+export function normalizeTools(uses) {
+    return (uses === undefined ? [] : uses).map((t) => {
+        const { uuid, options } = splitUse(t);
+        return { uuid, ...normalizeOptions(options) };
+    });
+}
+export function normalizeSubAgents(uses) {
+    return (uses === undefined ? [] : uses).map((s) => {
+        const { uuid, options } = splitUse(s);
+        return { uuid, ...normalizeOptions(options) };
+    });
+}
+export function normalizeConnectorActions(refs) {
+    return (refs === undefined ? [] : refs).map((c) => ({
+        integration: c.integration,
+        actionSlug: c.actionSlug,
+        connectorUuid: c.connector === undefined ? undefined : refUuid(c.connector),
+        config: c.config === undefined ? {} : c.config,
+        ...normalizeOptions(c),
+    }));
+}

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

@@ -0,0 +1,71 @@
+import type { AiTypes } from "@cargo-ai/types";
+import { type Token } from "../core.js";
+import { type ConnectorRef, type FolderRef, type ModelRef } from "../refs.js";
+import { type AgentUse, type ConnectorActionSpec, type ToolUse } from "./actions.js";
+import type { ConnectorHandle } from "./connector.js";
+import type { FolderHandle } from "./folder.js";
+import type { ModelHandle } from "./model.js";
+export type { ActionOptions, AgentUse, ConnectorActionSpec, ToolUse, } from "./actions.js";
+export type CapabilitySpec = AiTypes.Capability["slug"] | AiTypes.Capability;
+export type TriggerSpec = {
+    type: "cron";
+    cron: string;
+    text: string;
+    name?: string;
+} | {
+    type: "connector";
+    integration: string;
+    /** The triggering connector — a handle or `connectorRef(uuid)`. */
+    connector?: ConnectorHandle | ConnectorRef;
+    config?: Record<string, unknown>;
+    name?: string;
+};
+/** Per-model options when an agent/MCP server exposes a data model. */
+export type ModelOptions = {
+    readonly readOnly?: boolean;
+    readonly columns?: string[];
+    readonly prompt?: string;
+};
+/** A data model to expose — the handle / `modelRef(uuid)`, bare or `{ ref, …options }`. */
+export type ModelUse = ModelHandle | ModelRef | (ModelOptions & {
+    readonly ref: ModelHandle | ModelRef;
+});
+export type AgentSpec = {
+    name?: string;
+    description?: string;
+    /** Icon colour. Defaults to "grey". */
+    color?: AiTypes.AgentIcon["color"];
+    /** The LLM connector — a handle (e.g. `openai`) or `connectorRef(uuid)`. */
+    connector?: ConnectorHandle | ConnectorRef;
+    /** Language-model slug, e.g. "gpt-4o". */
+    languageModel?: string;
+    systemPrompt: string;
+    temperature?: number;
+    maxSteps?: number;
+    withReasoning?: boolean;
+    capabilities?: CapabilitySpec[];
+    triggers?: TriggerSpec[];
+    /** Data models the agent can read/write. */
+    models?: ModelUse[];
+    /** Tools the agent can call (become tool actions). */
+    tools?: ToolUse[];
+    /** Connector actions the agent can call. */
+    connectorActions?: ConnectorActionSpec[];
+    /** Sub-agents the agent can call (become agent actions). */
+    subAgents?: AgentUse[];
+    mcpClients?: AiTypes.McpClient[];
+    suggestedActions?: AiTypes.SuggestedAction[];
+    output?: AiTypes.Output;
+    heartbeat?: AiTypes.Heartbeat;
+    evaluator?: AiTypes.Evaluator;
+    folder?: FolderHandle | FolderRef;
+};
+export declare function normalizeModels(uses: readonly ModelUse[] | undefined, defaultReadOnly: boolean): unknown[];
+export type AgentHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    /** Discriminator so an agent handle can be passed to a workflow's `uses`. */
+    readonly resource: "agent";
+};
+export declare function defineAgent(slug: string, spec: AgentSpec): AgentHandle;
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/resources/agent.ts"],"names":[],"mappings":"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"}

package/build/src/resources/agent.js

@@ -0,0 +1,96 @@
+// defineAgent — the typed builder over a Release + Agent. References dependencies
+// by handle (or `xxRef(uuid)`): `connector` is the LLM connector (its integration
+// slug is resolved at deploy), `models` are data models, and `tools` / `subAgents`
+// / `connectorActions` become the agent's release actions. Compiles to a
+// CreateAgentPayload + DeployDraftReleasePayload once tokens resolve.
+import { register, resourceId, token } from "../core.js";
+import { refUuid, } from "../refs.js";
+import { normalizeConnectorActions, normalizeSubAgents, normalizeTools, } from "./actions.js";
+// Normalize the `models` list (shared with `defineMcpServer`) — each entry is a
+// bare handle/ref or `{ ref, …options }`.
+export function normalizeModels(uses, defaultReadOnly) {
+    return (uses === undefined ? [] : uses).map((m) => {
+        const hasOptions = "ref" in m;
+        const ref = hasOptions ? m.ref : m;
+        const opts = hasOptions ? m : {};
+        return {
+            uuid: refUuid(ref),
+            readOnly: opts.readOnly === undefined ? defaultReadOnly : opts.readOnly,
+            columns: opts.columns === undefined ? null : opts.columns,
+            prompt: opts.prompt === undefined ? null : opts.prompt,
+        };
+    });
+}
+// Lower triggers to their wire form — a connector trigger references its
+// connector by handle/ref, which becomes `connectorUuid`.
+function normalizeTriggers(triggers) {
+    return (triggers === undefined ? [] : triggers).map((t) => {
+        if (t.type === "connector") {
+            const { connector, ...rest } = t;
+            return {
+                ...rest,
+                connectorUuid: connector === undefined ? undefined : refUuid(connector),
+            };
+        }
+        return t;
+    });
+}
+function normalizeCapability(capability) {
+    if (typeof capability === "string") {
+        return { slug: capability, config: {} };
+    }
+    return capability;
+}
+export function defineAgent(slug, spec) {
+    const id = resourceId("agent", slug);
+    // The release needs a complete LLM binding (the executor throws otherwise) —
+    // catch a missing/partial one here so it fails in `plan`, not mid-deploy.
+    if (spec.connector === undefined || spec.languageModel === undefined) {
+        throw new Error(`defineAgent("${slug}"): an agent needs both connector (the LLM ` +
+            `provider connector, e.g. \`openai\`) and languageModel (e.g. ` +
+            `"gpt-4o") to deploy. Got connector=${spec.connector === undefined ? "undefined" : "set"}, ` +
+            `languageModel=${spec.languageModel === undefined ? "undefined" : `"${spec.languageModel}"`}.`);
+    }
+    register({
+        id,
+        kind: "agent",
+        slug,
+        spec: {
+            slug,
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            icon: {
+                color: spec.color === undefined ? "grey" : spec.color,
+                face: "robot",
+            },
+            description: spec.description === undefined ? null : spec.description,
+            systemPrompt: spec.systemPrompt,
+            temperature: spec.temperature === undefined ? 0.2 : spec.temperature,
+            maxSteps: spec.maxSteps === undefined ? 8 : spec.maxSteps,
+            withReasoning: spec.withReasoning === undefined ? false : spec.withReasoning,
+            connectorUuid: refUuid(spec.connector),
+            languageModelSlug: spec.languageModel,
+            capabilities: (spec.capabilities === undefined
+                ? []
+                : spec.capabilities).map(normalizeCapability),
+            mcpClients: spec.mcpClients === undefined ? [] : spec.mcpClients,
+            suggestedActions: spec.suggestedActions === undefined ? [] : spec.suggestedActions,
+            output: spec.output === undefined ? { type: "text" } : spec.output,
+            heartbeat: spec.heartbeat === undefined ? null : spec.heartbeat,
+            evaluator: spec.evaluator === undefined ? null : spec.evaluator,
+            triggers: normalizeTriggers(spec.triggers),
+            // resolved → ModelResource[] / Action[] by the apply executor
+            models: normalizeModels(spec.models, true),
+            tools: normalizeTools(spec.tools),
+            subAgents: normalizeSubAgents(spec.subAgents),
+            connectorActions: normalizeConnectorActions(spec.connectorActions),
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), resource: "agent" };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,18 @@
+import { type Token } from "../core.js";
+import { type FolderRef } from "../refs.js";
+import type { FolderHandle } from "./folder.js";
+export type AppSpec = {
+    /** Path to the app's code directory (uploaded + built on deploy). */
+    path: string;
+    name?: string;
+    description?: string;
+    folder?: FolderHandle | FolderRef;
+};
+export type AppHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    /** The live app URL (deferred — known after deploy). */
+    readonly url: Token;
+};
+export declare function defineApp(slug: string, spec: AppSpec): AppHandle;
+//# sourceMappingURL=app.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/resources/app.ts"],"names":[],"mappings":"AAIA,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;AAMhD,MAAM,MAAM,OAAO,GAAG;IACpB,qEAAqE;IACrE,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,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;CACrB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,CAiBhE"}

package/build/src/resources/app.js

@@ -0,0 +1,33 @@
+// defineApp — a hosted Cargo app (the resource), deployed from a code directory
+// (a Vite app). On deploy the reconciler creates the app slot, uploads the
+// bundle, and promotes it (the backend runs the build).
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+import { assertBundleFiles, bundleHash } from "./bundle.js";
+// Files the hosting app build requires at the bundle root: an npm-ci'able project
+// and a Vite entry (`vite build` must emit dist/index.html).
+const APP_REQUIRED = ["index.html", "package.json", "package-lock.json"];
+export function defineApp(slug, spec) {
+    const id = resourceId("app", slug);
+    assertBundleFiles(spec.path, "app", APP_REQUIRED);
+    register({
+        id,
+        kind: "app",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            description: spec.description === undefined ? null : spec.description,
+            path: spec.path,
+            contentHash: bundleHash(spec.path),
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), url: token(id, "url") };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,15 @@
+export type SourceFile = {
+    path: string;
+    content: string;
+};
+/** All uploadable source files under `root`, paths relative to `root`. */
+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.
+ */
+export declare function assertBundleFiles(root: string, label: string, required: 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

@@ -0,0 +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"}

package/build/src/resources/bundle.js

@@ -0,0 +1,61 @@
+// Read a directory of source files for a worker/app deployment, and hash it so a
+// code change shows as drift. The bundle is read at define time (to hash) and
+// re-read by the executor (to upload). Text files only — binary assets in apps
+// are a known v1 limitation (the deployment payload's `content` is a string).
+import { createHash } from "node:crypto";
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { isAbsolute, join, relative, resolve } from "node:path";
+const SKIP = new Set(["node_modules", ".git", "build", "dist", ".turbo"]);
+function walk(base, dir, out) {
+    for (const entry of readdirSync(dir)) {
+        if (SKIP.has(entry))
+            continue;
+        const full = join(dir, entry);
+        if (statSync(full).isDirectory()) {
+            walk(base, full, out);
+        }
+        else {
+            out.push({
+                path: relative(base, full),
+                content: readFileSync(full, "utf8"),
+            });
+        }
+    }
+}
+/** All uploadable source files under `root`, paths relative to `root`. */
+export function readBundle(root) {
+    const base = isAbsolute(root) ? root : resolve(process.cwd(), root);
+    if (!existsSync(base))
+        throw new Error(`code path not found: ${base}`);
+    const out = [];
+    walk(base, base, out);
+    out.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    return out;
+}
+/**
+ * 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.
+ */
+export function assertBundleFiles(root, label, required) {
+    const base = isAbsolute(root) ? root : resolve(process.cwd(), root);
+    if (!existsSync(base)) {
+        throw new Error(`${label} code path not found: ${base}`);
+    }
+    const missing = required.filter((file) => !existsSync(join(base, file)));
+    if (missing.length > 0) {
+        throw new Error(`${label} bundle at "${root}" is missing required file(s): ${missing.join(", ")}. ` +
+            `A ${label} bundle must contain ${required.join(", ")} at its root.`);
+    }
+}
+/** A content hash over the whole bundle — changes when any file changes. */
+export function bundleHash(root) {
+    const hash = createHash("sha256");
+    for (const file of readBundle(root)) {
+        hash.update(file.path);
+        hash.update("\0");
+        hash.update(file.content);
+        hash.update("\0");
+    }
+    return `sha256:${hash.digest("hex").slice(0, 16)}`;
+}

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

@@ -0,0 +1,30 @@
+import { type Token } from "../core.js";
+export type RateLimitSpec = {
+    unit: "day" | "hour" | "minute" | "second";
+    max: number;
+    strategy: "spread" | "burst";
+};
+export interface ConnectorConfigs {
+}
+type ConnectorConfigFor<S extends string> = S extends keyof ConnectorConfigs ? ConnectorConfigs[S] : Record<string, unknown>;
+export type ConnectorSpec<S extends string = string> = {
+    integration: S;
+    name?: string;
+    config?: ConnectorConfigFor<S>;
+    rateLimit?: RateLimitSpec;
+    cacheTtlMilliseconds?: number;
+    adopt?: boolean;
+};
+export type ConnectorHandle<S extends string = string> = {
+    readonly slug: string;
+    readonly integrationSlug: S;
+    readonly uuid: Token;
+    readonly datasetUuid: Token;
+    /** Discriminator so a connector handle can be passed where a connector (or its
+     *  dataset, via `defineModel`) is referenced. Carries the integration slug `S`
+     *  so `defineModel({ dataset })` can type extractor config. */
+    readonly resource: "connector";
+};
+export declare function defineConnector<S extends string>(slug: string, spec: ConnectorSpec<S>): ConnectorHandle<S>;
+export {};
+//# sourceMappingURL=connector.d.ts.map

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

@@ -0,0 +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"}

package/build/src/resources/connector.js

@@ -0,0 +1,41 @@
+// defineConnector
+//
+// `defineConnector` registers a connector and returns a handle. Outputs are
+// deferred tokens — `connector.uuid` and `connector.datasetUuid` (the dataset
+// auto-created alongside it, which data models source from). The integration
+// 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.
+import { register, resourceId, token } from "../core.js";
+export function defineConnector(slug, spec) {
+    const id = resourceId("connector", slug);
+    register({
+        id,
+        kind: "connector",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            integrationSlug: spec.integration,
+            config: spec.config,
+            rateLimit: spec.rateLimit,
+            cacheTtlMilliseconds: spec.cacheTtlMilliseconds,
+            adopt: spec.adopt === undefined ? false : spec.adopt,
+        },
+    });
+    return {
+        slug,
+        integrationSlug: spec.integration,
+        uuid: token(id, "uuid"),
+        datasetUuid: token(id, "datasetUuid"),
+        resource: "connector",
+    };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,15 @@
+import { type Token } from "../core.js";
+export type ContextSpec = {
+    /** A local directory of markdown/MDX files to sync (read recursively). */
+    dir?: string;
+    /** Inline files (repo-relative POSIX path → content). Merged over `dir`. */
+    files?: Record<string, string>;
+};
+export type ContextHandle = {
+    /** Discriminator (there is one context repo per workspace). */
+    readonly resource: "context";
+    /** The context repository's uuid (deferred). */
+    readonly uuid: Token;
+};
+export declare function defineContext(spec: ContextSpec): ContextHandle;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/resources/context.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG;IACxB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB,CAAC;AAKF,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAoB9D"}

package/build/src/resources/context.js

@@ -0,0 +1,58 @@
+// defineContext — the workspace's context repository (a git-backed GTM knowledge
+// base of markdown/MDX files) as code. A workspace has exactly ONE context repo,
+// so this is a singleton resource; its "spec" is a set of repo-relative files.
+//
+// On deploy the executor writes each changed file into the repo via the runtime
+// (committing). It is ADDITIVE — files removed from code are left in place, since
+// the repo may hold files managed elsewhere (the UI, other tooling).
+//
+//   defineContext({
+//     dir: "./context",                       // sync a local folder of .md/.mdx
+//     files: { "generated/icp.md": buildIcp() }, // + inline additions/overrides
+//   });
+import { readdirSync, readFileSync } from "node:fs";
+import { join, relative, sep } from "node:path";
+import { register, resourceId, token } from "../core.js";
+// One context repo per workspace → a fixed singleton slug.
+const CONTEXT_SLUG = "repository";
+export function defineContext(spec) {
+    const id = resourceId("context", CONTEXT_SLUG);
+    const files = {};
+    if (spec.dir !== undefined) {
+        for (const [path, content] of readMarkdownDir(spec.dir)) {
+            files[path] = content;
+        }
+    }
+    if (spec.files !== undefined) {
+        for (const [path, content] of Object.entries(spec.files)) {
+            files[path] = content;
+        }
+    }
+    register({
+        id,
+        kind: "context",
+        slug: CONTEXT_SLUG,
+        spec: { slug: CONTEXT_SLUG, files },
+    });
+    return { resource: "context", uuid: token(id, "uuid") };
+}
+// Recursively read a local directory's `.md` / `.mdx` files, keyed by their
+// repo-relative POSIX path.
+function readMarkdownDir(dir) {
+    const out = [];
+    const walk = (current) => {
+        for (const entry of readdirSync(current, { withFileTypes: true })) {
+            const abs = join(current, entry.name);
+            if (entry.isDirectory()) {
+                walk(abs);
+            }
+            else if (entry.isFile() && /\.mdx?$/i.test(entry.name)) {
+                const rel = relative(dir, abs).split(sep).join("/");
+                out.push([rel, readFileSync(abs, "utf8")]);
+            }
+        }
+    };
+    walk(dir);
+    out.sort(([a], [b]) => a.localeCompare(b));
+    return out;
+}

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

@@ -0,0 +1,15 @@
+import { type Token } from "../core.js";
+import { type FolderRef } from "../refs.js";
+import type { FolderHandle } from "./folder.js";
+export type FileSpec = {
+    /** Path to the file's content (read + uploaded on deploy). */
+    path: string;
+    name?: string;
+    folder?: FolderHandle | FolderRef;
+};
+export type FileHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+};
+export declare function defineFile(slug: string, spec: FileSpec): FileHandle;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/resources/file.ts"],"names":[],"mappings":"AAcA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,QAAQ,GAAG;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CAoBnE"}

package/build/src/resources/file.js

@@ -0,0 +1,35 @@
+// defineFile — a Cargo content file, uploaded from a local path. The file's
+// content is read + hashed at define time; the executor uploads it (multipart)
+// and reconciles the returned uuid by its s3Filename.
+//
+// Identity: a file has no slug (uuid-only, state-tracked). Editing the file's
+// content reconciles on the next deploy: Cargo files are immutable, so the
+// executor uploads a replacement and deletes the old one — the uuid changes, and
+// the state's stored `contentHash` is how a content change is told apart from a
+// name/folder-only change (which is reconciled in place).
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, isAbsolute, resolve } from "node:path";
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+export function defineFile(slug, spec) {
+    const id = resourceId("file", slug);
+    const abs = isAbsolute(spec.path)
+        ? spec.path
+        : resolve(process.cwd(), spec.path);
+    if (!existsSync(abs))
+        throw new Error(`file path not found: ${abs}`);
+    register({
+        id,
+        kind: "file",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? basename(spec.path) : spec.name,
+            path: spec.path,
+            contentHash: `sha256:${createHash("sha256").update(readFileSync(abs)).digest("hex").slice(0, 16)}`,
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+        },
+    });
+    return { slug, uuid: token(id, "uuid") };
+}

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

@@ -0,0 +1,20 @@
+import type { WorkspaceManagementTypes } from "@cargo-ai/types";
+import { type Token } from "../core.js";
+import { type FolderRef } from "../refs.js";
+export type FolderKind = WorkspaceManagementTypes.FolderKind;
+export type FolderHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    readonly kind: FolderKind;
+    readonly resource: "folder";
+};
+export type FolderSpec = {
+    /** Which kind of resource this folder holds (model, agent, play, …). */
+    kind: FolderKind;
+    name?: string;
+    emojiSlug?: string;
+    /** Parent folder, for nesting — a folder handle or a `folderRef(uuid)`. */
+    parent?: FolderHandle | FolderRef;
+};
+export declare function defineFolder(slug: string, spec: FolderSpec): FolderHandle;
+//# sourceMappingURL=folder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../../../src/resources/folder.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,UAAU,GAAG,wBAAwB,CAAC,UAAU,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,wEAAwE;IACxE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,YAAY,CAgBzE"}