@carthooks/arcubase-cli 0.1.3 → 0.1.5

package/bundle/arcubase.mjs

@@ -227,6 +227,22 @@ var adminCommands = [
     "scalarParams": [],
     "responseType": "AppCreateByTenantsRespVO"
   },
+  {
+    "scope": "admin",
+    "module": "app",
+    "functionName": "listApps",
+    "commandPath": [
+      "app",
+      "list-apps"
+    ],
+    "method": "GET",
+    "endpoint": "/apps",
+    "endpointParams": [],
+    "controller": "App.ListApps",
+    "requestType": null,
+    "scalarParams": [],
+    "responseType": "AppListRespVO"
+  },
   {
     "scope": "admin",
     "module": "app",
@@ -3232,88 +3248,6 @@ var adminCommands = [
       }
     ],
     "responseType": "TenantUsageDailyRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "deployEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "deploy-entity-workflow"
-    ],
-    "method": "POST",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow/deploy",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowDeploy",
-    "requestType": "EntityWorkflowDeployReqVO",
-    "scalarParams": [],
-    "responseType": "EntityWorkflowDeployRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "getEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "get-entity-workflow"
-    ],
-    "method": "GET",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowGet",
-    "requestType": null,
-    "scalarParams": [
-      {
-        "name": "workingId",
-        "type": "string",
-        "hasDefault": true
-      }
-    ],
-    "responseType": "EntityWorkflowGetRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "createEntityWorkflowVersion",
-    "commandPath": [
-      "workflow",
-      "create-entity-workflow-version"
-    ],
-    "method": "POST",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow/new",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowNewVersion",
-    "requestType": null,
-    "scalarParams": [],
-    "responseType": "EntityWorkflowNewVersionRespVO"
-  },
-  {
-    "scope": "admin",
-    "module": "workflow",
-    "functionName": "updateEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "update-entity-workflow"
-    ],
-    "method": "POST",
-    "endpoint": "/apps/:app_id/entity/:entity_id/workflow",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "Entity.WorkflowUpdate",
-    "requestType": "EntityWorkflowUpdateReqVO",
-    "scalarParams": [],
-    "responseType": "EntityWorkflowUpdateRespVO"
   }
 ];
 var userCommands = [
@@ -4430,10 +4364,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "putEntityQueryKeeper",
     "commandPath": [
-      "workflow",
+      "rows",
       "put-entity-query-keeper"
     ],
     "method": "POST",
@@ -4449,10 +4383,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "queryEntity",
     "commandPath": [
-      "workflow",
+      "rows",
       "query-entity"
     ],
     "method": "POST",
@@ -4468,10 +4402,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "filterEntityQuery",
     "commandPath": [
-      "workflow",
+      "rows",
       "filter-entity-query"
     ],
     "method": "POST",
@@ -4487,10 +4421,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "queryEntitySelection",
     "commandPath": [
-      "workflow",
+      "rows",
       "query-entity-selection"
     ],
     "method": "POST",
@@ -4507,29 +4441,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
-    "functionName": "resolveEntityWorkflow",
-    "commandPath": [
-      "workflow",
-      "resolve-entity-workflow"
-    ],
-    "method": "POST",
-    "endpoint": "/entity/:app_id/:entity_id/resolve-workflow",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "UserAction.EntityResolveWorkflow",
-    "requestType": "EntityResolveWorkflowReqVO",
-    "scalarParams": [],
-    "responseType": "EntityResolveWorkflowRespVO"
-  },
-  {
-    "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "getEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "get-entity-row"
     ],
     "method": "GET",
@@ -4552,10 +4467,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "deleteEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "delete-entity-row"
     ],
     "method": "POST",
@@ -4571,10 +4486,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "restoreEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "restore-entity-row"
     ],
     "method": "POST",
@@ -4590,10 +4505,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "updateEntityRow",
     "commandPath": [
-      "workflow",
+      "rows",
       "update-entity-row"
     ],
     "method": "PUT",
@@ -4610,10 +4525,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "validateEntityUniq",
     "commandPath": [
-      "workflow",
+      "rows",
       "validate-entity-uniq"
     ],
     "method": "POST",
@@ -4629,10 +4544,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "insertEntity",
     "commandPath": [
-      "workflow",
+      "rows",
       "insert-entity"
     ],
     "method": "POST",
@@ -4648,10 +4563,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "prepareEntityInsert",
     "commandPath": [
-      "workflow",
+      "rows",
       "prepare-entity-insert"
     ],
     "method": "POST",
@@ -4667,48 +4582,10 @@ var userCommands = [
   },
   {
     "scope": "user",
-    "module": "workflow",
-    "functionName": "queryEntityWorkflowApproveUsers",
-    "commandPath": [
-      "workflow",
-      "query-entity-workflow-approve-users"
-    ],
-    "method": "POST",
-    "endpoint": "/entity/:app_id/:entity_id/query-approve-users",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "UserAction.EntityWorkflowApproveUsers",
-    "requestType": null,
-    "scalarParams": [],
-    "responseType": "EntityWorkflowApproveUsersRespVO"
-  },
-  {
-    "scope": "user",
-    "module": "workflow",
-    "functionName": "queryEntityWorkflowNodes",
-    "commandPath": [
-      "workflow",
-      "query-entity-workflow-nodes"
-    ],
-    "method": "POST",
-    "endpoint": "/entity/:app_id/:entity_id/query-workflow-nodes",
-    "endpointParams": [
-      "app_id",
-      "entity_id"
-    ],
-    "controller": "UserAction.EntityWorkflowNodes",
-    "requestType": null,
-    "scalarParams": [],
-    "responseType": "EntityWorkflowNodesRespVO"
-  },
-  {
-    "scope": "user",
-    "module": "workflow",
+    "module": "rows",
     "functionName": "getEntitySubformItems",
     "commandPath": [
-      "workflow",
+      "rows",
       "get-entity-subform-items"
     ],
     "method": "POST",
@@ -4726,8 +4603,24 @@ var userCommands = [
 ];
 
 // src/runtime/command_registry.ts
+var customAdminCommands = [
+  {
+    scope: "admin",
+    module: "app",
+    functionName: "inventory",
+    commandPath: ["app", "inventory"],
+    method: "GET",
+    endpoint: "/apps",
+    endpointParams: [],
+    controller: "Runtime.AppInventory",
+    requestType: null,
+    scalarParams: [],
+    responseType: "AppInventoryRespVO"
+  }
+];
+var customUserCommands = [];
 function listCommands(scope) {
-  return scope === "admin" ? adminCommands : userCommands;
+  return scope === "admin" ? [...adminCommands, ...customAdminCommands] : [...userCommands, ...customUserCommands];
 }
 function findCommand(scope, moduleName, commandName) {
   return listCommands(scope).find((item) => item.commandPath[0] === moduleName && item.commandPath[1] === commandName) ?? null;
@@ -5276,8 +5169,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path, errorMaps, issueData } = params;
-  const fullPath = [...path, ...issueData.path || []];
+  const { data, path: path2, errorMaps, issueData } = params;
+  const fullPath = [...path2, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -5393,11 +5286,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path, key) {
+  constructor(parent, value, path2, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path;
+    this._path = path2;
     this._key = key;
   }
   get path() {
@@ -8973,7 +8866,6 @@ var EntityQueryLinkToValuesReqVOSchema = external_exports.lazy(() => external_ex
 var EntityQueryRelationReqVOSchema = external_exports.lazy(() => external_exports.object({ "addition": external_exports.boolean().optional(), "data": external_exports.record(external_exports.string(), external_exports.any()).optional(), "entity": external_exports.boolean().optional(), "field_id": external_exports.number().optional(), "input": external_exports.string().optional(), "limit": external_exports.number().optional(), "offset": external_exports.number().optional(), "policies": external_exports.boolean().optional(), "query": external_exports.string().optional(), "total": external_exports.boolean().optional() }).strict());
 var EntityQueryOrderVOSchema = external_exports.lazy(() => external_exports.object({ "column": external_exports.string().optional(), "order": external_exports.string().optional() }).strict());
 var EntityQueryReqVOSchema = external_exports.lazy(() => external_exports.object({ "limit": external_exports.number().optional(), "offset": external_exports.number().optional(), "policy_id": external_exports.string().optional(), "search": external_exports.record(external_exports.string(), external_exports.any()).optional(), "sorts": external_exports.array(EntityQueryOrderVOSchema).optional(), "view_mode": external_exports.string().optional(), "withSubForm": external_exports.boolean().optional() }).strict());
-var EntityResolveWorkflowReqVOSchema = external_exports.lazy(() => external_exports.object({ "approve_users": external_exports.array(external_exports.number()).optional(), "closeCurrentTasks": external_exports.boolean().optional(), "node_id": external_exports.number().optional(), "policy_id": external_exports.string().optional(), "record_id": external_exports.number().optional(), "version_id": external_exports.number().optional() }).strict());
 var EntitySaveCustomKeysFieldVOSchema = external_exports.lazy(() => external_exports.object({ "id": external_exports.number().optional(), "key": external_exports.string().optional() }).strict());
 var EntitySaveCustomKeysReqVOSchema = external_exports.lazy(() => external_exports.array(EntitySaveCustomKeysFieldVOSchema));
 var EntitySaveNameReqVOSchema = external_exports.lazy(() => external_exports.object({ "name": external_exports.string().optional() }).strict());
@@ -8996,20 +8888,6 @@ var EntityUpdateReqVOSchema = external_exports.lazy(() => external_exports.objec
 var EntityUpdateSuccessScreenReqVOSchema = external_exports.lazy(() => external_exports.object({ "EnableDraft": external_exports.boolean().optional(), "EnableOffline": external_exports.boolean().optional(), "EnableSuccessScreen": external_exports.boolean().optional(), "SuccessScreen": external_exports.string().optional() }).strict());
 var EntityValidateUniqFieldVOSchema = external_exports.lazy(() => external_exports.object({ "field_id": external_exports.number().optional(), "value": external_exports.string().optional() }).strict());
 var EntityValidateUniqReqVOSchema = external_exports.lazy(() => external_exports.object({ "fields": external_exports.array(EntityValidateUniqFieldVOSchema).optional(), "record_id": external_exports.number().optional() }).strict());
-var ActionBulkUpdateActionSchema = external_exports.lazy(() => external_exports.object({ "number_add": external_exports.number().optional(), "number_mul": external_exports.number().optional(), "number_sub": external_exports.number().optional(), "text_append": external_exports.string().optional(), "text_prepend": external_exports.string().optional(), "text_replace": external_exports.string().optional(), "text_search": external_exports.string().optional(), "type": external_exports.string().optional(), "value": external_exports.any().optional() }).strict());
-var ActionBulkUpdateSchema = external_exports.lazy(() => external_exports.object({ "action": ActionBulkUpdateActionSchema.optional(), "id": external_exports.number().optional() }).strict());
-var WorkflowActionConfigSchema = external_exports.lazy(() => external_exports.object({ "enabled": external_exports.boolean().optional(), "options": external_exports.object({ "comment_required": external_exports.boolean().optional(), "desc": external_exports.string().optional(), "modifiers": external_exports.array(ActionBulkUpdateSchema).optional() }).strict().optional() }).strict());
-var WorkflowVoteTypeSchema = external_exports.lazy(() => external_exports.union([external_exports.literal(0), external_exports.literal(1)]));
-var NotificationWebhookConfigSchema = external_exports.lazy(() => external_exports.object({ "mode": NotificationPayloadModeSchema.optional(), "template": external_exports.string().optional(), "url": external_exports.string().optional(), "version": external_exports.string().optional() }).strict());
-var WorkflowConfigNodeSchema = external_exports.lazy(() => external_exports.object({ "data": external_exports.object({ "actions": external_exports.record(external_exports.string(), WorkflowActionConfigSchema).optional(), "approver_actions": external_exports.array(external_exports.number()).optional(), "approvers": external_exports.array(PermitUserScopeSchema).optional(), "auto_forward": external_exports.boolean().optional(), "cc": external_exports.array(PermitUserScopeSchema).optional(), "fields": external_exports.array(external_exports.number()).optional(), "notify_email": external_exports.boolean().optional(), "notify_email_tmpl": external_exports.object({ "body": external_exports.string().optional(), "subject": external_exports.string().optional() }).strict().optional(), "submit_condition": external_exports.array(external_exports.number()).optional(), "use_cc": external_exports.boolean().optional(), "vote_type": WorkflowVoteTypeSchema.optional(), "webhooks": external_exports.array(NotificationWebhookConfigSchema).optional() }).strict().optional(), "events": external_exports.array(external_exports.number()).optional(), "id": external_exports.string().optional(), "label": external_exports.string().optional(), "mode": external_exports.string().optional(), "position": external_exports.array(external_exports.number()).optional(), "type": external_exports.string().optional() }).strict());
-var WorkflowConfigDiagramSchema = external_exports.lazy(() => external_exports.object({ "edges": external_exports.array(external_exports.number()).optional(), "id_seq": external_exports.number().optional(), "nodes": external_exports.array(WorkflowConfigNodeSchema).optional(), "viewport": external_exports.array(external_exports.number()).optional() }).strict());
-var WorkflowAutoApproveRuleSchema = external_exports.lazy(() => external_exports.union([external_exports.literal(1), external_exports.literal(2), external_exports.literal(3)]));
-var WorkflowRetractRuleSchema = external_exports.lazy(() => external_exports.union([external_exports.literal(1), external_exports.literal(2), external_exports.literal(3)]));
-var WorkflowSLATriggerSchema = external_exports.lazy(() => external_exports.object({ "hasUpdateField": external_exports.boolean().optional(), "hasWebhook": external_exports.boolean().optional(), "modifiers": external_exports.array(ActionBulkUpdateSchema).optional(), "time_point": external_exports.number().optional(), "webhook": NotificationWebhookConfigSchema.optional() }).strict());
-var WorkflowSLAConfigSchema = external_exports.lazy(() => external_exports.object({ "ddl": external_exports.number().optional(), "enabled": external_exports.boolean().optional(), "id": external_exports.string().optional(), "name": external_exports.string().optional(), "nodes": external_exports.array(external_exports.string()).optional(), "triggers": external_exports.array(WorkflowSLATriggerSchema).optional() }).strict());
-var WorkflowOptionsSchema = external_exports.lazy(() => external_exports.object({ "allow_urge": external_exports.boolean().optional(), "allow_view_diagram": external_exports.boolean().optional(), "auto_approve_rule": WorkflowAutoApproveRuleSchema.optional(), "retract_rule": WorkflowRetractRuleSchema.optional(), "sla": external_exports.array(WorkflowSLAConfigSchema).optional() }).strict());
-var EntityWorkflowDeployReqVOSchema = external_exports.lazy(() => external_exports.object({ "diagram": WorkflowConfigDiagramSchema.optional(), "id": external_exports.number().optional(), "options": WorkflowOptionsSchema.optional() }).strict());
-var EntityWorkflowUpdateReqVOSchema = external_exports.lazy(() => external_exports.object({ "diagram": WorkflowConfigDiagramSchema.optional(), "id": external_exports.number().optional(), "options": WorkflowOptionsSchema.optional() }).strict());
 var EntityUtilsQueryOrderSchema = external_exports.lazy(() => external_exports.object({ "column": external_exports.string().optional(), "order": external_exports.string().optional() }).strict());
 var FetchWidgetsDataReqVOSchema = external_exports.lazy(() => external_exports.object({ "dashboard_id": external_exports.number().optional(), "ingress_hash_id": external_exports.string().optional(), "ingress_id": external_exports.number().optional(), "querys": external_exports.object({ "search": external_exports.record(external_exports.string(), external_exports.any()).optional(), "sorts": external_exports.array(EntityUtilsQueryOrderSchema).optional() }).strict().optional(), "type": WidgetsTypeCodeSchema.optional() }).strict());
 var GetOrganizationTreeReqVOSchema = external_exports.lazy(() => external_exports.object({ "parent_id": external_exports.number().optional() }).strict());
@@ -9134,7 +9012,6 @@ var bodySchemas = {
   "EntityQueryLinkToValuesReqVO": EntityQueryLinkToValuesReqVOSchema,
   "EntityQueryRelationReqVO": EntityQueryRelationReqVOSchema,
   "EntityQueryReqVO": EntityQueryReqVOSchema,
-  "EntityResolveWorkflowReqVO": EntityResolveWorkflowReqVOSchema,
   "EntitySaveCustomKeysReqVO": EntitySaveCustomKeysReqVOSchema,
   "EntitySaveNameReqVO": EntitySaveNameReqVOSchema,
   "EntitySaveReqVO": EntitySaveReqVOSchema,
@@ -9147,8 +9024,6 @@ var bodySchemas = {
   "EntityUpdateReqVO": EntityUpdateReqVOSchema,
   "EntityUpdateSuccessScreenReqVO": EntityUpdateSuccessScreenReqVOSchema,
   "EntityValidateUniqReqVO": EntityValidateUniqReqVOSchema,
-  "EntityWorkflowDeployReqVO": EntityWorkflowDeployReqVOSchema,
-  "EntityWorkflowUpdateReqVO": EntityWorkflowUpdateReqVOSchema,
   "FetchWidgetsDataReqVO": FetchWidgetsDataReqVOSchema,
   "GetOrganizationTreeReqVO": GetOrganizationTreeReqVOSchema,
   "GetOrganizationUsersReqVO": GetOrganizationUsersReqVOSchema,
@@ -9476,10 +9351,6 @@ var typeIndex = {
     "file": "/opt/arcubase-sdk/types/user-action.ts",
     "dependencies": []
   },
-  "EntityResolveWorkflowReqVO": {
-    "file": "/opt/arcubase-sdk/types/user-action.ts",
-    "dependencies": []
-  },
   "EntitySaveCustomKeysReqVO": {
     "file": "/opt/arcubase-sdk/types/entity.ts",
     "dependencies": [
@@ -9538,14 +9409,6 @@ var typeIndex = {
     "file": "/opt/arcubase-sdk/types/common.ts",
     "dependencies": []
   },
-  "EntityWorkflowDeployReqVO": {
-    "file": "/opt/arcubase-sdk/types/workflow.ts",
-    "dependencies": []
-  },
-  "EntityWorkflowUpdateReqVO": {
-    "file": "/opt/arcubase-sdk/types/workflow.ts",
-    "dependencies": []
-  },
   "FetchWidgetsDataReqVO": {
     "file": "/opt/arcubase-sdk/types/user-action.ts",
     "dependencies": []
@@ -10372,54 +10235,59 @@ var examplesIndexDocHint = {
   title: "Examples index",
   file: "/opt/arcubase-sdk/docs/runtime-reference/examples/README.md"
 };
-var omsExampleDocHint = {
-  title: "OMS example 01",
-  file: "/opt/arcubase-sdk/docs/runtime-reference/examples/oms-01/README.md"
+var appDiscoveryDocHint = {
+  title: "App discovery",
+  file: "/opt/arcubase-sdk/docs/runtime-reference/app-discovery.md"
 };
 var docHintIndex = {
   AppCreateByTenantsReqVO: [
+    appDiscoveryDocHint,
     { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
-    examplesIndexDocHint,
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   AppCreateEntityReqVO: [
+    appDiscoveryDocHint,
     { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
-    examplesIndexDocHint,
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   EntitySaveReqVO: [
     { title: "Entity schema", file: "/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   EntityQueryReqVO: [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
     { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   EntityUpdateReqVO: [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+    examplesIndexDocHint
   ],
   EntitySelectionActionReqVO: [
     { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   InsertReqVO: [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+    examplesIndexDocHint
   ],
   EntityBulkUpdateReqVO: [
     { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   "EntityInvokeBatchOperatorReqVO & InvokeRequestVO": [
-    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" }
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    examplesIndexDocHint
   ],
   "{ policy_id: string selection: any }": [
-    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" }
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    examplesIndexDocHint
   ],
   "{ policy_id: string selection: any tag_names: string[] }": [
-    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" }
+    { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
+    examplesIndexDocHint
   ]
 };
 function getTypeHints(typeName) {
@@ -10451,53 +10319,68 @@ function getDocHints(typeName) {
 }
 var commandDocHintIndex = {
   "admin.app.createAppByTenants": [
+    appDiscoveryDocHint,
     { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
-    examplesIndexDocHint,
-    omsExampleDocHint
+    examplesIndexDocHint
+  ],
+  "admin.app.listApps": [
+    appDiscoveryDocHint,
+    examplesIndexDocHint
+  ],
+  "admin.app.inventory": [
+    appDiscoveryDocHint,
+    examplesIndexDocHint
   ],
   "admin.app.createEntity": [
+    appDiscoveryDocHint,
     { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   "admin.entity.adminGetEntityInfo": [
+    appDiscoveryDocHint,
     { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   "admin.entity.adminSaveEntity": [
     { title: "Entity schema", file: "/opt/arcubase-sdk/docs/runtime-reference/entity-schema.md" },
-    omsExampleDocHint
+    { title: "Table lifecycle", file: "/opt/arcubase-sdk/docs/runtime-reference/table-lifecycle.md" },
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    examplesIndexDocHint
   ],
-  "user.workflow.insertEntity": [
+  "user.rows.insertEntity": [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+    examplesIndexDocHint
   ],
-  "user.workflow.queryEntity": [
+  "user.rows.queryEntity": [
     { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
-    omsExampleDocHint
+    { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
+    examplesIndexDocHint
   ],
-  "user.workflow.getEntityRow": [
+  "user.rows.getEntityRow": [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
-  "user.workflow.updateEntityRow": [
+  "user.rows.updateEntityRow": [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+    examplesIndexDocHint
   ],
-  "user.workflow.queryEntitySelection": [
+  "user.rows.queryEntitySelection": [
     { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
-  "user.workflow.deleteEntityRow": [
+  "user.rows.deleteEntityRow": [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
-  "user.workflow.restoreEntityRow": [
+  "user.rows.restoreEntityRow": [
     { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ],
   "user.entity.updateEntityBulk": [
     { title: "Search and bulk actions", file: "/opt/arcubase-sdk/docs/runtime-reference/search-and-bulk-actions.md" },
-    omsExampleDocHint
+    examplesIndexDocHint
   ]
 };
 function getCommandDocHints(operation) {
@@ -10506,14 +10389,246 @@ function getCommandDocHints(operation) {
   return commandDocHintIndex[key] ?? [];
 }
 
+// src/runtime/upload.ts
+import fs2 from "fs";
+import path from "path";
+function readUploadSource(sourcePath) {
+  const absolutePath = path.resolve(sourcePath);
+  if (!fs2.existsSync(absolutePath)) {
+    throw new CLIError("UPLOAD_SOURCE_NOT_FOUND", `upload source file does not exist: ${sourcePath}`, 2);
+  }
+  const stat = fs2.statSync(absolutePath);
+  if (!stat.isFile()) {
+    throw new CLIError("UPLOAD_SOURCE_INVALID", `upload source path must be a file: ${sourcePath}`, 2);
+  }
+  return {
+    absolutePath,
+    bytes: fs2.readFileSync(absolutePath)
+  };
+}
+function parseJSONResponse(raw) {
+  try {
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return raw;
+  }
+}
+function requireTokenPayload(payload) {
+  if (payload && typeof payload === "object" && payload.error) {
+    const upstreamError = payload.error;
+    const message = typeof upstreamError === "object" && upstreamError && "message" in upstreamError && typeof upstreamError.message === "string" ? upstreamError.message : typeof upstreamError === "string" ? upstreamError : JSON.stringify(upstreamError);
+    throw new CLIError("UPSTREAM_BODY_ERROR", message, 1, {
+      endpoint: "/upload/token",
+      method: "POST",
+      traceId: typeof payload.trace_id === "string" ? payload.trace_id : void 0,
+      upstreamError
+    });
+  }
+  if (!payload?.data || typeof payload.data !== "object") {
+    throw new CLIError("UPLOAD_TOKEN_INVALID", "upload token response did not include data", 1);
+  }
+  return payload.data;
+}
+function renderUploadHelp() {
+  return [
+    "arcubase upload <local-file> [flags]",
+    "",
+    "purpose:",
+    "  - upload one local file through Arcubase",
+    "  - return a field value that can be used directly in file or image row payloads",
+    "",
+    "flags:",
+    "  --filename <name>   override the uploaded filename stored in Arcubase",
+    "  --global            request a global upload token instead of a tenant-scoped token",
+    "",
+    "result shape:",
+    "  - data is a JSON array",
+    "  - use that array directly as the value of a file or image field in insert/update payloads",
+    "",
+    "example:",
+    "  arcubase upload ./contract.pdf",
+    "  arcubase upload ./photo.jpg --filename lead-photo.jpg",
+    "",
+    "docs:",
+    "  - Uploads: /opt/arcubase-sdk/docs/runtime-reference/uploads.md",
+    "  - Row CRUD: /opt/arcubase-sdk/docs/runtime-reference/row-crud.md",
+    "  - File field: /opt/arcubase-sdk/docs/runtime-reference/entity-schema/file.md",
+    "  - Image field: /opt/arcubase-sdk/docs/runtime-reference/entity-schema/image.md"
+  ].join("\n");
+}
+async function uploadLocalFile(env, sourcePath, options, fetchImpl = fetch) {
+  const { absolutePath, bytes } = readUploadSource(sourcePath);
+  const filename = options.filename && options.filename.trim() || path.basename(absolutePath);
+  const tokenResponse = await fetchImpl(buildURL(env.ARCUBASE_BASE_URL, "/upload/token"), {
+    method: "POST",
+    headers: {
+      ...buildRequestHeaders(env),
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      global: Boolean(options.global)
+    })
+  });
+  const tokenRaw = await tokenResponse.text();
+  const tokenParsed = parseJSONResponse(tokenRaw);
+  if (!tokenResponse.ok) {
+    throw new CLIError("UPLOAD_TOKEN_REQUEST_FAILED", typeof tokenParsed === "string" ? tokenParsed : JSON.stringify(tokenParsed), 1, {
+      endpoint: "/upload/token",
+      method: "POST"
+    });
+  }
+  const tokenData = requireTokenPayload(tokenParsed);
+  if (tokenData.mode !== "aliyun-oss" && tokenData.mode !== "s3-post-policy") {
+    throw new CLIError("UPLOAD_MODE_UNSUPPORTED", `unsupported upload mode: ${String(tokenData.mode || "")}`, 1);
+  }
+  if (!tokenData.token_data?.dir || !tokenData.token_data.policy || !tokenData.token_data.host) {
+    throw new CLIError("UPLOAD_TOKEN_INVALID", "upload token response is missing required token_data fields", 1);
+  }
+  if (tokenData.id === void 0 || tokenData.id === null || tokenData.id === "") {
+    throw new CLIError("UPLOAD_TOKEN_INVALID", "upload token response is missing id", 1);
+  }
+  const form = new FormData();
+  form.append("key", `${tokenData.token_data.dir}${filename}`);
+  form.append("policy", tokenData.token_data.policy);
+  if (tokenData.mode === "aliyun-oss") {
+    if (!tokenData.token_data.accessid || !tokenData.token_data.signature) {
+      throw new CLIError("UPLOAD_TOKEN_INVALID", "upload token response is missing required token_data fields", 1);
+    }
+    form.append("OSSAccessKeyId", tokenData.token_data.accessid);
+    form.append("success_action_status", "200");
+    form.append("signature", tokenData.token_data.signature);
+  } else {
+    if (!tokenData.token_data.x_amz_algorithm || !tokenData.token_data.x_amz_credential || !tokenData.token_data.x_amz_date || !tokenData.token_data.x_amz_signature) {
+      throw new CLIError("UPLOAD_TOKEN_INVALID", "upload token response is missing required s3 token_data fields", 1);
+    }
+    form.append("x-amz-algorithm", tokenData.token_data.x_amz_algorithm);
+    form.append("x-amz-credential", tokenData.token_data.x_amz_credential);
+    form.append("x-amz-date", tokenData.token_data.x_amz_date);
+    form.append("x-amz-signature", tokenData.token_data.x_amz_signature);
+  }
+  form.append("file", new Blob([new Uint8Array(bytes)]), filename);
+  const uploadResponse = await fetchImpl(tokenData.token_data.host, {
+    method: "POST",
+    body: form
+  });
+  const uploadRaw = await uploadResponse.text();
+  if (!uploadResponse.ok) {
+    throw new CLIError("UPLOAD_TRANSFER_FAILED", uploadRaw || `upload failed with status ${uploadResponse.status}`, 1, {
+      endpoint: tokenData.token_data.host,
+      method: "POST"
+    });
+  }
+  return [
+    {
+      upload_id: tokenData.id,
+      file: filename,
+      file_name: filename,
+      meta: {}
+    }
+  ];
+}
+
 // src/runtime/execute.ts
+function parseJSONResponse2(raw) {
+  if (!raw) return null;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+function unwrapResponseData(payload) {
+  return isRecord2(payload) && "data" in payload ? payload.data : payload;
+}
+function formatUpstreamError(payload) {
+  if (typeof payload === "string") {
+    return payload;
+  }
+  if (isRecord2(payload) && isRecord2(payload.error) && typeof payload.error.message === "string") {
+    return payload.error.message;
+  }
+  return JSON.stringify(payload);
+}
+function extractApps(payload) {
+  const data = unwrapResponseData(payload);
+  if (!Array.isArray(data)) return [];
+  return data.filter((item) => isRecord2(item)).filter((item) => item.id !== void 0 && typeof item.name === "string").map((item) => ({
+    id: String(item.id),
+    name: item.name
+  }));
+}
+function extractEntities(payload) {
+  const data = unwrapResponseData(payload);
+  if (!Array.isArray(data)) return [];
+  return data.filter((item) => isRecord2(item)).filter((item) => item.id !== void 0 && typeof item.name === "string").map((item) => ({
+    id: String(item.id),
+    name: item.name
+  }));
+}
+async function executeAppInventory(runtimeEnv, fetchImpl) {
+  const appsResponse = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, "/apps"), {
+    method: "GET",
+    headers: buildRequestHeaders(runtimeEnv)
+  });
+  const appsRaw = await appsResponse.text();
+  const appsPayload = parseJSONResponse2(appsRaw);
+  if (!appsResponse.ok) {
+    throw new CLIError("UPSTREAM_REQUEST_FAILED", formatUpstreamError(appsPayload), 1);
+  }
+  if (isRecord2(appsPayload) && appsPayload.error) {
+    throw new CLIError("UPSTREAM_BODY_ERROR", formatUpstreamError(appsPayload), 1, {
+      endpoint: "/apps",
+      method: "GET",
+      upstreamError: appsPayload.error
+    });
+  }
+  const apps = extractApps(appsPayload);
+  const items = [];
+  for (const app of apps) {
+    const entitiesResponse = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, `/apps/${encodeURIComponent(app.id)}/entities`), {
+      method: "POST",
+      headers: {
+        ...buildRequestHeaders(runtimeEnv),
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({})
+    });
+    const entitiesRaw = await entitiesResponse.text();
+    const entitiesPayload = parseJSONResponse2(entitiesRaw);
+    if (!entitiesResponse.ok) {
+      throw new CLIError("UPSTREAM_REQUEST_FAILED", formatUpstreamError(entitiesPayload), 1);
+    }
+    if (isRecord2(entitiesPayload) && entitiesPayload.error) {
+      throw new CLIError("UPSTREAM_BODY_ERROR", formatUpstreamError(entitiesPayload), 1, {
+        endpoint: `/apps/${app.id}/entities`,
+        method: "POST",
+        upstreamError: entitiesPayload.error
+      });
+    }
+    items.push({
+      ...app,
+      entities: extractEntities(entitiesPayload)
+    });
+  }
+  return {
+    kind: "result",
+    commandPath: ["app", "inventory"],
+    status: 200,
+    data: {
+      apps: items
+    }
+  };
+}
 function renderRootHelp(scope) {
   const binary = scope === "admin" ? "arcubase-admin" : "arcubase";
+  const items = listModules(scope).map((item) => `  - ${item}`);
   return [
     `${binary} <module> <command> [flags]`,
     "",
+    ...scope === "admin" ? ["use arcubase-admin for app, entity shell, and schema management", ""] : ["use arcubase for rows, search, selection actions, and bulk actions", ""],
     "modules:",
-    ...listModules(scope).map((item) => `  - ${item}`)
+    ...items,
+    ...scope === "user" ? ["", "special commands:", "  - upload <local-file>"] : []
   ].join("\n");
 }
 function renderModuleHelp(scope, moduleName) {
@@ -10525,15 +10640,26 @@ function renderModuleHelp(scope, moduleName) {
   return [
     `${scope === "admin" ? "arcubase-admin" : "arcubase"} ${moduleName} <command> [flags]`,
     "",
+    ...scope === "admin" ? ["use arcubase-admin for app, entity shell, and schema management", ""] : ["use arcubase for rows, search, selection actions, and bulk actions", ""],
     "commands:",
     ...items.map((item) => `  - ${item.commandPath[1]}`)
   ].join("\n");
 }
+function buildUnknownCommandDetails(scope, moduleName, commandName) {
+  const suggestions = findCommandSuggestions(moduleName, commandName).map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`);
+  if (scope === "admin" && moduleName === "workflow" && suggestions.some((item) => item.startsWith("arcubase rows "))) {
+    return {
+      suggestions,
+      reason: `${moduleName} ${commandName} is not a valid command group; use arcubase rows for row operations`,
+      hint: `use: arcubase rows ${commandName}`
+    };
+  }
+  return suggestions.length > 0 ? { suggestions } : void 0;
+}
 function renderCommandHelp(scope, moduleName, commandName) {
   const command = findCommand(scope, moduleName, commandName);
   if (!command) {
-    const suggestions = findCommandSuggestions(moduleName, commandName).map((item) => `${item.binary} ${item.moduleName} ${item.commandName}`);
-    throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2, suggestions.length > 0 ? { suggestions } : void 0);
+    throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2, buildUnknownCommandDetails(scope, moduleName, commandName));
   }
   const docHints = [
     ...getCommandDocHints(`${scope}.${command.module}.${command.functionName}`),
@@ -10547,6 +10673,17 @@ function renderCommandHelp(scope, moduleName, commandName) {
     "query flags: --query-file",
     command.endpointParams.length ? `path flags: ${command.endpointParams.map((item) => `--${item.replace(/_/g, "-")}`).join(", ")}` : "path flags: none",
     command.scalarParams.length ? `scalar flags: ${command.scalarParams.map((item) => `--${item.name.replace(/([A-Z])/g, "-$1").toLowerCase()}`).join(", ")}` : "scalar flags: none",
+    ...scope === "admin" && moduleName === "entity" && commandName === "admin-save-entity" ? [
+      "next step:",
+      "  - switch to arcubase for row operations",
+      "  - row insert: arcubase rows insert-entity --app-id <app_id> --entity-id <entity_id> --body-file insert.json",
+      "  - row query: arcubase rows query-entity --app-id <app_id> --entity-id <entity_id> --body-file query.json"
+    ] : [],
+    ...scope === "admin" && moduleName === "app" && commandName === "inventory" ? [
+      "purpose:",
+      "  - list all accessible apps and each app entity list in one call sequence",
+      "  - use this before asking the user for app_id"
+    ] : [],
     ...docHints.length > 0 ? ["docs:", ...docHints.map((item) => `  - ${item.title}: ${item.file}`)] : []
   ].join("\n");
 }
@@ -10594,13 +10731,139 @@ function buildScalarQuery(command, flags) {
 function isRecord2(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function throwBodyValidationFailure(message, requestType, path, scope, command) {
+function extractEntityFields(payload) {
+  const candidate = isRecord2(payload) && isRecord2(payload.data) ? payload.data : payload;
+  if (!isRecord2(candidate) || !Array.isArray(candidate.fields)) {
+    return [];
+  }
+  return candidate.fields.filter((item) => isRecord2(item)).filter((item) => typeof item.id === "number" && typeof item.type === "string").map((item) => ({
+    id: item.id,
+    type: item.type,
+    label: typeof item.label === "string" ? item.label : void 0
+  }));
+}
+async function fetchEntityFields(runtimeEnv, appId, entityId, fetchImpl) {
+  const response = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, `/entity/${encodeURIComponent(appId)}/${encodeURIComponent(entityId)}`), {
+    method: "GET",
+    headers: buildRequestHeaders(runtimeEnv)
+  });
+  const raw = await response.text();
+  let parsedResponse = raw;
+  try {
+    parsedResponse = raw ? JSON.parse(raw) : null;
+  } catch {
+    parsedResponse = raw;
+  }
+  if (!response.ok) {
+    throw new CLIError("UPSTREAM_REQUEST_FAILED", typeof parsedResponse === "string" ? parsedResponse : JSON.stringify(parsedResponse), 1);
+  }
+  if (isRecord2(parsedResponse) && parsedResponse.error) {
+    const upstreamError = parsedResponse.error;
+    const upstreamMessage = isRecord2(upstreamError) && typeof upstreamError.message === "string" ? upstreamError.message : typeof upstreamError === "string" ? upstreamError : JSON.stringify(upstreamError);
+    throw new CLIError("UPSTREAM_BODY_ERROR", upstreamMessage, 1, {
+      endpoint: `/entity/${appId}/${entityId}`,
+      method: "GET",
+      upstreamError
+    });
+  }
+  const fields = extractEntityFields(parsedResponse);
+  return new Map(fields.map((field) => [field.id, field]));
+}
+function looksLikeLocalFilePath(value) {
+  return value.startsWith("./") || value.startsWith("../") || value.startsWith("/") || value.startsWith("~/") || /\.(pdf|png|jpe?g|gif|webp|bmp|svg|heic|txt|csv|xlsx?|docx?|pptx?|zip)$/i.test(value);
+}
+function isValidUploadEntry(value) {
+  if (!isRecord2(value)) {
+    return false;
+  }
+  const hasUploadId = typeof value.upload_id === "number" || typeof value.upload_id === "string";
+  const hasAssetsId = typeof value.assets_id === "number" || typeof value.assets_id === "string";
+  return (hasUploadId || hasAssetsId) && typeof value.file === "string" && typeof value.file_name === "string";
+}
+async function validateFileFieldPayloads(scope, command, runtimeEnv, flags, body, fetchImpl) {
+  if (!isRecord2(body)) {
+    return;
+  }
+  const container = command.functionName === "updateEntityRow" ? body.data : body.fields;
+  if (!isRecord2(container)) {
+    return;
+  }
+  const appId = flagValue(flags, "app-id");
+  const entityId = flagValue(flags, "entity-id");
+  if (!appId || !entityId) {
+    return;
+  }
+  const fieldsById = await fetchEntityFields(runtimeEnv, appId, entityId, fetchImpl);
+  for (const [fieldIdText, value] of Object.entries(container)) {
+    if (!/^\d+$/.test(fieldIdText)) {
+      continue;
+    }
+    const fieldId = Number(fieldIdText);
+    const field = fieldsById.get(fieldId);
+    if (!field || field.type !== "file" && field.type !== "image") {
+      continue;
+    }
+    const fieldPath = command.functionName === "updateEntityRow" ? `body.data.${fieldId}` : `body.fields.${fieldId}`;
+    const fieldName = field.label ? `${field.label} (${field.type})` : `${field.type} field ${fieldId}`;
+    if (typeof value === "string") {
+      const guidance = looksLikeLocalFilePath(value) ? `do not put a local file path directly into ${fieldName}; run "arcubase upload ${value}" first and use the returned data array as the field value` : `${fieldName} must be an array returned by "arcubase upload <local-file>", not a string`;
+      throw new CLIError("BODY_VALIDATION_FAILED", guidance, 2, {
+        operation: `${scope}.${command.module}.${command.functionName}`,
+        requestType: command.requestType ?? void 0,
+        issues: [{ path: fieldPath, message: guidance }],
+        docHints: [
+          { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+          { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" }
+        ]
+      });
+    }
+    if (isRecord2(value)) {
+      const guidance = `${fieldName} must be an array. Run "arcubase upload <local-file>" and use the returned data array directly as the field value`;
+      throw new CLIError("BODY_VALIDATION_FAILED", guidance, 2, {
+        operation: `${scope}.${command.module}.${command.functionName}`,
+        requestType: command.requestType ?? void 0,
+        issues: [{ path: fieldPath, message: guidance }],
+        docHints: [
+          { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+          { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" }
+        ]
+      });
+    }
+    if (!Array.isArray(value)) {
+      const guidance = `${fieldName} must be an array returned by "arcubase upload <local-file>"`;
+      throw new CLIError("BODY_VALIDATION_FAILED", guidance, 2, {
+        operation: `${scope}.${command.module}.${command.functionName}`,
+        requestType: command.requestType ?? void 0,
+        issues: [{ path: fieldPath, message: guidance }],
+        docHints: [
+          { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+          { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" }
+        ]
+      });
+    }
+    for (const [index, item] of value.entries()) {
+      if (!isValidUploadEntry(item)) {
+        const guidance = `${fieldName} entries must include upload_id or assets_id plus file and file_name. Use "arcubase upload <local-file>" and copy the returned array item as-is`;
+        throw new CLIError("BODY_VALIDATION_FAILED", guidance, 2, {
+          operation: `${scope}.${command.module}.${command.functionName}`,
+          requestType: command.requestType ?? void 0,
+          issues: [{ path: `${fieldPath}.${index}`, message: guidance }],
+          docHints: [
+            { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+            { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" }
+          ]
+        });
+      }
+    }
+  }
+}
+function throwBodyValidationFailure(message, requestType, path2, scope, command) {
   throw new CLIError("BODY_VALIDATION_FAILED", message, 2, {
     operation: `${scope}.${command.module}.${command.functionName}`,
     requestType,
     issues: [
       {
-        path,
+        path: path2,
         message
       }
     ],
@@ -10612,7 +10875,7 @@ function validateActionSpecificBody(scope, command, flags, body) {
   if (!isRecord2(body) || !command.requestType) {
     return;
   }
-  if (command.module === "workflow" && command.functionName === "queryEntitySelection") {
+  if (command.module === "rows" && command.functionName === "queryEntitySelection") {
     const action = flagValue(flags, "action");
     const selection = body.selection;
     if (!isRecord2(selection) || typeof selection.type !== "string") {
@@ -10624,7 +10887,7 @@ function validateActionSpecificBody(scope, command, flags, body) {
     if (action === "query") {
       if (type === "condition") {
         throwBodyValidationFailure(
-          "selection.type=condition is not supported for action=query; use selection.type=ids or selection.type=all, or use workflow query-entity for search conditions",
+          "selection.type=condition is not supported for action=query; use selection.type=ids or selection.type=all, or use rows query-entity for search conditions",
           command.requestType,
           "body.selection.type",
           scope,
@@ -10655,6 +10918,31 @@ function validateActionSpecificBody(scope, command, flags, body) {
 }
 async function executeCLI(scope, argv, env, fetchImpl = fetch) {
   const parsed = parseCLIArgs(argv);
+  if (scope === "user" && parsed.commandTokens[0] === "upload") {
+    if (hasFlag(parsed.flags, "help") || parsed.commandTokens.length === 1) {
+      return { kind: "help", text: renderUploadHelp() };
+    }
+    const sourcePath = parsed.commandTokens[1];
+    if (!sourcePath) {
+      throw new CLIError("UPLOAD_SOURCE_REQUIRED", "upload requires a local file path", 2);
+    }
+    const runtimeEnv2 = env ?? loadRuntimeEnv(scope);
+    const data = await uploadLocalFile(
+      runtimeEnv2,
+      sourcePath,
+      {
+        filename: flagValue(parsed.flags, "filename"),
+        global: hasFlag(parsed.flags, "global")
+      },
+      fetchImpl
+    );
+    return {
+      kind: "result",
+      commandPath: ["upload", sourcePath],
+      status: 200,
+      data
+    };
+  }
   if (parsed.commandTokens.length === 0) {
     return { kind: "help", text: renderRootHelp(scope) };
   }
@@ -10671,7 +10959,10 @@ async function executeCLI(scope, argv, env, fetchImpl = fetch) {
   const runtimeEnv = env ?? loadRuntimeEnv(scope);
   const command = findCommand(scope, moduleName, commandName);
   if (!command) {
-    throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2);
+    throw new CLIError("UNKNOWN_COMMAND", `unknown command: ${moduleName} ${commandName}`, 2, buildUnknownCommandDetails(scope, moduleName, commandName));
+  }
+  if (scope === "admin" && moduleName === "app" && commandName === "inventory") {
+    return executeAppInventory(runtimeEnv, fetchImpl);
   }
   const endpoint = normalizeExternalEndpoint(resolveEndpoint(command.endpoint, parsed.flags));
   const scalarQuery = buildScalarQuery(command, parsed.flags);
@@ -10718,6 +11009,9 @@ async function executeCLI(scope, argv, env, fetchImpl = fetch) {
       }
     }
   }
+  if (scope === "user" && (command.functionName === "insertEntity" || command.functionName === "updateEntityRow")) {
+    await validateFileFieldPayloads(scope, command, runtimeEnv, parsed.flags, validatedBody, fetchImpl);
+  }
   const response = await fetchImpl(buildURL(runtimeEnv.ARCUBASE_BASE_URL, endpoint, Object.keys(query).length > 0 ? query : void 0), {
     method: command.method,
     headers: {
@@ -10739,11 +11033,20 @@ async function executeCLI(scope, argv, env, fetchImpl = fetch) {
     const upstreamError = parsedResponse.error;
     const upstreamMessage = typeof upstreamError === "object" && upstreamError && "message" in upstreamError && typeof upstreamError.message === "string" ? upstreamError.message : typeof upstreamError === "string" ? upstreamError : JSON.stringify(upstreamError);
     const traceId = typeof parsedResponse.trace_id === "string" ? parsedResponse.trace_id : typeof parsedResponse.request_id === "string" ? parsedResponse.request_id : void 0;
+    const uploadBindFailure = upstreamMessage.includes("failed to bind upload to assets");
     throw new CLIError("UPSTREAM_BODY_ERROR", upstreamMessage, 1, {
       endpoint,
       method: command.method,
       traceId,
-      upstreamError
+      upstreamError,
+      ...uploadBindFailure ? {
+        reason: "the row payload used a file/image upload entry, but Arcubase could not bind that upload into an asset record",
+        hint: "verify the upload storage host is reachable from the Arcubase server, then rerun arcubase upload and retry the row insert/update",
+        docHints: [
+          { title: "Uploads", file: "/opt/arcubase-sdk/docs/runtime-reference/uploads.md" },
+          { title: "Row CRUD", file: "/opt/arcubase-sdk/docs/runtime-reference/row-crud.md" }
+        ]
+      } : {}
     });
   }
   return {