diff --git a/apps/web/src/app/docs/architecture/page.tsx b/apps/web/src/app/docs/architecture/page.tsx
index aa9e73a..ee5c214 100644
--- a/apps/web/src/app/docs/architecture/page.tsx
+++ b/apps/web/src/app/docs/architecture/page.tsx
@@ -13,13 +13,13 @@ function ArchBox({
}: {
children: React.ReactNode;
className?: string;
- variant?: 'default' | 'primary' | 'muted' | 'header';
+ variant?: 'default' | 'muted' | 'header';
}) {
const variants = {
default: 'border-border bg-surface',
- primary: 'border-primary/50 bg-primary/5',
- muted: 'border-border/50 bg-surface-secondary/50',
- header: 'border-primary bg-primary/10 font-mono text-sm font-medium text-primary',
+ muted: 'border-border bg-surface-secondary/70',
+ header:
+ 'border-border-strong bg-surface-secondary font-mono text-sm font-medium text-foreground',
};
return (
@@ -30,21 +30,15 @@ function ArchBox({
}
// Small cell for grid items
-function Cell({
- children,
- variant = 'default',
-}: {
- children: React.ReactNode;
- variant?: 'default' | 'accent' | 'muted';
-}) {
- const variants = {
- default: 'border-border bg-background text-foreground-secondary',
- accent: 'border-primary/30 bg-primary/5 text-primary',
- muted: 'border-border/50 bg-surface-secondary/30 text-foreground-tertiary',
- };
-
+function Cell({ children, muted = false }: { children: React.ReactNode; muted?: boolean }) {
return (
-
+
{children}
);
@@ -119,8 +113,8 @@ export default function ArchitecturePage(): React.ReactElement {
SDK Packages
- | @tpmjs/registry-search |
- @tpmjs/registry-execute |
+ @tpmjs/registry-search |
+ @tpmjs/registry-execute |
@tpmjs/types |
@tpmjs/ui |
@@ -132,9 +126,9 @@ export default function ArchitecturePage(): React.ReactElement {
MCP Protocol
- | Claude Desktop |
- Cursor |
- Claude Code |
+ Claude Desktop |
+ Cursor |
+ Claude Code |
Any MCP Client |
@@ -151,9 +145,9 @@ export default function ArchitecturePage(): React.ReactElement {
/api/tools/execute |
/api/collections |
/api/agents |
- /api/mcp/* |
- /api/sync/* |
- /api/health |
+ /api/mcp/* |
+ /api/sync/* |
+ /api/health |
{/* Bottom Layer - Infrastructure */}
@@ -168,7 +162,7 @@ export default function ArchitecturePage(): React.ReactElement {
| PostgreSQL (Neon) |
- Prisma ORM |
+ Prisma ORM |
@@ -176,8 +170,8 @@ export default function ArchitecturePage(): React.ReactElement {
Execution
- | Vercel Sandbox |
- Custom Executors |
+ Vercel Sandbox |
+ Custom Executors |
@@ -186,7 +180,7 @@ export default function ArchitecturePage(): React.ReactElement {
| npm Registry |
- esm.sh CDN |
+ esm.sh CDN |
@@ -201,20 +195,20 @@ export default function ArchitecturePage(): React.ReactElement {
{/* Request */}
-
+
1. REQUEST
SDK:
- registryExecute()
+ registryExecute()
MCP:
- tools/call
+ tools/call
Agent:
- tool_call
+ tool_call
@@ -236,16 +230,16 @@ export default function ArchitecturePage(): React.ReactElement {
{/* Executor */}
-
+
3. EXECUTE
-
+
npm install pkg
-
+
tool.execute(params)
-
@@ -297,26 +291,26 @@ export default function ArchitecturePage(): React.ReactElement {
- ✓
+ ✓
Network isolated
- ✓
+ ✓
Per-request env injection
- ✓
+ ✓
Automatic npm install
- ✓
+ ✓
Cold start optimized
{/* Custom Executor */}
-
+
Custom
User-Deployed
@@ -327,28 +321,28 @@ export default function ArchitecturePage(): React.ReactElement {
User Infrastructure
- | Vercel |
- Railway |
- AWS Lambda |
- Self-hosted |
+ Vercel |
+ Railway |
+ AWS Lambda |
+ Self-hosted |
- ★
+ ★
Custom dependencies pre-installed
- ★
+ ★
Your own API keys built-in
- ★
+ ★
Custom security policies
- ★
+ ★
One-click deploy templates
@@ -362,7 +356,9 @@ export default function ArchitecturePage(): React.ReactElement {
-
POST /execute-tool
+
+ POST /execute-tool
+
packageName: string
name: string
@@ -371,7 +367,7 @@ export default function ArchitecturePage(): React.ReactElement {
-
Response
+
Response
success: boolean
output?: any
@@ -409,7 +405,7 @@ export default function ArchitecturePage(): React.ReactElement {
tools[]
- CollectionTool[]
+ CollectionTool[]
executorConfig
@@ -423,14 +419,14 @@ export default function ArchitecturePage(): React.ReactElement {
- | /api/mcp/{user}/{slug}/http |
+ /api/mcp/{user}/{slug}/http |
/api/collections/{id} |
- Tool-level env overrides |
+ Tool-level env overrides |
{/* Agents */}
-
+
Agent
@@ -453,7 +449,7 @@ export default function ArchitecturePage(): React.ReactElement {
collections[]
- Collection[]
+ Collection[]
model
@@ -463,9 +459,9 @@ export default function ArchitecturePage(): React.ReactElement {
- | /agents/{id}/chat |
- Streaming: SSE tool_call events |
- Persistent conversations |
+ /agents/{id}/chat |
+ Streaming: SSE tool_call events |
+ Persistent conversations |
@@ -484,13 +480,13 @@ export default function ArchitecturePage(): React.ReactElement {
↓
Collection Config
- executorConfig
+ executorConfig
→
↓
-
+
Agent Override
- agent.executorConfig
+ agent.executorConfig
@@ -513,24 +509,24 @@ export default function ArchitecturePage(): React.ReactElement {
| keyword: "tpmjs" |
tpmjs field |
- package.json |
+ package.json |
- Sync Jobs
+ Sync Jobs
- | Changes Feed (2min) |
+ Changes Feed (2min) |
Keyword Search (15min) |
- Metrics Sync (1hr) |
+ Metrics Sync (1hr) |
- Processing
+ Processing
| Validate tpmjs field |
- Extract inputSchema |
+ Extract inputSchema |
Calculate quality score |
@@ -542,7 +538,7 @@ export default function ArchitecturePage(): React.ReactElement {
| Tool (metadata) |
Package (npm info) |
- inputSchema (JSON) |
+ inputSchema (JSON) |
@@ -561,7 +557,7 @@ export default function ArchitecturePage(): React.ReactElement {
Package
- npmPackageName PK
+ npmPackageName PK
npmVersion
npmDownloadsLastMonth
@@ -571,22 +567,22 @@ export default function ArchitecturePage(): React.ReactElement {
{/* Tool */}
-
+
Tool
-
- id
PK
+
+ id PK
-
name
-
description
+
name
+
description
inputSchema JSON
-
category
+
category
qualityScore
healthStatus
- packageId FK
+ packageId FK
@@ -596,10 +592,10 @@ export default function ArchitecturePage(): React.ReactElement {
CollectionTool
- collectionId FK
+ collectionId FK
- toolId FK
+ toolId FK
displayName
@@ -634,25 +630,29 @@ export default function ArchitecturePage(): React.ReactElement {
-
Documentation
+
+ Documentation
+
Full SDK and API reference
-
Custom Executors
+
+ Custom Executors
+
Deploy your own execution environment
-
Agent Docs
+
Agent Docs
Build AI assistants with tools