licos-platform-cli 0.4.4__tar.gz → 0.4.6__tar.gz

{licos_platform_cli-0.4.4 → licos_platform_cli-0.4.6}/.gitignore

@@ -1,7 +1,6 @@
 # Rust
 /target/
 **/*.rs.bk
-Cargo.lock
 
 # Node
 node_modules/
@@ -61,3 +60,4 @@ logs
 source
 
 平台API
+云端环境

licos_platform_cli-0.4.6/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.5
+Name: licos-platform-cli
+Version: 0.4.6
+Summary: LICOS platform CLI
+Requires-Python: >=3.10
+Requires-Dist: licos-platform-sdk>=0.5.4

{licos_platform_cli-0.4.4 → licos_platform_cli-0.4.6}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "licos-platform-cli"
-version = "0.4.4"
+version = "0.4.6"
 description = "LICOS platform CLI"
 requires-python = ">=3.10"
 dependencies = [
-    "licos-platform-sdk>=0.5.2",
+    "licos-platform-sdk>=0.5.4",
 ]
 
 [project.scripts]

{licos_platform_cli-0.4.4 → licos_platform_cli-0.4.6}/src/licos_platform_cli/help_commands.py

@@ -806,127 +806,42 @@ PROJECT_CONFIG_HELP = {
 }
 
 
-UNS_HELP = {
-    "topic": "uns",
-    "description": "Tenant-isolated UNS directory modeling, provisioning, and runtime access.",
-    "runtime": RUNTIME_ENV,
+ONTOLOGY_HELP = {
+    "topic": "ontology",
+    "description": "Authorized ontology and Data Factory tools discovered from the external AI tool catalog.",
+    "runtime": RUNTIME_ENV + [
+        {"name": "LICOS_PLATFORM_PUBLIC_BASE_URL", "required": True, "description": "Public AIOS Web Gateway base URL; ontology requests use its /ontology-api route."},
+    ],
     "rules": [
-        "Isolation follows the tenant UNS directory hierarchy; projectId and workspaceId are not UNS isolation keys.",
-        "Fetch schema and capabilities before generating a provisioning document; capabilities are the source of truth for supported protocols, data types, video options, and limits.",
-        "Use the standard sequence: schema -> capabilities -> validate -> plan -> submit -> wait -> operations.",
-        "validate and plan inspect the request. submit creates an asynchronous job; the terminal job status contains the result.",
-        "Use nodes, templates, and labels for direct tenant directory maintenance. Delete commands require explicit --confirm.",
-        "IoT source queries provide collectors, points, latest values, and video stream options.",
-        "Realtime returns a platform WebSocket URL containing a short-lived ticket.",
+        "Search the catalog before invoking a tool; the catalog is filtered by the current user's permissions.",
+        "Resolve elements by stable IDs before querying context, model checks, or mapped data.",
+        "READ tools query state, PREPARE tools validate a change draft, and PERSIST tools apply an explicitly confirmed draft.",
+        "PERSIST commands require --confirm. Never reuse a catalog result after its catalogVersion changes.",
     ],
     "sdk": {
-        "python": "from licos_platform_sdk import uns\ndoc = {...}\nuns.validate(doc)\nuns.plan(doc)\ncreated = uns.submit(doc)\nresult = uns.wait_job(created['jobId'])",
-        "node": "import { uns } from '@kmlckj/licos-platform-sdk';\nconst created = await uns.submit(document);\nconst result = await uns.waitJob(created.jobId);",
+        "python": "from licos_platform_sdk import ontology\ncatalog = ontology.search_tools('查询设备实时数据')\nselected = catalog['items'][0]\n# 按 selected['definition']['function']['parameters'] 构造 arguments 后调用 selected 中的精确函数名。",
+        "node": "import { ontology } from '@kmlckj/licos-platform-sdk';\nconst catalog = await ontology.searchTools('查询设备实时数据');\nconst selected = catalog.items[0];\n// 按 selected.definition.function.parameters 构造 arguments 后调用 selected 中的精确函数名。",
     },
     "commands": {
-        "schema": {"description": "Get the provisioning JSON Schema.", "parameters": [], "example": "licos-platform uns schema"},
-        "capabilities": {"description": "Get supported IoT/video capabilities and tenant limits.", "parameters": [], "example": "licos-platform uns capabilities"},
-        "validate": {"description": "Validate and normalize a provisioning document without writes.", "parameters": [{"name": "--file", "required": True, "description": "AIOS_IOT_UNS_PROVISIONING JSON file."}], "example": "licos-platform uns validate --file UNS.provisioning.json"},
-        "plan": {"description": "Build a read-only provisioning plan.", "parameters": [{"name": "--file", "required": True, "description": "Validated provisioning JSON file."}], "example": "licos-platform uns plan --file UNS.provisioning.json"},
-        "submit": {"description": "Submit an asynchronous provisioning job.", "parameters": [{"name": "--file", "required": True, "description": "The exact planned provisioning JSON file."}, {"name": "--idempotency-key", "required": False, "description": "Stable caller-generated key used to safely retry the same submission."}], "example": "licos-platform uns submit --file UNS.provisioning.json --idempotency-key <stable-key>"},
-        "job": {"description": "Get one provisioning job status.", "parameters": [{"name": "job_id", "required": True, "description": "Job ID returned by submit."}], "example": "licos-platform uns job <jobId>"},
-        "operations": {"description": "List all operations and errors for a provisioning job.", "parameters": [{"name": "job_id", "required": True, "description": "Provisioning job ID."}], "example": "licos-platform uns operations <jobId>"},
-        "wait": {"description": "Wait for a provisioning job terminal status.", "parameters": [{"name": "job_id", "required": True, "description": "Provisioning job ID."}, {"name": "--timeout", "required": False, "description": "Maximum seconds, default 600."}, {"name": "--interval", "required": False, "description": "Poll interval seconds, default 1.5."}], "example": "licos-platform uns wait <jobId>"},
-        "nodes": {"description": "List the tenant UNS directory tree.", "parameters": [], "example": "licos-platform uns nodes"},
-        "node-get": {"description": "Get one UNS node by its exact ID.", "parameters": [{"name": "node_id", "type": "string", "required": True, "description": "UNS node ID."}], "example": "licos-platform uns node-get <nodeId>"},
-        "node-children": {"description": "List direct or recursive children of one UNS directory.", "parameters": [{"name": "node_id", "type": "string", "required": True, "description": "Parent UNS node ID."}, {"name": "--recursive", "type": "flag", "required": False, "description": "Include all descendants instead of direct children only."}, {"name": "--kind", "type": "enum", "required": False, "values": ["FOLDER", "FILE"], "description": "Optionally return only folders or files."}], "example": "licos-platform uns node-children <nodeId> --recursive --kind FILE"},
-        "node-create": {"description": "Create one directory or file node.", "parameters": [{"name": "--json", "required": True, "description": "Node request JSON object."}], "example": "licos-platform uns node-create --json <node-json>"},
-        "node-batch-create": {"description": "Batch create directory/file nodes.", "parameters": [{"name": "--file", "required": True, "description": "JSON array or {nodes:[...]} file."}], "example": "licos-platform uns node-batch-create --file nodes.json"},
-        "node-copy": {"description": "Copy one node under an optional target directory.", "parameters": [{"name": "node_id", "required": True, "description": "Source node ID."}, {"name": "--parent-id", "required": False, "description": "Target parent node ID; omit for root."}], "example": "licos-platform uns node-copy <nodeId> --parent-id <parentId>"},
-        "node-update": {"description": "Update one node with a structured request.", "parameters": [{"name": "node_id", "required": True, "description": "Node ID."}, {"name": "--json", "required": True, "description": "Node update JSON object."}], "example": "licos-platform uns node-update <nodeId> --json <node-json>"},
-        "node-delete": {"description": "Delete one node after explicit confirmation.", "parameters": [{"name": "node_id", "required": True, "description": "Node ID."}, {"name": "--confirm", "required": True, "description": "Confirm deletion."}], "example": "licos-platform uns node-delete <nodeId> --confirm"},
-        "templates": {"description": "List UNS templates.", "parameters": [], "example": "licos-platform uns templates"},
-        "template-get": {"description": "Get one UNS template by its exact ID.", "parameters": [{"name": "template_id", "type": "string", "required": True, "description": "UNS template ID."}], "example": "licos-platform uns template-get <templateId>"},
-        "template-nodes": {"description": "List UNS nodes that use one template.", "parameters": [{"name": "template_id", "type": "string", "required": True, "description": "UNS template ID."}], "example": "licos-platform uns template-nodes <templateId>"},
-        "template-create": {"description": "Create an UNS template.", "parameters": [{"name": "--json", "required": True, "description": "Template JSON object."}], "example": "licos-platform uns template-create --json '{...}'"},
-        "template-update": {"description": "Update an UNS template.", "parameters": [{"name": "template_id", "required": True, "description": "Template ID."}, {"name": "--json", "required": True, "description": "Template JSON object."}], "example": "licos-platform uns template-update <id> --json '{...}'"},
-        "template-delete": {"description": "Delete an UNS template after confirmation.", "parameters": [{"name": "template_id", "required": True, "description": "Template ID."}, {"name": "--confirm", "required": True, "description": "Confirm deletion."}], "example": "licos-platform uns template-delete <id> --confirm"},
-        "labels": {"description": "List UNS labels.", "parameters": [], "example": "licos-platform uns labels"},
-        "label-get": {"description": "Get one UNS label by its exact ID.", "parameters": [{"name": "label_id", "type": "string", "required": True, "description": "UNS label ID."}], "example": "licos-platform uns label-get <labelId>"},
-        "label-node-list": {"description": "List UNS nodes assigned to one label.", "parameters": [{"name": "label_id", "type": "string", "required": True, "description": "UNS label ID."}], "example": "licos-platform uns label-node-list <labelId>"},
-        "label-create": {"description": "Create an UNS label.", "parameters": [{"name": "--json", "required": True, "description": "Label JSON object."}], "example": "licos-platform uns label-create --json '{...}'"},
-        "label-update": {"description": "Update an UNS label.", "parameters": [{"name": "label_id", "required": True, "description": "Label ID."}, {"name": "--json", "required": True, "description": "Label JSON object."}], "example": "licos-platform uns label-update <id> --json '{...}'"},
-        "label-nodes": {"description": "Replace all nodes assigned to one label.", "parameters": [{"name": "label_id", "required": True, "description": "Label ID."}, {"name": "--node-ids-json", "required": True, "description": "JSON string array of node IDs."}], "example": "licos-platform uns label-nodes <id> --node-ids-json <node-id-array>"},
-        "label-delete": {"description": "Delete an UNS label after confirmation.", "parameters": [{"name": "label_id", "required": True, "description": "Label ID."}, {"name": "--confirm", "required": True, "description": "Confirm deletion."}], "example": "licos-platform uns label-delete <id> --confirm"},
-        "node-schema": {"description": "Get the JSON Schema for a folder, file, template, or label.", "parameters": [{"name": "schema_type", "required": True, "description": "folder, file, template, or label."}], "example": "licos-platform uns node-schema file"},
-        "infer-definition": {"description": "Infer UNS definition fields from a JSON sample.", "parameters": [{"name": "--sample / --file", "required": True, "description": "Inline JSON sample text or a UTF-8 JSON sample file."}], "example": "licos-platform uns infer-definition --file sample.json"},
-        "reverse-datasources": {"description": "List data sources available for reverse modeling.", "parameters": [], "example": "licos-platform uns reverse-datasources"},
-        "reverse-schemas": {"description": "List database schemas available for reverse modeling.", "parameters": [], "example": "licos-platform uns reverse-schemas"},
-        "reverse-tables": {"description": "List reverse-modeling tables in one schema.", "parameters": [{"name": "schema", "required": True, "description": "Database schema name."}], "example": "licos-platform uns reverse-tables public"},
-        "reverse-fields": {"description": "List reverse-modeling field metadata for one table.", "parameters": [{"name": "schema", "required": True, "description": "Database schema name."}, {"name": "table", "required": True, "description": "Database table name."}], "example": "licos-platform uns reverse-fields public equipment"},
-        "attachments": {"description": "List attachments on one UNS node.", "parameters": [{"name": "node_id", "required": True, "description": "UNS node ID."}], "example": "licos-platform uns attachments <nodeId>"},
-        "attachment-upload": {"description": "Upload one or more local files to a UNS node.", "parameters": [{"name": "node_id", "required": True, "description": "UNS node ID."}, {"name": "files", "required": True, "description": "One or more local file paths."}], "example": "licos-platform uns attachment-upload <nodeId> report.pdf image.png"},
-        "attachment-download": {"description": "Download one UNS node attachment to a local file.", "parameters": [{"name": "node_id", "required": True, "description": "UNS node ID."}, {"name": "attachment_id", "required": True, "description": "Attachment ID."}, {"name": "--output", "required": True, "description": "Local output path."}], "example": "licos-platform uns attachment-download <nodeId> <attachmentId> --output report.pdf"},
-        "attachment-delete": {"description": "Delete one UNS node attachment after confirmation.", "parameters": [{"name": "node_id", "required": True, "description": "UNS node ID."}, {"name": "attachment_id", "required": True, "description": "Attachment ID."}, {"name": "--confirm", "required": True, "description": "Confirm deletion."}], "example": "licos-platform uns attachment-delete <nodeId> <attachmentId> --confirm"},
-        "latest": {"description": "Read one UNS node latest runtime value.", "parameters": [{"name": "node_id", "required": True, "description": "UNS node ID."}], "example": "licos-platform uns latest <nodeId>"},
-        "history": {"description": "Read one UNS node runtime history.", "parameters": [{"name": "node_id", "required": True, "description": "UNS node ID."}, {"name": "--limit", "required": False, "description": "Maximum records, default 100."}], "example": "licos-platform uns history <nodeId> --limit 100"},
-        "realtime-config": {"description": "Issue a one-time ticket and return the platform WebSocket URL.", "parameters": [], "example": "licos-platform uns realtime-config"},
-        "collectors": {"description": "List point collectors or video devices.", "parameters": [{"name": "--source-type", "required": True, "description": "IOT_POINT_COLLECTOR or IOT_VIDEO_DEVICE_COLLECTOR."}, {"name": "--page / --page-size", "required": False, "description": "Pagination."}], "example": "licos-platform uns collectors --source-type IOT_POINT_COLLECTOR"},
-        "points": {"description": "List collection points or video channels.", "parameters": [{"name": "task_id", "required": True, "description": "Collector task or video device ID."}, {"name": "--source-type", "required": True, "description": "Source type."}], "example": "licos-platform uns points <taskId> --source-type IOT_POINT_COLLECTOR"},
-        "source-latest": {"description": "Read one upstream collection point latest value.", "parameters": [{"name": "task_id", "required": True, "description": "Collector task ID."}, {"name": "point_id", "required": True, "description": "Point ID."}, {"name": "--tag-code / --node-id", "required": False, "description": "Optional business correlation."}], "example": "licos-platform uns source-latest <taskId> <pointId>"},
-        "video-stream": {"description": "Get supported playback options for one video channel.", "parameters": [{"name": "channel_id", "required": True, "description": "Video channel ID."}], "example": "licos-platform uns video-stream <channelId>"},
-    },
-}
-
-
-INDUSTRIAL_HELP = {
-    "topic": "industrial",
-    "description": (
-        "Maintain collection tasks, points, values, video devices and channels through the "
-        "platform UNS industrial runtime gateway."
-    ),
-    "runtime": RUNTIME_ENV,
-    "rules": [
-        "Use uns schema/capabilities/validate/plan/submit for first-time connection, task, point, video, and UNS provisioning.",
-        "Use industrial commands after provisioning to inspect or modify an existing resource and to read/write/control runtime data.",
-        "Before an update, read the current resource and preserve fields that are not intentionally changed.",
-        "Point write and PTZ commands are side effects: identify the exact target, verify access/capabilities, execute once, and read back the result.",
-        "Use --payload or --payload-file for request bodies and --query for platform-supported query filters; every value is a JSON object.",
-        "Delete commands require --confirm.",
-    ],
-    "commands": {
-        "collectors": {"description": "List point collectors or video devices.", "parameters": [{"name": "--source-type", "required": True, "description": "IOT_POINT_COLLECTOR or IOT_VIDEO_DEVICE_COLLECTOR."}], "example": "licos-platform industrial collectors --source-type IOT_POINT_COLLECTOR"},
-        "points": {"description": "List task points or device video channels.", "parameters": [{"name": "task_id", "required": True, "description": "Task or device ID."}, {"name": "--source-type", "required": True, "description": "Source type."}], "example": "licos-platform industrial points <taskId> --source-type IOT_POINT_COLLECTOR"},
-        "latest": {"description": "Read one upstream point latest value.", "parameters": [{"name": "task_id", "required": True, "description": "Collector task ID."}, {"name": "point_id", "required": True, "description": "Point ID."}, {"name": "--tag-code / --node-id", "required": False, "description": "Optional business correlation."}], "example": "licos-platform industrial latest <taskId> <pointId>"},
-        "video-stream": {"description": "Get playback options for one video channel.", "parameters": [{"name": "channel_id", "required": True, "description": "Video channel ID."}], "example": "licos-platform industrial video-stream <channelId>"},
-        "connections": {"description": "List saved protocol connections.", "parameters": [{"name": "--query", "type": "JSON object", "required": False, "description": "Platform-supported filters such as keyword, protocol, enabled, page, and pageSize."}], "example": "licos-platform industrial connections --query '{\"protocol\":\"modbus-tcp\"}'"},
-        "connection": {"description": "Get one saved protocol connection.", "parameters": [{"name": "connection_id", "type": "string", "required": True, "description": "Existing connection ID."}], "example": "licos-platform industrial connection <connectionId>"},
-        "connection-update": {"description": "Update one saved protocol connection.", "parameters": [{"name": "connection_id", "type": "string", "required": True, "description": "Existing connection ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Complete connection object after merging intended changes into the current resource; protocol-specific config follows the current platform schema."}], "example": "licos-platform industrial connection-update <connectionId> --payload-file connection.json"},
-        "connection-test": {"description": "Test one saved protocol connection.", "parameters": [{"name": "connection_id", "type": "string", "required": True, "description": "Existing connection ID."}], "example": "licos-platform industrial connection-test <connectionId>"},
-        "connection-delete": {"description": "Delete one saved protocol connection.", "parameters": [{"name": "connection_id", "type": "string", "required": True, "description": "Existing connection ID."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Explicit destructive-operation confirmation after checking dependent tasks."}], "example": "licos-platform industrial connection-delete <connectionId> --confirm"},
-        "tasks": {"description": "List collection tasks.", "parameters": [{"name": "--query", "type": "JSON object", "required": False, "description": "Filters such as keyword, protocol, desiredState, runtimeState, page, and pageSize."}], "example": "licos-platform industrial tasks --query '{\"runtimeState\":\"running\"}'"},
-        "task": {"description": "Get one collection task.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Existing task ID."}], "example": "licos-platform industrial task <taskId>"},
-        "task-status": {"description": "Get one task desired/runtime status.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Existing task ID."}], "example": "licos-platform industrial task-status <taskId>"},
-        "task-update": {"description": "Update one existing collection task.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Existing task ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Task fields such as name, protocol, connectionId, desiredState, schedule, and config."}], "example": "licos-platform industrial task-update <taskId> --payload-file task.json"},
-        "task-action": {"description": "Start, stop, restart, or run one task once.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Existing task ID."}, {"name": "action", "type": "enum", "required": True, "values": ["start", "stop", "restart", "run-once"], "description": "Lifecycle action."}], "example": "licos-platform industrial task-action <taskId> restart"},
-        "task-delete": {"description": "Delete one collection task.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Existing task ID."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Explicit destructive-operation confirmation."}], "example": "licos-platform industrial task-delete <taskId> --confirm"},
-        "task-points": {"description": "List points belonging to one task.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Existing task ID."}, {"name": "--query", "type": "JSON object", "required": False, "description": "Filters such as keyword, tagCode, dataType, enabled, page, and pageSize."}], "example": "licos-platform industrial task-points <taskId> --query '{\"enabled\":true}'"},
-        "point": {"description": "Get one collection point.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Parent task ID."}, {"name": "point_id", "type": "string", "required": True, "description": "Existing point ID."}], "example": "licos-platform industrial point <taskId> <pointId>"},
-        "point-update": {"description": "Update one existing collection point.", "parameters": [{"name": "task_id / point_id", "type": "string", "required": True, "description": "Parent task ID and point ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Point fields including tagCode, name, protocolAddress, dataType, accessMode, pollIntervalMs, unit, enabled, and metadata."}], "example": "licos-platform industrial point-update <taskId> <pointId> --payload-file point.json"},
-        "point-validate": {"description": "Validate point definitions without saving.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Parent task ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Platform validation request."}], "example": "licos-platform industrial point-validate <taskId> --payload-file points.json"},
-        "point-test-read": {"description": "Read selected point definitions once without changing the task.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Parent task ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Platform test-read request."}], "example": "licos-platform industrial point-test-read <taskId> --payload-file points.json"},
-        "point-write": {"description": "Write explicitly selected writable points.", "parameters": [{"name": "task_id", "type": "string", "required": True, "description": "Parent task ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Platform point write request; only target points with write access."}], "example": "licos-platform industrial point-write <taskId> --payload-file write.json"},
-        "point-delete": {"description": "Delete one collection point.", "parameters": [{"name": "task_id / point_id", "type": "string", "required": True, "description": "Parent task ID and point ID."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Explicit destructive-operation confirmation."}], "example": "licos-platform industrial point-delete <taskId> <pointId> --confirm"},
-        "values-latest": {"description": "Read the cloud-side latest sample snapshot.", "parameters": [{"name": "--task-id / --point-id / --tag-code", "type": "string", "required": False, "description": "Optional selectors; combine only identifiers for the same target."}], "example": "licos-platform industrial values-latest --point-id <pointId>"},
-        "values-history": {"description": "Read persisted point history.", "parameters": [{"name": "--task-id / --point-id / --tag-code", "type": "string", "required": False, "description": "Optional target selectors."}, {"name": "--start-time / --end-time", "type": "RFC3339 string", "required": False, "description": "History time range."}, {"name": "--page / --page-size", "type": "integer", "required": False, "description": "Pagination; defaults to 1 and 100."}], "example": "licos-platform industrial values-history --point-id <pointId> --start-time 2026-07-24T00:00:00Z"},
-        "values-direct-read": {"description": "Read a current point value through its online edge channel.", "parameters": [{"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "taskId and pointId are required; agentId and tagCode are optional consistency checks."}], "example": "licos-platform industrial values-direct-read --payload '{\"taskId\":\"task\",\"pointId\":\"point\"}'"},
-        "video-devices": {"description": "List video devices.", "parameters": [{"name": "--query", "type": "JSON object", "required": False, "description": "Filters such as keyword, ingestProtocol, onlineStatus, page, and pageSize."}], "example": "licos-platform industrial video-devices --query '{\"onlineStatus\":\"online\"}'"},
-        "video-device": {"description": "Get one video device.", "parameters": [{"name": "device_id", "type": "string", "required": True, "description": "Existing video device ID."}], "example": "licos-platform industrial video-device <deviceId>"},
-        "video-device-update": {"description": "Update one existing video device.", "parameters": [{"name": "device_id", "type": "string", "required": True, "description": "Existing device ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Device fields defined by the current platform contract."}], "example": "licos-platform industrial video-device-update <deviceId> --payload-file device.json"},
-        "video-device-action": {"description": "Test, enable/disable, or synchronize one video device.", "parameters": [{"name": "device_id", "type": "string", "required": True, "description": "Existing device ID."}, {"name": "action", "type": "enum", "required": True, "values": ["test-connection", "toggle-enabled", "sync-channels"], "description": "Device action."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": False, "description": "Action-specific request body."}], "example": "licos-platform industrial video-device-action <deviceId> test-connection"},
-        "video-device-delete": {"description": "Delete one video device.", "parameters": [{"name": "device_id", "type": "string", "required": True, "description": "Existing device ID."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Explicit destructive-operation confirmation."}], "example": "licos-platform industrial video-device-delete <deviceId> --confirm"},
-        "video-channels": {"description": "List video channels.", "parameters": [{"name": "--query", "type": "JSON object", "required": False, "description": "Filters such as deviceId, streamType, ptzSupported, enabled, page, and pageSize."}], "example": "licos-platform industrial video-channels --query '{\"deviceId\":\"device\"}'"},
-        "video-channel": {"description": "Get one video channel.", "parameters": [{"name": "channel_id", "type": "string", "required": True, "description": "Existing video channel ID."}], "example": "licos-platform industrial video-channel <channelId>"},
-        "video-channel-update": {"description": "Update one existing video channel.", "parameters": [{"name": "channel_id", "type": "string", "required": True, "description": "Existing channel ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": True, "description": "Channel fields defined by the current platform contract."}], "example": "licos-platform industrial video-channel-update <channelId> --payload-file channel.json"},
-        "video-channel-delete": {"description": "Delete one video channel.", "parameters": [{"name": "channel_id", "type": "string", "required": True, "description": "Existing channel ID."}, {"name": "--confirm", "type": "flag", "required": True, "description": "Explicit destructive-operation confirmation."}], "example": "licos-platform industrial video-channel-delete <channelId> --confirm"},
-        "video-capabilities": {"description": "Get playback, PTZ, and preset capabilities.", "parameters": [{"name": "channel_id", "type": "string", "required": True, "description": "Existing channel ID."}], "example": "licos-platform industrial video-capabilities <channelId>"},
-        "video-snapshot": {"description": "Create one video snapshot.", "parameters": [{"name": "channel_id", "type": "string", "required": True, "description": "Existing channel ID."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": False, "description": "Optional snapshot options."}], "example": "licos-platform industrial video-snapshot <channelId>"},
-        "video-ptz": {"description": "Move/stop PTZ or set/go to a preset.", "parameters": [{"name": "channel_id", "type": "string", "required": True, "description": "Existing channel ID."}, {"name": "action", "type": "enum", "required": True, "values": ["move", "stop", "preset/set", "preset/goto"], "description": "PTZ action."}, {"name": "--payload / --payload-file", "type": "JSON object", "required": False, "description": "Action payload, for example direction/speed/durationMs or presetId/presetName."}], "example": "licos-platform industrial video-ptz <channelId> move --payload '{\"direction\":\"left\",\"speed\":30,\"durationMs\":1000}'"},
+        "search": {
+            "description": "Search the current user's ontology AI tool catalog.",
+            "parameters": [
+                {"name": "query", "required": True, "description": "Natural-language capability query."},
+                {"name": "--limit", "required": False, "description": "Result count from 1 to 10; default 5."},
+                {"name": "--offset", "required": False, "description": "Catalog result offset."},
+            ],
+            "example": "licos-platform ontology search '查询设备实时数据' --limit 5",
+        },
+        "invoke": {
+            "description": "Resolve an exact catalog function name and invoke it with structured arguments.",
+            "parameters": [
+                {"name": "name", "required": True, "description": "Exact function name returned by search."},
+                {"name": "--arguments / --arguments-file", "required": True, "description": "Tool arguments as a JSON object."},
+                {"name": "--catalog-version", "required": False, "description": "catalogVersion returned by the search that supplied the function schema."},
+                {"name": "--confirm", "required": False, "description": "Required for PERSIST tools."},
+            ],
+            "example": "licos-platform ontology invoke <精确函数名> --catalog-version <版本> --arguments '{\"参数名\":\"参数值\"}'",
+        },
     },
 }
 
@@ -936,9 +851,8 @@ HELP_TOPICS = {
     "database": DATABASE_HELP,
     "knowledge": KNOWLEDGE_HELP,
     "oauth": OAUTH_HELP,
-    "project-config": PROJECT_CONFIG_HELP,
-    "industrial": INDUSTRIAL_HELP,
-    "uns": UNS_HELP,
+    "project-config": PROJECT_CONFIG_HELP,
+    "ontology": ONTOLOGY_HELP,
 }
 
 
@@ -962,8 +876,8 @@ def _cmd_help(args: argparse.Namespace) -> dict[str, Any]:
                 "licos-platform help oauth",
                 "licos-platform help oauth configure-project",
                 "licos-platform help project-config set-database",
-                "licos-platform help uns",
-                "licos-platform help uns capabilities",
+                "licos-platform help ontology",
+                "licos-platform help ontology search",
             ],
             "topics": sorted(HELP_TOPICS),
         }

{licos_platform_cli-0.4.4 → licos_platform_cli-0.4.6}/src/licos_platform_cli/main.py

@@ -9,12 +9,11 @@ from licos_platform_sdk import PlatformSdkError
 
 from .database_commands import add_database_parser
 from .help_commands import add_help_parser
-from .industrial_commands import add_industrial_parser
 from .knowledge_commands import add_knowledge_parser
 from .oauth_commands import add_oauth_parser
+from .ontology_commands import add_ontology_parser
 from .project_config_commands import add_project_config_parser
 from .storage_commands import add_storage_parser
-from .uns_commands import add_uns_parser
 
 
 def _print_json(value: Any) -> None:
@@ -38,8 +37,7 @@ def _build_parser() -> argparse.ArgumentParser:
     add_knowledge_parser(subparsers)
     add_oauth_parser(subparsers)
     add_project_config_parser(subparsers)
-    add_uns_parser(subparsers)
-    add_industrial_parser(subparsers)
+    add_ontology_parser(subparsers)
     return parser
 
 

licos_platform_cli-0.4.6/src/licos_platform_cli/ontology_commands.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any, Callable
+
+from licos_platform_sdk import ontology
+
+
+Handler = Callable[[argparse.Namespace], Any]
+
+
+def _set_handler(parser: argparse.ArgumentParser, handler: Handler) -> None:
+    parser.set_defaults(handler=handler)
+
+
+def _arguments(args: argparse.Namespace) -> dict[str, Any]:
+    raw = args.arguments
+    if args.arguments_file:
+        raw = Path(args.arguments_file).read_text(encoding="utf-8")
+    try:
+        value = json.loads(raw)
+    except json.JSONDecodeError as exc:
+        raise argparse.ArgumentTypeError(f"arguments must be valid JSON: {exc.msg}") from exc
+    if not isinstance(value, dict):
+        raise argparse.ArgumentTypeError("arguments must be a JSON object")
+    return value
+
+
+def _cmd_search(args: argparse.Namespace) -> Any:
+    return ontology.search_tools(args.query, limit=args.limit, offset=args.offset)
+
+
+def _cmd_invoke(args: argparse.Namespace) -> Any:
+    catalog_version, item = ontology.resolve_tool(args.name)
+    if args.catalog_version and args.catalog_version != catalog_version:
+        raise argparse.ArgumentTypeError(
+            "ontology tool catalog changed; search again before invoking the tool"
+        )
+    if item["mode"] == "PERSIST" and not args.confirm:
+        raise argparse.ArgumentTypeError(
+            f"ontology tool {args.name!r} persists changes; invoke it again with --confirm"
+        )
+    return ontology.invoke_tool(
+        args.name,
+        _arguments(args),
+        catalog_version=catalog_version,
+    )
+
+
+def add_ontology_parser(
+    subparsers: argparse._SubParsersAction[argparse.ArgumentParser],
+) -> None:
+    parser = subparsers.add_parser(
+        "ontology",
+        help="Discover and invoke authorized ontology and Data Factory AI tools",
+    )
+    commands = parser.add_subparsers(dest="ontology_command", required=True)
+
+    search = commands.add_parser("search", help="Search the authorized AI tool catalog")
+    search.add_argument("query")
+    search.add_argument("--limit", type=int, default=5, choices=range(1, 11))
+    search.add_argument("--offset", type=int, default=0)
+    _set_handler(search, _cmd_search)
+
+    invoke = commands.add_parser("invoke", help="Resolve and invoke one catalog tool")
+    invoke.add_argument("name")
+    source = invoke.add_mutually_exclusive_group(required=True)
+    source.add_argument("--arguments", help="Inline JSON object with tool arguments")
+    source.add_argument("--arguments-file", help="UTF-8 JSON object file")
+    invoke.add_argument(
+        "--catalog-version",
+        help="catalogVersion returned by the search that supplied the function schema",
+    )
+    invoke.add_argument("--confirm", action="store_true")
+    _set_handler(invoke, _cmd_invoke)