{
  "schema_version": 1,
  "release_version": "0.2.5",
  "repository": "https://github.com/cwfs-insight/realinsight-agent-toolkit",
  "defaults": {
    "harness": "chatgpt",
    "surface": "desktop",
    "transport": "remote",
    "environment": "prod"
  },
  "copy_templates": {
    "chatgpt_remote_desktop": "{{mcp_url}}",
    "codex_remote_desktop": "Repository: https://github.com/cwfs-insight/realinsight-agent-toolkit\nReference: main\nSparse paths: leave empty\nPlugin: {{plugin_name}}",
    "codex_remote_cli": "codex plugin marketplace add cwfs-insight/realinsight-agent-toolkit --ref main\ncodex",
    "codex_local_desktop": "npm run package:plugins -- --env {{environment_code}} --type codex --runtime node\n\nMarketplace folder:\n{{codex_marketplace}}",
    "codex_local_cli": "npm run package:plugins -- --env {{environment_code}} --type codex --runtime node\ncodex plugin marketplace add {{codex_marketplace}}\ncodex",
    "claude_remote_desktop": "{{mcp_url}}",
    "claude_remote_cli": "/plugin marketplace add cwfs-insight/realinsight-agent-toolkit\n/plugin install {{plugin_name}}@realinsight",
    "claude_local_desktop": "npm run package:plugins -- --env {{environment_code}} --type claude-mcpb --runtime node\nmcpb pack {{claude_mcpb_source}}",
    "claude_local_cli": "npm run package:plugins -- --env {{environment_code}} --type claude-plugin --runtime node\n/plugin marketplace add {{claude_marketplace}}\n/plugin install {{plugin_name}}@{{claude_marketplace_name}}",
    "generic_remote_mcp": "{\n  \"mcpServers\": {\n    \"{{server_name}}\": {\n      \"type\": \"http\",\n      \"url\": \"{{mcp_url}}\"\n    }\n  }\n}",
    "generic_local_stdio": "{\n  \"mcpServers\": {\n    \"{{server_name}}\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\"./src/ri-agent.mjs\", \"mcp\"],\n      \"cwd\": \"/absolute/path/to/realinsight-agent-toolkit/packages/agent-toolkit\",\n      \"env\": {\n        \"RI_AGENT_BASE_URL\": \"{{base_url}}\",\n        \"RI_AGENT_PROFILE\": \"{{profile}}\",\n        \"REALINSIGHT_AGENT_CONFIG\": \"/absolute/path/to/.realinsight/agent-toolkit-{{profile_suffix}}.json\",\n        \"RI_AGENT_MAX_TOOL_RESULT_BYTES\": \"240000\"\n      }\n    }\n  }\n}"
  },
  "environments": {
    "prod": {
      "label": "Production",
      "base_url": "https://www.realinsight.cloud/api/v1",
      "mcp_url": "https://www.realinsight.cloud/api/v1/mcp",
      "profile": "realinsight-prod",
      "profile_suffix": "prod",
      "server_name": "realinsight-agent-toolkit",
      "plugin_name": "realinsight-connector",
      "remote_example": "examples/mcp/mcp.prod.json",
      "local_example": "examples/mcp/mcp.prod-source.json",
      "providers": {
        "codex": "providers/codex/prod",
        "claude": "providers/claude/prod",
        "cursor": "providers/cursor/plugin"
      }
    },
    "qa": {
      "label": "QA",
      "base_url": "https://www.ri2-qa.com/api/v1",
      "mcp_url": "https://www.ri2-qa.com/api/v1/mcp",
      "profile": "realinsight-qa",
      "profile_suffix": "qa",
      "server_name": "realinsight-agent-toolkit-qa",
      "plugin_name": "realinsight-connector-qa",
      "remote_example": "examples/mcp/mcp.qa.json",
      "local_example": "examples/mcp/mcp.qa-source.json",
      "providers": {
        "codex": "providers/codex/qa",
        "claude": "providers/claude/qa",
        "cursor": "providers/cursor/qa/plugin"
      },
      "warning": "QA is for controlled testing. Keep its profile and credential file separate from production."
    },
    "dev": {
      "label": "Development",
      "base_url": "https://www.ri2-dev.com/api/v1",
      "mcp_url": "https://www.ri2-dev.com/api/v1/mcp",
      "profile": "realinsight-dev",
      "profile_suffix": "dev",
      "server_name": "realinsight-agent-toolkit-dev",
      "plugin_name": "realinsight-connector-dev",
      "remote_example": "providers/cursor/dev/plugin/mcp.json",
      "local_example": "examples/mcp/mcp.dev-source.json",
      "providers": {
        "codex": "providers/codex/dev",
        "claude": "providers/claude/dev",
        "cursor": "providers/cursor/dev/plugin"
      },
      "warning": "Development is for Realinsight development and approved testing. Keep it isolated from QA and production."
    }
  },
  "harnesses": {
    "chatgpt": {
      "label": "ChatGPT",
      "remote_http": true,
      "local_node": false,
      "surfaces": [
        "desktop"
      ],
      "guide": "install/chatgpt.md"
    },
    "codex": {
      "label": "Codex",
      "remote_http": true,
      "local_node": true,
      "surfaces": [
        "desktop",
        "cli"
      ],
      "guide": "install/codex.md"
    },
    "claude": {
      "label": "Claude / Claude Code",
      "remote_http": true,
      "local_node": true,
      "surfaces": [
        "desktop",
        "cli"
      ],
      "guide": "install/claude.md"
    },
    "cursor": {
      "label": "Cursor",
      "remote_http": true,
      "local_node": true,
      "surfaces": [
        "desktop"
      ],
      "guide": "install/cursor.md"
    },
    "pi": {
      "label": "Pi or another MCP harness",
      "remote_http": true,
      "local_node": true,
      "surfaces": [
        "cli"
      ],
      "guide": "install/other-harnesses.md"
    }
  },
  "guardrails": [
    "Native desktop app instructions are the default when the harness provides a documented desktop path.",
    "CLI instructions are explicit alternatives for Codex, Claude Code, and CLI-first MCP harnesses.",
    "Copyable command and configuration templates are machine-readable under copy_templates.",
    "Remote HTTP MCP is the default installation path.",
    "Production is the default environment.",
    "Local Node MCP runs checked-in source from a clone.",
    "The native Realinsight toolkit package is not yet available through npm or npx.",
    "Non-production profiles and credential files must stay isolated.",
    "Realinsight APIs enforce the signed-in user's customer context, permissions, and scopes."
  ]
}
