@epilot/cli 0.1.10 → 0.1.12

package/dist/{document-NT5JOJQV.js → document-5HB632XE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{email-settings-2M3WJTQS.js → email-settings-H7HQTDYE.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{email-template-F4PLBPPC.js → email-template-2DHZ3VKF.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{entity-32LKMZAU.js → entity-HED6QHG7.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{entity-mapping-OBCZDYQJ.js → entity-mapping-QP22B65Z.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{environments-H3TBCDQE.js → environments-6LLEIGWV.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{event-catalog-NVAPTZ4M.js → event-catalog-2ZCZTATY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/export-JA5N4JCJ.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import {
+  createAppApiClient,
+  log,
+  toManifest,
+  writeManifest
+} from "./chunk-CEP7S7X3.js";
+import "./chunk-RSA7K5HB.js";
+import "./chunk-PDMWUCWD.js";
+import "./chunk-7ZQ666ZQ.js";
+
+// src/commands/app/export.ts
+import { defineCommand } from "citty";
+import { resolve } from "path";
+var export_default = defineCommand({
+  meta: { name: "export", description: "Export an existing app as manifest.json" },
+  args: {
+    "app-id": { type: "string", description: "App ID to export", required: true },
+    version: { type: "string", description: "Version to export (default: latest)" },
+    output: { type: "string", alias: "o", description: "Output path (default: manifest.json)" },
+    token: { type: "string", alias: "t", description: "Bearer token" },
+    server: { type: "string", alias: "s", description: "Override server base URL" },
+    profile: { type: "string", description: "Use a named profile" }
+  },
+  run: async ({ args }) => {
+    const client = createAppApiClient({ token: args.token, server: args.server, profile: args.profile });
+    const appId = args["app-id"];
+    log.header(`Exporting app ${appId}...`);
+    const config = await client.getConfiguration(appId);
+    const targetVersion = args.version ?? config.latest_version;
+    const version = await client.getVersion(appId, targetVersion);
+    log.info(`Version: ${targetVersion}`);
+    const manifest = toManifest(config, version);
+    const outputPath = resolve(args.output ?? "manifest.json");
+    writeManifest(outputPath, manifest);
+    log.success(`Exported to ${outputPath}`);
+    log.info(`App: ${manifest.name}`);
+    log.info(`Components: ${manifest.components.length}`);
+    log.dim("Asset paths are placeholders. Update them to point to your local files.");
+  }
+});
+export {
+  export_default as default
+};

package/dist/{file-US2HR4SV.js → file-R6IIXOIZ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/{iban-7QUCOULB.js → iban-EQD2VROZ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-P5IZZW4Y.js";
+} from "./chunk-BYAEI4Z2.js";
 import "./chunk-RSA7K5HB.js";
 import "./chunk-PDMWUCWD.js";
 import "./chunk-IOLKUHUB.js";

package/dist/init-5KGNJEWF.js

@@ -0,0 +1,524 @@
+#!/usr/bin/env node
+import {
+  log,
+  writeManifest
+} from "./chunk-CEP7S7X3.js";
+import "./chunk-RSA7K5HB.js";
+import "./chunk-PDMWUCWD.js";
+import "./chunk-7ZQ666ZQ.js";
+
+// src/commands/app/init.ts
+import { defineCommand } from "citty";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { resolve, join } from "path";
+var init_default = defineCommand({
+  meta: { name: "init", description: "Scaffold a new epilot app project" },
+  args: {
+    name: { type: "positional", description: "App name (also used as directory name)", required: false }
+  },
+  run: ({ args }) => {
+    const name = args.name ?? "my-epilot-app";
+    const rootDir = resolve(name);
+    if (existsSync(rootDir)) {
+      log.error(`Directory "${name}" already exists.`);
+      process.exit(1);
+    }
+    mkdirSync(rootDir, { recursive: true });
+    mkdirSync(join(rootDir, "components"));
+    const manifest = {
+      $schema: "https://cdn.app.dev.sls.epilot.io/v1/schema.json",
+      manifest_version: 1,
+      name,
+      description: { de: "App description", en: "App description" },
+      category: "integration",
+      author: { company: "Your Company", name: "Your Name", email: "dev@example.com" },
+      components: []
+    };
+    writeManifest(join(rootDir, "manifest.json"), manifest);
+    writeFileSync(
+      join(rootDir, "package.json"),
+      `${JSON.stringify(
+        {
+          name,
+          version: "0.0.1",
+          private: true,
+          packageManager: "npm@10.9.2",
+          workspaces: ["components/*"],
+          scripts: {
+            build: "turbo build",
+            dev: "turbo dev",
+            lint: "turbo lint",
+            deploy: "epilot app deploy"
+          },
+          devDependencies: {
+            turbo: "^2"
+          }
+        },
+        null,
+        2
+      )}
+`
+    );
+    writeFileSync(
+      join(rootDir, "turbo.json"),
+      `${JSON.stringify(
+        {
+          $schema: "https://turbo.build/schema.json",
+          tasks: {
+            build: {
+              dependsOn: ["^build"],
+              outputs: ["dist/**"]
+            },
+            dev: {
+              cache: false,
+              persistent: true
+            },
+            lint: {}
+          }
+        },
+        null,
+        2
+      )}
+`
+    );
+    writeFileSync(join(rootDir, ".gitignore"), ["node_modules", "dist", ".turbo", ""].join("\n"));
+    writeFileSync(
+      join(rootDir, "components", "README.md"),
+      [
+        "# Components",
+        "",
+        "Each subdirectory is a component package in the monorepo.",
+        "",
+        "Add a new component with:",
+        "",
+        "```bash",
+        "epilot app add-component <name> --type CUSTOM_CAPABILITY",
+        "```",
+        "",
+        "Available component types:",
+        "",
+        "Code-based (have src/ and build step):",
+        "- `CUSTOM_FLOW_ACTION_SANDBOX` \u2014 Sandboxed flow action (JS runs in epilot)",
+        "- `CUSTOM_CAPABILITY` \u2014 Custom entity tab or group",
+        "- `CUSTOM_JOURNEY_BLOCK` \u2014 Custom journey builder block",
+        "- `CUSTOM_PAGE` \u2014 Custom navigation page",
+        "- `CUSTOM_PORTAL_BLOCK` \u2014 Custom portal widget",
+        "",
+        "Config-only (configuration.json):",
+        "- `CUSTOM_FLOW_ACTION_EXTERNAL` \u2014 External integration webhook",
+        "- `PORTAL_EXTENSION` \u2014 Portal extension hooks",
+        "- `EXTERNAL_PRODUCT_CATALOG` \u2014 External product catalog hooks",
+        ""
+      ].join("\n")
+    );
+    writeFileSync(
+      join(rootDir, "README.md"),
+      [
+        `# ${name}`,
+        "",
+        "An [epilot](https://epilot.cloud) app.",
+        "",
+        "## Getting started",
+        "",
+        "```bash",
+        "# Install dependencies",
+        "npm install",
+        "",
+        "# Add a component",
+        "epilot app add-component my-action --type CUSTOM_FLOW_ACTION",
+        "",
+        "# Build all components",
+        "npm run build",
+        "",
+        "# Validate the manifest",
+        "epilot app validate",
+        "",
+        "# Deploy (dry run)",
+        "epilot app deploy --dry-run",
+        "",
+        "# Deploy for real",
+        "epilot app deploy",
+        "```",
+        "",
+        "## Project structure",
+        "",
+        "```",
+        `${name}/`,
+        "\u251C\u2500\u2500 manifest.json          # App manifest (source of truth)",
+        "\u251C\u2500\u2500 package.json           # Monorepo root",
+        "\u251C\u2500\u2500 turbo.json             # Turborepo config",
+        "\u2514\u2500\u2500 components/",
+        "    \u2514\u2500\u2500 <component-name>/  # Each component is a package",
+        "        \u251C\u2500\u2500 package.json",
+        "        \u251C\u2500\u2500 src/",
+        "        \u2514\u2500\u2500 dist/",
+        "```",
+        ""
+      ].join("\n")
+    );
+    writeFileSync(
+      join(rootDir, "SKILL.md"),
+      `---
+name: epilot App Builder
+description: Build, deploy, and manage epilot Apps using the declarative manifest system and CLI. Covers all component types, project structure, and deployment workflow.
+---
+
+# epilot App Builder
+
+You are working inside an epilot App project. This is a monorepo managed by Turborepo with a declarative \`manifest.json\` at the root. Your job is to help build, configure, and deploy this app.
+
+## Project Structure
+
+\`\`\`
+<app-name>/
+\u251C\u2500\u2500 manifest.json            # Declarative app manifest (source of truth)
+\u251C\u2500\u2500 package.json             # npm workspaces monorepo root
+\u251C\u2500\u2500 turbo.json               # Turborepo task config
+\u251C\u2500\u2500 SKILL.md                 # This file (AI agent instructions)
+\u2514\u2500\u2500 components/              # Each component is a workspace package
+    \u251C\u2500\u2500 <component-name>/    # Code-based component
+    \u2502   \u251C\u2500\u2500 package.json
+    \u2502   \u251C\u2500\u2500 tsconfig.json
+    \u2502   \u251C\u2500\u2500 vite.config.ts
+    \u2502   \u251C\u2500\u2500 src/
+    \u2502   \u2514\u2500\u2500 dist/            # Build output (uploaded on deploy)
+    \u2514\u2500\u2500 <component-name>/    # Config-only component
+        \u2514\u2500\u2500 configuration.json
+\`\`\`
+
+## manifest.json Schema
+
+The manifest is the source of truth. The CLI reads it to create, update, and deploy the app.
+
+\`\`\`json
+{
+  "$schema": "https://cdn.app.sls.epilot.io/v1/schema.json",
+  "manifest_version": 1,
+  "app_id": "uuid (set automatically after first deploy)",
+  "name": "App Name",
+  "description": { "de": "German description (required)", "en": "English description" },
+  "category": "integration",
+  "author": { "company": "Company", "name": "Name", "email": "dev@example.com" },
+  "documentation_url": "https://docs.example.com",
+  "support_email": "support@example.com",
+  "pricing": { "pricing_type": "FREE" },
+  "notifications": { "email": "dev@example.com", "events": ["app.installed", "app.uninstalled"] },
+  "permissions": [
+    { "action": "entity:read", "resource": "contact" },
+    { "action": "entity:write", "resource": "order" }
+  ],
+  "blueprint": { "manifest_id": "uuid" },
+  "assets": { "logo": "./assets/logo.png" },
+  "components": []
+}
+\`\`\`
+
+**Important rules:**
+- \`description.de\` is always required (German)
+- \`app_id\` is set automatically after first \`epilot app deploy\` \u2014 never set it manually
+- \`_dir\` on components is a CLI-internal field mapping to the directory in \`components/\`
+- Component \`id\` must be a UUID
+- Option values of type \`secret\` are never stored in the manifest \u2014 they are set per-installation
+
+## CLI Commands
+
+All commands use \`epilot app <command>\`. Authentication uses stored credentials (\`epilot auth login\`) or \`--token\` / \`EPILOT_TOKEN\` env var.
+
+### \`epilot app init <name>\`
+Scaffold a new app project (monorepo with turbo, manifest.json, components/ dir).
+
+### \`epilot app add-component <name> --type <TYPE>\`
+Add a component. Downloads template from GitHub, adds entry to manifest.json.
+Run interactively (no args) to get a type selector and name prompt.
+
+### \`epilot app remove-component <name>\`
+Remove a component from manifest and delete its directory.
+Run interactively (no args) to get a component selector.
+
+### \`epilot app validate\`
+Validate manifest.json locally against the schema.
+
+### \`epilot app deploy [--dry-run] [--new-version] [--server <url>]\`
+Deploy the app:
+1. Creates app on first deploy (writes \`app_id\` back to manifest)
+2. Updates metadata (name, description, etc.)
+3. Uploads assets (bundles, zips) and resolves CDN URLs
+4. Upserts components with resolved URLs
+5. Deletes remote components not in the manifest (sync)
+
+**Important:** Components with missing build artifacts (bundle/zip) are skipped. Run \`npm run build\` first.
+
+The deploy command reads \`components/<dir>/configuration.json\` at deploy time and uses it as the component's configuration. This means you edit config in the component directory, not in manifest.json.
+
+### \`epilot app export --app-id <id> [-o manifest.json]\`
+Export an existing app from the API as a manifest.json.
+
+### \`epilot app versions [--app-id <id>]\`
+List all versions with visibility, review status, and component count.
+
+### \`epilot app review --technical-contact <email> --marketing-contact <email> [--demo-url <url>]\`
+Submit the latest version for public marketplace review.
+
+### \`epilot app api <operationId> [params]\`
+Raw access to App API operations (OpenAPI-based).
+
+## Component Types
+
+### Code-based components (have src/, build step, produce dist/)
+
+#### CUSTOM_JOURNEY_BLOCK
+A Web Component embedded in the epilot Journey Builder. Built as a single UMD bundle.
+
+**Stack:** React + Vite + \`@r2wc/react-to-web-component\` + \`@epilot/concorde-elements\`
+**Build output:** \`dist/bundle.js\` (single file, CSS injected by JS)
+**Manifest configuration:**
+\`\`\`json
+{
+  "component_type": "CUSTOM_JOURNEY_BLOCK",
+  "configuration": {
+    "component_url": "./components/<name>/dist/bundle.js",
+    "component_tag": "<name>",
+    "component_args": []
+  },
+  "assets": { "bundle": "./components/<name>/dist/bundle.js" }
+}
+\`\`\`
+
+The \`component_url\` is a local path in the manifest. On deploy, the CLI uploads the bundle and replaces it with the CDN URL automatically.
+
+**Key files:**
+- \`src/main.tsx\` \u2014 Wraps React app as Web Component using \`r2wc\`, defines the custom element tag
+- \`src/App.tsx\` \u2014 React component using \`@epilot/concorde-elements\` (Button, Card, Input)
+- \`vite.config.ts\` \u2014 UMD build with \`fileName: () => 'bundle.js'\`, CSS injected by JS, single file output
+
+**Component props (passed by the Journey runtime):**
+\`\`\`typescript
+type AppProps<T> = {
+  container: {
+    setValue: React.Dispatch<T>        // Set the block's value
+    value?: T                          // Current value
+    theme?: string                     // Stringified theme JSON
+    errors?: string                    // Validation errors
+    required?: boolean                 // Whether the block is required
+    args?: string                      // Extra args from Journey Builder config
+    subscribe: (blockId: string, fn: (state: unknown) => void) => () => void
+  }
+}
+\`\`\`
+
+#### CUSTOM_CAPABILITY
+A tab or group on entity detail pages. Uses App Bridge for communication with epilot.
+
+**Stack:** React + Vite + Tailwind + \`@epilot/volt-ui\` + \`@epilot/app-bridge\`
+**Build output:** \`dist/\` directory (zipped and uploaded on deploy)
+**Manifest configuration:**
+\`\`\`json
+{
+  "component_type": "CUSTOM_CAPABILITY",
+  "configuration": { "type": "tab", "allowed_schemas": ["contact", "order"] },
+  "surfaces": { "capability_config": { "app_url": "./components/<name>/dist/index.html" } },
+  "assets": { "zip": "./components/<name>/dist/" }
+}
+\`\`\`
+
+\`allowed_schemas\` controls which entity types show the tab. Empty array = all schemas.
+\`type\` can be \`"tab"\` or \`"group"\`.
+
+**Key files:**
+- \`src/main.tsx\` \u2014 Renders React app inside \`AppBridgeProvider\`
+- \`src/AppBridgeProvider.tsx\` \u2014 Initializes App Bridge, receives auth token from parent
+- \`src/AppBridgeContext.ts\` \u2014 React context for the bridge token
+- \`vite.config.ts\` \u2014 Standard Vite build with \`base: './'\` for relative paths
+
+#### CUSTOM_PAGE
+A full custom page in the epilot navigation sidebar. Same stack as CUSTOM_CAPABILITY.
+
+**Manifest configuration:**
+\`\`\`json
+{
+  "component_type": "CUSTOM_PAGE",
+  "configuration": { "slug": "<name>", "nav_label": "Page Title", "nav_icon": "layout" },
+  "surfaces": { "page": { "app_url": "./components/<name>/dist/index.html" } },
+  "assets": { "zip": "./components/<name>/dist/" }
+}
+\`\`\`
+
+Reserved slugs (cannot use): entity, settings, dashboard, apps.
+
+#### CUSTOM_PORTAL_BLOCK
+A widget in the epilot Customer Portal. Same stack as CUSTOM_CAPABILITY.
+
+**Manifest configuration:**
+\`\`\`json
+{
+  "component_type": "CUSTOM_PORTAL_BLOCK",
+  "configuration": {},
+  "surfaces": { "portal_block": { "app_url": "./components/<name>/dist/index.html" } },
+  "assets": { "zip": "./components/<name>/dist/" }
+}
+\`\`\`
+
+#### CUSTOM_FLOW_ACTION_SANDBOX
+JavaScript code that runs in epilot's sandboxed runtime when a flow action is triggered.
+
+**Stack:** TypeScript (compiled to JS)
+**Build output:** \`dist/handler.js\`
+**Manifest configuration:**
+\`\`\`json
+{
+  "component_type": "CUSTOM_FLOW_ACTION",
+  "configuration": {
+    "type": "sandbox",
+    "sandbox_settings": { "code": "// read from dist/ during deploy" }
+  }
+}
+\`\`\`
+
+**Restrictions:** Max 300KB. \`eval()\` and \`Function()\` constructor are not allowed.
+
+### Config-only components (no build step, just configuration.json)
+
+#### CUSTOM_FLOW_ACTION_EXTERNAL
+An external webhook called by epilot when a flow action triggers. No code to build.
+
+**configuration.json:**
+\`\`\`json
+{
+  "type": "external_integration",
+  "external_integration_settings": {
+    "url": "https://api.example.com/webhook",
+    "headers": { "Content-Type": "application/json" }
+  }
+}
+\`\`\`
+
+Set \`"wait_for_callback": true\` if epilot should wait for your endpoint to respond before continuing the flow.
+
+#### PORTAL_EXTENSION
+Hooks that customize Customer Portal behavior. No UI, just configuration.
+
+**configuration.json:**
+\`\`\`json
+{
+  "hooks": [
+    {
+      "type": "registration_identifiers_check",
+      "call": {
+        "method": "POST",
+        "url": "https://api.example.com/portal/register",
+        "headers": { "x-api-key": "{{api_key}}" }
+      }
+    }
+  ]
+}
+\`\`\`
+
+**Available hook types:** \`registration_identifiers_check\`, \`contract_identification\`, \`meter_reading_plausibility_check\`, \`consumption_data_retrieval\`, \`cost_data_retrieval\`, \`price_data_retrieval\`.
+
+Use \`{{option_key}}\` syntax in URLs/headers to interpolate secret option values set per-installation.
+
+#### EXTERNAL_PRODUCT_CATALOG
+Hooks that provide products from an external catalog to epilot Journeys.
+
+**configuration.json:**
+\`\`\`json
+{
+  "hooks": [
+    {
+      "id": "get-products",
+      "name": { "de": "Produkte abrufen", "en": "Get Products" },
+      "type": "products",
+      "call": {
+        "method": "POST",
+        "url": "https://api.example.com/products",
+        "headers": { "Content-Type": "application/json", "x-api-key": "{{api_key}}" }
+      }
+    }
+  ]
+}
+\`\`\`
+
+**Hook types:** \`products\`, \`product-recommendations\`.
+
+## Workflow: Building an App from Scratch
+
+\`\`\`bash
+# 1. Scaffold the project
+epilot app init my-app
+cd my-app
+
+# 2. Add components (interactive or with flags)
+epilot app add-component my-block --type CUSTOM_JOURNEY_BLOCK
+epilot app add-component my-tab --type CUSTOM_CAPABILITY
+epilot app add-component my-webhook --type CUSTOM_FLOW_ACTION_EXTERNAL
+
+# 3. Install dependencies
+npm install
+
+# 4. Develop components
+cd components/my-block && npm run dev   # local dev server
+cd components/my-tab && npm run dev     # local dev server
+
+# 5. Edit config-only components
+# Edit components/my-webhook/configuration.json directly
+
+# 6. Build all components
+npm run build
+
+# 7. Validate the manifest
+epilot app validate
+
+# 8. Deploy (dry run first)
+epilot app deploy --dry-run
+epilot app deploy
+
+# 9. Check versions
+epilot app versions
+
+# 10. Submit for marketplace review
+epilot app review --technical-contact dev@example.com --marketing-contact marketing@example.com
+\`\`\`
+
+## Key Concepts
+
+### Configuration override
+For every component with a \`_dir\` field, the CLI reads \`components/<dir>/configuration.json\` at deploy time and uses it as the component's configuration, overriding whatever is in manifest.json. This means: **edit configuration in the component directory, not in manifest.json.**
+
+### Asset upload flow
+1. CLI reads local paths from manifest (\`./components/x/dist/bundle.js\`)
+2. Requests a presigned S3 upload URL from the App API
+3. Uploads the file to S3
+4. Gets back the CDN URL
+5. Injects the CDN URL into the component configuration/surfaces before upserting
+
+### Permissions
+Apps can request permissions via the \`permissions\` array in the manifest. These are created as a role when the app is installed. Common actions: \`entity:read\`, \`entity:write\`, \`entity:delete\`, \`workflow:read\`, \`workflow:write\`.
+
+### Options
+Components can declare \`options\` \u2014 configuration values set by the installing organization. Types: \`text\`, \`number\`, \`boolean\`, \`secret\`. Secret values are encrypted and never included in the manifest. Use \`{{option_key}}\` in configuration URLs/headers for interpolation.
+
+### Descriptions
+All user-facing text (app name, component names, descriptions) must include a \`de\` (German) translation. \`en\` is optional but recommended.
+
+### App Bridge
+Components that render inside epilot (capabilities, pages, portal blocks) use \`@epilot/app-bridge\` to communicate with the parent window. The bridge provides an auth token and language setting. Always wrap your React app in an \`AppBridgeProvider\`.
+
+### Volt UI
+Use \`@epilot/volt-ui\` for UI components in App Bridge surfaces (capabilities, pages, portal blocks). It provides cards, buttons, forms, selectors, and more \u2014 consistent with epilot's design system.
+
+### Concorde Elements
+Use \`@epilot/concorde-elements\` for UI components in Journey Blocks. It provides buttons, cards, inputs \u2014 consistent with epilot's journey design system.
+`
+    );
+    log.success(`Created ${name}/`);
+    log.info("");
+    log.info(`  cd ${name}`);
+    log.info("  npm install");
+    log.info("  epilot app add-component my-action --type CUSTOM_FLOW_ACTION");
+    log.info("");
+    log.dim("See README.md for more details.");
+  }
+});
+export {
+  init_default as default
+};