# Noorle

## Docs

- [Configuration Reference](https://noorle.com/docs/build/configuration.md): Complete noorle.yaml reference for plugin metadata, runtime, network and filesystem permissions, env vars, and memory and timeout limits
- [Publishing and Versioning](https://noorle.com/docs/build/deployment/publishing-and-versioning.md): Publish WASM plugins to Noorle via CLI or Console, push .npack archives, manage active and archived versions, and roll back releases
- [Version Management](https://noorle.com/docs/build/deployment/version-management.md): Plugin version management with semantic versioning, integer version slots, rollback strategies, and major, minor, and patch release workflows
- [Build on Noorle](https://noorle.com/docs/build/introduction.md): Create plugins, extend the platform, and deploy custom capabilities.
- [Go](https://noorle.com/docs/build/languages/go.md): Build Noorle WASM plugins in Go with TinyGo, compile to WASI Preview 2, export typed tools, and handle structs and JSON serialization
- [JavaScript](https://noorle.com/docs/build/languages/javascript.md): Build Noorle plugins with JavaScript for quick prototyping and flexibility
- [Python](https://noorle.com/docs/build/languages/python.md): Build Noorle plugins with Python using componentize-py
- [Rust](https://noorle.com/docs/build/languages/rust.md): Build Noorle plugins with Rust using cargo-component
- [TypeScript](https://noorle.com/docs/build/languages/typescript.md): Build Noorle plugins with TypeScript using ComponentizeJS
- [Permissions and Security](https://noorle.com/docs/build/plugins/permissions-and-security.md): Sandbox security model and permission configuration
- [Plugin Architecture](https://noorle.com/docs/build/plugins/platform-overview.md): How Noorle plugins compile to WASI Preview 2 WebAssembly, run in a Wasmtime sandbox, and integrate via the Component Model and .npack format
- [Project Structure](https://noorle.com/docs/build/plugins/project-structure.md): Noorle plugin layout explained: noorle.yaml, world.wit, .env, src directories, Cargo.toml, and the compiled plugin.wasm output
- [When to Build a Plugin](https://noorle.com/docs/build/plugins/when-to-build.md): Decision guide for plugins vs connectors vs builtins
- [5-Minute Quickstart](https://noorle.com/docs/build/quickstart.md): Create, build, and deploy your first Noorle WASM plugin in 5 minutes using the noorle CLI, with Rust, Python, TypeScript, or Go
- [Architecture Overview](https://noorle.com/docs/learn/architecture.md): Understanding Noorle's layered architecture and host-based routing
- [API Keys](https://noorle.com/docs/learn/auth/api-keys.md): Long-lived credentials for server-to-server authentication
- [Connected Apps](https://noorle.com/docs/learn/auth/connected-apps.md): Connect third-party OAuth apps to your Noorle account with dynamic client registration, scoped permissions, JWT access tokens, and one-click revocation
- [JWT Tokens](https://noorle.com/docs/learn/auth/jwt-tokens.md): JWT bearer tokens for Noorle API authentication, including header, payload, and signature structure, expiration, refresh tokens, and 401 handling
- [OAuth Device Flow](https://noorle.com/docs/learn/auth/oauth-device-flow.md): OAuth 2.0 device flow (RFC 8628) for CLI tools and headless clients: request device codes, poll for tokens, and authorize without a browser redirect
- [Authentication Overview](https://noorle.com/docs/learn/auth/overview.md): Compare Noorle authentication methods including OAuth 2.1, API keys, JWT tokens, and device flow, with principal types and least-privilege guidance
- [Roles and Permissions](https://noorle.com/docs/learn/auth/roles-and-permissions.md): Noorle RBAC explained: Owner, Admin, Developer, and Member roles with resource-level and action-level permissions for agents, gateways, and API keys
- [Agents](https://noorle.com/docs/learn/concepts/agents.md): Autonomous AI systems with memory, tools, and reasoning
- [Automation Triggers](https://noorle.com/docs/learn/concepts/automation-triggers.md): Scheduled, event-based, and proactive automation for agents
- [Capabilities](https://noorle.com/docs/learn/concepts/capabilities.md): Built-in tools, custom plugins, and external connectors
- [Connectors](https://noorle.com/docs/learn/concepts/connectors.md): Connect Noorle agents to REST APIs, MCP registry servers, and custom MCP endpoints with OAuth, bearer tokens, and OpenAPI auto-discovery
- [Generative UI](https://noorle.com/docs/learn/concepts/generative-ui.md): Dynamic, interactive interfaces rendered by agents in real time
- [Knowledge Bases & RAG](https://noorle.com/docs/learn/concepts/knowledge-and-rag.md): Semantic search, embeddings, and grounded AI responses
- [MCP Gateways](https://noorle.com/docs/learn/concepts/mcp-gateways.md): MCP gateways expose your built-in tools, WASM plugins, and connectors to AI clients via a unique subdomain with isolated auth and rate limits
- [Memory System](https://noorle.com/docs/learn/concepts/memory-system.md): Three-tier conversation memory for efficient context management
- [Model Context Protocol (MCP)](https://noorle.com/docs/learn/concepts/model-context-protocol.md): Understanding MCP and why Noorle uses it for tool standardization
- [Tool Exposure](https://noorle.com/docs/learn/concepts/omni-tool.md): How Noorle agents and gateways expose tools to LLMs: AI-driven tool discovery that picks from 50+ capabilities and auto-maps natural language parameters
- [WebAssembly Plugins](https://noorle.com/docs/learn/concepts/webassembly.md): How Noorle runs WebAssembly plugins in a Wasmtime sandbox with WASI Preview 2, resource limits, and the .npack format for safe custom tools
- [Workflows](https://noorle.com/docs/learn/concepts/workflows.md): Durable graph-based workflows in Noorle that survive failures, support retries, approval gates, and conditional branching across agents and tools
- [Welcome to Noorle](https://noorle.com/docs/learn/introduction.md): A unified gateway for humans and AI to interact through MCP and A2A protocols
- [Quick Orientation](https://noorle.com/docs/learn/quickstart.md): A brief overview before diving into detailed concepts
- [Use Cases & Applications](https://noorle.com/docs/learn/use-cases.md): Real-world scenarios where Noorle enables powerful AI integrations
- [Agent Card](https://noorle.com/docs/reference/a2a/agent-card.md): Fetch the A2A agent-card.json to discover an agent's name, version, capabilities, supported LLM models, max tokens, and exposed skills
- [Send Message](https://noorle.com/docs/reference/a2a/message-send.md): POST /message/send - Send message and get complete response
- [Stream Message](https://noorle.com/docs/reference/a2a/message-stream.md): Stream agent responses token-by-token over Server-Sent Events using POST /message/stream with JSON-RPC 2.0, token, complete, and error events
- [A2A Protocol](https://noorle.com/docs/reference/a2a/overview.md): A2A protocol reference for Noorle agent gateways with JSON-RPC 2.0, WebSocket, and SSE transports, OAuth tokens, and message and task methods
- [Tasks](https://noorle.com/docs/reference/a2a/tasks.md): Track A2A agent task status with GET /tasks/{id}, monitor submitted, working, completed, failed, and canceled states, and cancel long-running operations
- [WebSocket](https://noorle.com/docs/reference/a2a/websocket.md): Connect to A2A agent gateways over WebSocket for persistent, low-latency bidirectional messaging with JSON-RPC 2.0 and token query authentication
- [Authentication](https://noorle.com/docs/reference/authentication.md): Authenticate Noorle REST, MCP, and A2A APIs with API keys via X-API-Key, JWT bearer tokens, or OAuth device flow, with curl examples for each
- [CLI Commands](https://noorle.com/docs/reference/cli/commands.md): Full noorle CLI command reference for plugin, agent, gateway, env, api-key, and token operations with flags and example invocations
- [CLI Installation](https://noorle.com/docs/reference/cli/installation.md): Install the noorle CLI on Linux and macOS via curl script or manual binary, verify with noorle --version, and enable Bash, Zsh, or Fish completion
- [CLI Overview](https://noorle.com/docs/reference/cli/overview.md): Tour of the noorle CLI for managing WASM plugins, agents, MCP gateways, and direct REST calls, with config file and environment variable setup
- [CLI Workflows](https://noorle.com/docs/reference/cli/workflows.md): Common noorle CLI workflows for plugin development, login and token management, agent creation, version rollback, and CI/CD pipeline scripting
- [Errors and Rate Limits](https://noorle.com/docs/reference/errors-and-rate-limits.md): Noorle API error reference with HTTP status codes, JSON-RPC 2.0 error format, 401 and 403 troubleshooting, and 429 rate limit handling
- [API Overview](https://noorle.com/docs/reference/introduction.md): Noorle's three APIs at a glance: REST at api.noorle.com for admin, MCP gateways for LLM tools, and A2A gateways for agent-to-agent messaging
- [MCP Protocol](https://noorle.com/docs/reference/mcp/overview.md): Noorle's MCP implementation for tool discovery, tool execution, resource access, and prompts over Streamable HTTP and stateless HTTP transports
- [Prompts](https://noorle.com/docs/reference/mcp/prompts.md): Use MCP prompts/list and prompts/get to fetch reusable agent system prompts and tool usage templates with parameterized arguments
- [Resources](https://noorle.com/docs/reference/mcp/resources.md): Read files and data through MCP resources/list and resources/read with file://, http://, and https:// URI schemes and MIME-typed content
- [SSE Transport](https://noorle.com/docs/reference/mcp/sse-endpoint.md): Connect to MCP gateways over Server-Sent Events for stateful sessions, streaming responses, and lower-latency JSON-RPC requests via /sse and /messages
- [tools/call](https://noorle.com/docs/reference/mcp/tools-call.md): Invoke MCP tools with the tools/call JSON-RPC method, pass arguments matching the inputSchema, and parse text, image, and multimodal content responses
- [tools/list](https://noorle.com/docs/reference/mcp/tools-list.md): Discover MCP tools with tools/list and inspect JSON Schema input definitions for plugin, built-in, and connector capabilities in your gateway
- [List Capabilities](https://noorle.com/docs/reference/rest/capabilities-list.md): GET /v1/capabilities - List available capabilities
- [Device Authorization](https://noorle.com/docs/reference/rest/oauth-device-authorize.md): Start OAuth device flow with POST /oauth/device/authorize, get a device_code, user_code, verification_uri, and polling interval for CLI authentication
- [Get Token](https://noorle.com/docs/reference/rest/oauth-token.md): Exchange device codes, refresh tokens, or client credentials at POST /oauth/token to receive a Noorle JWT bearer access token and refresh token
- [Upload Plugin](https://noorle.com/docs/reference/rest/plugins-upload.md): POST /v1/capabilities/upload - Upload a new plugin
- [Attaching Capabilities](https://noorle.com/docs/use/agents/attaching-capabilities.md): Add tools and capabilities to your agents. Manage built-in, connectors, and plugins.
- [Automation Triggers](https://noorle.com/docs/use/agents/automation-triggers.md): Configure scheduled, event-based, and proactive automations for agents.
- [Creating an Agent](https://noorle.com/docs/use/agents/creating-an-agent.md): Step-by-step guide to create your first AI agent in the Console.
- [Generative UI](https://noorle.com/docs/use/agents/generative-ui.md): Configure agents to render interactive UI components in responses.
- [Memory and Context](https://noorle.com/docs/use/agents/memory-and-context.md): Configure agent conversation memory. Working memory, summarization, and context management.
- [Agent Model Routing](https://noorle.com/docs/use/agents/model-routing.md): Choose how agents select AI models. Smart routing vs specific model selection.
- [Tool Exposure](https://noorle.com/docs/use/agents/omni-tool.md): Control how tools are presented to agents and MCP clients.
- [Agents Overview](https://noorle.com/docs/use/agents/overview.md): AI agents are autonomous assistants powered by LLMs. Compare to MCP gateways and understand when to use agents.
- [Sub-Agents and Delegation](https://noorle.com/docs/use/agents/sub-agents.md): Delegate tasks to other agents. Build multi-agent systems with handoffs.
- [System Prompts](https://noorle.com/docs/use/agents/system-prompts.md): Write effective system prompts that guide agent behavior, personality, and constraints.
- [Browser](https://noorle.com/docs/use/capabilities/browser.md): Convert web pages to screenshots and structured data.
- [Code Runner](https://noorle.com/docs/use/capabilities/code-runner.md): Execute Python and JavaScript code instantly. Sandboxed, secure environment for instant computations.
- [Computer](https://noorle.com/docs/use/capabilities/computer.md): Computer-use tools for full agent control. Screenshots, mouse, and keyboard automation. Agent-only capability.
- [Files](https://noorle.com/docs/use/capabilities/files.md): Read and write files in session storage. Scoped file operations for data persistence.
- [HTTP Client](https://noorle.com/docs/use/capabilities/http-client.md): Make HTTP requests to APIs and web services. Full authentication support and header control.
- [Knowledge Retrieval](https://noorle.com/docs/use/capabilities/knowledge-retrieval.md): RAG-powered document search with vector embeddings and semantic search.
- [Built-in Capabilities Overview](https://noorle.com/docs/use/capabilities/overview.md): Discover all 8 built-in capabilities available in Noorle Platform. Learn what each does and how to enable them.
- [Sandbox](https://noorle.com/docs/use/capabilities/sandbox.md): Full compute environment with package installation. Run complex workloads with npm, pip, and system tools.
- [Web Search](https://noorle.com/docs/use/capabilities/web-search.md): AI-optimized internet search with relevance scoring. Find current information across the web.
- [Channels Overview](https://noorle.com/docs/use/channels/overview.md): Deploy agents to messaging platforms. Telegram, Slack, and SMS integrations.
- [Slack Channel](https://noorle.com/docs/use/channels/slack.md): Deploy your agent as a Slack bot or app. DMs and channels supported.
- [SMS](https://noorle.com/docs/use/channels/sms.md): Deploy your agent as an SMS chatbot. Requires 10DLC registration.
- [Telegram Channel](https://noorle.com/docs/use/channels/telegram.md): Deploy your agent as a Telegram bot. Support groups and direct messages.
- [Connector Authentication](https://noorle.com/docs/use/connectors/authentication.md): Secure credential management for REST, MCP Registry, and Custom MCP connectors.
- [Custom MCP](https://noorle.com/docs/use/connectors/custom-mcp.md): Connect to your own MCP server for full control and custom implementations.
- [MCP Registry](https://noorle.com/docs/use/connectors/mcp-registry.md): Connect to pre-built MCP services from the registry.
- [OpenAPI Import](https://noorle.com/docs/use/connectors/openapi-import.md): Automatically generate REST connectors from OpenAPI specifications.
- [Connectors Overview](https://noorle.com/docs/use/connectors/overview.md): Connect to external APIs, MCP services, and custom servers. Manage authentication and expose them as tools.
- [Parameter Mapping](https://noorle.com/docs/use/connectors/parameter-mapping.md): Map input parameters to HTTP request locations. Path, query, header, and body mapping.
- [REST Connectors](https://noorle.com/docs/use/connectors/rest-connectors.md): Create custom REST API connectors by defining operations and parameter mappings.
- [Five-Minute Quickstart](https://noorle.com/docs/use/five-minute-quickstart.md): Get started with Noorle Platform in five minutes. Create your first MCP gateway, attach capabilities, and connect your MCP client.
- [Use Noorle](https://noorle.com/docs/use/introduction.md): Set up your platform, connect capabilities, and deploy agents — step by step.
- [Knowledge Base Overview](https://noorle.com/docs/use/knowledge/overview.md): Create and manage knowledge bases for RAG. Store documents and search with semantic understanding.
- [Result Reranking](https://noorle.com/docs/use/knowledge/reranking.md): LLM-based result reranking for improved relevance.
- [Uploading Documents](https://noorle.com/docs/use/knowledge/uploading-documents.md): Upload PDF, DOCX, Markdown, JSON, XLSX, and HTML files to Noorle knowledge bases with automatic chunking, vector embedding, and metadata tagging
- [Vector Search](https://noorle.com/docs/use/knowledge/vector-search.md): Semantic search using vector embeddings. How vector search works.
- [API Keys](https://noorle.com/docs/use/platform/api-keys.md): Generate and manage API keys for service account authentication. Understand API key format and security.
- [MCP Gateway](https://noorle.com/docs/use/platform/mcp-gateway.md): Create and manage MCP gateways to expose capabilities to MCP clients like Claude Desktop.
- [Model Routing](https://noorle.com/docs/use/platform/model-routing.md): Choose how AI models are selected for agent runs. Smart routing vs specific model selection with budget models.
- [Service Accounts](https://noorle.com/docs/use/platform/service-accounts.md): Create service accounts for programmatic access to Noorle Platform. Ideal for automation, integrations, and server-to-server communication.
- [Team Management](https://noorle.com/docs/use/platform/team-management.md): Invite team members, assign roles, and manage permissions for collaborative development.
- [Usage and Limits](https://noorle.com/docs/use/platform/usage-and-limits.md): Monitor token usage, track costs, understand rate limits and billing.
- [Human-in-the-Loop Workflows](https://noorle.com/docs/use/workflows/human-in-the-loop.md): Add human decision points to workflows with approval nodes.
- [Workflow Node Types](https://noorle.com/docs/use/workflows/node-types.md): Noorle workflow node types including Agent, HTTP, Approval, Webhook, Capability, sub-Workflow, Pause, and Data Transform with conditional routing
- [Workflows Overview](https://noorle.com/docs/use/workflows/overview.md): Graph-based durable workflows. Orchestrate multi-step processes with agents, approvals, and webhooks.
- [Workflow State Machine](https://noorle.com/docs/use/workflows/state-machine.md): Workflow execution states (Running, Success, Failed, Waiting, Paused, Suspended, Canceled), transition rules, and how to retry, extend, or cancel runs
- [Workflow Webhooks](https://noorle.com/docs/use/workflows/webhooks.md): Trigger workflows via webhooks and handle external data.

## OpenAPI Specs

- [openapi](https://noorle.com/docs/api-reference/openapi.json)

## Optional

- [Console](https://console.noorle.com)
- [Support](https://noorle.freshdesk.com/)