[{"data":1,"prerenderedAt":452},["ShallowReactive",2],{"navigation-en":3,"\u002Fen\u002Fintegrations\u002Fclient-lifecycle":203,"\u002Fen\u002Fintegrations\u002Fclient-lifecycle-surround":447},[4,8,47,80,130,151,173,191,195,199],{"title":5,"path":6,"stem":7},"","\u002Fen","en\u002Findex",{"title":9,"icon":10,"path":11,"stem":12,"children":13,"page":46},"Get Started","i-lucide-rocket","\u002Fen\u002Fget-started","en\u002F1.get-started",[14,18,22,26,30,34,38,42],{"title":15,"path":16,"stem":17},"Introduction","\u002Fen\u002Fget-started\u002Fintroduction","en\u002F1.get-started\u002F1.introduction",{"title":19,"path":20,"stem":21},"Installation","\u002Fen\u002Fget-started\u002Finstallation","en\u002F1.get-started\u002F2.installation",{"title":23,"path":24,"stem":25},"Run your first session","\u002Fen\u002Fget-started\u002Ffirst-debate","en\u002F1.get-started\u002F3.first-debate",{"title":27,"path":28,"stem":29},"Your first Relay","\u002Fen\u002Fget-started\u002Ffirst-relay","en\u002F1.get-started\u002F4.first-relay",{"title":31,"path":32,"stem":33},"First configuration","\u002Fen\u002Fget-started\u002Fconfiguration","en\u002F1.get-started\u002F5.configuration",{"title":35,"path":36,"stem":37},"VS Code extension","\u002Fen\u002Fget-started\u002Fvscode-extension","en\u002F1.get-started\u002F6.vscode-extension",{"title":39,"path":40,"stem":41},"Palabre skill","\u002Fen\u002Fget-started\u002Fskill","en\u002F1.get-started\u002F7.skill",{"title":43,"path":44,"stem":45},"Change machines","\u002Fen\u002Fget-started\u002Fchange-machine","en\u002F1.get-started\u002F8.change-machine",false,{"title":48,"icon":49,"path":50,"stem":51,"children":52,"page":46},"Agents","i-lucide-bot","\u002Fen\u002Fagents","en\u002F2.agents",[53,56,60,64,68,72,76],{"title":48,"path":54,"stem":55},"\u002Fen\u002Fagents\u002Foverview","en\u002F2.agents\u002F1.overview",{"title":57,"path":58,"stem":59},"Claude Code","\u002Fen\u002Fagents\u002Fclaude-code","en\u002F2.agents\u002F2.claude-code",{"title":61,"path":62,"stem":63},"Codex","\u002Fen\u002Fagents\u002Fcodex","en\u002F2.agents\u002F3.codex",{"title":65,"path":66,"stem":67},"Antigravity","\u002Fen\u002Fagents\u002Fantigravity","en\u002F2.agents\u002F5.antigravity",{"title":69,"path":70,"stem":71},"OpenCode","\u002Fen\u002Fagents\u002Fopencode","en\u002F2.agents\u002F6.opencode",{"title":73,"path":74,"stem":75},"Ollama","\u002Fen\u002Fagents\u002Follama","en\u002F2.agents\u002F7.ollama",{"title":77,"path":78,"stem":79},"Mistral Vibe","\u002Fen\u002Fagents\u002Fvibe","en\u002F2.agents\u002F8.vibe",{"title":81,"icon":82,"path":83,"stem":84,"children":85,"page":46},"Usage","i-lucide-terminal","\u002Fen\u002Fusage","en\u002F3.usage",[86,90,94,98,102,106,110,114,118,122,126],{"title":87,"path":88,"stem":89},"Choose a mode","\u002Fen\u002Fusage\u002Frunning-a-debate","en\u002F3.usage\u002F01.running-a-debate",{"title":91,"path":92,"stem":93},"Debate mode","\u002Fen\u002Fusage\u002Fdebate","en\u002F3.usage\u002F02.debate",{"title":95,"path":96,"stem":97},"Relay mode","\u002Fen\u002Fusage\u002Frelay","en\u002F3.usage\u002F03.relay",{"title":99,"path":100,"stem":101},"Ask mode","\u002Fen\u002Fusage\u002Fask","en\u002F3.usage\u002F04.ask",{"title":103,"path":104,"stem":105},"Chat mode","\u002Fen\u002Fusage\u002Fchat","en\u002F3.usage\u002F05.chat",{"title":107,"path":108,"stem":109},"Use the TUI","\u002Fen\u002Fusage\u002Ftui","en\u002F3.usage\u002F06.tui",{"title":111,"path":112,"stem":113},"Context and files","\u002Fen\u002Fusage\u002Fcontext-and-files","en\u002F3.usage\u002F07.context-and-files",{"title":115,"path":116,"stem":117},"Summaries","\u002Fen\u002Fusage\u002Fsummaries","en\u002F3.usage\u002F08.summaries",{"title":119,"path":120,"stem":121},"Exports","\u002Fen\u002Fusage\u002Fexports","en\u002F3.usage\u002F09.exports",{"title":123,"path":124,"stem":125},"Use multiple AI agents from the terminal","\u002Fen\u002Fusage\u002Fmulti-agent-cli","en\u002F3.usage\u002F10.multi-agent-cli",{"title":127,"path":128,"stem":129},"Run a Codex and Claude Code debate","\u002Fen\u002Fusage\u002Fcodex-claude-debate","en\u002F3.usage\u002F11.codex-claude-debate",{"title":131,"icon":132,"path":133,"stem":134,"children":135,"page":46},"Configuration","i-lucide-settings","\u002Fen\u002Fconfiguration","en\u002F4.configuration",[136,139,143,147],{"title":131,"path":137,"stem":138},"\u002Fen\u002Fconfiguration\u002Foverview","en\u002F4.configuration\u002F1.overview",{"title":140,"path":141,"stem":142},"Default settings","\u002Fen\u002Fconfiguration\u002Fdefaults","en\u002F4.configuration\u002F2.defaults",{"title":144,"path":145,"stem":146},"Local vs global configuration","\u002Fen\u002Fconfiguration\u002Flocal-vs-global","en\u002F4.configuration\u002F3.local-vs-global",{"title":148,"path":149,"stem":150},"Advanced JSON","\u002Fen\u002Fconfiguration\u002Fadvanced-json","en\u002F4.configuration\u002F4.advanced-json",{"title":152,"icon":153,"path":154,"stem":155,"children":156,"page":46},"Integrations","i-lucide-blocks","\u002Fen\u002Fintegrations","en\u002F5.integrations",[157,161,165,169],{"title":158,"path":159,"stem":160},"Integrate Palabre","\u002Fen\u002Fintegrations\u002Foverview","en\u002F5.integrations\u002F1.overview",{"title":162,"path":163,"stem":164},"JSON catalogs","\u002Fen\u002Fintegrations\u002Fjson-contracts","en\u002F5.integrations\u002F2.json-contracts",{"title":166,"path":167,"stem":168},"NDJSON v1 stream","\u002Fen\u002Fintegrations\u002Fndjson","en\u002F5.integrations\u002F3.ndjson",{"title":170,"path":171,"stem":172},"Lifecycle, errors, and identity","\u002Fen\u002Fintegrations\u002Fclient-lifecycle","en\u002F5.integrations\u002F4.client-lifecycle",{"title":174,"icon":175,"path":176,"stem":177,"children":178,"page":46},"Reference","i-lucide-book","\u002Fen\u002Freference","en\u002F6.reference",[179,183,187],{"title":180,"path":181,"stem":182},"Command reference","\u002Fen\u002Freference\u002Fcli","en\u002F6.reference\u002F1.cli",{"title":184,"path":185,"stem":186},"Configuration file reference","\u002Fen\u002Freference\u002Fconfig-file","en\u002F6.reference\u002F2.config-file",{"title":188,"path":189,"stem":190},"Presets","\u002Fen\u002Freference\u002Fpresets","en\u002F6.reference\u002F3.presets",{"title":192,"path":193,"stem":194},"Troubleshooting","\u002Fen\u002Ftroubleshooting","en\u002F7.troubleshooting",{"title":196,"path":197,"stem":198},"Roadmap","\u002Fen\u002Froadmap","en\u002F8.roadmap",{"title":200,"path":201,"stem":202},"Changelog","\u002Fen\u002Fchangelog","en\u002F9.changelog",{"id":204,"title":170,"body":205,"description":438,"extension":439,"links":440,"meta":441,"navigation":442,"path":171,"seo":443,"stem":172,"__hash__":446},"docs\u002Fen\u002F5.integrations\u002F4.client-lifecycle.md",{"type":206,"value":207,"toc":433},"minimark",[208,259,280,287,352,358,365,370,379,386],[209,210,211,224],"table",{},[212,213,214],"thead",{},[215,216,217,221],"tr",{},[218,219,220],"th",{},"Code",[218,222,223],{},"Meaning",[225,226,227,239,249],"tbody",{},[215,228,229,236],{},[230,231,232],"td",{},[233,234,235],"code",{},"0",[230,237,238],{},"Success.",[215,240,241,246],{},[230,242,243],{},[233,244,245],{},"1",[230,247,248],{},"Validation, configuration, or runtime error.",[215,250,251,256],{},[230,252,253],{},[233,254,255],{},"130",[230,257,258],{},"Cancellation.",[260,261,262,263,267,268,271,272,271,276,279],"p",{},"This table covers Debate, Ask and Chat sessions and catalogs. Relay and its Mission option use their own table, including exits 2 through 9: see ",[264,265,266],"a",{"href":96},"Relay",". Handle Relay using both ",[233,269,270],{},"status"," ",[273,274,275],"strong",{},"and",[233,277,278],{},"delivery.status",", not only the exit code.",[260,281,282,283,286],{},"Always wait for process termination. ",[233,284,285],{},"error"," describes the business failure; the code confirms final state.",[260,288,289,290,292,293,296,297,300,301,300,304,300,307,300,310,300,313,300,316,300,319,300,322,300,325,300,328,300,331,334,335,338,339,300,341,344,345,348,349,351],{},"An ",[233,291,285],{}," event may include phase, agent, role, turn, a stable ",[233,294,295],{},"kind",", message, and details. Kinds include ",[233,298,299],{},"command-not-found",", ",[233,302,303],{},"spawn-failed",[233,305,306],{},"timeout",[233,308,309],{},"idle-timeout",[233,311,312],{},"output-too-large",[233,314,315],{},"empty-output",[233,317,318],{},"non-zero-exit",[233,320,321],{},"usage-limit",[233,323,324],{},"unsupported-model",[233,326,327],{},"model-unavailable",[233,329,330],{},"model-pull-failed",[233,332,333],{},"http-error",", and ",[233,336,337],{},"cancelled",". For a ",[233,340,321],{},[233,342,343],{},"retryAfter"," may be present: duration in seconds, ISO timestamp, or local ",[233,346,347],{},"HH:mm"," time. It is best-effort; branch on ",[233,350,295],{},", not message text.",[260,353,354,355,357],{},"A CLI agent that exits with a non-zero code still fails, even if it wrote to stdout. Palabre gives stderr priority; when stderr is empty, the ",[233,356,318],{}," message includes only a sanitized, bounded stdout excerpt for diagnostics. This excerpt is never an agent response and does not automatically reclassify the error.",[260,359,360,361,364],{},"Palabre attempts to preserve responses in a partial export after failure. Accept ",[233,362,363],{},"done"," with a path followed by a non-zero code. Cancellation must remain distinct from an error.",[366,367,369],"h2",{"id":368},"client-identity","Client identity",[371,372,377],"pre",{"className":373,"code":375,"language":376,"meta":5},[374],"language-text","PALABRE_CLIENT=my-integration\nPALABRE_CLIENT_VERSION=2.3.0\n","text",[233,378,375],{"__ignoreMap":5},[260,380,381,382,385],{},"The name is open-ended. Palabre sanitizes these values and records them with its own version in exports. Without a declaration, the source is ",[233,383,384],{},"direct-cli",". These fields are diagnostic, not a security boundary.",[260,387,388,389,391,392,391,395,398,399,402,403,406,407,410,411,414,415,418,419,422,423,426,427,429,430,432],{},"Relay has its own outcomes: ",[233,390,321],{}," (2), ",[233,393,394],{},"read-unavailable",[233,396,397],{},"target-not-open"," (3), ",[233,400,401],{},"review-failed"," (9), ",[233,404,405],{},"invalid-request"," with ",[233,408,409],{},"error.reason"," (8). Refused command launches on Windows fill ",[233,412,413],{},"readAccess",": ",[233,416,417],{},"partial"," and ",[233,420,421],{},"unverified"," preserve the outcome; ",[233,424,425],{},"blocked"," may produce ",[233,428,394],{}," without removing reply or delivery. ",[233,431,343],{}," may be only a time, without a date or time zone: show it as supplied and await a human decision, without scheduled resend. Client provenance fields described here apply to Debate\u002FAsk\u002FChat exports; Relay reports its PALABRE version.",{"title":5,"searchDepth":434,"depth":435,"links":436},1,2,[437],{"id":368,"depth":435,"text":369},"Handle exit codes, partial exports, cancellation, and integration provenance.","md",null,{},true,{"title":444,"description":445},"Exit codes, cancellation, and partial exports","Handle Palabre exit codes, partial exports, and cancellation, and declare your integration's provenance.","CMnryZQn9LgOHjjhjYlDojPqx-mTHR84_SHqmMthQnE",[448,450],{"title":166,"path":167,"stem":168,"description":449,"children":-1},"Read Palabre session events from stdout and build a robust integration UI.",{"title":180,"path":181,"stem":182,"description":451,"children":-1},"Reference for commands and options available in the Palabre CLI.",1793816478366]