@cargo-ai/cdk 1.0.5 → 1.0.6

package/build/src/index.d.ts

@@ -1,4 +1,4 @@
-export type { ActionOptions, AgentHandle, AgentSpec, AgentUse, ConnectorActionSpec, ModelOptions, ModelUse, ToolUse, } from "./resources/agent.js";
+export type { ActionOptions, AgentHandle, AgentSpec, AgentUse, ConnectorActionOptions, ModelOptions, } from "./resources/agent.js";
 export { defineAgent } from "./resources/agent.js";
 export type { AppHandle, AppSpec } from "./resources/app.js";
 export { defineApp } from "./resources/app.js";
@@ -8,16 +8,20 @@ export type { ConnectorConfigs, ConnectorHandle, ConnectorSpec, } from "./resour
 export { defineConnector } from "./resources/connector.js";
 export type { ContextHandle, ContextSpec } from "./resources/context.js";
 export { defineContext } from "./resources/context.js";
+export type { CustomIntegrationHandle, CustomIntegrationSpec, } from "./resources/customIntegration.js";
+export { defineCustomIntegration } from "./resources/customIntegration.js";
 export type { FileHandle, FileSpec } from "./resources/file.js";
 export { defineFile } from "./resources/file.js";
 export type { FolderHandle, FolderKind, FolderSpec, } from "./resources/folder.js";
 export { defineFolder } from "./resources/folder.js";
 export type { McpServerHandle, McpServerSpec } from "./resources/mcpServer.js";
 export { defineMcpServer } from "./resources/mcpServer.js";
-export type { ExtractorConfigs, ModelHandle, ModelSpec, } from "./resources/model.js";
+export type { ExtractorConfigs, ModelHandle, ModelSpec, UnificationColumnSpec, UnificationParentSpec, UnificationSpec, } from "./resources/model.js";
 export { defineModel } from "./resources/model.js";
 export type { PlayHandle, PlaySpec } from "./resources/play.js";
 export { definePlay } from "./resources/play.js";
+export type { RelationshipEndpointSpec, RelationshipHandle, RelationshipRelation, RelationshipSpec, } from "./resources/relationship.js";
+export { defineRelationship } from "./resources/relationship.js";
 export type { SegmentHandle, SegmentSpec } from "./resources/segment.js";
 export { defineSegment } from "./resources/segment.js";
 export type { TerritoryColor, TerritoryHandle, TerritoryMemberSpec, TerritorySpec, } from "./resources/territory.js";
@@ -27,10 +31,10 @@ export { defineTool } from "./resources/tool.js";
 export type { WorkerHandle, WorkerSpec } from "./resources/worker.js";
 export { defineWorker } from "./resources/worker.js";
 export { createWorker, OpenAPIRoute } from "@cargo-ai/worker-sdk";
-export { agentRef, defineWorkflow, toolRef, type WorkflowResourceRef, } from "@cargo-ai/workflow-sdk";
+export { agentRef, defineWorkflow, defineWorkflowFromNodes, toolRef, type WorkflowFromNodes, type WorkflowResourceRef, } from "@cargo-ai/workflow-sdk";
 export type { EncryptionRef, ResourceKind, ResourceNode, SecretRef, Token, } from "./core.js";
 export { env, isSecret, isToken, resolveSecrets, secret, token, } from "./core.js";
-export type { AgentRef, ConnectorRef, DatasetRef, FolderRef, MemberRef, ModelRef, PlayRef, ResourceRef, SegmentRef, ToolRef, } from "./refs.js";
-export { connectorRef, datasetRef, folderRef, memberRef, modelRef, playRef, refUuid, segmentRef, } from "./refs.js";
+export type { AgentRef, ConnectorActionRef, ConnectorRef, DatasetRef, FolderRef, MemberRef, ModelRef, PlayRef, ResourceRef, SegmentRef, ToolRef, } from "./refs.js";
+export { connectorActionRef, connectorRef, datasetRef, folderRef, memberRef, modelRef, playRef, refUuid, segmentRef, } from "./refs.js";
 export * from "./deploy/index.js";
 //# sourceMappingURL=index.d.ts.map

package/build/src/index.d.ts.map

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

package/build/src/index.js

@@ -11,11 +11,13 @@ export { defineApp } from "./resources/app.js";
 export { defineCapacity } from "./resources/capacity.js";
 export { defineConnector } from "./resources/connector.js";
 export { defineContext } from "./resources/context.js";
+export { defineCustomIntegration } from "./resources/customIntegration.js";
 export { defineFile } from "./resources/file.js";
 export { defineFolder } from "./resources/folder.js";
 export { defineMcpServer } from "./resources/mcpServer.js";
 export { defineModel } from "./resources/model.js";
 export { definePlay } from "./resources/play.js";
+export { defineRelationship } from "./resources/relationship.js";
 export { defineSegment } from "./resources/segment.js";
 export { defineTerritory } from "./resources/territory.js";
 export { defineTool } from "./resources/tool.js";
@@ -26,8 +28,8 @@ export { createWorker, OpenAPIRoute } from "@cargo-ai/worker-sdk";
 // `agentRef` (+ their `WorkflowResourceRef` type) to reference a tool or agent by
 // literal uuid inside a body's `uses` map. The lower-level wire-format/codegen
 // types stay in `@cargo-ai/workflow-sdk`.
-export { agentRef, defineWorkflow, toolRef, } from "@cargo-ai/workflow-sdk";
+export { agentRef, defineWorkflow, defineWorkflowFromNodes, toolRef, } from "@cargo-ai/workflow-sdk";
 export { env, isSecret, isToken, resolveSecrets, secret, token, } from "./core.js";
-export { connectorRef, datasetRef, folderRef, memberRef, modelRef, playRef, refUuid, segmentRef, } from "./refs.js";
+export { connectorActionRef, connectorRef, datasetRef, folderRef, memberRef, modelRef, playRef, refUuid, segmentRef, } from "./refs.js";
 // ── deployment: plan + apply ─────────────────────────────────────────────────
 export * from "./deploy/index.js";

package/build/src/refs.d.ts

@@ -27,6 +27,28 @@ export declare const playRef: (uuid: string) => PlayRef;
 export declare const memberRef: (uuid: string) => MemberRef;
 /** Reference a segment by uuid. */
 export declare const segmentRef: (uuid: string) => SegmentRef;
+/**
+ * A reference to one action of a connector (e.g. an enrichment endpoint), for an
+ * agent's / MCP server's `uses`. Produced by accessing the action off a connector
+ * handle — `hunter.actions.emailFinder` — or with `connectorActionRef(connector, slug)`.
+ * Unlike a `ResourceRef`, it carries the integration + action slug alongside the
+ * connector's uuid (the action itself isn't a `define*` resource).
+ */
+export type ConnectorActionRef = {
+    readonly resource: "connectorAction";
+    readonly connectorUuid: Token | string;
+    readonly integration: string;
+    readonly actionSlug: string;
+};
+/**
+ * Reference a connector action by an explicit connector + action slug — the
+ * escape hatch when you don't have a typed connector handle (`connector.actions.<slug>`
+ * is the typed way).
+ */
+export declare const connectorActionRef: (connector: {
+    uuid: Token | string;
+    integrationSlug?: string;
+}, actionSlug: string, integration?: string) => ConnectorActionRef;
 /** Extract the uuid from a handle or ref (both carry `uuid`). */
 export declare const refUuid: (ref: {
     uuid: Token | string;

package/build/src/refs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/refs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAEhD,uEAAuE;AACvE,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,YAG1C,CAAC;AACH,+EAA+E;AAC/E,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,UAGxC,CAAC;AACH,sCAAsC;AACtC,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,QAGtC,CAAC;AACH,kCAAkC;AAClC,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,SAGvC,CAAC;AACH,+EAA+E;AAC/E,eAAO,MAAM,OAAO,SAAU,MAAM,KAAG,OAAuC,CAAC;AAC/E,gFAAgF;AAChF,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,SAGvC,CAAC;AACH,mCAAmC;AACnC,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,UAGxC,CAAC;AAKH,iEAAiE;AACjE,eAAO,MAAM,OAAO,QAAS;IAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,KAAG,KAAK,GAAG,MACtD,CAAC"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/refs.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI;IACrE,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AACpD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAChD,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAC5C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAEhD,uEAAuE;AACvE,eAAO,MAAM,YAAY,SAAU,MAAM,KAAG,YAG1C,CAAC;AACH,+EAA+E;AAC/E,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,UAGxC,CAAC;AACH,sCAAsC;AACtC,eAAO,MAAM,QAAQ,SAAU,MAAM,KAAG,QAGtC,CAAC;AACH,kCAAkC;AAClC,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,SAGvC,CAAC;AACH,+EAA+E;AAC/E,eAAO,MAAM,OAAO,SAAU,MAAM,KAAG,OAAuC,CAAC;AAC/E,gFAAgF;AAChF,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,SAGvC,CAAC;AACH,mCAAmC;AACnC,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,UAGxC,CAAC;AAKH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,KAAK,GAAG,MAAM,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,cAClB;IAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,cACjD,MAAM,gBACJ,MAAM,KACnB,kBAKD,CAAC;AAEH,iEAAiE;AACjE,eAAO,MAAM,OAAO,QAAS;IAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,KAAG,KAAK,GAAG,MACtD,CAAC"}

package/build/src/refs.js

@@ -38,7 +38,16 @@ export const segmentRef = (uuid) => ({
     uuid,
     resource: "segment",
 });
-// `toolRef` / `agentRef` are re-exported from `@cargo-ai/workflow-sdk` — their
-// `WorkflowResourceRef` is structurally a `ResourceRef<"tool" | "agent">`.
+/**
+ * Reference a connector action by an explicit connector + action slug — the
+ * escape hatch when you don't have a typed connector handle (`connector.actions.<slug>`
+ * is the typed way).
+ */
+export const connectorActionRef = (connector, actionSlug, integration) => ({
+    resource: "connectorAction",
+    connectorUuid: connector.uuid,
+    integration: integration ?? connector.integrationSlug ?? "",
+    actionSlug,
+});
 /** Extract the uuid from a handle or ref (both carry `uuid`). */
 export const refUuid = (ref) => ref.uuid;

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

@@ -1,5 +1,6 @@
-import { type ConnectorRef, type ResourceRef } from "../refs.js";
-/** Options shared by every action an agent or MCP server can call. */
+import { type ConnectorActionRef, type ResourceRef } from "../refs.js";
+import type { ModelHandle } from "./model.js";
+/** Options shared by every action a use exposes (tool / agent / connector action). */
 export type ActionOptions = {
     /** Override the action's display name. */
     readonly name?: string;
@@ -9,23 +10,42 @@ export type ActionOptions = {
     /** 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">;
+/** Extra option only a connector action takes, on top of `ActionOptions`. */
+export type ConnectorActionOptions = ActionOptions & {
+    /** Lock input fields to fixed values; the agent decides the rest. */
+    readonly config?: Record<string, unknown>;
+};
+/** Per-model options when a use exposes a data model. */
+export type ModelOptions = {
+    readonly readOnly?: boolean;
+    readonly columns?: string[];
+    readonly prompt?: string;
+};
+/** The data-model references (become the agent's release resources). */
+type ModelUseRef = ModelHandle | ResourceRef<"model">;
+/**
+ * One entry in an agent's / MCP server's `uses` — referenced by handle, bare or
+ * `{ ref, …options }`:
+ *   - a `defineTool` / `defineAgent` handle (or `toolRef` / `agentRef`) — options
+ *     `name` / `description` / `isBulkAllowed` / `waitUntilFinished`;
+ *   - a connector action — `connector.<actionSlug>` (or `connectorActionRef(...)`)
+ *     — same action options plus `config` to fix input fields;
+ *   - a `defineModel` handle (or `modelRef`) — options `readOnly` / `columns` / `prompt`.
+ * The kind is read from each ref's `resource`, so order doesn't matter.
+ */
+export type AgentUse = ResourceRef<"tool"> | ResourceRef<"agent"> | ConnectorActionRef | ModelUseRef | (ActionOptions & {
+    readonly ref: ResourceRef<"tool"> | ResourceRef<"agent">;
+}) | (ConnectorActionOptions & {
+    readonly ref: ConnectorActionRef;
+}) | (ModelOptions & {
+    readonly ref: ModelUseRef;
 });
-/** 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 type NormalizedUses = {
+    models: unknown[];
+    tools: unknown[];
+    subAgents: unknown[];
+    connectorActions: 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[];
+export declare function normalizeUses(uses: readonly AgentUse[] | undefined): NormalizedUses;
+export {};
 //# sourceMappingURL=actions.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/resources/actions.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,kBAAkB,EAAW,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,sFAAsF;AACtF,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,6EAA6E;AAC7E,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG;IACnD,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wEAAwE;AACxE,KAAK,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAChB,WAAW,CAAC,MAAM,CAAC,GACnB,WAAW,CAAC,OAAO,CAAC,GACpB,kBAAkB,GAClB,WAAW,GACX,CAAC,aAAa,GAAG;IACf,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;CAC1D,CAAC,GACF,CAAC,sBAAsB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;CAAE,CAAC,GAC/D,CAAC,YAAY,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAoBnD,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,gBAAgB,EAAE,OAAO,EAAE,CAAC;CAC7B,CAAC;AAIF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,GACpC,cAAc,CAgEhB"}

package/build/src/resources/actions.js

@@ -1,8 +1,9 @@
-// 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.
+// The unified `uses` surface shared by `defineAgent` and `defineMcpServer`: one
+// array of references — tools, agents, data models, and connector actions — each
+// a bare handle/ref or `{ ref, …options }`. `normalizeUses` splits it into the
+// four release buckets the executor reads (models / tools / subAgents /
+// connectorActions), so the stored spec — and the content hash — is identical
+// regardless of the order entries were written in.
 import { refUuid } from "../refs.js";
 function normalizeOptions(opts) {
     return {
@@ -12,33 +13,59 @@ function normalizeOptions(opts) {
         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 };
+// Split the `uses` array into the four release buckets, keyed off each ref's
+// `resource` discriminator.
+export function normalizeUses(uses) {
+    const models = [];
+    const tools = [];
+    const subAgents = [];
+    const connectorActions = [];
+    for (const use of uses ?? []) {
+        const wrapped = "ref" in use;
+        const ref = wrapped ? use.ref : use;
+        const opts = wrapped ? use : {};
+        switch (ref.resource) {
+            case "model":
+                models.push({
+                    uuid: refUuid(ref),
+                    readOnly: opts.readOnly === undefined
+                        ? true
+                        : opts.readOnly,
+                    columns: opts.columns === undefined
+                        ? null
+                        : opts.columns,
+                    prompt: opts.prompt === undefined
+                        ? null
+                        : opts.prompt,
+                });
+                break;
+            case "tool":
+                tools.push({
+                    uuid: refUuid(ref),
+                    ...normalizeOptions(opts),
+                });
+                break;
+            case "agent":
+                subAgents.push({
+                    uuid: refUuid(ref),
+                    ...normalizeOptions(opts),
+                });
+                break;
+            case "connectorAction":
+                connectorActions.push({
+                    integration: ref.integration,
+                    actionSlug: ref.actionSlug,
+                    connectorUuid: ref.connectorUuid,
+                    config: opts.config === undefined
+                        ? {}
+                        : opts.config,
+                    ...normalizeOptions(opts),
+                });
+                break;
+            default:
+                throw new Error(`uses: unsupported entry with resource "${String(ref.resource)}" — expected a tool, agent, data model, or connector action ` +
+                    `(a connector action is \`connector.<actionSlug>\`).`);
+        }
     }
-    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),
-    }));
+    return { models, tools, subAgents, connectorActions };
 }

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

@@ -1,11 +1,10 @@
 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 ConnectorRef, type FolderRef } from "../refs.js";
+import { type AgentUse } 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 { ActionOptions, AgentUse, ConnectorActionOptions, ModelOptions, } from "./actions.js";
 export type CapabilitySpec = AiTypes.Capability["slug"] | AiTypes.Capability;
 export type TriggerSpec = {
     type: "cron";
@@ -20,16 +19,6 @@ export type TriggerSpec = {
     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;
@@ -45,14 +34,13 @@ export type AgentSpec = {
     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[];
+    /**
+     * Everything the agent can call or read, in one array — tools, sub-agents,
+     * connector actions, and data models. Each entry is a handle (bare or
+     * `{ ref, …options }`): a `defineTool` / `defineAgent` / `defineModel` handle,
+     * or a connector action `connector.<actionSlug>`. See `AgentUse`.
+     */
+    uses?: AgentUse[];
     mcpClients?: AiTypes.McpClient[];
     suggestedActions?: AiTypes.SuggestedAction[];
     output?: AiTypes.Output;
@@ -60,7 +48,6 @@ export type AgentSpec = {
     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;

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/resources/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/resources/agent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAW,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,KAAK,QAAQ,EAAiB,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,YAAY,EACV,aAAa,EACb,QAAQ,EACR,sBAAsB,EACtB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;AAE7E,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC;IAC3C,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACnC,CAAC;AAmBF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AASF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,WAAW,CAiDtE"}

package/build/src/resources/agent.js

@@ -1,26 +1,11 @@
 // 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.
+// slug is resolved at deploy); everything the agent can call or read — tools,
+// sub-agents, connector actions, and data models — is one `uses` array. 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,
-        };
-    });
-}
+import { refUuid } from "../refs.js";
+import { normalizeUses } from "./actions.js";
 // Lower triggers to their wire form — a connector trigger references its
 // connector by handle/ref, which becomes `connectorUuid`.
 function normalizeTriggers(triggers) {
@@ -79,11 +64,9 @@ export function defineAgent(slug, spec) {
             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),
+            // `uses` splits into the four buckets the executor resolves →
+            // ModelResource[] / Action[]. Spread keeps the stored spec shape stable.
+            ...normalizeUses(spec.uses),
         },
     });
     return { slug, uuid: token(id, "uuid"), resource: "agent" };

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

@@ -1,4 +1,4 @@
-import { type Token } from "../core.js";
+import { type SecretRef, type Token } from "../core.js";
 import { type FolderRef } from "../refs.js";
 import type { FolderHandle } from "./folder.js";
 export type AppSpec = {
@@ -7,6 +7,8 @@ export type AppSpec = {
     name?: string;
     description?: string;
     folder?: FolderHandle | FolderRef;
+    /** Env vars baked into the build (`VITE_`-prefixed). Use `secret("NAME")` for secret values. */
+    env?: Record<string, string | SecretRef>;
 };
 export type AppHandle = {
     readonly slug: string;

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

@@ -1 +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"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/resources/app.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,KAAK,EAEX,MAAM,YAAY,CAAC;AACpB,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;IAClC,gGAAgG;IAChG,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,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,CAkBhE"}

package/build/src/resources/app.js

@@ -1,7 +1,7 @@
 // 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 { 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
@@ -21,6 +21,7 @@ export function defineApp(slug, spec) {
             path: spec.path,
             contentHash: bundleHash(spec.path),
             folderUuid: spec.folder === undefined ? undefined : refUuid(spec.folder),
+            env: spec.env === undefined ? {} : spec.env,
         },
     });
     return { slug, uuid: token(id, "uuid"), url: token(id, "url") };

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

@@ -1,4 +1,6 @@
+import type { Integrations } from "@cargo-ai/workflow-sdk";
 import { type Token } from "../core.js";
+import type { ConnectorActionRef } from "../refs.js";
 export type RateLimitSpec = {
     unit: "day" | "hour" | "minute" | "second";
     max: number;
@@ -15,6 +17,11 @@ export type ConnectorSpec<S extends string = string> = {
     cacheTtlMilliseconds?: number;
     adopt?: boolean;
 };
+type ConnectorActions<S extends string> = S extends keyof Integrations ? {
+    readonly [A in keyof Integrations[S] & string]: ConnectorActionRef;
+} : {
+    readonly [actionSlug: string]: ConnectorActionRef;
+};
 export type ConnectorHandle<S extends string = string> = {
     readonly slug: string;
     readonly integrationSlug: S;
@@ -24,6 +31,9 @@ export type ConnectorHandle<S extends string = string> = {
      *  dataset, via `defineModel`) is referenced. Carries the integration slug `S`
      *  so `defineModel({ dataset })` can type extractor config. */
     readonly resource: "connector";
+    /** This connector's actions — `connector.actions.<actionSlug>` — for an
+     *  agent's / MCP server's `uses`. */
+    readonly actions: ConnectorActions<S>;
 };
 export declare function defineConnector<S extends string>(slug: string, spec: ConnectorSpec<S>): ConnectorHandle<S>;
 export {};

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/resources/connector.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,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;AAOF,KAAK,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,MAAM,YAAY,GAClE;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,kBAAkB;CAAE,GACtE;IAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAE1D,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;IAC/B;yCACqC;IACrC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GACrB,eAAe,CAAC,CAAC,CAAC,CAuCpB"}

package/build/src/resources/connector.js

@@ -26,12 +26,29 @@ export function defineConnector(slug, spec) {
             adopt: spec.adopt === undefined ? false : spec.adopt,
         },
     });
+    const uuid = token(id, "uuid");
+    // A small Proxy: `connector.actions.<slug>` → a `ConnectorActionRef` pinned to
+    // this connector. The handle itself stays a plain object; only this dedicated
+    // `actions` namespace is proxied (symbols and `then` pass through as undefined).
+    const actions = new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop !== "string" || prop === "then")
+                return undefined;
+            return {
+                resource: "connectorAction",
+                connectorUuid: uuid,
+                integration: spec.integration,
+                actionSlug: prop,
+            };
+        },
+    });
     return {
         slug,
         integrationSlug: spec.integration,
-        uuid: token(id, "uuid"),
+        uuid,
         datasetUuid: token(id, "datasetUuid"),
         resource: "connector",
+        actions,
     };
 }
 function toTitle(slug) {

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

@@ -0,0 +1,12 @@
+import { type Token } from "../core.js";
+import type { WorkerHandle } from "./worker.js";
+export type CustomIntegrationSpec = {
+    /** The worker serving the Custom Integration HTTP contract. */
+    worker: WorkerHandle;
+};
+export type CustomIntegrationHandle = {
+    readonly slug: string;
+    readonly uuid: Token;
+};
+export declare function defineCustomIntegration(slug: string, spec: CustomIntegrationSpec): CustomIntegrationHandle;
+//# sourceMappingURL=customIntegration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customIntegration.d.ts","sourceRoot":"","sources":["../../../src/resources/customIntegration.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,KAAK,EAAS,MAAM,YAAY,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAAG;IAClC,+DAA+D;IAC/D,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,uBAAuB,CAWzB"}

package/build/src/resources/customIntegration.js

@@ -0,0 +1,18 @@
+// defineCustomIntegration — registers a worker-backed custom integration in
+// the workspace's connector catalog. The worker serves the Custom Integration
+// HTTP contract (`createCustomIntegration` from @cargo-ai/worker-sdk); Cargo
+// reads its `GET /manifest` once the worker is deployed and promoted.
+import { register, resourceId, token } from "../core.js";
+import { refUuid } from "../refs.js";
+export function defineCustomIntegration(slug, spec) {
+    const id = resourceId("customIntegration", slug);
+    register({
+        id,
+        kind: "customIntegration",
+        slug,
+        spec: {
+            workerUuid: refUuid(spec.worker),
+        },
+    });
+    return { slug, uuid: token(id, "uuid") };
+}