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)
-
+
Return result
@@ -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