@cargo-ai/cdk 0.1.1

package/build/src/resources/folder.js

@@ -0,0 +1,28 @@
+// defineFolder — a Cargo folder for organizing resources. Cargo folders are
+// per-kind (a folder has a `kind` of model/agent/play/tool/worker/app/file/…),
+// so a folder declares its kind and only same-kind resources can live in it.
+// Returns a handle whose `uuid` token feeds other resources' `folder` param.
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+export function defineFolder(slug, spec) {
+    const id = resourceId("folder", slug);
+    register({
+        id,
+        kind: "folder",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            emojiSlug: spec.emojiSlug === undefined ? "open_file_folder" : spec.emojiSlug,
+            folderKind: spec.kind,
+            parentUuid: spec.parent === undefined ? undefined : refUuid(spec.parent),
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), kind: spec.kind, resource: "folder" };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,25 @@
+import { type Token } from "../core.js";
+import { type FolderRef } from "../refs.js";
+import { type AgentUse, type ConnectorActionSpec, type ToolUse } from "./actions.js";
+import { type ModelUse } from "./agent.js";
+import type { FolderHandle } from "./folder.js";
+export type McpServerSpec = {
+    name?: string;
+    description?: string;
+    /** Tools the server exposes (become tool actions). */
+    tools?: ToolUse[];
+    /** Agents the server exposes (become agent actions). */
+    agents?: AgentUse[];
+    /** Connector actions the server exposes. */
+    connectorActions?: ConnectorActionSpec[];
+    /** Data models the server serves. */
+    models?: ModelUse[];
+    folder?: FolderHandle | FolderRef;
+};
+export type McpServerHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    readonly resource: "mcpServer";
+};
+export declare function defineMcpServer(slug: string, spec: McpServerSpec): McpServerHandle;
+//# sourceMappingURL=mcpServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpServer.d.ts","sourceRoot":"","sources":["../../../src/resources/mcpServer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AACrD,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EAIxB,KAAK,OAAO,EACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,qCAAqC;IACrC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC,CAAC;AAEF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,GAClB,eAAe,CAmBjB"}

package/build/src/resources/mcpServer.js

@@ -0,0 +1,34 @@
+// defineMcpServer — a Cargo MCP server: a named bundle of actions (tools,
+// agents, connector actions) and data-model resources, exposed as an MCP
+// endpoint. References everything by uuid token. Compiles to the ai
+// `CreateMcpServerPayload`. Uuid-only identity (no slug) — state-tracked.
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+import { normalizeConnectorActions, normalizeSubAgents, normalizeTools, } from "./actions.js";
+import { normalizeModels } from "./agent.js";
+export function defineMcpServer(slug, spec) {
+    const id = resourceId("mcpServer", slug);
+    register({
+        id,
+        kind: "mcpServer",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            description: spec.description === undefined ? null : spec.description,
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+            // resolved → AiTypes.Action[] / Resource[] by the apply executor
+            tools: normalizeTools(spec.tools),
+            subAgents: normalizeSubAgents(spec.agents),
+            connectorActions: normalizeConnectorActions(spec.connectorActions),
+            models: normalizeModels(spec.models, true),
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), resource: "mcpServer" };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,34 @@
+import { type Token } from "../core.js";
+import { type DatasetRef, type FolderRef } from "../refs.js";
+import type { ConnectorHandle } from "./connector.js";
+import type { FolderHandle } from "./folder.js";
+export type ScheduleSpec = {
+    type: "cron";
+    cron: string;
+} | {
+    type: "dbt";
+    jobId: string;
+};
+export interface ExtractorConfigs {
+}
+type ExtractorConfigFor<S extends string, E extends string> = S extends keyof ExtractorConfigs ? E extends keyof ExtractorConfigs[S] ? ExtractorConfigs[S][E] : Record<string, unknown> : Record<string, unknown>;
+export type ModelSpec<S extends string = string, E extends string = string> = {
+    name?: string;
+    description?: string;
+    /** Source dataset — a connector handle (its dataset) or a `datasetRef(uuid)`. */
+    dataset: ConnectorHandle<S> | DatasetRef;
+    /** An extractor the source's integration exposes, e.g. "fetchRecords". */
+    extractSlug: E;
+    /** Extractor config — validated against the extractor's schema on apply. */
+    config?: ExtractorConfigFor<S, E>;
+    schedule?: ScheduleSpec;
+    folder?: FolderHandle | FolderRef;
+};
+export type ModelHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    readonly resource: "model";
+};
+export declare function defineModel<S extends string, E extends string>(slug: string, spec: ModelSpec<S, E>): ModelHandle;
+export {};
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/resources/model.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAUnC,MAAM,WAAW,gBAAgB;CAAG;AAEpC,KAAK,kBAAkB,CACrB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,IACd,CAAC,SAAS,MAAM,gBAAgB,GAChC,CAAC,SAAS,MAAM,gBAAgB,CAAC,CAAC,CAAC,GACjC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;IACzC,0EAA0E;IAC1E,WAAW,EAAE,CAAC,CAAC;IACf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AAQF,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC5D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GACpB,WAAW,CAkBb"}

package/build/src/resources/model.js

@@ -0,0 +1,43 @@
+// defineModel — a data model (a `StorageTypes.Model`: a table sourced from a
+// dataset by an extractor). Returns a handle whose `uuid` is a deferred token.
+// It sources from a connector's dataset and lives in an optional folder:
+//
+//   const hubspot = defineConnector("hubspot", { integration: "hubspot" });
+//   const contacts = defineModel("contacts", {
+//     dataset: hubspot,
+//     extractSlug: "fetchRecords",
+//   });
+//
+// Compiles to the storage `CreateModelPayload` once tokens are resolved.
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+// A connector handle references its auto-created dataset (`.datasetUuid`); a
+// `datasetRef` references the dataset directly (`.uuid`).
+function datasetUuidOf(dataset) {
+    return dataset.resource === "connector" ? dataset.datasetUuid : dataset.uuid;
+}
+export function defineModel(slug, spec) {
+    const id = resourceId("model", slug);
+    register({
+        id,
+        kind: "model",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            description: spec.description === undefined ? null : spec.description,
+            datasetUuid: datasetUuidOf(spec.dataset),
+            extractorSlug: spec.extractSlug,
+            config: spec.config === undefined ? {} : spec.config,
+            schedule: spec.schedule,
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), resource: "model" };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,35 @@
+import type { OrchestrationTypes, SegmentationTypes } from "@cargo-ai/types";
+import { type Token } from "../core.js";
+import { type FolderRef, type ModelRef, type PlayRef } from "../refs.js";
+import type { FolderHandle } from "./folder.js";
+import type { ModelHandle } from "./model.js";
+import type { WorkflowDefinition } from "./tool.js";
+export type PlayScheduleSpec = Omit<OrchestrationTypes.PlayScheduleCron, "temporalScheduleWorkflowId"> | OrchestrationTypes.PlayScheduleDbt | OrchestrationTypes.PlayScheduleRealtime | (Omit<OrchestrationTypes.PlayScheduleDependency, "playUuid"> & {
+    /** The upstream play — a play handle or a `playRef(uuid)`. */
+    play: PlayHandle | PlayRef;
+}) | Omit<OrchestrationTypes.PlayScheduleWatch, "temporalScheduleWorkflowId" | "meta">;
+export type PlaySpec = {
+    name?: string;
+    description?: string;
+    /** The data model this play runs over — a model handle or `modelRef(uuid)`. */
+    model: ModelHandle | ModelRef;
+    /** Optional per-row automation — a `defineWorkflow(...)` result. */
+    workflow?: WorkflowDefinition;
+    /** Which row changes trigger a run. Defaults to `["added"]`. */
+    changeKinds?: SegmentationTypes.ChangeKind[];
+    /** How runs are created on change. Defaults to `"always"`. */
+    runCreationRule?: OrchestrationTypes.PlayRunCreationRule;
+    filter?: SegmentationTypes.Filter;
+    sort?: SegmentationTypes.Sort;
+    limit?: number;
+    trackingColumnSlugs?: string[];
+    schedule?: PlayScheduleSpec;
+    folder?: FolderHandle | FolderRef;
+};
+export type PlayHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    readonly resource: "play";
+};
+export declare function definePlay(slug: string, spec: PlaySpec): PlayHandle;
+//# sourceMappingURL=play.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"play.d.ts","sourceRoot":"","sources":["../../../src/resources/play.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EACL,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,OAAO,EAEb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAYpD,MAAM,MAAM,gBAAgB,GACxB,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,GACvE,kBAAkB,CAAC,eAAe,GAClC,kBAAkB,CAAC,oBAAoB,GACvC,CAAC,IAAI,CAAC,kBAAkB,CAAC,sBAAsB,EAAE,UAAU,CAAC,GAAG;IAC7D,8DAA8D;IAC9D,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;CAC5B,CAAC,GACF,IAAI,CACF,kBAAkB,CAAC,iBAAiB,EACpC,4BAA4B,GAAG,MAAM,CACtC,CAAC;AAEN,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,gEAAgE;IAChE,WAAW,CAAC,EAAE,iBAAiB,CAAC,UAAU,EAAE,CAAC;IAC7C,8DAA8D;IAC9D,eAAe,CAAC,EAAE,kBAAkB,CAAC,mBAAmB,CAAC;IACzD,MAAM,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC;IAClC,IAAI,CAAC,EAAE,iBAAiB,CAAC,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,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;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAcF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CA4BnE"}

package/build/src/resources/play.js

@@ -0,0 +1,49 @@
+// definePlay — an automation over a data model that emits runs as the model's
+// rows change. References its `model` (and optional `folder`) by handle, and may
+// carry a backing workflow (a `defineWorkflow(...)` result) deployed as its
+// release. Compiles to the orchestration `CreatePlayPayload`.
+import { register, resourceId, token } from "../core.js";
+import { refUuid, } from "../refs.js";
+// Lower a schedule to its wire form — the `dependency` variant references an
+// upstream play by handle/ref, which becomes `playUuid`.
+function toWireSchedule(schedule) {
+    if (schedule === undefined)
+        return undefined;
+    if (schedule.type === "dependency") {
+        return { type: "dependency", playUuid: refUuid(schedule.play) };
+    }
+    return schedule;
+}
+export function definePlay(slug, spec) {
+    const id = resourceId("play", slug);
+    const workflow = spec.workflow;
+    register({
+        id,
+        kind: "play",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            description: spec.description === undefined ? null : spec.description,
+            modelUuid: refUuid(spec.model),
+            changeKinds: spec.changeKinds === undefined ? ["added"] : spec.changeKinds,
+            runCreationRule: spec.runCreationRule === undefined ? "always" : spec.runCreationRule,
+            filter: spec.filter,
+            sort: spec.sort,
+            limit: spec.limit,
+            trackingColumnSlugs: spec.trackingColumnSlugs,
+            schedule: toWireSchedule(spec.schedule),
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+            // the play's backing workflow graph (deployed as its release)
+            nodes: workflow === undefined ? undefined : workflow.nodes,
+            formFields: workflow === undefined ? undefined : workflow.formFields,
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), resource: "play" };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

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

@@ -0,0 +1,40 @@
+import type { OrchestrationTypes } from "@cargo-ai/types";
+import { type Token } from "../core.js";
+import { type FolderRef } from "../refs.js";
+import type { FolderHandle } from "./folder.js";
+/** A cron trigger for the tool (the only trigger kind tools support). */
+export type ToolTriggerSpec = {
+    cron: string;
+    name?: string;
+    description?: string;
+    data?: Record<string, unknown>;
+};
+export type WorkflowDefinition<I = unknown, O = unknown> = {
+    readonly nodes: unknown[];
+    readonly formFields: unknown[];
+    readonly __input?: I;
+    readonly __output?: O;
+};
+export type ToolSpec<I = unknown, O = unknown> = {
+    /** The workflow that backs this tool — a `defineWorkflow(...)` result. */
+    workflow: WorkflowDefinition<I, O>;
+    name?: string;
+    description?: string;
+    /** Emoji slug for the tool's icon (e.g. "wrench", "mag"). */
+    emojiSlug?: string;
+    folder?: FolderHandle | FolderRef;
+    /** Cron triggers (applied via tool update — create doesn't take them). */
+    triggers?: ToolTriggerSpec[];
+    /** Public form config (applied via tool update). */
+    publicForm?: OrchestrationTypes.ToolPublicForm;
+};
+export type ToolHandle<I = unknown, O = unknown> = {
+    readonly slug: string;
+    readonly uuid: Token;
+    /** Discriminator so a tool handle can be passed to a workflow's `uses`. */
+    readonly resource: "tool";
+    readonly __input?: I;
+    readonly __output?: O;
+};
+export declare function defineTool<I = unknown, O = unknown>(slug: string, spec: ToolSpec<I, O>): ToolHandle<I, O>;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/resources/tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,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,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAKF,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAC/C,0EAA0E;IAC1E,QAAQ,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,oDAAoD;IACpD,UAAU,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC;CAChD,CAAC;AAIF,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;CACvB,CAAC;AAEF,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACjD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAuBlB"}

package/build/src/resources/tool.js

@@ -0,0 +1,36 @@
+// defineTool — an AI tool, backed by a workflow. A tool's logic IS a workflow:
+// `defineTool({ workflow: defineWorkflow(...) })`. On deploy the reconciler
+// creates the tool (which creates its backing workflow) and then deploys the
+// workflow release to the returned workflowUuid.
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+export function defineTool(slug, spec) {
+    const id = resourceId("tool", slug);
+    register({
+        id,
+        kind: "tool",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            description: spec.description === undefined ? null : spec.description,
+            icon: {
+                kind: "emoji",
+                emojiSlug: spec.emojiSlug === undefined ? "wrench" : spec.emojiSlug,
+            },
+            // the backing workflow's compiled graph — deployed as the tool's release
+            nodes: spec.workflow.nodes,
+            formFields: spec.workflow.formFields,
+            folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+            triggers: spec.triggers === undefined ? [] : spec.triggers,
+            publicForm: spec.publicForm === undefined ? null : spec.publicForm,
+        },
+    });
+    return { slug, uuid: token(id, "uuid"), resource: "tool" };
+}
+function toTitle(slug) {
+    return slug
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}

package/build/src/resources/worker.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 WorkerSpec = {
+    /** Path to the worker's code directory (uploaded + built on deploy). */
+    path: string;
+    name?: string;
+    description?: string;
+    folder?: FolderHandle | FolderRef;
+};
+export type WorkerHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+    /** The live worker URL (deferred — known after deploy). */
+    readonly url: Token;
+};
+export declare function defineWorker(slug: string, spec: WorkerSpec): WorkerHandle;
+//# sourceMappingURL=worker.d.ts.map

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

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

package/build/src/resources/worker.js

@@ -0,0 +1,40 @@
+// defineWorker — a hosted Cargo worker (the resource), deployed from a code
+// directory. Distinct from @cargo-ai/worker-sdk's `createWorker`, which is the
+// worker's *runtime code* (the Hono app at <path>/src/index.ts). On deploy the
+// reconciler creates the worker slot, uploads the bundle, and promotes it.
+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 = [
+    "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);
+    register({
+        id,
+        kind: "worker",
+        slug,
+        spec: {
+            slug,
+            name: spec.name === undefined ? toTitle(slug) : spec.name,
+            description: spec.description === undefined ? null : spec.description,
+            path: spec.path,
+            // hash the code now so editing it shows as drift on the next deploy
+            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(" ");
+}