@agent-native/core 0.6.1 → 0.7.1

package/dist/onboarding/default-steps.js

@@ -0,0 +1,164 @@
+/**
+ * Default framework-level onboarding steps.
+ *
+ * Registered when `createOnboardingPlugin()` mounts (auto-mount or explicit).
+ * Templates can override any step by registering another step with the same
+ * `id` after these have been registered.
+ */
+import { registerOnboardingStep } from "./registry.js";
+/** Step 1 — an LLM must be reachable for the agent chat to work. */
+const llmStep = {
+    id: "llm",
+    order: 10,
+    required: true,
+    title: "Connect an AI engine",
+    description: "Agent-native needs an LLM to power the agent chat.",
+    methods: [
+        {
+            id: "anthropic-key",
+            kind: "form",
+            label: "Use your Anthropic API key",
+            description: "Paste a key — stored locally in your .env file.",
+            primary: true,
+            payload: {
+                writeScope: "workspace",
+                fields: [
+                    {
+                        key: "ANTHROPIC_API_KEY",
+                        label: "ANTHROPIC_API_KEY",
+                        placeholder: "sk-ant-...",
+                        secret: true,
+                    },
+                ],
+            },
+        },
+        {
+            id: "builder",
+            kind: "builder-cli-auth",
+            // TODO: expand scope to "llm" once the Builder LLM gateway ships so
+            // connecting Builder also provisions a managed model.
+            label: "Connect Builder",
+            description: "Unlocks LLM + browser automation + more. Free during beta.",
+            badge: "free",
+            payload: { scope: "browser" },
+        },
+    ],
+    isComplete: () => !!process.env.ANTHROPIC_API_KEY || !!process.env.BUILDER_PRIVATE_KEY,
+};
+/** Step 2 — where application data lives. SQLite default means non-blocking. */
+const databaseStep = {
+    id: "database",
+    order: 20,
+    required: false,
+    title: "Database",
+    description: "Where your app data lives.",
+    methods: [
+        {
+            id: "sqlite-default",
+            kind: "link",
+            label: "Use SQLite (default)",
+            description: "Zero setup, local dev only.",
+            primary: true,
+            payload: { url: "#" },
+        },
+        {
+            id: "postgres-url",
+            kind: "form",
+            label: "Use Postgres / Neon",
+            description: "Paste a DATABASE_URL for any SQL-compatible provider.",
+            payload: {
+                writeScope: "workspace",
+                fields: [
+                    {
+                        key: "DATABASE_URL",
+                        label: "DATABASE_URL",
+                        placeholder: "postgres://user:pass@host/db",
+                    },
+                ],
+            },
+        },
+    ],
+    // SQLite default means this step is always satisfied — never blocks setup.
+    isComplete: () => true,
+};
+/** Step 3 — how users sign in. Dev-mode keeps solo local workflows easy. */
+const authStep = {
+    id: "auth",
+    order: 30,
+    required: false,
+    title: "Authentication",
+    description: "How users sign in. Dev mode is fine for local work.",
+    methods: [
+        {
+            id: "local-dev",
+            kind: "link",
+            label: "Use local mode (dev)",
+            description: "Solo dev with no login step.",
+            primary: true,
+            payload: { url: "#" },
+        },
+        {
+            id: "better-auth-google",
+            kind: "form",
+            label: "Sign in with Google",
+            description: "Paste Google OAuth credentials (client ID + secret).",
+            payload: {
+                writeScope: "workspace",
+                fields: [
+                    { key: "GOOGLE_CLIENT_ID", label: "GOOGLE_CLIENT_ID" },
+                    {
+                        key: "GOOGLE_CLIENT_SECRET",
+                        label: "GOOGLE_CLIENT_SECRET",
+                        secret: true,
+                    },
+                ],
+            },
+        },
+    ],
+    isComplete: () => {
+        if (process.env.AUTH_MODE === "local")
+            return true;
+        if (process.env.ACCESS_TOKEN || process.env.ACCESS_TOKENS)
+            return true;
+        return !!(process.env.GOOGLE_CLIENT_ID && process.env.GOOGLE_CLIENT_SECRET);
+    },
+};
+/** Step 4 — where uploaded files (avatars, chat attachments) go. */
+const fileUploadStep = {
+    id: "file-upload",
+    order: 40,
+    required: false,
+    title: "File uploads",
+    description: "Where user-uploaded files live. SQL fallback works out of the box but isn't optimal for production.",
+    methods: [
+        {
+            id: "builder",
+            kind: "builder-cli-auth",
+            label: "Connect Builder.io",
+            description: "Uploads go to Builder's CDN. Free during beta.",
+            primary: true,
+            badge: "free",
+            payload: { scope: "browser" },
+        },
+        {
+            id: "custom-provider",
+            kind: "link",
+            label: "Use your own provider",
+            description: "Register a FileUploadProvider (S3, R2, etc.) that returns a URL.",
+            payload: { url: "https://www.builder.io/c/docs/upload-api" },
+        },
+    ],
+    isComplete: () => !!process.env.BUILDER_PRIVATE_KEY,
+};
+let registered = false;
+/** Idempotent. Safe to call from every plugin-mount call. */
+export function registerDefaultOnboardingSteps() {
+    if (registered)
+        return;
+    registered = true;
+    registerOnboardingStep(llmStep);
+    registerOnboardingStep(databaseStep);
+    registerOnboardingStep(authStep);
+    registerOnboardingStep(fileUploadStep);
+}
+//# sourceMappingURL=default-steps.js.map

package/dist/onboarding/default-steps.js.map

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

package/dist/onboarding/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Framework-level onboarding system.
+ *
+ * Templates register steps the agent sidebar should show as a setup checklist.
+ * The server auto-mounts `/_agent-native/onboarding/*` routes and the client
+ * hook polls them — see `@agent-native/core/client/onboarding`.
+ */
+export { registerOnboardingStep, listOnboardingSteps } from "./registry.js";
+export type { OnboardingStep, OnboardingMethod, OnboardingMethodBadge, OnboardingFormField, OnboardingStepStatus, } from "./types.js";
+export { createOnboardingPlugin, defaultOnboardingPlugin, type OnboardingPluginOptions, } from "./plugin.js";
+export { registerDefaultOnboardingSteps } from "./default-steps.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/onboarding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/onboarding/index.js

@@ -0,0 +1,11 @@
+/**
+ * Framework-level onboarding system.
+ *
+ * Templates register steps the agent sidebar should show as a setup checklist.
+ * The server auto-mounts `/_agent-native/onboarding/*` routes and the client
+ * hook polls them — see `@agent-native/core/client/onboarding`.
+ */
+export { registerOnboardingStep, listOnboardingSteps } from "./registry.js";
+export { createOnboardingPlugin, defaultOnboardingPlugin, } from "./plugin.js";
+export { registerDefaultOnboardingSteps } from "./default-steps.js";
+//# sourceMappingURL=index.js.map

package/dist/onboarding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQ5E,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/onboarding/plugin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Onboarding plugin — auto-mounts the `/_agent-native/onboarding/*` routes.
+ *
+ * Routes:
+ *   GET  /_agent-native/onboarding/steps              — list steps + completion
+ *   POST /_agent-native/onboarding/steps/:id/complete — manual override (marks complete)
+ *   POST /_agent-native/onboarding/dismiss            — dismiss the banner
+ *   GET  /_agent-native/onboarding/dismissed          — dismissed flag + allComplete
+ */
+type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
+export interface OnboardingPluginOptions {
+    /** Skip registering the built-in default steps (llm, database, auth). */
+    skipDefaultSteps?: boolean;
+}
+export declare function createOnboardingPlugin(options?: OnboardingPluginOptions): NitroPluginDef;
+/** Default plugin instance — mounted automatically when a template doesn't override. */
+export declare const defaultOnboardingPlugin: NitroPluginDef;
+export {};
+//# sourceMappingURL=plugin.d.ts.map

package/dist/onboarding/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/onboarding/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAM9D,MAAM,WAAW,uBAAuB;IACtC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAsDD,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,cAAc,CAoHhB;AAED,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,EAAE,cAAyC,CAAC"}

package/dist/onboarding/plugin.js

@@ -0,0 +1,147 @@
+/**
+ * Onboarding plugin — auto-mounts the `/_agent-native/onboarding/*` routes.
+ *
+ * Routes:
+ *   GET  /_agent-native/onboarding/steps              — list steps + completion
+ *   POST /_agent-native/onboarding/steps/:id/complete — manual override (marks complete)
+ *   POST /_agent-native/onboarding/dismiss            — dismiss the banner
+ *   GET  /_agent-native/onboarding/dismissed          — dismissed flag + allComplete
+ */
+import { defineEventHandler, getMethod, setResponseStatus, } from "h3";
+import { awaitBootstrap, getH3App, } from "../server/framework-request-handler.js";
+import { appStateGet, appStatePut } from "../application-state/store.js";
+import { getSession } from "../server/auth.js";
+import { listOnboardingSteps } from "./registry.js";
+import { registerDefaultOnboardingSteps } from "./default-steps.js";
+const ONBOARDING_PREFIX = "/_agent-native/onboarding";
+const OVERRIDE_KEY_PREFIX = "onboarding:override:";
+const DISMISSED_KEY = "onboarding:dismissed";
+/** Resolve the session id to use for application-state scoping. */
+async function resolveSessionId(event) {
+    const session = await getSession(event);
+    if (!session)
+        return "local";
+    if (session.email === "local@localhost")
+        return "local";
+    return session.email;
+}
+async function hasOverride(sessionId, stepId) {
+    const val = await appStateGet(sessionId, `${OVERRIDE_KEY_PREFIX}${stepId}`);
+    return !!(val && val.complete);
+}
+/**
+ * Serialise every registered onboarding step (awaiting `isComplete()`).
+ * Honours the per-session "manual override" flag in application-state.
+ */
+async function serializeSteps(sessionId) {
+    const steps = listOnboardingSteps();
+    const out = [];
+    for (const step of steps) {
+        let complete = false;
+        try {
+            complete = (await step.isComplete()) === true;
+        }
+        catch {
+            complete = false;
+        }
+        if (!complete) {
+            complete = await hasOverride(sessionId, step.id);
+        }
+        out.push({
+            id: step.id,
+            title: step.title,
+            description: step.description,
+            order: step.order,
+            required: step.required ?? false,
+            complete,
+            methods: step.methods,
+        });
+    }
+    return out;
+}
+function allRequiredComplete(statuses) {
+    return statuses.filter((s) => s.required).every((s) => s.complete);
+}
+export function createOnboardingPlugin(options = {}) {
+    return async (nitroApp) => {
+        await awaitBootstrap(nitroApp);
+        if (!options.skipDefaultSteps) {
+            registerDefaultOnboardingSteps();
+        }
+        // GET  /_agent-native/onboarding/steps              — list steps
+        // POST /_agent-native/onboarding/steps/:id/complete — manual override
+        //
+        // Mounting on `/steps` means the middleware wrapper strips that prefix,
+        // so this handler sees `/` for the list and `/<stepId>/complete` for the
+        // override.
+        getH3App(nitroApp).use(`${ONBOARDING_PREFIX}/steps`, defineEventHandler(async (event) => {
+            const method = getMethod(event);
+            const pathname = event.url?.pathname || "/";
+            const trimmed = pathname.replace(/^\/+/, "").replace(/\/+$/, "");
+            // List endpoint — GET /steps (pathname becomes "" or "/")
+            if (trimmed === "") {
+                if (method !== "GET") {
+                    setResponseStatus(event, 405);
+                    return { error: "Method not allowed" };
+                }
+                const sessionId = await resolveSessionId(event);
+                return serializeSteps(sessionId);
+            }
+            // Override endpoint — POST /steps/:id/complete
+            const [id, action] = trimmed.split("/");
+            if (action === "complete") {
+                if (method !== "POST") {
+                    setResponseStatus(event, 405);
+                    return { error: "Method not allowed" };
+                }
+                if (!id) {
+                    setResponseStatus(event, 400);
+                    return { error: "id required" };
+                }
+                const sessionId = await resolveSessionId(event);
+                await appStatePut(sessionId, `${OVERRIDE_KEY_PREFIX}${id}`, { complete: true }, { requestSource: "agent" });
+                return { ok: true, id };
+            }
+            // Unknown subroute — fall through to other middleware.
+            return;
+        }));
+        // POST /_agent-native/onboarding/dismiss
+        getH3App(nitroApp).use(`${ONBOARDING_PREFIX}/dismiss`, defineEventHandler(async (event) => {
+            if (getMethod(event) !== "POST") {
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            const sessionId = await resolveSessionId(event);
+            await appStatePut(sessionId, DISMISSED_KEY, { dismissed: true, at: new Date().toISOString() }, { requestSource: "agent" });
+            return { ok: true };
+        }));
+        // POST /_agent-native/onboarding/reopen — clear dismissed flag
+        getH3App(nitroApp).use(`${ONBOARDING_PREFIX}/reopen`, defineEventHandler(async (event) => {
+            if (getMethod(event) !== "POST") {
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            const sessionId = await resolveSessionId(event);
+            await appStatePut(sessionId, DISMISSED_KEY, { dismissed: false, at: new Date().toISOString() }, { requestSource: "agent" });
+            return { ok: true };
+        }));
+        // GET /_agent-native/onboarding/dismissed
+        getH3App(nitroApp).use(`${ONBOARDING_PREFIX}/dismissed`, defineEventHandler(async (event) => {
+            if (getMethod(event) !== "GET") {
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            const sessionId = await resolveSessionId(event);
+            const value = await appStateGet(sessionId, DISMISSED_KEY);
+            const dismissed = !!(value && value.dismissed);
+            const statuses = await serializeSteps(sessionId);
+            return {
+                dismissed,
+                allComplete: allRequiredComplete(statuses),
+            };
+        }));
+    };
+}
+/** Default plugin instance — mounted automatically when a template doesn't override. */
+export const defaultOnboardingPlugin = createOnboardingPlugin();
+//# sourceMappingURL=plugin.js.map

package/dist/onboarding/plugin.js.map

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

package/dist/onboarding/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * In-process registry of onboarding steps.
+ *
+ * Templates (or the framework itself) call `registerOnboardingStep` at module
+ * load time — typically from a server plugin. The onboarding HTTP routes read
+ * from this registry on every request so overrides and late-registered steps
+ * are picked up without a restart.
+ */
+import type { OnboardingStep } from "./types.js";
+/**
+ * Register (or override) an onboarding step.
+ *
+ * Subsequent registrations with the same `id` replace the previous definition
+ * — templates can override framework defaults this way.
+ */
+export declare function registerOnboardingStep(step: OnboardingStep): void;
+/**
+ * Return all registered onboarding steps, sorted by `order` ascending.
+ * Ties are broken by registration order (insertion order).
+ */
+export declare function listOnboardingSteps(): OnboardingStep[];
+/** Test helper — clears the registry between runs. Not part of the public API. */
+export declare function __resetOnboardingRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/onboarding/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/onboarding/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAcjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAEtD;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/onboarding/registry.js

@@ -0,0 +1,40 @@
+/**
+ * In-process registry of onboarding steps.
+ *
+ * Templates (or the framework itself) call `registerOnboardingStep` at module
+ * load time — typically from a server plugin. The onboarding HTTP routes read
+ * from this registry on every request so overrides and late-registered steps
+ * are picked up without a restart.
+ */
+const steps = new Map();
+/**
+ * Register (or override) an onboarding step.
+ *
+ * Subsequent registrations with the same `id` replace the previous definition
+ * — templates can override framework defaults this way.
+ */
+export function registerOnboardingStep(step) {
+    if (!step || typeof step.id !== "string" || !step.id) {
+        throw new Error("registerOnboardingStep: step.id is required");
+    }
+    if (steps.has(step.id)) {
+        // Override intentionally supported. Log only when DEBUG is on so template
+        // authors who deliberately override defaults don't see warnings.
+        if (process.env.DEBUG) {
+            console.log(`[agent-native] Overriding onboarding step "${step.id}" with new registration.`);
+        }
+    }
+    steps.set(step.id, step);
+}
+/**
+ * Return all registered onboarding steps, sorted by `order` ascending.
+ * Ties are broken by registration order (insertion order).
+ */
+export function listOnboardingSteps() {
+    return Array.from(steps.values()).sort((a, b) => a.order - b.order);
+}
+/** Test helper — clears the registry between runs. Not part of the public API. */
+export function __resetOnboardingRegistry() {
+    steps.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/onboarding/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/onboarding/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAoB;IACzD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACvB,0EAA0E;QAC1E,iEAAiE;QACjE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CACT,8CAA8C,IAAI,CAAC,EAAE,0BAA0B,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,yBAAyB;IACvC,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/onboarding/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Framework-level onboarding types.
+ *
+ * The onboarding system exposes a registry of "setup steps" that the agent
+ * sidebar renders as a checklist. Each step declares one or more `methods`
+ * by which the user can complete it (paste an API key, connect Builder, ask
+ * the agent to do it, etc.).
+ */
+export type OnboardingMethodBadge = "recommended" | "beta" | "free";
+/** Fields for a form-style onboarding method (key/value env-var entry). */
+export interface OnboardingFormField {
+    key: string;
+    label: string;
+    placeholder?: string;
+    secret?: boolean;
+}
+export interface OnboardingMethodBase {
+    id: string;
+    label: string;
+    description?: string;
+    badge?: OnboardingMethodBadge;
+    /** Highlight as the primary CTA for this step. */
+    primary?: boolean;
+}
+export type OnboardingMethod = (OnboardingMethodBase & {
+    kind: "link";
+    payload: {
+        url: string;
+        external?: boolean;
+    };
+}) | (OnboardingMethodBase & {
+    kind: "form";
+    payload: {
+        fields: OnboardingFormField[];
+        writeScope?: "workspace" | "app";
+    };
+}) | (OnboardingMethodBase & {
+    kind: "builder-cli-auth";
+    payload: {
+        scope: "browser";
+    };
+}) | (OnboardingMethodBase & {
+    kind: "agent-task";
+    payload: {
+        prompt: string;
+    };
+});
+export interface OnboardingStep {
+    /** Stable ID (e.g. "llm", "gmail"). */
+    id: string;
+    title: string;
+    description: string;
+    /** Lower = earlier. Default order slots: 10 (engine), 20 (db), 30 (auth). */
+    order: number;
+    /** Required steps block onboarding dismissal when incomplete. */
+    required?: boolean;
+    methods: OnboardingMethod[];
+    /** Resolver — called on every `GET /_agent-native/onboarding/steps` request. */
+    isComplete: () => boolean | Promise<boolean>;
+}
+/** Serialized shape returned by `GET /_agent-native/onboarding/steps`. */
+export interface OnboardingStepStatus {
+    id: string;
+    title: string;
+    description: string;
+    order: number;
+    required: boolean;
+    complete: boolean;
+    methods: OnboardingMethod[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/onboarding/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/onboarding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GACxB,CAAC,oBAAoB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9C,CAAC,GACF,CAAC,oBAAoB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,MAAM,EAAE,mBAAmB,EAAE,CAAC;QAC9B,UAAU,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;KAClC,CAAC;CACH,CAAC,GACF,CAAC,oBAAoB,GAAG;IACtB,IAAI,EAAE,kBAAkB,CAAC;IAEzB,OAAO,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC;CAC/B,CAAC,GACF,CAAC,oBAAoB,GAAG;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,CAAC,CAAC;AAEP,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,gFAAgF;IAChF,UAAU,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B"}

package/dist/onboarding/types.js

@@ -0,0 +1,10 @@
+/**
+ * Framework-level onboarding types.
+ *
+ * The onboarding system exposes a registry of "setup steps" that the agent
+ * sidebar renders as a checklist. Each step declares one or more `methods`
+ * by which the user can complete it (paste an API key, connect Builder, ask
+ * the agent to do it, etc.).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/onboarding/types.js.map

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

package/dist/resources/agents.d.ts

@@ -0,0 +1,4 @@
+import { type CustomAgentProfile } from "./metadata.js";
+export declare function listAccessibleCustomAgents(owner: string): Promise<CustomAgentProfile[]>;
+export declare function findAccessibleCustomAgent(owner: string, identifier: string): Promise<CustomAgentProfile | null>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/resources/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/resources/agents.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,eAAe,CAAC;AAEvB,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAa/B;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAiCpC"}

package/dist/resources/agents.js

@@ -0,0 +1,44 @@
+import { resourceGet, resourceGetByPath, resourceListAccessible, SHARED_OWNER, } from "./store.js";
+import { parseCustomAgentProfile, } from "./metadata.js";
+export async function listAccessibleCustomAgents(owner) {
+    const resources = await resourceListAccessible(owner, "agents/");
+    const profiles = await Promise.all(resources
+        .filter((resource) => resource.path.endsWith(".md"))
+        .map(async (resource) => {
+        const full = await resourceGet(resource.id);
+        if (!full)
+            return null;
+        return parseCustomAgentProfile(full.content, resource.path);
+    }));
+    return profiles.filter((profile) => !!profile);
+}
+export async function findAccessibleCustomAgent(owner, identifier) {
+    const trimmed = identifier.trim();
+    if (!trimmed)
+        return null;
+    const byPathCandidates = [
+        trimmed,
+        trimmed.endsWith(".md") ? trimmed : `agents/${trimmed}.md`,
+        trimmed.startsWith("agents/") ? trimmed : `agents/${trimmed}`,
+    ];
+    for (const path of byPathCandidates) {
+        const personal = await resourceGetByPath(owner, path);
+        if (personal) {
+            const profile = parseCustomAgentProfile(personal.content, personal.path);
+            if (profile)
+                return profile;
+        }
+        const shared = await resourceGetByPath(SHARED_OWNER, path);
+        if (shared) {
+            const profile = parseCustomAgentProfile(shared.content, shared.path);
+            if (profile)
+                return profile;
+        }
+    }
+    const lower = trimmed.toLowerCase();
+    const agents = await listAccessibleCustomAgents(owner);
+    return (agents.find((agent) => agent.id.toLowerCase() === lower ||
+        agent.name.toLowerCase() === lower ||
+        agent.path.toLowerCase() === lower) ?? null);
+}
+//# sourceMappingURL=agents.js.map

package/dist/resources/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/resources/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAAa;IAEb,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,SAAS;SACN,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACnD,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,uBAAuB,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CACL,CAAC;IAEF,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAiC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,KAAa,EACb,UAAkB;IAElB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,gBAAgB,GAAG;QACvB,OAAO;QACP,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,KAAK;QAC1D,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,EAAE;KAC9D,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACzE,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAC3D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YACrE,IAAI,OAAO;gBAAE,OAAO,OAAO,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,MAAM,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,CACL,MAAM,CAAC,IAAI,CACT,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK;QAChC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK;QAClC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CACrC,IAAI,IAAI,CACV,CAAC;AACJ,CAAC"}