@epilot/cli 0.1.172 → 0.1.174

package/README.md

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

package/definitions/automation.json

@@ -1230,6 +1230,153 @@
           "results"
         ]
       },
+      "JourneyContextUsagesReq": {
+        "type": "object",
+        "required": [
+          "journey_id",
+          "param_keys"
+        ],
+        "properties": {
+          "journey_id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "param_keys": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Context parameter keys to look for, as plain strings."
+          },
+          "param_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Accepted and ignored. This service stores context references by name only; the field keeps one request shape across every adapter.\n"
+          }
+        }
+      },
+      "JourneyContextUsage": {
+        "type": "object",
+        "required": [
+          "kind",
+          "resource",
+          "matched_as",
+          "link_hint"
+        ],
+        "properties": {
+          "kind": {
+            "type": "string",
+            "enum": [
+              "automation"
+            ]
+          },
+          "resource": {
+            "type": "object",
+            "required": [
+              "type",
+              "id"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": [
+                  "automation_flow"
+                ]
+              },
+              "id": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              }
+            }
+          },
+          "location": {
+            "type": "object",
+            "properties": {
+              "action_id": {
+                "type": "string"
+              },
+              "action_type": {
+                "type": "string"
+              }
+            }
+          },
+          "matched_as": {
+            "type": "object",
+            "required": [
+              "dialect",
+              "token",
+              "at"
+            ],
+            "properties": {
+              "dialect": {
+                "type": "string",
+                "enum": [
+                  "name"
+                ]
+              },
+              "token": {
+                "type": "string"
+              },
+              "at": {
+                "type": "string"
+              }
+            }
+          },
+          "link_hint": {
+            "type": "object",
+            "required": [
+              "route",
+              "params"
+            ],
+            "properties": {
+              "route": {
+                "type": "string",
+                "enum": [
+                  "automation-flow"
+                ]
+              },
+              "params": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      },
+      "JourneyContextUsagesResp": {
+        "type": "object",
+        "required": [
+          "usages",
+          "status",
+          "scanned"
+        ],
+        "properties": {
+          "usages": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/JourneyContextUsage"
+            }
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "ok",
+              "partial"
+            ],
+            "description": "partial means the row cap (MAX_USAGES) was reached mid-scan and the scan was aborted: entire flows after the one that tripped the cap may have gone unscanned, not just that some rows were dropped from the one flow being scanned when it tripped.\n"
+          },
+          "scanned": {
+            "type": "integer",
+            "description": "Number of flows actually entered by the scan, including the one flow the scan was aborted part-way through when the row cap tripped. Not a total: when status is partial, flows after the aborted one were never visited and are not counted here.\n"
+          }
+        }
+      },
       "AnyTrigger": {
         "anyOf": [
           {
@@ -2846,6 +2993,15 @@
             "description": "Prefix to add to the original email subject",
             "default": "Fwd: "
           },
+          "language_code": {
+            "type": "string",
+            "description": "Language of the \"Forwarded message\" attribution header\n(From / Date / To / Subject) prepended to the forwarded email.\nDefaults to German.\n",
+            "enum": [
+              "de",
+              "en"
+            ],
+            "default": "de"
+          },
           "mark_as_done": {
             "type": "boolean",
             "description": "When enabled, the email thread will be automatically marked as done after this action completes.",
@@ -2971,7 +3127,7 @@
           },
           "wait_for_journey_submission": {
             "type": "boolean",
-            "description": "Only relevant when this action runs from a workflow automation task. After the email is sent,\nthe workflow task waits for the journey referenced in the email template to be submitted and\nits submission automation to complete (AL-2521).\n\nThe email template should contain a journey link created with the generateJourneyLink variable.\n",
+            "description": "Only relevant when this action runs from a workflow automation task. After the email is sent,\nthe workflow task waits for the journey referenced in the email template to be submitted and\nits submission automation to complete.\n\nThe email template should contain a journey link created with the generateJourneyLink variable.\n",
             "default": false
           },
           "journey_id": {
@@ -3023,6 +3179,16 @@
                       "description": "Match by filename. Regex syntax supported",
                       "example": ".*"
                     },
+                    "filename": {
+                      "type": "string",
+                      "description": "Match by exact filename",
+                      "example": "Datenblatt_PV.pdf"
+                    },
+                    "filename_pattern": {
+                      "type": "string",
+                      "description": "Match by a filename pattern that may contain template variables. Each\n`{{variable}}` placeholder matches any text, so a pattern written the way a\ngenerated document is named picks up every document produced from that\ntemplate, whatever the variables resolved to.\n",
+                      "example": "{{system.date}}_Summary_{{contact._title}}.docx"
+                    },
                     "attribute": {
                       "type": "string",
                       "description": "Filter by a specific relation attribute on the main entity",
@@ -3692,7 +3858,7 @@
       },
       "FlowExecutionCancelConfig": {
         "type": "object",
-        "description": "Configuration for cancelling a flow execution with selected reasons",
+        "description": "Configuration for cancelling a flow execution. The selected reasons are optional; a semi-automated step lets the person running it choose them when the execution starts.",
         "properties": {
           "selected_reasons": {
             "type": "array",
@@ -3706,10 +3872,7 @@
             "description": "Additional description or notes for the cancellation",
             "example": "Process completed successfully"
           }
-        },
-        "required": [
-          "configured_reasons"
-        ]
+        }
       },
       "CancellationReason": {
         "type": "object",
@@ -4023,6 +4186,9 @@
               "$ref": "#/components/schemas/AnyAction"
             }
           },
+          "action_inputs": {
+            "$ref": "#/components/schemas/ActionInputs"
+          },
           "resume_token": {
             "$ref": "#/components/schemas/ResumeToken"
           },
@@ -4163,7 +4329,7 @@
       },
       "WorkflowWaitContext": {
         "type": "object",
-        "description": "Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link (AL-2521). Consumed by svc-workflows to resume a task waiting on this journey submission.\n",
+        "description": "Correlation stamped when the triggering submission entity carried workflow wait claims from a journey link. Consumed by svc-workflows to resume a task waiting on this journey submission.\n",
         "required": [
           "workflow_execution_id",
           "workflow_task_id"
@@ -4601,6 +4767,9 @@
             "type": "string",
             "deprecated": true,
             "description": "Use workflow_context.workflow_exec_task_id instead"
+          },
+          "action_inputs": {
+            "$ref": "#/components/schemas/ActionInputs"
           }
         },
         "required": [
@@ -4608,6 +4777,58 @@
           "flow_id"
         ]
       },
+      "ActionInputs": {
+        "type": "object",
+        "description": "Internal. Run-time inputs for the actions of this execution, keyed by\naction type. An action reads the entry for its own type and treats it\nas replacing the matching configured values; an action whose type has\nno entry runs entirely from its configuration.\n\nOnly the workflows service may set this field, on behalf of the person\nrunning a semi-automated flow task: it forwards what that person chose\nafter checking their permission to run the task. A request carrying\n`action_inputs` under any other token is refused with 403 and nothing\nis stored.\n\nThis is deliberately NOT stored on `actions[].config`. Retrying a step\nrefreshes that action's config from the live flow (see `startAction`),\nwhich would silently drop an override and re-run the action with the\nconfigured values — sending the wrong email, or cancelling a flow\nunder the wrong reason. Keeping the inputs on the execution row means a\nretry replays what the person actually chose.\n",
+        "properties": {
+          "cancel-flow-execution": {
+            "$ref": "#/components/schemas/FlowExecutionCancelInputs"
+          },
+          "send-email": {
+            "$ref": "#/components/schemas/SendEmailInputs"
+          }
+        }
+      },
+      "SendEmailInputs": {
+        "type": "object",
+        "description": "Adjustments a person made to an email before sending it, replacing the rendered values the template produced. The template itself is untouched.\n\n`attachment_entity_ids` is a request, not an instruction: the worker keeps only the ids that are genuinely files of the entity this execution runs on, so a caller cannot attach an arbitrary file.",
+        "properties": {
+          "subject": {
+            "type": "string",
+            "maxLength": 998
+          },
+          "body": {
+            "type": "string",
+            "maxLength": 50000
+          },
+          "attachment_entity_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "FlowExecutionCancelInputs": {
+        "type": "object",
+        "description": "The cancellation reasons a person chose when running a semi-automated cancel step, replacing `selected_reasons` from the action's configuration.",
+        "properties": {
+          "selected_reasons": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CancellationReason"
+            }
+          },
+          "extra_description": {
+            "type": "string",
+            "maxLength": 2000,
+            "description": "A note the person added with their choice, replacing the one fixed in the action's configuration."
+          }
+        },
+        "required": [
+          "selected_reasons"
+        ]
+      },
       "PatchBulkJobRequest": {
         "type": "object",
         "properties": {

package/definitions/entity.json

@@ -1783,7 +1783,7 @@
       "get": {
         "operationId": "autocomplete",
         "summary": "autocomplete",
-        "description": "Autocomplete entity attributes\n",
+        "description": "Autocomplete entity attributes.\n\nSuggestions are derived from the values **currently stored on entities** the caller is allowed to read.\nA value only shows up while at least one entity carries it, so this endpoint reflects usage, not\nconfiguration.\n\nTo enumerate the label catalogue managed in the Label Builder (including labels that are not\nassigned to any entity yet, and excluding archived ones), use the Taxonomy endpoints instead:\n`POST /v1/entity/taxonomies/classifications:search` (`taxonomiesClassificationsSearch`) or\n`GET /v1/entity/taxonomies/{taxonomySlug}:autocomplete` (`taxonomyAutocomplete`).\n\nFor `attribute=_tags` the distinct values are aggregated across all matching entities, `hits` is the exact\nnumber of distinct values (capped at 1000) and results are ordered by usage. For other attributes the\n1000 most recently updated entities are scanned and `hits` is the number of distinct values found so far.\n",
         "tags": [
           "Entities"
         ],
@@ -1794,7 +1794,7 @@
           {
             "name": "input",
             "in": "query",
-            "description": "Input to autocomplete",
+            "description": "Input to autocomplete (case-insensitive substring match)",
             "schema": {
               "type": "string"
             }
@@ -1827,6 +1827,17 @@
               "minimum": 1,
               "maximum": 250
             }
+          },
+          {
+            "name": "from",
+            "in": "query",
+            "description": "Number of distinct values to skip, for paging through results when `hits` exceeds `size`.\n`from + size` may not exceed 1000.\n",
+            "schema": {
+              "type": "integer",
+              "default": 0,
+              "minimum": 0,
+              "maximum": 999
+            }
           }
         ],
         "responses": {
@@ -1839,6 +1850,7 @@
                   "properties": {
                     "hits": {
                       "type": "number",
+                      "description": "Number of distinct values matching the input. Exact (independent of `size`, capped at 1000) for\n`_tags`; for other attributes the number of distinct values collected so far, which may grow with `size`.\n",
                       "example": 1
                     },
                     "results": {
@@ -5132,6 +5144,100 @@
                   "address_map": "full_width",
                   "recent_communications": "one_third_width"
                 }
+              },
+              "custom_tabs": {
+                "type": "array",
+                "description": "Configured tabs that host widgets, shown alongside capability tabs in entity details. Interleaves with capability `EntityDetailsV2:Tab` ui_hooks on a shared `order`: the host merges both lists and sorts by `order`, with capability tabs winning ties. Unlike the header grid, a tab's `widgets` list is the entire membership — a widget's ui_hook `default_visible` is never consulted for tab placement.",
+                "items": {
+                  "type": "object",
+                  "additionalProperties": true,
+                  "description": "A single configured tab. `type` discriminates the payload shape; readers must skip an entry whose `type` they don't recognize instead of failing, and writers must round-trip such entries unchanged, so a stable host and a canary host can safely share one schema. Mirrors the same skip-unknown/round-trip contract already used for capability `ui_hooks` entries above.",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "Generated when the tab is created and never edited afterward, so a blueprint-authored tab and a customer-authored tab can never collide and identity survives a rename.",
+                      "example": "8f14e45f-ceea-467e-a0d6-c8a4ea1c9e6d"
+                    },
+                    "slug": {
+                      "type": "string",
+                      "description": "URL route segment for the tab, derived from `title`. Unique within the schema, and against capability tab ids, since both share one route-segment namespace.",
+                      "example": "sales-overview"
+                    },
+                    "title": {
+                      "type": "string",
+                      "description": "Tab label, authored by the configuring user.",
+                      "example": "Sales Overview"
+                    },
+                    "order": {
+                      "type": "integer",
+                      "description": "Authoritative render position; array position carries no meaning. Shares one ordering space with capability tab ui_hook `order` — at equal `order`, capability tabs sort first.",
+                      "example": 10
+                    },
+                    "icon": {
+                      "type": "string",
+                      "description": "Icon name from the existing entity icon set.",
+                      "example": "person"
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "Discriminator for the tab's payload. Currently `widgets`, carried by the `widgets` property below; a future tab kind adds its own payload property rather than reusing this one. Deliberately not an enum, so a type introduced by a newer host still round-trips through an older one instead of failing validation.",
+                      "example": "widgets"
+                    },
+                    "widgets": {
+                      "type": "array",
+                      "description": "Payload for `type: widgets`. Membership in this list IS the tab's widget set, in render order — there is no separate visibility map, and a widget's ui_hook `default_visible` is not consulted.",
+                      "items": {
+                        "type": "object",
+                        "properties": {
+                          "id": {
+                            "type": "string",
+                            "description": "Widget id — a capability widget's `component`, or `summary` for the synthesized summary card.",
+                            "example": "next_best_action"
+                          },
+                          "width": {
+                            "type": "string",
+                            "description": "Width for this widget within the tab's grid. Falls back the same way as the header's `widget_widths` when omitted: widget's ui_hook `default_width`, then `full_width`.",
+                            "enum": [
+                              "one_third_width",
+                              "half_width",
+                              "two_third_width",
+                              "full_width"
+                            ]
+                          }
+                        },
+                        "required": [
+                          "id"
+                        ]
+                      }
+                    }
+                  },
+                  "required": [
+                    "id",
+                    "slug",
+                    "title",
+                    "order",
+                    "type"
+                  ]
+                },
+                "example": [
+                  {
+                    "id": "8f14e45f-ceea-467e-a0d6-c8a4ea1c9e6d",
+                    "slug": "sales-overview",
+                    "title": "Sales Overview",
+                    "order": 10,
+                    "type": "widgets",
+                    "widgets": [
+                      {
+                        "id": "next_best_action",
+                        "width": "full_width"
+                      },
+                      {
+                        "id": "recent_communications",
+                        "width": "one_third_width"
+                      }
+                    ]
+                  }
+                ]
               }
             }
           },
@@ -7509,7 +7615,16 @@
           "overridable_attribute": {
             "type": "boolean",
             "default": false,
-            "description": "Allow conditional variants of the entity to override the values managed by this\ncapability. Only meaningful on schemas that declare `conditions` and on capabilities\nthat render an attribute group (`EntityAttributes:Group` ui hook), e.g. pricing tiers.\nAttributes carried by the capability opt in individually via their own\n`overridable_attribute` flag.\n"
+            "description": "Allow conditional variants to override the fields this capability manages. Only\nmeaningful on schemas that declare `conditions`, and requires `managed_fields`: the\nflag covers exactly what that lists, not the capability's name.\n"
+          },
+          "managed_fields": {
+            "type": "array",
+            "description": "Every entity field this capability writes, including one named after the capability\nitself. With `overridable_attribute`, this is the definitive list of what a variant\nmay override through the capability, applied as a single patch.\n\nFields, not attributes: a capability may write entity fields that have no attribute\ndefinition, so entries need not resolve to one. Where an entry does resolve to an\nattribute, `hidden` and `computed` do not disqualify it.\n",
+            "items": {
+              "type": "string",
+              "pattern": "^[a-z0-9_]+$",
+              "example": "status"
+            }
           },
           "_purpose": {
             "type": "array",

package/dist/{access-token-FU7TZ54Q.js → access-token-HA6PGQMQ.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{add-component-7TIKSEHW.js → add-component-FOYDCUK5.js}

@@ -3,8 +3,8 @@ import {
   log,
   readManifest,
   writeManifest
-} from "./chunk-4TPJYISA.js";
-import "./chunk-XTBPN3IE.js";
+} from "./chunk-REE2AXXS.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{add-function-FLDRV4XK.js → add-function-CG6MSD3Y.js}

@@ -4,8 +4,8 @@ import {
   readManifest,
   validateScheduleExpression,
   writeManifest
-} from "./chunk-4TPJYISA.js";
-import "./chunk-XTBPN3IE.js";
+} from "./chunk-REE2AXXS.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{address-A5BBWRGT.js → address-VJKXRGSX.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{address-suggestions-EWWWHFDI.js → address-suggestions-QAXTMNKC.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{ai-agents-LJSIMI3W.js → ai-agents-733CONDM.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{api-4W67J5TF.js → api-N6FKFDSD.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/app-TWDGYQR5.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-LFI6V27F.js").then((m) => m.default),
+    "add-component": () => import("./add-component-FOYDCUK5.js").then((m) => m.default),
+    "remove-component": () => import("./remove-component-VXDXMMOY.js").then((m) => m.default),
+    "add-function": () => import("./add-function-CG6MSD3Y.js").then((m) => m.default),
+    validate: () => import("./validate-BB736XTY.js").then((m) => m.default),
+    deploy: () => import("./deploy-723UQC7G.js").then((m) => m.default),
+    dev: () => import("./dev-ZKR2O7PA.js").then((m) => m.default),
+    export: () => import("./export-FYR2NPC2.js").then((m) => m.default),
+    versions: () => import("./versions-4QFNQHNF.js").then((m) => m.default),
+    review: () => import("./review-7CYXTYDH.js").then((m) => m.default),
+    api: () => import("./api-N6FKFDSD.js").then((m) => m.default)
+  }
+});
+export {
+  app_default as default
+};

package/dist/{audit-logs-35SE6FNF.js → audit-logs-254HAFKW.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{automation-JMKANLLC.js → automation-UJANXGM5.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";

package/dist/{billing-IHWVAX4G.js → billing-UU2S37JH.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import {
   callApi
-} from "./chunk-FWMIC45S.js";
+} from "./chunk-ECOIEYJT.js";
 import "./chunk-IOLKUHUB.js";
-import "./chunk-XTBPN3IE.js";
+import "./chunk-LHA2TF33.js";
 import "./chunk-M3M3C5WH.js";
 import "./chunk-YHQA2AVG.js";
 import "./chunk-7ZQ666ZQ.js";