runpane 2.3.16 → 2.3.18

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.
Files changed (19) hide show
  1. package/dist/cli.d.ts.map +1 -1
  2. package/dist/cli.js +3 -0
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands.d.ts +1 -0
  5. package/dist/commands.d.ts.map +1 -1
  6. package/dist/commands.js +19 -0
  7. package/dist/commands.js.map +1 -1
  8. package/dist/generated/contract.d.ts +91 -24
  9. package/dist/generated/contract.d.ts.map +1 -1
  10. package/dist/generated/contract.js +201 -24
  11. package/dist/generated/contract.js.map +1 -1
  12. package/dist/localControl.d.ts.map +1 -1
  13. package/dist/localControl.js +43 -3
  14. package/dist/localControl.js.map +1 -1
  15. package/dist/version.d.ts +1 -1
  16. package/dist/version.d.ts.map +1 -1
  17. package/dist/version.js +1 -20
  18. package/dist/version.js.map +1 -1
  19. package/package.json +1 -1
package/dist/generated/contract.js CHANGED
@@ -103,7 +103,7 @@ exports.RUNPANE_CONTRACT = {
103
103
  },
104
104
  {
105
105
  "name": "version",
106
- "summary": "Print the runpane wrapper version and installed Pane version when detectable.",
106
+ "summary": "Print the runpane wrapper version without contacting, launching, or focusing Pane.",
107
107
  "usage": [
108
108
  "runpane version",
109
109
  "runpane --version"
@@ -177,7 +177,7 @@ exports.RUNPANE_CONTRACT = {
177
177
  "name": "panes create",
178
178
  "summary": "Create one or more Pane sessions in a saved repository and open a terminal-backed tool tab.",
179
179
  "usage": [
180
- "runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]",
180
+ "runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [options]",
181
181
  "runpane panes create --from-json <path|-> [--yes] [--json]"
182
182
  ],
183
183
  "mutates": true,
@@ -190,8 +190,8 @@ exports.RUNPANE_CONTRACT = {
190
190
  "name": "panels create",
191
191
  "summary": "Create a terminal-backed tool panel inside an existing Pane session.",
192
192
  "usage": [
193
- "runpane panels create --pane <pane-id> --agent <codex|claude> [--no-focus] [--wait-ready] --yes [--json]",
194
- "runpane panels create --pane <pane-id> --tool-command <command> [--title <title>] [--no-focus] --yes [--json]"
193
+ "runpane panels create --pane <pane-id> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready] --yes [--json]",
194
+ "runpane panels create --pane <pane-id> --tool-command <command> [--title <title>] [--focus|--no-focus] --yes [--json]"
195
195
  ],
196
196
  "mutates": true,
197
197
  "jsonSchemas": [
@@ -506,7 +506,11 @@ exports.RUNPANE_CONTRACT = {
506
506
  },
507
507
  {
508
508
  "name": "--no-focus",
509
- "description": "Create the panel in the background without changing the active panel."
509
+ "description": "Create the pane or panel in the background without changing focus."
510
+ },
511
+ {
512
+ "name": "--focus",
513
+ "description": "Explicitly focus the created pane or panel."
510
514
  }
511
515
  ]
512
516
  },
@@ -525,14 +529,15 @@ exports.RUNPANE_CONTRACT = {
525
529
  " runpane repos list [--json]",
526
530
  " runpane repos add --path <path> [--name <name>]",
527
531
  " runpane panes list [--repo <selector>] [--json]",
528
- " runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--wait-ready]",
529
- " runpane panels create --pane <pane-id> --agent codex --no-focus --yes",
532
+ " runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready]",
533
+ " runpane panels create --pane <pane-id> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] --yes",
530
534
  " runpane panels list --pane <pane-id> [--json]",
531
535
  " runpane panels output --panel <panel-id> [--limit <count>] [--json]",
532
536
  " runpane panels screen --panel <panel-id> [--limit <count>] [--json]",
533
- " runpane panels input --panel <panel-id> --input-file <path|-> --yes",
534
- " runpane panels submit --panel <panel-id> --text <text> --yes",
535
- " runpane panels wait --panel <panel-id> [--for ready|idle|text] [--json]",
537
+ " runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
538
+ " runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
539
+ " runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]",
540
+ " runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]",
536
541
  " runpane help [command]",
537
542
  "",
538
543
  "Quick start:",
@@ -660,6 +665,18 @@ exports.RUNPANE_CONTRACT = {
660
665
  " --dry-run Validate and preview without adding the repo",
661
666
  " --yes Skip confirmation for mutating commands"
662
667
  ],
668
+ "panes": [
669
+ "Pane session commands.",
670
+ "",
671
+ "Usage:",
672
+ " runpane panes <command> [options]",
673
+ "",
674
+ "Commands:",
675
+ " runpane panes list [--repo <selector>] [--json]",
676
+ " runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]",
677
+ "",
678
+ "Run \"runpane help panes list\" or \"runpane help panes create\" for command-specific options."
679
+ ],
663
680
  "panes list": [
664
681
  "Usage:",
665
682
  " runpane panes list [--repo <selector>] [--json]",
@@ -694,11 +711,32 @@ exports.RUNPANE_CONTRACT = {
694
711
  " --wait-ready Wait for terminal readiness before returning",
695
712
  " --ready-timeout-ms <ms> Readiness wait timeout; defaults to 30000",
696
713
  " --concurrency <count> Accepted; creation is currently serialized",
714
+ " --source <user|agent> Mark mutation source; agent implies background creation",
715
+ " --no-focus Create in the background without stealing focus",
716
+ " --focus Explicitly focus the created pane",
697
717
  " --pane-dir <path> Connect to a specific Pane data directory",
698
718
  " --json Print machine-readable output",
699
719
  " --dry-run Validate and preview without creating panes",
700
720
  " --yes Skip confirmation for mutating commands"
701
721
  ],
722
+ "panels": [
723
+ "Terminal-backed panel commands.",
724
+ "",
725
+ "Usage:",
726
+ " runpane panels <command> [options]",
727
+ "",
728
+ "Commands:",
729
+ " runpane panels create --pane <pane-id> --agent <codex|claude> [options]",
730
+ " runpane panels list --pane <pane-id> [--json]",
731
+ " runpane panels screen --panel <panel-id> [--limit <count>] [--json]",
732
+ " runpane panels output --panel <panel-id> [--limit <count>] [--json]",
733
+ " runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
734
+ " runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
735
+ " runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]",
736
+ " runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]",
737
+ "",
738
+ "Run \"runpane help panels create\" or another command-specific topic for options."
739
+ ],
702
740
  "panels list": [
703
741
  "Usage:",
704
742
  " runpane panels list --pane <pane-id> [--json]",
@@ -821,6 +859,7 @@ exports.RUNPANE_CONTRACT = {
821
859
  " --initial-input, --prompt Initial input to send after the tool starts.",
822
860
  " --initial-input-file <path|-> Read initial input from a file or stdin.",
823
861
  " --no-focus Create the panel in the background.",
862
+ " --focus Explicitly focus the created panel.",
824
863
  " --source <user|agent> Mark the mutation source; agent implies background creation.",
825
864
  " --wait-ready Wait until the terminal tool is ready.",
826
865
  " --ready-timeout-ms <ms> Readiness wait timeout.",
@@ -854,14 +893,15 @@ exports.RUNPANE_CONTRACT = {
854
893
  " runpane repos list [--json]",
855
894
  " runpane repos add --path <path> [--name <name>]",
856
895
  " runpane panes list [--repo <selector>] [--json]",
857
- " runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--wait-ready]",
858
- " python -m runpane panels create --pane <pane-id> --agent codex --no-focus --yes",
896
+ " runpane panes create --repo <selector> --name <name> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] [--wait-ready]",
897
+ " python -m runpane panels create --pane <pane-id> --agent <codex|claude> [--source user|agent] [--focus|--no-focus] --yes",
859
898
  " runpane panels list --pane <pane-id> [--json]",
860
899
  " runpane panels output --panel <panel-id> [--limit <count>] [--json]",
861
900
  " runpane panels screen --panel <panel-id> [--limit <count>] [--json]",
862
- " runpane panels input --panel <panel-id> --input-file <path|-> --yes",
863
- " runpane panels submit --panel <panel-id> --text <text> --yes",
864
- " runpane panels wait --panel <panel-id> [--for ready|idle|text] [--json]",
901
+ " runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
902
+ " runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
903
+ " runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]",
904
+ " runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]",
865
905
  " runpane help [command]",
866
906
  "",
867
907
  "Quick start:",
@@ -978,6 +1018,18 @@ exports.RUNPANE_CONTRACT = {
978
1018
  " --dry-run",
979
1019
  " --yes"
980
1020
  ],
1021
+ "panes": [
1022
+ "Pane session commands.",
1023
+ "",
1024
+ "Usage:",
1025
+ " runpane panes <command> [options]",
1026
+ "",
1027
+ "Commands:",
1028
+ " runpane panes list [--repo <selector>] [--json]",
1029
+ " runpane panes create --repo <selector> --name <name> --agent <codex|claude> [options]",
1030
+ "",
1031
+ "Run \"runpane help panes list\" or \"runpane help panes create\" for command-specific options."
1032
+ ],
981
1033
  "panes list": [
982
1034
  "Usage:",
983
1035
  " runpane panes list [--repo <selector>] [--json]",
@@ -1012,11 +1064,32 @@ exports.RUNPANE_CONTRACT = {
1012
1064
  " --wait-ready Wait for terminal readiness before returning",
1013
1065
  " --ready-timeout-ms <ms> Readiness wait timeout; defaults to 30000",
1014
1066
  " --concurrency <count> Accepted; creation is currently serialized",
1067
+ " --source <user|agent> Mark mutation source; agent implies background creation",
1068
+ " --no-focus Create in the background without stealing focus",
1069
+ " --focus Explicitly focus the created pane",
1015
1070
  " --pane-dir <path> Connect to a specific Pane data directory",
1016
1071
  " --json Print machine-readable output",
1017
1072
  " --dry-run Validate and preview without creating panes",
1018
1073
  " --yes Skip confirmation for mutating commands"
1019
1074
  ],
1075
+ "panels": [
1076
+ "Terminal-backed panel commands.",
1077
+ "",
1078
+ "Usage:",
1079
+ " runpane panels <command> [options]",
1080
+ "",
1081
+ "Commands:",
1082
+ " runpane panels create --pane <pane-id> --agent <codex|claude> [options]",
1083
+ " runpane panels list --pane <pane-id> [--json]",
1084
+ " runpane panels screen --panel <panel-id> [--limit <count>] [--json]",
1085
+ " runpane panels output --panel <panel-id> [--limit <count>] [--json]",
1086
+ " runpane panels input --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
1087
+ " runpane panels submit --panel <panel-id> (--text <text>|--input-file <path|->) --yes [--json]",
1088
+ " runpane panels submit-composer --panel <panel-id> [--strategy auto|codex-ctrl-enter|enter] --yes [--json]",
1089
+ " runpane panels wait --panel <panel-id> [--for initialized|ready|idle|text] [--json]",
1090
+ "",
1091
+ "Run \"runpane help panels create\" or another command-specific topic for options."
1092
+ ],
1020
1093
  "panels list": [
1021
1094
  "Usage:",
1022
1095
  " runpane panels list --pane <pane-id> [--json]",
@@ -1139,6 +1212,7 @@ exports.RUNPANE_CONTRACT = {
1139
1212
  " --initial-input, --prompt Initial input to send after the tool starts.",
1140
1213
  " --initial-input-file <path|-> Read initial input from a file or stdin.",
1141
1214
  " --no-focus Create the panel in the background.",
1215
+ " --focus Explicitly focus the created panel.",
1142
1216
  " --source <user|agent> Mark the mutation source; agent implies background creation.",
1143
1217
  " --wait-ready Wait until the terminal tool is ready.",
1144
1218
  " --ready-timeout-ms <ms> Readiness wait timeout.",
@@ -1242,14 +1316,14 @@ exports.RUNPANE_CONTRACT = {
1242
1316
  "`runpane install daemon` downloads or installs Pane, resolves a stable Pane executable path, and spawns `<pane executable> --remote-setup <forwarded remote setup args>`.",
1243
1317
  "The wrapper must stream Pane stdout/stderr without reformatting because `pane --remote-setup` prints the one-time `pane-remote://...` connection code.",
1244
1318
  "`runpane update` uses the same release resolution and installer path as `install client`.",
1245
- "`runpane version` prints the wrapper package version, the installed Pane version when detectable, and the latest GitHub release version when reachable.",
1319
+ "`runpane version` prints only wrapper package metadata and does not contact, launch, or focus the Pane app or daemon.",
1246
1320
  "`runpane doctor` checks platform support, release metadata reachability, download URL selection, installed Pane detection, daemon reachability, and remote-daemon hints. Add `--json` for a machine-readable report that agents should run before mutating Pane state.",
1247
1321
  "`runpane agent-context` prints a brief, token-efficient command schema for coding agents without connecting to the Pane daemon.",
1248
1322
  "`runpane agent-context --command \"panes create\"` prints the detailed definition for one command. Add `--json` for machine-readable output.",
1249
1323
  "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.",
1250
1324
  "`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.",
1251
1325
  "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.",
1252
- "`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.",
1326
+ "`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. Built-in agent panes and `--source agent` default to background/no-focus unless `--focus` is passed.",
1253
1327
  "`runpane panels list` lists tool panels inside one Pane session.",
1254
1328
  "`runpane panels output` reads bounded recent terminal output from one panel and strips common terminal control noise for agent use.",
1255
1329
  "`runpane panels input` sends exact input bytes to one terminal panel. Prefer `--input-file` for newlines, Ctrl-C, quotes, or shell-sensitive text.",
@@ -1389,6 +1463,8 @@ exports.RUNPANE_CONTRACT = {
1389
1463
  "codex",
1390
1464
  "--prompt",
1391
1465
  "Kick off discussion",
1466
+ "--source",
1467
+ "agent",
1392
1468
  "--dry-run",
1393
1469
  "--yes",
1394
1470
  "--json"
@@ -1444,6 +1520,9 @@ exports.RUNPANE_CONTRACT = {
1444
1520
  "create",
1445
1521
  "--from-json",
1446
1522
  "-",
1523
+ "--source",
1524
+ "agent",
1525
+ "--focus",
1447
1526
  "--wait-ready",
1448
1527
  "--ready-timeout-ms",
1449
1528
  "45000",
@@ -1502,6 +1581,17 @@ exports.RUNPANE_CONTRACT = {
1502
1581
  "--yes",
1503
1582
  "--json"
1504
1583
  ],
1584
+ [
1585
+ "panels",
1586
+ "create",
1587
+ "--pane",
1588
+ "pane-1",
1589
+ "--agent",
1590
+ "codex",
1591
+ "--focus",
1592
+ "--yes",
1593
+ "--json"
1594
+ ],
1505
1595
  [
1506
1596
  "panels",
1507
1597
  "submit-composer",
@@ -1524,12 +1614,14 @@ exports.RUNPANE_CONTRACT = {
1524
1614
  "runpane repos add",
1525
1615
  "runpane panes list",
1526
1616
  "runpane panes create",
1617
+ "runpane panels create",
1527
1618
  "runpane panels list",
1528
1619
  "runpane panels output",
1529
1620
  "runpane panels input",
1530
1621
  "runpane agents doctor",
1531
1622
  "runpane panels screen",
1532
1623
  "runpane panels submit",
1624
+ "runpane panels submit-composer",
1533
1625
  "runpane panels wait",
1534
1626
  "runpane doctor --json",
1535
1627
  "runpane agent-context --json",
@@ -1974,6 +2066,18 @@ exports.RUNPANE_CONTRACT = {
1974
2066
  },
1975
2067
  "concurrency": {
1976
2068
  "type": "number"
2069
+ },
2070
+ "noFocus": {
2071
+ "type": "boolean"
2072
+ },
2073
+ "focus": {
2074
+ "type": "boolean"
2075
+ },
2076
+ "source": {
2077
+ "enum": [
2078
+ "user",
2079
+ "agent"
2080
+ ]
1977
2081
  }
1978
2082
  },
1979
2083
  "additionalProperties": false
@@ -2050,6 +2154,12 @@ exports.RUNPANE_CONTRACT = {
2050
2154
  },
2051
2155
  "additionalProperties": false
2052
2156
  },
2157
+ "active": {
2158
+ "type": "boolean"
2159
+ },
2160
+ "focused": {
2161
+ "type": "boolean"
2162
+ },
2053
2163
  "readiness": {
2054
2164
  "type": "object",
2055
2165
  "required": [
@@ -2922,6 +3032,9 @@ exports.RUNPANE_CONTRACT = {
2922
3032
  "noFocus": {
2923
3033
  "type": "boolean"
2924
3034
  },
3035
+ "focus": {
3036
+ "type": "boolean"
3037
+ },
2925
3038
  "source": {
2926
3039
  "enum": [
2927
3040
  "user",
@@ -2945,6 +3058,7 @@ exports.RUNPANE_CONTRACT = {
2945
3058
  "panelId",
2946
3059
  "title",
2947
3060
  "active",
3061
+ "focused",
2948
3062
  "tool"
2949
3063
  ],
2950
3064
  "properties": {
@@ -2963,6 +3077,9 @@ exports.RUNPANE_CONTRACT = {
2963
3077
  "active": {
2964
3078
  "type": "boolean"
2965
3079
  },
3080
+ "focused": {
3081
+ "type": "boolean"
3082
+ },
2966
3083
  "tool": {
2967
3084
  "type": "object",
2968
3085
  "required": [
@@ -3113,11 +3230,13 @@ exports.RUNPANE_CONTRACT = {
3113
3230
  "panelId",
3114
3231
  "inputBytes",
3115
3232
  "strategy",
3233
+ "sequenceName",
3234
+ "verifiedSubmitted",
3116
3235
  "sentAt"
3117
3236
  ],
3118
3237
  "properties": {
3119
3238
  "ok": {
3120
- "const": true
3239
+ "type": "boolean"
3121
3240
  },
3122
3241
  "panelId": {
3123
3242
  "type": "string"
@@ -3134,9 +3253,41 @@ exports.RUNPANE_CONTRACT = {
3134
3253
  "enter"
3135
3254
  ]
3136
3255
  },
3256
+ "sequenceName": {
3257
+ "enum": [
3258
+ "codex-ctrl-enter-cr",
3259
+ "enter-cr"
3260
+ ]
3261
+ },
3262
+ "verifiedSubmitted": {
3263
+ "type": "boolean"
3264
+ },
3137
3265
  "sentAt": {
3138
3266
  "type": "string"
3139
3267
  },
3268
+ "blocked": {
3269
+ "type": "object",
3270
+ "required": [
3271
+ "kind",
3272
+ "message"
3273
+ ],
3274
+ "properties": {
3275
+ "kind": {
3276
+ "enum": [
3277
+ "codex-update",
3278
+ "agent-prompt",
3279
+ "unknown"
3280
+ ]
3281
+ },
3282
+ "message": {
3283
+ "type": "string"
3284
+ },
3285
+ "suggestedCommand": {
3286
+ "type": "string"
3287
+ }
3288
+ },
3289
+ "additionalProperties": false
3290
+ },
3140
3291
  "nextCommand": {
3141
3292
  "type": "string"
3142
3293
  }
@@ -3156,7 +3307,7 @@ exports.RUNPANE_CONTRACT = {
3156
3307
  "If the repository exists on disk but is not saved in Pane, use `runpane repos add --path <repo> --yes --json` before creating panes.",
3157
3308
  "Use `runpane agents doctor --agent <codex|claude> --repo <selector> --json` when agent availability differs across host, Windows, WSL, or repo environments.",
3158
3309
  "Use `runpane panes create --wait-ready` to create panes and validate initial terminal readiness in one call.",
3159
- "Use `runpane panels screen` for compact current state, `panels wait` for readiness/text checks, and `panels submit` for ordinary Enter-submitted input.",
3310
+ "Use `runpane panels screen` for compact current state, `panels wait` for readiness/text checks, `panels submit` for ordinary Enter-submitted input, and `panels submit-composer --strategy auto` for agent composers.",
3160
3311
  "Use `runpane panels input` only when exact bytes are required, such as Ctrl-C or handcrafted terminal input.",
3161
3312
  "After creating panes or sending terminal input, validate with `panels wait` or bounded `panels screen` before reporting success."
3162
3313
  ],
@@ -3228,6 +3379,9 @@ exports.RUNPANE_CONTRACT = {
3228
3379
  "--prompt <text>",
3229
3380
  "--initial-input-file <path|->",
3230
3381
  "--from-json <path|->",
3382
+ "--source <user|agent>",
3383
+ "--no-focus",
3384
+ "--focus",
3231
3385
  "--wait-ready",
3232
3386
  "--ready-timeout-ms <ms>",
3233
3387
  "--concurrency <count>",
@@ -3244,6 +3398,7 @@ exports.RUNPANE_CONTRACT = {
3244
3398
  "--tool-command <command>",
3245
3399
  "--source <user|agent>",
3246
3400
  "--no-focus",
3401
+ "--focus",
3247
3402
  "--wait-ready",
3248
3403
  "--yes",
3249
3404
  "--json"
@@ -3438,8 +3593,8 @@ exports.RUNPANE_CONTRACT = {
3438
3593
  },
3439
3594
  "version": {
3440
3595
  "name": "version",
3441
- "summary": "Print the runpane wrapper version and installed Pane version when detectable.",
3442
- "details": "Use this for diagnostics or to confirm which wrapper is available.",
3596
+ "summary": "Print the runpane wrapper version without contacting, launching, or focusing Pane.",
3597
+ "details": "Use this to confirm which wrapper is available. App, daemon, and release diagnostics belong in doctor.",
3443
3598
  "requiresPaneDaemon": false,
3444
3599
  "mutates": false,
3445
3600
  "arguments": [
@@ -3447,7 +3602,7 @@ exports.RUNPANE_CONTRACT = {
3447
3602
  "name": "--pane-path",
3448
3603
  "value": "<path>",
3449
3604
  "required": false,
3450
- "description": "Inspect a specific Pane executable."
3605
+ "description": "Ignored for version; retained only for parser compatibility."
3451
3606
  }
3452
3607
  ],
3453
3608
  "examples": [
@@ -3704,6 +3859,22 @@ exports.RUNPANE_CONTRACT = {
3704
3859
  "required": false,
3705
3860
  "description": "Read a full panes.create request JSON payload."
3706
3861
  },
3862
+ {
3863
+ "name": "--source",
3864
+ "value": "<user|agent>",
3865
+ "required": false,
3866
+ "description": "Mutation source; agent implies background/no-focus creation."
3867
+ },
3868
+ {
3869
+ "name": "--no-focus",
3870
+ "required": false,
3871
+ "description": "Create the pane in the background without stealing focus."
3872
+ },
3873
+ {
3874
+ "name": "--focus",
3875
+ "required": false,
3876
+ "description": "Explicitly focus the created pane."
3877
+ },
3707
3878
  {
3708
3879
  "name": "--yes",
3709
3880
  "required": false,
@@ -4147,6 +4318,11 @@ exports.RUNPANE_CONTRACT = {
4147
4318
  "required": false,
4148
4319
  "description": "Create the panel in the background without changing active panel."
4149
4320
  },
4321
+ {
4322
+ "name": "--focus",
4323
+ "required": false,
4324
+ "description": "Explicitly focus the created panel."
4325
+ },
4150
4326
  {
4151
4327
  "name": "--wait-ready",
4152
4328
  "required": false,
@@ -4185,7 +4361,7 @@ exports.RUNPANE_CONTRACT = {
4185
4361
  "panels submit-composer": {
4186
4362
  "name": "panels submit-composer",
4187
4363
  "summary": "Submit an agent composer using the panel-appropriate key sequence.",
4188
- "details": "Use this after sending text into an agent composer when plain Enter is not the right submit action. Auto mode sends Ctrl+Enter for Codex panels and Enter for other panels.",
4364
+ "details": "Use this after sending text into an agent composer when plain Enter is not the right submit action. Agents should use --strategy auto; Pane owns per-agent submit sequences internally and verifies visible composer state when possible.",
4189
4365
  "requiresPaneDaemon": true,
4190
4366
  "mutates": true,
4191
4367
  "arguments": [
@@ -4222,7 +4398,8 @@ exports.RUNPANE_CONTRACT = {
4222
4398
  ],
4223
4399
  "notes": [
4224
4400
  "Use `panels input` or `panels submit` to write prompt text first; this command only submits the current composer.",
4225
- "Codex composer submission uses ESC [13;5u, not a plain Enter."
4401
+ "Use --strategy auto for agent workflows; explicit strategies are diagnostic escape hatches.",
4402
+ "The JSON result includes sequenceName and verifiedSubmitted. If ok is false, follow blocked.suggestedCommand instead of assuming submission happened."
4226
4403
  ]
4227
4404
  }
4228
4405
  },