MIZ OKI Integration Plan: Merge miz-oki-integration 2 into MIZOKICloudRun

1. Executive Summary

We are merging the legacy integration package into the live codebase using a compatibility-first approach. The canonical Boss Agent remains miz-oki-adk-agents/boss/boss_agent_core.py, and the integration package is folded in by adding legacy API endpoints, client types, and hook aliases that match the older surface area without regressing current capabilities.

Key decisions: - Keep boss_agent_core.py as the single source of truth. - Add legacy endpoints that map to the modern SRPVDAL and KG implementations. - Update the Command Center UI to expose missing legacy client types and hook names. - Align deployment pipeline scripts to boss-agent-adk and boss_agent_core.py.

2. Compatibility Strategy

Backend

• Add legacy endpoints into boss_agent_core.py using existing managers (srpvdal_orchestrator, conversation_manager, session_manager, kg_controller).
• Preserve current /api/v1/* endpoints; legacy paths are additive.
• Provide response shapes compatible with the integration package without breaking newer clients.

Frontend

• Keep miz-oki-command-center-ui as the canonical frontend.
• Add compatibility types and hook aliases so useBoss* and older client signatures work.

Deployment

• Update deployment/boss-agent-pipeline to deploy boss-agent-adk.
• Align Cloud Build and deployment flags with miz-oki-adk-agents/boss/cloudbuild.v5.yaml.

3. Implementation Steps

1. Add legacy compatibility endpoints in boss_agent_core.py.
2. Merge missing client types into miz-oki-command-center-ui/lib/api/boss.ts.
3. Add a legacy hook export file miz-oki-command-center-ui/hooks/api/useBoss.ts.
4. Update environment templates with the canonical Boss Agent URL.
5. Align deployment scripts and Cloud Build configs to boss-agent-adk.
6. Refresh MCP capability registries and docs based on verified external sources.

4. Files Updated

• miz-oki-adk-agents/boss/boss_agent_core.py
• miz-oki-command-center-ui/lib/api/boss.ts
• miz-oki-command-center-ui/hooks/api/useBoss.ts
• miz-oki-command-center-ui/env.example
• deployment/boss-agent-pipeline/Dockerfile
• deployment/boss-agent-pipeline/cloudbuild.yaml
• deployment/boss-agent-pipeline/deploy.sh
• docs/MCP_INTEGRATION_ARCHITECTURE.md
• docs/API_PLATFORM_CHANGES_2026.md
• miz-oki-adk-agents/boss/config/platform_skills_registry.yaml
• miz-oki-adk-agents/boss/mcp_capability_registry.py
• mcp/service_registry.yaml

5. Validation

• pytest miz-oki-adk-agents/boss/tests
• npm run lint in miz-oki-command-center-ui
• Manual smoke tests: GET /health, POST /api/v1/chat, POST /process, GET /agents, GET /conversations/{user_id}