@synergenius/flow-weaver 0.17.0 → 0.17.2

package/dist/deployment/types.d.ts

@@ -8,7 +8,7 @@ import type { ExecutionTraceEvent } from '../mcp/workflow-executor.js';
 /**
  * Source of a workflow execution request
  */
-export type ExecutionSource = 'cli' | 'http' | 'lambda' | 'vercel' | 'cloudflare';
+export type ExecutionSource = 'cli' | 'http' | (string & {});
 /**
  * Runtime environment
  */
@@ -133,51 +133,8 @@ export interface HttpInput {
     /** Request headers */
     headers: Record<string, string | string[] | undefined>;
 }
-/**
- * Input from AWS Lambda
- */
-export interface LambdaInput {
-    /** Raw event body (JSON string or parsed object) */
-    body?: string | Record<string, unknown>;
-    /** Path parameters */
-    pathParameters?: Record<string, string>;
-    /** Query string parameters */
-    queryStringParameters?: Record<string, string>;
-    /** Request headers */
-    headers?: Record<string, string>;
-    /** Request context */
-    requestContext?: {
-        requestId?: string;
-        stage?: string;
-    };
-}
-/**
- * Input from Vercel serverless function
- */
-export interface VercelInput {
-    /** Request method */
-    method: string;
-    /** Request body (already parsed) */
-    body: Record<string, unknown>;
-    /** Query parameters */
-    query: Record<string, string | string[]>;
-    /** Request headers */
-    headers: Record<string, string | string[]>;
-}
-/**
- * Input from Cloudflare Worker
- */
-export interface CloudflareInput {
-    /** Request object */
-    request: {
-        method: string;
-        url: string;
-        headers: Headers;
-        json: () => Promise<Record<string, unknown>>;
-    };
-}
 /**
  * Generic adapter input type
  */
-export type AdapterInput = CliInput | HttpInput | LambdaInput | VercelInput | CloudflareInput;
+export type AdapterInput = CliInput | HttpInput;
 //# sourceMappingURL=types.d.ts.map

package/dist/diagram/html-viewer.js

@@ -29,7 +29,7 @@ export function wrapSVGInHTML(svgContent, options = {}) {
     const { inner, viewBox } = prepareSvgContent(svgContent);
     const isDark = theme === 'dark';
     const bg = isDark ? '#202139' : '#f6f7ff';
-    const dotColor = isDark ? 'rgba(142, 158, 255, 0.6)' : 'rgba(84, 104, 255, 0.6)';
+    const dotColor = isDark ? 'rgba(142, 158, 255, 0.5)' : 'rgba(84, 104, 255, 0.45)';
     const surfaceMain = isDark ? '#1a1a2e' : '#ffffff';
     const borderSubtle = isDark ? '#313143' : '#e6e6e6';
     const textHigh = isDark ? '#e8e8ee' : '#1a1a2e';
@@ -96,15 +96,19 @@ path[data-source].port-hover { opacity: 1; }
 /* Node hover glow + draggable cursor */
 .nodes g[data-node-id] { cursor: grab; }
 .nodes g[data-node-id]:active { cursor: grabbing; }
-.nodes g[data-node-id]:hover > rect:first-of-type { filter: brightness(1.08); }
+.nodes g[data-node-id]:hover > rect:first-of-type {
+  filter: brightness(1.08) drop-shadow(0 0 6px ${isDark ? 'rgba(142,158,255,0.15)' : 'rgba(84,104,255,0.12)'});
+  transition: filter 0.15s ease;
+}
 
 /* Zoom controls */
 #controls {
   position: fixed; bottom: 16px; right: 16px;
   display: flex; align-items: center; gap: 2px;
-  background: ${surfaceMain}; border: 1px solid ${borderSubtle};
+  background: ${isDark ? 'rgba(26,26,46,0.85)' : 'rgba(255,255,255,0.85)'};
+  backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
+  border: 1px solid ${isDark ? 'rgba(142,158,255,0.12)' : 'rgba(84,104,255,0.1)'};
   border-radius: 8px; padding: 4px; z-index: 10;
-  box-shadow: 0 2px 8px rgba(0,0,0,0.2);
 }
 .ctrl-btn {
   display: flex; align-items: center; justify-content: center;
@@ -113,24 +117,26 @@ path[data-source].port-hover { opacity: 1; }
   font-size: 16px; font-weight: 600; cursor: pointer;
   transition: background 0.15s, color 0.15s;
 }
-.ctrl-btn:hover { background: ${surfaceHigh}; color: ${textHigh}; }
+.ctrl-btn:hover { background: ${isDark ? 'rgba(142,158,255,0.08)' : 'rgba(84,104,255,0.06)'}; color: ${textHigh}; }
 #zoom-label {
   font-size: 11px; font-family: 'SF Mono', 'Fira Code', monospace;
   color: ${textLow}; min-width: 36px; text-align: center;
 }
 
 /* Info panel */
+@keyframes panelSlideIn { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }
 #info-panel {
   position: fixed; bottom: 52px; left: 16px;
   max-width: 480px; min-width: 260px;
-  background: ${surfaceMain}; border: 1px solid ${borderSubtle};
-  border-radius: 8px; padding: 12px 16px;
+  background: ${isDark ? 'rgba(26,26,46,0.85)' : 'rgba(255,255,255,0.85)'};
+  backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
+  border: 1px solid ${isDark ? 'rgba(142,158,255,0.12)' : 'rgba(84,104,255,0.1)'};
+  border-radius: 8px; padding: 0;
   font-size: 13px; line-height: 1.5;
-  box-shadow: 0 2px 8px rgba(0,0,0,0.2);
   z-index: 10; display: none;
-  max-height: calc(100vh - 120px); overflow-y: auto;
+  max-height: calc(100vh - 120px); overflow: hidden;
 }
-#info-panel.visible { display: block; }
+#info-panel.visible { display: block; animation: panelSlideIn 0.2s ease-out; }
 #info-panel h3 {
   font-size: 14px; font-weight: 700; margin: 0;
   white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
@@ -139,10 +145,10 @@ path[data-source].port-hover { opacity: 1; }
 #info-panel .info-section { margin-bottom: 6px; }
 #info-panel .info-label { font-size: 11px; font-weight: 600; color: ${textLow}; text-transform: uppercase; letter-spacing: 0.5px; }
 #info-panel .info-value { color: ${textMed}; }
-#info-panel .port-list { list-style: none; padding: 0; }
-#info-panel .port-list li { padding: 1px 0; }
-#info-panel .port-list li::before { content: '\\2022'; margin-right: 6px; color: ${textLow}; }
-#info-panel .port-type { color: ${textLow}; font-size: 11px; margin-left: 4px; font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace; }
+#info-panel .port-list { list-style: none; padding: 0; display: flex; flex-direction: column; gap: 2px; }
+#info-panel .port-list li { padding: 2px 0; display: flex; align-items: center; gap: 6px; }
+#info-panel .port-list li::before { content: '\\2022'; color: ${textLow}; flex-shrink: 0; }
+#info-panel .port-type { color: ${textLow}; font-size: 11px; font-family: 'SF Mono', 'Fira Code', 'Consolas', monospace; }
 #info-panel pre {
   background: ${isDark ? '#161625' : '#f0f1fa'}; border: 1px solid ${borderSubtle};
   border-radius: 6px; padding: 10px; overflow-x: auto;
@@ -162,9 +168,11 @@ path[data-source].port-hover { opacity: 1; }
 
 /* Info panel header */
 #info-header {
-  display: flex; align-items: center; gap: 6px; margin-bottom: 6px;
+  display: flex; align-items: center; gap: 6px; padding: 12px 16px;
+  border-bottom: 1px solid ${isDark ? 'rgba(142,158,255,0.08)' : 'rgba(84,104,255,0.06)'};
 }
 #info-header h3 { flex: 1; margin-bottom: 0; }
+#info-body { padding: 12px 16px; overflow-y: auto; max-height: calc(100vh - 180px); }
 .panel-btn {
   display: flex; align-items: center; justify-content: center;
   width: 24px; height: 24px; border: none; border-radius: 4px;
@@ -174,16 +182,7 @@ path[data-source].port-hover { opacity: 1; }
 }
 .panel-btn:hover { background: ${surfaceHigh}; color: ${textHigh}; }
 
-/* Info panel transitions */
-#info-panel {
-  transition: left 0.3s cubic-bezier(0.4,0,0.2,1), bottom 0.3s cubic-bezier(0.4,0,0.2,1),
-              width 0.3s cubic-bezier(0.4,0,0.2,1), height 0.3s cubic-bezier(0.4,0,0.2,1),
-              max-width 0.3s cubic-bezier(0.4,0,0.2,1), max-height 0.3s cubic-bezier(0.4,0,0.2,1),
-              min-width 0.3s cubic-bezier(0.4,0,0.2,1), border-radius 0.3s cubic-bezier(0.4,0,0.2,1),
-              opacity 0.2s ease, transform 0.3s cubic-bezier(0.4,0,0.2,1);
-  transform: translateY(8px); opacity: 0;
-}
-#info-panel.visible { transform: translateY(0); opacity: 1; }
+/* Info panel fullscreen transitions */
 #info-panel.fullscreen {
   left: 16px; bottom: 16px; top: 16px; right: 16px;
   max-width: none; min-width: 0; width: auto; max-height: none;
@@ -206,20 +205,25 @@ path[data-source].port-hover { opacity: 1; }
 #branding {
   position: fixed; bottom: 16px; left: 16px;
   display: flex; align-items: center; gap: 6px;
-  background: ${surfaceMain}; border: 1px solid ${borderSubtle};
+  background: ${isDark ? 'rgba(26,26,46,0.85)' : 'rgba(255,255,255,0.85)'};
+  backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
+  border: 1px solid ${isDark ? 'rgba(142,158,255,0.12)' : 'rgba(84,104,255,0.1)'};
   border-radius: 8px; padding: 6px 12px;
   font-size: 12px; font-weight: 600; color: ${textMed};
   text-decoration: none; z-index: 9;
-  box-shadow: 0 2px 8px rgba(0,0,0,0.2);
   transition: color 0.15s, border-color 0.15s;
 }
 #branding:hover { color: ${textHigh}; border-color: ${textLow}; }
 
 /* Scroll hint */
+@keyframes hintFade { 0% { opacity: 1; } 80% { opacity: 1; } 100% { opacity: 0; } }
 #scroll-hint {
   position: fixed; top: 50%; left: 50%;
   transform: translate(-50%, -50%);
-  background: rgba(0,0,0,0.75); color: #fff;
+  background: ${isDark ? 'rgba(26,26,46,0.92)' : 'rgba(255,255,255,0.92)'};
+  backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
+  border: 1px solid ${isDark ? 'rgba(142,158,255,0.12)' : 'rgba(84,104,255,0.1)'};
+  color: ${textHigh};
   padding: 6px 14px; border-radius: 8px;
   font-size: 13px; pointer-events: none;
   z-index: 20; opacity: 0; transition: opacity 0.3s;
@@ -227,25 +231,54 @@ path[data-source].port-hover { opacity: 1; }
 #scroll-hint.visible { opacity: 1; }
 #scroll-hint kbd {
   display: inline-block; padding: 1px 5px;
-  border: 1px solid rgba(255,255,255,0.3);
+  border: 1px solid ${isDark ? 'rgba(255,255,255,0.15)' : 'rgba(0,0,0,0.15)'};
   border-radius: 3px; font-family: 'SF Mono', 'Fira Code', monospace;
-  font-size: 12px; background: rgba(255,255,255,0.1);
+  font-size: 12px; background: ${isDark ? 'rgba(255,255,255,0.06)' : 'rgba(0,0,0,0.04)'};
 }
 
 /* Studio nudge toast */
 #studio-hint {
   position: fixed; bottom: 60px; left: 50%;
   transform: translateX(-50%);
-  background: ${surfaceMain}; border: 1px solid ${borderSubtle};
+  background: ${isDark ? 'rgba(26,26,46,0.85)' : 'rgba(255,255,255,0.85)'};
+  backdrop-filter: blur(8px); -webkit-backdrop-filter: blur(8px);
+  border: 1px solid ${isDark ? 'rgba(142,158,255,0.12)' : 'rgba(84,104,255,0.1)'};
   padding: 8px 16px; border-radius: 8px;
   font-size: 13px; color: ${textMed};
-  box-shadow: 0 2px 8px rgba(0,0,0,0.2);
   z-index: 20; opacity: 0; transition: opacity 0.4s;
   pointer-events: none;
 }
 #studio-hint.visible { opacity: 1; pointer-events: auto; }
 #studio-hint a { color: ${brandAccent}; text-decoration: none; font-weight: 600; }
 #studio-hint a:hover { text-decoration: underline; }
+
+/* Reduced motion */
+@media (prefers-reduced-motion: reduce) {
+  .node-glow { animation: none; opacity: 0.35; stroke-width: 8; }
+  #info-panel { animation: none; }
+  * { transition-duration: 0s !important; }
+}
+
+/* Responsive: mobile */
+@media (max-width: 768px) {
+  #controls { bottom: 12px; right: 12px; padding: 3px; }
+  .ctrl-btn { width: 24px; height: 24px; font-size: 14px; }
+  #zoom-label { font-size: 10px; min-width: 30px; }
+  #branding { bottom: 12px; left: 12px; padding: 4px 8px; font-size: 11px; }
+  #studio-hint { max-width: 90vw; text-align: center; white-space: normal; }
+  #info-panel {
+    left: 0 !important; right: 0 !important; bottom: 0 !important;
+    max-width: none; min-width: 0; width: 100%;
+    border-radius: 12px 12px 0 0;
+    max-height: 60vh;
+  }
+  #info-panel::before {
+    content: ''; display: block; width: 32px; height: 4px;
+    background: ${isDark ? 'rgba(142,158,255,0.3)' : 'rgba(84,104,255,0.2)'};
+    border-radius: 2px; margin: 8px auto 4px;
+  }
+  #info-body { max-height: calc(60vh - 80px); }
+}
 </style>
 </head>
 <body>

package/dist/diagram/renderer.js

@@ -37,11 +37,14 @@ export function renderSVG(graph, options = {}) {
     parts.push(`  .port-label { font-size: 10px; font-weight: 600; fill: ${theme.labelColor}; }`);
     parts.push(`  .port-type-label { font-size: 10px; font-weight: 600; }`);
     parts.push(`</style>`);
-    // Defs (dot grid pattern + connection gradients)
+    // Defs (dot grid pattern + node shadow filter + connection gradients)
     parts.push(`<defs>`);
     parts.push(`  <pattern id="dot-grid" width="20" height="20" patternUnits="userSpaceOnUse">`);
-    parts.push(`    <circle cx="10" cy="10" r="1.5" fill="${theme.dotColor}" opacity="0.6"/>`);
+    parts.push(`    <circle cx="10" cy="10" r="1.5" fill="${theme.dotColor}" opacity="${theme.dotOpacity}"/>`);
     parts.push(`  </pattern>`);
+    parts.push(`  <filter id="node-shadow" x="-10%" y="-10%" width="130%" height="140%">`);
+    parts.push(`    <feDropShadow dx="0" dy="2" stdDeviation="4" flood-opacity="${theme.nodeShadowOpacity}" flood-color="#000"/>`);
+    parts.push(`  </filter>`);
     for (let i = 0; i < allConnections.length; i++) {
         const conn = allConnections[i];
         parts.push(`  <linearGradient id="conn-grad-${i}" x1="0%" y1="0%" x2="100%" y2="0%">`);
@@ -51,8 +54,8 @@ export function renderSVG(graph, options = {}) {
     }
     parts.push(`</defs>`);
     // Background
-    parts.push(`<rect width="${vbWidth}" height="${vbHeight}" fill="${theme.background}"/>`);
-    parts.push(`<rect width="${vbWidth}" height="${vbHeight}" fill="url(#dot-grid)"/>`);
+    parts.push(`<rect x="${vbX}" y="${vbY}" width="${vbWidth}" height="${vbHeight}" fill="${theme.background}"/>`);
+    parts.push(`<rect x="${vbX}" y="${vbY}" width="${vbWidth}" height="${vbHeight}" fill="url(#dot-grid)"/>`);
     // Connections
     parts.push(`<g class="connections">`);
     for (let i = 0; i < graph.connections.length; i++) {
@@ -111,7 +114,7 @@ function renderScopeConnection(parts, conn, allConnections, parentNodeId) {
 /** Render node body rect + icon */
 function renderNodeBody(parts, node, theme, indent) {
     const strokeColor = node.color !== '#334155' ? node.color : theme.nodeIconColor;
-    parts.push(`${indent}<rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="${BORDER_RADIUS}" fill="${theme.nodeFill}" stroke="${strokeColor}" stroke-width="2"/>`);
+    parts.push(`${indent}<rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="${BORDER_RADIUS}" fill="${theme.nodeFill}" stroke="${strokeColor}" stroke-width="2" filter="url(#node-shadow)"/>`);
     const iconPath = NODE_ICON_PATHS[node.icon] ?? NODE_ICON_PATHS.code;
     const iconColor = node.color !== '#334155' ? node.color : theme.nodeIconColor;
     const iconSize = 40;
@@ -125,7 +128,7 @@ function renderNode(node, theme, themeName, allConnections) {
     if (node.scopeChildren && node.scopeChildren.length > 0) {
         // Scoped node: body rect only (no icon), then scope internals
         const strokeColor = node.color !== '#334155' ? node.color : theme.nodeIconColor;
-        parts.push(`    <rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="${BORDER_RADIUS}" fill="${theme.nodeFill}" stroke="${strokeColor}" stroke-width="2"/>`);
+        parts.push(`    <rect x="${node.x}" y="${node.y}" width="${node.width}" height="${node.height}" rx="${BORDER_RADIUS}" fill="${theme.nodeFill}" stroke="${strokeColor}" stroke-width="2" filter="url(#node-shadow)"/>`);
         renderScopedContent(parts, node, theme, themeName, allConnections);
     }
     else {

package/dist/diagram/theme.js

@@ -50,6 +50,8 @@ const DARK_PALETTE = {
     labelBadgeBorder: '#313143', // color-surface-lowest = dark-shade-90
     nodeIconColor: '#a4beff', // secondary-dark-base (matches label color)
     scopeAreaStroke: '#5f5f6d', // color-border-subtle = dark-shade-70
+    nodeShadowOpacity: 0.15,
+    dotOpacity: 0.5,
 };
 const LIGHT_PALETTE = {
     background: '#f6f7ff', // color-brand-subtle-bg = primary-extended-tint-95
@@ -63,6 +65,8 @@ const LIGHT_PALETTE = {
     labelBadgeBorder: '#e6e6e6', // shade-10
     nodeIconColor: '#5468ff', // primary-base (light)
     scopeAreaStroke: '#cccccc', // color-border-default
+    nodeShadowOpacity: 0.08,
+    dotOpacity: 0.45,
 };
 export function getTheme(name) {
     return name === 'light' ? LIGHT_PALETTE : DARK_PALETTE;

package/dist/diagram/types.d.ts

@@ -69,5 +69,7 @@ export interface ThemePalette {
     labelBadgeBorder: string;
     nodeIconColor: string;
     scopeAreaStroke: string;
+    nodeShadowOpacity: number;
+    dotOpacity: number;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/doc-metadata/extractors/annotations.js

@@ -309,7 +309,7 @@ targetType     ::= "string" | "number" | "boolean" | "json" | "object"`,
         name: '@trigger',
         category: 'workflow',
         syntax: '@trigger event="name" | cron="expr"',
-        description: 'Declares an event or cron trigger for Inngest deployment. Can specify event, cron, or both.',
+        description: 'Declares an event or cron trigger for the workflow. Can specify event, cron, or both.',
         insertText: '@trigger event="${1:event/name}"',
         insertTextFormat: 'snippet',
         ebnf: 'triggerTag     ::= "@trigger" ( "event=" STRING | "cron=" STRING )*',
@@ -324,7 +324,7 @@ targetType     ::= "string" | "number" | "boolean" | "json" | "object"`,
         name: '@cancelOn',
         category: 'workflow',
         syntax: '@cancelOn event="name" [match="field"] [timeout="duration"]',
-        description: 'Cancels a running Inngest function when a specified event is received.',
+        description: 'Cancels a running workflow execution when a specified event is received.',
         insertText: '@cancelOn event="${1:event/name}"',
         insertTextFormat: 'snippet',
         ebnf: 'cancelOnTag    ::= "@cancelOn" "event=" STRING [ "match=" STRING ] [ "timeout=" STRING ]',
@@ -339,7 +339,7 @@ targetType     ::= "string" | "number" | "boolean" | "json" | "object"`,
         name: '@retries',
         category: 'workflow',
         syntax: '@retries N',
-        description: 'Sets the retry count for an Inngest function (overrides default of 3).',
+        description: 'Sets the retry count for the deployed function.',
         insertText: '@retries ${1:3}',
         insertTextFormat: 'snippet',
         ebnf: 'retriesTag     ::= "@retries" INTEGER',
@@ -350,7 +350,7 @@ targetType     ::= "string" | "number" | "boolean" | "json" | "object"`,
         name: '@timeout',
         category: 'workflow',
         syntax: '@timeout "duration"',
-        description: 'Sets the maximum execution time for an Inngest function.',
+        description: 'Sets the maximum execution time for the deployed function.',
         insertText: '@timeout "${1:30m}"',
         insertTextFormat: 'snippet',
         ebnf: 'timeoutTag     ::= "@timeout" STRING',
@@ -361,7 +361,7 @@ targetType     ::= "string" | "number" | "boolean" | "json" | "object"`,
         name: '@throttle',
         category: 'workflow',
         syntax: '@throttle limit=N [period="duration"]',
-        description: 'Limits concurrent executions of an Inngest function.',
+        description: 'Limits concurrent executions of the deployed function.',
         insertText: '@throttle limit=${1:10}',
         insertTextFormat: 'snippet',
         ebnf: 'throttleTag    ::= "@throttle" "limit=" INTEGER [ "period=" STRING ]',

package/dist/doc-metadata/extractors/cli-commands.js

@@ -206,7 +206,7 @@ export const CLI_COMMANDS = [
         syntax: 'flow-weaver export <file> -t <target> -o <path> [options]',
         description: 'Export workflow as serverless function',
         options: [
-            { flags: '-t, --target', arg: 'lambda|vercel|cloudflare', description: 'Target platform', required: true },
+            { flags: '-t, --target', arg: '<target>', description: 'Target platform (provided by installed packs)', required: true },
             { flags: '-o, --output', arg: '<path>', description: 'Output directory', required: true },
             { flags: '-w, --workflow', arg: '<name>', description: 'Specific workflow to export' },
             { flags: '-p, --production', description: 'Production mode', defaultValue: 'true' },

package/dist/doc-metadata/extractors/mcp-tools.js

@@ -637,9 +637,8 @@ export const MCP_TOOLS = [
             {
                 name: 'target',
                 type: 'string',
-                description: 'Target deployment platform',
+                description: 'Target deployment platform (provided by installed packs)',
                 required: true,
-                enum: ['lambda', 'vercel', 'cloudflare'],
             },
             {
                 name: 'outputDir',

package/dist/docs/index.d.ts

@@ -33,11 +33,12 @@ export interface SearchResult {
     relevance: number;
 }
 /**
- * List all available documentation topics.
+ * List all available documentation topics, including pack-contributed ones.
  */
 export declare function listTopics(): DocTopic[];
 /**
  * Read a single documentation topic.
+ * Checks core docs first, then falls back to pack-contributed topics.
  * @param slug - Topic slug (filename without .md)
  * @param compact - If true, return a compact LLM-friendly version
  */
@@ -51,4 +52,30 @@ export declare function readTopicStructured(slug: string): DocStructured | null;
  * Returns matching sections with context.
  */
 export declare function searchDocs(query: string): SearchResult[];
+/** Registered pack doc topics. Populated by registerPackDocTopics(). */
+declare const packDocTopics: Array<{
+    slug: string;
+    name: string;
+    description: string;
+    keywords: string[];
+    presets: string[];
+    filePath: string;
+}>;
+/**
+ * Register doc topics from installed pack manifests.
+ * These appear alongside core topics in listTopics() and readTopic().
+ */
+export declare function registerPackDocTopics(topics: Array<{
+    slug: string;
+    name: string;
+    description?: string;
+    keywords?: string[];
+    presets?: string[];
+    absoluteFile: string;
+}>): void;
+/**
+ * List pack-contributed doc topics. Used internally by listTopics() and readTopic().
+ */
+export declare function getPackDocTopics(): typeof packDocTopics;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/docs/index.js

@@ -86,44 +86,77 @@ function splitSections(body) {
 // Public API
 // ---------------------------------------------------------------------------
 /**
- * List all available documentation topics.
+ * List all available documentation topics, including pack-contributed ones.
  */
 export function listTopics() {
     const docsDir = getDocsDir();
-    if (!fs.existsSync(docsDir))
-        return [];
-    const files = fs.readdirSync(docsDir).filter((f) => f.endsWith('.md')).sort();
-    return files.map((file) => {
-        const raw = fs.readFileSync(path.join(docsDir, file), 'utf-8');
-        const { frontmatter } = parseFrontmatter(raw);
-        return {
-            slug: file.replace(/\.md$/, ''),
-            name: frontmatter.name,
-            description: frontmatter.description,
-            keywords: frontmatter.keywords,
-        };
-    });
+    const coreTopics = [];
+    if (fs.existsSync(docsDir)) {
+        const files = fs.readdirSync(docsDir).filter((f) => f.endsWith('.md')).sort();
+        for (const file of files) {
+            const raw = fs.readFileSync(path.join(docsDir, file), 'utf-8');
+            const { frontmatter } = parseFrontmatter(raw);
+            coreTopics.push({
+                slug: file.replace(/\.md$/, ''),
+                name: frontmatter.name,
+                description: frontmatter.description,
+                keywords: frontmatter.keywords,
+            });
+        }
+    }
+    // Append pack-contributed topics (no slug collisions with core)
+    const coreSlugs = new Set(coreTopics.map((t) => t.slug));
+    for (const packTopic of packDocTopics) {
+        if (!coreSlugs.has(packTopic.slug)) {
+            coreTopics.push({
+                slug: packTopic.slug,
+                name: packTopic.name,
+                description: packTopic.description,
+                keywords: packTopic.keywords,
+            });
+        }
+    }
+    return coreTopics;
 }
 /**
  * Read a single documentation topic.
+ * Checks core docs first, then falls back to pack-contributed topics.
  * @param slug - Topic slug (filename without .md)
  * @param compact - If true, return a compact LLM-friendly version
  */
 export function readTopic(slug, compact) {
+    // Try core docs first
     const docsDir = getDocsDir();
-    const filePath = path.join(docsDir, `${slug}.md`);
-    if (!fs.existsSync(filePath))
-        return null;
-    const raw = fs.readFileSync(filePath, 'utf-8');
-    const { frontmatter, body } = parseFrontmatter(raw);
-    const content = compact ? buildCompactContent(frontmatter, body) : body.trim();
-    return {
-        slug,
-        name: frontmatter.name,
-        description: frontmatter.description,
-        keywords: frontmatter.keywords,
-        content,
-    };
+    const coreFilePath = path.join(docsDir, `${slug}.md`);
+    if (fs.existsSync(coreFilePath)) {
+        const raw = fs.readFileSync(coreFilePath, 'utf-8');
+        const { frontmatter, body } = parseFrontmatter(raw);
+        const content = compact ? buildCompactContent(frontmatter, body) : body.trim();
+        return {
+            slug,
+            name: frontmatter.name,
+            description: frontmatter.description,
+            keywords: frontmatter.keywords,
+            content,
+        };
+    }
+    // Check pack-contributed topics
+    const packTopic = packDocTopics.find((t) => t.slug === slug);
+    if (packTopic && fs.existsSync(packTopic.filePath)) {
+        const raw = fs.readFileSync(packTopic.filePath, 'utf-8');
+        const { frontmatter, body } = parseFrontmatter(raw);
+        const content = compact
+            ? buildCompactContent({ name: frontmatter.name || packTopic.name, description: frontmatter.description || packTopic.description, keywords: frontmatter.keywords.length > 0 ? frontmatter.keywords : packTopic.keywords }, body)
+            : body.trim();
+        return {
+            slug,
+            name: frontmatter.name || packTopic.name,
+            description: frontmatter.description || packTopic.description,
+            keywords: frontmatter.keywords.length > 0 ? frontmatter.keywords : packTopic.keywords,
+            content,
+        };
+    }
+    return null;
 }
 /**
  * Read a topic and return structured sections (for JSON output).
@@ -157,7 +190,11 @@ export function searchDocs(query) {
     for (const topic of topics) {
         // Check keywords match
         const keywordMatch = topic.keywords.some((kw) => queryTerms.some((term) => kw.toLowerCase().includes(term)));
-        const filePath = path.join(docsDir, `${topic.slug}.md`);
+        // Resolve the file path: core topics live in docsDir, pack topics have their own path
+        const packTopic = packDocTopics.find((p) => p.slug === topic.slug);
+        const filePath = packTopic ? packTopic.filePath : path.join(docsDir, `${topic.slug}.md`);
+        if (!fs.existsSync(filePath))
+            continue;
         const raw = fs.readFileSync(filePath, 'utf-8');
         const { body } = parseFrontmatter(raw);
         const sections = splitSections(body);
@@ -207,6 +244,36 @@ export function searchDocs(query) {
     return results;
 }
 // ---------------------------------------------------------------------------
+// Pack-contributed doc topics
+// ---------------------------------------------------------------------------
+/** Registered pack doc topics. Populated by registerPackDocTopics(). */
+const packDocTopics = [];
+/**
+ * Register doc topics from installed pack manifests.
+ * These appear alongside core topics in listTopics() and readTopic().
+ */
+export function registerPackDocTopics(topics) {
+    for (const t of topics) {
+        // Avoid duplicates (same slug)
+        if (packDocTopics.some((p) => p.slug === t.slug))
+            continue;
+        packDocTopics.push({
+            slug: t.slug,
+            name: t.name,
+            description: t.description ?? '',
+            keywords: t.keywords ?? [],
+            presets: t.presets ?? [],
+            filePath: t.absoluteFile,
+        });
+    }
+}
+/**
+ * List pack-contributed doc topics. Used internally by listTopics() and readTopic().
+ */
+export function getPackDocTopics() {
+    return packDocTopics;
+}
+// ---------------------------------------------------------------------------
 // Compact mode builder
 // ---------------------------------------------------------------------------
 function buildCompactContent(frontmatter, body) {

package/dist/export/index.d.ts

@@ -6,8 +6,7 @@
  * Export target identifier.
  *
  * Widened to `string` so marketplace packs can register arbitrary targets
- * without modifying core. Well-known built-in names (when packs are installed):
- * 'lambda', 'vercel', 'cloudflare', 'inngest', 'github-actions', 'gitlab-ci'
+ * without modifying core.
  */
 export type ExportTarget = string;
 /**
@@ -34,7 +33,7 @@ export interface ExportOptions {
     workflows?: string[];
     /** Include API documentation routes */
     includeDocs?: boolean;
-    /** Use deep generator with per-node Inngest steps for durability (inngest target only) */
+    /** Use deep generator with per-node durable steps (target-specific) */
     durableSteps?: boolean;
 }
 /**