io.zzstoatzz.phi.getAbilities

phi.zzstoatzz.io

Documentation

Phi's currently-registered function tools, computed live from the running code rather than hand-maintained, so it cannot drift from what she can actually do. Every tool carries a risk declaration: a tool without one is not a valid tool, and the test suite refuses it. Served at /xrpc/io.zzstoatzz.phi.getAbilities; /api/abilities is kept as an alias.

main query

Phi's currently-registered function tools, computed live from the running code rather than hand-maintained, so it cannot drift from what she can actually do. Every tool carries a risk declaration: a tool without one is not a valid tool, and the test suite refuses it. Served at /xrpc/io.zzstoatzz.phi.getAbilities; /api/abilities is kept as an alias.

Output

Encodingapplication/json
abilities array Required

No description available.

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "abilities"
      ],
      "properties": {
        "abilities": {
          "type": "array",
          "items": {
            "ref": "#ability",
            "type": "ref"
          }
        }
      }
    },
    "encoding": "application/json"
  },
  "description": "Phi's currently-registered function tools, computed live from the running code rather than hand-maintained, so it cannot drift from what she can actually do. Every tool carries a risk declaration: a tool without one is not a valid tool, and the test suite refuses it. Served at /xrpc/io.zzstoatzz.phi.getAbilities; /api/abilities is kept as an alias."
}
ability object

One registered function tool.

Properties

description string Required

The tool's docstring — what the model is shown.

name string Required

The tool name the model calls.

operator_only boolean Required

Whether the tool is gated to the operator via the like-as-approval mechanism.

risk ref #risk Required

No description available.

View raw schema 
{
  "type": "object",
  "required": [
    "name",
    "description",
    "operator_only",
    "risk"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The tool name the model calls."
    },
    "risk": {
      "ref": "#risk",
      "type": "ref"
    },
    "description": {
      "type": "string",
      "description": "The tool's docstring — what the model is shown."
    },
    "operator_only": {
      "type": "boolean",
      "description": "Whether the tool is gated to the operator via the like-as-approval mechanism."
    }
  },
  "description": "One registered function tool."
}
risk object

What this tool can cost if it goes wrong. Required on every tool — the declaration is what makes a tool valid. Magnitude is ordered by reach and reversibility, not by how often the tool is used.

Properties

magnitude string Required

none: reads only, changes nothing. low: changes phi's own private state, reversible. moderate: publicly visible under her name, reversible by her. high: reaches other people's attention, spends real money, or cannot be undone with the tools she has.

Known values: none, low, moderate, high
reason string Required

One sentence saying what specifically could go wrong. Written to be read by a person in the cockpit and by the policy judge when it evaluates a proposed call, so it names the concrete failure rather than restating the magnitude.

maxLength: 400 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "magnitude",
    "reason"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "maxLength": 400,
      "description": "One sentence saying what specifically could go wrong. Written to be read by a person in the cockpit and by the policy judge when it evaluates a proposed call, so it names the concrete failure rather than restating the magnitude."
    },
    "magnitude": {
      "type": "string",
      "description": "none: reads only, changes nothing. low: changes phi's own private state, reversible. moderate: publicly visible under her name, reversible by her. high: reaches other people's attention, spends real money, or cannot be undone with the tools she has.",
      "knownValues": [
        "none",
        "low",
        "moderate",
        "high"
      ]
    }
  },
  "description": "What this tool can cost if it goes wrong. Required on every tool — the declaration is what makes a tool valid. Magnitude is ordered by reach and reversibility, not by how often the tool is used."
}

Lexicon Garden

@