@agent-native/core 0.202.0 → 0.202.1-nightly-20261007011022

package/dist/onboarding/app-profile-data.js

@@ -0,0 +1,423 @@
+import { DESIGN_SYSTEM_INTELLIGENCE_CAPABILITY, EMBEDDINGS_CAPABILITY, LLM_CAPABILITY, WORKSPACE_SERVICES, workspaceServiceForCapability, } from "./workspace-services.js";
+const SYSTEM_ONE_CAPABILITY = {
+    id: "system-one",
+    label: "Decision model (Jev)",
+    required: false,
+    suggested: true,
+    builderIncluded: true,
+    keySummary: "Jev decision model key",
+    whyKey: "agentChat.onboarding.capability.systemOne.why",
+    why: "Jev is an optional decision model that helps choose relevant tools and skills before the agent's first model request.",
+};
+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 generation",
+                required: true,
+                builderIncluded: true,
+                keySummary: "Image generation",
+                labelKey: "agentChat.onboarding.capability.assetsImageGeneration.label",
+                keySummaryKey: "agentChat.onboarding.capability.assetsImageGeneration.label",
+                whyKey: "agentChat.onboarding.capability.assetsImageGeneration.why",
+                why: "Image generation is the core workflow for creating on-brand assets.",
+            },
+            {
+                id: "video-generation",
+                label: "Video generation",
+                required: false,
+                suggested: true,
+                builderIncluded: true,
+                keySummary: "Gemini API key",
+                labelKey: "agentChat.onboarding.capability.assetsVideoGeneration.label",
+                keySummaryKey: "agentChat.onboarding.capability.assetsVideoGeneration.keySummary",
+                whyKey: "agentChat.onboarding.capability.assetsVideoGeneration.why",
+                why: "Video generation is optional; the core Assets workflow is image generation.",
+            },
+            DESIGN_SYSTEM_INTELLIGENCE_CAPABILITY,
+            {
+                id: "file-storage",
+                label: "Media storage",
+                required: false,
+                suggested: true,
+                builderIncluded: true,
+                keySummary: "Media storage",
+                why: "Generated files need a durable place to live before they can be shared.",
+            },
+        ],
+    },
+    brain: {
+        appId: "brain",
+        appName: "Brain",
+        capabilities: [
+            LLM_CAPABILITY,
+            EMBEDDINGS_CAPABILITY,
+            {
+                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: "Object storage",
+                required: true,
+                builderIncluded: true,
+                keySummary: "Object storage",
+                labelKey: "agentChat.onboarding.capability.clipsObjectStorage.label",
+                keySummaryKey: "agentChat.onboarding.capability.clipsObjectStorage.label",
+                whyKey: "agentChat.onboarding.capability.clipsObjectStorage.why",
+                why: "Recorded videos need durable object storage before they can be played back or shared.",
+            },
+            {
+                id: "transcription",
+                label: "Transcription",
+                required: false,
+                builderIncluded: true,
+                keySummary: "Speech-to-text provider key",
+                keySummaryKey: "agentChat.onboarding.capability.clipsTranscription.keySummary",
+                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,
+            DESIGN_SYSTEM_INTELLIGENCE_CAPABILITY,
+            {
+                id: "image-generation",
+                label: "Image generation",
+                required: false,
+                suggested: true,
+                builderIncluded: true,
+                keySummary: "Image generation",
+                labelKey: "agentChat.onboarding.capability.assetsImageGeneration.label",
+                keySummaryKey: "agentChat.onboarding.capability.assetsImageGeneration.label",
+                whyKey: "agentChat.onboarding.capability.assetsImageGeneration.why",
+                why: "Image generation is the core workflow for creating on-brand assets.",
+            },
+            {
+                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: [
+            LLM_CAPABILITY,
+            {
+                id: "builder-executor",
+                label: "Builder executor",
+                required: true,
+                builderIncluded: true,
+                keySummary: "Use Builder.io 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.",
+            },
+        ],
+    },
+    mail: {
+        appId: "mail",
+        appName: "Mail",
+        capabilities: [
+            LLM_CAPABILITY,
+            {
+                id: "gmail",
+                label: "Gmail",
+                required: true,
+                builderIncluded: false,
+                satisfiedBySignIn: true,
+                keySummary: "Connect Gmail with OAuth",
+                why: "Mail uses the workspace's managed Google connection; no key is pasted here.",
+            },
+            {
+                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,
+            DESIGN_SYSTEM_INTELLIGENCE_CAPABILITY,
+            {
+                id: "image-generation",
+                label: "Image generation",
+                required: false,
+                suggested: true,
+                builderIncluded: true,
+                keySummary: "Image generation",
+                labelKey: "agentChat.onboarding.capability.assetsImageGeneration.label",
+                keySummaryKey: "agentChat.onboarding.capability.assetsImageGeneration.label",
+                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],
+};
+export function normalizeOnboardingAppId(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");
+}
+/**
+ * The app's setup profile: the shared workspace services first (see
+ * `WORKSPACE_SERVICES`), each tagged with its `service` id, then the app's
+ * own capabilities. A profile that declares a
+ * service's capability tailors its copy and can raise it to required or
+ * recommended, never lower it.
+ */
+export function getOnboardingAppProfileForId(appId) {
+    const resolvedId = normalizeOnboardingAppId(appId);
+    const profile = PROFILES[resolvedId] ?? FALLBACK_PROFILE;
+    const services = WORKSPACE_SERVICES.flatMap((service) => {
+        const declared = profile.capabilities.find((capability) => service.capabilityIds.includes(capability.id));
+        if (!declared && !service.everyApp)
+            return [];
+        const base = declared ?? service.capability;
+        const required = Boolean(declared?.required || service.capability.required);
+        const suggested = !required && Boolean(declared?.suggested || service.capability.suggested);
+        return [
+            {
+                ...base,
+                required,
+                suggested,
+                service: service.id,
+                ...(service.kind === "builder-only" ? { builderOnly: true } : {}),
+            },
+        ];
+    });
+    const appCapabilities = profile.capabilities.filter((capability) => !workspaceServiceForCapability(capability.id));
+    return {
+        ...profile,
+        capabilities: [
+            // Jev is part of the model setup, so it follows the AI model.
+            ...services.flatMap((capability) => capability.service === "model"
+                ? [capability, { ...SYSTEM_ONE_CAPABILITY }]
+                : [capability]),
+            ...appCapabilities.map((capability) => ({ ...capability })),
+        ],
+    };
+}

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

@@ -1,10 +1,4 @@
 import type { OnboardingAppProfile } from "./types.js";
+export { getOnboardingAppProfileForId } from "./app-profile-data.js";
 export declare function resolveOnboardingAppId(explicit?: string): string;
-/**
- * The app's setup profile: the shared workspace services first (see
- * `WORKSPACE_SERVICES`), each tagged with its `service` id, then the app's
- * own capabilities. A profile that declares a
- * service's capability tailors its copy and can raise it to required or
- * recommended, never lower it.
- */
 export declare function getOnboardingAppProfile(appId?: string): OnboardingAppProfile;