@invinite-org/invinite-data-cli 3.0.0 → 4.0.0

package/dist/src/spec-manifest.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 /**
- * The compact, committed form of the Data API spec that `invd` registers its generated commands from
+ * The compact, committed form of the Data API v2 spec that `invd` registers its generated commands from
  * (`src/generated/cli-manifest.json`, written by `scripts/build-cli-manifest.ts` from `openapi.json`'s `x-cli`).
  * One schema for the builder's output, the startup loader and the dispatcher.
  */
@@ -8,183 +8,329 @@ export declare const MANIFEST_PARAM_TYPES: readonly ["string", "integer", "numbe
 export declare const MANIFEST_ITEM_TYPES: readonly ["string", "integer", "number"];
 export declare const MANIFEST_METHODS: readonly ["get", "post", "put", "patch", "delete"];
 export declare const MANIFEST_VIEWS: readonly ["table", "keyValue", "json"];
-export declare const MANIFEST_PAGINATIONS: readonly ["none", "top", "perCompany"];
 declare const manifestParamSchema: z.ZodObject<{
     name: z.ZodString;
-    in: z.ZodEnum<["query", "path"]>;
+    in: z.ZodEnum<["query", "path", "header"]>;
     required: z.ZodBoolean;
     type: z.ZodEnum<["string", "integer", "number", "boolean", "array"]>;
     /** Arrays only: the item type; the value is sent as a repeated parameter. */
     items: z.ZodOptional<z.ZodEnum<["string", "integer", "number"]>>;
     /** Allowed values, stringified; on an array they apply to each item. */
     enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** The spec's `pattern` (comma lists like `income-statement,balance-sheet` are patterns, not arrays). */
+    pattern: z.ZodOptional<z.ZodString>;
     /** Shown in help, never sent — the API applies its own default. */
     default: z.ZodOptional<z.ZodUnknown>;
-    /** The spec's `example`: shown in help and the skill's example line, never sent. */
+    /** The spec's `example`: shown in help and in the examples, never sent. */
     example: z.ZodOptional<z.ZodUnknown>;
     description: z.ZodOptional<z.ZodString>;
     /** One-letter short flag (`-q`). */
     alias: z.ZodOptional<z.ZodString>;
+    /** The long flag without dashes (`filed_at.gte` → `filed-at-gte`). */
+    flag: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    type: "string" | "number" | "boolean" | "array" | "integer";
+    type: "string" | "number" | "boolean" | "integer" | "array";
     name: string;
     required: boolean;
-    in: "path" | "query";
+    in: "query" | "path" | "header";
+    flag: string;
     default?: unknown;
     description?: string | undefined;
-    enum?: string[] | undefined;
     items?: "string" | "number" | "integer" | undefined;
+    enum?: string[] | undefined;
+    pattern?: string | undefined;
     example?: unknown;
     alias?: string | undefined;
 }, {
-    type: "string" | "number" | "boolean" | "array" | "integer";
+    type: "string" | "number" | "boolean" | "integer" | "array";
     name: string;
     required: boolean;
-    in: "path" | "query";
+    in: "query" | "path" | "header";
+    flag: string;
     default?: unknown;
     description?: string | undefined;
-    enum?: string[] | undefined;
     items?: "string" | "number" | "integer" | undefined;
+    enum?: string[] | undefined;
+    pattern?: string | undefined;
     example?: unknown;
     alias?: string | undefined;
 }>;
+declare const bodyFieldSchema: z.ZodObject<{
+    /** The property's path in the JSON body (`["filters", "ciks"]`). */
+    path: z.ZodArray<z.ZodString, "many">;
+    type: z.ZodEnum<["string", "integer", "number", "boolean", "array"]>;
+    items: z.ZodOptional<z.ZodEnum<["string", "integer", "number"]>>;
+    required: z.ZodBoolean;
+    description: z.ZodOptional<z.ZodString>;
+    alias: z.ZodOptional<z.ZodString>;
+    flag: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    path: string[];
+    type: "string" | "number" | "boolean" | "integer" | "array";
+    required: boolean;
+    flag: string;
+    description?: string | undefined;
+    items?: "string" | "number" | "integer" | undefined;
+    alias?: string | undefined;
+}, {
+    path: string[];
+    type: "string" | "number" | "boolean" | "integer" | "array";
+    required: boolean;
+    flag: string;
+    description?: string | undefined;
+    items?: "string" | "number" | "integer" | undefined;
+    alias?: string | undefined;
+}>;
 declare const manifestOperationSchema: z.ZodObject<{
     operationId: z.ZodString;
     group: z.ZodString;
-    /** `""` = the group itself is the command (`invd health`). */
+    /** `""` = the group itself is the command (`invd financials`, the `x-cli.command` operations). */
     action: z.ZodString;
     method: z.ZodEnum<["get", "post", "put", "patch", "delete"]>;
     path: z.ZodString;
-    /** `false` = the operation needs no API key (`security: []` or none in the spec): no key is resolved or sent. */
+    /** `false` = the operation needs no API key: no key is resolved or sent. */
     auth: z.ZodBoolean;
     summary: z.ZodString;
+    /** The spec's `x-credits`: the base cost of one response (`--dry-run`, the `--all` confirmation). */
+    credits: z.ZodNumber;
+    /** The spec's `x-tier` (free, lite, standard, pro). */
+    tier: z.ZodString;
     params: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
-        in: z.ZodEnum<["query", "path"]>;
+        in: z.ZodEnum<["query", "path", "header"]>;
         required: z.ZodBoolean;
         type: z.ZodEnum<["string", "integer", "number", "boolean", "array"]>;
         /** Arrays only: the item type; the value is sent as a repeated parameter. */
         items: z.ZodOptional<z.ZodEnum<["string", "integer", "number"]>>;
         /** Allowed values, stringified; on an array they apply to each item. */
         enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** The spec's `pattern` (comma lists like `income-statement,balance-sheet` are patterns, not arrays). */
+        pattern: z.ZodOptional<z.ZodString>;
         /** Shown in help, never sent — the API applies its own default. */
         default: z.ZodOptional<z.ZodUnknown>;
-        /** The spec's `example`: shown in help and the skill's example line, never sent. */
+        /** The spec's `example`: shown in help and in the examples, never sent. */
         example: z.ZodOptional<z.ZodUnknown>;
         description: z.ZodOptional<z.ZodString>;
         /** One-letter short flag (`-q`). */
         alias: z.ZodOptional<z.ZodString>;
+        /** The long flag without dashes (`filed_at.gte` → `filed-at-gte`). */
+        flag: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        type: "string" | "number" | "boolean" | "array" | "integer";
+        type: "string" | "number" | "boolean" | "integer" | "array";
         name: string;
         required: boolean;
-        in: "path" | "query";
+        in: "query" | "path" | "header";
+        flag: string;
         default?: unknown;
         description?: string | undefined;
-        enum?: string[] | undefined;
         items?: "string" | "number" | "integer" | undefined;
+        enum?: string[] | undefined;
+        pattern?: string | undefined;
         example?: unknown;
         alias?: string | undefined;
     }, {
-        type: "string" | "number" | "boolean" | "array" | "integer";
+        type: "string" | "number" | "boolean" | "integer" | "array";
         name: string;
         required: boolean;
-        in: "path" | "query";
+        in: "query" | "path" | "header";
+        flag: string;
         default?: unknown;
         description?: string | undefined;
-        enum?: string[] | undefined;
         items?: "string" | "number" | "integer" | undefined;
+        enum?: string[] | undefined;
+        pattern?: string | undefined;
         example?: unknown;
         alias?: string | undefined;
     }>, "many">;
+    /** The parameter the first positional fills: a company list (`AAPL MSFT` → `company=AAPL,MSFT`), a member id, `q`. */
+    positional: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        required: z.ZodBoolean;
+        /** Several words: joined with `,` (a company list) or ` ` (a search text). */
+        variadic: z.ZodOptional<z.ZodEnum<["comma", "space"]>>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        required: boolean;
+        variadic?: "comma" | "space" | undefined;
+    }, {
+        name: string;
+        required: boolean;
+        variadic?: "comma" | "space" | undefined;
+    }>>;
+    /** One command over several operations (`invd financials`): the `--basis` / `--view` values that pick this one. */
+    select: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     /** The spec's `x-example-params`: the OPTIONAL params an example invocation passes beside the required ones. */
     exampleParams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     body: z.ZodOptional<z.ZodObject<{
         required: z.ZodBoolean;
         contentType: z.ZodLiteral<"application/json">;
-        /** The spec's request-body `example` (the skill's `--body`). */
+        /** The spec's request-body `example`. */
         example: z.ZodOptional<z.ZodUnknown>;
+        /** Flags for the body's scalar / list properties (`--url`, `--events a,b`, `--ciks` → `filters.ciks`). */
+        fields: z.ZodArray<z.ZodObject<{
+            /** The property's path in the JSON body (`["filters", "ciks"]`). */
+            path: z.ZodArray<z.ZodString, "many">;
+            type: z.ZodEnum<["string", "integer", "number", "boolean", "array"]>;
+            items: z.ZodOptional<z.ZodEnum<["string", "integer", "number"]>>;
+            required: z.ZodBoolean;
+            description: z.ZodOptional<z.ZodString>;
+            alias: z.ZodOptional<z.ZodString>;
+            flag: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            path: string[];
+            type: "string" | "number" | "boolean" | "integer" | "array";
+            required: boolean;
+            flag: string;
+            description?: string | undefined;
+            items?: "string" | "number" | "integer" | undefined;
+            alias?: string | undefined;
+        }, {
+            path: string[];
+            type: "string" | "number" | "boolean" | "integer" | "array";
+            required: boolean;
+            flag: string;
+            description?: string | undefined;
+            items?: "string" | "number" | "integer" | undefined;
+            alias?: string | undefined;
+        }>, "many">;
     }, "strict", z.ZodTypeAny, {
         required: boolean;
         contentType: "application/json";
+        fields: {
+            path: string[];
+            type: "string" | "number" | "boolean" | "integer" | "array";
+            required: boolean;
+            flag: string;
+            description?: string | undefined;
+            items?: "string" | "number" | "integer" | undefined;
+            alias?: string | undefined;
+        }[];
         example?: unknown;
     }, {
         required: boolean;
         contentType: "application/json";
+        fields: {
+            path: string[];
+            type: "string" | "number" | "boolean" | "integer" | "array";
+            required: boolean;
+            flag: string;
+            description?: string | undefined;
+            items?: "string" | "number" | "integer" | undefined;
+            alias?: string | undefined;
+        }[];
         example?: unknown;
     }>>;
+    /** A cursor-paginated list (`{data, has_more, next_cursor, meta}`): `--all`, `--cursor`, JSONL / CSV rows. */
+    list: z.ZodBoolean;
     view: z.ZodEnum<["table", "keyValue", "json"]>;
-    /** Dotted path to the table's rows, or to the ONE object a `keyValue` view shows (absent = the response root). */
-    rowsPath: z.ZodOptional<z.ZodString>;
     columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    pagination: z.ZodEnum<["none", "top", "perCompany"]>;
+    /** The JSON fields of one row (a list's `data[]` item, else the object): `--json a,b` and `--help`. */
+    fields: z.ZodArray<z.ZodString, "many">;
     /**
-     * The arrays `--all` concatenates: top-level paths for `top` (default: `[rowsPath]`), paths under `companies[]`
-     * for `perCompany`. Absent on `none`.
+     * Where the response carries a downloadable file (`{url, sha256?, bytes?, content_type?}`): `""` = the response
+     * root, else a dotted path (`pdf`, `deck`). Present = the command takes `--save <file>`.
      */
-    allItemsPath: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    download: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    method: "get" | "post" | "put" | "patch" | "delete";
+    path: string;
+    auth: boolean;
+    list: boolean;
     params: {
-        type: "string" | "number" | "boolean" | "array" | "integer";
+        type: "string" | "number" | "boolean" | "integer" | "array";
         name: string;
         required: boolean;
-        in: "path" | "query";
+        in: "query" | "path" | "header";
+        flag: string;
         default?: unknown;
         description?: string | undefined;
-        enum?: string[] | undefined;
         items?: "string" | "number" | "integer" | undefined;
+        enum?: string[] | undefined;
+        pattern?: string | undefined;
         example?: unknown;
         alias?: string | undefined;
     }[];
-    method: "get" | "post" | "put" | "patch" | "delete";
-    path: string;
-    group: string;
     operationId: string;
+    group: string;
     action: string;
-    auth: boolean;
     summary: string;
-    view: "json" | "table" | "keyValue";
-    pagination: "none" | "top" | "perCompany";
+    credits: number;
+    tier: string;
+    fields: string[];
+    view: "table" | "json" | "keyValue";
     body?: {
         required: boolean;
         contentType: "application/json";
+        fields: {
+            path: string[];
+            type: "string" | "number" | "boolean" | "integer" | "array";
+            required: boolean;
+            flag: string;
+            description?: string | undefined;
+            items?: "string" | "number" | "integer" | undefined;
+            alias?: string | undefined;
+        }[];
         example?: unknown;
     } | undefined;
+    select?: Record<string, string> | undefined;
+    positional?: {
+        name: string;
+        required: boolean;
+        variadic?: "comma" | "space" | undefined;
+    } | undefined;
     exampleParams?: string[] | undefined;
-    rowsPath?: string | undefined;
     columns?: string[] | undefined;
-    allItemsPath?: string[] | undefined;
+    download?: string | undefined;
 }, {
+    method: "get" | "post" | "put" | "patch" | "delete";
+    path: string;
+    auth: boolean;
+    list: boolean;
     params: {
-        type: "string" | "number" | "boolean" | "array" | "integer";
+        type: "string" | "number" | "boolean" | "integer" | "array";
         name: string;
         required: boolean;
-        in: "path" | "query";
+        in: "query" | "path" | "header";
+        flag: string;
         default?: unknown;
         description?: string | undefined;
-        enum?: string[] | undefined;
         items?: "string" | "number" | "integer" | undefined;
+        enum?: string[] | undefined;
+        pattern?: string | undefined;
         example?: unknown;
         alias?: string | undefined;
     }[];
-    method: "get" | "post" | "put" | "patch" | "delete";
-    path: string;
-    group: string;
     operationId: string;
+    group: string;
     action: string;
-    auth: boolean;
     summary: string;
-    view: "json" | "table" | "keyValue";
-    pagination: "none" | "top" | "perCompany";
+    credits: number;
+    tier: string;
+    fields: string[];
+    view: "table" | "json" | "keyValue";
     body?: {
         required: boolean;
         contentType: "application/json";
+        fields: {
+            path: string[];
+            type: "string" | "number" | "boolean" | "integer" | "array";
+            required: boolean;
+            flag: string;
+            description?: string | undefined;
+            items?: "string" | "number" | "integer" | undefined;
+            alias?: string | undefined;
+        }[];
         example?: unknown;
     } | undefined;
+    select?: Record<string, string> | undefined;
+    positional?: {
+        name: string;
+        required: boolean;
+        variadic?: "comma" | "space" | undefined;
+    } | undefined;
     exampleParams?: string[] | undefined;
-    rowsPath?: string | undefined;
     columns?: string[] | undefined;
-    allItemsPath?: string[] | undefined;
+    download?: string | undefined;
 }>;
 export declare const manifestSchema: z.ZodObject<{
     specVersion: z.ZodString;
@@ -193,234 +339,388 @@ export declare const manifestSchema: z.ZodObject<{
         name: z.ZodString;
         description: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        description: string;
         name: string;
-    }, {
         description: string;
+    }, {
         name: string;
+        description: string;
     }>, "many">;
     operations: z.ZodArray<z.ZodObject<{
         operationId: z.ZodString;
         group: z.ZodString;
-        /** `""` = the group itself is the command (`invd health`). */
+        /** `""` = the group itself is the command (`invd financials`, the `x-cli.command` operations). */
         action: z.ZodString;
         method: z.ZodEnum<["get", "post", "put", "patch", "delete"]>;
         path: z.ZodString;
-        /** `false` = the operation needs no API key (`security: []` or none in the spec): no key is resolved or sent. */
+        /** `false` = the operation needs no API key: no key is resolved or sent. */
         auth: z.ZodBoolean;
         summary: z.ZodString;
+        /** The spec's `x-credits`: the base cost of one response (`--dry-run`, the `--all` confirmation). */
+        credits: z.ZodNumber;
+        /** The spec's `x-tier` (free, lite, standard, pro). */
+        tier: z.ZodString;
         params: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
-            in: z.ZodEnum<["query", "path"]>;
+            in: z.ZodEnum<["query", "path", "header"]>;
             required: z.ZodBoolean;
             type: z.ZodEnum<["string", "integer", "number", "boolean", "array"]>;
             /** Arrays only: the item type; the value is sent as a repeated parameter. */
             items: z.ZodOptional<z.ZodEnum<["string", "integer", "number"]>>;
             /** Allowed values, stringified; on an array they apply to each item. */
             enum: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            /** The spec's `pattern` (comma lists like `income-statement,balance-sheet` are patterns, not arrays). */
+            pattern: z.ZodOptional<z.ZodString>;
             /** Shown in help, never sent — the API applies its own default. */
             default: z.ZodOptional<z.ZodUnknown>;
-            /** The spec's `example`: shown in help and the skill's example line, never sent. */
+            /** The spec's `example`: shown in help and in the examples, never sent. */
             example: z.ZodOptional<z.ZodUnknown>;
             description: z.ZodOptional<z.ZodString>;
             /** One-letter short flag (`-q`). */
             alias: z.ZodOptional<z.ZodString>;
+            /** The long flag without dashes (`filed_at.gte` → `filed-at-gte`). */
+            flag: z.ZodString;
         }, "strict", z.ZodTypeAny, {
-            type: "string" | "number" | "boolean" | "array" | "integer";
+            type: "string" | "number" | "boolean" | "integer" | "array";
             name: string;
             required: boolean;
-            in: "path" | "query";
+            in: "query" | "path" | "header";
+            flag: string;
             default?: unknown;
             description?: string | undefined;
-            enum?: string[] | undefined;
             items?: "string" | "number" | "integer" | undefined;
+            enum?: string[] | undefined;
+            pattern?: string | undefined;
             example?: unknown;
             alias?: string | undefined;
         }, {
-            type: "string" | "number" | "boolean" | "array" | "integer";
+            type: "string" | "number" | "boolean" | "integer" | "array";
             name: string;
             required: boolean;
-            in: "path" | "query";
+            in: "query" | "path" | "header";
+            flag: string;
             default?: unknown;
             description?: string | undefined;
-            enum?: string[] | undefined;
             items?: "string" | "number" | "integer" | undefined;
+            enum?: string[] | undefined;
+            pattern?: string | undefined;
             example?: unknown;
             alias?: string | undefined;
         }>, "many">;
+        /** The parameter the first positional fills: a company list (`AAPL MSFT` → `company=AAPL,MSFT`), a member id, `q`. */
+        positional: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            required: z.ZodBoolean;
+            /** Several words: joined with `,` (a company list) or ` ` (a search text). */
+            variadic: z.ZodOptional<z.ZodEnum<["comma", "space"]>>;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            required: boolean;
+            variadic?: "comma" | "space" | undefined;
+        }, {
+            name: string;
+            required: boolean;
+            variadic?: "comma" | "space" | undefined;
+        }>>;
+        /** One command over several operations (`invd financials`): the `--basis` / `--view` values that pick this one. */
+        select: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         /** The spec's `x-example-params`: the OPTIONAL params an example invocation passes beside the required ones. */
         exampleParams: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         body: z.ZodOptional<z.ZodObject<{
             required: z.ZodBoolean;
             contentType: z.ZodLiteral<"application/json">;
-            /** The spec's request-body `example` (the skill's `--body`). */
+            /** The spec's request-body `example`. */
             example: z.ZodOptional<z.ZodUnknown>;
+            /** Flags for the body's scalar / list properties (`--url`, `--events a,b`, `--ciks` → `filters.ciks`). */
+            fields: z.ZodArray<z.ZodObject<{
+                /** The property's path in the JSON body (`["filters", "ciks"]`). */
+                path: z.ZodArray<z.ZodString, "many">;
+                type: z.ZodEnum<["string", "integer", "number", "boolean", "array"]>;
+                items: z.ZodOptional<z.ZodEnum<["string", "integer", "number"]>>;
+                required: z.ZodBoolean;
+                description: z.ZodOptional<z.ZodString>;
+                alias: z.ZodOptional<z.ZodString>;
+                flag: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }, {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }>, "many">;
         }, "strict", z.ZodTypeAny, {
             required: boolean;
             contentType: "application/json";
+            fields: {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }[];
             example?: unknown;
         }, {
             required: boolean;
             contentType: "application/json";
+            fields: {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }[];
             example?: unknown;
         }>>;
+        /** A cursor-paginated list (`{data, has_more, next_cursor, meta}`): `--all`, `--cursor`, JSONL / CSV rows. */
+        list: z.ZodBoolean;
         view: z.ZodEnum<["table", "keyValue", "json"]>;
-        /** Dotted path to the table's rows, or to the ONE object a `keyValue` view shows (absent = the response root). */
-        rowsPath: z.ZodOptional<z.ZodString>;
         columns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        pagination: z.ZodEnum<["none", "top", "perCompany"]>;
+        /** The JSON fields of one row (a list's `data[]` item, else the object): `--json a,b` and `--help`. */
+        fields: z.ZodArray<z.ZodString, "many">;
         /**
-         * The arrays `--all` concatenates: top-level paths for `top` (default: `[rowsPath]`), paths under `companies[]`
-         * for `perCompany`. Absent on `none`.
+         * Where the response carries a downloadable file (`{url, sha256?, bytes?, content_type?}`): `""` = the response
+         * root, else a dotted path (`pdf`, `deck`). Present = the command takes `--save <file>`.
          */
-        allItemsPath: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        download: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        method: "get" | "post" | "put" | "patch" | "delete";
+        path: string;
+        auth: boolean;
+        list: boolean;
         params: {
-            type: "string" | "number" | "boolean" | "array" | "integer";
+            type: "string" | "number" | "boolean" | "integer" | "array";
             name: string;
             required: boolean;
-            in: "path" | "query";
+            in: "query" | "path" | "header";
+            flag: string;
             default?: unknown;
             description?: string | undefined;
-            enum?: string[] | undefined;
             items?: "string" | "number" | "integer" | undefined;
+            enum?: string[] | undefined;
+            pattern?: string | undefined;
             example?: unknown;
             alias?: string | undefined;
         }[];
-        method: "get" | "post" | "put" | "patch" | "delete";
-        path: string;
-        group: string;
         operationId: string;
+        group: string;
         action: string;
-        auth: boolean;
         summary: string;
-        view: "json" | "table" | "keyValue";
-        pagination: "none" | "top" | "perCompany";
+        credits: number;
+        tier: string;
+        fields: string[];
+        view: "table" | "json" | "keyValue";
         body?: {
             required: boolean;
             contentType: "application/json";
+            fields: {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }[];
             example?: unknown;
         } | undefined;
+        select?: Record<string, string> | undefined;
+        positional?: {
+            name: string;
+            required: boolean;
+            variadic?: "comma" | "space" | undefined;
+        } | undefined;
         exampleParams?: string[] | undefined;
-        rowsPath?: string | undefined;
         columns?: string[] | undefined;
-        allItemsPath?: string[] | undefined;
+        download?: string | undefined;
     }, {
+        method: "get" | "post" | "put" | "patch" | "delete";
+        path: string;
+        auth: boolean;
+        list: boolean;
         params: {
-            type: "string" | "number" | "boolean" | "array" | "integer";
+            type: "string" | "number" | "boolean" | "integer" | "array";
             name: string;
             required: boolean;
-            in: "path" | "query";
+            in: "query" | "path" | "header";
+            flag: string;
             default?: unknown;
             description?: string | undefined;
-            enum?: string[] | undefined;
             items?: "string" | "number" | "integer" | undefined;
+            enum?: string[] | undefined;
+            pattern?: string | undefined;
             example?: unknown;
             alias?: string | undefined;
         }[];
-        method: "get" | "post" | "put" | "patch" | "delete";
-        path: string;
-        group: string;
         operationId: string;
+        group: string;
         action: string;
-        auth: boolean;
         summary: string;
-        view: "json" | "table" | "keyValue";
-        pagination: "none" | "top" | "perCompany";
+        credits: number;
+        tier: string;
+        fields: string[];
+        view: "table" | "json" | "keyValue";
         body?: {
             required: boolean;
             contentType: "application/json";
+            fields: {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }[];
             example?: unknown;
         } | undefined;
+        select?: Record<string, string> | undefined;
+        positional?: {
+            name: string;
+            required: boolean;
+            variadic?: "comma" | "space" | undefined;
+        } | undefined;
         exampleParams?: string[] | undefined;
-        rowsPath?: string | undefined;
         columns?: string[] | undefined;
-        allItemsPath?: string[] | undefined;
+        download?: string | undefined;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
     specVersion: string;
     specSha256: string;
     groups: {
-        description: string;
         name: string;
+        description: string;
     }[];
     operations: {
+        method: "get" | "post" | "put" | "patch" | "delete";
+        path: string;
+        auth: boolean;
+        list: boolean;
         params: {
-            type: "string" | "number" | "boolean" | "array" | "integer";
+            type: "string" | "number" | "boolean" | "integer" | "array";
             name: string;
             required: boolean;
-            in: "path" | "query";
+            in: "query" | "path" | "header";
+            flag: string;
             default?: unknown;
             description?: string | undefined;
-            enum?: string[] | undefined;
             items?: "string" | "number" | "integer" | undefined;
+            enum?: string[] | undefined;
+            pattern?: string | undefined;
             example?: unknown;
             alias?: string | undefined;
         }[];
-        method: "get" | "post" | "put" | "patch" | "delete";
-        path: string;
-        group: string;
         operationId: string;
+        group: string;
         action: string;
-        auth: boolean;
         summary: string;
-        view: "json" | "table" | "keyValue";
-        pagination: "none" | "top" | "perCompany";
+        credits: number;
+        tier: string;
+        fields: string[];
+        view: "table" | "json" | "keyValue";
         body?: {
             required: boolean;
             contentType: "application/json";
+            fields: {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }[];
             example?: unknown;
         } | undefined;
+        select?: Record<string, string> | undefined;
+        positional?: {
+            name: string;
+            required: boolean;
+            variadic?: "comma" | "space" | undefined;
+        } | undefined;
         exampleParams?: string[] | undefined;
-        rowsPath?: string | undefined;
         columns?: string[] | undefined;
-        allItemsPath?: string[] | undefined;
+        download?: string | undefined;
     }[];
 }, {
     specVersion: string;
     specSha256: string;
     groups: {
-        description: string;
         name: string;
+        description: string;
     }[];
     operations: {
+        method: "get" | "post" | "put" | "patch" | "delete";
+        path: string;
+        auth: boolean;
+        list: boolean;
         params: {
-            type: "string" | "number" | "boolean" | "array" | "integer";
+            type: "string" | "number" | "boolean" | "integer" | "array";
             name: string;
             required: boolean;
-            in: "path" | "query";
+            in: "query" | "path" | "header";
+            flag: string;
             default?: unknown;
             description?: string | undefined;
-            enum?: string[] | undefined;
             items?: "string" | "number" | "integer" | undefined;
+            enum?: string[] | undefined;
+            pattern?: string | undefined;
             example?: unknown;
             alias?: string | undefined;
         }[];
-        method: "get" | "post" | "put" | "patch" | "delete";
-        path: string;
-        group: string;
         operationId: string;
+        group: string;
         action: string;
-        auth: boolean;
         summary: string;
-        view: "json" | "table" | "keyValue";
-        pagination: "none" | "top" | "perCompany";
+        credits: number;
+        tier: string;
+        fields: string[];
+        view: "table" | "json" | "keyValue";
         body?: {
             required: boolean;
             contentType: "application/json";
+            fields: {
+                path: string[];
+                type: "string" | "number" | "boolean" | "integer" | "array";
+                required: boolean;
+                flag: string;
+                description?: string | undefined;
+                items?: "string" | "number" | "integer" | undefined;
+                alias?: string | undefined;
+            }[];
             example?: unknown;
         } | undefined;
+        select?: Record<string, string> | undefined;
+        positional?: {
+            name: string;
+            required: boolean;
+            variadic?: "comma" | "space" | undefined;
+        } | undefined;
         exampleParams?: string[] | undefined;
-        rowsPath?: string | undefined;
         columns?: string[] | undefined;
-        allItemsPath?: string[] | undefined;
+        download?: string | undefined;
     }[];
 }>;
 export type ManifestParam = z.infer<typeof manifestParamSchema>;
-/** A param's spec example as its flag takes it: an array comma-joined, anything else as its text. */
-export declare const exampleValue: (example: unknown) => string;
+export type ManifestBodyField = z.infer<typeof bodyFieldSchema>;
 export type ManifestOperation = z.infer<typeof manifestOperationSchema>;
 export type Manifest = z.infer<typeof manifestSchema>;
+/** A param's spec example as its flag takes it: an array comma-joined, anything else as its text. */
+export declare const exampleValue: (example: unknown) => string;
+/** `invd <group> <action>` without the program name (`financials`, `companies get`). */
+export declare const commandName: (operation: Pick<ManifestOperation, "group" | "action">) => string;
 /** Parses a loaded manifest; a corrupt file fails by name rather than registering half a CLI. */
 export declare function parseManifest(raw: unknown, source?: string): Manifest;
 export {};