[ako]

Syncs ako/mxcli:main into upstream: 8 commits since #1777 — agent documents round-trip byte for byte, new MDL for Agent Editor settings and published MCP services, and catalog refs for mappings.

Agents: a rewrite keeps what Agent Editor stored

alter agent, alter knowledge base and create or modify of an agent, AI model or knowledge base rebuilt the document's Contents from mxcli's typed fields, so everything else Agent Editor stores was lost: per-tool approval and display text, the agent's streaming switches and selected model, a knowledge base tool's minimum similarity. The knowledge base's Portal name was written as "", and on create or modify so were the model's type and name. create or modify agent also ignored a tool block's Document (the tool ran no microflow), dropped MCP service tools' service (it compared "mcp" with the stored "MCP"), wrote every tool with an empty id, and blanked the entity reference's documentId.

A rewrite now writes onto the stored Contents: unmodelled keys keep their value and position, tool entries pair by id, and the stored layout (Agent Editor 2.6's two-space indent, or compact) is kept. Measured on Studio Pro 11.16 projects: describe → exec of 34 agent documents writes nothing, byte for byte, and alter changes only the property it sets.

Agents: approval, display text and streaming in MDL

Agent Editor 2.2+ stores human-in-the-loop and streaming settings in the agent document (measured on 11.12–11.16):

• tool / mcp service block: UserAccessApproval (HiddenForUser | VisibleForUser | UserConfirmationRequired), DisplayTitle, DisplayDescription
• knowledge base block: MinSimilarity, IsVisible
• agent: EnableBackendStreaming, EnableUIStreaming

describe prints them, alter agent … set takes the streaming switches and alter … add the block keys. A create or modify that leaves one out keeps its stored value, so older scripts don't reset them.

Agents: publish the app's microflows as an MCP server

New: create [or modify] / alter (set, add tool, drop tool) / describe / list / drop published mcp service — MCP Server 5.x's model configuration (Agent Editor 2.6's publishedMCPService document), with tool blocks (Microflow, Description, Title, Schema) and authentication (AuthenticationEnabled, AuthenticationMicroflow, AuthorizationServerUrl, Scopes). A rewrite writes onto the stored Contents as above, and check reports what CreateMCPServer would refuse (MDL-MCPSERVER01). Measured on Studio Pro 11.16, Agent Editor 2.6.0, MCP Server 5.4.0: describe → exec of stored services writes nothing; a new authenticated service re-execs unchanged and adds no mx check errors.

A new mcp-server skill covers both routes: the startup-microflow route of MCP Server 3.x–4.x (CreateMCPServer / AddTool / AddPrompt with the parameters read from 3.0.0, 4.0.0 and 4.2.2) and 5.x's model configuration, mapping each runtime parameter to its document key. Its example handles its Java action errors (CreateMCPServer throws when the application root URL is unset) and passes check, exec, lint and mx check against an untouched copy.

Catalog: refs for mappings and JSON structures

A flow applying an import or export mapping (import/export action, REST or web service call), and a mapping built on a JSON structure, made no refs row, so refs, show callers and orphan checks reported them as unreferenced — on one real 11.16 app, 54 of 55 import mappings, 42 of 44 export mappings and 65 of 66 JSON structures. refs gains mapping_call (flow → mapping) and structure (mapping → JSON structure) edges. Schema version 35 rebuilds cached catalogs. Fixes #1703