{"server":"google-colab","version":"1.0.0","description":"Cloudflare Edge Worker & Google Colab GPU / Media RAG Toolchain","protocolVersion":"2024-11-05","endpoints":{"mcp":"https://colab-staging.suggestions.cc/mcp/colab","sse":"https://colab-staging.suggestions.cc/sse","messages":"https://colab-staging.suggestions.cc/mcp/messages","openapiActions":"https://colab-staging.suggestions.cc/openapi.json","openapiActionsYaml":"https://colab-staging.suggestions.cc/openapi.yaml","openapiFull":"https://colab-staging.suggestions.cc/openapi-full.json","openapiFullYaml":"https://colab-staging.suggestions.cc/openapi-full.yaml","actionsExecute":"https://colab-staging.suggestions.cc/api/actions/execute","actionsQuery":"https://colab-staging.suggestions.cc/api/actions/query","prompt":"https://colab-staging.suggestions.cc/prompt","llmsTxt":"https://colab-staging.suggestions.cc/llms.txt","privacy":"https://colab-staging.suggestions.cc/privacy","rootInfo":"https://colab-staging.suggestions.cc/root.json","connectors":"https://colab-staging.suggestions.cc/connectors"},"connectors":{"chatgpt":"https://colab-staging.suggestions.cc/connectors/chatgpt","spark":"https://colab-staging.suggestions.cc/connectors/spark","grok":"https://colab-staging.suggestions.cc/connectors/grok","generic":"https://colab-staging.suggestions.cc/connectors/generic"},"toolsCount":30,"tools":[{"name":"colab_media_rag_search","description":"[CTTB-01 Target] Execute GPU-accelerated semantic multimodal Media RAG search over Google Drive _ENTITIES media assets. Retrieves top matching images, diagrams, game cards, and character art with grounded citations.","parameters":["query","theme","topK","mode"],"required":["query"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_media_rag_search"},{"name":"colab_media_batch_embedder","description":"[CTTB-01 Target] Execute high-throughput GPU batch embedding pipeline on Colab (T4/L4). Stages media assets to /content/scratch SSD (CONV-01) to eliminate Drive FUSE latency, generates Multimodal/MRL embeddings, and atomically updates the Drive embedding registry.","parameters":["theme","batchSize","forceReindex","markReady","accelerator"],"required":["theme"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_media_batch_embedder"},{"name":"colab_notebook_custom_runner","description":"[CTTB-01 Target] Execute a whitelisted Jupyter Notebook stored in Google Drive (or bookmark alias like @colab:eval) on Colab GPU (T4/L4/A100) with isolated output staging in _프로젝트/colab-workspace/.","parameters":["targetAliasOrFileId","accelerator","parameters"],"required":["targetAliasOrFileId"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_notebook_custom_runner"},{"name":"colab_gallery_rag_bundler","description":"[CTTB-01 Target] Execute Colab GPU pipeline to generate and package a self-contained Web Gallery RAG ZIP bundle. Stages media assets to /content/scratch, generates web-optimized thumbnails (.webp), extracts rich search metadata (dimensions, dominant colors, tags, captions), computes semantic vector embeddings, and outputs a single high-speed distribution ZIP archive (manifest.json, items.jsonl, embeddings.bin, thumbnails/).","parameters":["theme","thumbnailSize","thumbnailQuality","generateColorPalette","accelerator"],"required":["theme"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_gallery_rag_bundler"},{"name":"colab_media_thumbnail_generator","description":"[CTTB-01 Target] High-throughput batch thumbnail generation and color palette extraction pipeline on Colab. Stages Drive media files to /content/scratch (CONV-01), resizes raw media into web-optimized WebP/AVIF thumbnails, extracts dominant color palettes and BlurHash metadata for instant skeleton UI rendering, and writes them back to Google Drive.","parameters":["theme","maxDimension","format","quality","extractPalette","generateBlurHash","outputMode","forceRegenerate","accelerator"],"required":["theme"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_media_thumbnail_generator"},{"name":"colab_semantic_atlas_advisor","description":"[CTTB-01 Target] Inspects Google Drive Semantic Atlas inventory, determines the exact storage directory and next canonical ID, and returns prompt engineering recipes and JSON envelope boilerplates for image generation models.","parameters":["theme","targetConcept","targetSpecId","proposedRole","userPrompt","mediaRoot"],"required":["theme"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_semantic_atlas_advisor"},{"name":"colab_media_vision_captioner","description":"[CTTB-01 Target] Automated GPU Multimodal Vision Captioner and Semantic Tagging pipeline on Colab. Stages raw images to /content/scratch (CONV-01), runs Gemini 1.5 Flash / BLIP2 vision models to extract visual summaries, aesthetic descriptions, and 301-domain taxonomy tags, and automatically scaffolds companion metadata JSON envelopes on Google Drive.","parameters":["theme","model","batchSize","taxonomyScope","outputMode","forceRecaption","accelerator"],"required":["theme"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_media_vision_captioner"},{"name":"colab_document_chunk_indexer","description":"[CTTB-01 Target] GPU Hierarchical Document Chunking & Embedding Indexer on Colab. Stages Google Docs, Markdown specs, and text nodes from Google Drive to /content/scratch SSD (CONV-01), applies hierarchical heading-aware AST chunking, generates 768D text embeddings via Gemini Embedding models, and atomically writes back consolidated JSONL/Parquet datasets to Google Drive.","parameters":["sourcePath","chunkSize","chunkOverlap","embeddingDim","bundleFormat","preserveHierarchy","accelerator"],"required":["sourcePath"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_document_chunk_indexer"},{"name":"colab_media_dataset_sanitizer","description":"[CTTB-01 Target] High-throughput Media Dataset Sanitizer and Integrity Auditor on Colab. Stages media files to /content/scratch SSD (CONV-01), computes hardware-accelerated SHA-256 digests, validates image headers against corrupt bytes, isolates defective items into _ENTITIES/quarantine/, and produces an actionable hygiene audit report.","parameters":["theme","action","verifySha256","maxScanned","quarantineDir","accelerator"],"required":["theme"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_media_dataset_sanitizer"},{"name":"colab_spec_governance_auditor","description":"[CTTB-01 Target] High-throughput Engineering Spec Governance Auditor, Semantic Diff, Atomic Promotion, and Sheets Control Plane Sync on Colab. Audits _ENTITIES/specs/, enforces NES v0.1 immutability and entity.json activeVersion pointers, computes Markdown AST & semantic diffs, atomically promotes new spec versions with SHA-256 integrity, and synchronizes spec lifecycle states to the Google Sheets [스펙_거버넌스] control plane.","parameters":["action","specId","fromVersion","toVersion","comment","author","accelerator"],"required":["action"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_spec_governance_auditor"},{"name":"colab_entity_graph_auditor","description":"[CTTB-01 Target] High-throughput in-memory metadata scanner & graph topology linter. Audits cross-entity missing links, broken markdown cross-references, media companion CAS integrity, and DAG cycles without small-file Drive FUSE overhead.","parameters":["action","outputDir","severityFilter"],"required":["action"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_entity_graph_auditor"},{"name":"colab_run_rag","description":"Execute high-throughput GPU-accelerated batch embedding or Multimodal Media RAG search on Google Drive assets. Utilizes CONV-01 Tier 0 Scratch staging (/content/scratch) to eliminate Drive FUSE latency and GPU starvation.","parameters":["query","theme","topK","accelerator","stageToScratch","mode"],"required":["query"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_run_rag"},{"name":"colab_execute","description":"Execute a Jupyter Notebook (.ipynb) stored on Google Drive (or local path) on Google Colab GPU (T4/L4/A100), stream results, and save outputs back to Google Drive.","parameters":["driveFileIdOrAlias","accelerator","parameters","saveLogs"],"required":["driveFileIdOrAlias"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_execute"},{"name":"colab_runtime_status","description":"Check availability, CLI binary status, authentication state, and supported hardware accelerators for Google Colab and Jupyter execution runtimes.","parameters":[],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_runtime_status"},{"name":"auth_status","description":"Check current Google OAuth2 / Service Account authentication status, active account email, token expiration, and granted scopes for Colab and Drive operations.","parameters":[],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/auth_status"},{"name":"colab_session_create","description":"Allocate and provision a new Google Colab GPU/CPU VM session in advance.","parameters":["sessionName","accelerator","highMem"],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_session_create"},{"name":"colab_session_stop","description":"Terminate an active Google Colab / Jupyter session to release VM and GPU resources and prevent quota consumption.","parameters":["sessionName"],"required":["sessionName"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_session_stop"},{"name":"colab_session_list","description":"List all active Google Colab / Jupyter sessions on the backend.","parameters":[],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_session_list"},{"name":"colab_pipeline_execute","description":"[CPLC-01 Pipeline] Execute any registered Colab Target pipeline through the deterministic 7-stage FSM (PROVISION -> RESOLVE -> STAGING -> INJECTION -> EXECUTE -> WRITE_BACK -> TEARDOWN) with real-time lifecycle tracking, cell progress, and runId issuance.","parameters":["targetId","arguments"],"required":["targetId"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_execute"},{"name":"colab_pipeline_status","description":"[CPLC-01 Pipeline] Query real-time execution status, current FSM stage, progress percentage, cell-level telemetry (cellIndex/totalCells), elapsed duration, and markdown timeline for a given runId.","parameters":["runId"],"required":["runId"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_status"},{"name":"colab_pipeline_cancel","description":"[CPLC-01 Pipeline] Cancel an active Colab pipeline run, trigger AbortSignal, mark status as CANCELLED, and safely purge temporary Scratch SSD staging resources.","parameters":["runId","reason"],"required":["runId"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_cancel"},{"name":"colab_pipeline_list","description":"[CPLC-01 Pipeline] List recent Colab pipeline execution runs with their FSM stages, status, and elapsed durations.","parameters":["status","targetId","limit"],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_list"},{"name":"colab_pipeline_history","description":"[SPEC-45 Observability] Query persistent 3-tier pipeline execution history with workflowId, status, and target filters.","parameters":["status","targetId","workflowId","limit"],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_history"},{"name":"colab_pipeline_get_events","description":"[SPEC-45 Observability] Retrieve sequential WAL events from events.jsonl for a specific run ID.","parameters":["runId","sinceSeq","limit"],"required":["runId"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_get_events"},{"name":"colab_pipeline_diff","description":"[SPEC-45 Observability] Compare two pipeline runs, computing parameter changes, stage latencies, and artifact diffs.","parameters":["runIdA","runIdB"],"required":["runIdA","runIdB"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_diff"},{"name":"colab_pipeline_resume","description":"[SPEC-45 Resumption] Resume an interrupted, stalled, or failed pipeline run from a specified stage checkpoint.","parameters":["runId","fromStage","overrideArgs"],"required":["runId"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_pipeline_resume"},{"name":"colab_script_list","description":"[CSST-01 Script Store] List all Colab notebooks (.ipynb) and scripts (.py) registered in _ENTITIES/notebooks and catalog.json, with category, hardware accelerator, parameter counts, and bookmarks.","parameters":["category","accelerator","format","query"],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_script_list"},{"name":"colab_script_get","description":"[CSST-01 Script Store] Retrieve full metadata, parameter schema, cell breakdown, and conformance report for a specific Colab notebook or Python script.","parameters":["nameOrAlias","includeContent"],"required":["nameOrAlias"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_script_get"},{"name":"colab_script_store","description":"[CSST-01 Script Store] Ingest, validate, sanitize, and persist a Colab notebook (.ipynb) or Python script (.py) into _ENTITIES/notebooks/, sync catalog.json, register @colab:* bookmark, and bind live MCP execution target.","parameters":["name","content","category","description","accelerator","bookmarkAlias","parametersSchema","force"],"required":["name","content"],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_script_store"},{"name":"colab_doctor","description":"[CDOC-01] Run comprehensive health diagnostic across Google Colab subsystem: Google Auth/ADC, Local Drive VFS, Colab CLI 0.7.4+, Cloudflare Edge Worker, and Python AI dependencies.","parameters":[],"required":[],"restEndpoint":"https://colab-staging.suggestions.cc/api/v1/tools/colab_doctor"}]}