no skills preloaded.

• kanban::ticket::getkanban0.1.23schema

  Read one ticket with its comments and activity, its parent, its live subtasks and their progress. The id accepts the internal uuid or the human-readable key.

  request

  • idstring*required

    Ticket uuid or human-readable key (KAN-1, case-insensitive).

  response

  • activityobject[]

    • actorstring*required
    • atstring*required
    • changesobject[]

      • fieldstring*required
      • fromunknown*required
      • tounknown*required
    • comment_idstring
    • idstring*required
    • seqinteger· uint64*requiredmin 0
    • ticket_idstring*required
    • typestring*required

      ticket.created | ticket.updated | ticket.moved | ticket.deleted | ticket.restored | comment.created

  • assigneestring

    Agent profile id.

  • childrenobject[]*required

    Live subtasks by ticket number.

    • assigneestring
    • deleted_atstring
    • idstring*required
    • keystring*required
    • prioritystring*required
    • project_idstring
    • release_idstring
    • statusstring*required
    • titlestring*required
  • commentsobject[]

    • authorstring*required

      Agent profile id, or `user`.

    • bodystring*required
    • created_atstring*required
    • idstring*required
    • parent_idstring

      Set for a reply; replies stay one level deep.

    • ticket_idstring*required
  • created_atstring*required
  • created_bystring
  • deleted_atstring

    Set when soft-deleted; the row stays on disk.

  • descriptionstring
  • idstring*required

    Internal uuid.

  • keystring*required

    Human-readable id, e.g. KAN-1.

  • labelsstring[]
  • orderinteger· uint64min 0

    Position inside its column.

  • parentany of

    The parent, deleted or not; `null` for a ticket that is not a subtask.

    any of (2)

    variant 1

    • assigneestring
    • deleted_atstring
    • idstring*required
    • keystring*required
    • prioritystring*required
    • project_idstring
    • release_idstring
    • statusstring*required
    • titlestring*required

    variant 2

    valuenull
  • parent_idstring

    Uuid of the parent ticket. One level deep: a parent has no parent.

  • prioritystring*required
  • progressobject*required

    Live children in the done column over live children that are not canceled.

    • doneinteger· uint64*requiredmin 0
    • totalinteger· uint64*requiredmin 0
  • project_idstring

    Uuid of the project (several tickets, independent of the release).

  • release_idstring

    Uuid of the release.

  • statusstring*required

    Column id.

  • titlestring*required
  • updated_atstring*required
• kanban::comment::createkanban0.1.23schema

  Comment on a ticket, or reply to a comment by passing parent_id. Returns the new comment and the ticket (only its compact row with compact).

  request

  • authorstring

    Agent profile id, or `user`. Defaults to `user`.

  • bodystring*required

    Comment body. Markdown is rendered in the console.

  • compactboolean

    Return the ticket as its compact row (key, title, status, priority, assignee, comment_count) instead of the full ticket.

  • parent_idstring

    Comment id to reply to; replies stay one level deep.

  • ticket_idstring*required

    Ticket uuid or human-readable key (KAN-1, case-insensitive).

  response

  • commentobject*required

    • authorstring*required

      Agent profile id, or `user`.

    • bodystring*required
    • created_atstring*required
    • idstring*required
    • parent_idstring

      Set for a reply; replies stay one level deep.

    • ticket_idstring*required
  • ticketany of*required

    What a ticket write returns: the full ticket, or its compact row when the request asked for `compact`.

    any of (2)

    variant 1

    • activityobject[]

      … expand 8 nestedcollapse

      • actorstring*required
      • atstring*required
      • changesobject[]

        … expand 3 nestedcollapse

        • fieldstring*required
        • fromunknown*required
        • tounknown*required
      • comment_idstring
      • idstring*required
      • seqinteger· uint64*requiredmin 0
      • ticket_idstring*required
      • typestring*required

        ticket.created | ticket.updated | ticket.moved | ticket.deleted | ticket.restored | comment.created

    • assigneestring

      Agent profile id.

    • childrenobject[]*required

      Live subtasks by ticket number.

      … expand 9 nestedcollapse

      • assigneestring
      • deleted_atstring
      • idstring*required
      • keystring*required
      • prioritystring*required
      • project_idstring
      • release_idstring
      • statusstring*required
      • titlestring*required
    • commentsobject[]

      … expand 6 nestedcollapse

      • authorstring*required

        Agent profile id, or `user`.

      • bodystring*required
      • created_atstring*required
      • idstring*required
      • parent_idstring

        Set for a reply; replies stay one level deep.

      • ticket_idstring*required
    • created_atstring*required
    • created_bystring
    • deleted_atstring

      Set when soft-deleted; the row stays on disk.

    • descriptionstring
    • idstring*required

      Internal uuid.

    • keystring*required

      Human-readable id, e.g. KAN-1.

    • labelsstring[]
    • orderinteger· uint64min 0

      Position inside its column.

    • parentany of

      The parent, deleted or not; `null` for a ticket that is not a subtask.

      … expand 2 nestedcollapse

      any of (2)

      variant 1

      • assigneestring
      • deleted_atstring
      • idstring*required
      • keystring*required
      • prioritystring*required
      • project_idstring
      • release_idstring
      • statusstring*required
      • titlestring*required

      variant 2

      valuenull
    • parent_idstring

      Uuid of the parent ticket. One level deep: a parent has no parent.

    • prioritystring*required
    • progressobject*required

      Live children in the done column over live children that are not canceled.

      … expand 2 nestedcollapse

      • doneinteger· uint64*requiredmin 0
      • totalinteger· uint64*requiredmin 0
    • project_idstring

      Uuid of the project (several tickets, independent of the release).

    • release_idstring

      Uuid of the release.

    • statusstring*required

      Column id.

    • titlestring*required
    • updated_atstring*required

    variant 2

    • assigneestring
    • comment_countinteger· uint64*requiredmin 0
    • keystring*required
    • prioritystring*required
    • statusstring*required
    • titlestring*required
• state::compare-and-setstate0.22.19schema

  Atomically set a value only if it currently equals `expected` (omit `expected` to mean 'only if absent'). Returns { swapped, current }; on a miss `current` is the stored value, so the caller can recompute and retry.

  request

  • expectedunknown

    The value the caller believes is there. Omit to mean "expect absent" — the set-if-absent form.

  • keystring*required
  • scopestring*required
  • valueunknown*required

  response

  • currentunknown

    What is actually stored, when the swap did not happen.

  • swappedboolean*required
• shell::execide0.12.32schema

  Run a command in the foreground and return its full output. Put the program in `command` (string) and arguments in `args` (string[]), never argv in `command`. Host-only cwd/env/stdin reject S210 on a sandbox target. Errors return { code, message }; common: S216 host exec error, S300 VM boot failed, S200 in-VM failure.

  request

  • argsstring[]

    Arguments, in order (all strings). Omit/null to tokenize `command` shell-words style; pass an array (even empty) to use it verbatim.

  • commandstring*required

    Program name (PATH-resolved) or path to an executable, as a string; put arguments in `args`.

  • cwdstring

    Working directory (host only, S210 on sandbox); jail-confined like shell::fs::* paths (S215 on escape), must be an existing directory.

  • envobject

    Per-call env values (host only, S210 on sandbox); exec-hijacking keys (PATH, IFS, HOME, LD_*/DYLD_*, …) reject the whole call S210.

  • stdinstring

    Bytes written to the program's stdin, then EOF (host only, S210 on sandbox); omit to leave stdin at /dev/null.

  • targetall of

    Where to run the command. Defaults to the host worker; pass `{ kind: "sandbox", sandbox_id }` to forward the call to a microVM.

    all of (1)

    variant 1

    one of (2)

    variant 1

    • kindstring*requiredenum: host

    variant 2

    • kindstring*requiredenum: sandbox
    • sandbox_idstring· uuid*required
  • timeout_msinteger· uint64min 0

    Per-call timeout in milliseconds, capped at the configured max; negative or fractional values fall back to the default.

  response

  • duration_msinteger· uint64*requiredmin 0
  • exit_codeinteger· int32
  • stderrstring*required
  • stderr_truncatedboolean*required
  • stdoutstring*required
  • stdout_truncatedboolean*required
  • timed_outboolean*required
• coder::read-fileide0.12.32schema

  Read a file. stat: true probes size/mtime/total_lines without content; line_from/line_to (1-based, inclusive) read a window of a file of any size; numbered: true prefixes absolute line numbers; paths[] (XOR path) batch-reads. Paths: relative to the primary root or absolute inside an allowed root (see coder::info).

  request

  • encodingall of

    Content encoding for full reads; `base64` returns the exact file bytes (encoded length is budgeted). C210 with stat/window/numbered.

    all of (1)

    variant 1

    one of (2)

    variant 1

    valuestringenum: text

    variant 2

    valuestringenum: base64
  • line_frominteger· uint64min 1

    First line (1-based, >= 1) of a windowed read; windows keep files over max_read_bytes readable slice by slice. `path` mode only.

  • line_tointeger· uint64min 1

    Last line of the window, 1-based inclusive, >= `line_from`; omit to read from `line_from` to EOF. `path` mode only.

  • max_output_bytesinteger· uint64min 0

    Full-read byte budget (returned bytes, clamped to max_read_bytes); over budget fails C218 naming size/total_lines. C210 with a window.

  • numberedboolean

    Prefix each line with its absolute 1-based file line number (`N→`), matching coder::update-file line ops; C210 with `stat`. `path` mode only.

  • pathstring

    Single file to read; XOR with `paths` (C210 if both or neither is set).

  • pathsany of[]

    Batch of files to read in one call (bare path strings or window objects), processed in order against batch_read_budget_bytes; XOR with `path`.

    any of (2)

    variant 1

    valuestring

    variant 2

    • line_frominteger· uint64min 1

      First line of the window, 1-based inclusive (>= 1); defaults to 1 when only `line_to` is set.

    • line_tointeger· uint64min 1

      Last line of the window, 1-based inclusive, >= `line_from`; omit to read to EOF.

    • numberedboolean

      Prefix this entry's lines with their absolute 1-based line numbers (`N→`); prefix bytes count toward the batch budget.

    • pathstring*required

      File to read.

    • statboolean

      Metadata probe for this entry: size/mode/mtime plus total_lines, content null, no budget consumed; C210 with a window or `numbered`.

  • statboolean

    Metadata probe: size/mode/mtime plus total_lines/is_utf8, no content; C210 with line_from/line_to/numbered/max_output_bytes.

  response

  • contentstring

    File content as a UTF-8 string — the whole file, or just the requested window when `line_from`/`line_to` was given (window lines keep their newline terminators). Binary content is returned with invalid bytes replaced by U+FFFD; request `encoding: "base64"` when exact bytes matter (content is then the file's bytes base64-encoded). **Single-path mode only; null when the request used `paths[]`.**

  • is_utf8boolean

    Whether `content` survived UTF-8 conversion without losing bytes. Reflects the RETURNED content only: a clean window inside an otherwise-binary file is still `true`. **Single-path mode only; null when the request used `paths[]`.**

  • lines_returnedinteger· uint64min 0

    Number of lines in `content`. For full reads this equals the file's total line count. **Single-path mode only; null when the request used `paths[]`.**

  • modeinteger· uint32min 0

    Unix permission bits (lower 9 bits of `st_mode`), e.g. 0o644. **Single-path mode only; null when the request used `paths[]`.**

  • more_linesboolean

    True when the file has content beyond what `content` includes: the window ended before EOF, or the byte budget cut the window short. Always false for full reads. **Single-path mode only; null when the request used `paths[]`.**

  • mtimeinteger· int64

    Last-modified time as a Unix epoch in seconds. **Single-path mode only; null when the request used `paths[]`.**

  • pathstring

    Canonical absolute path of the file read (resolved through the jail). **Single-path mode only; null when the request used `paths[]`.**

  • resultsobject[]

    Per-entry results for a batch `paths[]` request. **Present only when the request used `paths[]`; null in single-path mode.**

    • contentstring

      File content as a UTF-8 string — the whole file or the requested window. Binary bytes are replaced by U+FFFD (`is_utf8: false`). `null` on failure.

    • errorany of

      Structured error — present only when `success: false`.

      any of (2)

      variant 1

      • codestring*required

        Stable error code, e.g. "C211". See the README error table.

      • messagestring*required

        Human/LLM-readable message: problem + actual values + corrective next call.

      variant 2

      valuenull
    • is_utf8boolean

      Whether `content` survived UTF-8 conversion without losing bytes. `null` on failure.

    • lines_returnedinteger· uint64min 0

      Number of lines returned in `content`. `null` on failure.

    • modeinteger· uint32min 0

      Unix permission bits (lower 9 bits of `st_mode`), e.g. 0o644. `null` on failure.

    • more_linesboolean

      `true` when the file has content beyond what `content` includes (window ended before EOF, or byte budget cut the window short). `null` on failure.

    • mtimeinteger· int64

      Last-modified time as a Unix epoch in seconds. `null` on failure.

    • pathstring*required

      Canonical absolute path of the file (resolved through the jail). If resolution failed, this echoes the caller's input verbatim.

    • sizeinteger· uint64min 0

      Size of the FILE in bytes (from metadata). `null` on failure or when the entry budget was exhausted before the file was opened.

    • successboolean*required

      `true` when the read succeeded (content/metadata fields are populated); `false` when an error occurred (only `error` is set).

    • total_linesinteger· uint64min 0

      Total lines in the file; present when the stream reached EOF during this entry's read. `null` when not traversed or on failure.

  • revisionstring

    Opaque identity of the file's exact bytes. Present for complete single-path reads only; pass it as `expected_revision` to `coder::create-file` for a conflict-safe whole-file overwrite.

  • sizeinteger· uint64min 0

    Size of the FILE in bytes (from metadata) — not the size of `content`; in windowed mode the two differ. **Single-path mode only; null when the request used `paths[]`.**

  • total_linesinteger· uint64min 0

    Total number of lines in the file. Present only when the read traversed the whole file: always for full reads; for windowed reads only when the stream naturally reached EOF within the byte cap. Never computed by forcing an extra full scan — absent means the file was not fully traversed. **Single-path mode only; null when the request used `paths[]`.**