Bioregional Knowledge Commons

{
  "schema_version": "0.1",
  "name": "Bioregional Knowledge Commons",
  "description": "Federated bioregional knowledge graph with commons governance membrane. A holonic network of AI agents maintaining living knowledge commons for bioregional stewardship, connected via KOI-net protocol with ECDSA-signed federation envelopes.",
  "url": "https://45.132.245.30.sslip.io/commons/api/nodes/octo-salish-sea",
  "version": "1.0.0",
  "provider": {
    "name": "Bioregional Knowledge Commons",
    "url": "https://45.132.245.30.sslip.io"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "authentication": {
    "schemes": [
      "None",
      "Bearer"
    ],
    "notes": "Read-only tools require no auth. ingest_url requires x-ingest-token header. vault_write_note requires x-ingest-token header."
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "resolve_entity",
      "name": "resolve_entity",
      "description": "Resolve an entity name to its canonical form in the knowledge graph. Returns the best match with type, URI, and confidence.",
      "tags": [
        "knowledge-graph",
        "entity-resolution"
      ]
    },
    {
      "id": "get_entity_neighborhood",
      "name": "get_entity_neighborhood",
      "description": "Get the neighborhood of an entity \u2014 its relationships, affiliated organizations, projects, and connected people.",
      "tags": [
        "knowledge-graph",
        "relationships"
      ]
    },
    {
      "id": "get_entity_documents",
      "name": "get_entity_documents",
      "description": "Find all documents that mention a specific entity.",
      "tags": [
        "knowledge-graph",
        "documents"
      ]
    },
    {
      "id": "koi_search",
      "name": "koi_search",
      "description": "Search the bioregional knowledge graph using semantic similarity. Returns entities and documents matching the query.",
      "tags": [
        "knowledge-graph",
        "search",
        "semantic"
      ]
    },
    {
      "id": "knowledge_search",
      "name": "knowledge_search",
      "description": "Search indexed documents using semantic similarity (RAG). Searches over koi_memories \u2014 GitHub code files, docs, markdown \u2014 using OpenAI embeddings.",
      "tags": [
        "rag",
        "search",
        "semantic"
      ]
    },
    {
      "id": "preview_url",
      "name": "preview_url",
      "description": "Fetch and preview a URL. Returns title, content summary, detected entities, and safety check. Does NOT ingest.",
      "tags": [
        "web",
        "preview",
        "curation"
      ]
    },
    {
      "id": "process_url",
      "name": "process_url",
      "description": "Extract entities and relationships from a previewed URL using server-side LLM. Call AFTER preview_url and BEFORE ingest_url.",
      "tags": [
        "web",
        "extraction",
        "llm"
      ]
    },
    {
      "id": "ingest_url",
      "name": "ingest_url",
      "description": "Ingest a previously previewed URL into the knowledge graph. Requires x-ingest-token header.",
      "tags": [
        "web",
        "ingest",
        "knowledge-graph"
      ],
      "requiresAuth": true
    },
    {
      "id": "github_scan",
      "name": "github_scan",
      "description": "Trigger a GitHub repository scan or check sensor status. Indexes codebases via tree-sitter extraction.",
      "tags": [
        "github",
        "code",
        "indexing"
      ]
    },
    {
      "id": "monitor_url",
      "name": "monitor_url",
      "description": "Manage web source monitoring. Add URLs to be periodically checked for content changes, triggering re-extraction.",
      "tags": [
        "web",
        "monitoring",
        "curation"
      ]
    },
    {
      "id": "code_query",
      "name": "code_query",
      "description": "Query the code knowledge graph using Cypher. Graph contains Functions, Classes, Modules, Files with CALLS, CONTAINS, BELONGS_TO relationships.",
      "tags": [
        "code",
        "graph",
        "cypher"
      ]
    },
    {
      "id": "vault_read_note",
      "name": "vault_read_note",
      "description": "Read a structured entity note from the bioregional knowledge vault. Folders: People, Organizations, Projects, Concepts, Bioregions.",
      "tags": [
        "vault",
        "notes",
        "knowledge"
      ]
    },
    {
      "id": "vault_write_note",
      "name": "vault_write_note",
      "description": "Create or update an entity note in the bioregional knowledge vault. Requires x-ingest-token header.",
      "tags": [
        "vault",
        "notes",
        "knowledge"
      ],
      "requiresAuth": true
    },
    {
      "id": "vault_list_notes",
      "name": "vault_list_notes",
      "description": "List entity notes in a vault folder. Folders: People, Organizations, Projects, Concepts, Bioregions.",
      "tags": [
        "vault",
        "notes",
        "knowledge"
      ]
    },
    {
      "id": "federation_status",
      "name": "federation_status",
      "description": "Get KOI-net federation status: node identity, connected peers, event queue size, and protocol policy.",
      "tags": [
        "federation",
        "koi-net",
        "health"
      ]
    }
  ]
}