Skip to content

MCP: remove fake GridSmith server boundary#2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fredporter merged 1 commit into from
Aug 19, 2026
Merged

MCP: remove fake GridSmith server boundary #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 13 additions & 24 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,7 @@ uDosGo code surfaces. It is designed to be consumed by host applications such as
uCode internals.

**uCode is not a full application GUI.** It provides the foundational runtime
packages, grid/code algebra, import/export tooling, CLI/MCP surfaces, and
packages, grid/code algebra, import/export tooling, CLI surfaces, and
inspectable render targets such as terminal and teletext widgets.

The advanced runtime layer is now tracked as **uCode2**. uCode2 is reserved for
Expand All@@ -27,11 +27,11 @@ Application-specific runtime concerns that belong to HomeNest should live in
| ---------------------------- | -------------------------------------------------- |
| `packages/gridcore` | Grid algebra, code addressing, cell/layer model |
| `packages/viewport-renderer` | Browser render surfaces, Terminal/Teletext widgets |
| `agents/gridsmith` | CLI/MCP/import/export/build tooling |
| `agents/gridsmith` | CLI/import/export/build tooling |
| `runtimes/basic` | BASIC runtime bridge/package |
| `runtimes/amos` | AMOS runtime bridge/package |
| `shared` | Cross-runtime support (not host-app-specific) |
| `config/` | AI routing, MCP definitions, vault config |
| `config/` | Runtime and development configuration |
| `docs/` | Specs, boundary docs, workflows |
| `tests/` | Integration tests |

Expand All@@ -43,8 +43,9 @@ Application-specific runtime concerns that belong to HomeNest should live in
- User/session/application state
- Long-running command-centre behaviour

uCore and other hosts should consume uCode through **package, CLI, MCP, or
runtime artifact boundaries**.
uCore and other hosts should consume uCode through **package, CLI, or runtime
artifact boundaries**. External MCP exposure belongs to uCore's canonical
`udos-mcp` gateway.

---

Expand All@@ -56,12 +57,12 @@ uCode/
│ ├── gridcore/ Grid algebra and core grid/code primitives
│ └── viewport-renderer/ Terminal/teletext/browser render surfaces
├── agents/
│ └── gridsmith/ CLI, MCP, and import/export tooling
│ └── gridsmith/ CLI and import/export tooling
├── runtimes/
│ ├── basic/ BASIC runtime bridge/package
│ └── amos/ AMOS runtime bridge/package
├── shared/ Cross-runtime support
├── config/ AI routing, MCP, vault configuration
├── config/ Runtime and development configuration
├── docs/ Specs, boundary docs, workflows
├── tests/ Integration tests
└── README.md This file
Expand DownExpand Up@@ -132,24 +133,12 @@ runtimes/

---

## AI Integration
## External Tool Integration

uCode provides MCP tooling (via GridSmith) that can be consumed by AI agents.
For full AI provider routing (Ollama, OpenRouter, Hivemind), uCode delegates to
uCore's snackbar daemon:

```
GridSmith MCP → uCore Snackbar (port 8484) → LiteLLM → Ollama/OpenRouter
```

Configuration lives in `config/`:

| File | Purpose |
| ------------------------ | ------------------------------- |
| `config/hivemind.env` | API keys for OpenRouter, Ollama |
| `config/openrouter.yaml` | Model routing tiers & costs |
| `config/mcp_config.json` | MCP server definitions |
| `config/vault.yaml` | Vault/secret paths |
GridSmith exposes deterministic package and CLI contracts. uCore invokes those
contracts through its GridSmith bridge and selectively exposes bounded reads
through the canonical `udos-mcp` gateway. uCode does not run an MCP server,
proxy providers, or own client configuration.

## Embedding uCode

Expand Down
4 changes: 2 additions & 2 deletions agents/gridsmith/README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -8,7 +8,7 @@ GridSmith is responsible for:

- creating and managing grid worlds under `uCode/workspaces/gridcore`
- importing BASIC and AMOS-oriented world inputs into grid artifacts
- exposing tool contracts that can later be surfaced via uCore MCP and REST
- exposing CLI tool contracts that uCore can adapt through owned APIs
- consuming the live `@udos/gridcore` and `@udos/viewport-renderer` packages

It is not a replacement for GridCore or GridUI. It is the orchestration layer for world-building on top of those packages.
Expand All@@ -34,4 +34,4 @@ npm run build --workspace @udos/gridsmith
node ./agents/gridsmith/dist/cli.js grid create --cols 80 --rows 24
node ./agents/gridsmith/dist/cli.js location latlon-to-ucode --lat -33.8688 --lon 151.2093 --level 340
node ./agents/gridsmith/dist/cli.js location ucode-to-latlon --coord L340-0A0B-0000-0
```
```
Loading
Loading