@growthub/cli 0.9.2 → 0.9.4

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/page.jsx

@@ -0,0 +1,117 @@
+import workspaceConfig from "../growthub.config.json";
+import { readAdapterConfig } from "@/lib/adapters/env";
+import { describeIntegrationAdapter } from "@/lib/adapters/integrations";
+import Link from "next/link";
+
+function Home() {
+  const adapterConfig = readAdapterConfig();
+  const integrationAdapter = describeIntegrationAdapter();
+  const canvas = workspaceConfig.canvas;
+  const dashboards = workspaceConfig.dashboards;
+  const widgetTypes = workspaceConfig.widgetTypes;
+
+  return <main className="workspace-builder">
+      <aside className="workspace-rail" aria-label="Workspace navigation">
+        <div className="workspace-brand">
+          <span className="workspace-mark">G</span>
+          <span>Growthub Workspace</span>
+        </div>
+        <nav className="workspace-nav">
+          <a className="active" href="#dashboards">Dashboards</a>
+          <a href="#canvas">Canvas</a>
+          <a href="#widgets">Widgets</a>
+          <a href="#bindings">Bindings</a>
+          <Link href="/settings/integrations">Integrations</Link>
+        </nav>
+        <div className="workspace-rail-status">
+          <span className="status-dot" />
+          {integrationAdapter.authority}
+        </div>
+      </aside>
+
+      <section className="workspace-surface">
+        <header className="workspace-toolbar">
+          <div>
+            <p>Official starter</p>
+            <h1>{workspaceConfig.name}</h1>
+          </div>
+          <div className="workspace-toolbar-actions">
+            <button type="button">New Dashboard</button>
+            <button type="button">Save</button>
+          </div>
+        </header>
+
+        <section className="workspace-table" id="dashboards" aria-label="Dashboards">
+          <div className="workspace-table-heading">
+            <strong>Dashboards</strong>
+            <span>{dashboards.length} template</span>
+          </div>
+          <div className="workspace-table-row workspace-table-head">
+            <span>Title</span>
+            <span>Created by</span>
+            <span>Last update</span>
+            <span>Status</span>
+          </div>
+          {dashboards.map((dashboard) => <div className="workspace-table-row" key={dashboard.id}>
+              <span>{dashboard.name}</span>
+              <span>{dashboard.createdBy}</span>
+              <span>{dashboard.updatedAt}</span>
+              <code>{dashboard.status}</code>
+            </div>)}
+        </section>
+
+        <section className="workspace-canvas" id="canvas" aria-label="Composable dashboard canvas">
+          <div className="workspace-tabs">
+            <button className="active" type="button">{canvas.name}</button>
+            <button type="button">New Tab</button>
+          </div>
+          <div className="workspace-grid" style={{ "--workspace-columns": canvas.layout.columns }}>
+            <button className="workspace-add-widget" type="button">
+              <span className="workspace-widget-icon" aria-hidden="true"><span /></span>
+              <strong>Add widget</strong>
+              <small>Click to add your first widget</small>
+            </button>
+            {Array.from({ length: 96 }).map((_, index) => <span aria-hidden="true" className="workspace-grid-cell" key={index} />)}
+            {canvas.widgets.map((widget) => <article className="workspace-widget-preview" key={widget.id} style={{
+              gridColumn: `${widget.position.x + 1} / span ${widget.position.w}`,
+              gridRow: `${widget.position.y + 1} / span ${widget.position.h}`
+            }}>
+                <span>{widget.kind}</span>
+                <strong>{widget.title}</strong>
+              </article>)}
+          </div>
+        </section>
+      </section>
+
+      <aside className="workspace-widget-panel" id="widgets" aria-label="Widget configuration">
+        <div className="workspace-panel-title">
+          <button type="button" aria-label="Close widget panel">x</button>
+          <strong>New widget</strong>
+        </div>
+        <section>
+          <p className="workspace-panel-label">Widget type</p>
+          <div className="workspace-widget-types">
+            {widgetTypes.map((widget) => <button type="button" key={widget.kind}>
+                <span>{widget.icon}</span>
+                {widget.label}
+              </button>)}
+          </div>
+        </section>
+        <section className="workspace-bindings" id="bindings">
+          <p className="workspace-panel-label">Config bindings</p>
+          {Object.entries(canvas.bindings).map(([key, value]) => <div key={key}>
+              <span>{key}</span>
+              <code>{String(value)}</code>
+            </div>)}
+          <div>
+            <span>integrationAdapter</span>
+            <code>{adapterConfig.integrationAdapter}</code>
+          </div>
+        </section>
+      </aside>
+    </main>;
+}
+
+export {
+  Home as default
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/app/settings/integrations/page.jsx

@@ -0,0 +1,105 @@
+import { readAdapterConfig } from "@/lib/adapters/env";
+import { describeIntegrationAdapter, listAgencyPortalIntegrations } from "@/lib/adapters/integrations";
+import { groupIntegrationsByLane } from "@/lib/domain/integrations";
+import { buildPortalWorkspace } from "@/lib/domain/portal";
+import { describeAuthAdapter } from "@/lib/adapters/auth";
+import { describePaymentAdapter } from "@/lib/adapters/payments";
+import { describePersistenceAdapter } from "@/lib/adapters/persistence";
+import Link from "next/link";
+async function IntegrationsSettingsPage() {
+  const config = readAdapterConfig();
+  const adapter = describeIntegrationAdapter();
+  const grouped = groupIntegrationsByLane(await listAgencyPortalIntegrations());
+  const workspace = buildPortalWorkspace({
+    config,
+    integrations: grouped,
+    adapters: {
+      persistence: describePersistenceAdapter(),
+      auth: describeAuthAdapter(),
+      payments: describePaymentAdapter(),
+      integrations: adapter
+    }
+  });
+  const rows = [
+    ...grouped.dataSources.map((item) => ({ ...item, primitiveGroup: "data-source" })),
+    ...grouped.workspaceIntegrations.map((item) => ({ ...item, primitiveGroup: "workspace-integration" }))
+  ];
+  return <main className="shell">
+      <aside className="sidebar">
+        <div className="brand">
+          <span className="brand-mark">{workspace.identity.mark}</span>
+          <span>{workspace.identity.label}</span>
+        </div>
+        <nav className="nav">
+          {workspace.navigation.map((item) => <Link className={item.href === "/settings/integrations" ? "active" : ""} key={item.href} href={item.href.startsWith("#") ? `/${item.href}` : item.href}>
+              {item.label}
+            </Link>)}
+        </nav>
+        <div className="sidebar-footer">
+          <span className="status-dot" />
+          {adapter.authority}
+        </div>
+      </aside>
+      <section className="main">
+        <div className="utility-bar">
+          <div>
+            <strong>{adapter.label}</strong>
+            <span>{workspace.identity.primitiveContract}</span>
+          </div>
+          <div className="utility-actions">
+            <span className="pill">{adapter.id}</span>
+            <span className="pill">{adapter.authority}</span>
+          </div>
+        </div>
+        <section className="primitive-grid summary" aria-label="Integration adapter primitives">
+          <article className="primitive-card">
+            <div className="primitive-card-top">
+              <p className="card-label">Authority</p>
+              <span className="status runtime-derived">{adapter.authority}</span>
+            </div>
+            <strong>{adapter.id}</strong>
+            <div className="primitive-meta">
+              {adapter.requiredEnv.map((key) => <code key={key}>{key}</code>)}
+            </div>
+          </article>
+          <article className="primitive-card">
+            <div className="primitive-card-top">
+              <p className="card-label">Data-source primitives</p>
+              <span className="status runtime-derived">{grouped.dataSources.length}</span>
+            </div>
+            <strong>{grouped.dataSources.filter((item) => item.isConnected).length}/{grouped.dataSources.length}</strong>
+            <div className="primitive-meta"><span>{config.reportingAdapter || "reporting-adapter"}</span></div>
+          </article>
+          <article className="primitive-card">
+            <div className="primitive-card-top">
+              <p className="card-label">Workspace primitives</p>
+              <span className="status runtime-derived">{grouped.workspaceIntegrations.length}</span>
+            </div>
+            <strong>{grouped.workspaceIntegrations.filter((item) => item.isConnected).length}/{grouped.workspaceIntegrations.length}</strong>
+            <div className="primitive-meta"><span>{config.integrationAdapter}</span></div>
+          </article>
+        </section>
+        <section className="integration-board">
+          {rows.map((item) => <article className="integration-card" key={item.id}>
+              <div className="integration-card-top">
+                <div className="provider-mark">{item.icon || item.label.slice(0, 1)}</div>
+                <div>
+                  <strong>{item.label}</strong>
+                  <p>{item.provider} / {item.objectType} / {item.primitiveGroup}</p>
+                </div>
+                <span className={`status ${item.status}`}>{item.status}</span>
+              </div>
+              <div className="integration-card-meta">
+                <span>{item.authPath}</span>
+                <span>{item.setupMode}</span>
+                <span>{item.authType}</span>
+                {item.secretEnvName ? <span>{item.secretEnvName}</span> : null}
+              </div>
+            </article>)}
+        </section>
+      </section>
+    </main>;
+}
+export {
+  IntegrationsSettingsPage as default
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/growthub.config.json

@@ -0,0 +1,53 @@
+{
+  "id": "workspace-builder-default",
+  "name": "Workspace Builder",
+  "description": "Default no-code composition for the official Growthub Custom Workspace Starter. The interface starts as a configurable dashboard-builder shell and can be customized by editing this file or by future governed UI controls.",
+  "capabilities": [
+    "dashboards",
+    "canvas",
+    "widgets",
+    "bindings",
+    "integrations",
+    "settings"
+  ],
+  "pipelines": [],
+  "integrations": [],
+  "dashboards": [
+    {
+      "id": "untitled-dashboard",
+      "name": "Untitled",
+      "createdBy": "Workspace owner",
+      "updatedAt": "new",
+      "status": "draft"
+    }
+  ],
+  "widgetTypes": [
+    { "kind": "chart", "label": "Chart", "icon": "C" },
+    { "kind": "view", "label": "View", "icon": "V" },
+    { "kind": "iframe", "label": "iFrame", "icon": "I" },
+    { "kind": "rich-text", "label": "Rich Text", "icon": "T" }
+  ],
+  "canvas": {
+    "id": "workspace-canvas",
+    "name": "Tab 1",
+    "scope": "workspace",
+    "layout": {
+      "columns": 12,
+      "rowHeight": 64,
+      "gap": 16,
+      "responsive": true
+    },
+    "widgets": [],
+    "bindings": {
+      "chatToCanvas": true,
+      "workflowOutputsToArtifacts": true,
+      "sessionContext": true,
+      "configDrivenCanvas": true
+    }
+  },
+  "provenance": {
+    "createdBy": "cli",
+    "mirrors": "growthub-agency-portal-starter-v1",
+    "note": "Shipped with growthub-custom-workspace-starter-v1; safe to edit inside a governed fork and validate through the starter export smoke path."
+  }
+}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/jsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./*"]
+    }
+  }
+}

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/auth/index.js

@@ -0,0 +1,21 @@
+import { readAdapterConfig } from "../env";
+function describeAuthAdapter() {
+  const { authAdapter } = readAdapterConfig();
+  if (authAdapter === "oidc") {
+    return {
+      id: "oidc",
+      requiredEnv: ["AUTH_SECRET", "AUTH_ISSUER", "AUTH_CLIENT_ID", "AUTH_CLIENT_SECRET"],
+      notes: ["Default portable auth contract for Vercel and local serverless use."]
+    };
+  }
+  if (authAdapter === "clerk") {
+    return { id: "clerk", requiredEnv: [], notes: ["Configure Clerk-specific env in the deployment target."] };
+  }
+  if (authAdapter === "authjs") {
+    return { id: "authjs", requiredEnv: ["AUTH_SECRET"], notes: ["Use Auth.js provider configuration in app code."] };
+  }
+  return { id: "provider-managed", requiredEnv: [], notes: ["Auth is managed outside the kit contract."] };
+}
+export {
+  describeAuthAdapter
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/env.js

@@ -0,0 +1,28 @@
+function readAdapterConfig() {
+  return {
+    deployTarget: "vercel",
+    dataAdapter: readEnum("AGENCY_PORTAL_DATA_ADAPTER", ["postgres", "qstash-kv", "provider-managed"], "provider-managed"),
+    authAdapter: readEnum("AGENCY_PORTAL_AUTH_ADAPTER", ["oidc", "clerk", "authjs", "provider-managed"], "provider-managed"),
+    paymentAdapter: readEnum("AGENCY_PORTAL_PAYMENT_ADAPTER", ["none", "stripe", "polar"], "none"),
+    integrationAdapter: readEnum("AGENCY_PORTAL_INTEGRATION_ADAPTER", ["growthub-bridge", "byo-api-key", "static"], "static"),
+    reportingAdapter: process.env.AGENCY_PORTAL_REPORTING_ADAPTER || void 0,
+    growthubBridge: {
+      baseUrl: process.env.GROWTHUB_BRIDGE_BASE_URL || void 0,
+      integrationsPath: process.env.GROWTHUB_BRIDGE_INTEGRATIONS_PATH || "/api/mcp/accounts",
+      userId: process.env.GROWTHUB_BRIDGE_USER_ID || void 0,
+      hasAccessToken: Boolean(process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN)
+    },
+    dataSources: {
+      hasWindsorApiKey: Boolean(process.env.WINDSOR_API_KEY)
+    }
+  };
+}
+function readEnum(key, allowed, fallback) {
+  const value = process.env[key];
+  if (!value) return fallback;
+  if (allowed.includes(value)) return value;
+  throw new Error(`${key} must be one of: ${allowed.join(", ")}`);
+}
+export {
+  readAdapterConfig
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/growthub-connection-normalizer.js

@@ -0,0 +1,95 @@
+const providerAliases = {
+  ga4: "google-analytics",
+  google_analytics: "google-analytics",
+  google_drive: "google-drive",
+  ghl: "go-high-level",
+  gohighlevel: "go-high-level",
+  meta: "meta-ads",
+  meta_ads: "meta-ads"
+};
+function normalizeProviderId(provider) {
+  const normalized = provider.trim().toLowerCase().replaceAll("_", "-");
+  return providerAliases[normalized] || normalized;
+}
+function isHostedRecord(row) {
+  return "provider" in row && ("ready" in row || "connectedAt" in row || "scopes" in row || "handle" in row);
+}
+function normalizeHostedIntegration(row) {
+  const provider = normalizeProviderId(row.provider);
+  const ready = row.ready !== false;
+  return {
+    id: provider,
+    provider,
+    label: row.label,
+    name: row.label,
+    status: ready ? "connected" : "needs-connection",
+    isConnected: ready,
+    isActive: ready,
+    authPath: "growthub-mcp-bridge",
+    setupMode: "hosted-authority",
+    connectionMetadata: {
+      source: "growthub-cli-profile",
+      connectedAt: row.connectedAt,
+      scopes: row.scopes,
+      handle: row.handle
+    }
+  };
+}
+function normalizeMcpAccount(account) {
+  const provider = normalizeProviderId(account.provider);
+  const isActive = account.isActive === true;
+  const isVerified = account.isVerified === true;
+  const isConnected = isActive;
+  return {
+    id: provider,
+    provider,
+    label: account.connectionName || void 0,
+    name: account.connectionName || void 0,
+    authType: normalizeConnectionType(account.connectionType),
+    status: isConnected ? "connected" : "needs-connection",
+    isConnected,
+    isActive,
+    connectionId: account.id,
+    authPath: "growthub-mcp-bridge",
+    setupMode: "hosted-authority",
+    connectionMetadata: {
+      source: "growthub-mcp-accounts",
+      accountId: account.id,
+      connectionName: account.connectionName,
+      connectionType: account.connectionType,
+      isVerified,
+      appSlug: account.appSlug,
+      createdAt: account.createdAt,
+      updatedAt: account.updatedAt,
+      metadata: account.metadata || void 0
+    }
+  };
+}
+function normalizeConnectionType(connectionType) {
+  if (connectionType === "api_token" || connectionType === "api_key") return "api_token";
+  if (connectionType === "webhook") return "webhook";
+  return "oauth_first_party";
+}
+function normalizeBridgeRow(row) {
+  if (isHostedRecord(row)) return normalizeHostedIntegration(row);
+  const provider = normalizeProviderId(row.provider || row.id || "");
+  return {
+    ...row,
+    id: row.id || provider,
+    provider
+  };
+}
+function normalizeGrowthubBridgePayload(payload) {
+  if (Array.isArray(payload)) {
+    return payload.map(normalizeBridgeRow);
+  }
+  return [
+    ...(payload.integrations || []).map(normalizeBridgeRow),
+    ...(payload.accounts || []).map(normalizeMcpAccount),
+    ...(payload.dataSources || []).map(normalizeBridgeRow),
+    ...(payload.workspaceIntegrations || []).map(normalizeBridgeRow)
+  ];
+}
+export {
+  normalizeGrowthubBridgePayload
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/integrations/index.js

@@ -0,0 +1,198 @@
+import { readAdapterConfig } from "@/lib/adapters/env";
+import {
+  agencyPortalIntegrationCatalog
+} from "@/lib/domain/integrations";
+import {
+  normalizeGrowthubBridgePayload
+} from "./growthub-connection-normalizer";
+function describeIntegrationAdapter() {
+  const config = readAdapterConfig();
+  if (config.integrationAdapter === "growthub-bridge") {
+    return {
+      id: "growthub-bridge",
+      label: "Growthub MCP bridge",
+      requiredEnv: ["GROWTHUB_BRIDGE_BASE_URL", "GROWTHUB_BRIDGE_ACCESS_TOKEN"],
+      authority: "growthub-gh-app"
+    };
+  }
+  if (config.integrationAdapter === "byo-api-key") {
+    return {
+      id: "byo-api-key",
+      label: "Bring your own API key",
+      requiredEnv: ["AGENCY_PORTAL_BYO_CONNECTIONS_JSON"],
+      authority: "workspace-env"
+    };
+  }
+  return {
+    id: "static",
+    label: "Static starter catalog",
+    requiredEnv: [],
+    authority: "local-catalog"
+  };
+}
+async function listAgencyPortalIntegrations() {
+  const config = readAdapterConfig();
+  if (config.integrationAdapter !== "growthub-bridge") {
+    if (config.integrationAdapter === "byo-api-key") {
+      return mergeBringYourOwnRows(readBringYourOwnRows());
+    }
+    return agencyPortalIntegrationCatalog;
+  }
+  if (!config.growthubBridge.baseUrl || !process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN) {
+    return agencyPortalIntegrationCatalog;
+  }
+  const url = new URL(config.growthubBridge.integrationsPath, config.growthubBridge.baseUrl);
+  const headers = {
+    accept: "application/json",
+    authorization: `Bearer ${process.env.GROWTHUB_BRIDGE_ACCESS_TOKEN}`
+  };
+  if (config.growthubBridge.userId) {
+    headers["x-user-id"] = config.growthubBridge.userId;
+  }
+  const response = await fetch(url, {
+    headers,
+    next: { revalidate: 30 }
+  });
+  if (!response.ok) {
+    return agencyPortalIntegrationCatalog;
+  }
+  const payload = await response.json();
+  const merged = mergeBridgeRows(normalizeGrowthubBridgePayload(payload));
+  return applyApiKeyOverlays(merged, config);
+}
+function applyApiKeyOverlays(integrations, config) {
+  if (!config.dataSources.hasWindsorApiKey) return integrations;
+  const windsorOverlay = {
+    status: "connected",
+    isConnected: true,
+    isActive: true,
+    authPath: "byo-api-key",
+    setupMode: "bring-your-own-key",
+    authType: "api_token",
+    category: "api_key",
+    secretEnvName: "WINDSOR_API_KEY",
+    connectionMetadata: { source: "workspace-env", secretEnvName: "WINDSOR_API_KEY" }
+  };
+  return integrations.map((item) => {
+    if (item.provider === "windsor-ai") return { ...item, ...windsorOverlay };
+    if (item.provider === "google-sheets") return { ...item, ...windsorOverlay, secretEnvName: undefined, connectionMetadata: { source: "windsor-blended-data" } };
+    return item;
+  });
+}
+function readBringYourOwnRows() {
+  const raw = process.env.AGENCY_PORTAL_BYO_CONNECTIONS_JSON;
+  const rows = [];
+  if (process.env.WINDSOR_API_KEY) {
+    rows.push({
+      id: "windsor-ai",
+      provider: "windsor-ai",
+      name: "Windsor AI",
+      label: "Windsor AI",
+      category: "api_key",
+      authType: "api_token",
+      status: "connected",
+      isConnected: true,
+      isActive: true,
+      authPath: "byo-api-key",
+      setupMode: "bring-your-own-key",
+      secretEnvName: "WINDSOR_API_KEY",
+      connectionMetadata: {
+        source: "workspace-env",
+        secretEnvName: "WINDSOR_API_KEY"
+      }
+    });
+  }
+  if (!raw) return rows;
+  try {
+    const parsed = JSON.parse(raw);
+    return [...rows, ...normalizeGrowthubBridgePayload(parsed)];
+  } catch {
+    return rows;
+  }
+}
+function mergeBringYourOwnRows(rows) {
+  const merged = mergeBridgeRows(rows);
+  return merged.map((item) => {
+    const row = rows.find((candidate) => {
+      const provider = candidate.provider || candidate.id;
+      return provider === item.provider || candidate.id === item.id;
+    });
+    if (!row) return item;
+    return {
+      ...item,
+      authPath: "byo-api-key",
+      setupMode: "bring-your-own-key",
+      secretEnvName: typeof row.secretEnvName === "string" ? row.secretEnvName : void 0,
+      status: row.status || "connected"
+    };
+  });
+}
+function mergeBridgeRows(rows) {
+  const seenProviders = /* @__PURE__ */ new Set();
+  const merged = agencyPortalIntegrationCatalog.map((catalogItem) => {
+    const row = rows.find((item) => {
+      const provider = item.provider || item.id;
+      return provider === catalogItem.provider || item.id === catalogItem.id;
+    });
+    if (!row) return catalogItem;
+    seenProviders.add(row.provider || row.id || catalogItem.provider);
+    return {
+      ...catalogItem,
+      label: row.label || row.name || catalogItem.label,
+      name: row.name || row.label || catalogItem.name,
+      icon: row.icon || catalogItem.icon,
+      description: row.description || catalogItem.description,
+      category: row.category || catalogItem.category,
+      authType: row.authType || catalogItem.authType,
+      isConnected: row.isConnected ?? (row.status === "connected" ? true : catalogItem.isConnected),
+      isActive: row.isActive ?? (row.status === "connected" ? true : catalogItem.isActive),
+      authPath: row.authPath || catalogItem.authPath,
+      setupMode: row.setupMode || catalogItem.setupMode,
+      status: row.status || (row.isConnected || row.isActive ? "connected" : catalogItem.status),
+      connectionId: row.connectionId,
+      accountId: row.accountId,
+      secretEnvName: row.secretEnvName,
+      connectionMetadata: row.connectionMetadata || row.metadata,
+      metadata: row.metadata || row.connectionMetadata
+    };
+  });
+  const discoveredRows = rows.filter((row) => {
+    const provider = row.provider || row.id;
+    if (!provider) return false;
+    if (seenProviders.has(provider)) return false;
+    return !agencyPortalIntegrationCatalog.some((item) => item.provider === provider || item.id === row.id);
+  });
+  return [...merged, ...discoveredRows.map(toDiscoveredIntegration)];
+}
+function toDiscoveredIntegration(row) {
+  const provider = row.provider || row.id || "unknown-provider";
+  const label = row.label || row.name || provider;
+  const isDataPipeline = ["windsor-ai", "google-sheets", "google-analytics", "shopify", "meta-ads"].includes(provider);
+  const isConnected = row.isConnected ?? row.status === "connected";
+  return {
+    id: row.id || provider,
+    label,
+    name: row.name || label,
+    icon: row.icon || label.slice(0, 1).toUpperCase(),
+    provider,
+    description: row.description || "Connected through the Growthub account bridge.",
+    category: row.category || "mcp_connector",
+    authType: row.authType || "oauth_first_party",
+    isConnected,
+    isActive: row.isActive ?? isConnected,
+    lane: isDataPipeline ? "data-source" : "workspace-integration",
+    objectType: isDataPipeline ? "data-pipeline" : "mcp-connection",
+    status: row.status || (isConnected ? "connected" : "needs-connection"),
+    authPath: row.authPath || "growthub-mcp-bridge",
+    setupMode: row.setupMode || "hosted-authority",
+    connectionId: row.connectionId,
+    accountId: row.accountId,
+    secretEnvName: row.secretEnvName,
+    connectionMetadata: row.connectionMetadata || row.metadata,
+    metadata: row.metadata || row.connectionMetadata
+  };
+}
+export {
+  describeIntegrationAdapter,
+  listAgencyPortalIntegrations
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/payments/index.js

@@ -0,0 +1,13 @@
+import { readAdapterConfig } from "../env";
+function describePaymentAdapter() {
+  const { paymentAdapter } = readAdapterConfig();
+  if (paymentAdapter === "none") return { id: "none", requiredEnv: [], enabled: false };
+  return {
+    id: paymentAdapter,
+    requiredEnv: ["PAYMENT_SECRET_KEY", "PAYMENT_WEBHOOK_SECRET"],
+    enabled: true
+  };
+}
+export {
+  describePaymentAdapter
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/persistence/index.js

@@ -0,0 +1,13 @@
+import { readAdapterConfig } from "../env";
+import { describePostgresAdapter } from "./postgres";
+import { describeProviderManagedAdapter } from "./provider-managed";
+import { describeQstashKvAdapter } from "./qstash-kv";
+function describePersistenceAdapter() {
+  const config = readAdapterConfig();
+  if (config.dataAdapter === "postgres") return describePostgresAdapter();
+  if (config.dataAdapter === "qstash-kv") return describeQstashKvAdapter();
+  return describeProviderManagedAdapter();
+}
+export {
+  describePersistenceAdapter
+};

package/assets/worker-kits/growthub-custom-workspace-starter-v1/apps/workspace/lib/adapters/persistence/postgres.js

@@ -0,0 +1,16 @@
+function describePostgresAdapter() {
+  return {
+    id: "postgres",
+    label: "Postgres",
+    requiredEnv: ["DATABASE_URL"],
+    mode: "sql",
+    notes: [
+      "Use any Postgres-compatible provider.",
+      "Keep provider-specific pooling, SSL, and migration tooling outside the kit contract.",
+      "Application repositories should depend on this descriptor, not a provider SDK directly."
+    ]
+  };
+}
+export {
+  describePostgresAdapter
+};