diff --git a/src/public/.well-known/agent-skills/index.json b/src/public/.well-known/agent-skills/index.json index 441dc44..7354f0a 100644 --- a/src/public/.well-known/agent-skills/index.json +++ b/src/public/.well-known/agent-skills/index.json @@ -1,4 +1,5 @@ { + "$schema": "https://agentskills.io/schema/v0.2.0/index.json", "version": "0.2.0", "skills": [ { diff --git a/src/public/.well-known/ai-catalog.json b/src/public/.well-known/ai-catalog.json index 21e4606..6b25ca0 100644 --- a/src/public/.well-known/ai-catalog.json +++ b/src/public/.well-known/ai-catalog.json @@ -1,5 +1,6 @@ { "$schema": "https://schema.agentcatalog.org/v1/ai-catalog.json", + "specVersion": "1.0.0", "name": "DevDeskApp Docs Catalog", "description": "Official documentation, n8n community node guide, and automation blueprint catalog for DevDeskApp.", "url": "https://docs.devdeskapp.com", @@ -8,6 +9,72 @@ "name": "DevDesk App", "url": "https://www.devdeskapp.com" }, + "host": { + "name": "docs.devdeskapp.com", + "url": "https://docs.devdeskapp.com" + }, + "entries": [ + { + "id": "urn:air:docs.devdeskapp.com:doc:n8n-nodes-devdeskapp", + "displayName": "DevDeskApp n8n Community Node Guide", + "type": "text/html", + "url": "https://docs.devdeskapp.com/n8n/", + "description": "In-memory, sub-millisecond deterministic utility node for n8n workflows with zero data leaks.", + "representativeQueries": [ + "how to install devdeskapp n8n node", + "devdeskapp operations reference", + "n8n client-side developer utilities" + ] + }, + { + "id": "urn:air:docs.devdeskapp.com:doc:ai-agents", + "displayName": "AI Agent Function Calling Integration", + "type": "text/html", + "url": "https://docs.devdeskapp.com/solutions/ai-agents", + "description": "Connect DevDeskApp utilities as zero-latency deterministic tools for OpenAI, Claude, Gemini, and Ollama agents in n8n.", + "representativeQueries": [ + "n8n ai agent tools", + "langchain local utility node", + "ai agent deterministic math and hashing" + ] + }, + { + "id": "urn:air:docs.devdeskapp.com:template:ctc-salary-engine", + "displayName": "CTC Salary Engine Workflow Blueprint (#21130)", + "type": "text/html", + "url": "https://docs.devdeskapp.com/templates/ctc-salary-engine", + "description": "Automated Indian statutory payroll engine computing gross, basic, HRA, EPF, and take-home net salary in n8n.", + "representativeQueries": [ + "n8n ctc salary calculator workflow", + "calculate in-hand salary in n8n", + "indian payroll template 21130" + ] + }, + { + "id": "urn:air:docs.devdeskapp.com:template:developer-suite", + "displayName": "Developer Suite Workflow Blueprint (#21017)", + "type": "text/html", + "url": "https://docs.devdeskapp.com/templates/developer-suite", + "description": "Automate JSON formatting, UUIDv4 generation, SHA256 checksums, and URL slugs inside n8n without cloud leaks.", + "representativeQueries": [ + "n8n json formatter workflow", + "secure payload hashing in n8n", + "n8n developer suite template 21017" + ] + }, + { + "id": "urn:air:docs.devdeskapp.com:doc:zero-leak-architecture", + "displayName": "DevDeskApp Zero-Leak Security Architecture", + "type": "text/html", + "url": "https://docs.devdeskapp.com/about/architecture", + "description": "In-memory sandboxing and privacy guarantee explaining how payloads execute strictly on host CPU cycles.", + "representativeQueries": [ + "devdeskapp zero leak privacy architecture", + "in-memory n8n security", + "local developer tools security" + ] + } + ], "services": [ { "id": "n8n-nodes-devdeskapp", diff --git a/src/public/.well-known/http-message-signatures-directory b/src/public/.well-known/http-message-signatures-directory new file mode 100644 index 0000000..5aeca02 --- /dev/null +++ b/src/public/.well-known/http-message-signatures-directory @@ -0,0 +1,5 @@ +{ + "directory": { + "keys": [] + } +} diff --git a/src/public/.well-known/oauth-authorization-server b/src/public/.well-known/oauth-authorization-server new file mode 100644 index 0000000..9fe6cb0 --- /dev/null +++ b/src/public/.well-known/oauth-authorization-server @@ -0,0 +1,13 @@ +{ + "issuer": "https://docs.devdeskapp.com", + "authorization_endpoint": "https://docs.devdeskapp.com/auth.md", + "token_endpoint": "https://docs.devdeskapp.com/auth.md", + "response_types_supported": ["none"], + "grant_types_supported": ["implicit"], + "service_documentation": "https://docs.devdeskapp.com/auth.md", + "agent_auth": { + "register_uri": "https://docs.devdeskapp.com/auth.md", + "supported_identity_types": ["anonymous"], + "supported_credential_types": ["none"] + } +} diff --git a/src/public/.well-known/oauth-protected-resource b/src/public/.well-known/oauth-protected-resource new file mode 100644 index 0000000..24ee48c --- /dev/null +++ b/src/public/.well-known/oauth-protected-resource @@ -0,0 +1,7 @@ +{ + "resource": "https://docs.devdeskapp.com", + "authorization_servers": ["https://docs.devdeskapp.com"], + "scopes_supported": ["public"], + "bearer_methods_supported": [], + "resource_documentation": "https://docs.devdeskapp.com/auth.md" +} diff --git a/src/public/.well-known/openid-configuration b/src/public/.well-known/openid-configuration new file mode 100644 index 0000000..767ad6c --- /dev/null +++ b/src/public/.well-known/openid-configuration @@ -0,0 +1,9 @@ +{ + "issuer": "https://docs.devdeskapp.com", + "authorization_endpoint": "https://docs.devdeskapp.com/auth.md", + "token_endpoint": "https://docs.devdeskapp.com/auth.md", + "jwks_uri": "https://docs.devdeskapp.com/.well-known/http-message-signatures-directory", + "response_types_supported": ["none"], + "subject_types_supported": ["public"], + "id_token_signing_alg_values_supported": ["none"] +} diff --git a/src/public/auth.md b/src/public/auth.md index f35d6ea..661a49c 100644 --- a/src/public/auth.md +++ b/src/public/auth.md @@ -1,4 +1,4 @@ -# Authentication & Agent Access Policy +# auth.md - Agent Access & Registration Policy **DevDeskApp Documentation (docs.devdeskapp.com)** provides public documentation for DevDeskApp developer utilities and the `n8n-nodes-devdeskapp` community node. @@ -6,3 +6,8 @@ - **Zero Auth**: All documentation pages, architecture guides, code examples, and template blueprints are 100% free and open access. No API keys, accounts, or bearer tokens are required. - **Privacy First**: Payloads and data processed via DevDeskApp execute purely in-memory on the local host with zero external transmission. - **Agent Friendly**: Autonomous AI agents, web crawlers, and LLM-assisted tools are explicitly permitted to read, parse, and cite all documentation pages under standard fair-use guidelines. + +## Agent Registration +- Autonomous AI agents do not need to register credentials or negotiate tokens. +- For discovery endpoints, agents can query `/.well-known/ai-catalog.json`, `/.well-known/mcp/server-card.json`, and `/.well-known/agent-skills/index.json`. +- Rate Limit Policy: Politeness interval of 100ms between batch requests.