@agent-native/core 0.5.0-dev.b51eaae → 0.7.1

package/dist/deploy/workspace-core.js

@@ -0,0 +1,223 @@
+/**
+ * Workspace-core discovery.
+ *
+ * An enterprise can sit many agent-native apps in one monorepo alongside a
+ * private "workspace core" package that provides shared plugins, skills,
+ * actions, AGENTS.md, and a tailwind preset. Apps inherit everything from
+ * the workspace core without writing any boilerplate — this is the
+ * middle layer of the three-layer inheritance model:
+ *
+ *   1. app local           (highest priority — app's own server/plugins/, actions/, etc.)
+ *   2. workspace core      (middle — packages/core-module/ in the enterprise monorepo)
+ *   3. @agent-native/core  (lowest — framework defaults)
+ *
+ * Discovery works by walking up from the build cwd looking for a package.json
+ * that declares `"agent-native": { "workspaceCore": "@company/core-module" }`.
+ * The declared package is then resolved through the monorepo's node_modules,
+ * and its directory structure is probed for the standard layout:
+ *
+ *   packages/core-module/
+ *     package.json
+ *     src/server/index.ts  (exports <slot>Plugin for any slot it wants to provide)
+ *     actions/             (shared agent-callable actions)
+ *     skills/              (shared .agents/skills/<name>/SKILL.md)
+ *     AGENTS.md            (enterprise-wide agent instructions)
+ *     tailwind.preset.ts   (brand preset extending @agent-native/core/tailwind)
+ */
+import path from "path";
+let _fs;
+async function getFs() {
+    if (!_fs)
+        _fs = await import("node:fs");
+    return _fs;
+}
+let cache;
+/**
+ * Walk up from startDir looking for a directory whose package.json has an
+ * `agent-native.workspaceCore` field. Returns both the root dir and the
+ * declared package name, or null if there's no workspace core in the tree.
+ */
+async function findWorkspaceRoot(startDir) {
+    const fs = await getFs();
+    let dir = path.resolve(startDir);
+    // Hard stop at filesystem root to avoid infinite loops.
+    for (let i = 0; i < 20; i++) {
+        const pkgPath = path.join(dir, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+                const declared = pkg?.["agent-native"]?.workspaceCore;
+                if (typeof declared === "string" && declared.length > 0) {
+                    return { workspaceRoot: dir, packageName: declared };
+                }
+            }
+            catch {
+                // Malformed package.json — keep walking up.
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Resolve a workspace package name to its directory inside the monorepo.
+ * Tries in order:
+ *   1. <workspaceRoot>/node_modules/<packageName>/package.json (pnpm symlink)
+ *   2. For each dir under <workspaceRoot>/packages/*, read its package.json
+ *      and match on `name`.
+ *   3. For each dir under <workspaceRoot>/packages/*\/*, same match.
+ *
+ * The pnpm symlink approach is fastest when deps are installed; the direct
+ * scan is a fallback for pre-install scenarios (e.g. running tests before
+ * the first `pnpm install` in a scaffolded workspace).
+ */
+async function resolvePackageDir(workspaceRoot, packageName) {
+    const fs = await getFs();
+    // 1) pnpm / npm install symlink
+    const nmCandidate = path.join(workspaceRoot, "node_modules", packageName);
+    if (fs.existsSync(path.join(nmCandidate, "package.json"))) {
+        return nmCandidate;
+    }
+    // 2) scan packages/*
+    const packagesDir = path.join(workspaceRoot, "packages");
+    const candidates = [];
+    if (fs.existsSync(packagesDir)) {
+        for (const entry of fs.readdirSync(packagesDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            candidates.push(path.join(packagesDir, entry.name));
+        }
+    }
+    // 3) scan packages/*/*  (for scoped layouts like packages/@company/core-module)
+    if (fs.existsSync(packagesDir)) {
+        for (const entry of fs.readdirSync(packagesDir, { withFileTypes: true })) {
+            if (!entry.isDirectory() || !entry.name.startsWith("@"))
+                continue;
+            const scopeDir = path.join(packagesDir, entry.name);
+            for (const sub of fs.readdirSync(scopeDir, { withFileTypes: true })) {
+                if (!sub.isDirectory())
+                    continue;
+                candidates.push(path.join(scopeDir, sub.name));
+            }
+        }
+    }
+    for (const candidate of candidates) {
+        const pkgPath = path.join(candidate, "package.json");
+        if (!fs.existsSync(pkgPath))
+            continue;
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+            if (pkg?.name === packageName)
+                return candidate;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+/**
+ * Probe a workspace core package directory to discover which plugin slots it
+ * exports. We read its package.json `exports` field + peek at
+ * `src/server/index.ts` (or dist/server/index.js) looking for exports of the
+ * form `<slot>Plugin` — the same convention the core server index uses.
+ */
+async function discoverPluginExports(packageDir) {
+    const fs = await getFs();
+    const out = {};
+    const candidates = [
+        path.join(packageDir, "src", "server", "index.ts"),
+        path.join(packageDir, "dist", "server", "index.js"),
+        path.join(packageDir, "src", "server.ts"),
+        path.join(packageDir, "dist", "server.js"),
+    ];
+    let source = "";
+    for (const c of candidates) {
+        if (fs.existsSync(c)) {
+            try {
+                source = fs.readFileSync(c, "utf-8");
+                break;
+            }
+            catch {
+                // keep trying
+            }
+        }
+    }
+    if (!source)
+        return out;
+    // Map slot name → export name we're looking for. "agent-chat" has a hyphen,
+    // so we probe both the camelCase and dash-free variants.
+    const slotExportNames = {
+        "agent-chat": ["agentChatPlugin"],
+        auth: ["authPlugin"],
+        "core-routes": ["coreRoutesPlugin"],
+        integrations: ["integrationsPlugin"],
+        org: ["orgPlugin"],
+        resources: ["resourcesPlugin"],
+        terminal: ["terminalPlugin"],
+    };
+    for (const [slot, names] of Object.entries(slotExportNames)) {
+        for (const name of names) {
+            // Match any of:
+            //   export const <name>
+            //   export async function <name>
+            //   export function <name>
+            //   export { <name>
+            //   export { foo as <name>
+            const patterns = [
+                new RegExp(`export\\s+const\\s+${name}\\b`, "m"),
+                new RegExp(`export\\s+(?:async\\s+)?function\\s+${name}\\b`, "m"),
+                new RegExp(`export\\s*\\{[^}]*?\\b${name}\\b[^}]*?\\}`, "m"),
+            ];
+            if (patterns.some((re) => re.test(source))) {
+                out[slot] = name;
+                break;
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Main entry point. Discovers the workspace core for the given cwd (defaults
+ * to process.cwd()) and returns its layout. Returns null if there's no
+ * workspace core in the ancestor chain. Result is cached per-cwd so repeated
+ * calls during a single build are cheap.
+ */
+export async function getWorkspaceCoreExports(cwd = process.cwd()) {
+    if (cache && cache.cwd === cwd)
+        return cache.result;
+    const fs = await getFs();
+    const rootInfo = await findWorkspaceRoot(cwd);
+    if (!rootInfo) {
+        cache = { cwd, result: null };
+        return null;
+    }
+    const packageDir = await resolvePackageDir(rootInfo.workspaceRoot, rootInfo.packageName);
+    if (!packageDir) {
+        cache = { cwd, result: null };
+        return null;
+    }
+    const plugins = await discoverPluginExports(packageDir);
+    const actionsDir = path.join(packageDir, "actions");
+    const skillsDir = path.join(packageDir, "skills");
+    const agentsMdPath = path.join(packageDir, "AGENTS.md");
+    const result = {
+        workspaceRoot: rootInfo.workspaceRoot,
+        packageName: rootInfo.packageName,
+        packageDir,
+        plugins,
+        actionsDir: fs.existsSync(actionsDir) ? actionsDir : null,
+        skillsDir: fs.existsSync(skillsDir) ? skillsDir : null,
+        agentsMdPath: fs.existsSync(agentsMdPath) ? agentsMdPath : null,
+    };
+    cache = { cwd, result };
+    return result;
+}
+/** Reset the internal cache. Exposed only for tests. */
+export function _resetWorkspaceCoreCache() {
+    cache = undefined;
+}
+//# sourceMappingURL=workspace-core.js.map

package/dist/deploy/workspace-core.js.map

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

package/dist/deploy/workspace-deploy.d.ts

@@ -0,0 +1,11 @@
+export interface WorkspaceDeployOptions {
+    args?: string[];
+    /** Override the workspace root (defaults to walking up from cwd). */
+    workspaceRoot?: string;
+    /** Only build — don't invoke the deploy platform CLI. */
+    buildOnly?: boolean;
+    /** Target preset. Defaults to `cloudflare_pages`. */
+    preset?: "cloudflare_pages";
+}
+export declare function runWorkspaceDeploy(opts?: WorkspaceDeployOptions): Promise<void>;
+//# sourceMappingURL=workspace-deploy.d.ts.map

package/dist/deploy/workspace-deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-deploy.d.ts","sourceRoot":"","sources":["../../src/deploy/workspace-deploy.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/deploy/workspace-deploy.js

@@ -0,0 +1,148 @@
+/**
+ * `agent-native deploy` — build and deploy every app in a workspace to a
+ * single origin. Each app is served from `/<app-name>/*`, so:
+ *
+ *   https://your-agents.com/mail/*       → apps/mail
+ *   https://your-agents.com/calendar/*   → apps/calendar
+ *
+ * Benefits of same-origin deploy:
+ *   - Shared auth cookie → log in once, every app is signed in
+ *   - Cross-app A2A is a same-origin fetch (no CORS, no JWT for siblings)
+ *   - One DNS record, one TLS cert, one CDN cache
+ *
+ * Per-app independent deploy is still supported — just cd into the app and
+ * run `agent-native build` as before. This orchestrator is for teams that
+ * want the whole workspace behind one domain.
+ */
+import { execFileSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { findWorkspaceRoot } from "../scripts/utils.js";
+export async function runWorkspaceDeploy(opts = {}) {
+    const workspaceRoot = opts.workspaceRoot ?? findWorkspaceRoot(process.cwd()) ?? process.cwd();
+    const appsDir = path.join(workspaceRoot, "apps");
+    if (!fs.existsSync(appsDir)) {
+        throw new Error(`No apps/ directory found at ${workspaceRoot}. Run this inside an agent-native workspace.`);
+    }
+    const args = new Set(opts.args ?? []);
+    const buildOnly = opts.buildOnly ?? args.has("--build-only");
+    const apps = fs
+        .readdirSync(appsDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .filter((n) => fs.existsSync(path.join(appsDir, n, "package.json")));
+    if (apps.length === 0) {
+        throw new Error(`Workspace has no apps. Run \`agent-native add-app\` to add one.`);
+    }
+    const preset = opts.preset ?? "cloudflare_pages";
+    const distDir = path.join(workspaceRoot, "dist");
+    fs.rmSync(distDir, { recursive: true, force: true });
+    fs.mkdirSync(distDir, { recursive: true });
+    console.log(`[workspace-deploy] Building ${apps.length} app(s) for preset=${preset}`);
+    for (const app of apps) {
+        buildOneApp(workspaceRoot, app, preset);
+        moveAppBuildIntoDist(workspaceRoot, app, distDir);
+    }
+    writeWorkspaceRoutingManifest(distDir, apps);
+    if (buildOnly) {
+        console.log(`\n[workspace-deploy] Build complete at ${distDir}. Skipping publish (--build-only).`);
+        return;
+    }
+    console.log(`\n[workspace-deploy] Build complete. Publish with:\n`);
+    console.log(`  cd ${path.relative(process.cwd(), workspaceRoot) || "."}`);
+    console.log(`  wrangler pages deploy dist\n`);
+    console.log(`All apps live at https://<origin>/<app-name>/*. Log in once on any app\nand the session is shared across the workspace.`);
+}
+function buildOneApp(workspaceRoot, app, preset) {
+    const env = {
+        ...process.env,
+        NITRO_PRESET: preset,
+        APP_BASE_PATH: `/${app}`,
+        VITE_APP_BASE_PATH: `/${app}`,
+    };
+    console.log(`[workspace-deploy] Building ${app} (base=/${app}, preset=${preset})`);
+    execFileSync("pnpm", ["--filter", app, "build"], {
+        cwd: workspaceRoot,
+        env,
+        stdio: "inherit",
+    });
+}
+function moveAppBuildIntoDist(workspaceRoot, app, distDir) {
+    const appDir = path.join(workspaceRoot, "apps", app);
+    // Resolve the per-app build output: prefer dist/ (standard), fall back to
+    // .output/ (Nitro's default). The Cloudflare preset emits into dist/
+    // containing the worker + assets.
+    const candidates = ["dist", ".output"];
+    const src = candidates
+        .map((c) => path.join(appDir, c))
+        .find((p) => fs.existsSync(p));
+    if (!src) {
+        throw new Error(`Expected ${candidates.join(" or ")} under ${appDir} but none existed. Check the app's build script.`);
+    }
+    const target = path.join(distDir, app);
+    fs.mkdirSync(target, { recursive: true });
+    copyDir(src, target);
+}
+/**
+ * Write the Cloudflare Pages `_routes.json` and a dispatcher `_worker.js` at
+ * the workspace dist root so each app is reachable under /<app>/*.
+ */
+function writeWorkspaceRoutingManifest(distDir, apps) {
+    // _routes.json tells Cloudflare which paths are dynamic (Functions) vs
+    // static. Mark /<app>/* as include so every app's worker handles its
+    // subtree.
+    const routes = {
+        version: 1,
+        include: apps.map((a) => `/${a}/*`).concat(["/"]),
+        exclude: [],
+    };
+    fs.writeFileSync(path.join(distDir, "_routes.json"), JSON.stringify(routes, null, 2) + "\n");
+    // Dispatcher worker: inspects the path and forwards to the matching
+    // per-app worker.
+    const imports = apps
+        .map((a) => `import ${moduleIdent(a)} from "./${a}/_worker.js";`)
+        .join("\n");
+    const dispatch = apps
+        .map((a) => `  if (pathname === "/${a}" || pathname.startsWith("/${a}/")) return ${moduleIdent(a)}.fetch(request, env, ctx);`)
+        .join("\n");
+    const worker = `${imports}
+
+export default {
+  async fetch(request, env, ctx) {
+    const { pathname } = new URL(request.url);
+${dispatch}
+    if (pathname === "/") {
+      return Response.redirect(new URL("/${apps[0]}/", request.url).toString(), 302);
+    }
+    return new Response("Not found", { status: 404 });
+  },
+};
+`;
+    fs.writeFileSync(path.join(distDir, "_worker.js"), worker);
+}
+function moduleIdent(app) {
+    return "app_" + app.replace(/[^a-zA-Z0-9_]/g, "_");
+}
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const s = path.join(src, entry.name);
+        const d = path.join(dest, entry.name);
+        if (entry.isSymbolicLink()) {
+            try {
+                const target = fs.readlinkSync(s);
+                fs.symlinkSync(target, d);
+            }
+            catch {
+                fs.copyFileSync(s, d);
+            }
+        }
+        else if (entry.isDirectory()) {
+            copyDir(s, d);
+        }
+        else {
+            fs.copyFileSync(s, d);
+        }
+    }
+}
+//# sourceMappingURL=workspace-deploy.js.map

package/dist/deploy/workspace-deploy.js.map

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

package/dist/file-upload/builder.d.ts

@@ -0,0 +1,11 @@
+import type { FileUploadProvider } from "./types.js";
+/**
+ * Built-in Builder.io file upload provider.
+ * Uses the same BUILDER_PRIVATE_KEY as the browser/background-agent flows,
+ * so connecting Builder once (via the sidebar "Connect Builder" action)
+ * automatically enables file uploads.
+ *
+ * Upload API: https://www.builder.io/c/docs/upload-api
+ */
+export declare const builderFileUploadProvider: FileUploadProvider;
+//# sourceMappingURL=builder.d.ts.map

package/dist/file-upload/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/file-upload/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAYrD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAqDvC,CAAC"}

package/dist/file-upload/builder.js

@@ -0,0 +1,53 @@
+const DEFAULT_BUILDER_APP_HOST = "https://builder.io";
+function builderUploadHost() {
+    return (process.env.BUILDER_APP_HOST ||
+        process.env.BUILDER_PUBLIC_APP_HOST ||
+        DEFAULT_BUILDER_APP_HOST);
+}
+/**
+ * Built-in Builder.io file upload provider.
+ * Uses the same BUILDER_PRIVATE_KEY as the browser/background-agent flows,
+ * so connecting Builder once (via the sidebar "Connect Builder" action)
+ * automatically enables file uploads.
+ *
+ * Upload API: https://www.builder.io/c/docs/upload-api
+ */
+export const builderFileUploadProvider = {
+    id: "builder",
+    name: "Builder.io",
+    isConfigured: () => !!process.env.BUILDER_PRIVATE_KEY,
+    upload: async ({ data, filename, mimeType }) => {
+        const privateKey = process.env.BUILDER_PRIVATE_KEY;
+        if (!privateKey) {
+            throw new Error("BUILDER_PRIVATE_KEY is not set");
+        }
+        const url = new URL("/api/v1/upload", builderUploadHost());
+        if (filename)
+            url.searchParams.set("name", filename);
+        const buffer = data instanceof Uint8Array ? data : new Uint8Array(data);
+        const bytes = new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+        const body = typeof Blob !== "undefined"
+            ? new Blob([bytes], {
+                type: mimeType || "application/octet-stream",
+            })
+            : bytes;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${privateKey}`,
+                "Content-Type": mimeType || "application/octet-stream",
+            },
+            body,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(`Builder.io upload failed (${response.status}): ${text || response.statusText}`);
+        }
+        const json = (await response.json().catch(() => ({})));
+        if (!json.url) {
+            throw new Error("Builder.io upload returned no URL");
+        }
+        return { url: json.url, id: json.id, provider: "builder" };
+    },
+};
+//# sourceMappingURL=builder.js.map

package/dist/file-upload/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/file-upload/builder.ts"],"names":[],"mappings":"AAEA,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAEtD,SAAS,iBAAiB;IACxB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAC5B,OAAO,CAAC,GAAG,CAAC,uBAAuB;QACnC,wBAAwB,CACzB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC3D,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;IACrD,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACnD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC3D,IAAI,QAAQ;YAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAErD,MAAM,MAAM,GACV,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,IAAW,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,UAAU,CAC1B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,UAAU,EACjB,MAAM,CAAC,UAAU,CAClB,CAAC;QACF,MAAM,IAAI,GACR,OAAO,IAAI,KAAK,WAAW;YACzB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE;gBAChB,IAAI,EAAE,QAAQ,IAAI,0BAA0B;aAC7C,CAAC;YACJ,CAAC,CAAE,KAA6B,CAAC;QAErC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,UAAU,EAAE;gBACrC,cAAc,EAAE,QAAQ,IAAI,0BAA0B;aACvD;YACD,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,CAAC,MAAM,MAAM,IAAI,IAAI,QAAQ,CAAC,UAAU,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAGpD,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC"}

package/dist/file-upload/index.d.ts

@@ -0,0 +1,4 @@
+export type { FileUploadInput, FileUploadProvider, FileUploadResult, } from "./types.js";
+export { registerFileUploadProvider, unregisterFileUploadProvider, listFileUploadProviders, getActiveFileUploadProvider, uploadFile, } from "./registry.js";
+export { builderFileUploadProvider } from "./builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/file-upload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-upload/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/file-upload/index.js

@@ -0,0 +1,3 @@
+export { registerFileUploadProvider, unregisterFileUploadProvider, listFileUploadProviders, getActiveFileUploadProvider, uploadFile, } from "./registry.js";
+export { builderFileUploadProvider } from "./builder.js";
+//# sourceMappingURL=index.js.map

package/dist/file-upload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/file-upload/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/file-upload/registry.d.ts

@@ -0,0 +1,23 @@
+import type { FileUploadInput, FileUploadProvider, FileUploadResult } from "./types.js";
+/**
+ * Register a file upload provider. Call from a server plugin or app
+ * bootstrap. Idempotent per id — later calls with the same id replace.
+ */
+export declare function registerFileUploadProvider(provider: FileUploadProvider): void;
+export declare function unregisterFileUploadProvider(id: string): void;
+export declare function listFileUploadProviders(): FileUploadProvider[];
+/**
+ * Returns the first configured provider, checking user-registered ones first
+ * and falling back to the built-in Builder.io provider when its env is set.
+ * Returns `null` when nothing is configured — callers should then use the
+ * SQL fallback.
+ */
+export declare function getActiveFileUploadProvider(): FileUploadProvider | null;
+/**
+ * Upload a file via the active provider, or `null` if no provider is
+ * configured. Callers use `null` as the signal to fall back to SQL
+ * storage. On the first fallback we log a one-time warning because
+ * storing files in SQL is not optimal for production.
+ */
+export declare function uploadFile(input: FileUploadInput): Promise<FileUploadResult | null>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/file-upload/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/file-upload/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAE7E;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,uBAAuB,IAAI,kBAAkB,EAAE,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,kBAAkB,GAAG,IAAI,CAQvE;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAclC"}

package/dist/file-upload/registry.js

@@ -0,0 +1,52 @@
+import { builderFileUploadProvider } from "./builder.js";
+const providers = new Map();
+let warnedFallback = false;
+/**
+ * Register a file upload provider. Call from a server plugin or app
+ * bootstrap. Idempotent per id — later calls with the same id replace.
+ */
+export function registerFileUploadProvider(provider) {
+    providers.set(provider.id, provider);
+}
+export function unregisterFileUploadProvider(id) {
+    providers.delete(id);
+}
+export function listFileUploadProviders() {
+    return [...providers.values()];
+}
+/**
+ * Returns the first configured provider, checking user-registered ones first
+ * and falling back to the built-in Builder.io provider when its env is set.
+ * Returns `null` when nothing is configured — callers should then use the
+ * SQL fallback.
+ */
+export function getActiveFileUploadProvider() {
+    for (const provider of providers.values()) {
+        if (provider.isConfigured())
+            return provider;
+    }
+    if (builderFileUploadProvider.isConfigured()) {
+        return builderFileUploadProvider;
+    }
+    return null;
+}
+/**
+ * Upload a file via the active provider, or `null` if no provider is
+ * configured. Callers use `null` as the signal to fall back to SQL
+ * storage. On the first fallback we log a one-time warning because
+ * storing files in SQL is not optimal for production.
+ */
+export async function uploadFile(input) {
+    const provider = getActiveFileUploadProvider();
+    if (provider) {
+        return provider.upload(input);
+    }
+    if (!warnedFallback) {
+        warnedFallback = true;
+        console.warn("[agent-native] No file upload provider configured — storing files in SQL. " +
+            "Connect Builder.io in Settings → File uploads, or register a provider, " +
+            "for production-grade file storage.");
+    }
+    return null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/file-upload/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/file-upload/registry.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;AACxD,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAA4B;IACrE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,EAAU;IACrD,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,IAAI,QAAQ,CAAC,YAAY,EAAE;YAAE,OAAO,QAAQ,CAAC;IAC/C,CAAC;IACD,IAAI,yBAAyB,CAAC,YAAY,EAAE,EAAE,CAAC;QAC7C,OAAO,yBAAyB,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAsB;IAEtB,MAAM,QAAQ,GAAG,2BAA2B,EAAE,CAAC;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,CAAC,IAAI,CACV,4EAA4E;YAC1E,yEAAyE;YACzE,oCAAoC,CACvC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/file-upload/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * File upload framework primitive.
+ *
+ * Templates call `uploadFile()` to upload a file and get back a URL.
+ * The framework dispatches to whichever provider is registered (Builder.io
+ * built-in, or a user-supplied one). If no provider is active, it falls back
+ * to the SQL resources store — fine for dev, not recommended for production.
+ */
+export interface FileUploadInput {
+    /** File contents. */
+    data: Uint8Array | Buffer;
+    /** Original filename, used for extension/display. */
+    filename?: string;
+    /** MIME type, e.g. "image/png". */
+    mimeType?: string;
+    /** Optional owner email for per-user scoping in fallback storage. */
+    ownerEmail?: string;
+}
+export interface FileUploadResult {
+    /** Public URL where the file can be fetched. */
+    url: string;
+    /** Optional provider-specific id (e.g. resource id, Builder asset id). */
+    id?: string;
+    /** The provider that handled the upload. */
+    provider: string;
+}
+export interface FileUploadProvider {
+    /** Unique id, e.g. "builder", "s3". */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Returns true if this provider is currently configured (env vars etc.). */
+    isConfigured: () => boolean;
+    /** Upload a file and return a URL. Throw on failure. */
+    upload: (input: FileUploadInput) => Promise<FileUploadResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/file-upload/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/file-upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,wDAAwD;IACxD,MAAM,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC/D"}

package/dist/file-upload/types.js

@@ -0,0 +1,10 @@
+/**
+ * File upload framework primitive.
+ *
+ * Templates call `uploadFile()` to upload a file and get back a URL.
+ * The framework dispatches to whichever provider is registered (Builder.io
+ * built-in, or a user-supplied one). If no provider is active, it falls back
+ * to the SQL resources store — fine for dev, not recommended for production.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/file-upload/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/file-upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}