inference.sh

{
  "type": "object",
  "required": [
    "app"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "App ref: namespace/name or namespace/name@version"
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "query": {
      "type": "string",
      "description": "Search by name or description"
    },
    "cursor": {
      "type": "string"
    },
    "category": {
      "enum": [
        "image",
        "video",
        "audio",
        "text",
        "chat",
        "3d",
        "other"
      ],
      "type": "string"
    }
  }
}

{
  "type": "object",
  "required": [
    "app",
    "input"
  ],
  "properties": {
    "app": {
      "type": "string",
      "description": "App ref: namespace/name or namespace/name@version"
    },
    "input": {
      "type": "object",
      "description": "App input matching the app's input schema"
    },
    "function": {
      "type": "string",
      "description": "Function name for multi-function apps"
    },
    "infrastructure": {
      "enum": [
        "cloud",
        "private",
        "private_first"
      ],
      "type": "string",
      "default": "cloud"
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id",
    "asset_id"
  ],
  "properties": {
    "asset_id": {
      "type": "string",
      "description": "Asset id, from artifact_asset_list"
    },
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id"
  ],
  "properties": {
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "The file's bytes, base64-encoded"
    },
    "filename": {
      "type": "string",
      "description": "What to call the file, e.g. chart.png"
    },
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    },
    "content_type": {
      "type": "string",
      "description": "MIME type; guessed from the filename when omitted"
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id"
  ],
  "properties": {
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id"
  ],
  "properties": {
    "version": {
      "type": "string",
      "description": "Optional version id or short id (default latest)"
    },
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    },
    "include_content": {
      "type": "boolean",
      "default": true
    }
  }
}

{
  "type": "object",
  "properties": {
    "topics": {
      "type": "array",
      "items": {
        "enum": [
          "design",
          "capabilities",
          "diagrams"
        ],
        "type": "string"
      },
      "description": "Which parts to include. \"design\" is always worth having; \"capabilities\" when the page takes input, remembers anything or knows its viewer; \"diagrams\" when it has a flow or chart. Omit for all three."
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50
    },
    "cursor": {
      "type": "string"
    },
    "search": {
      "type": "string",
      "description": "Search over title and description"
    }
  }
}

{
  "type": "object",
  "required": [
    "content",
    "title"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Optional URL slug; derived from title when omitted"
    },
    "type": {
      "enum": [
        "html",
        "markdown"
      ],
      "type": "string",
      "default": "html"
    },
    "image": {
      "type": "string",
      "description": "URL of a cover image for the gallery card and viewer header"
    },
    "label": {
      "type": "string",
      "description": "Optional label for this version"
    },
    "title": {
      "type": "string",
      "description": "Short distinctive name for the page (2-4 words)"
    },
    "content": {
      "type": "string",
      "description": "Page source: HTML content (or full document) or Markdown. Self-contained."
    },
    "favicon": {
      "type": "string",
      "description": "One or two emoji used as the tab icon"
    },
    "visibility": {
      "enum": [
        "private",
        "team",
        "org",
        "unlisted",
        "public"
      ],
      "type": "string",
      "description": "Who can open the page (default private). Only widen when asked."
    },
    "artifact_id": {
      "type": "string",
      "description": "Existing artifact id/ref to update in place"
    },
    "description": {
      "type": "string",
      "description": "One sentence shown under the title"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "enum": [
          "db",
          "user",
          "assets"
        ],
        "type": "string"
      },
      "description": "Runtime capabilities the page may use. \"db\" gives it a small store so it remembers what people do on it; \"user\" tells it who is viewing; \"assets\" lets it show images, video, fonts or PDFs stored beside it rather than inlined. A page gets only what it declares, and reaches them through window.inferencesh."
    },
    "content_encoding": {
      "enum": [
        "base64"
      ],
      "type": "string",
      "description": "Set to \"base64\" and base64-encode content. Required in practice: the edge firewall rejects request bodies containing raw HTML tags such as <script>."
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id",
    "text",
    "thread_id"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "The reply. Plain text, a sentence or two."
    },
    "thread_id": {
      "type": "string",
      "description": "Id of the thread to reply into, from artifact_comments"
    },
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    }
  }
}

{
  "type": "object",
  "required": [
    "artifact_id",
    "thread_id"
  ],
  "properties": {
    "thread_id": {
      "type": "string",
      "description": "Id of the thread to resolve, from artifact_comments"
    },
    "artifact_id": {
      "type": "string",
      "description": "Artifact id, short id, or namespace/name ref"
    }
  }
}

{
  "type": "object",
  "required": [
    "content",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Entry name"
    },
    "type": {
      "enum": [
        "concept",
        "observation",
        "preference",
        "reference",
        "person",
        "project"
      ],
      "type": "string",
      "default": "observation"
    },
    "content": {
      "type": "string",
      "description": "Entry content (markdown)"
    },
    "description": {
      "type": "string",
      "description": "Short description"
    }
  }
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Entry ID"
    }
  }
}

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Entry ref: namespace/name or ID"
    }
  }
}

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "skill",
        "concept",
        "observation",
        "preference",
        "reference",
        "person",
        "project"
      ],
      "type": "string",
      "description": "Filter by knowledge type"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "skill",
        "concept",
        "observation",
        "preference",
        "reference",
        "person",
        "project"
      ],
      "type": "string",
      "description": "Filter by type"
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "cursor": {
      "type": "string"
    }
  }
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Server slug"
    }
  }
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Server slug"
    }
  }
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Server slug"
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    },
    "category": {
      "enum": [
        "developer",
        "productivity",
        "data",
        "communication",
        "ai"
      ],
      "type": "string",
      "description": "Filter by category"
    },
    "featured": {
      "type": "boolean",
      "description": "Show only featured servers"
    }
  }
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "slug/tool format (e.g. 'linear/list_issues')"
    },
    "input": {
      "type": "object",
      "description": "Tool input arguments"
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "cursor": {
      "type": "string"
    }
  }
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "Server slug (e.g. 'linear') or slug/tool (e.g. 'linear/list_issues')"
    }
  }
}

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Skill ref: namespace/name"
    }
  }
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "cursor": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "description": "Filter by category"
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "description": "Filter by category"
    },
    "featured": {
      "type": "boolean",
      "description": "Show only featured skills"
    }
  }
}

{
  "type": "object",
  "required": [
    "content",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Skill name"
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "content",
          "path"
        ],
        "properties": {
          "path": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "description": "Supporting files (references, scripts)"
    },
    "content": {
      "type": "string",
      "description": "SKILL.md body content (markdown)"
    },
    "description": {
      "type": "string",
      "description": "Short description"
    },
    "allowed_tools": {
      "type": "string",
      "description": "Comma-separated list of allowed tools"
    }
  }
}

{
  "type": "object",
  "required": [
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Skill ref: namespace/name, or github.com/user/repo URL"
    }
  }
}

{
  "type": "object",
  "required": [
    "path",
    "ref"
  ],
  "properties": {
    "ref": {
      "type": "string",
      "description": "Skill ref: namespace/name"
    },
    "path": {
      "type": "string",
      "description": "File path within the skill"
    }
  }
}

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force kill immediately instead of graceful shutdown"
    },
    "task_id": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    },
    "status": {
      "enum": [
        "received",
        "queued",
        "running",
        "completed",
        "failed",
        "cancelled"
      ],
      "type": "string"
    }
  }
}

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task ID"
    },
    "log_type": {
      "enum": [
        "build",
        "run",
        "setup",
        "serve",
        "task"
      ],
      "type": "string",
      "default": "run"
    }
  }
}