Skip to content

armgit / Orkas

Public Imported from GitHub
0

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.

45.7 KB
Raw Blame
{
  "sdkVersion": 1,
  "manifest": {
    "file": "orkas-app.json",
    "schema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "type": "object",
      "properties": {
        "sdkVersion": {
          "type": "number",
          "const": 1
        },
        "minimumClient": {
          "type": "string",
          "const": "1.9.0"
        },
        "capabilities": {
          "maxItems": 7,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "storage",
              "appFiles",
              "files",
              "ai",
              "library",
              "connectors",
              "data"
            ]
          }
        },
        "data": {
          "type": "object",
          "properties": {
            "version": {
              "type": "number",
              "const": 1
            },
            "tables": {
              "maxItems": 32,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  },
                  "name": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  },
                  "fields": {
                    "maxItems": 128,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        },
                        "name": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        },
                        "type": {
                          "type": "string",
                          "enum": [
                            "string",
                            "number",
                            "integer",
                            "boolean",
                            "json",
                            "timestamp"
                          ]
                        },
                        "required": {
                          "type": "boolean"
                        },
                        "nullable": {
                          "type": "boolean"
                        },
                        "unique": {
                          "type": "boolean"
                        },
                        "default": {},
                        "references": {
                          "type": "object",
                          "properties": {
                            "table": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                            }
                          },
                          "required": [
                            "table"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "type"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "access": {
                    "type": "object",
                    "properties": {
                      "read": {
                        "default": [],
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        }
                      },
                      "insert": {
                        "default": [],
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        }
                      },
                      "count": {
                        "type": "boolean"
                      },
                      "maxCount": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 1000000
                      },
                      "aggregate": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                        }
                      },
                      "readFilters": {
                        "maxItems": 16,
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "field": {
                              "type": "string",
                              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                            },
                            "op": {
                              "type": "string",
                              "enum": [
                                "eq",
                                "ne",
                                "lt",
                                "lte",
                                "gt",
                                "gte"
                              ]
                            },
                            "value": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "number",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "boolean"
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "field",
                            "op",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "additionalProperties": false
                  },
                  "indexes": {
                    "maxItems": 16,
                    "type": "array",
                    "items": {
                      "minItems": 1,
                      "maxItems": 4,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                      }
                    }
                  }
                },
                "required": [
                  "id",
                  "name",
                  "fields",
                  "access"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "version",
            "tables"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "sdkVersion",
        "capabilities"
      ],
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "capabilities": {
                "contains": {
                  "const": "data"
                }
              }
            },
            "required": [
              "capabilities"
            ]
          },
          "then": {
            "required": [
              "data"
            ]
          }
        }
      ]
    },
    "starter": {
      "entry": "@skill/web-app-sdk/assets/starter/index.html",
      "manifest": "@skill/web-app-sdk/assets/starter/orkas-app.json"
    }
  },
  "dataDefinition": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "properties": {
      "version": {
        "type": "number",
        "const": 1
      },
      "tables": {
        "maxItems": 32,
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
            },
            "name": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
            },
            "fields": {
              "maxItems": 128,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  },
                  "name": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "string",
                      "number",
                      "integer",
                      "boolean",
                      "json",
                      "timestamp"
                    ]
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "nullable": {
                    "type": "boolean"
                  },
                  "unique": {
                    "type": "boolean"
                  },
                  "default": {},
                  "references": {
                    "type": "object",
                    "properties": {
                      "table": {
                        "type": "string",
                        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                      }
                    },
                    "required": [
                      "table"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "id",
                  "name",
                  "type"
                ],
                "additionalProperties": false
              }
            },
            "access": {
              "type": "object",
              "properties": {
                "read": {
                  "default": [],
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  }
                },
                "insert": {
                  "default": [],
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  }
                },
                "count": {
                  "type": "boolean"
                },
                "maxCount": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 1000000
                },
                "aggregate": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                  }
                },
                "readFilters": {
                  "maxItems": 16,
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "field": {
                        "type": "string",
                        "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                      },
                      "op": {
                        "type": "string",
                        "enum": [
                          "eq",
                          "ne",
                          "lt",
                          "lte",
                          "gt",
                          "gte"
                        ]
                      },
                      "value": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "number",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "boolean"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "required": [
                      "field",
                      "op",
                      "value"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "additionalProperties": false
            },
            "indexes": {
              "maxItems": 16,
              "type": "array",
              "items": {
                "minItems": 1,
                "maxItems": 4,
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                }
              }
            }
          },
          "required": [
            "id",
            "name",
            "fields",
            "access"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "version",
      "tables"
    ],
    "additionalProperties": false
  },
  "methods": [
    {
      "name": "data.query",
      "capability": "data",
      "description": "Read declared fields under readFilters; default limit 20, maximum 100, offset maximum 100000. Ordering adds id as a stable tie-breaker; include reads at most four declared one-hop relations.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "table": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "fields": {
            "maxItems": 130,
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
            }
          },
          "include": {
            "maxItems": 4,
            "type": "array",
            "items": {
              "type": "string",
              "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
            }
          },
          "filters": {
            "maxItems": 16,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "eq",
                    "ne",
                    "lt",
                    "lte",
                    "gt",
                    "gte"
                  ]
                },
                "value": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "field",
                "op",
                "value"
              ],
              "additionalProperties": false
            }
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100000
          },
          "order": {
            "type": "object",
            "properties": {
              "field": {
                "type": "string",
                "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
              },
              "direction": {
                "type": "string",
                "enum": [
                  "asc",
                  "desc"
                ]
              }
            },
            "required": [
              "field",
              "direction"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "table"
        ],
        "additionalProperties": false
      },
      "result": "{records:object[]}; include adds relations keyed by reference field.",
      "example": {
        "table": "messages",
        "fields": [
          "body"
        ],
        "limit": 20
      }
    },
    {
      "name": "data.count",
      "capability": "data",
      "description": "Count records under declared readFilters and caller filters; requires count permission.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "table": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "filters": {
            "maxItems": 16,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "eq",
                    "ne",
                    "lt",
                    "lte",
                    "gt",
                    "gte"
                  ]
                },
                "value": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "field",
                "op",
                "value"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "table"
        ],
        "additionalProperties": false
      },
      "result": "{count:number}",
      "example": {
        "table": "messages"
      }
    },
    {
      "name": "data.insert",
      "capability": "data",
      "description": "Insert declared fields, apply defaults and meter canonical UTF-8 bytes atomically. requestId deduplicates the latest 2048 insert requests across reopening.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "table": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "values": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          },
          "requestId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,64}$"
          }
        },
        "required": [
          "table",
          "values"
        ],
        "additionalProperties": false
      },
      "result": "{id:string}; generated record ID, never the private row.",
      "example": {
        "table": "messages",
        "values": {
          "body": "Hello"
        },
        "requestId": "message-1"
      }
    },
    {
      "name": "data.insertIf",
      "capability": "data",
      "description": "Atomically check whole-table count and insert. maxCount can only tighten the application declaration; full capacity returns E_CONDITION.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "table": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "values": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          },
          "requestId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,64}$"
          },
          "maxCount": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000000
          }
        },
        "required": [
          "table",
          "values",
          "maxCount"
        ],
        "additionalProperties": false
      },
      "result": "{id:string}; no partial insertion on failure.",
      "example": {
        "table": "messages",
        "values": {
          "body": "Hello"
        },
        "maxCount": 100,
        "requestId": "message-2"
      }
    },
    {
      "name": "data.aggregate",
      "capability": "data",
      "description": "Compute a declared aggregate under readFilters and caller filters; groupBy requires read permission. Up to 100 groups; larger results fail with E_LIMIT.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "table": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "field": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "op": {
            "type": "string",
            "enum": [
              "count",
              "sum",
              "min",
              "max",
              "avg"
            ]
          },
          "groupBy": {
            "type": "string",
            "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
          },
          "filters": {
            "maxItems": 16,
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "field": {
                  "type": "string",
                  "pattern": "^[A-Za-z][A-Za-z0-9_]{0,63}$"
                },
                "op": {
                  "type": "string",
                  "enum": [
                    "eq",
                    "ne",
                    "lt",
                    "lte",
                    "gt",
                    "gte"
                  ]
                },
                "value": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "field",
                "op",
                "value"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "table",
          "field",
          "op"
        ],
        "additionalProperties": false
      },
      "result": "{value:number|string|null} or {groups:[{key,value}]} when groupBy is supplied.",
      "example": {
        "table": "messages",
        "field": "score",
        "op": "sum"
      }
    },
    {
      "name": "capabilities.list",
      "capability": null,
      "description": "Discover supported methods, current availability and authorization requirements.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "result": "{sdkVersion, methods, unsupported}",
      "example": {}
    },
    {
      "name": "capabilities.describe",
      "capability": null,
      "description": "Read one method schema, result contract and example.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "method": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "method"
        ],
        "additionalProperties": false
      },
      "result": "Method documentation.",
      "example": {
        "method": "data.query"
      }
    },
    {
      "name": "host.getContext",
      "capability": null,
      "description": "Read the current application language and SDK version.",
      "appTypes": [
        "local",
        "web"
      ],
      "environments": [
        "desktop",
        "preview",
        "online"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "result": "{language, sdkVersion}",
      "example": {}
    },
    {
      "name": "permissions.revoke",
      "capability": null,
      "description": "Revoke this instance grants and cancel pending work. Reopening starts fresh.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "result": "{revoked:true}",
      "example": {}
    },
    {
      "name": "storage.get",
      "capability": "storage",
      "description": "Read app-private JSON; scope defaults to local for compatibility. cloud participates in account sync.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "minLength": 1
          },
          "scope": {
            "default": "local",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "required": [
          "key"
        ],
        "additionalProperties": false
      },
      "result": "{value}; null when missing.",
      "example": {
        "key": "draft"
      }
    },
    {
      "name": "storage.set",
      "capability": "storage",
      "description": "Atomically save an app-private JSON value; total store limit 200 MiB.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "minLength": 1
          },
          "scope": {
            "default": "local",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          },
          "value": {}
        },
        "required": [
          "key",
          "value"
        ],
        "additionalProperties": false
      },
      "result": "{saved:true}",
      "example": {
        "key": "draft",
        "value": "Hello"
      }
    },
    {
      "name": "storage.remove",
      "capability": "storage",
      "description": "Remove one app-private value.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "key": {
            "type": "string",
            "minLength": 1
          },
          "scope": {
            "default": "local",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "required": [
          "key"
        ],
        "additionalProperties": false
      },
      "result": "{removed:true}",
      "example": {
        "key": "draft"
      }
    },
    {
      "name": "storage.keys",
      "capability": "storage",
      "description": "List keys in the selected app store.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "scope": {
            "default": "local",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "additionalProperties": false
      },
      "result": "{keys:string[]}",
      "example": {}
    },
    {
      "name": "appFiles.list",
      "capability": "appFiles",
      "description": "List sandbox files recursively. cloud (default) syncs with the account; local is for caches.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "scope": {
            "default": "cloud",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "additionalProperties": false
      },
      "result": "{files:[{path,size}]}",
      "example": {
        "scope": "cloud"
      }
    },
    {
      "name": "appFiles.readText",
      "capability": "appFiles",
      "description": "Read a sandbox UTF-8 file up to 200 MiB; missing files return null.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "description": "Relative path. No atomic temporary filenames, hidden/traversal segments, backslashes, Windows reserved names, trailing dots/spaces, visibility, Thumbs.db or desktop.ini."
          },
          "scope": {
            "default": "cloud",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      },
      "result": "{text} or null.",
      "example": {
        "path": "notes/today.txt"
      }
    },
    {
      "name": "appFiles.readBase64",
      "capability": "appFiles",
      "description": "Read a sandbox binary file up to 200 MiB; missing files return null.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "description": "Relative path. No atomic temporary filenames, hidden/traversal segments, backslashes, Windows reserved names, trailing dots/spaces, visibility, Thumbs.db or desktop.ini."
          },
          "scope": {
            "default": "cloud",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      },
      "result": "{base64} or null.",
      "example": {
        "path": "images/icon.png"
      }
    },
    {
      "name": "appFiles.writeText",
      "capability": "appFiles",
      "description": "Atomically replace an app-owned UTF-8 file (200 MiB). Creates parent directories. Saved means local persistence, not completed upload.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "description": "Relative path. No atomic temporary filenames, hidden/traversal segments, backslashes, Windows reserved names, trailing dots/spaces, visibility, Thumbs.db or desktop.ini."
          },
          "scope": {
            "default": "cloud",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          },
          "text": {
            "type": "string",
            "maxLength": 209715200
          }
        },
        "required": [
          "path",
          "text"
        ],
        "additionalProperties": false
      },
      "result": "{saved:true}",
      "example": {
        "path": "notes/today.txt",
        "text": "Hello"
      }
    },
    {
      "name": "appFiles.writeBase64",
      "capability": "appFiles",
      "description": "Atomically replace an app-owned binary file (200 MiB). Requires canonical base64.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "description": "Relative path. No atomic temporary filenames, hidden/traversal segments, backslashes, Windows reserved names, trailing dots/spaces, visibility, Thumbs.db or desktop.ini."
          },
          "scope": {
            "default": "cloud",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          },
          "base64": {
            "type": "string",
            "maxLength": 279620268
          }
        },
        "required": [
          "path",
          "base64"
        ],
        "additionalProperties": false
      },
      "result": "{saved:true}",
      "example": {
        "path": "images/icon.bin",
        "base64": "AAE="
      }
    },
    {
      "name": "appFiles.remove",
      "capability": "appFiles",
      "description": "Remove one sandbox file; missing files are a successful no-op. Directories are not recursively deleted.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "description": "Relative path. No atomic temporary filenames, hidden/traversal segments, backslashes, Windows reserved names, trailing dots/spaces, visibility, Thumbs.db or desktop.ini."
          },
          "scope": {
            "default": "cloud",
            "type": "string",
            "enum": [
              "local",
              "cloud"
            ]
          }
        },
        "required": [
          "path"
        ],
        "additionalProperties": false
      },
      "result": "{removed:true}",
      "example": {
        "path": "notes/today.txt"
      }
    },
    {
      "name": "files.pick",
      "capability": "files",
      "description": "Choose a local file using the host dialog; grants read access only.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "result": "{handle,name,size} or null on cancellation.",
      "example": {}
    },
    {
      "name": "files.readText",
      "capability": "files",
      "description": "Read a selected UTF-8 file, at most 200 MiB.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "pattern": "^[a-f0-9]{32}$"
          }
        },
        "required": [
          "handle"
        ],
        "additionalProperties": false
      },
      "result": "{text}",
      "example": {
        "handle": "0123456789abcdef0123456789abcdef"
      }
    },
    {
      "name": "files.readBase64",
      "capability": "files",
      "description": "Read a selected file as base64, at most 200 MiB.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "pattern": "^[a-f0-9]{32}$"
          }
        },
        "required": [
          "handle"
        ],
        "additionalProperties": false
      },
      "result": "{base64}",
      "example": {
        "handle": "0123456789abcdef0123456789abcdef"
      }
    },
    {
      "name": "files.saveAs",
      "capability": "files",
      "description": "Export UTF-8 text using the host Save dialog. Create-only: choose a new destination; existing files are not overwritten.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[^/\\\\\\x00-\\x1f]+$"
          },
          "text": {
            "type": "string",
            "maxLength": 209715200
          }
        },
        "required": [
          "name",
          "text"
        ],
        "additionalProperties": false
      },
      "result": "{saved:true,name} or null on cancellation.",
      "example": {
        "name": "summary.txt",
        "text": "Summary"
      }
    },
    {
      "name": "files.release",
      "capability": "files",
      "description": "Release a file handle before closing the app.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "handle": {
            "type": "string",
            "pattern": "^[a-f0-9]{32}$"
          }
        },
        "required": [
          "handle"
        ],
        "additionalProperties": false
      },
      "result": "{released:true}",
      "example": {
        "handle": "0123456789abcdef0123456789abcdef"
      }
    },
    {
      "name": "ai.generate",
      "capability": "ai",
      "description": "Generate text with the configured model without tools, skills or conversation history. Optional progress receives text deltas. Uses the configured model without an extra application permission dialog.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "prompt": {
            "type": "string",
            "minLength": 1
          },
          "maxTokens": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "prompt"
        ],
        "additionalProperties": false
      },
      "result": "{text,usage,stopReason}; token-limited output has stopReason=max_tokens. Cancel with AbortSignal.",
      "example": {
        "prompt": "Write a short greeting.",
        "maxTokens": 128
      }
    },
    {
      "name": "tools.list",
      "capability": null,
      "description": "Discover eligible existing Orkas tools and their original schemas. Connector discovery supports BM25 query, bounded pages and full schemas for small catalogs through list_connector_tools. Does not grant execution.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "result": "{tools:[{name,capability,description,inputSchema}]}",
      "example": {}
    },
    {
      "name": "tools.call",
      "capability": null,
      "description": "Execute an eligible existing tool under its original operation permissions. Sensitive actions use host approval; Trusted mode skips confirmation. Unknown tools fail closed.",
      "appTypes": [
        "local"
      ],
      "environments": [
        "desktop",
        "preview"
      ],
      "status": "supported",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1
          },
          "arguments": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          }
        },
        "required": [
          "name",
          "arguments"
        ],
        "additionalProperties": false
      },
      "result": "{content,isError?}; inspect isError. Oversized results fail without replay.",
      "example": {
        "name": "library",
        "arguments": {
          "action": "list",
          "scope": "global",
          "limit": 10
        }
      }
    }
  ],
  "unsupported": [
    {
      "capability": "account.renewalReminders",
      "reason": "Host-only: account-wide reminder claims and billing navigation belong to the signed-in desktop account UI, not saved applications."
    },
    {
      "capability": "browser",
      "reason": "Host-only: task browser control, native file selection and site consent require a live conversation and its user-owned Chromium profile."
    },
    {
      "capability": "files.writeInPlace",
      "reason": "Deferred: needs shared revision/lock/indexer integration; export through files.saveAs."
    },
    {
      "capability": "projects",
      "reason": "Deferred: apps have no user-selected project binding; source conversation is not authority."
    },
    {
      "capability": "memory",
      "reason": "Deferred: needs a user-selected scope; Agent-private and global memories are not app state."
    },
    {
      "capability": "history",
      "reason": "Deferred: needs an explicit conversation grant and bounded history projection."
    },
    {
      "capability": "agents.tasks",
      "reason": "Deferred: needs a host-owned task lifetime, permissions and billing association."
    },
    {
      "capability": "skills",
      "reason": "Host-only: Skill script execution needs an explicitly scoped application sandbox and execution contract."
    },
    {
      "capability": "shell",
      "reason": "Host-only: arbitrary execution would escape the application capability boundary."
    },
    {
      "capability": "media.generate",
      "reason": "Deferred: owning studio plan, output and spending gates must be adapted first."
    }
  ]
}