create-omniflow-plugin 0.1.0 → 0.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 Interactive CLI scaffolder for [OmniFlow](https://github.com/agnistack/omniflow) plugins.
 
-Generates a ready-to-build Gradle project with a Java ingestor, optional Next.js micro UI, and all the wiring needed to upload the plugin as a JAR to a running OmniFlow backend.
+Generates a ready-to-build Gradle project with a Java ingestor, optional AI tools (exposed to OmniFlow AI chat), optional webhook action, optional Next.js micro UI, and all the wiring needed to upload the plugin as a JAR to a running OmniFlow backend.
 
 ## Usage
 
@@ -30,9 +30,11 @@ The CLI will ask a few questions and scaffold a new directory named after your p
 | Description | Short description of what the plugin ingests |
 | Author | Your name or organisation |
 | Java base package | Root Java package (e.g. `io.github.acme.plugins.myingestor`) |
-| Ingestor type key | Used in API paths — `/api/ingest/{type}` |
+| Ingestor type key | Used in API paths — `/api/v1/ingest/{type}` |
+| Include AI tool? | Scaffold a `PluginTool` that exposes data to OmniFlow AI chat |
+| Include webhook action? | Scaffold a `PluginAction` dispatched from OmniFlow scripts |
 | Include Next.js UI? | Whether to scaffold a micro frontend |
-| OmniFlow plugin-api version | Version of `omniflow-plugin-api` to depend on |
+| OmniFlow plugin-api version | Version of `omniflow-plugin-api` to depend on (default: `0.1`) |
 | OmniFlow API base URL | Backend URL for local UI dev (e.g. `http://localhost:8080`) |
 
 ## What gets generated
@@ -43,9 +45,14 @@ The CLI will ask a few questions and scaffold a new directory named after your p
 ├── settings.gradle
 ├── gradlew / gradlew.bat # Wrapper stubs (run `gradle wrapper` for the real ones)
 ├── src/main/java/…/
-│   ├── <Name>Plugin.java     # OmniflowPlugin implementation
-│   └── <Name>Ingestor.java   # PluginIngestor implementation
-└── ui/                   # Only when "Include Next.js UI?" = yes
+│   ├── <Name>Plugin.java          # OmniflowPlugin implementation
+│   ├── <Name>Ingestor.java        # PluginIngestor implementation
+│   ├── <Name>WebhookAction.java   # Only when "Include webhook action?" = yes
+│   └── tools/
+│       └── <Name>QueryTool.java   # Only when "Include AI tool?" = yes
+├── src/main/resources/
+│   └── META-INF/services/…        # ServiceLoader descriptor (auto-generated)
+└── ui/                            # Only when "Include Next.js UI?" = yes
     ├── package.json
     ├── tsconfig.json
     ├── next.config.ts
@@ -89,7 +96,7 @@ To skip the UI build during development:
 ## Upload to OmniFlow
 
 ```sh
-curl -X POST http://localhost:8080/api/plugins/upload \
+curl -X POST http://localhost:8080/api/v1/plugins/upload \
   -b "JSESSIONID=<your-session>" \
   -F "file=@build/libs/<plugin-id>-1.0.0.jar"
 ```
@@ -108,6 +115,31 @@ npm run dev        # starts on http://localhost:3000
 
 The `NEXT_PUBLIC_API_URL` variable in `.env.local` controls which OmniFlow backend the UI talks to.
 
+## AI tools
+
+When you include an AI tool, the scaffolder generates a `PluginTool` implementation that the OmniFlow AI agent can invoke. Tool names are automatically namespaced as `{pluginId}__{name}` to prevent clashes.
+
+After installing the plugin, users can ask the AI agent questions about the ingested data — the agent calls your tool behind the scenes:
+
+```
+User:  "Show me the most recent records from my-plugin"
+Agent: [calls my-plugin__query-records with limit=5]
+```
+
+The generated tool uses `PluginContext.queryRecords()` to fetch data from the host database — no in-memory state required. Customize the `getInputSchema()` and `execute()` methods to add filters, aggregations, or any query logic specific to your data.
+
+See the [deploy-tracker example plugin](https://github.com/ash-thakur-rh/omniflow/tree/main/example-plugins/deploy-tracker) for a full example with multiple AI tools.
+
+## Webhook action
+
+When you include a webhook action, the scaffolder generates a `PluginAction` that posts notifications to a configurable webhook URL. Set the environment variable (e.g. `MY_PLUGIN_WEBHOOK_URL`) to your Slack, Teams, or custom endpoint.
+
+Trigger it from an OmniFlow script:
+
+```
+context.dispatch("my-plugin-notify", "Deploy Complete", "v2.3.1 is live", metadata)
+```
+
 ---
 
 ## Contributing to `create-omniflow-plugin`
@@ -152,14 +184,36 @@ create-omniflow-plugin
 
 ## Publish to npm
 
-1. Bump the version in `package.json`.
-2. Build:
-   ```sh
-   npm run build
-   ```
-3. Publish:
+### One-time setup
+
+1. Create an npm account at [npmjs.com/signup](https://www.npmjs.com/signup) if you don't have one.
+2. Log in from your terminal:
    ```sh
-   npm publish --access public
+   npm login
    ```
 
+### Publish a release
+
+```sh
+# Build
+npm run build
+
+# Publish (first time — public by default for unscoped packages)
+npm publish
+```
+
+The package will be live at [npmjs.com/package/create-omniflow-plugin](https://www.npmjs.com/package/create-omniflow-plugin) and users can run `npx create-omniflow-plugin`.
+
 The `files` field in `package.json` ensures only `dist/` is included in the published package.
+
+### Future releases
+
+```sh
+# Bump version (patch/minor/major)
+npm version patch   # 0.3.0 → 0.3.1
+npm version minor   # 0.3.0 → 0.4.0
+npm version major   # 0.3.0 → 1.0.0
+
+# Build and publish
+npm run build && npm publish
+```

package/dist/index.js

@@ -15,7 +15,7 @@ function toPascalCase(id) {
 function javaTemplates(a) {
   const className = toPascalCase(a.pluginId);
   const pkgPath = a.javaPackage.replace(/\./g, "/");
-  return {
+  const files = {
     // ── Gradle wrapper stub (real wrapper needs `gradle wrapper` to generate) ──
     "gradlew": gradlew(),
     "gradlew.bat": gradlewBat(),
@@ -24,10 +24,20 @@ function javaTemplates(a) {
     // ── Java sources ──────────────────────────────────────────────────────────
     [`src/main/java/${pkgPath}/${className}Plugin.java`]: pluginClass(a, className),
     [`src/main/java/${pkgPath}/${className}Ingestor.java`]: ingestorClass(a, className),
+    // ── ServiceLoader descriptor (required for plugin discovery) ──────────────
+    "src/main/resources/META-INF/services/io.github.agnistack.omniflow.pluginapi.OmniflowPlugin": `${a.javaPackage}.${className}Plugin
+`,
     // ── CI / ingestor scripts ─────────────────────────────────────────────────
     "scripts/ingest.sh": ingestScript(a),
     "scripts/upload-plugin.sh": uploadPluginScript(a)
   };
+  if (a.hasTools) {
+    files[`src/main/java/${pkgPath}/tools/${className}QueryTool.java`] = toolClass(a, className);
+  }
+  if (a.hasAction) {
+    files[`src/main/java/${pkgPath}/${className}WebhookAction.java`] = actionClass(a, className);
+  }
+  return files;
 }
 function settingsGradle(a) {
   return `rootProject.name = '${a.pluginId}'
@@ -100,7 +110,7 @@ repositories {
 
 dependencies {
   compileOnly 'io.github.agnistack:omniflow-plugin-api:${a.omniflowVersion}'
-  implementation 'com.fasterxml.jackson.core:jackson-databind:2.17.2'
+  implementation 'com.fasterxml.jackson.core:jackson-databind:2.21.2'
 }
 ${uiBlock}
 jar {
@@ -111,58 +121,73 @@ jar {
   duplicatesStrategy = DuplicatesStrategy.EXCLUDE
   manifest {
     attributes(
-      'Plugin-Id'     : '${a.pluginId}',
-      'Plugin-Version': project.version,
-      'Plugin-Class'  : '${a.javaPackage}.${className}Plugin'
+      'Plugin-Id'             : '${a.pluginId}',
+      'Plugin-Version'        : project.version,
+      'Plugin-Api-Version'    : '${a.omniflowVersion}',
+      'Plugin-Class'          : '${a.javaPackage}.${className}Plugin',
+      'Implementation-Version': project.version
     )
   }
 }
 `;
 }
 function pluginClass(a, className) {
+  const toolImport = a.hasTools ? `
+import ${a.javaPackage}.tools.${className}QueryTool;` : "";
+  const toolsMethod = a.hasTools ? `
+    private PluginContext ctx;
+
+    @Override
+    public List<PluginTool> tools() {
+        return List.of(new ${className}QueryTool(ctx));
+    }
+` : "";
+  const actionsMethod = a.hasAction ? `
+    @Override
+    public List<PluginAction> actions() {
+        return List.of(new ${className}WebhookAction());
+    }
+` : "";
+  const onLoadBody = a.hasTools ? `        this.ctx = ctx;
+        ctx.log("${a.pluginName} plugin loaded -> ingestor type: ${a.ingestorType}");` : `        ctx.log("${a.pluginName} plugin loaded -> ingestor type: ${a.ingestorType}");`;
+  const onUnload = a.hasTools ? `
+    @Override
+    public void onUnload() {
+        this.ctx = null;
+    }
+` : "";
   return `package ${a.javaPackage};
 
 import io.github.agnistack.omniflow.pluginapi.*;
-import java.util.List;
+import java.util.List;${toolImport}
 
 public class ${className}Plugin implements OmniflowPlugin {
-
+${toolsMethod}
     @Override
     public PluginMetadata metadata() {
-        return PluginMetadata.builder()
-            .id("${a.pluginId}")
-            .name("${a.pluginName}")
-            .version("1.0.0")
-            .description("${a.description}")
-            .author("${a.author}")
-            .build();
+        return new PluginMetadata(
+            "${a.pluginId}",
+            "${a.pluginName}",
+            PluginMetadata.resolveVersion(${className}Plugin.class, "1.0.0"),
+            "${a.description}",
+            "${a.author}");
     }
 
     @Override
     public List<PluginIngestor<?>> ingestors() {
         return List.of(new ${className}Ingestor());
     }
-
-    @Override
-    public List<PluginAction> actions() {
-        return List.of();
-    }
-
+${actionsMethod}
     @Override
     public boolean hasUi() {
         return ${a.hasUi};
     }
 
     @Override
-    public void onLoad(PluginContext context) {
-        // Called when the plugin is loaded \u2014 register schemas, etc.
-    }
-
-    @Override
-    public void onUnload() {
-        // Called when the plugin is unloaded \u2014 release resources.
+    public void onLoad(PluginContext ctx) {
+${onLoadBody}
     }
-}
+${onUnload}}
 `;
 }
 function ingestorClass(a, className) {
@@ -171,11 +196,9 @@ function ingestorClass(a, className) {
 import com.fasterxml.jackson.databind.ObjectMapper;
 import io.github.agnistack.omniflow.pluginapi.*;
 import java.io.InputStream;
-import java.time.Instant;
 import java.util.Map;
-import java.util.UUID;
 
-public class ${className}Ingestor implements PluginIngestor<PluginDataRecord> {
+public class ${className}Ingestor implements PluginIngestor<SimplePluginDataRecord> {
 
     private static final ObjectMapper MAPPER = new ObjectMapper();
 
@@ -185,17 +208,149 @@ public class ${className}Ingestor implements PluginIngestor<PluginDataRecord> {
     }
 
     @Override
-    public PluginDataRecord ingest(InputStream data) throws Exception {
+    public SimplePluginDataRecord ingest(InputStream data) throws Exception {
         // TODO: parse your data format here
         @SuppressWarnings("unchecked")
         Map<String, Object> parsed = MAPPER.readValue(data, Map.class);
 
-        return PluginDataRecord.builder()
-            .id(UUID.randomUUID().toString())
-            .type(getType())
-            .timestamp(Instant.now())
-            .fields(parsed)
+        return SimplePluginDataRecord.of(getType(), parsed);
+    }
+}
+`;
+}
+function toolClass(a, className) {
+  return `package ${a.javaPackage}.tools;
+
+import io.github.agnistack.omniflow.pluginapi.PluginContext;
+import io.github.agnistack.omniflow.pluginapi.PluginTool;
+import java.time.Instant;
+import java.time.temporal.ChronoUnit;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+/**
+ * AI tool: {@code query-records}
+ * Namespaced by the host as {@code ${a.pluginId}__query-records}.
+ *
+ * Returns recently ingested records, optionally filtered by a field value.
+ * The OmniFlow AI agent can call this tool to answer user questions about
+ * the data ingested by this plugin.
+ */
+public class ${className}QueryTool implements PluginTool {
+
+    private final PluginContext ctx;
+
+    public ${className}QueryTool(PluginContext ctx) {
+        this.ctx = ctx;
+    }
+
+    @Override
+    public String getName() {
+        return "query-records";
+    }
+
+    @Override
+    public String getDescription() {
+        return "Query recently ingested ${a.pluginName} records. "
+             + "Returns the most recent records, optionally limited by count.";
+    }
+
+    @Override
+    public String getInputSchema() {
+        return """
+                {
+                  "type": "object",
+                  "properties": {
+                    "limit": {
+                      "type": "integer",
+                      "description": "Maximum number of results to return (1-50, default 10)"
+                    }
+                  }
+                }""";
+    }
+
+    @Override
+    public String execute(Map<String, Object> args) throws Exception {
+        int limit = args.get("limit") instanceof Number n ? n.intValue() : 10;
+        limit = Math.max(1, Math.min(limit, 50));
+
+        Instant since = Instant.now().minus(90, ChronoUnit.DAYS);
+        List<Map<String, Object>> records = ctx.queryRecords("${a.ingestorType}", limit, since);
+
+        if (records.isEmpty()) {
+            return "No ${a.pluginName} records found.";
+        }
+
+        StringBuilder sb = new StringBuilder();
+        sb.append("Found ").append(records.size()).append(" record(s):\\n\\n");
+
+        for (Map<String, Object> rec : records) {
+            sb.append("- id=").append(rec.get("id"))
+              .append(" timestamp=").append(rec.get("timestamp"))
+              .append(" fields=").append(rec)
+              .append("\\n");
+        }
+
+        return sb.toString();
+    }
+}
+`;
+}
+function actionClass(a, className) {
+  return `package ${a.javaPackage};
+
+import io.github.agnistack.omniflow.pluginapi.PluginAction;
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.util.Map;
+
+/**
+ * Webhook action: {@code ${a.pluginId}-notify}
+ *
+ * Posts a JSON payload to a webhook URL when dispatched from an OmniFlow script.
+ * Set the {@code ${a.pluginId.toUpperCase().replace(/-/g, "_")}_WEBHOOK_URL} environment variable
+ * to your Slack / Teams / custom webhook endpoint.
+ *
+ * Usage from an OmniFlow script:
+ * <pre>
+ *   context.dispatch("${a.pluginId}-notify", "Title", "Message", metadata)
+ * </pre>
+ */
+public class ${className}WebhookAction implements PluginAction {
+
+    private static final String ENV_KEY = "${a.pluginId.toUpperCase().replace(/-/g, "_")}_WEBHOOK_URL";
+
+    @Override
+    public String getType() {
+        return "${a.pluginId}-notify";
+    }
+
+    @Override
+    public boolean isConfigured() {
+        return System.getenv(ENV_KEY) != null;
+    }
+
+    @Override
+    public void execute(String title, String message, Map<String, String> metadata) throws Exception {
+        String url = System.getenv(ENV_KEY);
+        if (url == null || url.isBlank()) {
+            throw new IllegalStateException(ENV_KEY + " is not set");
+        }
+
+        String payload = String.format(
+            "{\\"text\\": \\"*%s*\\\\n%s\\"}", title.replace("\\"", "\\\\\\""), message.replace("\\"", "\\\\\\""));
+
+        HttpRequest request = HttpRequest.newBuilder()
+            .uri(URI.create(url))
+            .header("Content-Type", "application/json")
+            .POST(HttpRequest.BodyPublishers.ofString(payload))
             .build();
+
+        HttpClient.newHttpClient()
+            .send(request, HttpResponse.BodyHandlers.ofString());
     }
 }
 `;
@@ -232,7 +387,7 @@ API_KEY=\${OMNIFLOW_API_KEY:?Set OMNIFLOW_API_KEY environment variable}
 echo "Ingesting \${FILE} as type '${a.ingestorType}'..."
 
 HTTP_STATUS=$(curl -s -o /tmp/ingest_response.json -w "%{http_code}" \\
-  -X POST "\${API_URL}/api/ingest/${a.ingestorType}" \\
+  -X POST "\${API_URL}/api/v1/ingest/${a.ingestorType}" \\
   -H "X-Api-Key: \${API_KEY}" \\
   -H "Content-Type: application/json" \\
   --data-binary "@\${FILE}")
@@ -269,7 +424,7 @@ echo "Building JAR..."
 echo "Uploading \${JAR} to \${API_URL}..."
 
 HTTP_STATUS=$(curl -s -o /tmp/upload_response.json -w "%{http_code}" \\
-  -X POST "\${API_URL}/api/plugins/upload" \\
+  -X POST "\${API_URL}/api/v1/plugins/upload" \\
   -H "X-Api-Key: \${API_KEY}" \\
   -F "file=@\${JAR}")
 
@@ -314,26 +469,28 @@ function uiPackageJson(a) {
         lint: "next lint"
       },
       dependencies: {
-        "@omniflow/ui": "latest",
-        next: "16.2.1",
-        react: "19.2.4",
-        "react-dom": "19.2.4",
-        swr: "^2.3.3"
+        "@agnistack/omniflow-ui": "0.1.4",
+        next: "16.2.6",
+        react: "19.2.6",
+        "react-dom": "19.2.6",
+        swr: "2.4.1"
       },
       devDependencies: {
-        "@types/node": "^22",
+        "@types/node": "22.19.19",
         "@types/react": "19.2.14",
         "@types/react-dom": "19.2.3",
-        autoprefixer: "^10.4.21",
-        eslint: "^9.39.4",
-        "eslint-config-next": "^16.2.1",
-        postcss: "^8.5.3",
-        tailwindcss: "^3.4.17",
-        typescript: "^5"
+        autoprefixer: "10.5.0",
+        eslint: "9.39.4",
+        "eslint-config-next": "16.2.6",
+        postcss: "8.5.14",
+        tailwindcss: "3.4.19",
+        typescript: "5.9.3"
       },
       overrides: {
         "@types/react": "19.2.14",
-        "@types/react-dom": "19.2.3"
+        "@types/react-dom": "19.2.3",
+        next: "$next",
+        postcss: "8.5.14"
       }
     },
     null,
@@ -373,11 +530,11 @@ function uiNextConfig(a) {
 const forJar = process.env.NEXT_BUILD_FOR_JAR === '1';
 
 const config: NextConfig = {
-  transpilePackages: ['@omniflow/ui'],
+  transpilePackages: ['@agnistack/omniflow-ui'],
   output: 'export',
-  // basePath and assetPrefix match the host's /api/plugins/{id}/ui/** route.
-  basePath:    forJar ? '/api/plugins/${a.pluginId}/ui' : '',
-  assetPrefix: forJar ? '/api/plugins/${a.pluginId}/ui' : '',
+  // basePath and assetPrefix match the host's /api/v1/plugins/{id}/ui/** route.
+  basePath:    forJar ? '/api/v1/plugins/${a.pluginId}/ui' : '',
+  assetPrefix: forJar ? '/api/v1/plugins/${a.pluginId}/ui' : '',
   images: { unoptimized: true },
   trailingSlash: false,
 };
@@ -393,7 +550,7 @@ const config: Config = {
     './app/**/*.{ts,tsx}',
     './components/**/*.{ts,tsx}',
     './lib/**/*.{ts,tsx}',
-    './node_modules/@omniflow/ui/src/**/*.{ts,tsx}',
+    './node_modules/@agnistack/omniflow-ui/src/**/*.{ts,tsx}',
   ],
   darkMode: 'class',
   theme: { extend: {} },
@@ -448,8 +605,10 @@ body {
 }
 function uiLayout(a) {
   return `import type { Metadata } from 'next';
+import { Suspense } from 'react';
 import './globals.css';
 import ThemeSync from '@/components/ThemeSync';
+import { FilterProvider, FilterBar } from '@agnistack/omniflow-ui';
 
 export const metadata: Metadata = { title: '${a.pluginName} \u2014 OmniFlow' };
 
@@ -465,7 +624,10 @@ export default function RootLayout({ children }: { children: React.ReactNode })
           <span className="text-sm font-bold text-gray-900 dark:text-slate-100">${a.pluginName}</span>
           <span className="text-xs bg-purple-100 dark:bg-purple-900/50 text-purple-700 dark:text-purple-300 border border-purple-200 dark:border-purple-900 px-2 py-0.5 rounded-full">OmniFlow Plugin</span>
         </header>
-        <main className="flex-1 p-6">{children}</main>
+        <FilterProvider defaultLimit="50">
+          <Suspense><FilterBar apiType="${a.ingestorType}" defaultLimit="50" limitOptions={[{ value: '20', label: 'Last 20' }, { value: '50', label: 'Last 50' }, { value: '100', label: 'Last 100' }]} statusOptions={[{ value: 'SUCCESS', label: 'Success' }, { value: 'FAILED', label: 'Failed' }]} /></Suspense>
+          <main className="flex-1 p-6">{children}</main>
+        </FilterProvider>
       </body>
     </html>
   );
@@ -476,7 +638,7 @@ function uiPage(a) {
   return `'use client';
 
 import useSWR from 'swr';
-import { EmptyState, cls } from '@omniflow/ui';
+import { EmptyState, cls } from '@agnistack/omniflow-ui';
 import { fetchRecords, type PluginRecord } from '@/lib/api';
 
 export default function HomePage() {
@@ -490,7 +652,7 @@ export default function HomePage() {
   if (!records?.length) return (
     <EmptyState
       title="No ${a.pluginName} data ingested yet."
-      description="POST data to /api/ingest/${a.ingestorType} to get started."
+      description="POST data to /api/v1/ingest/${a.ingestorType} to get started."
     />
   );
 
@@ -546,7 +708,7 @@ export default function ThemeSync() {
 }
 function uiApi(a) {
   return `// The OmniFlow backend URL. Defaults to same origin in production (assets
-// are served by the OmniFlow host at /api/plugins/${a.pluginId}/ui).
+// are served by the OmniFlow host at /api/v1/plugins/${a.pluginId}/ui).
 const BASE = process.env.NEXT_PUBLIC_API_URL ?? '';
 
 async function get<T>(path: string): Promise<T> {
@@ -572,7 +734,7 @@ export interface PluginRecord {
 // \u2500\u2500 API calls \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
 
 export const fetchRecords = (limit = 50) =>
-  get<PluginRecord[]>(\`/api/analytics/builds?type=${a.ingestorType}&limit=\${limit}\`);
+  get<PluginRecord[]>(\`/api/v1/analytics/builds?type=${a.ingestorType}&limit=\${limit}\`);
 `;
 }
 
@@ -607,7 +769,7 @@ async function main() {
       pluginId: () => p.text({
         message: "Plugin ID",
         placeholder: "my-ingestor",
-        validate: (v) => /^[a-z][a-z0-9-]*$/.test(v) ? void 0 : "Use lowercase letters, numbers and hyphens only"
+        validate: (v = "") => /^[a-z][a-z0-9-]*$/.test(v) ? void 0 : "Use lowercase letters, numbers and hyphens only"
       }),
       pluginName: ({ results }) => p.text({
         message: "Plugin display name",
@@ -629,13 +791,21 @@ async function main() {
         message: "Ingestor type key  (used in API paths, e.g. /api/ingest/{type})",
         initialValue: results.pluginId
       }),
+      hasTools: () => p.confirm({
+        message: "Include an AI tool?  (exposes data to OmniFlow AI chat)",
+        initialValue: false
+      }),
+      hasAction: () => p.confirm({
+        message: "Include a webhook action?  (dispatched from OmniFlow scripts)",
+        initialValue: false
+      }),
       hasUi: () => p.confirm({
         message: "Include a Next.js micro UI?",
         initialValue: true
       }),
       omniflowVersion: () => p.text({
         message: "OmniFlow plugin-api version to depend on",
-        initialValue: "1.0.0"
+        initialValue: "0.1"
       }),
       apiUrl: () => p.text({
         message: "OmniFlow API base URL (for local dev)",
@@ -662,12 +832,12 @@ async function main() {
       `./gradlew jar`,
       "",
       "# Upload to a running OmniFlow backend:",
-      `curl -X POST ${answers.apiUrl}/api/plugins/upload \\`,
+      `curl -X POST ${answers.apiUrl}/api/v1/plugins/upload \\`,
       `  -H "X-Api-Key: <your-api-key>" \\`,
       `  -F "file=@build/libs/${answers.pluginId}-1.0.0.jar"`,
       "",
       "# Ingest data (see scripts/ingest.sh for a ready-made script):",
-      `curl -X POST ${answers.apiUrl}/api/ingest/${answers.ingestorType} \\`,
+      `curl -X POST ${answers.apiUrl}/api/v1/ingest/${answers.ingestorType} \\`,
       `  -H "X-Api-Key: <your-api-key>" \\`,
       `  -H "Content-Type: application/json" \\`,
       `  -d @data.json`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-omniflow-plugin",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Scaffold a new OmniFlow plugin — Java ingestor/action + optional Next.js micro UI",
   "license": "MIT",
   "type": "module",
@@ -14,13 +14,13 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
-    "@clack/prompts": "^0.9.0",
-    "picocolors": "^1.1.1"
+    "@clack/prompts": "1.5.0",
+    "picocolors": "1.1.1"
   },
   "devDependencies": {
-    "@types/node": "^22",
-    "tsup": "^8",
-    "typescript": "^5"
+    "@types/node": "22.19.15",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3"
   },
   "engines": {
     "node": ">=18"