no skills preloaded.

• kanban::ticket::getkanban0.1.22schema

  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.22schema

  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::getstate0.22.19schema

  Read the value stored at a key in a state scope

  request

  • keystring*required

    Identifier for the value within the scope.

  • scopestring*required

    Namespace that groups related keys.

  response

  valuestring
• 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