@epilot/cli 0.1.113 → 0.1.115

package/README.md

@@ -29,7 +29,7 @@ npm install -g @epilot/cli
 
 <!-- usage-help -->
 ```
-epilot v0.1.113 — CLI for epilot APIs
+epilot v0.1.115 — CLI for epilot APIs
 
 USAGE
   epilot <api> <operationId> [params...] [flags]

package/definitions/app.json

@@ -2113,12 +2113,12 @@
               "workflow",
               "scheduled"
             ],
-            "description": "Where the function can be used. `workflow` functions are selectable as actions in the flow builder and run with entity context. `scheduled` functions run automatically per installation on their cron schedule.\n"
+            "description": "Where the function can be used. `workflow` functions are referenced by CUSTOM_FLOW_ACTION components (type `function`) and run with entity context. `scheduled` functions run automatically per installation on their cron schedule.\n"
           },
           "label": {
             "allOf": [
               {
-                "description": "Human-readable display name, e.g. shown in the flow builder action picker"
+                "description": null
               },
               {
                 "$ref": "#/components/schemas/TranslatedString"
@@ -2165,19 +2165,6 @@
               "type": "string"
             },
             "description": "Keys of installation options of type secret made available to the function via input.app_options\n"
-          },
-          "wait_for_callback": {
-            "type": "boolean",
-            "description": "Workflow functions only — wait for the callback_url to be called before completing the flow action\n"
-          },
-          "surfaces": {
-            "type": "object",
-            "description": "Workflow functions only — optional custom config UI shown in the flow builder",
-            "properties": {
-              "flow_action_config": {
-                "$ref": "#/components/schemas/AppBridgeSurfaceConfig"
-              }
-            }
           }
         }
       },
@@ -2594,18 +2581,48 @@
           }
         ]
       },
+      "FunctionRefCustomActionConfig": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/BaseCustomActionConfig"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "function"
+                ]
+              },
+              "function_name": {
+                "type": "string",
+                "description": "Name of a `workflow`-type function of the same app version. The component provides the org-facing contract (name, options, config surface); the referenced function provides the code.\n"
+              }
+            },
+            "required": [
+              "type",
+              "function_name"
+            ]
+          }
+        ]
+      },
       "CustomFlowConfig": {
         "type": "object",
-        "description": "Configuration of an external-integration flow action. Sandboxed code belongs in the app's `functions` (type `workflow`) instead — workflow functions are selectable directly in the flow builder without a component.\n",
+        "description": "Configuration of a flow action component. `external_integration` calls an external HTTP endpoint; `function` runs a workflow-type app function in the epilot sandbox.\n",
         "oneOf": [
           {
             "$ref": "#/components/schemas/ExternalIntegrationCustomActionConfig"
+          },
+          {
+            "$ref": "#/components/schemas/FunctionRefCustomActionConfig"
           }
         ],
         "discriminator": {
           "propertyName": "type",
           "mapping": {
-            "external_integration": "#/components/schemas/ExternalIntegrationCustomActionConfig"
+            "external_integration": "#/components/schemas/ExternalIntegrationCustomActionConfig",
+            "function": "#/components/schemas/FunctionRefCustomActionConfig"
           }
         }
       },

package/definitions/calendar.json

@@ -1328,6 +1328,16 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "The epilot default calendar cannot be deleted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
           }
         }
       }
@@ -1430,7 +1440,7 @@
       "post": {
         "operationId": "createEvent",
         "summary": "createEvent",
-        "description": "Create a native epilot calendar event.",
+        "description": "Create a native epilot calendar event. Omit `calendar_id` to use the caller’s epilot default calendar.",
         "tags": [
           "Calendar Events"
         ],
@@ -2323,7 +2333,11 @@
           },
           "is_default": {
             "type": "boolean",
-            "description": "True if this is the user's primary calendar"
+            "description": "True if the source provider marks this calendar as default"
+          },
+          "is_epilot_default": {
+            "type": "boolean",
+            "description": "True for the epilot default calendar"
           },
           "read_only": {
             "type": "boolean",
@@ -2352,6 +2366,7 @@
           "_org",
           "name",
           "is_default",
+          "is_epilot_default",
           "read_only",
           "source"
         ]
@@ -2768,7 +2783,7 @@
           "calendar_id": {
             "type": "string",
             "minLength": 1,
-            "description": "epilot calendar this event belongs to"
+            "description": "Owned calendar ID. Omit this property to use the epilot default calendar."
           },
           "description": {
             "type": "string",
@@ -2815,7 +2830,6 @@
           }
         },
         "required": [
-          "calendar_id",
           "start_time",
           "end_time",
           "timezone",

package/dist/{add-component-TCF7V3KU.js → add-component-YSPAIR3D.js}

@@ -3,7 +3,7 @@ import {
   log,
   readManifest,
   writeManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";
@@ -15,6 +15,16 @@ import { existsSync, readFileSync, writeFileSync, readdirSync } from "fs";
 import { resolve, join } from "path";
 var TEMPLATES_REPO = "epilot-dev/app-templates";
 var TEMPLATE_REGISTRY = {
+  CUSTOM_FLOW_ACTION_FUNCTION: {
+    configOnly: true,
+    manifestType: "CUSTOM_FLOW_ACTION",
+    templateDir: "custom-flow-action-function",
+    description: "Flow action running a workflow function (code in epilot)",
+    configuration: () => ({
+      type: "function",
+      function_name: "<add-a-workflow-function-name>"
+    })
+  },
   CUSTOM_FLOW_ACTION_EXTERNAL: {
     configOnly: true,
     manifestType: "CUSTOM_FLOW_ACTION",

package/dist/{add-function-VRVBRNY3.js → add-function-6VYBWMRD.js}

@@ -4,7 +4,7 @@ import {
   readManifest,
   validateScheduleExpression,
   writeManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";
@@ -29,7 +29,10 @@ var add_function_default = defineCommand({
       type: "string",
       description: 'Cron ("0 3 * * *") or rate ("rate(30 minutes)") expression to run the function once per installation'
     },
-    label: { type: "string", description: "Display name shown to org admins (e.g. in the flow builder)" },
+    label: {
+      type: "string",
+      description: "Display name shown to org admins (e.g. in the installed app's functions summary)"
+    },
     timezone: { type: "string", description: "IANA timezone for cron schedules (default: Europe/Berlin)" },
     path: { type: "string", description: "Path to manifest.json (default: manifest.json)" }
   },
@@ -126,7 +129,9 @@ var add_function_default = defineCommand({
     if (args.schedule) {
       log.info(`Schedule: ${args.schedule} (runs once per installation, max 60s per run)`);
     } else {
-      log.info("Selectable as an action in the flow builder once the app is installed");
+      log.info(
+        "Wire it into the flow builder with: epilot app add-component <name> --type CUSTOM_FLOW_ACTION_FUNCTION"
+      );
     }
     log.dim('Build with "npm run build", then "epilot app deploy"');
   }
@@ -136,8 +141,9 @@ var handlerTemplate = (name, fnType, schedule) => `// App function: ${name}
 // Runs automatically ${schedule?.startsWith("rate(") ? `every ${schedule.slice(5, -1)}` : `on "${schedule}"`} \u2014 once per installation,
 // inside the epilot code-execution sandbox with a 60 second budget. Do a
 // bounded amount of work per run; the next tick picks up the rest.` : `
-// Selectable as an action in the flow builder. Runs inside the epilot
-// code-execution sandbox with the triggering entity in \`input.entity\`.`}
+// The code behind a flow action: reference it from a CUSTOM_FLOW_ACTION
+// component ({ "type": "function", "function_name": "..." }). Runs inside the
+// epilot code-execution sandbox with the triggering entity in \`input.entity\`.`}
 //
 // Runtime contract:
 //   - top-level \`async function handler(input, context)\` \u2014 no \`export\`.

package/dist/{api-5W2UMWCW.js → api-HKW3N3TV.js}

@@ -14,7 +14,7 @@ var api_default = defineCommand({
   args: {
     operation: { type: "positional", description: "operationId to call", required: false },
     param: { type: "string", alias: "p", description: "Parameter key=value" },
-    data: { type: "string", alias: "d", description: "Request body JSON" },
+    data: { type: "string", alias: ["d", "body"], description: "Request body JSON" },
     header: { type: "string", alias: "H", description: "Custom header" },
     include: { type: "boolean", alias: "i", description: "Include response headers" },
     definition: { type: "string", description: "Override OpenAPI spec file/URL" },
@@ -45,7 +45,8 @@ var api_default = defineCommand({
       ...args,
       help: !!args._ophelp,
       _apihelp: !!args._apihelp,
-      _args: positionalArgs
+      _args: positionalArgs,
+      _rawArgs: rawArgs
     });
   }
 });

package/dist/app-TCMEJ6XJ.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+// src/commands/app/index.ts
+import { defineCommand } from "citty";
+var app_default = defineCommand({
+  meta: {
+    name: "app",
+    description: "Manage epilot Apps \u2014 create, deploy, and manage app manifests"
+  },
+  subCommands: {
+    init: () => import("./init-5K7TXE74.js").then((m) => m.default),
+    "add-component": () => import("./add-component-YSPAIR3D.js").then((m) => m.default),
+    "remove-component": () => import("./remove-component-4XFMVBFW.js").then((m) => m.default),
+    "add-function": () => import("./add-function-6VYBWMRD.js").then((m) => m.default),
+    validate: () => import("./validate-B5MJWBXP.js").then((m) => m.default),
+    deploy: () => import("./deploy-3HGRSDVZ.js").then((m) => m.default),
+    dev: () => import("./dev-IYGZMQ5U.js").then((m) => m.default),
+    export: () => import("./export-TDFYIMNN.js").then((m) => m.default),
+    versions: () => import("./versions-KZG3AZCT.js").then((m) => m.default),
+    review: () => import("./review-BD2ZOXCZ.js").then((m) => m.default),
+    api: () => import("./api-HKW3N3TV.js").then((m) => m.default)
+  }
+});
+export {
+  app_default as default
+};

package/dist/bin/epilot.js

@@ -11,7 +11,7 @@ import { defineCommand } from "citty";
 var main = defineCommand({
   meta: {
     name: "epilot",
-    version: "0.1.113",
+    version: "0.1.115",
     description: "CLI for epilot APIs"
   },
   args: {
@@ -31,12 +31,12 @@ var main = defineCommand({
     profile: () => import("../profile-OZJL5ZPT.js").then((m) => m.default),
     config: () => import("../config-DGZIMLZK.js").then((m) => m.default),
     completion: () => import("../completion-YY2UW6SA.js").then((m) => m.default),
-    upgrade: () => import("../upgrade-KXJE4GVJ.js").then((m) => m.default),
+    upgrade: () => import("../upgrade-J67DJOAP.js").then((m) => m.default),
     "access-token": () => import("../access-token-WWE6BDJH.js").then((m) => m.default),
     address: () => import("../address-EH3C4CVB.js").then((m) => m.default),
     "address-suggestions": () => import("../address-suggestions-RRSLOBFW.js").then((m) => m.default),
     "ai-agents": () => import("../ai-agents-53M2KHPI.js").then((m) => m.default),
-    app: () => import("../app-NATUF3YX.js").then((m) => m.default),
+    app: () => import("../app-TCMEJ6XJ.js").then((m) => m.default),
     "audit-logs": () => import("../audit-logs-YFRK3EFU.js").then((m) => m.default),
     automation: () => import("../automation-4DEE3TUI.js").then((m) => m.default),
     billing: () => import("../billing-XX4VVOPI.js").then((m) => m.default),
@@ -134,7 +134,7 @@ process.stderr.on("error", (err) => {
   if (err.code === "EPIPE") process.exit(0);
   throw err;
 });
-var VERSION = true ? "0.1.113" : (await null).default.version;
+var VERSION = true ? "0.1.115" : (await null).default.version;
 var reorderedArgv = hoistFlagsAfterSubcommand(process.argv.slice(2));
 process.argv = [process.argv[0], process.argv[1], ...reorderedArgv];
 var args = process.argv.slice(2);

package/dist/{chunk-UDGF4AVJ.js → chunk-6HMS3A5C.js}

@@ -282,9 +282,6 @@ function validateFunctions(functions, errors) {
     if (fn.type !== "scheduled" && fn.schedule !== void 0) {
       errors.push({ path: `${path}/schedule`, message: 'Only functions of type "scheduled" may declare a schedule' });
     }
-    if (fn.type !== "workflow" && fn.wait_for_callback !== void 0) {
-      errors.push({ path: `${path}/wait_for_callback`, message: "Only valid for workflow functions" });
-    }
     if (typeof fn.name !== "string" || !FUNCTION_NAME_PATTERN.test(fn.name)) {
       errors.push({ path: `${path}/name`, message: "Required kebab-case string (a-z, 0-9, dashes; max 64 chars)" });
     } else if (seen.has(fn.name)) {

package/dist/{deploy-2U5FVEE7.js → deploy-3HGRSDVZ.js}

@@ -8,7 +8,7 @@ import {
   uploadDirectoryAsZip,
   uploadFileToPresignedUrl,
   writeManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";
@@ -81,9 +81,19 @@ var deploy_default = defineCommand({
         if (dryRun) {
           log.info(`[dry-run] Would create new version (cloned from ${targetVersion})`);
         } else {
-          const result = await client.cloneVersion(appId, targetVersion);
-          targetVersion = result.version;
-          log.success(`Created version ${targetVersion}`);
+          try {
+            const result = await client.cloneVersion(appId, targetVersion);
+            targetVersion = result.version;
+            log.success(`Created version ${targetVersion}`);
+          } catch (err) {
+            if (err instanceof Error && err.message.includes("disable dev mode")) {
+              log.error("Cannot create a new version while development mode is enabled.");
+              log.info("Disable it first, then re-run the deploy:");
+              log.dim(`  epilot app api patchMetadata --appId ${appId} -d '{"dev_mode": false}'`);
+              process.exit(1);
+            }
+            throw err;
+          }
         }
       }
     }
@@ -114,31 +124,8 @@ var deploy_default = defineCommand({
           log.error(`Handler not found for function "${fn.name}": ${handlerPath} \u2014 run "npm run build" first`);
           process.exit(1);
         }
-        const { handler, assets: fnAssets, ...rest } = fn;
-        const payload = { ...rest, code: readFileSync(handlerPath, "utf-8") };
-        if (fnAssets?.zip) {
-          const zipPath = resolve(manifestDir, fnAssets.zip);
-          if (!existsSync(zipPath)) {
-            log.warn(`Config UI directory not found for function "${fn.name}": ${zipPath} \u2014 skipping surface`);
-          } else if (dryRun) {
-            log.info(`[dry-run] Would zip and upload config UI for function ${fn.name}`);
-          } else {
-            const { upload_url, artifact_url } = await client.createZipUploadUrl(
-              appId,
-              targetVersion,
-              `fn-${fn.name}`
-            );
-            const zipSize = await uploadDirectoryAsZip(upload_url, zipPath);
-            log.success(`Uploaded config UI for function ${fn.name} (${formatFileSize(zipSize)})`);
-            payload.surfaces = {
-              flow_action_config: {
-                app_url: artifact_url.replace(/\/[^/]+$/, "/index.html"),
-                zip_url: artifact_url
-              }
-            };
-          }
-        }
-        functionsPayload.push(payload);
+        const { handler, ...rest } = fn;
+        functionsPayload.push({ ...rest, code: readFileSync(handlerPath, "utf-8") });
         if (dryRun) {
           log.info(
             `[dry-run] Would deploy ${fn.type} function ${fn.name}${fn.schedule ? ` (schedule: ${fn.schedule})` : ""}`

package/dist/{dev-JEAHUYQU.js → dev-IYGZMQ5U.js}

@@ -3,7 +3,7 @@ import {
   createAppApiClient,
   log,
   readManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{export-VLAY2KZP.js → export-TDFYIMNN.js}

@@ -4,7 +4,7 @@ import {
   log,
   toManifest,
   writeManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{init-C66L5GFR.js → init-5K7TXE74.js}

@@ -2,7 +2,7 @@
 import {
   log,
   writeManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{remove-component-7C7MPSBF.js → remove-component-4XFMVBFW.js}

@@ -3,7 +3,7 @@ import {
   log,
   readManifest,
   writeManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{review-JZTMQNU3.js → review-BD2ZOXCZ.js}

@@ -3,7 +3,7 @@ import {
   createAppApiClient,
   log,
   readManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";
@@ -60,7 +60,9 @@ var review_default = defineCommand({
       ...args["demo-url"] ? { demo_url: args["demo-url"] } : {}
     });
     log.success(`Review submitted for v${version}`);
-    log.info(`Status: ${result.review?.review_status ?? "pending"}`);
+    log.info(
+      `Status: ${result?.review?.review_status ?? "pending"}`
+    );
     log.dim("The epilot team will review your app and update the status.");
   }
 });

package/dist/{upgrade-KXJE4GVJ.js → upgrade-J67DJOAP.js}

@@ -72,7 +72,7 @@ ${GREEN}${BOLD}Upgraded to @epilot/cli@${latest}${RESET}
   }
 });
 var getCurrentVersion = () => {
-  if (true) return "0.1.113";
+  if (true) return "0.1.115";
   try {
     const output = execSync("npm ls -g @epilot/cli --depth=0 --json 2>/dev/null", {
       encoding: "utf-8",

package/dist/{validate-J35DJW3H.js → validate-B5MJWBXP.js}

@@ -2,7 +2,7 @@
 import {
   log,
   validateManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{versions-2TMTHO7W.js → versions-KZG3AZCT.js}

@@ -3,7 +3,7 @@ import {
   createAppApiClient,
   log,
   readManifest
-} from "./chunk-UDGF4AVJ.js";
+} from "./chunk-6HMS3A5C.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epilot/cli",
-  "version": "0.1.113",
+  "version": "0.1.115",
   "description": "CLI for epilot APIs",
   "type": "module",
   "bin": {

package/dist/app-NATUF3YX.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-
-// src/commands/app/index.ts
-import { defineCommand } from "citty";
-var app_default = defineCommand({
-  meta: {
-    name: "app",
-    description: "Manage epilot Apps \u2014 create, deploy, and manage app manifests"
-  },
-  subCommands: {
-    init: () => import("./init-C66L5GFR.js").then((m) => m.default),
-    "add-component": () => import("./add-component-TCF7V3KU.js").then((m) => m.default),
-    "remove-component": () => import("./remove-component-7C7MPSBF.js").then((m) => m.default),
-    "add-function": () => import("./add-function-VRVBRNY3.js").then((m) => m.default),
-    validate: () => import("./validate-J35DJW3H.js").then((m) => m.default),
-    deploy: () => import("./deploy-2U5FVEE7.js").then((m) => m.default),
-    dev: () => import("./dev-JEAHUYQU.js").then((m) => m.default),
-    export: () => import("./export-VLAY2KZP.js").then((m) => m.default),
-    versions: () => import("./versions-2TMTHO7W.js").then((m) => m.default),
-    review: () => import("./review-JZTMQNU3.js").then((m) => m.default),
-    api: () => import("./api-5W2UMWCW.js").then((m) => m.default)
-  }
-});
-export {
-  app_default as default
-};