@agent-native/core 0.136.5 → 0.137.0

package/dist/client/onboarding/use-onboarding.js

@@ -1,20 +1,31 @@
 import { useCallback, useEffect, useRef, useState } from "react";
+import { FIRST_RUN_ONBOARDING_COOKIE } from "../../shared/first-run-onboarding.js";
 import { agentNativePath } from "../api-path.js";
+function hasFirstRunCookie() {
+    if (typeof document === "undefined")
+        return false;
+    return document.cookie
+        .split(";")
+        .some((part) => part.trim().startsWith(`${FIRST_RUN_ONBOARDING_COOKIE}=`));
+}
 export function useOnboarding(options = {}) {
     const preview = options.preview === true;
     const [steps, setSteps] = useState([]);
+    const [profile, setProfile] = useState(null);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState(null);
     const [dismissed, setDismissed] = useState(false);
+    const [firstRun, setFirstRun] = useState(hasFirstRunCookie);
     const mountedRef = useRef(true);
     const fetchAll = useCallback(async () => {
         try {
             const stepsUrl = agentNativePath(preview
                 ? "/_agent-native/onboarding/steps?preview=1"
                 : "/_agent-native/onboarding/steps");
-            const [stepsRes, dismissRes] = await Promise.all([
+            const [stepsRes, dismissRes, profileRes] = await Promise.all([
                 fetch(stepsUrl),
                 fetch(agentNativePath("/_agent-native/onboarding/dismissed")),
+                fetch(agentNativePath("/_agent-native/onboarding/profile")),
             ]);
             if (!mountedRef.current)
                 return;
@@ -23,6 +34,10 @@ export function useOnboarding(options = {}) {
             }
             const stepsData = await stepsRes.json();
             setSteps(stepsData);
+            if (!profileRes.ok) {
+                throw new Error(`profile: ${profileRes.status}`);
+            }
+            setProfile((await profileRes.json()));
             if (dismissRes.ok) {
                 const d = (await dismissRes.json());
                 setDismissed(!!d.dismissed);
@@ -83,6 +98,19 @@ export function useOnboarding(options = {}) {
         });
         await fetchAll();
     }, [fetchAll]);
+    const completeFirstRun = useCallback(async () => {
+        const response = await fetch(agentNativePath("/_agent-native/onboarding/first-run/complete"), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: "{}",
+        });
+        if (!response.ok) {
+            setError(`first-run completion: ${response.status}`);
+            return;
+        }
+        setFirstRun(false);
+        await fetchAll();
+    }, [fetchAll]);
     const totalCount = steps.length;
     const completeCount = steps.filter((s) => s.complete).length;
     const allComplete = steps.filter((s) => s.required).every((s) => s.complete);
@@ -91,6 +119,7 @@ export function useOnboarding(options = {}) {
         null;
     return {
         steps,
+        profile,
         loading,
         error,
         currentStepId,
@@ -102,6 +131,8 @@ export function useOnboarding(options = {}) {
         complete,
         dismiss,
         reopen,
+        firstRun,
+        completeFirstRun,
     };
 }
 //# sourceMappingURL=use-onboarding.js.map

package/dist/client/route-state.js

@@ -1,6 +1,7 @@
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLocation, useNavigate, } from "react-router";
+import { isWorkspaceAppPath } from "./api-path.js";
 import { deleteClientAppState, readClientAppState, setClientAppState, } from "./application-state.js";
 import { navigateWithAgentChatViewTransition, } from "./chat-view-transition.js";
 const SAFE_BROWSER_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;
@@ -207,6 +208,15 @@ export function useAgentRouteState(options) {
             const resolvedOptions = typeof navigateOptions === "function"
                 ? navigateOptions(command)
                 : navigateOptions;
+            if (isWorkspaceAppPath(path)) {
+                if (resolvedOptions?.replace) {
+                    window.location.replace(path);
+                }
+                else {
+                    window.location.assign(path);
+                }
+                return;
+            }
             const transitionOptions = resolveAgentChatViewTransitionOption(options.agentChatViewTransition, command, path);
             const runNavigate = () => navigate(path, resolvedOptions);
             if (transitionOptions) {

package/dist/connections/catalog.d.ts

@@ -1,5 +1,5 @@
 export type WorkspaceConnectionCapability = "search" | "import" | "messages" | "meetings" | "crm" | "code" | "docs";
-export type WorkspaceConnectionTemplateUse = "analytics" | "brain" | "calendar" | "clips" | "content" | "crm" | "design" | "dispatch" | "forms" | "mail" | "slides";
+export type WorkspaceConnectionTemplateUse = "analytics" | "brain" | "calendar" | "clips" | "content" | "crm" | "design" | "dispatch" | "factory" | "forms" | "mail" | "slides";
 export type WorkspaceConnectionProviderId = "slack" | "github" | "figma" | "notion" | "gmail" | "google_drive" | "hubspot" | "salesforce" | "jira" | "sentry" | "granola" | "clips" | "generic";
 export interface WorkspaceConnectionCredentialKey {
     key: string;
@@ -39,7 +39,7 @@ export declare const WORKSPACE_CONNECTION_PROVIDERS: readonly [{
         readonly required: true;
     }];
     readonly capabilities: readonly ["search", "import", "messages"];
-    readonly recommendedTemplateUses: readonly ["brain", "dispatch", "analytics"];
+    readonly recommendedTemplateUses: readonly ["brain", "dispatch", "analytics", "factory"];
 }, {
     readonly id: "github";
     readonly label: "GitHub";
@@ -57,7 +57,7 @@ export declare const WORKSPACE_CONNECTION_PROVIDERS: readonly [{
         readonly scopes: readonly ["repo", "read:org", "read:user", "user:email"];
     };
     readonly capabilities: readonly ["search", "import", "code", "docs"];
-    readonly recommendedTemplateUses: readonly ["brain", "analytics", "dispatch"];
+    readonly recommendedTemplateUses: readonly ["brain", "analytics", "dispatch", "factory"];
 }, {
     readonly id: "figma";
     readonly label: "Figma";
@@ -217,7 +217,7 @@ export declare const WORKSPACE_CONNECTION_PROVIDERS: readonly [{
         readonly scopes: readonly ["org:read", "project:read", "event:read", "team:read"];
     };
     readonly capabilities: readonly ["search", "import", "docs"];
-    readonly recommendedTemplateUses: readonly ["analytics", "brain", "dispatch"];
+    readonly recommendedTemplateUses: readonly ["analytics", "brain", "dispatch", "factory"];
 }, {
     readonly id: "granola";
     readonly label: "Granola";

package/dist/connections/catalog.js

@@ -15,7 +15,7 @@ export const WORKSPACE_CONNECTION_PROVIDERS = [
             },
         ],
         capabilities: ["search", "import", "messages"],
-        recommendedTemplateUses: ["brain", "dispatch", "analytics"],
+        recommendedTemplateUses: ["brain", "dispatch", "analytics", "factory"],
     }),
     defineWorkspaceConnectionProvider({
         id: "github",
@@ -36,7 +36,7 @@ export const WORKSPACE_CONNECTION_PROVIDERS = [
             scopes: ["repo", "read:org", "read:user", "user:email"],
         },
         capabilities: ["search", "import", "code", "docs"],
-        recommendedTemplateUses: ["brain", "analytics", "dispatch"],
+        recommendedTemplateUses: ["brain", "analytics", "dispatch", "factory"],
     }),
     defineWorkspaceConnectionProvider({
         id: "figma",
@@ -243,7 +243,7 @@ export const WORKSPACE_CONNECTION_PROVIDERS = [
             scopes: ["org:read", "project:read", "event:read", "team:read"],
         },
         capabilities: ["search", "import", "docs"],
-        recommendedTemplateUses: ["analytics", "brain", "dispatch"],
+        recommendedTemplateUses: ["analytics", "brain", "dispatch", "factory"],
     }),
     defineWorkspaceConnectionProvider({
         id: "granola",

package/dist/db/index.d.ts

@@ -22,7 +22,7 @@ export declare function createDb(config: DbConfig): Promise<(import("drizzle-orm
 export type DrizzleDb = Awaited<ReturnType<typeof createDb>>;
 export { createGetDb } from "./create-get-db.js";
 export { runMigrations, type MigrationEntry, type MigrationSql, } from "./migrations.js";
-export { getDbExec, createDbExec, getDialect, isLocalDatabase, isPostgres, intType, closeDbExec, type DbExec, type DbExecConfig, type DbExecQuery, type DbExecStatement, type Dialect, } from "./client.js";
+export { getDbExec, createDbExec, getDatabaseUrl, getDialect, isLocalDatabase, isPostgres, intType, closeDbExec, type DbExec, type DbExecConfig, type DbExecQuery, type DbExecStatement, type Dialect, } from "./client.js";
 export { table, text, integer, now } from "./schema.js";
 export { ensureAdditiveColumns, type EnsureAdditiveColumnsOptions, type EnsureAdditiveColumnsResult, type EnsureAdditiveColumnsLogger, } from "./ensure-additive-columns.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/db/index.js

@@ -21,7 +21,7 @@ export async function createDb(config) {
 }
 export { createGetDb } from "./create-get-db.js";
 export { runMigrations, } from "./migrations.js";
-export { getDbExec, createDbExec, getDialect, isLocalDatabase, isPostgres, intType, closeDbExec, } from "./client.js";
+export { getDbExec, createDbExec, getDatabaseUrl, getDialect, isLocalDatabase, isPostgres, intType, closeDbExec, } from "./client.js";
 export { table, text, integer, now } from "./schema.js";
 export { ensureAdditiveColumns, } from "./ensure-additive-columns.js";
 //# sourceMappingURL=index.js.map

package/dist/file-upload/actions/upload-image.d.ts

@@ -17,12 +17,12 @@ declare const _default: import("../../action.js").ActionDefinition<{
     id?: undefined;
     provider?: undefined;
 } | {
+    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
     url: string;
     id: string;
     provider: string;
-    error?: undefined;
 }>;
 export default _default;
 //# sourceMappingURL=upload-image.d.ts.map

package/dist/notifications/routes.d.ts

@@ -13,22 +13,22 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
+    count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
-    count?: undefined;
+    error?: undefined;
 } | {
+    count?: undefined;
     updated?: undefined;
     error: string;
     ok?: undefined;
-    count?: undefined;
 } | {
+    count?: undefined;
     updated?: undefined;
     ok: boolean;
     error?: undefined;
-    count?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/observability/routes.d.ts

@@ -41,16 +41,16 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-    error?: undefined;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    error?: undefined;
     ok?: undefined;
 } | {
     summary?: undefined;
@@ -59,10 +59,10 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     ok: boolean;
-    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/onboarding/app-profile.d.ts

@@ -0,0 +1,4 @@
+import type { OnboardingAppProfile } from "./types.js";
+export declare function resolveOnboardingAppId(explicit?: string): string;
+export declare function getOnboardingAppProfile(appId?: string): OnboardingAppProfile;
+//# sourceMappingURL=app-profile.d.ts.map

package/dist/onboarding/app-profile.js

@@ -0,0 +1,378 @@
+const LLM_CAPABILITY = {
+    id: "llm",
+    label: "AI model",
+    required: true,
+    builderIncluded: true,
+    keySummary: "One model key: Anthropic, OpenAI, Gemini, Groq, Mistral, or Cohere",
+    why: "The agent uses a language model to understand requests and produce answers.",
+};
+const PROFILES = {
+    analytics: {
+        appId: "analytics",
+        appName: "Analytics",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "data-sources",
+                label: "Data sources",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Connectors are added individually in Settings",
+                why: "Only needed for the services you want to query, such as GA4, Stripe, or HubSpot.",
+            },
+            {
+                id: "replay-storage",
+                label: "Replay storage",
+                required: false,
+                builderIncluded: true,
+                keySummary: "S3-compatible bucket, access key, and secret",
+                why: "Only needed when session replay is enabled so recordings can be stored.",
+            },
+        ],
+    },
+    assets: {
+        appId: "assets",
+        appName: "Assets",
+        capabilities: [
+            {
+                id: "media-generation",
+                label: "Image and video generation",
+                required: true,
+                builderIncluded: true,
+                keySummary: "Gemini for video, or OpenAI / Gemini for images",
+                why: "These providers create the images and videos requested in the app.",
+            },
+            {
+                id: "file-storage",
+                label: "Media storage",
+                required: true,
+                builderIncluded: true,
+                keySummary: "S3-compatible endpoint, bucket, access key, and secret",
+                why: "Generated files need a durable place to live before they can be shared.",
+            },
+        ],
+    },
+    brain: {
+        appId: "brain",
+        appName: "Brain",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "embeddings",
+                label: "Embeddings",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Gemini, Cohere, or Voyage key",
+                why: "Embeddings improve semantic search. Keyword search still works without them.",
+            },
+            {
+                id: "source-connections",
+                label: "Source connections",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Slack, Granola, or GitHub connection",
+                why: "Only needed for the sources you want to ingest into your knowledge base.",
+            },
+        ],
+    },
+    calendar: {
+        appId: "calendar",
+        appName: "Calendar",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "google-calendar",
+                label: "Google Calendar",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Connect Google Calendar with OAuth",
+                why: "Calendar access is an OAuth connection, not an API key to paste.",
+            },
+            {
+                id: "calendar-connectors",
+                label: "Other calendar connections",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Zoom, CRM, or enrichment connection",
+                why: "Only needed for the provider features you turn on.",
+            },
+        ],
+    },
+    chat: {
+        appId: "chat",
+        appName: "Chat",
+        capabilities: [LLM_CAPABILITY],
+    },
+    clips: {
+        appId: "clips",
+        appName: "Clips",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "video-storage",
+                label: "Video storage",
+                required: true,
+                builderIncluded: true,
+                keySummary: "S3 endpoint, bucket, access key, and secret",
+                why: "Recorded videos need durable storage before they can be played back or shared.",
+            },
+            {
+                id: "transcription",
+                label: "Transcription",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Groq or Google Speech key",
+                why: "Transcription powers captions, titles, summaries, and searchable chapters. Native capture still works without it.",
+            },
+        ],
+    },
+    content: {
+        appId: "content",
+        appName: "Content",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "media-storage",
+                label: "Media storage",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Builder file storage or S3-compatible storage",
+                why: "Only needed for documents that contain uploaded images, video, or audio.",
+            },
+            {
+                id: "notion",
+                label: "Notion",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Connect Notion with OAuth",
+                why: "Only needed if you want to import or sync workspace content from Notion.",
+            },
+        ],
+    },
+    crm: {
+        appId: "crm",
+        appName: "CRM",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "crm-connection",
+                label: "CRM connection",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Connect HubSpot or Salesforce",
+                why: "Connections are shared securely with CRM; no provider token needs to be pasted here.",
+            },
+        ],
+    },
+    design: {
+        appId: "design",
+        appName: "Design",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "assets-library",
+                label: "Assets library",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Connect the Assets app",
+                why: "Only needed when designs use managed images or other media assets.",
+            },
+            {
+                id: "figma",
+                label: "Figma",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Figma personal access token",
+                why: "Only needed to read or update files in Figma.",
+            },
+            {
+                id: "github",
+                label: "GitHub",
+                required: false,
+                builderIncluded: false,
+                keySummary: "GitHub token",
+                why: "Only needed when designs are connected to a repository.",
+            },
+        ],
+    },
+    dispatch: {
+        appId: "dispatch",
+        appName: "Dispatch",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "workspace-connections",
+                label: "Workspace connections",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Connect providers from the workspace registry",
+                why: "Dispatch uses shared connections so provider tokens never need to be pasted into this app.",
+            },
+        ],
+    },
+    factory: {
+        appId: "factory",
+        appName: "Factory",
+        capabilities: [
+            {
+                id: "builder-executor",
+                label: "Builder executor",
+                required: true,
+                builderIncluded: true,
+                keySummary: "Connect Builder for managed agent runs",
+                why: "The executor runs approved code and review workflows for Factory items.",
+            },
+            {
+                id: "triage-connections",
+                label: "Triage connections",
+                required: false,
+                builderIncluded: false,
+                keySummary: "GitHub, Slack, or Sentry connection",
+                why: "Only needed for the feedback source you want Factory to monitor.",
+            },
+        ],
+    },
+    forms: {
+        appId: "forms",
+        appName: "Forms",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "file-storage",
+                label: "File storage",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Builder file storage or S3-compatible storage",
+                why: "Text-only forms work without storage. Add it when a form accepts file uploads.",
+            },
+        ],
+    },
+    macros: {
+        appId: "macros",
+        appName: "Macros",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "transcription",
+                label: "Transcription",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Groq or Google Speech key",
+                why: "Voice input uses transcription. Text entry always works without it.",
+            },
+        ],
+    },
+    mail: {
+        appId: "mail",
+        appName: "Mail",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "gmail",
+                label: "Gmail",
+                required: true,
+                builderIncluded: false,
+                keySummary: "Google OAuth client ID and secret",
+                why: "Mail needs OAuth access to read, send, and organize the mailbox.",
+            },
+            {
+                id: "attachment-storage",
+                label: "Attachment storage",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Builder file storage or S3-compatible storage",
+                why: "Only needed when attachments need to be retained outside Gmail.",
+            },
+        ],
+    },
+    plan: {
+        appId: "plan",
+        appName: "Plan",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "plan-assets",
+                label: "Plan asset storage",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Builder file storage or S3-compatible storage",
+                why: "Only needed for screenshots and other visual plan assets.",
+            },
+            {
+                id: "google-sign-in",
+                label: "Google sign-in",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Google OAuth client ID and secret",
+                why: "Only needed when Google sign-in is enabled for the deployment.",
+            },
+        ],
+    },
+    slides: {
+        appId: "slides",
+        appName: "Slides",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "image-generation",
+                label: "Image generation",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Gemini or OpenAI key",
+                why: "Only needed when slides generate images instead of using uploaded assets.",
+            },
+            {
+                id: "reference-storage",
+                label: "Reference file storage",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Builder file storage or S3-compatible storage",
+                why: "Only needed for uploaded reference files and presentation assets.",
+            },
+            {
+                id: "google-docs",
+                label: "Google Docs",
+                required: false,
+                builderIncluded: false,
+                keySummary: "Connect Google Docs with OAuth",
+                why: "Only needed to import source material from Google Drive or Docs.",
+            },
+        ],
+    },
+    tasks: {
+        appId: "tasks",
+        appName: "Tasks",
+        capabilities: [LLM_CAPABILITY],
+    },
+};
+const FALLBACK_PROFILE = {
+    appId: "app",
+    appName: "Your app",
+    capabilities: [LLM_CAPABILITY],
+};
+function normalizeAppId(value) {
+    const normalized = value?.trim().toLowerCase() ?? "";
+    if (!normalized)
+        return "app";
+    return (normalized
+        .replace(/^@[^/]+\//, "")
+        .replace(/^agent-native-/, "")
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "") || "app");
+}
+export function resolveOnboardingAppId(explicit) {
+    return normalizeAppId(explicit ??
+        process.env.AGENT_NATIVE_APP_ID ??
+        process.env.APP_ID ??
+        process.env.npm_package_name);
+}
+export function getOnboardingAppProfile(appId) {
+    const resolvedId = resolveOnboardingAppId(appId);
+    const profile = PROFILES[resolvedId] ?? FALLBACK_PROFILE;
+    return {
+        ...profile,
+        capabilities: profile.capabilities.map((capability) => ({ ...capability })),
+    };
+}
+//# sourceMappingURL=app-profile.js.map

package/dist/onboarding/index.d.ts

@@ -6,7 +6,8 @@
  * 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 type { OnboardingStep, OnboardingMethod, OnboardingMethodBadge, OnboardingFormField, OnboardingStepStatus, OnboardingCapability, OnboardingAppProfile, } from "./types.js";
+export { getOnboardingAppProfile, resolveOnboardingAppId, } from "./app-profile.js";
 export { createOnboardingPlugin, defaultOnboardingPlugin, type OnboardingPluginOptions, } from "./plugin.js";
 export { registerDefaultOnboardingSteps } from "./default-steps.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/onboarding/index.js

@@ -6,6 +6,7 @@
  * hook polls them — see `@agent-native/core/client/onboarding`.
  */
 export { registerOnboardingStep, listOnboardingSteps } from "./registry.js";
+export { getOnboardingAppProfile, resolveOnboardingAppId, } from "./app-profile.js";
 export { createOnboardingPlugin, defaultOnboardingPlugin, } from "./plugin.js";
 export { registerDefaultOnboardingSteps } from "./default-steps.js";
 //# sourceMappingURL=index.js.map

package/dist/onboarding/plugin.d.ts

@@ -11,6 +11,8 @@ type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
 export interface OnboardingPluginOptions {
     /** Skip registering the built-in default steps (llm, database, auth). */
     skipDefaultSteps?: boolean;
+    /** App id used to select the app-specific first-run capability profile. */
+    appId?: string;
 }
 export declare function createOnboardingPlugin(options?: OnboardingPluginOptions): NitroPluginDef;
 /** Default plugin instance — mounted automatically when a template doesn't override. */