@auxx/sdk 0.0.15 → 0.0.17

package/lib/build/server/find-tool-server-modules.js

@@ -277,3 +277,52 @@ export async function findToolModules(srcDirAbsolute) {
         modules: new Map(),
     });
 }
+export function findDataConnectorModulesFromSource(source, currPath, helpers) {
+    const result = new Map();
+    try {
+        const ast = parse(source, { range: true, jsx: true });
+        const scopeManager = analyze(ast, { sourceType: 'module' });
+        const moduleScope = scopeManager.acquire(ast, true);
+        if (moduleScope === null) {
+            throw new Error('Expected to be able to acquire module scope');
+        }
+        ;
+        walk(ast, null, {
+            ExportNamedDeclaration(node) {
+                if (!node.declaration || node.declaration.type !== 'VariableDeclaration')
+                    return;
+                if (node.declaration.declarations.length !== 1)
+                    return;
+                const declaration = node.declaration.declarations[0];
+                if (declaration.id.type !== 'Identifier' || declaration.id.name !== 'app')
+                    return;
+                const appValue = declaration.init;
+                if (!appValue || appValue.type !== 'ObjectExpression')
+                    return;
+                const connectors = findProperty(appValue, 'dataConnectors', moduleScope);
+                if (connectors?.type !== 'ArrayExpression')
+                    return;
+                for (const element of connectors.elements) {
+                    if (element)
+                        visitTool(element, moduleScope, result, currPath, helpers);
+                }
+            },
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errored({ code: 'DATA_CONNECTOR_RESOLUTION_FAILED', message });
+    }
+    return complete(result);
+}
+export async function findDataConnectorModules(srcDirAbsolute) {
+    const appEntryPoint = await getAppEntryPoint(srcDirAbsolute);
+    if (!appEntryPoint) {
+        return complete(new Map());
+    }
+    return findDataConnectorModulesFromSource(appEntryPoint.content, appEntryPoint.path, {
+        getModuleSource: (p) => fs.readFileSync(p, 'utf-8'),
+        doesModuleExist: (p) => fs.existsSync(p),
+        modules: new Map(),
+    });
+}

package/lib/build/server/generate-server-entry.js

@@ -16,7 +16,7 @@ async function findServerFunctionModules(cwd, pattern) {
         });
     }
 }
-export async function generateServerEntry({ appDirAbsolute, srcDirAbsolute, webhooksDirAbsolute, eventDirAbsolute, workflowBlockModules, toolModules = new Map(), log, }) {
+export async function generateServerEntry({ appDirAbsolute, srcDirAbsolute, webhooksDirAbsolute, eventDirAbsolute, workflowBlockModules, toolModules = new Map(), dataConnectorModules = new Map(), log, }) {
     const pathsResult = await combineAsync({
         serverFunctionConcretePaths: findServerFunctionModules(srcDirAbsolute, 'server'),
         webhookConcretePaths: findServerFunctionModules(webhooksDirAbsolute, 'webhook'),
@@ -150,6 +150,51 @@ export async function generateServerEntry({ appDirAbsolute, srcDirAbsolute, webh
             };
         }
 
+        // Data connector module registry
+        const dataConnectorModulesMap = new Map()
+
+        ${[...dataConnectorModules.entries()]
+        .map(([connectorId, handlers]) => `dataConnectorModulesMap.set(
+                        ${JSON.stringify(connectorId)},
+                        {
+                        ${[...Object.entries(handlers)]
+        .map(([handler, data]) => data
+        ? `${JSON.stringify(handler)}: {
+                                        module: () => import(${JSON.stringify(path.join(appDirAbsolute, data.path))}),
+                                        export: ${JSON.stringify(data.export)}
+                                    },`
+        : '')
+        .join('\n')}
+                        }
+                    )`)
+        .join('\n')}
+
+        // Build __AUXX_DATA_CONNECTORS__ — the connector registry read by the
+        // lambda data-connector-executor. Mirrors __AUXX_TOOLS__: the executor
+        // reads execute({ streamKey, mode, state, connection, config }) off this
+        // global. See plans/data-connectors/claude/03-connectors-and-sources.md §4.
+        const __AUXX_DATA_CONNECTORS__ = {};
+
+        for (const [connectorId, handlers] of dataConnectorModulesMap.entries()) {
+            __AUXX_DATA_CONNECTORS__[connectorId] = {
+                execute: async (...args) => {
+                    const executeHandler = handlers.execute;
+                    if (!executeHandler) {
+                        throw new Error(\`No execute handler for data connector \${connectorId}\`);
+                    }
+                    const module = await executeHandler.module();
+                    const func = module[executeHandler.export];
+                    if (!func) {
+                        throw new Error(\`Execute export not found in data connector \${connectorId}\`);
+                    }
+                    if (typeof func !== "function") {
+                        throw new Error(\`Execute export in data connector \${connectorId} is not a function\`);
+                    }
+                    return await func(...args);
+                }
+            };
+        }
+
         var stdin_default;
         var stdin_webhooks_default;
         var stdin_events_default;

package/lib/client/forms/index.d.ts

@@ -1,11 +1,13 @@
 import { FormBoolean } from './types/boolean.js';
 import { FormNumber } from './types/number.js';
+import { FormPicker } from './types/picker.js';
 import { FormSelect } from './types/select.js';
 import { FormString } from './types/string.js';
 import type { SelectOption } from './types.js';
 export * from './base.js';
 export { FormBoolean } from './types/boolean.js';
 export { FormNumber } from './types/number.js';
+export { FormPicker, type PickerConfig } from './types/picker.js';
 export { FormSelect } from './types/select.js';
 export { FormString } from './types/string.js';
 export * from './types.js';
@@ -16,11 +18,13 @@ export declare const Forms: {
     number: () => FormNumber;
     boolean: () => FormBoolean;
     select: <T extends string>(options: SelectOption<T>[]) => FormSelect<T>;
+    picker: typeof FormPicker.create;
 };
 export declare const Settings: {
     string: () => FormString;
     number: () => FormNumber;
     boolean: () => FormBoolean;
     select: <T extends string>(options: SelectOption<T>[]) => FormSelect<T>;
+    picker: typeof FormPicker.create;
 };
 //# sourceMappingURL=index.d.ts.map

package/lib/client/forms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/forms/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AAgBrC,eAAO,MAAM,KAAK;;;;aAIP,CAAC,SAAS,MAAM,WAAW,YAAY,CAAC,CAAC,CAAC,EAAE;CACtD,CAAA;AAeD,eAAO,MAAM,QAAQ;;;;aAhBV,CAAC,SAAS,MAAM,WAAW,YAAY,CAAC,CAAC,CAAC,EAAE;CAgB1B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/forms/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAqB,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,cAAc,WAAW,CAAA;AACzB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AAgBrC,eAAO,MAAM,KAAK;;;;aAIP,CAAC,SAAS,MAAM,WAAW,YAAY,CAAC,CAAC,CAAC,EAAE;YACoB,OAAO,UAAU,CAAC,MAAM;CAClG,CAAA;AAeD,eAAO,MAAM,QAAQ;;;;aAjBV,CAAC,SAAS,MAAM,WAAW,YAAY,CAAC,CAAC,CAAC,EAAE;YACoB,OAAO,UAAU,CAAC,MAAM;CAgBtE,CAAA"}

package/lib/client/forms/types/picker.d.ts

@@ -0,0 +1,21 @@
+import { FormValue } from '../base.js';
+import type { FormPickerMetadata, PickerLoadOptions, SelectOption, SerializedFormValue } from '../types.js';
+export interface PickerConfig {
+    loadOptions?: PickerLoadOptions;
+    options?: SelectOption[];
+    multi?: boolean;
+}
+export declare class FormPicker<V extends string | string[] = string> extends FormValue<V> {
+    readonly _metadata: FormPickerMetadata;
+    private constructor();
+    static create(config: PickerConfig & {
+        multi: true;
+    }): FormPicker<string[]>;
+    static create(config?: PickerConfig): FormPicker<string>;
+    static is(value: unknown): value is FormPicker;
+    get type(): 'picker';
+    optional(): FormPicker<V>;
+    placeholder(text: string): FormPicker<V>;
+    toJSON(): SerializedFormValue;
+}
+//# sourceMappingURL=picker.d.ts.map

package/lib/client/forms/types/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../../../src/client/forms/types/picker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACpB,MAAM,aAAa,CAAA;AAMpB,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAcD,qBAAa,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAChF,SAAgB,SAAS,EAAE,kBAAkB,CAAA;IAE7C,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;IAC3E,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC;IAYxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU;IAI9C,IAAI,IAAI,IAAI,QAAQ,CAEnB;IAED,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC;IAIzB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAIxC,MAAM,IAAI,mBAAmB;CAS9B"}

package/lib/client/forms/types/picker.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Implementation stripped - provided by runtime

package/lib/client/forms/types.d.ts

@@ -10,6 +10,9 @@ export type SerializedFormValue = {
 } | {
     type: 'select';
     metadata: FormSelectMetadata;
+} | {
+    type: 'picker';
+    metadata: FormPickerMetadata;
 };
 export interface FormStringMetadata {
     optional?: boolean;
@@ -61,6 +64,18 @@ export interface FormSelectMetadata<T extends string = string> {
         required?: string;
     };
 }
+export type PickerLoadOptions = (query: string) => Promise<SelectOption[]>;
+export interface FormPickerMetadata {
+    loadOptions?: PickerLoadOptions;
+    hasLoadOptions?: boolean;
+    options?: SelectOption[];
+    multi?: boolean;
+    optional?: boolean;
+    placeholder?: string;
+    errorMessages?: {
+        required?: string;
+    };
+}
 export type FormSchema = Record<string, FormValue<any>>;
 export type InferFormValues<S extends FormSchema> = {
     [K in keyof S]: S[K] extends FormValue<infer T> ? S[K]['_metadata']['optional'] extends true ? T | undefined : T : never;

package/lib/client/forms/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/forms/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAA;CAAE,CAAA;AAKpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,GAAG,CAAC,EAAE,MAAM,CAAA;KACb,CAAA;CACF;AAKD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAKD,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAKD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,KAAK,EAAE,CAAC,CAAA;IACR,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAKD,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3D,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,CAAC,CAAA;IAChB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAKD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;AAKvD,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,UAAU,IAAI;KACjD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAC3C,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,GACxC,CAAC,GAAG,SAAS,GACb,CAAC,GACH,KAAK;CACV,CAAA;AAGD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/forms/types.ts"],"names":[],"mappings":"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"}

package/lib/client/hooks/index.d.ts

@@ -2,9 +2,10 @@ export { type AsyncCacheConfig, type AsyncFunction, useAsyncCache } from './use-
 export interface AuxxRecord {
     id: string;
     type: string;
+    displayName?: string;
     data: Record<string, any>;
-    createdAt: Date;
-    updatedAt: Date;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
 }
 export interface Query {
     type: string;
@@ -21,7 +22,7 @@ export interface User {
 export interface AppSettings {
     [key: string]: any;
 }
-export declare function useRecord(_recordId: string): AuxxRecord;
+export declare function useRecord(recordId: string): AuxxRecord;
 export declare function useRecords(_query: Query): AuxxRecord[];
 export declare function useCurrentUser(): User;
 export declare function useSettings(): AppSettings;

package/lib/client/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAK/F,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAKD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAKD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAKD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAkBD,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAEvD;AAkBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,UAAU,EAAE,CAEtD;AAiBD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAiBD,wBAAgB,WAAW,IAAI,WAAW,CAEzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/hooks/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAS/F,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAKD,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAKD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAKD,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AA4BD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAKtD;AAkBD,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,UAAU,EAAE,CAEtD;AAiBD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAiBD,wBAAgB,WAAW,IAAI,WAAW,CAEzC"}

package/lib/commands/dev/prepare-build-context.js

@@ -1,6 +1,6 @@
 import chalk from 'chalk';
 import path from 'path';
-import { findToolModules } from '../../build/server/find-tool-server-modules.js';
+import { findDataConnectorModules, findToolModules, } from '../../build/server/find-tool-server-modules.js';
 import { findWorkflowBlockModules } from '../../build/server/find-workflow-block-server-modules.js';
 import { combine, combineAsync, complete, isComplete, isErrored, map, } from '../../errors.js';
 import { ClientBuilder } from './client-builder.js';
@@ -46,11 +46,16 @@ export async function prepareBuildContext(mode) {
             if (isErrored(toolModulesResult)) {
                 return toolModulesResult;
             }
+            const dataConnectorModulesResult = await findDataConnectorModules(srcDir);
+            if (isErrored(dataConnectorModulesResult)) {
+                return dataConnectorModulesResult;
+            }
             const { blocks: workflowBlockModules } = workflowBlockModulesResult.value;
             const toolModules = toolModulesResult.value;
+            const dataConnectorModules = dataConnectorModulesResult.value;
             return combineAsync({
                 client: client.rebuild({ workflowBlockModules }),
-                server: server.rebuild({ workflowBlockModules, toolModules }),
+                server: server.rebuild({ workflowBlockModules, toolModules, dataConnectorModules }),
             });
         },
         dispose: async (timeoutMs) => {

package/lib/commands/dev/server-builder.js

@@ -42,7 +42,7 @@ export class ServerBuilder {
             });
         }
     }
-    async rebuild({ workflowBlockModules, toolModules, }) {
+    async rebuild({ workflowBlockModules, toolModules, dataConnectorModules, }) {
         const jsResult = await generateServerEntry({
             appDirAbsolute: path.resolve(this._directories.app),
             srcDirAbsolute: path.resolve(this._directories.src),
@@ -50,6 +50,7 @@ export class ServerBuilder {
             eventDirAbsolute: path.resolve(this._directories.events),
             workflowBlockModules,
             toolModules: toolModules ?? new Map(),
+            dataConnectorModules: dataConnectorModules ?? new Map(),
             log: console.log,
         });
         if (isErrored(jsResult)) {

package/lib/root/app.d.ts

@@ -1,4 +1,5 @@
 import type { BulkRecordAction, RecordAction, RecordWidget } from '../client/record-actions.js';
+import type { DataConnectorDefinition } from './data-connectors/types.js';
 import type { AppFieldDefinition } from './fields/index.js';
 import type { ScopedSettingsSchema } from './settings/settings-schema.js';
 import type { ToolDefinition, Toolset } from './tools/types.js';
@@ -50,6 +51,7 @@ export interface App {
     readonly tools?: ReadonlyArray<ToolDefinition>;
     readonly toolsets?: ReadonlyArray<Toolset>;
     readonly fields?: ReadonlyArray<AppFieldDefinition>;
+    readonly dataConnectors?: ReadonlyArray<DataConnectorDefinition>;
     readonly settings?: {
         readonly organization?: ScopedSettingsSchema;
     };

package/lib/root/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/root/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAIjE,MAAM,WAAW,UAAU;IAEzB,QAAQ,EAAE,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAA;IAE/D,OAAO,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC,EAAE,CAAA;IAExC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAKD,MAAM,WAAW,WAAW;IAE1B,IAAI,EAAE,MAAM,CAAA;IAEZ,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAE1B,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAuBD,MAAM,CAAC,OAAO,WAAW,GAAG,CAAC;IAC3B,UAAU,MAAM,CAAC;QACf,KAAK,MAAM,GAAG,YAAY,CAAA;QAC1B,KAAK,UAAU,GAAG,gBAAgB,CAAA;QAClC,KAAK,MAAM,GAAG,YAAY,CAAA;KAC3B;IACD,UAAU,QAAQ,CAAC,GAAE;IACrB,UAAU,QAAQ,CAAC,GAAE;CACtB;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;KAC5C,CAAA;IAED,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,QAAQ,CAAC,OAAO,CAAC,EAAE;YACjB,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;SACpC,CAAA;QACD,QAAQ,CAAC,OAAO,CAAC,EAAE;YACjB,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;SACrC,CAAA;QACD,QAAQ,CAAC,UAAU,CAAC,EAAE;YACpB,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;SACpC,CAAA;KACF,CAAA;IAED,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAElB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;QAEjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;KAC9B,CAAA;IAOD,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAA;IAK9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAQ1C,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAA;IAEnD,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAA;KAC7C,CAAA;CAIF"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/root/app.ts"],"names":[],"mappings":"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"}

package/lib/root/data-connectors/define-data-connector.d.ts

@@ -0,0 +1,4 @@
+import type { z } from 'zod/v4';
+import type { DataConnectorDefinition } from './types.js';
+export declare function defineDataConnector<TConfigSchema extends z.ZodTypeAny>(connector: DataConnectorDefinition<TConfigSchema>): DataConnectorDefinition<TConfigSchema>;
+//# sourceMappingURL=define-data-connector.d.ts.map

package/lib/root/data-connectors/define-data-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-data-connector.d.ts","sourceRoot":"","sources":["../../../src/root/data-connectors/define-data-connector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAwDzD,wBAAgB,mBAAmB,CAAC,aAAa,SAAS,CAAC,CAAC,UAAU,EACpE,SAAS,EAAE,uBAAuB,CAAC,aAAa,CAAC,GAChD,uBAAuB,CAAC,aAAa,CAAC,CA6CxC"}

package/lib/root/data-connectors/define-data-connector.js

@@ -0,0 +1,33 @@
+const CONNECTOR_ID_RE = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)*$/;
+export function defineDataConnector(connector) {
+    if (!CONNECTOR_ID_RE.test(connector.id)) {
+        throw new Error(`defineDataConnector: invalid id "${connector.id}" — must match ${CONNECTOR_ID_RE.source}`);
+    }
+    if (!connector.streams.length) {
+        throw new Error(`defineDataConnector: connector "${connector.id}" declares no streams`);
+    }
+    const seenStreamKeys = new Set();
+    for (const stream of connector.streams) {
+        if (!stream.key) {
+            throw new Error(`defineDataConnector: connector "${connector.id}" has a stream with no key`);
+        }
+        if (seenStreamKeys.has(stream.key)) {
+            throw new Error(`defineDataConnector: connector "${connector.id}" has duplicate stream key "${stream.key}"`);
+        }
+        seenStreamKeys.add(stream.key);
+        if (!stream.fields[stream.displayFieldKey]) {
+            throw new Error(`defineDataConnector: stream "${stream.key}" displayFieldKey "${stream.displayFieldKey}" is not a declared field`);
+        }
+        if (stream.exampleRecord !== undefined) {
+            try {
+                if (JSON.stringify(stream.exampleRecord) === undefined) {
+                    throw new Error('serializes to undefined');
+                }
+            }
+            catch (err) {
+                throw new Error(`defineDataConnector: stream "${stream.key}" exampleRecord is not JSON-serializable — ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    return connector;
+}

package/lib/root/data-connectors/index.d.ts

@@ -0,0 +1,3 @@
+export { defineDataConnector } from './define-data-connector.js';
+export type { ConnectorConnection, ConnectorDefaultMapping, ConnectorEntityDecl, ConnectorExecute, ConnectorExecuteArgs, ConnectorFetchResult, ConnectorFieldCapabilities, ConnectorFieldDecl, ConnectorRecord, ConnectorStreamDecl, ConnectorStreamState, DataConnectorDefinition, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/root/data-connectors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/root/data-connectors/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,YAAY,CAAA"}

package/lib/root/data-connectors/index.js

@@ -0,0 +1 @@
+export { defineDataConnector } from './define-data-connector.js';

package/lib/root/data-connectors/types.d.ts

@@ -0,0 +1,80 @@
+import type { z } from 'zod/v4';
+import type { FieldType } from '../fields/field-types.js';
+export interface ConnectorRecord {
+    streamKey: string;
+    externalId: string;
+    displayName: string;
+    fields: Record<string, unknown>;
+    deleted?: boolean;
+    contentHash?: string;
+}
+export interface ConnectorStreamState {
+    cursor?: unknown;
+    updatedSince?: string;
+    backfillComplete?: boolean;
+    [key: string]: unknown;
+}
+export interface ConnectorFetchResult {
+    records: ConnectorRecord[] | AsyncIterable<ConnectorRecord>;
+    nextState: ConnectorStreamState;
+}
+export interface ConnectorFieldCapabilities {
+    hidden?: boolean;
+    filterable?: boolean;
+}
+export interface ConnectorFieldDecl {
+    sourcePath: string;
+    type: FieldType;
+    name: string;
+    pii?: boolean;
+    capabilities?: ConnectorFieldCapabilities;
+}
+export interface ConnectorEntityDecl {
+    apiSlug: string;
+    singular: string;
+    plural: string;
+    primaryDisplayField?: string;
+}
+export interface ConnectorDefaultMapping {
+    rootPath: string;
+    linkMode?: 'upsert' | 'reference';
+    relationshipFieldKey?: string;
+    target: {
+        mode: 'owned';
+        entity: ConnectorEntityDecl;
+    } | {
+        mode: 'contributing';
+        entityKind: string;
+        matchFieldKeys?: string[];
+    };
+}
+export interface ConnectorStreamDecl {
+    key: string;
+    displayFieldKey: string;
+    fields: Record<string, ConnectorFieldDecl>;
+    defaultMappings?: ConnectorDefaultMapping[];
+    exampleRecord?: Record<string, unknown>;
+}
+export interface ConnectorExecuteArgs<TConfig = Record<string, unknown>> {
+    streamKey: string;
+    mode: 'snapshot' | 'incremental';
+    state: ConnectorStreamState;
+    connection: ConnectorConnection | null;
+    config: TConfig;
+}
+export interface ConnectorConnection {
+    value: string;
+    fields?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+export type ConnectorExecute<TConfig = Record<string, unknown>> = (args: ConnectorExecuteArgs<TConfig>) => Promise<ConnectorFetchResult>;
+export interface DataConnectorDefinition<TConfigSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+    id: string;
+    label: string;
+    requiresConnection: boolean;
+    config: TConfigSchema;
+    streams: ConnectorStreamDecl[];
+    iconKey?: string;
+    execute: ConnectorExecute<z.output<TConfigSchema>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/root/data-connectors/types.d.ts.map

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

package/lib/root/data-connectors/types.js

@@ -0,0 +1 @@
+export {};

package/lib/root/index.d.ts

@@ -1,6 +1,8 @@
 export type { BulkRecordAction, RecordAction, RecordActionContext, } from '../client/record-actions.js';
 export type { TriggerContext, WorkflowContext, WorkflowInput, WorkflowOutput, } from '../server/workflow/index.js';
 export type { App, AppSettings, Permission } from './app.js';
+export type { ConnectorConnection, ConnectorDefaultMapping, ConnectorEntityDecl, ConnectorExecute, ConnectorExecuteArgs, ConnectorFetchResult, ConnectorFieldCapabilities, ConnectorFieldDecl, ConnectorRecord, ConnectorStreamDecl, ConnectorStreamState, DataConnectorDefinition, } from './data-connectors/index.js';
+export { defineDataConnector } from './data-connectors/index.js';
 export { type AppFieldDefinition, type AppFieldValues, defineField, defineFields, FIELD_TYPES, type FieldCapabilities, type FieldScope, type FieldSelectOption, type FieldType, type FieldTypeValueMap, type FieldValueType, } from './fields/index.js';
 export { Settings } from './settings/index.js';
 export type { BaseSettingOptions, BooleanSettingOptions, NumberSettingOptions, SelectSettingOptions, SettingsBooleanNode, SettingsNode, SettingsNumberNode, SettingsSchema, SettingsSelectNode, SettingsStringNode, SettingsStructNode, StringSettingOptions, StructSettingOptions, } from './settings/settings-schema.js';

package/lib/root/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/root/index.ts"],"names":[],"mappings":"AASA,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AACpC,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE5D,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,OAAO,GACR,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,wBAAwB,EACxB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EAEZ,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EAEjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/root/index.ts"],"names":[],"mappings":"AASA,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,GACpB,MAAM,6BAA6B,CAAA;AACpC,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,OAAO,GACR,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAA;AACtD,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,wBAAwB,EACxB,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EAEZ,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EAEjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,GACb,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA"}

package/lib/root/index.js

@@ -1,3 +1,4 @@
+export { defineDataConnector } from './data-connectors/index.js';
 export { defineField, defineFields, FIELD_TYPES, } from './fields/index.js';
 export { Settings } from './settings/index.js';
 export { defineTool, refs, z } from './tools/index.js';

package/lib/root/tools/types.d.ts

@@ -58,6 +58,21 @@ export interface ToolActionSurface {
     readonly confirmationMessage?: string;
     readonly shouldShow?: (ctx: ToolActionContext) => boolean;
     readonly getDefaults?: (ctx: ToolActionContext) => Record<string, unknown>;
+    readonly inputs?: Record<string, ActionInputHint>;
+}
+export type ActionInputHint = {
+    kind: 'dynamic-select';
+    dynamicSelect: DynamicSelectHint;
+};
+export interface DynamicSelectHint {
+    readonly optionsFrom: string;
+    readonly bindArgsFrom?: Record<string, string>;
+    readonly args?: Record<string, unknown>;
+    readonly valuePath: string;
+    readonly itemsPath?: string;
+    readonly labelTemplate: string;
+    readonly sublabelTemplate?: string;
+    readonly emptyHint?: string;
 }
 export interface ToolDefinition<TInput extends z.ZodTypeAny = z.ZodTypeAny, TOutput extends z.ZodTypeAny = z.ZodTypeAny> {
     readonly id: string;

package/lib/root/tools/types.d.ts.map

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

package/lib/runtime/reconciler/tags/form-tag.d.ts

@@ -2,6 +2,8 @@ import { BaseTag } from './base-tag.js';
 export declare class FormTag extends BaseTag {
     private internalRef;
     constructor(props: Record<string, any>);
+    private pickerResolvers;
+    private registerPickerLoadOptions;
     getTagName(): string;
     getComponentName(): string;
     getAttributes(props: Record<string, any>): Record<string, any>;

package/lib/runtime/reconciler/tags/form-tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-tag.d.ts","sourceRoot":"","sources":["../../../../src/runtime/reconciler/tags/form-tag.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAMvC,qBAAa,OAAQ,SAAQ,OAAO;IAClC,OAAO,CAAC,WAAW,CAAK;gBAEZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAatC,UAAU,IAAI,MAAM;IAIpB,gBAAgB,IAAI,MAAM;IAI1B,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA8C9D,mBAAmB;CA8BpB"}
+{"version":3,"file":"form-tag.d.ts","sourceRoot":"","sources":["../../../../src/runtime/reconciler/tags/form-tag.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AASvC,qBAAa,OAAQ,SAAQ,OAAO;IAClC,OAAO,CAAC,WAAW,CAAK;gBAEZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAqBtC,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,yBAAyB;IAsBjC,UAAU,IAAI,MAAM;IAIpB,gBAAgB,IAAI,MAAM;IAI1B,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA8C9D,mBAAmB;CA8BpB"}

package/lib/runtime/reconciler/tags/form-tag.js

@@ -1,7 +1,10 @@
 import { serializeSchema } from '../../../client/forms/utils/serialize.js';
 import { validateFormFields } from '../../../client/forms/utils/validation.js';
+import { eventBus } from '../../event-bus.js';
 import { registerEventHandler } from '../../register-event-handler.js';
+import { wrapEventHandler } from '../../wrap-event-handler.js';
 import { BaseTag } from './base-tag.js';
+const LOAD_OPTIONS_PREFIX = 'loadOptions:';
 export class FormTag extends BaseTag {
     internalRef;
     constructor(props) {
@@ -10,8 +13,36 @@ export class FormTag extends BaseTag {
         registerEventHandler(this, 'onChange');
         registerEventHandler(this, 'onError');
         registerEventHandler(this, 'onValidationError');
+        this.registerPickerLoadOptions(props.schema);
         this.internalRef = props.__internalRef;
     }
+    pickerResolvers(schema) {
+        if (!schema || typeof schema !== 'object')
+            return [];
+        const out = [];
+        for (const [name, field] of Object.entries(schema)) {
+            if (field?.type === 'picker' && typeof field._metadata?.loadOptions === 'function') {
+                out.push({ name, loadOptions: field._metadata.loadOptions });
+            }
+        }
+        return out;
+    }
+    registerPickerLoadOptions(schema) {
+        const resolvers = this.pickerResolvers(schema);
+        if (resolvers.length === 0)
+            return;
+        this.mounted.addListener(({ instance }) => {
+            for (const { name, loadOptions } of resolvers) {
+                const eventName = `${LOAD_OPTIONS_PREFIX}${name}`;
+                eventBus.setTagEventListener(eventName, instance.instance_id, wrapEventHandler((query) => loadOptions(query ?? ''), { eventName }));
+            }
+        });
+        this.destroyed.addListener(({ instance }) => {
+            for (const { name } of resolvers) {
+                eventBus.clearTagEventListener(`${LOAD_OPTIONS_PREFIX}${name}`, instance.instance_id);
+            }
+        });
+    }
     getTagName() {
         return 'form';
     }

package/lib/util/compile-and-extract-catalog.js

@@ -44,6 +44,7 @@ export async function compileAndExtractCatalog() {
     const SDK_REAL_TOOLS = path.join(SDK_ROOT, 'lib', 'root', 'tools', 'index.js');
     const SDK_REAL_WORKFLOW = path.join(SDK_ROOT, 'lib', 'root', 'workflow', 'index.js');
     const SDK_REAL_FIELDS = path.join(SDK_ROOT, 'lib', 'root', 'fields', 'index.js');
+    const SDK_REAL_DATA_CONNECTORS = path.join(SDK_ROOT, 'lib', 'root', 'data-connectors', 'index.js');
     const stubSdkSubpaths = {
         name: 'auxx-stub-sdk-subpaths',
         setup(build) {
@@ -56,6 +57,8 @@ export async function compileAndExtractCatalog() {
                     return { path: SDK_REAL_WORKFLOW };
                 if (args.path === '@auxx/sdk/fields')
                     return { path: SDK_REAL_FIELDS };
+                if (args.path === '@auxx/sdk/data-connectors')
+                    return { path: SDK_REAL_DATA_CONNECTORS };
                 return { path: args.path, namespace: 'auxx-sdk-stub' };
             });
             build.onLoad({ filter: /.*/, namespace: 'auxx-sdk-stub' }, () => ({
@@ -120,11 +123,13 @@ export async function compileAndExtractCatalog() {
     const workflowBlocksArr = (app.workflow?.blocks ?? []);
     const workflowTriggersArr = (app.workflow?.triggers ?? []);
     const fieldsArr = (app.fields ?? []);
+    const dataConnectorsArr = (app.dataConnectors ?? []);
     if (!toolsArr.length &&
         !toolsetsArr.length &&
         !workflowBlocksArr.length &&
         !workflowTriggersArr.length &&
-        !fieldsArr.length) {
+        !fieldsArr.length &&
+        !dataConnectorsArr.length) {
         return complete(undefined);
     }
     const { zodToProviderToolSchema } = await import('../build/server/zod-to-provider-tool-schema.js');
@@ -193,9 +198,30 @@ export async function compileAndExtractCatalog() {
                 surface: tool.action.surface,
                 requiresConfirmation: tool.action.requiresConfirmation,
                 confirmationMessage: tool.action.confirmationMessage,
+                ...(tool.action.inputs ? { inputHints: tool.action.inputs } : {}),
             });
         }
     }
+    const toolIds = new Set(cataloguedTools.map((t) => t.id));
+    for (const action of cataloguedActions) {
+        for (const [fieldKey, hint] of Object.entries(action.inputHints ?? {})) {
+            if (hint.kind !== 'dynamic-select')
+                continue;
+            const ds = hint.dynamicSelect;
+            if (!toolIds.has(ds.optionsFrom)) {
+                return errored({
+                    code: 'CATALOG_VALIDATION_FAILED',
+                    message: `Action "${action.toolId}" input "${fieldKey}": optionsFrom "${ds.optionsFrom}" is not a tool in this app`,
+                });
+            }
+            if (!ds.valuePath || !ds.labelTemplate) {
+                return errored({
+                    code: 'CATALOG_VALIDATION_FAILED',
+                    message: `Action "${action.toolId}" input "${fieldKey}": dynamic-select requires valuePath and labelTemplate`,
+                });
+            }
+        }
+    }
     const cataloguedTriggers = [];
     const cataloguedWorkflowTriggers = [];
     const cataloguedAgentTriggers = [];
@@ -279,6 +305,48 @@ export async function compileAndExtractCatalog() {
             capabilities: field.capabilities,
         });
     }
+    const cataloguedDataConnectors = [];
+    const seenConnectorIds = new Set();
+    for (const connector of dataConnectorsArr) {
+        if (!connector?.id) {
+            return errored({
+                code: 'CATALOG_VALIDATION_FAILED',
+                message: 'Data connector is missing an id',
+            });
+        }
+        if (seenConnectorIds.has(connector.id)) {
+            return errored({
+                code: 'CATALOG_VALIDATION_FAILED',
+                message: `Duplicate data connector id "${connector.id}"`,
+            });
+        }
+        seenConnectorIds.add(connector.id);
+        const configJsonSchema = connector.config
+            ? zodToProviderToolSchema(connector.config).jsonSchema
+            : {};
+        const streams = (connector.streams ?? []).map((stream) => ({
+            key: stream.key,
+            displayFieldKey: stream.displayFieldKey,
+            fields: Object.entries(stream.fields ?? {}).map(([fieldKey, decl]) => ({
+                fieldKey,
+                sourcePath: decl.sourcePath,
+                type: decl.type,
+                name: decl.name,
+                pii: decl.pii,
+                capabilities: decl.capabilities,
+            })),
+            defaultMappings: stream.defaultMappings,
+            exampleRecord: stream.exampleRecord,
+        }));
+        cataloguedDataConnectors.push({
+            id: connector.id,
+            label: connector.label,
+            requiresConnection: Boolean(connector.requiresConnection),
+            iconKey: connector.iconKey ?? null,
+            configJsonSchema,
+            streams,
+        });
+    }
     const catalog = {
         tools: cataloguedTools,
         triggers: cataloguedTriggers,
@@ -294,6 +362,7 @@ export async function compileAndExtractCatalog() {
         },
         actions: cataloguedActions,
         fields: cataloguedFields,
+        dataConnectors: cataloguedDataConnectors,
     };
     try {
         JSON.stringify(catalog);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auxx/sdk",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "CLI tool and SDK for creating Auxx apps",
   "type": "module",
   "bin": {
@@ -46,6 +46,10 @@
       "types": "./lib/root/fields/index.d.ts",
       "import": "./lib/root/fields/index.js"
     },
+    "./data-connectors": {
+      "types": "./lib/root/data-connectors/index.d.ts",
+      "import": "./lib/root/data-connectors/index.js"
+    },
     "./shared": {
       "types": "./lib/shared/index.d.ts",
       "import": "./lib/shared/index.js"