flowbase-cli 0.1.14__tar.gz → 0.1.16__tar.gz

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.14
+Version: 0.1.16
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -160,6 +160,14 @@ flowbase objects cli-edit-policy update obj_xxx --json '{"baseRevision":4,"polic
 
 `records create` returns `{recordId}`; use it with `records get`.
 
+To add existing objects to an application, pass their IDs with `--object-ids`:
+
+```bash
+flowbase apps add-objects app_xxx --object-ids obj_a,obj_b
+```
+
+Use a comma-separated list for multiple objects. Object IDs are not positional arguments. Run `flowbase docs show apps.objects.add` for the endpoint details.
+
 Record `values` keys are **field keys** (`name`), not internal IDs (`fld_...`). IDs are `obj_`/`fld_`/`dsh_`/`wfl_`/`pag_`/`reg_`/`cmp_`-prefixed; see `docs catalogs id-prefixes`.
 
 ### 6.2 Edit and publish configuration on a test environment
@@ -280,3 +288,77 @@ flowbase roles update rol_xxx --json-file role.json
 - `docs catalogs page-buttons`, `workflow-branches`, `approval-rules`, and `dashboard-runtime` describe complex configuration and runtime limits.
 
 Transport requests time out after 60 seconds. A lost write response has an unknown outcome: read the resource and current revision before retrying. The CLI never automatically retries writes.
+
+### Recent feature authoring
+
+- `flowbase docs catalogs planning`: tree/Gantt view snapshots, candidate queries and optimistic plan updates. Read a full view with `views list` before updating; preserve `displayMode`, `parentFieldId` and `gantt`.
+- `flowbase docs catalogs record-bundles`: initialize, atomically submit and recover a parent/detail submission. Reuse a submission ID only with the identical request body.
+- `flowbase docs catalogs formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Derived values are read-only.
+- `flowbase docs catalogs workflow-python`: record creation examples and failed-task retry. `workflows python-runtime OBJECT new` discovers current object bindings; `workflows executions` includes Python attempts, logs and `canRetry`.
+
+Use `records list OBJECT --view-id VIEW --view-layout` for tree/Gantt projections; the default remains a flat list. `records update` accepts `updatedAt` and `planViewId` in its JSON body for version-checked plan edits. Formula validation/trials require both metadata read and record read; workflow retry requires both metadata write and record write and explicit CLI confirmation (`--yes` in automation).
+
+### Reusable iframe configuration (4.11)
+
+`flowbase iframes list|get|create|update|delete` manages environment-specific iframe drafts. Create/update use `--json-file`; fields are `label`, `icon` (default `IconWorld`), `color` (default `#2563EB`), and a complete HTTPS `url` without credentials. Update and delete require `baseRevision` from `iframes get`; deletion also requires confirmation (`--yes` for noninteractive use).
+
+```bash
+flowbase iframes create --json-file iframe.json
+flowbase iframes get ifr_example
+flowbase iframes update ifr_example --json-file iframe-update.json
+flowbase apps add-iframes app_example ifr_example
+flowbase apps set-iframe-group app_example ifr_example --group-id grp_example
+flowbase apps set-iframe-group app_example ifr_example --ungrouped
+flowbase apps reorder-members app_example --json '{"items":[{"type":"iframe","id":"ifr_example"}]}'
+flowbase apps remove-iframe app_example ifr_example --yes
+flowbase iframes delete ifr_example --json '{"baseRevision":12}' --yes
+```
+
+Removal only unlinks one app. Deletion unlinks all apps atomically. Changes follow the existing commit/release/rollback workflow; they do not fetch, proxy or modify the external website. API keys use `metadata:read`/`metadata:write`; browser roles use `iframe.manage` for shared resources and `app.manage` for app associations.
+
+### Custom object views (4.12)
+
+Read `flowbase docs catalogs custom-views` and `flowbase views list OBJECT` first. Save the following as `view.json`, replacing `baseRevision` with the current `draftRevision`:
+
+```json
+{
+  "baseRevision": 4,
+  "name": "Custom overview",
+  "enabled": false,
+  "defaultFieldIds": [],
+  "displayMode": "custom",
+  "custom": {
+    "runtimeVersion": "cv1",
+    "source": "import React from 'react'; export default function View(){return <div>Hello</div>}"
+  }
+}
+```
+
+```bash
+flowbase views create obj_example --json-file view.json
+flowbase views list obj_example
+flowbase views update obj_example viw_example --json-file view.json
+flowbase views set-enabled obj_example viw_example --base-revision 6 --enabled --yes
+```
+
+Use the revision returned by the preceding write, rather than the example numbers. Custom views start disabled; preview in the browser and enable when ready. Updates replace the writable snapshot: preserve `custom.source`, `custom.runtimeVersion`, `displayMode`, filters and other configuration from `views list`, excluding the response-only `id` and `status`. Built-in/custom view types cannot be converted. JSX source is limited to 512 KiB UTF-8; the runtime supports `react`, `three` and `flowbase`. CLI configuration does not execute browser previews.
+
+### Record detail embedded pages (4.13)
+
+`flowbase docs catalogs page-components` documents `recordEmbed`, supported at the top level or inside tabs of a detail Page. Add this component to an existing region column (or a tab's `components`):
+
+```json
+{
+  "kind": "recordEmbed",
+  "label": "External panel",
+  "showTitle": true,
+  "url": "https://example.com/panel",
+  "height": 480,
+  "allowRead": false,
+  "allowedFieldIds": []
+}
+```
+
+Read `flowbase pages get PAGE`, preserve the existing components and IDs, and remove the read-only Page keys listed in `docs catalogs page-components`. Wrap the editable snapshot as `{"baseRevision":4,"page":{...}}`, then use `flowbase pages update PAGE --json-file page.json` (or `pages create --json-file page.json` for a new detail Page). For creation, omit the Page ID and IDs of new regions/components so the server allocates them.
+
+Height must be an integer from 240 to 1600. URLs must use external HTTPS and exclude credentials, identity/context parameters and templates. To permit SDK reads, set `allowRead: true` and select at least one unique active field ID in `allowedFieldIds`; current record/field permissions still apply. The browser SDK is `/sdk/record-embed.v1.js`. The CLI configures the component; rendering and SDK calls run in the browser. `flowbase-user` has no metadata management commands.

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/README.md

@@ -151,6 +151,14 @@ flowbase objects cli-edit-policy update obj_xxx --json '{"baseRevision":4,"polic
 
 `records create` returns `{recordId}`; use it with `records get`.
 
+To add existing objects to an application, pass their IDs with `--object-ids`:
+
+```bash
+flowbase apps add-objects app_xxx --object-ids obj_a,obj_b
+```
+
+Use a comma-separated list for multiple objects. Object IDs are not positional arguments. Run `flowbase docs show apps.objects.add` for the endpoint details.
+
 Record `values` keys are **field keys** (`name`), not internal IDs (`fld_...`). IDs are `obj_`/`fld_`/`dsh_`/`wfl_`/`pag_`/`reg_`/`cmp_`-prefixed; see `docs catalogs id-prefixes`.
 
 ### 6.2 Edit and publish configuration on a test environment
@@ -271,3 +279,77 @@ flowbase roles update rol_xxx --json-file role.json
 - `docs catalogs page-buttons`, `workflow-branches`, `approval-rules`, and `dashboard-runtime` describe complex configuration and runtime limits.
 
 Transport requests time out after 60 seconds. A lost write response has an unknown outcome: read the resource and current revision before retrying. The CLI never automatically retries writes.
+
+### Recent feature authoring
+
+- `flowbase docs catalogs planning`: tree/Gantt view snapshots, candidate queries and optimistic plan updates. Read a full view with `views list` before updating; preserve `displayMode`, `parentFieldId` and `gantt`.
+- `flowbase docs catalogs record-bundles`: initialize, atomically submit and recover a parent/detail submission. Reuse a submission ID only with the identical request body.
+- `flowbase docs catalogs formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Derived values are read-only.
+- `flowbase docs catalogs workflow-python`: record creation examples and failed-task retry. `workflows python-runtime OBJECT new` discovers current object bindings; `workflows executions` includes Python attempts, logs and `canRetry`.
+
+Use `records list OBJECT --view-id VIEW --view-layout` for tree/Gantt projections; the default remains a flat list. `records update` accepts `updatedAt` and `planViewId` in its JSON body for version-checked plan edits. Formula validation/trials require both metadata read and record read; workflow retry requires both metadata write and record write and explicit CLI confirmation (`--yes` in automation).
+
+### Reusable iframe configuration (4.11)
+
+`flowbase iframes list|get|create|update|delete` manages environment-specific iframe drafts. Create/update use `--json-file`; fields are `label`, `icon` (default `IconWorld`), `color` (default `#2563EB`), and a complete HTTPS `url` without credentials. Update and delete require `baseRevision` from `iframes get`; deletion also requires confirmation (`--yes` for noninteractive use).
+
+```bash
+flowbase iframes create --json-file iframe.json
+flowbase iframes get ifr_example
+flowbase iframes update ifr_example --json-file iframe-update.json
+flowbase apps add-iframes app_example ifr_example
+flowbase apps set-iframe-group app_example ifr_example --group-id grp_example
+flowbase apps set-iframe-group app_example ifr_example --ungrouped
+flowbase apps reorder-members app_example --json '{"items":[{"type":"iframe","id":"ifr_example"}]}'
+flowbase apps remove-iframe app_example ifr_example --yes
+flowbase iframes delete ifr_example --json '{"baseRevision":12}' --yes
+```
+
+Removal only unlinks one app. Deletion unlinks all apps atomically. Changes follow the existing commit/release/rollback workflow; they do not fetch, proxy or modify the external website. API keys use `metadata:read`/`metadata:write`; browser roles use `iframe.manage` for shared resources and `app.manage` for app associations.
+
+### Custom object views (4.12)
+
+Read `flowbase docs catalogs custom-views` and `flowbase views list OBJECT` first. Save the following as `view.json`, replacing `baseRevision` with the current `draftRevision`:
+
+```json
+{
+  "baseRevision": 4,
+  "name": "Custom overview",
+  "enabled": false,
+  "defaultFieldIds": [],
+  "displayMode": "custom",
+  "custom": {
+    "runtimeVersion": "cv1",
+    "source": "import React from 'react'; export default function View(){return <div>Hello</div>}"
+  }
+}
+```
+
+```bash
+flowbase views create obj_example --json-file view.json
+flowbase views list obj_example
+flowbase views update obj_example viw_example --json-file view.json
+flowbase views set-enabled obj_example viw_example --base-revision 6 --enabled --yes
+```
+
+Use the revision returned by the preceding write, rather than the example numbers. Custom views start disabled; preview in the browser and enable when ready. Updates replace the writable snapshot: preserve `custom.source`, `custom.runtimeVersion`, `displayMode`, filters and other configuration from `views list`, excluding the response-only `id` and `status`. Built-in/custom view types cannot be converted. JSX source is limited to 512 KiB UTF-8; the runtime supports `react`, `three` and `flowbase`. CLI configuration does not execute browser previews.
+
+### Record detail embedded pages (4.13)
+
+`flowbase docs catalogs page-components` documents `recordEmbed`, supported at the top level or inside tabs of a detail Page. Add this component to an existing region column (or a tab's `components`):
+
+```json
+{
+  "kind": "recordEmbed",
+  "label": "External panel",
+  "showTitle": true,
+  "url": "https://example.com/panel",
+  "height": 480,
+  "allowRead": false,
+  "allowedFieldIds": []
+}
+```
+
+Read `flowbase pages get PAGE`, preserve the existing components and IDs, and remove the read-only Page keys listed in `docs catalogs page-components`. Wrap the editable snapshot as `{"baseRevision":4,"page":{...}}`, then use `flowbase pages update PAGE --json-file page.json` (or `pages create --json-file page.json` for a new detail Page). For creation, omit the Page ID and IDs of new regions/components so the server allocates them.
+
+Height must be an integer from 240 to 1600. URLs must use external HTTPS and exclude credentials, identity/context parameters and templates. To permit SDK reads, set `allowRead: true` and select at least one unique active field ID in `allowedFieldIds`; current record/field permissions still apply. The browser SDK is `/sdk/record-embed.v1.js`. The CLI configures the component; rendering and SDK calls run in the browser. `flowbase-user` has no metadata management commands.

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flowbase-cli"
-version = "0.1.14"
+version = "0.1.16"
 description = "Command line client for the FlowBase OpenAPI"
 readme = "README.md"
 requires-python = ">=3.11"

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/src/flowbase_cli/__init__.py

@@ -1,3 +1,3 @@
 """FlowBase OpenAPI CLI."""
 
-__version__ = "0.1.14"
+__version__ = "0.1.16"

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/src/flowbase_cli/endpoints.py

@@ -22,6 +22,53 @@ class Endpoint:
 
 
 ENDPOINTS = (
+    Endpoint("iframes.list", "flowbase_iframes_list", "GET", "/iframes", "metadata:read", "List iframe configuration.", "flowbase iframes list", requires_confirmation=False, request_body=None),
+    Endpoint("iframes.get", "flowbase_iframes_get", "GET", "/iframes/{iframe_id}", "metadata:read", "Get iframe configuration.", "flowbase iframes get", requires_confirmation=False, request_body=None),
+    Endpoint("iframes.create", "flowbase_iframes_create", "POST", "/iframes", "metadata:write", "Create iframe configuration.", "flowbase iframes create", requires_confirmation=False, request_body='{"label": "Help", "url": "https://example.com", "icon": "IconWorld", "color": "#2563EB"}'),
+    Endpoint("iframes.update", "flowbase_iframes_update", "PUT", "/iframes/{iframe_id}", "metadata:write", "Update iframe configuration.", "flowbase iframes update", requires_confirmation=False, request_body='{"label": "Help", "url": "https://example.com", "icon": "IconWorld", "color": "#2563EB", "baseRevision": 0}'),
+    Endpoint("iframes.delete", "flowbase_iframes_delete", "POST", "/iframes/{iframe_id}/delete", "metadata:write", "Delete iframe configuration.", "flowbase iframes delete", requires_confirmation=True, request_body='{"baseRevision": 0}'),
+    Endpoint(
+        "apps.iframes.add",
+        "flowbase_apps_iframes_add",
+        "POST",
+        "/apps/{app_id}/iframes",
+        "metadata:write",
+        "Add iframes to an app (association only).",
+        "flowbase apps add-iframes app_xxx ifr_xxx",
+        request_body='{"iframeIds":["ifr_xxx"]}',
+    ),
+    Endpoint(
+        "apps.iframes.remove",
+        "flowbase_apps_iframes_remove",
+        "DELETE",
+        "/apps/{app_id}/iframes/{iframe_id}",
+        "metadata:write",
+        "Remove a iframe association from an app.",
+        "flowbase apps remove-iframe app_xxx ifr_xxx --yes",
+        True,
+    ),
+    Endpoint(
+        "apps.iframes.set-group",
+        "flowbase_apps_iframes_set_group",
+        "POST",
+        "/apps/{app_id}/iframes/{iframe_id}/group",
+        "metadata:write",
+        "Move an app-linked iframe into a group or ungroup it.",
+        "flowbase apps set-iframe-group app_xxx ifr_xxx --group-id grp_xxx",
+        request_body='{"groupId":"grp_xxx"}',
+    ),
+
+    Endpoint('formulas.sources', 'flowbase_formulas_sources', 'GET', '/objects/{object_id}/formula/sources', 'metadata:read', 'Discover scalar formula sources in the draft.', 'flowbase formulas sources obj_xxx'),
+    Endpoint('formulas.collections', 'flowbase_formulas_collections', 'GET', '/objects/{object_id}/formula/collections', 'metadata:read', 'Discover collection object and field IDs in the draft.', 'flowbase formulas collections obj_xxx'),
+    Endpoint('formulas.validate', 'flowbase_formulas_validate', 'POST', '/objects/{object_id}/formula/validate', 'metadata:read', 'Validate formula or rollup; trial also supported. Requires records:read. No writes.', 'flowbase formulas validate obj_xxx --json-file formula.json', request_body='{"constraints":{"expression":"amount * 2","resultType":"number","scale":2},"samples":{"amount":12.50},"trial":true}'),
+    Endpoint('records.formula-preview', 'flowbase_records_formula_preview', 'POST', '/objects/{object_id}/formula-preview', 'records:read', 'Preview runtime formulas without saving. New rollups remain pending; saved rollups use saved data.', 'flowbase records formula-preview obj_xxx --json-file preview.json', request_body='{"values":{"amount":12.50}}'),
+    Endpoint('records.bundle-init', 'flowbase_records_bundle_init', 'GET', '/objects/{object_id}/bundle/init', 'records:read', 'Load configuration and collection versions before an atomic write.', 'flowbase records bundle-init obj_xxx --record-id rec_xxx'),
+    Endpoint('records.bundle-save', 'flowbase_records_bundle_save', 'POST', '/objects/{object_id}/bundle', 'records:write', 'Atomically save parent and configured related rows. Reuse submissionId only for identical retries.', 'flowbase records bundle-save obj_xxx --json-file bundle.json', request_body='{"submissionId":"unique-submission-0001","configVersion":"from-bundle-init","values":{"name":"Order"},"components":[]}'),
+    Endpoint('records.bundle-status', 'flowbase_records_bundle_status', 'GET', '/objects/{object_id}/bundle/submissions/{submission_id}', 'records:read', "Query this API key's submission receipt after a timeout; unknown does not prove failure.", 'flowbase records bundle-status obj_xxx unique-submission-0001'),
+    Endpoint('records.hierarchy-candidates', 'flowbase_records_hierarchy_candidates', 'GET', '/objects/{object_id}/hierarchy/candidates', 'records:read', 'Discover eligible parent records, excluding self and descendants.', 'flowbase records hierarchy-candidates obj_xxx --field fld_parent --exclude rec_xxx'),
+    Endpoint('records.gantt-candidates', 'flowbase_records_gantt_candidates', 'GET', '/objects/{object_id}/gantt/candidates', 'records:read', 'Discover eligible predecessors, excluding cycles and hierarchy conflicts.', 'flowbase records gantt-candidates obj_xxx --field fld_predecessors --exclude rec_xxx'),
+    Endpoint('workflows.python-runtime', 'flowbase_workflows_python_runtime', 'GET', '/objects/{object_id}/workflows/{workflow_id}/python-runtime', 'metadata:read', 'Discover Python APIs and creation methods. Use workflow ID new before creation.', 'flowbase workflows python-runtime obj_xxx new'),
+    Endpoint('workflows.retry', 'flowbase_workflows_retry', 'POST', '/objects/{object_id}/workflows/{workflow_id}/executions/{execution_id}/retry', 'metadata:write', 'Retry a failed Python execution; also requires records:write.', 'flowbase workflows retry obj_xxx wfl_xxx exe_xxx --yes', requires_confirmation=True),
     Endpoint("pages.evaluate", "flowbase_pages_evaluate", "POST", "/pages/{page_id}/evaluate", "metadata:read", "Evaluate draft page rule effects on sample field-key values; no writes or visual rendering.", "flowbase pages evaluate pag_xxx --json-file values.json", request_body='{"values":{"done":true}}'),
     Endpoint("dashboards.run", "flowbase_dashboards_run", "POST", "/dashboards/{dashboard_id}/components/{component_id}/run", "metadata:read", "Run a saved draft component; also requires records:read. Inspect ok/output/error, not visual rendering.", "flowbase dashboards run dsh_xxx dcm_xxx --json-file filters.json", request_body='{"filterValues":{}}'),
     Endpoint("organization.employees", "flowbase_organization_employees", "GET", "/organization/employees", "metadata:read", "Paginated employee IDs/names; follow pages with --page, optionally --query.", "flowbase organization employees --page 1"),
@@ -245,15 +292,15 @@ ENDPOINTS = (
                  '"filters":['
                  '{"fieldId":"fld_status","operator":"eq","value":"opt_xxx"},'
                  '{"fieldId":"fld_done","operator":"is_true"}'
-                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null}'
+                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null,"displayMode":"table","parentFieldId":null,"gantt":{}}'
              )),
-    Endpoint("views.update", "flowbase_views_update", "PUT", "/objects/{object_id}/views/{view_id}", "metadata:write", "Update an object view draft.", "flowbase views update obj_xxx viw_xxx --json-file view.json",
+    Endpoint("views.update", "flowbase_views_update", "PUT", "/objects/{object_id}/views/{view_id}", "metadata:write", "Update a complete view snapshot. Preserve displayMode, parentFieldId, gantt and custom from views.list; Read custom-views catalog for JSX configuration; omitted fields use defaults.", "flowbase views update obj_xxx viw_xxx --json-file view.json",
              request_body=(
                  '{"baseRevision":4,"name":"Active","enabled":true,"match":"all",'
                  '"filters":['
                  '{"fieldId":"fld_status","operator":"eq","value":"opt_xxx"},'
                  '{"fieldId":"fld_done","operator":"is_true"}'
-                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null}'
+                 '],"defaultFieldIds":["fld_a","fld_b"],"groupFieldId":null,"displayMode":"table","parentFieldId":null,"gantt":{}}'
              )),
     Endpoint("views.reorder", "flowbase_views_reorder", "PUT", "/objects/{object_id}/views/order", "metadata:write", "Reorder object views.", "flowbase views reorder obj_xxx --json '{\"baseRevision\":4,\"viewIds\":[\"viw_xxx\"]}'",
              request_body='{"baseRevision":4,"viewIds":["viw_a","viw_b"]}'),
@@ -625,6 +672,17 @@ def _field_type(
 
 
 FIELD_TYPES = (
+    _field_type(
+        "rollup", ("source", "operation", "resultType", "scale", "currency", "unit"),
+        writable=False, record_value="derived scalar | null; omit on writes; see formulaStates",
+        extra={"permissions": ["readonly", "hidden"], "operations": ["sum", "avg", "count", "count_values", "min", "max"], "sourceModes": ["reverse", "forward", "children"]},
+    ),
+    _field_type(
+        "formula", ("expression", "resultType", "scale", "currency", "bindings", "languageVersion", "collections"),
+        writable=False, record_value="derived scalar | null; omit on writes; see formulaStates for failures",
+        extra={"permissions": ["readonly", "hidden"], "resultTypes": ["number", "number.currency", "number.percent", "text.singleLine", "date", "boolean"],
+               "createExample": {"label": "Total", "key": "total", "description": "Calculated total", "type": "formula", "typeVersion": "v1", "permission": "readonly", "constraints": {"expression": "quantity * unit_price", "resultType": "number", "scale": 2}}},
+    ),
     _field_type(
         "text.singleLine", ("maxLength", "minLength", "placeholder", "unique"),
         filter_operators=_TEXT_FILTERS, record_value="string | null",
@@ -1018,7 +1076,7 @@ APPROVAL_NODE_TYPES = (
 )
 
 FUNCTION_PERMISSIONS = (
-    "workspace.access", "app.manage", "object.manage", "dashboard.manage", "form.manage",
+    "workspace.access", "app.manage", "object.manage", "dashboard.manage", "form.manage", "iframe.manage",
     "version.manage", "org.manage", "system.manage",
 )
 
@@ -1066,7 +1124,7 @@ PAGE_COMPONENTS = {
         ),
         "detailOnlyKinds": (
             "relatedList", "approval", "detailSummary", "stageBar", "tabs",
-            "relatedSummary", "attachmentCard", "noticeBlock",
+            "relatedSummary", "attachmentCard", "noticeBlock", "recordEmbed",
         ),
     },
     "kinds": (
@@ -1099,7 +1157,8 @@ PAGE_COMPONENTS = {
                 "kind", "label", "hideLabel", "objectId", "relationFieldId",
                 "columnFieldIds", "sort", "limit", "showViewAll", "createAction",
             ),
-            "optionalKeys": ("id", "filters", "carryIns"),
+            "optionalKeys": ("id", "filters", "carryIns", "editMode", "editOptions", "editColumns"),
+            "editMode": {"withParent": "Atomic editing on create/detail pages; initialize with records bundle-init, then bundle-save."},
             "limit": (5, 10, 20),
             "sortDirections": ("asc", "desc"),
             "carryInSources": (
@@ -1184,7 +1243,7 @@ PAGE_COMPONENTS = {
                 "minimumComponents": 1,
                 "allowedChildKinds": (
                     "field", "relatedList", "approval", "stageBar",
-                    "relatedSummary", "attachmentCard", "noticeBlock",
+                    "relatedSummary", "attachmentCard", "noticeBlock", "recordEmbed",
                 ),
             },
             "note": "defaultTabId must reference a tab in this component; tabs cannot be nested.",
@@ -1225,6 +1284,22 @@ PAGE_COMPONENTS = {
                 "titleLengthWhenShown": (1, 50),
             },
         },
+        {
+            "kind": "recordEmbed",
+            "name": "record detail embedded page",
+            "pageTypes": ("detail",),
+            "placement": ("topLevel", "tabs"),
+            "requiredKeys": ("kind", "label", "url"),
+            "optionalKeys": ("id", "showTitle", "height", "allowRead", "allowedFieldIds"),
+            "defaults": {"showTitle": True, "height": 480, "allowRead": False, "allowedFieldIds": []},
+            "constraints": {
+                "labelLength": (1, 80),
+                "height": "integer, 240–1600",
+                "url": "External HTTPS only; no credentials, identity/context parameters, templates, localhost or FlowBase hosts.",
+                "allowedFieldIds": "Unique active field IDs on the Page object; at least one when allowRead=true. Runtime reads also enforce current record and field permissions.",
+            },
+            "runtime": "Browser SDK /sdk/record-embed.v1.js; read-only bridge. CLI authors configuration and does not render or execute the embed.",
+        },
         {
             "kind": "noticeBlock",
             "name": "notice block",
@@ -1300,7 +1375,7 @@ PAGE_RULES = {
             "states": ("visible", "hidden"),
             "targetKinds": (
                 "relatedList", "approval", "detailSummary", "stageBar", "tabs",
-                "relatedSummary", "attachmentCard", "noticeBlock",
+                "relatedSummary", "attachmentCard", "noticeBlock", "recordEmbed",
             ),
             "excludedTargets": ("field", "region", "tab", "button", "systemArea"),
             "sameRuleUniqueTarget": True,
@@ -1519,6 +1594,38 @@ FORMS = {
 }
 
 CATALOGS = {
+    "custom-views": {
+        "commands": "views list/create/update/set-enabled/delete; create/update accept --json-file.",
+        "example": {"baseRevision": 4, "name": "Custom", "enabled": False, "defaultFieldIds": [], "displayMode": "custom", "custom": {"runtimeVersion": "cv1", "source": "import React from 'react'; export default function View(){return <div>Hello</div>}"}},
+        "update": "Read views.list; preserve custom.source, custom.runtimeVersion, displayMode and the other writable snapshot fields. Use draftRevision as baseRevision; omit response-only id and status from the body.",
+        "constraints": "Custom views start disabled; enable separately after validation. Built-in and custom views cannot convert into each other. custom contains exactly source and runtimeVersion=cv1; source must be nonempty and at most 512 KiB UTF-8.",
+        "runtime": "Sandboxed browser JSX, with react/three/flowbase imports. CLI saves configuration; browser preview/read bridge is not exposed as an API-key CLI command.",
+    },
+    "planning": {
+        "viewUpdate": "Read views.list, preserve the complete snapshot, then views.update with baseRevision. Omitting displayMode/parentFieldId/gantt resets them to table/null/{}.",
+        "tree": {"displayMode": "tree", "parentFieldId": "fld_parent", "gantt": {}},
+        "gantt": {"displayMode": "gantt", "parentFieldId": None, "gantt": {"startFieldId": "fld_start", "endFieldId": "fld_end", "predecessorFieldId": "fld_dependencies"}},
+        "read": "records list OBJECT --view-id VIEW --view-layout; use --parent, --root, --locate and --hierarchy-version for tree navigation. Default is flat.",
+        "write": {"values": {"start": "2026-10-24", "end": "2026-10-25"}, "planViewId": "viw_plan", "updatedAt": "from-records-get"},
+        "candidates": "records hierarchy-candidates / gantt-candidates use field IDs. Record values use field keys.",
+    },
+    "record-bundles": {
+        "steps": ["Configure relatedList editMode=withParent on the default create/detail page.", "records bundle-init OBJECT [--record-id RECORD] returns configVersion, updatedAt and component collection versions.", "records bundle-save OBJECT --json-file bundle.json commits the entire write set or rolls back.", "After a timeout, bundle-status OBJECT SUBMISSION; retry only the identical body with the same submissionId."],
+        "example": {"submissionId": "unique-submission-0001", "configVersion": "from-init", "recordId": "rec_parent", "updatedAt": "from-init", "values": {}, "components": [{"componentId": "cmp_lines", "version": 1, "rows": [{"clientId": "line-1", "operation": "create", "values": {"quantity": 2}}]}]},
+        "rules": "Copy every visible component and its version. Update/delete rows also require recordId and updatedAt. Relation is injected by the server; omit it from row values. API-key receipts are isolated per key. Conflict: reload, reconcile and use a new submissionId. Max 200 resulting detail rows.",
+    },
+    "formula-authoring": {
+        "steps": ["formulas sources OBJECT discovers scalar paths; formulas collections OBJECT discovers stable object/field IDs.", "formulas validate OBJECT --json-file formula.json validates constraints; trial=true uses samples or a saved recordId.", "fields create/update saves metadata. records formula-preview previews runtime values without saving."],
+        "rollupExample": {"fieldType": "rollup", "constraints": {"source": {"mode": "reverse", "objectId": "obj_lines", "relationFieldId": "fld_order", "fieldId": "fld_amount"}, "operation": "sum", "resultType": "number", "scale": 2}, "trial": True, "recordId": "rec_order"},
+        "collectionExample": {"expression": "sum(lines)", "resultType": "number", "scale": 2, "languageVersion": 2, "collections": {"lines": {"mode": "reverse", "objectId": "obj_lines", "relationFieldId": "fld_order", "fieldId": "fld_amount"}}},
+        "readOnly": "formula/rollup values cannot be written, filtered, sorted or SQL-aggregated through the employee CLI. Read results and formulaStates instead.",
+    },
+    "workflow-python": {
+        "discover": "workflows python-runtime OBJECT new (or WORKFLOW) returns creationObjects, relation bindings and limits.",
+        "example": 'import flowbase\n\ndef run():\n    first = flowbase.records.create(object="task", values={"title": "Review"})\n    others = flowbase.records.create_many(object="task", records=[{"title": "Prepare"}])\n    flowbase.records.update(first, values={"title": "Review order"})\n',
+        "atomicity": "Creates and updates commit together after successful execution. Use object/field keys, writable ordinary fields, and returned handles. At most 100 created+updated records.",
+        "retry": "workflows executions OBJECT WORKFLOW lists results; workflows retry OBJECT WORKFLOW EXECUTION --yes retries eligible failed tasks using the original task contract.",
+    },
     "workflow-branches": WORKFLOW_BRANCHES,
     "approval-rules": APPROVAL_RULES,
     "page-buttons": PAGE_BUTTONS,

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/src/flowbase_cli/main.py

@@ -467,6 +467,35 @@ def handle_apps(args: argparse.Namespace) -> int:
             path_params={"app_id": args.app_id, "dashboard_id": args.dashboard_id},
             body=body,
         )
+    if action == "add-iframes":
+        ids = [item.strip() for item in args.iframe_ids if item.strip()]
+        if not ids:
+            raise CliError("Provide at least one iframe ID.")
+        return run_request(
+            args,
+            "apps.iframes.add",
+            path_params={"app_id": args.app_id},
+            body={"iframeIds": ids},
+        )
+    if action == "remove-iframe":
+        return run_request(
+            args,
+            "apps.iframes.remove",
+            path_params={"app_id": args.app_id, "iframe_id": args.iframe_id},
+        )
+    if action == "set-iframe-group":
+        if args.ungrouped:
+            body = {"groupId": None}
+        elif args.group_id is not None:
+            body = {"groupId": args.group_id}
+        else:
+            raise CliError("Provide --group-id or --ungrouped.")
+        return run_request(
+            args,
+            "apps.iframes.set-group",
+            path_params={"app_id": args.app_id, "iframe_id": args.iframe_id},
+            body=body,
+        )
     if action == "reorder-members":
         body = _payload_from_args(args, {}, ("items",))
         if not isinstance(body["items"], list):
@@ -522,6 +551,13 @@ def handle_dashboards(args: argparse.Namespace) -> int:
     )
 
 
+def handle_iframes(args: argparse.Namespace) -> int:
+    action = args.iframes_action
+    params = {"iframe_id": args.iframe_id} if action in ("get", "update", "delete") else None
+    body = load_json_payload(args.json, args.json_file) if action in ("create", "update", "delete") else None
+    return run_request(args, f"iframes.{action}", path_params=params, body=body)
+
+
 def handle_forms(args: argparse.Namespace) -> int:
     action = args.forms_action
     if action == "list":
@@ -681,6 +717,10 @@ def handle_workflows(args: argparse.Namespace) -> int:
     path = {"object_id": args.object_id}
     if hasattr(args, "workflow_id"):
         path["workflow_id"] = args.workflow_id
+    if action in ("python-runtime", "retry"):
+        if action == "retry":
+            path["execution_id"] = args.execution_id
+        return run_request(args, f"workflows.{action}", path_params=path)
     if action == "list":
         return run_request(args, "workflows.list", path_params=path)
     if action == "get":
@@ -941,8 +981,26 @@ def handle_environments(args: argparse.Namespace) -> int:
     return 0
 
 
+def handle_formulas(args: argparse.Namespace) -> int:
+    body = load_json_payload(args.json, args.json_file) if args.formulas_action == "validate" else None
+    return run_request(args, f"formulas.{args.formulas_action}", path_params={"object_id": args.object_id}, body=body)
+
+
 def handle_records(args: argparse.Namespace) -> int:
     action = args.records_action
+    if action in ("bundle-init", "bundle-status", "bundle-save", "formula-preview", "hierarchy-candidates", "gantt-candidates"):
+        path = {"object_id": args.object_id}
+        query = {}
+        body = None
+        if action == "bundle-init":
+            query = {"record_id": args.record_id}
+        elif action == "bundle-status":
+            path["submission_id"] = args.submission_id
+        elif action in ("bundle-save", "formula-preview"):
+            body = load_json_payload(args.json, args.json_file)
+        else:
+            query = {"field": args.field, "exclude": args.exclude, "q": args.query}
+        return run_request(args, f"records.{action}", path_params=path, query=query, body=body)
     path = {"object_id": args.object_id}
     if action == "upload-attachment":
         body, content_type = multipart_upload(args.file)
@@ -972,7 +1030,7 @@ def handle_records(args: argparse.Namespace) -> int:
     if hasattr(args, "record_id"):
         path["record_id"] = args.record_id
     if action == "list":
-        return run_request(args, "records.list", path_params=path, query={"page": args.page, "viewId": args.view_id})
+        return run_request(args, "records.list", path_params=path, query={"page": args.page, "viewId": args.view_id, **({"flat": "false"} if args.view_layout else {}), **{key: value for key, value in {"root": args.root, "parent": args.parent, "locate": args.locate, "hierarchyVersion": args.hierarchy_version}.items() if value is not None}})
     if action == "get" or action == "delete":
         return run_request(args, f"records.{action}", path_params=path)
     body = load_json_payload(args.json, args.json_file)
@@ -1140,6 +1198,26 @@ def build_parser() -> argparse.ArgumentParser:
         action="store_true",
         help="Remove the dashboard from its current group in this app.",
     )
+    app_add_iframes = app_actions.add_parser("add-iframes")
+    app_add_iframes.add_argument("app_id")
+    app_add_iframes.add_argument(
+        "iframe_ids",
+        nargs="+",
+        help="One or more iframe IDs to associate with the app.",
+    )
+    app_remove_iframe = app_actions.add_parser("remove-iframe")
+    app_remove_iframe.add_argument("app_id")
+    app_remove_iframe.add_argument("iframe_id")
+    add_yes(app_remove_iframe)
+    app_set_iframe_group = app_actions.add_parser("set-iframe-group")
+    app_set_iframe_group.add_argument("app_id")
+    app_set_iframe_group.add_argument("iframe_id")
+    app_set_iframe_group.add_argument("--group-id", help="Target group ID. Omit with --ungrouped.")
+    app_set_iframe_group.add_argument(
+        "--ungrouped",
+        action="store_true",
+        help="Remove the iframe from its current group in this app.",
+    )
     app_reorder_members = app_actions.add_parser("reorder-members")
     app_reorder_members.add_argument("app_id")
     add_json_args(app_reorder_members, endpoint_key="apps.members.reorder")
@@ -1170,6 +1248,18 @@ def build_parser() -> argparse.ArgumentParser:
     add_yes(dashboard_delete)
     dashboards.set_defaults(handler=handle_dashboards)
 
+    iframes = groups.add_parser("iframes", help="Manage reusable iframe configurations.")
+    iframe_actions = iframes.add_subparsers(dest="iframes_action", required=True)
+    for action in ("list", "get", "create", "update", "delete"):
+        command = iframe_actions.add_parser(action)
+        if action in ("get", "update", "delete"):
+            command.add_argument("iframe_id")
+        if action in ("create", "update", "delete"):
+            add_json_args(command, endpoint_key=f"iframes.{action}")
+        if action == "delete":
+            add_yes(command)
+    iframes.set_defaults(handler=handle_iframes)
+
     forms = groups.add_parser("forms", help="Manage custom forms (public collection links).")
     form_actions = forms.add_subparsers(dest="forms_action", required=True)
     form_actions.add_parser("list")
@@ -1336,6 +1426,14 @@ def build_parser() -> argparse.ArgumentParser:
     workflow_executions.add_argument("object_id")
     workflow_executions.add_argument("workflow_id")
     workflow_executions.add_argument("--result", choices=("success", "failure"))
+    runtime_help = workflow_actions.add_parser("python-runtime")
+    runtime_help.add_argument("object_id")
+    runtime_help.add_argument("workflow_id", help="Use new for a workflow not yet created.")
+    retry = workflow_actions.add_parser("retry")
+    retry.add_argument("object_id")
+    retry.add_argument("workflow_id")
+    retry.add_argument("execution_id")
+    add_yes(retry)
     workflows.set_defaults(handler=handle_workflows)
 
     approvals = groups.add_parser("approvals", help="Manage object approval flow metadata.")
@@ -1473,6 +1571,11 @@ def build_parser() -> argparse.ArgumentParser:
     record_list = record_actions.add_parser("list")
     record_list.add_argument("object_id")
     record_list.add_argument("--page", type=int, default=1)
+    record_list.add_argument("--view-layout", action="store_true", help="Return tree/Gantt projection instead of the default flat list.")
+    record_list.add_argument("--root")
+    record_list.add_argument("--parent")
+    record_list.add_argument("--locate")
+    record_list.add_argument("--hierarchy-version")
     record_list.add_argument("--view-id", help="Select a view returned by views list.")
     record_get = record_actions.add_parser("get")
     record_get.add_argument("object_id")
@@ -1497,6 +1600,19 @@ def build_parser() -> argparse.ArgumentParser:
     record_delete.add_argument("object_id")
     record_delete.add_argument("record_id")
     add_yes(record_delete)
+    for action in ("bundle-init", "bundle-status", "bundle-save", "formula-preview", "hierarchy-candidates", "gantt-candidates"):
+        item = record_actions.add_parser(action)
+        item.add_argument("object_id")
+        if action == "bundle-init":
+            item.add_argument("--record-id")
+        elif action == "bundle-status":
+            item.add_argument("submission_id")
+        elif action in ("bundle-save", "formula-preview"):
+            add_json_args(item, endpoint_key=f"records.{action}")
+        else:
+            item.add_argument("--field", required=True, help="Stable field ID.")
+            item.add_argument("--exclude", required=action == "gantt-candidates", default="")
+            item.add_argument("--query", default="")
     records.set_defaults(handler=handle_records)
 
     roles = groups.add_parser("roles", help="Manage organization roles (production Host only).")
@@ -1516,6 +1632,14 @@ def build_parser() -> argparse.ArgumentParser:
     role_delete.add_argument("role_id")
     add_yes(role_delete)
     roles.set_defaults(handler=handle_roles)
+    formulas = groups.add_parser("formulas", help="Discover, validate and trial formula/rollup fields.")
+    formula_actions = formulas.add_subparsers(dest="formulas_action", required=True)
+    for action in ("sources", "collections", "validate"):
+        item = formula_actions.add_parser(action)
+        item.add_argument("object_id")
+        if action == "validate":
+            add_json_args(item, endpoint_key="formulas.validate")
+    formulas.set_defaults(handler=handle_formulas)
     return parser
 
 

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/src/flowbase_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flowbase-cli
-Version: 0.1.14
+Version: 0.1.16
 Summary: Command line client for the FlowBase OpenAPI
 Author: DeepFlowAI
 License: Apache-2.0
@@ -160,6 +160,14 @@ flowbase objects cli-edit-policy update obj_xxx --json '{"baseRevision":4,"polic
 
 `records create` returns `{recordId}`; use it with `records get`.
 
+To add existing objects to an application, pass their IDs with `--object-ids`:
+
+```bash
+flowbase apps add-objects app_xxx --object-ids obj_a,obj_b
+```
+
+Use a comma-separated list for multiple objects. Object IDs are not positional arguments. Run `flowbase docs show apps.objects.add` for the endpoint details.
+
 Record `values` keys are **field keys** (`name`), not internal IDs (`fld_...`). IDs are `obj_`/`fld_`/`dsh_`/`wfl_`/`pag_`/`reg_`/`cmp_`-prefixed; see `docs catalogs id-prefixes`.
 
 ### 6.2 Edit and publish configuration on a test environment
@@ -280,3 +288,77 @@ flowbase roles update rol_xxx --json-file role.json
 - `docs catalogs page-buttons`, `workflow-branches`, `approval-rules`, and `dashboard-runtime` describe complex configuration and runtime limits.
 
 Transport requests time out after 60 seconds. A lost write response has an unknown outcome: read the resource and current revision before retrying. The CLI never automatically retries writes.
+
+### Recent feature authoring
+
+- `flowbase docs catalogs planning`: tree/Gantt view snapshots, candidate queries and optimistic plan updates. Read a full view with `views list` before updating; preserve `displayMode`, `parentFieldId` and `gantt`.
+- `flowbase docs catalogs record-bundles`: initialize, atomically submit and recover a parent/detail submission. Reuse a submission ID only with the identical request body.
+- `flowbase docs catalogs formula-authoring`: formula/rollup sources, validation, saved-record trials and runtime draft preview. Derived values are read-only.
+- `flowbase docs catalogs workflow-python`: record creation examples and failed-task retry. `workflows python-runtime OBJECT new` discovers current object bindings; `workflows executions` includes Python attempts, logs and `canRetry`.
+
+Use `records list OBJECT --view-id VIEW --view-layout` for tree/Gantt projections; the default remains a flat list. `records update` accepts `updatedAt` and `planViewId` in its JSON body for version-checked plan edits. Formula validation/trials require both metadata read and record read; workflow retry requires both metadata write and record write and explicit CLI confirmation (`--yes` in automation).
+
+### Reusable iframe configuration (4.11)
+
+`flowbase iframes list|get|create|update|delete` manages environment-specific iframe drafts. Create/update use `--json-file`; fields are `label`, `icon` (default `IconWorld`), `color` (default `#2563EB`), and a complete HTTPS `url` without credentials. Update and delete require `baseRevision` from `iframes get`; deletion also requires confirmation (`--yes` for noninteractive use).
+
+```bash
+flowbase iframes create --json-file iframe.json
+flowbase iframes get ifr_example
+flowbase iframes update ifr_example --json-file iframe-update.json
+flowbase apps add-iframes app_example ifr_example
+flowbase apps set-iframe-group app_example ifr_example --group-id grp_example
+flowbase apps set-iframe-group app_example ifr_example --ungrouped
+flowbase apps reorder-members app_example --json '{"items":[{"type":"iframe","id":"ifr_example"}]}'
+flowbase apps remove-iframe app_example ifr_example --yes
+flowbase iframes delete ifr_example --json '{"baseRevision":12}' --yes
+```
+
+Removal only unlinks one app. Deletion unlinks all apps atomically. Changes follow the existing commit/release/rollback workflow; they do not fetch, proxy or modify the external website. API keys use `metadata:read`/`metadata:write`; browser roles use `iframe.manage` for shared resources and `app.manage` for app associations.
+
+### Custom object views (4.12)
+
+Read `flowbase docs catalogs custom-views` and `flowbase views list OBJECT` first. Save the following as `view.json`, replacing `baseRevision` with the current `draftRevision`:
+
+```json
+{
+  "baseRevision": 4,
+  "name": "Custom overview",
+  "enabled": false,
+  "defaultFieldIds": [],
+  "displayMode": "custom",
+  "custom": {
+    "runtimeVersion": "cv1",
+    "source": "import React from 'react'; export default function View(){return <div>Hello</div>}"
+  }
+}
+```
+
+```bash
+flowbase views create obj_example --json-file view.json
+flowbase views list obj_example
+flowbase views update obj_example viw_example --json-file view.json
+flowbase views set-enabled obj_example viw_example --base-revision 6 --enabled --yes
+```
+
+Use the revision returned by the preceding write, rather than the example numbers. Custom views start disabled; preview in the browser and enable when ready. Updates replace the writable snapshot: preserve `custom.source`, `custom.runtimeVersion`, `displayMode`, filters and other configuration from `views list`, excluding the response-only `id` and `status`. Built-in/custom view types cannot be converted. JSX source is limited to 512 KiB UTF-8; the runtime supports `react`, `three` and `flowbase`. CLI configuration does not execute browser previews.
+
+### Record detail embedded pages (4.13)
+
+`flowbase docs catalogs page-components` documents `recordEmbed`, supported at the top level or inside tabs of a detail Page. Add this component to an existing region column (or a tab's `components`):
+
+```json
+{
+  "kind": "recordEmbed",
+  "label": "External panel",
+  "showTitle": true,
+  "url": "https://example.com/panel",
+  "height": 480,
+  "allowRead": false,
+  "allowedFieldIds": []
+}
+```
+
+Read `flowbase pages get PAGE`, preserve the existing components and IDs, and remove the read-only Page keys listed in `docs catalogs page-components`. Wrap the editable snapshot as `{"baseRevision":4,"page":{...}}`, then use `flowbase pages update PAGE --json-file page.json` (or `pages create --json-file page.json` for a new detail Page). For creation, omit the Page ID and IDs of new regions/components so the server allocates them.
+
+Height must be an integer from 240 to 1600. URLs must use external HTTPS and exclude credentials, identity/context parameters and templates. To permit SDK reads, set `allowRead: true` and select at least one unique active field ID in `allowedFieldIds`; current record/field permissions still apply. The browser SDK is `/sdk/record-embed.v1.js`. The CLI configures the component; rendering and SDK calls run in the browser. `flowbase-user` has no metadata management commands.

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/src/flowbase_cli.egg-info/SOURCES.txt

@@ -10,4 +10,6 @@ src/flowbase_cli.egg-info/dependency_links.txt
 src/flowbase_cli.egg-info/entry_points.txt
 src/flowbase_cli.egg-info/top_level.txt
 tests/test_autonomy.py
-tests/test_cli.py
+tests/test_cli.py
+tests/test_iframes.py
+tests/test_recent_commands.py

{flowbase_cli-0.1.14 → flowbase_cli-0.1.16}/tests/test_cli.py

@@ -191,7 +191,7 @@ class FlowBaseCliTest(unittest.TestCase):
         self.assertEqual(code, 0)
         field_types = json.loads(stdout.getvalue())
         type_names = {item["type"] for item in field_types}
-        self.assertEqual(len(field_types), 25)
+        self.assertEqual(len(field_types), 27)
         self.assertIn("select.single", type_names)
         self.assertIn("lookup.employee", type_names)
         self.assertTrue({
@@ -261,7 +261,7 @@ class FlowBaseCliTest(unittest.TestCase):
         kinds = {item.get("kind") for item in page_components["kinds"]}
         self.assertEqual(kinds, {
             None, "relatedList", "approval", "detailSummary", "stageBar",
-            "tabs", "relatedSummary", "attachmentCard", "noticeBlock",
+            "tabs", "relatedSummary", "attachmentCard", "noticeBlock", "recordEmbed",
         })
         approval = next(
             item for item in page_components["kinds"] if item.get("kind") == "approval"

flowbase_cli-0.1.16/tests/test_iframes.py

@@ -0,0 +1,30 @@
+"""Iframe CLI uses the same API contracts as browser management."""
+import io
+from unittest.mock import patch
+import pytest
+from flowbase_cli.main import main
+
+
+@pytest.mark.parametrize("args,endpoint,path,body", [
+    (["iframes", "list"], "iframes.list", None, None),
+    (["iframes", "get", "ifr_x"], "iframes.get", {"iframe_id": "ifr_x"}, None),
+    (["iframes", "create", "--json", '{"label":"Help","url":"https://example.com"}'], "iframes.create", None, {"label":"Help","url":"https://example.com"}),
+    (["iframes", "update", "ifr_x", "--json", '{"label":"Help","url":"https://example.com","baseRevision":3}'], "iframes.update", {"iframe_id":"ifr_x"}, {"label":"Help","url":"https://example.com","baseRevision":3}),
+    (["iframes", "delete", "ifr_x", "--yes", "--json", '{"baseRevision":4}'], "iframes.delete", {"iframe_id":"ifr_x"}, {"baseRevision":4}),
+    (["apps", "add-iframes", "app_x", "ifr_x", "ifr_y"], "apps.iframes.add", {"app_id":"app_x"}, {"iframeIds":["ifr_x","ifr_y"]}),
+    (["apps", "remove-iframe", "app_x", "ifr_x", "--yes"], "apps.iframes.remove", {"app_id":"app_x","iframe_id":"ifr_x"}, None),
+    (["apps", "set-iframe-group", "app_x", "ifr_x", "--ungrouped"], "apps.iframes.set-group", {"app_id":"app_x","iframe_id":"ifr_x"}, {"groupId":None}),
+    (["apps", "reorder-members", "app_x", "--json", '{"items":[{"type":"iframe","id":"ifr_x"}]}'], "apps.members.reorder", {"app_id":"app_x"}, {"items":[{"type":"iframe","id":"ifr_x"}]}),
+])
+def test_iframe_cli_request(args, endpoint, path, body):
+    with patch("flowbase_cli.main.OpenApiClient.request", return_value=b"{}") as request, patch("sys.stdout", io.StringIO()):
+        assert main(args) == 0
+    assert request.call_args.args[0] == endpoint
+    assert request.call_args.kwargs["path_params"] == path
+    assert request.call_args.kwargs["body"] == body
+
+
+def test_delete_requires_confirmation():
+    with patch("flowbase_cli.main.OpenApiClient.request") as request, patch("sys.stdin.isatty", return_value=False), patch("sys.stderr", io.StringIO()):
+        assert main(["iframes", "delete", "ifr_x", "--json", '{"baseRevision":0}']) == 1
+    request.assert_not_called()

flowbase_cli-0.1.16/tests/test_recent_commands.py

@@ -0,0 +1,30 @@
+"""New discovery commands and retry confirmation remain usable without a browser."""
+import io
+from unittest.mock import patch
+
+import pytest
+
+from flowbase_cli.main import main
+
+
+@pytest.mark.parametrize('args,endpoint,path,query', [
+    (['formulas', 'sources', 'obj_x'], 'formulas.sources', {'object_id': 'obj_x'}, None),
+    (['formulas', 'collections', 'obj_x'], 'formulas.collections', {'object_id': 'obj_x'}, None),
+    (['records', 'bundle-init', 'obj_x', '--record-id', 'rec_x'], 'records.bundle-init', {'object_id': 'obj_x'}, {'record_id': 'rec_x'}),
+    (['records', 'bundle-status', 'obj_x', 'submission'], 'records.bundle-status', {'object_id': 'obj_x', 'submission_id': 'submission'}, {}),
+    (['records', 'hierarchy-candidates', 'obj_x', '--field', 'fld_x'], 'records.hierarchy-candidates', {'object_id': 'obj_x'}, {'field': 'fld_x', 'exclude': '', 'q': ''}),
+    (['records', 'gantt-candidates', 'obj_x', '--field', 'fld_x', '--exclude', 'rec_x'], 'records.gantt-candidates', {'object_id': 'obj_x'}, {'field': 'fld_x', 'exclude': 'rec_x', 'q': ''}),
+    (['workflows', 'python-runtime', 'obj_x', 'new'], 'workflows.python-runtime', {'object_id': 'obj_x', 'workflow_id': 'new'}, None),
+])
+def test_discovery_request(args, endpoint, path, query):
+    with patch('flowbase_cli.main.OpenApiClient.request', return_value=b'{}') as request, patch('sys.stdout', io.StringIO()):
+        assert main(args) == 0
+    assert request.call_args.args[0] == endpoint
+    assert request.call_args.kwargs['path_params'] == path
+    assert request.call_args.kwargs['query'] == query
+
+
+def test_retry_noninteractive_requires_explicit_confirmation():
+    with patch('flowbase_cli.main.OpenApiClient.request') as request, patch('sys.stdin.isatty', return_value=False), patch('sys.stderr', io.StringIO()):
+        assert main(['workflows', 'retry', 'obj_x', 'wfl_x', 'exe_x']) == 1
+    request.assert_not_called()