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.
JavaScript agent-collaborationagent-harnessagent-orchestrationagent-teamagent-workflowai-assistantai-automationai-employeeai-productivityai-teamai-workflowautonomous-agentsclaude-code-guiclaude-coworkdesktop-agentlocal-firstmulti-agentmulti-agent-systemself-evolving-agentstask-automation
{
"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."
}
]
}