world:pick-model

world family

Return the best proven model for a task shape — every `model` is an OpenRouter id from the registry (chat/model-intel.json ∪ model-speed.json), except reason `lane`, which names a claude-code:<seat> the local lane runs

Effect: ask; Awaits an outcome — the call returns the response below.
Caller: none; The class of authority the caller must already hold, decided from the attested context with no round trip.
Reversible: yes; The effect can be undone by a later call.

Send it with your agent

One click hands your coding agent a prompt that registers the substrate, reads this contract, and makes the call. Launch opens the app; the others copy the prompt.

Claude Code

Codex

Cursor

Gemini CLI

Claude Desktop

ChatGPT

curl -X POST https://one.ie/api/ask/world:pick-model \
  -H "Authorization: Bearer $ONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": { "shape": <string> }}'

The key is never in a link. npx -y @oneie/cli login writes it to ~/.config/oneie/key on your machine.

Request

Validated before dispatch — an invalid payload is refused with the fix, never half-applied.

shape string required
kit string optional The kit (routing/teams.json). Present → the pick is one of the kit's BUILD seats and an unknown kit is refused as unknown-kit, never dropped
rung trivial | contained | shaped | irreversible optional The row's risk rung (text/work-categories.md). irreversible → frontier tier only; a rung above the kit's rungMax is refused as rung-outside-kit

Response

What comes back from the call.

ok boolean
model string
effort string
reason warmed | cold | toxic-escalate | …
error string
kit string
seats object | null
ranking cost-per-pass | pass-rate
prices string
costPerPass number
weights object[]

Traffic

Every call to world:pick-model, counted where it is dispatched — over HTTP or in-process alike. Aggregate only — no actor, no payload, no workspace.

Counting…

Wiring

Every place in the open source that names world:pick-model, and the file that answers it. Read from the tree at build time — a receiver is reached by NAME through one door, so there is no import edge to follow and a grep is the honest shape of the question. Structure, not volume — the count is in Traffic above.

Called from

API route 1

one.ie/web/src/lib/receiver-index.generated.ts:397

Workflow 1

one.ie/web/src/lib/factory/card-flow.ts:70

→

Answered by

world:pick-model one.ie/web/src/lib/resolvers/router.ts:405 Dispatched through POST /api/ask/world:pick-model, after the envelope validates the payload.

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "shape": {
      "type": "string",
      "minLength": 1
    },
    "kit": {
      "description": "The kit (routing/teams.json). Present → the pick is one of the kit's BUILD seats and an unknown kit is refused as unknown-kit, never dropped",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "rung": {
      "description": "The row's risk rung (text/work-categories.md). irreversible → frontier tier only; a rung above the kit's rungMax is refused as rung-outside-kit",
      "type": "string",
      "enum": [
        "trivial",
        "contained",
        "shaped",
        "irreversible"
      ]
    }
  },
  "required": [
    "shape"
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "model": {
      "type": "string"
    },
    "effort": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "enum": [
        "warmed",
        "cold",
        "toxic-escalate",
        "fallback-unreachable",
        "rung-apex",
        "lane",
        "unknown-kit",
        "rung-outside-kit"
      ]
    },
    "error": {
      "type": "string"
    },
    "kit": {
      "type": "string"
    },
    "seats": {
      "anyOf": [
        {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "ranking": {
      "type": "string",
      "enum": [
        "cost-per-pass",
        "pass-rate"
      ]
    },
    "prices": {
      "type": "string"
    },
    "costPerPass": {
      "type": "number"
    },
    "weights": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "model": {
            "type": "string"
          },
          "strength": {
            "type": "number"
          },
          "resistance": {
            "type": "number"
          }
        },
        "required": [
          "model",
          "strength",
          "resistance"
        ]
      }
    }
  },
  "required": [
    "ok"
  ]
}