tools.yaml

#
# task-loop tool catalog — v0 seed
#
# Same registry shape as mcp-server: each tool declares name, description,
# tags, side_effect, and an optional full schema (only injected into a prompt
# when its tags match a task's tags).
#
# v0 seed pulls in what already exists locally: mcp-server registry tools
# (log / notify / commands) and vital-pulse health-data readers.
#
# Servers: named tool servers tools route to. `mcp` is the local mcp-server
# over plain HTTP/JSON (openapi); `vital` is the health-data server over the
# MCP Streamable HTTP protocol.
#
# Secrets and hostnames are NOT hardcoded here — every value supports
# ${VAR:-default} substitution (shell/docker-compose semantics):
#   ${VAR}           -> the env var's value, or "" if unset
#   ${VAR:-default}  -> the env var's value, or `default` if unset/empty
#
# On bare metal: TASKLOOP_* comes from a local `.env` (copied from
# .env.example). In Docker: TASKLOOP_ENV=production skips `.env` entirely and
# real environment variables are used (see docker-compose.yml example in README).
#
servers:
  mcp:
    url: ${TASKLOOP_MCP_URL:-http://localhost:8627}
    api_key: ${TASKLOOP_MCP_API_KEY:-}
    protocol: openapi
  vital:
    url: ${TASKLOOP_VITAL_URL:-http://localhost:9000}
    api_key: ${TASKLOOP_VITAL_API_KEY:-}
    protocol: mcp
    # Server-level `tags:` is the inherited default for every tool discovered
    # from this server via tools/list. Per-tool `tags:` in the tools: list
    # wins. Leave it off and the boot warning flags untagged endpoints.
    tags: [health, vital]

tools:
  - name: log.info
    description: Append a line to the local task-loop log
    tags: [core, logging]
    side_effect: true
    server:
      name: mcp
    schema:
      type: object
      properties:
        message:
          type: string
          description: The line to log
      required: [message]

  - name: notify
    description: Send a notification to the user (desktop/app)
    tags: [core, notify]
    side_effect: true
    server:
      name: mcp
    schema:
      type: object
      properties:
        message:
          type: string
          description: The notification text
      required: [message]

  - name: command.run
    description: Run a shell command on the local machine
    tags: [sys, commands]
    side_effect: true
    server:
      name: mcp
    schema:
      type: object
      properties:
        cmd:
          type: string
          description: The shell command to run
      required: [cmd]

  - name: health.pull_steps
    description: Pull today's step count from the health tracker
    tags: [health, vital]
    side_effect: false
    returns: A number with the step count (e.g. "10000"). Report the number
      exactly, no conversion.
    server:
      name: vital
    schema:
      type: object
      properties: {}

  - name: health.pull_hrv
    description: Pull today's heart-rate variability reading
    tags: [health, vital]
    side_effect: false
    server:
      name: vital
    schema:
      type: object
      properties: {}

  - name: health.pull_sleep
    description: Pull last night's sleep summary
    tags: [health, vital]
    side_effect: false
    server:
      name: vital
    schema:
      type: object
      properties: {}

  - name: weather
    description: Get current weather and days of forecast for the configured location
    tags: [weather, daily]
    side_effect: false
    returns: A JSON object with current conditions (temperature, condition, day/date)
      and daily forecast entries for the requested number of days. Read values
      literally from the JSON; do not invent conditions or times.
    server:
      name: mcp
      method: GET
      base_path: weather
    schema:
      type: object
      properties:
        days:
          type: integer
          minimum: 1
          maximum: 7
          default: 1
          description: Days to forecast

  - name: log
    description: Append a timestamped message to the MCP log file
    tags: [core, logging]
    side_effect: true
    server:
      name: mcp
    schema:
      type: object
      properties:
        level:
          type: string
          enum: [info, warn, error]
          default: info
          description: Log level
        message:
          type: string
          description: Message to log
      required: [message]

  - name: log_read
    description: Read the last N lines from the MCP log file
    tags: [core, logging]
    side_effect: false
    server:
      name: mcp
    schema:
      type: object
      properties:
        lines:
          type: string
          default: "50"
          description: Number of lines to read (as a string, matches the server)