runpane 2.4.80 → 2.4.82

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 (18) 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.map +1 -1
  5. package/dist/commands.js +1 -0
  6. package/dist/commands.js.map +1 -1
  7. package/dist/generated/contract.d.ts +303 -7
  8. package/dist/generated/contract.d.ts.map +1 -1
  9. package/dist/generated/contract.js +428 -0
  10. package/dist/generated/contract.js.map +1 -1
  11. package/dist/localControl.d.ts +1 -0
  12. package/dist/localControl.d.ts.map +1 -1
  13. package/dist/localControl.js +106 -0
  14. package/dist/localControl.js.map +1 -1
  15. package/dist/telemetry.d.ts.map +1 -1
  16. package/dist/telemetry.js +5 -1
  17. package/dist/telemetry.js.map +1 -1
  18. package/package.json +1 -1
package/dist/generated/contract.js CHANGED
@@ -190,6 +190,17 @@ exports.RUNPANE_CONTRACT = {
190
190
  "paneListResult"
191
191
  ]
192
192
  },
193
+ {
194
+ "name": "panes cost",
195
+ "summary": "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.",
196
+ "usage": [
197
+ "runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]"
198
+ ],
199
+ "jsonSchemas": [
200
+ "paneCostRequest",
201
+ "paneCostResult"
202
+ ]
203
+ },
193
204
  {
194
205
  "name": "workspace state",
195
206
  "summary": "Read one workspace snapshot of every Pane and CLI panel.",
@@ -665,6 +676,7 @@ exports.RUNPANE_CONTRACT = {
665
676
  " runpane repos list [--json]",
666
677
  " runpane repos add --path <path> [--name <name>]",
667
678
  " runpane panes list [--repo <selector>] [--json]",
679
+ " runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
668
680
  " runpane workspace state [--repo <selector>] [--json]",
669
681
  " runpane watch [--as <name>|--since <generation>] [--follow] [--json]",
670
682
  " runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]",
@@ -824,6 +836,7 @@ exports.RUNPANE_CONTRACT = {
824
836
  "",
825
837
  "Commands:",
826
838
  " runpane panes list [--repo <selector>] [--json]",
839
+ " runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
827
840
  " runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [options]",
828
841
  " runpane panes archive --pane <pane-id> [--force] [--source user|agent] [--dry-run] --yes [--json]",
829
842
  " runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]",
@@ -843,6 +856,18 @@ exports.RUNPANE_CONTRACT = {
843
856
  " --pane-dir <path> Connect to a specific Pane data directory",
844
857
  " --json Print machine-readable output"
845
858
  ],
859
+ "panes cost": [
860
+ "Usage:",
861
+ " runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
862
+ "",
863
+ "Reports estimated token costs per Pane for the last 30 days, including per-model and cache-efficiency details.",
864
+ "",
865
+ "Options:",
866
+ " --repo <selector> Limit results to one saved repository",
867
+ " --pane <pane-id> Return one Pane, including an idle Pane with zero usage",
868
+ " --pane-dir <path> Connect to a specific Pane data directory",
869
+ " --json Print machine-readable output"
870
+ ],
846
871
  "workspace": [
847
872
  "Workspace observation commands.",
848
873
  "",
@@ -1140,6 +1165,7 @@ exports.RUNPANE_CONTRACT = {
1140
1165
  " runpane repos list [--json]",
1141
1166
  " runpane repos add --path <path> [--name <name>]",
1142
1167
  " runpane panes list [--repo <selector>] [--json]",
1168
+ " runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
1143
1169
  " runpane workspace state [--repo <selector>] [--json]",
1144
1170
  " runpane watch [--as <name>|--since <generation>] [--follow] [--json]",
1145
1171
  " runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [--source user|agent] [--focus|--no-focus] [--wait-ready]",
@@ -1288,6 +1314,7 @@ exports.RUNPANE_CONTRACT = {
1288
1314
  "",
1289
1315
  "Commands:",
1290
1316
  " runpane panes list [--repo <selector>] [--json]",
1317
+ " runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
1291
1318
  " runpane panes create --repo <selector> --name <name> --agent <codex|claude|cursor> [options]",
1292
1319
  " runpane panes archive --pane <pane-id> [--force] [--source user|agent] [--dry-run] --yes [--json]",
1293
1320
  " runpane panes pin --pane <pane-id> --yes [--dry-run] [--json]",
@@ -1307,6 +1334,18 @@ exports.RUNPANE_CONTRACT = {
1307
1334
  " --pane-dir <path>",
1308
1335
  " --json"
1309
1336
  ],
1337
+ "panes cost": [
1338
+ "Usage:",
1339
+ " runpane panes cost [--repo <selector>] [--pane <pane-id>] [--json]",
1340
+ "",
1341
+ "Reports estimated token costs per Pane for the last 30 days, including per-model and cache-efficiency details.",
1342
+ "",
1343
+ "Options:",
1344
+ " --repo <selector>",
1345
+ " --pane <pane-id>",
1346
+ " --pane-dir <path>",
1347
+ " --json"
1348
+ ],
1310
1349
  "workspace": [
1311
1350
  "Workspace observation commands.",
1312
1351
  "",
@@ -1659,6 +1698,7 @@ exports.RUNPANE_CONTRACT = {
1659
1698
  "runpane repos list --json",
1660
1699
  "runpane repos add --path /path/to/repo --name Pane --yes --json",
1661
1700
  "runpane panes list --repo active --json",
1701
+ "runpane panes cost --pane <pane-id> --json",
1662
1702
  "runpane panes create --repo active --name issue-252 --agent <agent> --prompt \"Kick off the discussion skill for issue 252\" --source agent --no-focus --wait-ready --yes --json",
1663
1703
  "runpane panes create --from-json panes.json --yes --json",
1664
1704
  "runpane panes archive --pane <pane-id> --source agent --yes --json",
@@ -1684,6 +1724,7 @@ exports.RUNPANE_CONTRACT = {
1684
1724
  "`runpane repos list` connects to the running local Pane daemon and prints saved repository records.",
1685
1725
  "`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.",
1686
1726
  "`runpane panes list` lists Pane sessions, optionally scoped to one saved repository.",
1727
+ "`runpane panes cost` reports estimated token costs per Pane for the last 30 days, including per-model breakdowns and cache efficiency; unscoped output includes an Unattributed bucket that reconciles against workspace totals.",
1687
1728
  "`runpane panes create` connects to the running local Pane daemon, resolves the requested saved base repository, creates user-visible Pane sessions backed by Pane-managed worktrees/branches, 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. New Panes are pinned into the UI's favorite/pin set by default; pass `--no-pinned` to opt out. Panes created interactively in the Pane UI are unaffected.",
1688
1729
  "For `panes create --wait-ready`, `initialInput.verifiedSubmitted: true` is reported only after argument attachment or composer-clear plus activity evidence. Routing input does not by itself verify submission.",
1689
1730
  "`runpane panes archive` refreshes the configured upstream, reports exact unpushed commit evidence, and refuses unsafe archive operations unless `--force` is used. Add `--dry-run` to inspect the same evidence without archiving. Successful archives wait for worktree removal and report `worktreeCleanup`.",
@@ -1825,6 +1866,13 @@ exports.RUNPANE_CONTRACT = {
1825
1866
  "active",
1826
1867
  "--json"
1827
1868
  ],
1869
+ [
1870
+ "panes",
1871
+ "cost",
1872
+ "--pane",
1873
+ "session-1",
1874
+ "--json"
1875
+ ],
1828
1876
  [
1829
1877
  "panes",
1830
1878
  "create",
@@ -3155,6 +3203,332 @@ exports.RUNPANE_CONTRACT = {
3155
3203
  },
3156
3204
  "additionalProperties": false
3157
3205
  },
3206
+ "paneCostRequest": {
3207
+ "type": "object",
3208
+ "properties": {
3209
+ "repo": {
3210
+ "oneOf": [
3211
+ {
3212
+ "type": "string"
3213
+ },
3214
+ {
3215
+ "type": "object",
3216
+ "properties": {
3217
+ "id": {
3218
+ "type": "number"
3219
+ },
3220
+ "path": {
3221
+ "type": "string"
3222
+ },
3223
+ "name": {
3224
+ "type": "string"
3225
+ },
3226
+ "active": {
3227
+ "const": true
3228
+ }
3229
+ },
3230
+ "additionalProperties": false
3231
+ }
3232
+ ]
3233
+ },
3234
+ "paneId": {
3235
+ "type": "string",
3236
+ "minLength": 1
3237
+ }
3238
+ },
3239
+ "additionalProperties": false
3240
+ },
3241
+ "paneCostResult": {
3242
+ "$defs": {
3243
+ "usageTotals": {
3244
+ "type": "object",
3245
+ "required": [
3246
+ "inputTokens",
3247
+ "outputTokens",
3248
+ "cacheReadTokens",
3249
+ "cacheCreationTokens",
3250
+ "totalTokens",
3251
+ "messageCount",
3252
+ "estimatedCostUsd",
3253
+ "costIncomplete",
3254
+ "cacheSavingsUsd"
3255
+ ],
3256
+ "properties": {
3257
+ "inputTokens": {
3258
+ "type": "number"
3259
+ },
3260
+ "outputTokens": {
3261
+ "type": "number"
3262
+ },
3263
+ "cacheReadTokens": {
3264
+ "type": "number"
3265
+ },
3266
+ "cacheCreationTokens": {
3267
+ "type": "number"
3268
+ },
3269
+ "totalTokens": {
3270
+ "type": "number"
3271
+ },
3272
+ "messageCount": {
3273
+ "type": "number"
3274
+ },
3275
+ "estimatedCostUsd": {
3276
+ "type": "number"
3277
+ },
3278
+ "costIncomplete": {
3279
+ "type": "boolean"
3280
+ },
3281
+ "cacheSavingsUsd": {
3282
+ "type": "number"
3283
+ }
3284
+ },
3285
+ "additionalProperties": false
3286
+ },
3287
+ "usageByModel": {
3288
+ "type": "object",
3289
+ "required": [
3290
+ "model",
3291
+ "provider",
3292
+ "inputTokens",
3293
+ "outputTokens",
3294
+ "cacheReadTokens",
3295
+ "cacheCreationTokens",
3296
+ "totalTokens",
3297
+ "messageCount",
3298
+ "estimatedCostUsd",
3299
+ "costIncomplete",
3300
+ "cacheSavingsUsd"
3301
+ ],
3302
+ "properties": {
3303
+ "model": {
3304
+ "type": "string"
3305
+ },
3306
+ "provider": {
3307
+ "enum": [
3308
+ "claude",
3309
+ "codex"
3310
+ ]
3311
+ },
3312
+ "inputTokens": {
3313
+ "type": "number"
3314
+ },
3315
+ "outputTokens": {
3316
+ "type": "number"
3317
+ },
3318
+ "cacheReadTokens": {
3319
+ "type": "number"
3320
+ },
3321
+ "cacheCreationTokens": {
3322
+ "type": "number"
3323
+ },
3324
+ "totalTokens": {
3325
+ "type": "number"
3326
+ },
3327
+ "messageCount": {
3328
+ "type": "number"
3329
+ },
3330
+ "estimatedCostUsd": {
3331
+ "type": "number"
3332
+ },
3333
+ "costIncomplete": {
3334
+ "type": "boolean"
3335
+ },
3336
+ "cacheSavingsUsd": {
3337
+ "type": "number"
3338
+ }
3339
+ },
3340
+ "additionalProperties": false
3341
+ },
3342
+ "paneCostSlice": {
3343
+ "type": "object",
3344
+ "required": [
3345
+ "inputTokens",
3346
+ "outputTokens",
3347
+ "cacheReadTokens",
3348
+ "cacheCreationTokens",
3349
+ "totalTokens",
3350
+ "messageCount",
3351
+ "estimatedCostUsd",
3352
+ "costIncomplete",
3353
+ "cacheSavingsUsd",
3354
+ "uncachedCostUsd",
3355
+ "uncachedInputTokens",
3356
+ "cacheHitRate",
3357
+ "byModel"
3358
+ ],
3359
+ "properties": {
3360
+ "inputTokens": {
3361
+ "type": "number"
3362
+ },
3363
+ "outputTokens": {
3364
+ "type": "number"
3365
+ },
3366
+ "cacheReadTokens": {
3367
+ "type": "number"
3368
+ },
3369
+ "cacheCreationTokens": {
3370
+ "type": "number"
3371
+ },
3372
+ "totalTokens": {
3373
+ "type": "number"
3374
+ },
3375
+ "messageCount": {
3376
+ "type": "number"
3377
+ },
3378
+ "estimatedCostUsd": {
3379
+ "type": "number"
3380
+ },
3381
+ "costIncomplete": {
3382
+ "type": "boolean"
3383
+ },
3384
+ "cacheSavingsUsd": {
3385
+ "type": "number"
3386
+ },
3387
+ "uncachedCostUsd": {
3388
+ "type": "number"
3389
+ },
3390
+ "uncachedInputTokens": {
3391
+ "type": "number"
3392
+ },
3393
+ "cacheHitRate": {
3394
+ "type": "number"
3395
+ },
3396
+ "byModel": {
3397
+ "type": "array",
3398
+ "items": {
3399
+ "$ref": "#/$defs/usageByModel"
3400
+ }
3401
+ }
3402
+ },
3403
+ "additionalProperties": false
3404
+ },
3405
+ "pane": {
3406
+ "type": "object",
3407
+ "required": [
3408
+ "paneId",
3409
+ "paneName",
3410
+ "worktreePath",
3411
+ "repoId",
3412
+ "archived",
3413
+ "createdAtMs",
3414
+ "inputTokens",
3415
+ "outputTokens",
3416
+ "cacheReadTokens",
3417
+ "cacheCreationTokens",
3418
+ "totalTokens",
3419
+ "messageCount",
3420
+ "estimatedCostUsd",
3421
+ "costIncomplete",
3422
+ "cacheSavingsUsd",
3423
+ "uncachedCostUsd",
3424
+ "uncachedInputTokens",
3425
+ "cacheHitRate",
3426
+ "byModel"
3427
+ ],
3428
+ "properties": {
3429
+ "paneId": {
3430
+ "type": "string"
3431
+ },
3432
+ "paneName": {
3433
+ "type": "string"
3434
+ },
3435
+ "worktreePath": {
3436
+ "type": "string"
3437
+ },
3438
+ "repoId": {
3439
+ "type": [
3440
+ "number",
3441
+ "null"
3442
+ ]
3443
+ },
3444
+ "archived": {
3445
+ "type": "boolean"
3446
+ },
3447
+ "createdAtMs": {
3448
+ "type": "number"
3449
+ },
3450
+ "inputTokens": {
3451
+ "type": "number"
3452
+ },
3453
+ "outputTokens": {
3454
+ "type": "number"
3455
+ },
3456
+ "cacheReadTokens": {
3457
+ "type": "number"
3458
+ },
3459
+ "cacheCreationTokens": {
3460
+ "type": "number"
3461
+ },
3462
+ "totalTokens": {
3463
+ "type": "number"
3464
+ },
3465
+ "messageCount": {
3466
+ "type": "number"
3467
+ },
3468
+ "estimatedCostUsd": {
3469
+ "type": "number"
3470
+ },
3471
+ "costIncomplete": {
3472
+ "type": "boolean"
3473
+ },
3474
+ "cacheSavingsUsd": {
3475
+ "type": "number"
3476
+ },
3477
+ "uncachedCostUsd": {
3478
+ "type": "number"
3479
+ },
3480
+ "uncachedInputTokens": {
3481
+ "type": "number"
3482
+ },
3483
+ "cacheHitRate": {
3484
+ "type": "number"
3485
+ },
3486
+ "byModel": {
3487
+ "type": "array",
3488
+ "items": {
3489
+ "$ref": "#/$defs/usageByModel"
3490
+ }
3491
+ }
3492
+ },
3493
+ "additionalProperties": false
3494
+ }
3495
+ },
3496
+ "type": "object",
3497
+ "required": [
3498
+ "ok",
3499
+ "fromMs",
3500
+ "toMs",
3501
+ "pricingAsOf",
3502
+ "panes"
3503
+ ],
3504
+ "properties": {
3505
+ "ok": {
3506
+ "const": true
3507
+ },
3508
+ "fromMs": {
3509
+ "type": "number"
3510
+ },
3511
+ "toMs": {
3512
+ "type": "number"
3513
+ },
3514
+ "pricingAsOf": {
3515
+ "type": "string"
3516
+ },
3517
+ "panes": {
3518
+ "type": "array",
3519
+ "items": {
3520
+ "$ref": "#/$defs/pane"
3521
+ }
3522
+ },
3523
+ "unattributed": {
3524
+ "$ref": "#/$defs/paneCostSlice"
3525
+ },
3526
+ "totals": {
3527
+ "$ref": "#/$defs/usageTotals"
3528
+ }
3529
+ },
3530
+ "additionalProperties": false
3531
+ },
3158
3532
  "workspaceEntry": {
3159
3533
  "type": "object",
3160
3534
  "required": [
@@ -4820,6 +5194,16 @@ exports.RUNPANE_CONTRACT = {
4820
5194
  "--pane-dir <path>"
4821
5195
  ]
4822
5196
  },
5197
+ {
5198
+ "name": "panes cost",
5199
+ "summary": "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.",
5200
+ "arguments": [
5201
+ "--repo <selector>",
5202
+ "--pane <pane-id>",
5203
+ "--json",
5204
+ "--pane-dir <path>"
5205
+ ]
5206
+ },
4823
5207
  {
4824
5208
  "name": "panes create",
4825
5209
  "summary": "Create user-visible Panes (Pane sessions) backed by Pane-managed worktrees for feature/PR work and open terminal-backed tool tabs.",
@@ -5348,6 +5732,50 @@ exports.RUNPANE_CONTRACT = {
5348
5732
  "Without --repo, this lists sessions across saved Pane repositories."
5349
5733
  ]
5350
5734
  },
5735
+ "panes cost": {
5736
+ "name": "panes cost",
5737
+ "summary": "Report estimated token cost per Pane, with per-model breakdown and cache efficiency.",
5738
+ "details": "Use this to attribute estimated workspace token costs to Pane lifetimes and inspect the models and cache efficiency behind each Pane's spend.",
5739
+ "requiresPaneDaemon": true,
5740
+ "mutates": false,
5741
+ "arguments": [
5742
+ {
5743
+ "name": "--repo",
5744
+ "value": "<selector>",
5745
+ "required": false,
5746
+ "description": "Optional repository selector: active, id, exact path, or saved repository name."
5747
+ },
5748
+ {
5749
+ "name": "--pane",
5750
+ "value": "<pane-id>",
5751
+ "required": false,
5752
+ "description": "Return only the selected Pane."
5753
+ },
5754
+ {
5755
+ "name": "--json",
5756
+ "required": false,
5757
+ "description": "Print machine-readable output."
5758
+ },
5759
+ {
5760
+ "name": "--pane-dir",
5761
+ "value": "<path>",
5762
+ "required": false,
5763
+ "description": "Connect to a specific Pane data directory."
5764
+ }
5765
+ ],
5766
+ "examples": [
5767
+ "runpane panes cost --pane <pane-id> --json"
5768
+ ],
5769
+ "jsonSchemas": [
5770
+ "paneCostRequest",
5771
+ "paneCostResult"
5772
+ ],
5773
+ "notes": [
5774
+ "The report range is the last 30 days.",
5775
+ "Costs are estimates based on API token prices.",
5776
+ "The unattributed bucket reconciles the Pane rows against totals in the unscoped result."
5777
+ ]
5778
+ },
5351
5779
  "panes create": {
5352
5780
  "name": "panes create",
5353
5781
  "summary": "Create user-visible Panes (Pane sessions) backed by Pane-managed worktrees for feature/PR work and open terminal-backed tool tabs.",