runpane 2.3.0 → 2.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/agentContext.d.ts +23 -0
- package/dist/agentContext.d.ts.map +1 -0
- package/dist/agentContext.js +100 -0
- package/dist/agentContext.js.map +1 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +15 -0
- package/dist/cli.js.map +1 -1
- package/dist/commands.d.ts +17 -2
- package/dist/commands.d.ts.map +1 -1
- package/dist/commands.js +111 -8
- package/dist/commands.js.map +1 -1
- package/dist/daemonClient.d.ts +17 -0
- package/dist/daemonClient.d.ts.map +1 -0
- package/dist/daemonClient.js +176 -0
- package/dist/daemonClient.js.map +1 -0
- package/dist/generated/contract.d.ts +765 -10
- package/dist/generated/contract.d.ts.map +1 -1
- package/dist/generated/contract.js +1231 -8
- package/dist/generated/contract.js.map +1 -1
- package/dist/localControl.d.ts +5 -0
- package/dist/localControl.d.ts.map +1 -0
- package/dist/localControl.js +279 -0
- package/dist/localControl.js.map +1 -0
- package/package.json +1 -1
|
@@ -46,8 +46,24 @@ exports.RUNPANE_CONTRACT = {
|
|
|
46
46
|
"channels": [
|
|
47
47
|
"stable",
|
|
48
48
|
"nightly"
|
|
49
|
+
],
|
|
50
|
+
"agents": [
|
|
51
|
+
"codex",
|
|
52
|
+
"claude"
|
|
49
53
|
]
|
|
50
54
|
},
|
|
55
|
+
"agentTemplates": {
|
|
56
|
+
"codex": {
|
|
57
|
+
"title": "Codex",
|
|
58
|
+
"command": "codex --yolo",
|
|
59
|
+
"description": "Open a Codex terminal tab and allow the initial input to drive the agent."
|
|
60
|
+
},
|
|
61
|
+
"claude": {
|
|
62
|
+
"title": "Claude Code",
|
|
63
|
+
"command": "claude --dangerously-skip-permissions",
|
|
64
|
+
"description": "Open a Claude Code terminal tab and allow the initial input to drive the agent."
|
|
65
|
+
}
|
|
66
|
+
},
|
|
51
67
|
"commands": [
|
|
52
68
|
{
|
|
53
69
|
"name": "help",
|
|
@@ -99,6 +115,53 @@ exports.RUNPANE_CONTRACT = {
|
|
|
99
115
|
"usage": [
|
|
100
116
|
"runpane doctor"
|
|
101
117
|
]
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
"name": "agent-context",
|
|
121
|
+
"summary": "Print token-efficient Pane command context for coding agents.",
|
|
122
|
+
"usage": [
|
|
123
|
+
"runpane agent-context [--json]",
|
|
124
|
+
"runpane agent-context --command <command> [--json]"
|
|
125
|
+
],
|
|
126
|
+
"jsonSchemas": [
|
|
127
|
+
"agentContextBriefResult",
|
|
128
|
+
"agentContextCommandResult"
|
|
129
|
+
]
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"name": "repos list",
|
|
133
|
+
"summary": "List repositories saved in the running Pane app.",
|
|
134
|
+
"usage": [
|
|
135
|
+
"runpane repos list [--json] [--pane-dir <path>]"
|
|
136
|
+
],
|
|
137
|
+
"jsonSchemas": [
|
|
138
|
+
"repoListResult"
|
|
139
|
+
]
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"name": "repos add",
|
|
143
|
+
"summary": "Register an existing git repository with the running Pane app.",
|
|
144
|
+
"usage": [
|
|
145
|
+
"runpane repos add --path <path> [--name <name>] [--json] [--yes]"
|
|
146
|
+
],
|
|
147
|
+
"mutates": true,
|
|
148
|
+
"jsonSchemas": [
|
|
149
|
+
"repoAddRequest",
|
|
150
|
+
"repoAddResult"
|
|
151
|
+
]
|
|
152
|
+
},
|
|
153
|
+
{
|
|
154
|
+
"name": "panes create",
|
|
155
|
+
"summary": "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.",
|
|
156
|
+
"usage": [
|
|
157
|
+
"runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]",
|
|
158
|
+
"runpane panes create --from-json <path|-> [--yes] [--json]"
|
|
159
|
+
],
|
|
160
|
+
"mutates": true,
|
|
161
|
+
"jsonSchemas": [
|
|
162
|
+
"paneCreateRequest",
|
|
163
|
+
"paneCreateResult"
|
|
164
|
+
]
|
|
102
165
|
}
|
|
103
166
|
],
|
|
104
167
|
"flags": {
|
|
@@ -189,6 +252,82 @@ exports.RUNPANE_CONTRACT = {
|
|
|
189
252
|
{
|
|
190
253
|
"name": "--print-only"
|
|
191
254
|
}
|
|
255
|
+
],
|
|
256
|
+
"localValue": [
|
|
257
|
+
{
|
|
258
|
+
"name": "--pane-dir",
|
|
259
|
+
"value": "<path>",
|
|
260
|
+
"description": "Connect to a Pane daemon using this Pane data directory."
|
|
261
|
+
},
|
|
262
|
+
{
|
|
263
|
+
"name": "--repo",
|
|
264
|
+
"value": "<selector>",
|
|
265
|
+
"description": "Repository selector: active, id, exact path, or saved repository name."
|
|
266
|
+
},
|
|
267
|
+
{
|
|
268
|
+
"name": "--path",
|
|
269
|
+
"value": "<path>",
|
|
270
|
+
"description": "Existing git repository path to register with Pane."
|
|
271
|
+
},
|
|
272
|
+
{
|
|
273
|
+
"name": "--name",
|
|
274
|
+
"value": "<name>",
|
|
275
|
+
"description": "Name for the registered repository or created pane/session."
|
|
276
|
+
},
|
|
277
|
+
{
|
|
278
|
+
"name": "--worktree-name",
|
|
279
|
+
"value": "<name>",
|
|
280
|
+
"description": "Worktree name to request. Defaults to --name."
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"name": "--base-branch",
|
|
284
|
+
"value": "<branch>",
|
|
285
|
+
"description": "Base branch for the created worktree."
|
|
286
|
+
},
|
|
287
|
+
{
|
|
288
|
+
"name": "--agent",
|
|
289
|
+
"value": "<codex|claude>",
|
|
290
|
+
"description": "Built-in agent terminal template to open."
|
|
291
|
+
},
|
|
292
|
+
{
|
|
293
|
+
"name": "--tool-command",
|
|
294
|
+
"value": "<command>",
|
|
295
|
+
"description": "Custom terminal command to run instead of a built-in agent."
|
|
296
|
+
},
|
|
297
|
+
{
|
|
298
|
+
"name": "--title",
|
|
299
|
+
"value": "<title>",
|
|
300
|
+
"description": "Terminal tab title. Defaults to the selected agent title or Terminal."
|
|
301
|
+
},
|
|
302
|
+
{
|
|
303
|
+
"name": "--initial-input",
|
|
304
|
+
"value": "<text>",
|
|
305
|
+
"aliases": [
|
|
306
|
+
"--prompt"
|
|
307
|
+
],
|
|
308
|
+
"description": "Text to send to the terminal after the command is ready. --prompt is an alias."
|
|
309
|
+
},
|
|
310
|
+
{
|
|
311
|
+
"name": "--initial-input-file",
|
|
312
|
+
"value": "<path|->",
|
|
313
|
+
"description": "Read initial input from a file or stdin."
|
|
314
|
+
},
|
|
315
|
+
{
|
|
316
|
+
"name": "--from-json",
|
|
317
|
+
"value": "<path|->",
|
|
318
|
+
"description": "Read a full panes.create request JSON payload from a file or stdin."
|
|
319
|
+
},
|
|
320
|
+
{
|
|
321
|
+
"name": "--timeout-ms",
|
|
322
|
+
"value": "<milliseconds>",
|
|
323
|
+
"description": "Maximum time to wait for each pane creation job."
|
|
324
|
+
}
|
|
325
|
+
],
|
|
326
|
+
"localBoolean": [
|
|
327
|
+
{
|
|
328
|
+
"name": "--json",
|
|
329
|
+
"description": "Print machine-readable JSON output."
|
|
330
|
+
}
|
|
192
331
|
]
|
|
193
332
|
},
|
|
194
333
|
"help": {
|
|
@@ -201,6 +340,10 @@ exports.RUNPANE_CONTRACT = {
|
|
|
201
340
|
" runpane update [options]",
|
|
202
341
|
" runpane version",
|
|
203
342
|
" runpane doctor",
|
|
343
|
+
" runpane agent-context [--json]",
|
|
344
|
+
" runpane repos list [--json]",
|
|
345
|
+
" runpane repos add --path <path> [--name <name>]",
|
|
346
|
+
" runpane panes create --repo <selector> --name <name> --agent <codex|claude>",
|
|
204
347
|
" runpane help [command]",
|
|
205
348
|
"",
|
|
206
349
|
"Quick start:",
|
|
@@ -213,7 +356,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
213
356
|
" pnpm dlx runpane@latest",
|
|
214
357
|
" pipx run runpane",
|
|
215
358
|
"",
|
|
216
|
-
"Run \"runpane
|
|
359
|
+
"Run \"runpane agent-context\" when an agent needs Pane command context.",
|
|
360
|
+
"Run \"runpane help panes create\" for pane orchestration options."
|
|
217
361
|
],
|
|
218
362
|
"install": [
|
|
219
363
|
"Usage:",
|
|
@@ -280,6 +424,72 @@ exports.RUNPANE_CONTRACT = {
|
|
|
280
424
|
"doctor": [
|
|
281
425
|
"Usage:",
|
|
282
426
|
" runpane doctor [--pane-path <path>] [--format <format>] [--verbose]"
|
|
427
|
+
],
|
|
428
|
+
"repos list": [
|
|
429
|
+
"Usage:",
|
|
430
|
+
" runpane repos list [--json] [--pane-dir <path>]",
|
|
431
|
+
"",
|
|
432
|
+
"Lists repositories saved in the running Pane app.",
|
|
433
|
+
"",
|
|
434
|
+
"Options:",
|
|
435
|
+
" --json Print machine-readable output",
|
|
436
|
+
" --pane-dir <path> Connect to a specific Pane data directory"
|
|
437
|
+
],
|
|
438
|
+
"repos add": [
|
|
439
|
+
"Usage:",
|
|
440
|
+
" runpane repos add --path <path> [--name <name>] [--json] [--yes]",
|
|
441
|
+
"",
|
|
442
|
+
"Registers an existing git repository with the running Pane app.",
|
|
443
|
+
"",
|
|
444
|
+
"Options:",
|
|
445
|
+
" --path <path> Existing git repository path",
|
|
446
|
+
" --name <name> Saved repository name; defaults to the directory name",
|
|
447
|
+
" --pane-dir <path> Connect to a specific Pane data directory",
|
|
448
|
+
" --json Print machine-readable output",
|
|
449
|
+
" --dry-run Validate and preview without adding the repo",
|
|
450
|
+
" --yes Skip confirmation for mutating commands"
|
|
451
|
+
],
|
|
452
|
+
"panes create": [
|
|
453
|
+
"Usage:",
|
|
454
|
+
" runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]",
|
|
455
|
+
" runpane panes create --from-json <path|-> [--yes] [--json]",
|
|
456
|
+
"",
|
|
457
|
+
"Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.",
|
|
458
|
+
"",
|
|
459
|
+
"Options:",
|
|
460
|
+
" --repo <selector> active, id, exact path, or saved repository name",
|
|
461
|
+
" --name <name> Pane/session name",
|
|
462
|
+
" --worktree-name <name> Worktree name; defaults to --name",
|
|
463
|
+
" --base-branch <branch> Base branch for the worktree",
|
|
464
|
+
" --agent <codex|claude> Built-in terminal template",
|
|
465
|
+
" --tool-command <command> Custom terminal command",
|
|
466
|
+
" --title <title> Terminal tab title",
|
|
467
|
+
" --initial-input <text> Text sent after the command is ready",
|
|
468
|
+
" --prompt <text> Alias for --initial-input",
|
|
469
|
+
" --initial-input-file <path|-> Read initial input from a file or stdin",
|
|
470
|
+
" --from-json <path|-> Read a full request payload",
|
|
471
|
+
" --timeout-ms <milliseconds> Pane creation timeout",
|
|
472
|
+
" --pane-dir <path> Connect to a specific Pane data directory",
|
|
473
|
+
" --json Print machine-readable output",
|
|
474
|
+
" --dry-run Validate and preview without creating panes",
|
|
475
|
+
" --yes Skip confirmation for mutating commands"
|
|
476
|
+
],
|
|
477
|
+
"agent-context": [
|
|
478
|
+
"Usage:",
|
|
479
|
+
" runpane agent-context [--json]",
|
|
480
|
+
" runpane agent-context --command <command> [--json]",
|
|
481
|
+
"",
|
|
482
|
+
"Prints Pane command context for coding agents without requiring a running Pane app.",
|
|
483
|
+
"",
|
|
484
|
+
"Options:",
|
|
485
|
+
" --command <command> Print the full definition for one runpane command",
|
|
486
|
+
" --json Print machine-readable output",
|
|
487
|
+
"",
|
|
488
|
+
"Examples:",
|
|
489
|
+
" runpane agent-context",
|
|
490
|
+
" runpane agent-context --json",
|
|
491
|
+
" runpane agent-context --command \"panes create\"",
|
|
492
|
+
" runpane agent-context --command \"panes create\" --json"
|
|
283
493
|
]
|
|
284
494
|
},
|
|
285
495
|
"pip": {
|
|
@@ -291,6 +501,10 @@ exports.RUNPANE_CONTRACT = {
|
|
|
291
501
|
" runpane update [options]",
|
|
292
502
|
" runpane version",
|
|
293
503
|
" runpane doctor",
|
|
504
|
+
" runpane agent-context [--json]",
|
|
505
|
+
" runpane repos list [--json]",
|
|
506
|
+
" runpane repos add --path <path> [--name <name>]",
|
|
507
|
+
" runpane panes create --repo <selector> --name <name> --agent <codex|claude>",
|
|
294
508
|
" runpane help [command]",
|
|
295
509
|
"",
|
|
296
510
|
"Quick start:",
|
|
@@ -302,7 +516,8 @@ exports.RUNPANE_CONTRACT = {
|
|
|
302
516
|
" pipx run runpane install daemon --label \"My Server\"",
|
|
303
517
|
" uvx runpane@latest",
|
|
304
518
|
"",
|
|
305
|
-
"Run \"runpane
|
|
519
|
+
"Run \"runpane agent-context\" when an agent needs Pane command context.",
|
|
520
|
+
"Run \"runpane help panes create\" for pane orchestration options."
|
|
306
521
|
],
|
|
307
522
|
"install": [
|
|
308
523
|
"Usage:",
|
|
@@ -358,6 +573,72 @@ exports.RUNPANE_CONTRACT = {
|
|
|
358
573
|
"doctor": [
|
|
359
574
|
"Usage:",
|
|
360
575
|
" runpane doctor [--pane-path <path>] [--format <format>] [--verbose]"
|
|
576
|
+
],
|
|
577
|
+
"repos list": [
|
|
578
|
+
"Usage:",
|
|
579
|
+
" runpane repos list [--json] [--pane-dir <path>]",
|
|
580
|
+
"",
|
|
581
|
+
"Lists repositories saved in the running Pane app.",
|
|
582
|
+
"",
|
|
583
|
+
"Options:",
|
|
584
|
+
" --json",
|
|
585
|
+
" --pane-dir <path>"
|
|
586
|
+
],
|
|
587
|
+
"repos add": [
|
|
588
|
+
"Usage:",
|
|
589
|
+
" runpane repos add --path <path> [--name <name>] [--json] [--yes]",
|
|
590
|
+
"",
|
|
591
|
+
"Registers an existing git repository with the running Pane app.",
|
|
592
|
+
"",
|
|
593
|
+
"Options:",
|
|
594
|
+
" --path <path>",
|
|
595
|
+
" --name <name>",
|
|
596
|
+
" --pane-dir <path>",
|
|
597
|
+
" --json",
|
|
598
|
+
" --dry-run",
|
|
599
|
+
" --yes"
|
|
600
|
+
],
|
|
601
|
+
"panes create": [
|
|
602
|
+
"Usage:",
|
|
603
|
+
" runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]",
|
|
604
|
+
" runpane panes create --from-json <path|-> [--yes] [--json]",
|
|
605
|
+
"",
|
|
606
|
+
"Creates Pane sessions in a saved repository and opens a terminal-backed tool tab.",
|
|
607
|
+
"",
|
|
608
|
+
"Options:",
|
|
609
|
+
" --repo <selector>",
|
|
610
|
+
" --name <name>",
|
|
611
|
+
" --worktree-name <name>",
|
|
612
|
+
" --base-branch <branch>",
|
|
613
|
+
" --agent <codex|claude>",
|
|
614
|
+
" --tool-command <command>",
|
|
615
|
+
" --title <title>",
|
|
616
|
+
" --initial-input <text>",
|
|
617
|
+
" --prompt <text>",
|
|
618
|
+
" --initial-input-file <path|->",
|
|
619
|
+
" --from-json <path|->",
|
|
620
|
+
" --timeout-ms <milliseconds>",
|
|
621
|
+
" --pane-dir <path>",
|
|
622
|
+
" --json",
|
|
623
|
+
" --dry-run",
|
|
624
|
+
" --yes"
|
|
625
|
+
],
|
|
626
|
+
"agent-context": [
|
|
627
|
+
"Usage:",
|
|
628
|
+
" runpane agent-context [--json]",
|
|
629
|
+
" runpane agent-context --command <command> [--json]",
|
|
630
|
+
"",
|
|
631
|
+
"Prints Pane command context for coding agents without requiring a running Pane app.",
|
|
632
|
+
"",
|
|
633
|
+
"Options:",
|
|
634
|
+
" --command <command>",
|
|
635
|
+
" --json",
|
|
636
|
+
"",
|
|
637
|
+
"Examples:",
|
|
638
|
+
" runpane agent-context",
|
|
639
|
+
" runpane agent-context --json",
|
|
640
|
+
" runpane agent-context --command \"panes create\"",
|
|
641
|
+
" runpane agent-context --command \"panes create\" --json"
|
|
361
642
|
]
|
|
362
643
|
}
|
|
363
644
|
},
|
|
@@ -423,6 +704,12 @@ exports.RUNPANE_CONTRACT = {
|
|
|
423
704
|
"runpane update",
|
|
424
705
|
"runpane version",
|
|
425
706
|
"runpane doctor",
|
|
707
|
+
"runpane agent-context",
|
|
708
|
+
"runpane agent-context --command \"panes create\" --json",
|
|
709
|
+
"runpane repos list --json",
|
|
710
|
+
"runpane repos add --path /path/to/repo --name Pane --yes --json",
|
|
711
|
+
"runpane panes create --repo active --name issue-252 --agent codex --prompt \"Kick off the discussion skill for issue 252\" --yes",
|
|
712
|
+
"runpane panes create --from-json panes.json --yes --json",
|
|
426
713
|
"runpane help",
|
|
427
714
|
"runpane <command> --help"
|
|
428
715
|
],
|
|
@@ -434,9 +721,16 @@ exports.RUNPANE_CONTRACT = {
|
|
|
434
721
|
"The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.",
|
|
435
722
|
"`runpane update` uses the same release resolution and installer path as `install client`.",
|
|
436
723
|
"`runpane version` prints the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.",
|
|
437
|
-
"`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints."
|
|
724
|
+
"`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, and remote-daemon hints.",
|
|
725
|
+
"`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.",
|
|
726
|
+
"`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.",
|
|
727
|
+
"`runpane repos list` connects to the running local Pane daemon and prints saved repository records.",
|
|
728
|
+
"`runpane repos add` registers an existing git repository with the running local Pane daemon. It does not create directories or initialize git repositories by default.",
|
|
729
|
+
"`runpane panes create` connects to the running local Pane daemon, resolves the requested repository, creates Pane sessions, opens terminal-backed tool tabs, and optionally sends initial input to the started tool.",
|
|
730
|
+
"`runpane panes create --prompt` is an alias for `--initial-input`; request JSON and daemon payloads should use the canonical `initialInput` field."
|
|
438
731
|
],
|
|
439
732
|
"wrapperFlagNote": "The top-level `runpane --version` form prints the wrapper version. The install subcommand form `runpane install --version vX.Y.Z` selects a Pane release.",
|
|
733
|
+
"localControlFlagNote": "`runpane repos list` and `runpane panes create` use the local framed daemon socket/pipe for a running Pane app. `--pane-dir` points the wrapper at a non-default Pane data directory, such as `PANE_DIR=~/.pane_test` in development. `runpane agent-context` is local/offline and can be used before Pane is running.",
|
|
440
734
|
"daemonFlagNote": "Unknown daemon flags should be forwarded rather than dropped so newer Pane versions can extend `--remote-setup` without requiring an immediate wrapper release. Unknown flags for non-daemon commands should fail clearly.",
|
|
441
735
|
"downloadAttribution": [
|
|
442
736
|
"The npm package uses `source=npm` for all npm-registry consumers, including `npx`, `pnpm dlx`, `yarn dlx`, `bunx`, and global npm/pnpm installs.",
|
|
@@ -512,6 +806,58 @@ exports.RUNPANE_CONTRACT = {
|
|
|
512
806
|
"zip",
|
|
513
807
|
"--verbose"
|
|
514
808
|
],
|
|
809
|
+
[
|
|
810
|
+
"agent-context"
|
|
811
|
+
],
|
|
812
|
+
[
|
|
813
|
+
"agent-context",
|
|
814
|
+
"--command",
|
|
815
|
+
"panes create",
|
|
816
|
+
"--json"
|
|
817
|
+
],
|
|
818
|
+
[
|
|
819
|
+
"repos",
|
|
820
|
+
"list",
|
|
821
|
+
"--json",
|
|
822
|
+
"--pane-dir",
|
|
823
|
+
"/tmp/pane"
|
|
824
|
+
],
|
|
825
|
+
[
|
|
826
|
+
"repos",
|
|
827
|
+
"add",
|
|
828
|
+
"--path",
|
|
829
|
+
"/tmp/repo",
|
|
830
|
+
"--name",
|
|
831
|
+
"Repo",
|
|
832
|
+
"--dry-run",
|
|
833
|
+
"--yes",
|
|
834
|
+
"--json",
|
|
835
|
+
"--pane-dir",
|
|
836
|
+
"/tmp/pane"
|
|
837
|
+
],
|
|
838
|
+
[
|
|
839
|
+
"panes",
|
|
840
|
+
"create",
|
|
841
|
+
"--repo",
|
|
842
|
+
"active",
|
|
843
|
+
"--name",
|
|
844
|
+
"issue-252",
|
|
845
|
+
"--agent",
|
|
846
|
+
"codex",
|
|
847
|
+
"--prompt",
|
|
848
|
+
"Kick off discussion",
|
|
849
|
+
"--dry-run",
|
|
850
|
+
"--yes",
|
|
851
|
+
"--json"
|
|
852
|
+
],
|
|
853
|
+
[
|
|
854
|
+
"panes",
|
|
855
|
+
"create",
|
|
856
|
+
"--from-json",
|
|
857
|
+
"-",
|
|
858
|
+
"--yes",
|
|
859
|
+
"--json"
|
|
860
|
+
],
|
|
515
861
|
[
|
|
516
862
|
"--version"
|
|
517
863
|
]
|
|
@@ -521,7 +867,11 @@ exports.RUNPANE_CONTRACT = {
|
|
|
521
867
|
"runpane install",
|
|
522
868
|
"runpane update",
|
|
523
869
|
"runpane version",
|
|
524
|
-
"runpane doctor"
|
|
870
|
+
"runpane doctor",
|
|
871
|
+
"runpane agent-context",
|
|
872
|
+
"runpane repos list",
|
|
873
|
+
"runpane repos add",
|
|
874
|
+
"runpane panes create"
|
|
525
875
|
],
|
|
526
876
|
"npmHelpIncludes": [
|
|
527
877
|
"pnpm dlx runpane@latest",
|
|
@@ -570,14 +920,887 @@ exports.RUNPANE_CONTRACT = {
|
|
|
570
920
|
},
|
|
571
921
|
"additionalProperties": false
|
|
572
922
|
},
|
|
573
|
-
"
|
|
923
|
+
"repoListResult": {
|
|
924
|
+
"type": "object",
|
|
925
|
+
"required": [
|
|
926
|
+
"ok",
|
|
927
|
+
"repos"
|
|
928
|
+
],
|
|
929
|
+
"properties": {
|
|
930
|
+
"ok": {
|
|
931
|
+
"const": true
|
|
932
|
+
},
|
|
933
|
+
"repos": {
|
|
934
|
+
"type": "array",
|
|
935
|
+
"items": {
|
|
936
|
+
"type": "object",
|
|
937
|
+
"required": [
|
|
938
|
+
"id",
|
|
939
|
+
"name",
|
|
940
|
+
"path",
|
|
941
|
+
"active",
|
|
942
|
+
"sessionCount"
|
|
943
|
+
],
|
|
944
|
+
"properties": {
|
|
945
|
+
"id": {
|
|
946
|
+
"type": "number"
|
|
947
|
+
},
|
|
948
|
+
"name": {
|
|
949
|
+
"type": "string"
|
|
950
|
+
},
|
|
951
|
+
"path": {
|
|
952
|
+
"type": "string"
|
|
953
|
+
},
|
|
954
|
+
"active": {
|
|
955
|
+
"type": "boolean"
|
|
956
|
+
},
|
|
957
|
+
"environment": {
|
|
958
|
+
"type": "string"
|
|
959
|
+
},
|
|
960
|
+
"sessionCount": {
|
|
961
|
+
"type": "number"
|
|
962
|
+
}
|
|
963
|
+
},
|
|
964
|
+
"additionalProperties": false
|
|
965
|
+
}
|
|
966
|
+
}
|
|
967
|
+
},
|
|
968
|
+
"additionalProperties": false
|
|
969
|
+
},
|
|
970
|
+
"repoAddRequest": {
|
|
574
971
|
"type": "object",
|
|
575
|
-
"
|
|
972
|
+
"required": [
|
|
973
|
+
"path"
|
|
974
|
+
],
|
|
975
|
+
"properties": {
|
|
976
|
+
"path": {
|
|
977
|
+
"type": "string"
|
|
978
|
+
},
|
|
979
|
+
"name": {
|
|
980
|
+
"type": "string"
|
|
981
|
+
},
|
|
982
|
+
"dryRun": {
|
|
983
|
+
"type": "boolean"
|
|
984
|
+
}
|
|
985
|
+
},
|
|
986
|
+
"additionalProperties": false
|
|
576
987
|
},
|
|
577
|
-
"
|
|
988
|
+
"repoAddResult": {
|
|
578
989
|
"type": "object",
|
|
579
|
-
"
|
|
990
|
+
"required": [
|
|
991
|
+
"ok",
|
|
992
|
+
"created"
|
|
993
|
+
],
|
|
994
|
+
"properties": {
|
|
995
|
+
"ok": {
|
|
996
|
+
"const": true
|
|
997
|
+
},
|
|
998
|
+
"created": {
|
|
999
|
+
"type": "boolean"
|
|
1000
|
+
},
|
|
1001
|
+
"dryRun": {
|
|
1002
|
+
"type": "boolean"
|
|
1003
|
+
},
|
|
1004
|
+
"repo": {
|
|
1005
|
+
"$ref": "#/jsonSchemas/repoListResult/properties/repos/items"
|
|
1006
|
+
},
|
|
1007
|
+
"preview": {
|
|
1008
|
+
"type": "object",
|
|
1009
|
+
"required": [
|
|
1010
|
+
"name",
|
|
1011
|
+
"path",
|
|
1012
|
+
"alreadyExists",
|
|
1013
|
+
"wouldCreate"
|
|
1014
|
+
],
|
|
1015
|
+
"properties": {
|
|
1016
|
+
"name": {
|
|
1017
|
+
"type": "string"
|
|
1018
|
+
},
|
|
1019
|
+
"path": {
|
|
1020
|
+
"type": "string"
|
|
1021
|
+
},
|
|
1022
|
+
"alreadyExists": {
|
|
1023
|
+
"type": "boolean"
|
|
1024
|
+
},
|
|
1025
|
+
"wouldCreate": {
|
|
1026
|
+
"type": "boolean"
|
|
1027
|
+
},
|
|
1028
|
+
"environment": {
|
|
1029
|
+
"type": "string"
|
|
1030
|
+
}
|
|
1031
|
+
},
|
|
1032
|
+
"additionalProperties": false
|
|
1033
|
+
}
|
|
1034
|
+
},
|
|
1035
|
+
"additionalProperties": false
|
|
1036
|
+
},
|
|
1037
|
+
"paneCreateRequest": {
|
|
1038
|
+
"type": "object",
|
|
1039
|
+
"required": [
|
|
1040
|
+
"repo",
|
|
1041
|
+
"panes"
|
|
1042
|
+
],
|
|
1043
|
+
"properties": {
|
|
1044
|
+
"repo": {
|
|
1045
|
+
"oneOf": [
|
|
1046
|
+
{
|
|
1047
|
+
"type": "string"
|
|
1048
|
+
},
|
|
1049
|
+
{
|
|
1050
|
+
"type": "object",
|
|
1051
|
+
"properties": {
|
|
1052
|
+
"id": {
|
|
1053
|
+
"type": "number"
|
|
1054
|
+
},
|
|
1055
|
+
"path": {
|
|
1056
|
+
"type": "string"
|
|
1057
|
+
},
|
|
1058
|
+
"name": {
|
|
1059
|
+
"type": "string"
|
|
1060
|
+
},
|
|
1061
|
+
"active": {
|
|
1062
|
+
"const": true
|
|
1063
|
+
}
|
|
1064
|
+
},
|
|
1065
|
+
"additionalProperties": false
|
|
1066
|
+
}
|
|
1067
|
+
]
|
|
1068
|
+
},
|
|
1069
|
+
"panes": {
|
|
1070
|
+
"type": "array",
|
|
1071
|
+
"minItems": 1,
|
|
1072
|
+
"items": {
|
|
1073
|
+
"type": "object",
|
|
1074
|
+
"required": [
|
|
1075
|
+
"name",
|
|
1076
|
+
"tool"
|
|
1077
|
+
],
|
|
1078
|
+
"properties": {
|
|
1079
|
+
"name": {
|
|
1080
|
+
"type": "string"
|
|
1081
|
+
},
|
|
1082
|
+
"worktreeName": {
|
|
1083
|
+
"type": "string"
|
|
1084
|
+
},
|
|
1085
|
+
"baseBranch": {
|
|
1086
|
+
"type": "string"
|
|
1087
|
+
},
|
|
1088
|
+
"sessionPrompt": {
|
|
1089
|
+
"type": "string"
|
|
1090
|
+
},
|
|
1091
|
+
"tool": {
|
|
1092
|
+
"oneOf": [
|
|
1093
|
+
{
|
|
1094
|
+
"type": "object",
|
|
1095
|
+
"required": [
|
|
1096
|
+
"agent"
|
|
1097
|
+
],
|
|
1098
|
+
"properties": {
|
|
1099
|
+
"agent": {
|
|
1100
|
+
"enum": [
|
|
1101
|
+
"codex",
|
|
1102
|
+
"claude"
|
|
1103
|
+
]
|
|
1104
|
+
},
|
|
1105
|
+
"title": {
|
|
1106
|
+
"type": "string"
|
|
1107
|
+
},
|
|
1108
|
+
"initialInput": {
|
|
1109
|
+
"type": "string"
|
|
1110
|
+
}
|
|
1111
|
+
},
|
|
1112
|
+
"additionalProperties": false
|
|
1113
|
+
},
|
|
1114
|
+
{
|
|
1115
|
+
"type": "object",
|
|
1116
|
+
"required": [
|
|
1117
|
+
"command"
|
|
1118
|
+
],
|
|
1119
|
+
"properties": {
|
|
1120
|
+
"command": {
|
|
1121
|
+
"type": "string"
|
|
1122
|
+
},
|
|
1123
|
+
"title": {
|
|
1124
|
+
"type": "string"
|
|
1125
|
+
},
|
|
1126
|
+
"initialInput": {
|
|
1127
|
+
"type": "string"
|
|
1128
|
+
}
|
|
1129
|
+
},
|
|
1130
|
+
"additionalProperties": false
|
|
1131
|
+
}
|
|
1132
|
+
]
|
|
1133
|
+
}
|
|
1134
|
+
},
|
|
1135
|
+
"additionalProperties": false
|
|
1136
|
+
}
|
|
1137
|
+
},
|
|
1138
|
+
"dryRun": {
|
|
1139
|
+
"type": "boolean"
|
|
1140
|
+
},
|
|
1141
|
+
"timeoutMs": {
|
|
1142
|
+
"type": "number"
|
|
1143
|
+
}
|
|
1144
|
+
},
|
|
1145
|
+
"additionalProperties": false
|
|
1146
|
+
},
|
|
1147
|
+
"paneCreateResult": {
|
|
1148
|
+
"type": "object",
|
|
1149
|
+
"required": [
|
|
1150
|
+
"ok",
|
|
1151
|
+
"repo",
|
|
1152
|
+
"items"
|
|
1153
|
+
],
|
|
1154
|
+
"properties": {
|
|
1155
|
+
"ok": {
|
|
1156
|
+
"type": "boolean"
|
|
1157
|
+
},
|
|
1158
|
+
"repo": {
|
|
1159
|
+
"$ref": "#/jsonSchemas/repoListResult/properties/repos/items"
|
|
1160
|
+
},
|
|
1161
|
+
"items": {
|
|
1162
|
+
"type": "array",
|
|
1163
|
+
"items": {
|
|
1164
|
+
"oneOf": [
|
|
1165
|
+
{
|
|
1166
|
+
"type": "object",
|
|
1167
|
+
"required": [
|
|
1168
|
+
"ok",
|
|
1169
|
+
"index",
|
|
1170
|
+
"name"
|
|
1171
|
+
],
|
|
1172
|
+
"properties": {
|
|
1173
|
+
"ok": {
|
|
1174
|
+
"const": true
|
|
1175
|
+
},
|
|
1176
|
+
"index": {
|
|
1177
|
+
"type": "number"
|
|
1178
|
+
},
|
|
1179
|
+
"name": {
|
|
1180
|
+
"type": "string"
|
|
1181
|
+
},
|
|
1182
|
+
"sessionId": {
|
|
1183
|
+
"type": "string"
|
|
1184
|
+
},
|
|
1185
|
+
"paneId": {
|
|
1186
|
+
"type": "string"
|
|
1187
|
+
},
|
|
1188
|
+
"panelId": {
|
|
1189
|
+
"type": "string"
|
|
1190
|
+
},
|
|
1191
|
+
"worktreePath": {
|
|
1192
|
+
"type": "string"
|
|
1193
|
+
},
|
|
1194
|
+
"tool": {
|
|
1195
|
+
"type": "object",
|
|
1196
|
+
"required": [
|
|
1197
|
+
"title",
|
|
1198
|
+
"command"
|
|
1199
|
+
],
|
|
1200
|
+
"properties": {
|
|
1201
|
+
"title": {
|
|
1202
|
+
"type": "string"
|
|
1203
|
+
},
|
|
1204
|
+
"command": {
|
|
1205
|
+
"type": "string"
|
|
1206
|
+
},
|
|
1207
|
+
"agent": {
|
|
1208
|
+
"enum": [
|
|
1209
|
+
"codex",
|
|
1210
|
+
"claude"
|
|
1211
|
+
]
|
|
1212
|
+
}
|
|
1213
|
+
},
|
|
1214
|
+
"additionalProperties": false
|
|
1215
|
+
}
|
|
1216
|
+
},
|
|
1217
|
+
"additionalProperties": false
|
|
1218
|
+
},
|
|
1219
|
+
{
|
|
1220
|
+
"type": "object",
|
|
1221
|
+
"required": [
|
|
1222
|
+
"ok",
|
|
1223
|
+
"index",
|
|
1224
|
+
"error"
|
|
1225
|
+
],
|
|
1226
|
+
"properties": {
|
|
1227
|
+
"ok": {
|
|
1228
|
+
"const": false
|
|
1229
|
+
},
|
|
1230
|
+
"index": {
|
|
1231
|
+
"type": "number"
|
|
1232
|
+
},
|
|
1233
|
+
"name": {
|
|
1234
|
+
"type": "string"
|
|
1235
|
+
},
|
|
1236
|
+
"error": {
|
|
1237
|
+
"type": "object",
|
|
1238
|
+
"required": [
|
|
1239
|
+
"message"
|
|
1240
|
+
],
|
|
1241
|
+
"properties": {
|
|
1242
|
+
"message": {
|
|
1243
|
+
"type": "string"
|
|
1244
|
+
},
|
|
1245
|
+
"code": {
|
|
1246
|
+
"type": "string"
|
|
1247
|
+
}
|
|
1248
|
+
},
|
|
1249
|
+
"additionalProperties": false
|
|
1250
|
+
}
|
|
1251
|
+
},
|
|
1252
|
+
"additionalProperties": false
|
|
1253
|
+
}
|
|
1254
|
+
]
|
|
1255
|
+
}
|
|
1256
|
+
}
|
|
1257
|
+
},
|
|
1258
|
+
"additionalProperties": false
|
|
1259
|
+
},
|
|
1260
|
+
"agentContextBriefResult": {
|
|
1261
|
+
"type": "object",
|
|
1262
|
+
"required": [
|
|
1263
|
+
"ok",
|
|
1264
|
+
"mode",
|
|
1265
|
+
"source",
|
|
1266
|
+
"summary",
|
|
1267
|
+
"rules",
|
|
1268
|
+
"tools",
|
|
1269
|
+
"detailCommand"
|
|
1270
|
+
],
|
|
1271
|
+
"properties": {
|
|
1272
|
+
"ok": {
|
|
1273
|
+
"const": true
|
|
1274
|
+
},
|
|
1275
|
+
"mode": {
|
|
1276
|
+
"const": "brief"
|
|
1277
|
+
},
|
|
1278
|
+
"source": {
|
|
1279
|
+
"const": "runpane-contract"
|
|
1280
|
+
},
|
|
1281
|
+
"summary": {
|
|
1282
|
+
"type": "string"
|
|
1283
|
+
},
|
|
1284
|
+
"rules": {
|
|
1285
|
+
"type": "array",
|
|
1286
|
+
"items": {
|
|
1287
|
+
"type": "string"
|
|
1288
|
+
}
|
|
1289
|
+
},
|
|
1290
|
+
"tools": {
|
|
1291
|
+
"type": "array",
|
|
1292
|
+
"items": {
|
|
1293
|
+
"type": "object",
|
|
1294
|
+
"required": [
|
|
1295
|
+
"name",
|
|
1296
|
+
"summary",
|
|
1297
|
+
"arguments"
|
|
1298
|
+
],
|
|
1299
|
+
"properties": {
|
|
1300
|
+
"name": {
|
|
1301
|
+
"type": "string"
|
|
1302
|
+
},
|
|
1303
|
+
"summary": {
|
|
1304
|
+
"type": "string"
|
|
1305
|
+
},
|
|
1306
|
+
"arguments": {
|
|
1307
|
+
"type": "array",
|
|
1308
|
+
"items": {
|
|
1309
|
+
"type": "string"
|
|
1310
|
+
}
|
|
1311
|
+
}
|
|
1312
|
+
},
|
|
1313
|
+
"additionalProperties": false
|
|
1314
|
+
}
|
|
1315
|
+
},
|
|
1316
|
+
"detailCommand": {
|
|
1317
|
+
"type": "string"
|
|
1318
|
+
}
|
|
1319
|
+
},
|
|
1320
|
+
"additionalProperties": false
|
|
1321
|
+
},
|
|
1322
|
+
"agentContextCommandResult": {
|
|
1323
|
+
"type": "object",
|
|
1324
|
+
"required": [
|
|
1325
|
+
"ok",
|
|
1326
|
+
"mode",
|
|
1327
|
+
"source",
|
|
1328
|
+
"command"
|
|
1329
|
+
],
|
|
1330
|
+
"properties": {
|
|
1331
|
+
"ok": {
|
|
1332
|
+
"const": true
|
|
1333
|
+
},
|
|
1334
|
+
"mode": {
|
|
1335
|
+
"const": "command"
|
|
1336
|
+
},
|
|
1337
|
+
"source": {
|
|
1338
|
+
"const": "runpane-contract"
|
|
1339
|
+
},
|
|
1340
|
+
"command": {
|
|
1341
|
+
"type": "object",
|
|
1342
|
+
"required": [
|
|
1343
|
+
"name",
|
|
1344
|
+
"summary",
|
|
1345
|
+
"details",
|
|
1346
|
+
"arguments",
|
|
1347
|
+
"examples"
|
|
1348
|
+
],
|
|
1349
|
+
"properties": {
|
|
1350
|
+
"name": {
|
|
1351
|
+
"type": "string"
|
|
1352
|
+
},
|
|
1353
|
+
"summary": {
|
|
1354
|
+
"type": "string"
|
|
1355
|
+
},
|
|
1356
|
+
"details": {
|
|
1357
|
+
"type": "string"
|
|
1358
|
+
},
|
|
1359
|
+
"requiresPaneDaemon": {
|
|
1360
|
+
"type": "boolean"
|
|
1361
|
+
},
|
|
1362
|
+
"mutates": {
|
|
1363
|
+
"type": "boolean"
|
|
1364
|
+
},
|
|
1365
|
+
"arguments": {
|
|
1366
|
+
"type": "array",
|
|
1367
|
+
"items": {
|
|
1368
|
+
"type": "object"
|
|
1369
|
+
}
|
|
1370
|
+
},
|
|
1371
|
+
"examples": {
|
|
1372
|
+
"type": "array",
|
|
1373
|
+
"items": {
|
|
1374
|
+
"type": "string"
|
|
1375
|
+
}
|
|
1376
|
+
},
|
|
1377
|
+
"jsonSchemas": {
|
|
1378
|
+
"type": "array",
|
|
1379
|
+
"items": {
|
|
1380
|
+
"type": "string"
|
|
1381
|
+
}
|
|
1382
|
+
},
|
|
1383
|
+
"notes": {
|
|
1384
|
+
"type": "array",
|
|
1385
|
+
"items": {
|
|
1386
|
+
"type": "string"
|
|
1387
|
+
}
|
|
1388
|
+
}
|
|
1389
|
+
},
|
|
1390
|
+
"additionalProperties": false
|
|
1391
|
+
}
|
|
1392
|
+
},
|
|
1393
|
+
"additionalProperties": false
|
|
580
1394
|
}
|
|
1395
|
+
},
|
|
1396
|
+
"agentContext": {
|
|
1397
|
+
"brief": {
|
|
1398
|
+
"title": "Pane agent context",
|
|
1399
|
+
"summary": "Pane lets a developer manage repositories and user-visible panes. Agents can use runpane to list/add Pane repositories and create panes with terminal-backed tools.",
|
|
1400
|
+
"rules": [
|
|
1401
|
+
"Start with `runpane repos list --json` to find the saved repository when unsure.",
|
|
1402
|
+
"If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.",
|
|
1403
|
+
"Use `runpane panes create` to create a Pane session and open a built-in agent or custom terminal command.",
|
|
1404
|
+
"Use `runpane agent-context --command <command>` for detailed command definitions only when needed."
|
|
1405
|
+
],
|
|
1406
|
+
"detailCommand": "runpane agent-context --command <command> [--json]",
|
|
1407
|
+
"tools": [
|
|
1408
|
+
{
|
|
1409
|
+
"name": "agent-context",
|
|
1410
|
+
"summary": "Print token-efficient Pane command context for coding agents.",
|
|
1411
|
+
"arguments": [
|
|
1412
|
+
"--command <command>",
|
|
1413
|
+
"--json"
|
|
1414
|
+
]
|
|
1415
|
+
},
|
|
1416
|
+
{
|
|
1417
|
+
"name": "repos list",
|
|
1418
|
+
"summary": "List repositories saved in the running Pane app.",
|
|
1419
|
+
"arguments": [
|
|
1420
|
+
"--json",
|
|
1421
|
+
"--pane-dir <path>"
|
|
1422
|
+
]
|
|
1423
|
+
},
|
|
1424
|
+
{
|
|
1425
|
+
"name": "repos add",
|
|
1426
|
+
"summary": "Register an existing git repository with the running Pane app.",
|
|
1427
|
+
"arguments": [
|
|
1428
|
+
"--path <path>",
|
|
1429
|
+
"--name <name>",
|
|
1430
|
+
"--yes",
|
|
1431
|
+
"--json",
|
|
1432
|
+
"--dry-run",
|
|
1433
|
+
"--pane-dir <path>"
|
|
1434
|
+
]
|
|
1435
|
+
},
|
|
1436
|
+
{
|
|
1437
|
+
"name": "panes create",
|
|
1438
|
+
"summary": "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.",
|
|
1439
|
+
"arguments": [
|
|
1440
|
+
"--repo <selector>",
|
|
1441
|
+
"--name <name>",
|
|
1442
|
+
"--agent <codex|claude>",
|
|
1443
|
+
"--tool-command <command>",
|
|
1444
|
+
"--prompt <text>",
|
|
1445
|
+
"--from-json <path|->",
|
|
1446
|
+
"--yes",
|
|
1447
|
+
"--json"
|
|
1448
|
+
]
|
|
1449
|
+
}
|
|
1450
|
+
]
|
|
1451
|
+
},
|
|
1452
|
+
"commands": {
|
|
1453
|
+
"help": {
|
|
1454
|
+
"name": "help",
|
|
1455
|
+
"summary": "Show help for runpane or a specific command.",
|
|
1456
|
+
"details": "Use this when you need human-readable usage text for a command.",
|
|
1457
|
+
"requiresPaneDaemon": false,
|
|
1458
|
+
"mutates": false,
|
|
1459
|
+
"arguments": [
|
|
1460
|
+
{
|
|
1461
|
+
"name": "command",
|
|
1462
|
+
"value": "<command>",
|
|
1463
|
+
"required": false,
|
|
1464
|
+
"description": "Optional command topic such as \"panes create\"."
|
|
1465
|
+
}
|
|
1466
|
+
],
|
|
1467
|
+
"examples": [
|
|
1468
|
+
"runpane help",
|
|
1469
|
+
"runpane help panes create"
|
|
1470
|
+
],
|
|
1471
|
+
"notes": [
|
|
1472
|
+
"Help text is generated from the runpane contract."
|
|
1473
|
+
]
|
|
1474
|
+
},
|
|
1475
|
+
"setup": {
|
|
1476
|
+
"name": "setup",
|
|
1477
|
+
"summary": "Open the guided setup wizard for install, remote host setup, update, and diagnostics.",
|
|
1478
|
+
"details": "Use this for a human-driven Pane setup flow, not for unattended agent orchestration.",
|
|
1479
|
+
"requiresPaneDaemon": false,
|
|
1480
|
+
"mutates": false,
|
|
1481
|
+
"arguments": [],
|
|
1482
|
+
"examples": [
|
|
1483
|
+
"runpane setup"
|
|
1484
|
+
],
|
|
1485
|
+
"notes": [
|
|
1486
|
+
"In non-interactive shells, setup prints help and exits successfully."
|
|
1487
|
+
]
|
|
1488
|
+
},
|
|
1489
|
+
"install": {
|
|
1490
|
+
"name": "install",
|
|
1491
|
+
"summary": "Install Pane on this machine or configure this machine as a remote daemon host.",
|
|
1492
|
+
"details": "Installs or launches Pane release artifacts at command runtime. `install daemon` forwards remote setup flags to Pane.",
|
|
1493
|
+
"requiresPaneDaemon": false,
|
|
1494
|
+
"mutates": true,
|
|
1495
|
+
"arguments": [
|
|
1496
|
+
{
|
|
1497
|
+
"name": "target",
|
|
1498
|
+
"value": "<client|daemon>",
|
|
1499
|
+
"required": false,
|
|
1500
|
+
"description": "Install the desktop client or configure a remote daemon host."
|
|
1501
|
+
},
|
|
1502
|
+
{
|
|
1503
|
+
"name": "--version",
|
|
1504
|
+
"value": "<latest|vX.Y.Z>",
|
|
1505
|
+
"required": false,
|
|
1506
|
+
"description": "Pane release to install."
|
|
1507
|
+
},
|
|
1508
|
+
{
|
|
1509
|
+
"name": "--format",
|
|
1510
|
+
"value": "<auto|appimage|deb|dmg|zip|exe>",
|
|
1511
|
+
"required": false,
|
|
1512
|
+
"description": "Release artifact format."
|
|
1513
|
+
},
|
|
1514
|
+
{
|
|
1515
|
+
"name": "--yes",
|
|
1516
|
+
"required": false,
|
|
1517
|
+
"description": "Skip interactive prompts where possible."
|
|
1518
|
+
}
|
|
1519
|
+
],
|
|
1520
|
+
"examples": [
|
|
1521
|
+
"runpane install client",
|
|
1522
|
+
"runpane install daemon --label \"My Server\""
|
|
1523
|
+
],
|
|
1524
|
+
"notes": [
|
|
1525
|
+
"Package install itself is inert; work begins only when runpane is executed."
|
|
1526
|
+
]
|
|
1527
|
+
},
|
|
1528
|
+
"update": {
|
|
1529
|
+
"name": "update",
|
|
1530
|
+
"summary": "Update the Pane desktop app using the same artifact path as install client.",
|
|
1531
|
+
"details": "Resolves and installs the selected Pane client release.",
|
|
1532
|
+
"requiresPaneDaemon": false,
|
|
1533
|
+
"mutates": true,
|
|
1534
|
+
"arguments": [
|
|
1535
|
+
{
|
|
1536
|
+
"name": "--version",
|
|
1537
|
+
"value": "<latest|vX.Y.Z>",
|
|
1538
|
+
"required": false,
|
|
1539
|
+
"description": "Pane release to update to."
|
|
1540
|
+
},
|
|
1541
|
+
{
|
|
1542
|
+
"name": "--format",
|
|
1543
|
+
"value": "<auto|appimage|deb|dmg|zip|exe>",
|
|
1544
|
+
"required": false,
|
|
1545
|
+
"description": "Release artifact format."
|
|
1546
|
+
},
|
|
1547
|
+
{
|
|
1548
|
+
"name": "--dry-run",
|
|
1549
|
+
"required": false,
|
|
1550
|
+
"description": "Print the update plan without downloading."
|
|
1551
|
+
}
|
|
1552
|
+
],
|
|
1553
|
+
"examples": [
|
|
1554
|
+
"runpane update",
|
|
1555
|
+
"runpane update --version latest"
|
|
1556
|
+
],
|
|
1557
|
+
"notes": [
|
|
1558
|
+
"Equivalent artifact selection to `runpane install client`."
|
|
1559
|
+
]
|
|
1560
|
+
},
|
|
1561
|
+
"version": {
|
|
1562
|
+
"name": "version",
|
|
1563
|
+
"summary": "Print the runpane wrapper version and installed Pane version when detectable.",
|
|
1564
|
+
"details": "Use this for diagnostics or to confirm which wrapper is available.",
|
|
1565
|
+
"requiresPaneDaemon": false,
|
|
1566
|
+
"mutates": false,
|
|
1567
|
+
"arguments": [
|
|
1568
|
+
{
|
|
1569
|
+
"name": "--pane-path",
|
|
1570
|
+
"value": "<path>",
|
|
1571
|
+
"required": false,
|
|
1572
|
+
"description": "Inspect a specific Pane executable."
|
|
1573
|
+
}
|
|
1574
|
+
],
|
|
1575
|
+
"examples": [
|
|
1576
|
+
"runpane version",
|
|
1577
|
+
"runpane --version"
|
|
1578
|
+
],
|
|
1579
|
+
"notes": []
|
|
1580
|
+
},
|
|
1581
|
+
"doctor": {
|
|
1582
|
+
"name": "doctor",
|
|
1583
|
+
"summary": "Run platform, release, installed Pane, and remote setup diagnostics.",
|
|
1584
|
+
"details": "Use this when runpane install/update behavior needs environment diagnostics.",
|
|
1585
|
+
"requiresPaneDaemon": false,
|
|
1586
|
+
"mutates": false,
|
|
1587
|
+
"arguments": [
|
|
1588
|
+
{
|
|
1589
|
+
"name": "--pane-path",
|
|
1590
|
+
"value": "<path>",
|
|
1591
|
+
"required": false,
|
|
1592
|
+
"description": "Use an existing Pane executable for diagnostics."
|
|
1593
|
+
},
|
|
1594
|
+
{
|
|
1595
|
+
"name": "--verbose",
|
|
1596
|
+
"required": false,
|
|
1597
|
+
"description": "Print extra diagnostics."
|
|
1598
|
+
}
|
|
1599
|
+
],
|
|
1600
|
+
"examples": [
|
|
1601
|
+
"runpane doctor",
|
|
1602
|
+
"runpane doctor --verbose"
|
|
1603
|
+
],
|
|
1604
|
+
"notes": []
|
|
1605
|
+
},
|
|
1606
|
+
"agent-context": {
|
|
1607
|
+
"name": "agent-context",
|
|
1608
|
+
"summary": "Print token-efficient Pane command context for coding agents.",
|
|
1609
|
+
"details": "Use this first when an agent needs to discover Pane primitives. It is local/offline and does not require a running Pane app.",
|
|
1610
|
+
"requiresPaneDaemon": false,
|
|
1611
|
+
"mutates": false,
|
|
1612
|
+
"arguments": [
|
|
1613
|
+
{
|
|
1614
|
+
"name": "--command",
|
|
1615
|
+
"value": "<command>",
|
|
1616
|
+
"required": false,
|
|
1617
|
+
"description": "Print the detailed definition for one command, for example \"panes create\"."
|
|
1618
|
+
},
|
|
1619
|
+
{
|
|
1620
|
+
"name": "--json",
|
|
1621
|
+
"required": false,
|
|
1622
|
+
"description": "Print machine-readable output."
|
|
1623
|
+
}
|
|
1624
|
+
],
|
|
1625
|
+
"examples": [
|
|
1626
|
+
"runpane agent-context",
|
|
1627
|
+
"runpane agent-context --command \"panes create\" --json"
|
|
1628
|
+
],
|
|
1629
|
+
"jsonSchemas": [
|
|
1630
|
+
"agentContextBriefResult",
|
|
1631
|
+
"agentContextCommandResult"
|
|
1632
|
+
],
|
|
1633
|
+
"notes": [
|
|
1634
|
+
"Default output is brief so AGENTS.md can point here without bloating context."
|
|
1635
|
+
]
|
|
1636
|
+
},
|
|
1637
|
+
"repos list": {
|
|
1638
|
+
"name": "repos list",
|
|
1639
|
+
"summary": "List repositories saved in the running Pane app.",
|
|
1640
|
+
"details": "Use this to find the right Pane-managed repository before creating panes. If the repo is missing, use `repos add` first.",
|
|
1641
|
+
"requiresPaneDaemon": true,
|
|
1642
|
+
"mutates": false,
|
|
1643
|
+
"arguments": [
|
|
1644
|
+
{
|
|
1645
|
+
"name": "--json",
|
|
1646
|
+
"required": false,
|
|
1647
|
+
"description": "Print machine-readable repository records."
|
|
1648
|
+
},
|
|
1649
|
+
{
|
|
1650
|
+
"name": "--pane-dir",
|
|
1651
|
+
"value": "<path>",
|
|
1652
|
+
"required": false,
|
|
1653
|
+
"description": "Connect to a specific Pane data directory."
|
|
1654
|
+
}
|
|
1655
|
+
],
|
|
1656
|
+
"examples": [
|
|
1657
|
+
"runpane repos list --json"
|
|
1658
|
+
],
|
|
1659
|
+
"jsonSchemas": [
|
|
1660
|
+
"repoListResult"
|
|
1661
|
+
],
|
|
1662
|
+
"notes": [
|
|
1663
|
+
"Requires a running Pane app or daemon for the selected Pane data directory."
|
|
1664
|
+
]
|
|
1665
|
+
},
|
|
1666
|
+
"repos add": {
|
|
1667
|
+
"name": "repos add",
|
|
1668
|
+
"summary": "Register an existing git repository with the running Pane app.",
|
|
1669
|
+
"details": "Use this when the repository exists on disk but is not saved in Pane yet. It validates the path as a git repository.",
|
|
1670
|
+
"requiresPaneDaemon": true,
|
|
1671
|
+
"mutates": true,
|
|
1672
|
+
"arguments": [
|
|
1673
|
+
{
|
|
1674
|
+
"name": "--path",
|
|
1675
|
+
"value": "<path>",
|
|
1676
|
+
"required": true,
|
|
1677
|
+
"description": "Existing git repository path to register with Pane."
|
|
1678
|
+
},
|
|
1679
|
+
{
|
|
1680
|
+
"name": "--name",
|
|
1681
|
+
"value": "<name>",
|
|
1682
|
+
"required": false,
|
|
1683
|
+
"description": "Saved repository name; defaults to the directory name."
|
|
1684
|
+
},
|
|
1685
|
+
{
|
|
1686
|
+
"name": "--yes",
|
|
1687
|
+
"required": false,
|
|
1688
|
+
"description": "Skip confirmation for mutating commands."
|
|
1689
|
+
},
|
|
1690
|
+
{
|
|
1691
|
+
"name": "--json",
|
|
1692
|
+
"required": false,
|
|
1693
|
+
"description": "Print machine-readable output."
|
|
1694
|
+
},
|
|
1695
|
+
{
|
|
1696
|
+
"name": "--dry-run",
|
|
1697
|
+
"required": false,
|
|
1698
|
+
"description": "Validate and preview without adding the repo."
|
|
1699
|
+
},
|
|
1700
|
+
{
|
|
1701
|
+
"name": "--pane-dir",
|
|
1702
|
+
"value": "<path>",
|
|
1703
|
+
"required": false,
|
|
1704
|
+
"description": "Connect to a specific Pane data directory."
|
|
1705
|
+
}
|
|
1706
|
+
],
|
|
1707
|
+
"examples": [
|
|
1708
|
+
"runpane repos add --path /path/to/repo --yes --json"
|
|
1709
|
+
],
|
|
1710
|
+
"jsonSchemas": [
|
|
1711
|
+
"repoAddRequest",
|
|
1712
|
+
"repoAddResult"
|
|
1713
|
+
],
|
|
1714
|
+
"notes": [
|
|
1715
|
+
"It does not create directories or initialize git repositories by default."
|
|
1716
|
+
]
|
|
1717
|
+
},
|
|
1718
|
+
"panes create": {
|
|
1719
|
+
"name": "panes create",
|
|
1720
|
+
"summary": "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.",
|
|
1721
|
+
"details": "Use this to set up user-visible panes for work. Select a saved repository, choose a built-in agent or custom terminal command, and optionally send initial input after the tool starts.",
|
|
1722
|
+
"requiresPaneDaemon": true,
|
|
1723
|
+
"mutates": true,
|
|
1724
|
+
"arguments": [
|
|
1725
|
+
{
|
|
1726
|
+
"name": "--repo",
|
|
1727
|
+
"value": "<selector>",
|
|
1728
|
+
"required": true,
|
|
1729
|
+
"description": "Repository selector: active, id, exact path, or saved repository name."
|
|
1730
|
+
},
|
|
1731
|
+
{
|
|
1732
|
+
"name": "--name",
|
|
1733
|
+
"value": "<name>",
|
|
1734
|
+
"required": true,
|
|
1735
|
+
"description": "Pane/session name."
|
|
1736
|
+
},
|
|
1737
|
+
{
|
|
1738
|
+
"name": "--agent",
|
|
1739
|
+
"value": "<codex|claude>",
|
|
1740
|
+
"required": false,
|
|
1741
|
+
"description": "Built-in agent terminal template to open."
|
|
1742
|
+
},
|
|
1743
|
+
{
|
|
1744
|
+
"name": "--tool-command",
|
|
1745
|
+
"value": "<command>",
|
|
1746
|
+
"required": false,
|
|
1747
|
+
"description": "Custom terminal command to run instead of a built-in agent."
|
|
1748
|
+
},
|
|
1749
|
+
{
|
|
1750
|
+
"name": "--prompt",
|
|
1751
|
+
"value": "<text>",
|
|
1752
|
+
"required": false,
|
|
1753
|
+
"description": "Alias for --initial-input; sends text after the command is ready."
|
|
1754
|
+
},
|
|
1755
|
+
{
|
|
1756
|
+
"name": "--initial-input-file",
|
|
1757
|
+
"value": "<path|->",
|
|
1758
|
+
"required": false,
|
|
1759
|
+
"description": "Read initial input from a file or stdin."
|
|
1760
|
+
},
|
|
1761
|
+
{
|
|
1762
|
+
"name": "--from-json",
|
|
1763
|
+
"value": "<path|->",
|
|
1764
|
+
"required": false,
|
|
1765
|
+
"description": "Read a full panes.create request JSON payload."
|
|
1766
|
+
},
|
|
1767
|
+
{
|
|
1768
|
+
"name": "--yes",
|
|
1769
|
+
"required": false,
|
|
1770
|
+
"description": "Skip confirmation for mutating commands."
|
|
1771
|
+
},
|
|
1772
|
+
{
|
|
1773
|
+
"name": "--json",
|
|
1774
|
+
"required": false,
|
|
1775
|
+
"description": "Print machine-readable output."
|
|
1776
|
+
}
|
|
1777
|
+
],
|
|
1778
|
+
"examples": [
|
|
1779
|
+
"runpane panes create --repo active --name issue-257 --agent codex --prompt \"Plan this issue\" --yes",
|
|
1780
|
+
"runpane panes create --from-json panes.json --yes --json"
|
|
1781
|
+
],
|
|
1782
|
+
"jsonSchemas": [
|
|
1783
|
+
"paneCreateRequest",
|
|
1784
|
+
"paneCreateResult"
|
|
1785
|
+
],
|
|
1786
|
+
"notes": [
|
|
1787
|
+
"At least one of --agent or --tool-command is required unless --from-json is used.",
|
|
1788
|
+
"The built-in agent templates come from the runpane contract; custom terminal commands can pass agent-specific flags when requested by the user."
|
|
1789
|
+
]
|
|
1790
|
+
}
|
|
1791
|
+
},
|
|
1792
|
+
"managedBlock": [
|
|
1793
|
+
"## Pane",
|
|
1794
|
+
"",
|
|
1795
|
+
"The developer is using Pane for this repository. Pane can manage saved repositories and create user-visible panes with terminal-backed tools for planning, discussion, and implementation work.",
|
|
1796
|
+
"",
|
|
1797
|
+
"Use `runpane agent-context` for a brief Pane command schema. Use `runpane agent-context --command \"panes create\"` or another command name for the detailed schema only when needed.",
|
|
1798
|
+
"",
|
|
1799
|
+
"Common commands:",
|
|
1800
|
+
"- `runpane repos list --json`",
|
|
1801
|
+
"- `runpane repos add --path <repo> --yes --json`",
|
|
1802
|
+
"- `runpane panes create --repo active --name <name> --agent codex --prompt \"<task>\" --yes`"
|
|
1803
|
+
]
|
|
581
1804
|
}
|
|
582
1805
|
};
|
|
583
1806
|
//# sourceMappingURL=contract.js.map
|