FR
Integrations

JSON catalogs

Consume agents, presets, context scans, exports, and checkpoints through versioned JSON.

These commands write one JSON document to stdout and exit without starting an AI session.

  • palabre agents --json exposes roles[], agents[], and defaults.askAgents[]. Each agent provides its name, type, role, availability, and a reason when needed.
  • palabre presets --json exposes pairs, order, available, missingAgents[], and unavailableReasons[].
  • palabre context scan src docs --json exposes the root, requested paths, items[], and warnings[].
  • palabre history --json exposes the 10 most recent exports in history[]. An integration may request 1 to 100 entries with --limit <number>.
  • palabre sessions --json exposes the 20 most recent checkpoints in sessions[], with a limit from 1 to 100. A valid entry contains valid, id, status, mode, topic, updatedAt, responses, nextPhase, and resumable. A corrupted entry contains valid: false, id, updatedAt, and a stable warning, without raw contents or an absolute path.
  • palabre sessions delete <session-id> --yes --json confirms the targeted deletion with { "v": 1, "deleted": { "id": "..." } }.

Consumption rules

  • check v;
  • ignore unknown fields;
  • accept missing optional fields;
  • do not recalculate availability or scanning rules;
  • display warnings without changing their meaning.