@overdeck/contracts 0.63.0 → 0.64.0

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/index.mjs CHANGED
@@ -82,7 +82,8 @@ const IssueState = Schema.Literals([
82
82
  const IssueAttention = Schema.Literals([
83
83
  "needs-you",
84
84
  "stuck",
85
- "api-error"
85
+ "api-error",
86
+ "work-not-started"
86
87
  ]);
87
88
  /** Latest review decision on the PR, as the forge reports it. */
88
89
  const PrReviewState = Schema.Literals([
@@ -115,6 +116,16 @@ const DerivedBranchState = Schema.Struct({
115
116
  aheadOfMain: Schema.Number,
116
117
  pushed: Schema.Boolean
117
118
  });
119
+ /** The workspace journal's read on a post-planning auto-start (PAN-4399). */
120
+ const DerivedWorkStart = Schema.Struct({
121
+ status: Schema.Literals(["retrying", "not-started"]),
122
+ /** ISO time of the journal entry the status was read from. */
123
+ at: Schema.String,
124
+ error: Schema.optional(Schema.String),
125
+ nextRetryAt: Schema.optional(Schema.String),
126
+ /** The retry is journaled but not actually running because the Deacon is frozen (PAN-4210). Present only when true. */
127
+ held: Schema.optional(Schema.Literal(true))
128
+ });
118
129
  /** Everything the dashboard needs to render an issue's pipeline position. */
119
130
  const DerivedIssueState = Schema.Struct({
120
131
  issueId: Schema.String,
@@ -127,7 +138,9 @@ const DerivedIssueState = Schema.Struct({
127
138
  * precedence — could not be ruled in or out. Present only in that case; an
128
139
  * unresolved tracker read is never reported as an open issue.
129
140
  */
130
- trackerUnknown: Schema.optional(Schema.Literal(true))
141
+ trackerUnknown: Schema.optional(Schema.Literal(true)),
142
+ /** A deferred or gave-up post-planning auto-start read from the workspace journal (PAN-4399). */
143
+ workStart: Schema.optional(DerivedWorkStart)
131
144
  });
132
145
  const ISSUE_STATES = [
133
146
  "backlog",
@@ -155,7 +168,8 @@ const ISSUE_STATE_PRECEDENCE = [
155
168
  const ISSUE_ATTENTIONS = [
156
169
  "needs-you",
157
170
  "stuck",
158
- "api-error"
171
+ "api-error",
172
+ "work-not-started"
159
173
  ];
160
174
  function isIssueState(value) {
161
175
  return typeof value === "string" && ISSUE_STATES.includes(value);
@@ -458,6 +472,13 @@ const ChannelPermissionRequestSnapshot = Schema.Struct({
458
472
  inputPreview: Schema.String,
459
473
  createdAt: Schema.String
460
474
  });
475
+ /** PAN-4371 — advisory Jev reading of why an idle agent ended its turn. kind is a string (append-only store). */
476
+ const TurnEndAssessment = Schema.Struct({
477
+ kind: Schema.String,
478
+ confidence: Schema.Number,
479
+ needsAnswer: Schema.Boolean,
480
+ model: Schema.String
481
+ });
461
482
  const AgentSnapshot = Schema.Struct({
462
483
  id: AgentId,
463
484
  issueId: IssueId,
@@ -520,6 +541,7 @@ const AgentSnapshot = Schema.Struct({
520
541
  })),
521
542
  resolution: Schema.optional(AgentResolution),
522
543
  resolutionCount: Schema.optional(Schema.Number),
544
+ turnEndAssessment: Schema.optional(TurnEndAssessment),
523
545
  runtimeSnapshotSequence: Schema.optional(SequenceNumber)
524
546
  });
525
547
  /** PAN-3151: A recorded cycle in the review convergence tracking series */
@@ -1777,7 +1799,8 @@ const AgentEnrichmentChangedEvent = Schema.Struct({
1777
1799
  plan: Schema.String
1778
1800
  })),
1779
1801
  resolution: Schema.optional(AgentResolution),
1780
- resolutionCount: Schema.optional(Schema.Number)
1802
+ resolutionCount: Schema.optional(Schema.Number),
1803
+ turnEndAssessment: Schema.optional(TurnEndAssessment)
1781
1804
  })
1782
1805
  });
1783
1806
  /** New — agent created in database */
@@ -4031,7 +4054,8 @@ function applyEvent(state, event) {
4031
4054
  pendingAskUserQuestion: event.payload.pendingAskUserQuestion,
4032
4055
  pendingProposedPlan: event.payload.pendingProposedPlan,
4033
4056
  resolution: event.payload.resolution,
4034
- resolutionCount: event.payload.resolutionCount
4057
+ resolutionCount: event.payload.resolutionCount,
4058
+ turnEndAssessment: event.payload.turnEndAssessment
4035
4059
  }
4036
4060
  }
4037
4061
  };
@@ -4169,6 +4193,7 @@ function applyEvent(state, event) {
4169
4193
  delete base["pendingInputKinds"];
4170
4194
  delete base["pendingAskUserQuestion"];
4171
4195
  delete base["pendingProposedPlan"];
4196
+ delete base["turnEndAssessment"];
4172
4197
  }
4173
4198
  return base;
4174
4199
  })();
@@ -6886,30 +6911,261 @@ const COMPOSER_COMMAND_MANIFEST = [
6886
6911
  "id": "pan-skills-set",
6887
6912
  "path": ["skills", "set"],
6888
6913
  "display": "/pan skills set",
6889
- "description": "Set a skill on, off, or inherit (global unless --project/--issue)",
6914
+ "description": "Set a skill (<skill> <state>) or a pack (--pack <id> <state>) on, off, or inherit",
6915
+ "args": [{
6916
+ "name": "args",
6917
+ "required": true,
6918
+ "variadic": true
6919
+ }],
6920
+ "options": [
6921
+ {
6922
+ "flags": "--project <key>",
6923
+ "description": "Project override",
6924
+ "required": true,
6925
+ "valueHint": "key"
6926
+ },
6927
+ {
6928
+ "flags": "--issue <id>",
6929
+ "description": "Issue override",
6930
+ "required": true,
6931
+ "valueHint": "id"
6932
+ },
6933
+ {
6934
+ "flags": "--pack <id>",
6935
+ "description": "Set a whole skill pack instead of one skill",
6936
+ "required": true,
6937
+ "valueHint": "id"
6938
+ }
6939
+ ],
6940
+ "aliases": [],
6941
+ "category": "Core"
6942
+ },
6943
+ {
6944
+ "id": "pan-skills-pack",
6945
+ "path": ["skills", "pack"],
6946
+ "display": "/pan skills pack",
6947
+ "description": "Register, update, and cache external skill packs pinned to a commit",
6948
+ "args": [],
6949
+ "options": [],
6950
+ "aliases": [],
6951
+ "category": "Core"
6952
+ },
6953
+ {
6954
+ "id": "pan-skills-pack-add",
6955
+ "path": [
6956
+ "skills",
6957
+ "pack",
6958
+ "add"
6959
+ ],
6960
+ "display": "/pan skills pack add",
6961
+ "description": "Register a git skill pack at the commit a ref resolves to (enables nothing)",
6890
6962
  "args": [{
6891
- "name": "skill",
6963
+ "name": "id",
6892
6964
  "required": true,
6893
6965
  "variadic": false
6894
6966
  }, {
6895
- "name": "state",
6967
+ "name": "url",
6968
+ "required": true,
6969
+ "variadic": false
6970
+ }],
6971
+ "options": [
6972
+ {
6973
+ "flags": "--ref <ref>",
6974
+ "description": "Tag or branch to pin",
6975
+ "required": true,
6976
+ "valueHint": "ref"
6977
+ },
6978
+ {
6979
+ "flags": "--adapter <adapter>",
6980
+ "description": "plain or claude-plugin",
6981
+ "required": true,
6982
+ "valueHint": "adapter"
6983
+ },
6984
+ {
6985
+ "flags": "--yes",
6986
+ "description": "Trust the resolved commit without asking",
6987
+ "required": false,
6988
+ "valueHint": null
6989
+ }
6990
+ ],
6991
+ "aliases": [],
6992
+ "category": "Core"
6993
+ },
6994
+ {
6995
+ "id": "pan-skills-pack-update",
6996
+ "path": [
6997
+ "skills",
6998
+ "pack",
6999
+ "update"
7000
+ ],
7001
+ "display": "/pan skills pack update",
7002
+ "description": "Move a pack to the commit its ref (or --ref) now resolves to",
7003
+ "args": [{
7004
+ "name": "id",
6896
7005
  "required": true,
6897
7006
  "variadic": false
6898
7007
  }],
6899
7008
  "options": [{
6900
- "flags": "--project <key>",
6901
- "description": "Project override",
7009
+ "flags": "--ref <ref>",
7010
+ "description": "Switch to a different tag or branch",
6902
7011
  "required": true,
6903
- "valueHint": "key"
7012
+ "valueHint": "ref"
6904
7013
  }, {
6905
- "flags": "--issue <id>",
6906
- "description": "Issue override",
7014
+ "flags": "--yes",
7015
+ "description": "Trust the new commit without asking",
7016
+ "required": false,
7017
+ "valueHint": null
7018
+ }],
7019
+ "aliases": [],
7020
+ "category": "Core"
7021
+ },
7022
+ {
7023
+ "id": "pan-skills-pack-list",
7024
+ "path": [
7025
+ "skills",
7026
+ "pack",
7027
+ "list"
7028
+ ],
7029
+ "display": "/pan skills pack list",
7030
+ "description": "List registered skill packs",
7031
+ "args": [],
7032
+ "options": [{
7033
+ "flags": "--json",
7034
+ "description": "Output as JSON",
7035
+ "required": false,
7036
+ "valueHint": null
7037
+ }, {
7038
+ "flags": "--offline",
7039
+ "description": "Skip the update check (no network)",
7040
+ "required": false,
7041
+ "valueHint": null
7042
+ }],
7043
+ "aliases": [],
7044
+ "category": "Core"
7045
+ },
7046
+ {
7047
+ "id": "pan-skills-pack-remove",
7048
+ "path": [
7049
+ "skills",
7050
+ "pack",
7051
+ "remove"
7052
+ ],
7053
+ "display": "/pan skills pack remove",
7054
+ "description": "Unregister a pack, clear its global toggles, and delete its cache",
7055
+ "args": [{
7056
+ "name": "id",
6907
7057
  "required": true,
6908
- "valueHint": "id"
7058
+ "variadic": false
7059
+ }],
7060
+ "options": [],
7061
+ "aliases": [],
7062
+ "category": "Core"
7063
+ },
7064
+ {
7065
+ "id": "pan-skills-pack-sync",
7066
+ "path": [
7067
+ "skills",
7068
+ "pack",
7069
+ "sync"
7070
+ ],
7071
+ "display": "/pan skills pack sync",
7072
+ "description": "Re-fetch packs and extract their trusted commits (all packs when omitted)",
7073
+ "args": [{
7074
+ "name": "id",
7075
+ "required": false,
7076
+ "variadic": false
7077
+ }],
7078
+ "options": [],
7079
+ "aliases": [],
7080
+ "category": "Core"
7081
+ },
7082
+ {
7083
+ "id": "pan-skills-pack-gc",
7084
+ "path": [
7085
+ "skills",
7086
+ "pack",
7087
+ "gc"
7088
+ ],
7089
+ "display": "/pan skills pack gc",
7090
+ "description": "Remove unused skill pack mounts and dangling launch links",
7091
+ "args": [],
7092
+ "options": [{
7093
+ "flags": "--max-age-days <n>",
7094
+ "description": "Keep unused mounts younger than this",
7095
+ "required": true,
7096
+ "valueHint": "n"
6909
7097
  }],
6910
7098
  "aliases": [],
6911
7099
  "category": "Core"
6912
7100
  },
7101
+ {
7102
+ "id": "pan-pair",
7103
+ "path": ["pair"],
7104
+ "display": "/pan pair",
7105
+ "description": "Print a one-time URL that pairs another device with this dashboard (see configuration/remote-access.mdx)",
7106
+ "args": [],
7107
+ "options": [
7108
+ {
7109
+ "flags": "--label <name>",
7110
+ "description": "Name to record for the pairing in the activity log",
7111
+ "required": true,
7112
+ "valueHint": "name"
7113
+ },
7114
+ {
7115
+ "flags": "--url <base>",
7116
+ "description": "Base URL the other device can reach (default: this dashboard's API URL)",
7117
+ "required": true,
7118
+ "valueHint": "base"
7119
+ },
7120
+ {
7121
+ "flags": "--json",
7122
+ "description": "Print { url, credential, expiresAt } as JSON",
7123
+ "required": false,
7124
+ "valueHint": null
7125
+ }
7126
+ ],
7127
+ "aliases": [],
7128
+ "category": "CLI"
7129
+ },
7130
+ {
7131
+ "id": "pan-devices",
7132
+ "path": ["devices"],
7133
+ "display": "/pan devices",
7134
+ "description": "List or revoke paired devices (see configuration/remote-access.mdx)",
7135
+ "args": [],
7136
+ "options": [],
7137
+ "aliases": [],
7138
+ "category": "CLI"
7139
+ },
7140
+ {
7141
+ "id": "pan-devices-list",
7142
+ "path": ["devices", "list"],
7143
+ "display": "/pan devices list",
7144
+ "description": "List paired devices with created, last-used and revoked times",
7145
+ "args": [],
7146
+ "options": [{
7147
+ "flags": "--json",
7148
+ "description": "Print the devices as JSON",
7149
+ "required": false,
7150
+ "valueHint": null
7151
+ }],
7152
+ "aliases": [],
7153
+ "category": "CLI"
7154
+ },
7155
+ {
7156
+ "id": "pan-devices-revoke",
7157
+ "path": ["devices", "revoke"],
7158
+ "display": "/pan devices revoke",
7159
+ "description": "Revoke a paired device and close its live connections",
7160
+ "args": [{
7161
+ "name": "id",
7162
+ "required": true,
7163
+ "variadic": false
7164
+ }],
7165
+ "options": [],
7166
+ "aliases": [],
7167
+ "category": "CLI"
7168
+ },
6913
7169
  {
6914
7170
  "id": "pan-issues",
6915
7171
  "path": ["issues"],
@@ -7224,6 +7480,12 @@ const COMPOSER_COMMAND_MANIFEST = [
7224
7480
  "description": "Bypass the PRD-first gate for a genuinely trivial issue (loud; prefer writing the PRD)",
7225
7481
  "required": false,
7226
7482
  "valueHint": null
7483
+ },
7484
+ {
7485
+ "flags": "--critic",
7486
+ "description": "Require an independent different-family plan critique before promotion (automatic for architecture, substrate-improvement and security labels)",
7487
+ "required": false,
7488
+ "valueHint": null
7227
7489
  }
7228
7490
  ],
7229
7491
  "aliases": [],
@@ -7430,6 +7692,12 @@ const COMPOSER_COMMAND_MANIFEST = [
7430
7692
  "required": true,
7431
7693
  "valueHint": "path"
7432
7694
  },
7695
+ {
7696
+ "flags": "--allow-primary",
7697
+ "description": "Operator only: allow --cwd to be a project's primary checkout (refused for agent sessions)",
7698
+ "required": false,
7699
+ "valueHint": null
7700
+ },
7433
7701
  {
7434
7702
  "flags": "--project <key>",
7435
7703
  "description": "Project (yaml key or display name) for the new conversation; defaults to inheriting the source conversation's project",
@@ -7479,6 +7747,12 @@ const COMPOSER_COMMAND_MANIFEST = [
7479
7747
  "required": true,
7480
7748
  "valueHint": "path"
7481
7749
  },
7750
+ {
7751
+ "flags": "--allow-primary",
7752
+ "description": "Operator only: allow --cwd to be a project's primary checkout (refused for agent sessions)",
7753
+ "required": false,
7754
+ "valueHint": null
7755
+ },
7482
7756
  {
7483
7757
  "flags": "--project <key>",
7484
7758
  "description": "Project (yaml key or display name) for the new conversation; defaults to inheriting the source conversation's project",
@@ -8309,6 +8583,11 @@ const COMPOSER_COMMAND_MANIFEST = [
8309
8583
  "description": "Print JSON",
8310
8584
  "required": false,
8311
8585
  "valueHint": null
8586
+ }, {
8587
+ "flags": "--steal",
8588
+ "description": "Claim even when a running agent holds this item or an overlapping one (foreman/operator override)",
8589
+ "required": false,
8590
+ "valueHint": null
8312
8591
  }],
8313
8592
  "aliases": [],
8314
8593
  "category": "Lifecycle"
@@ -8966,6 +9245,436 @@ const COMPOSER_COMMAND_MANIFEST = [
8966
9245
  "aliases": [],
8967
9246
  "category": "Workspace"
8968
9247
  },
9248
+ {
9249
+ "id": "pan-vault",
9250
+ "path": ["vault"],
9251
+ "display": "/pan vault",
9252
+ "description": "Session Vault: encrypted off-machine storage and cross-machine resume for agent conversations",
9253
+ "args": [],
9254
+ "options": [],
9255
+ "aliases": [],
9256
+ "category": "CLI"
9257
+ },
9258
+ {
9259
+ "id": "pan-vault-setup",
9260
+ "path": ["vault", "setup"],
9261
+ "display": "/pan vault setup",
9262
+ "description": "Enable the vault against your own git remote and print the recovery phrase once",
9263
+ "args": [{
9264
+ "name": "git-url",
9265
+ "required": true,
9266
+ "variadic": false
9267
+ }],
9268
+ "options": [
9269
+ {
9270
+ "flags": "--hooks",
9271
+ "description": "Also register the Claude Code Stop hook that saves after each turn",
9272
+ "required": false,
9273
+ "valueHint": null
9274
+ },
9275
+ {
9276
+ "flags": "--passphrase-file <path>",
9277
+ "description": "Also enable passphrase unlock with the passphrase in this file",
9278
+ "required": true,
9279
+ "valueHint": "path"
9280
+ },
9281
+ {
9282
+ "flags": "--generate-passphrase",
9283
+ "description": "Also enable passphrase unlock with a generated 6-word passphrase, printed once",
9284
+ "required": false,
9285
+ "valueHint": null
9286
+ },
9287
+ {
9288
+ "flags": "--no-passphrase",
9289
+ "description": "Do not offer passphrase unlock",
9290
+ "required": false,
9291
+ "valueHint": null
9292
+ }
9293
+ ],
9294
+ "aliases": [],
9295
+ "category": "CLI"
9296
+ },
9297
+ {
9298
+ "id": "pan-vault-join",
9299
+ "path": ["vault", "join"],
9300
+ "display": "/pan vault join",
9301
+ "description": "Join an existing vault from another machine with the vault passphrase or the recovery phrase",
9302
+ "args": [{
9303
+ "name": "git-url",
9304
+ "required": true,
9305
+ "variadic": false
9306
+ }],
9307
+ "options": [{
9308
+ "flags": "--phrase-file <path>",
9309
+ "description": "Read the 24-word recovery phrase from a file instead of prompting",
9310
+ "required": true,
9311
+ "valueHint": "path"
9312
+ }, {
9313
+ "flags": "--passphrase-file <path>",
9314
+ "description": "Read the vault passphrase from a file instead of prompting",
9315
+ "required": true,
9316
+ "valueHint": "path"
9317
+ }],
9318
+ "aliases": [],
9319
+ "category": "CLI"
9320
+ },
9321
+ {
9322
+ "id": "pan-vault-passphrase",
9323
+ "path": ["vault", "passphrase"],
9324
+ "display": "/pan vault passphrase",
9325
+ "description": "Turn passphrase unlock for new machines on (set) or off (remove); the vault key stays the same",
9326
+ "args": [],
9327
+ "options": [],
9328
+ "aliases": [],
9329
+ "category": "CLI"
9330
+ },
9331
+ {
9332
+ "id": "pan-vault-passphrase-set",
9333
+ "path": [
9334
+ "vault",
9335
+ "passphrase",
9336
+ "set"
9337
+ ],
9338
+ "display": "/pan vault passphrase set",
9339
+ "description": "Wrap the vault key under a passphrase so a new machine can join without the recovery phrase",
9340
+ "args": [],
9341
+ "options": [{
9342
+ "flags": "--passphrase-file <path>",
9343
+ "description": "Read the passphrase from a file instead of prompting",
9344
+ "required": true,
9345
+ "valueHint": "path"
9346
+ }, {
9347
+ "flags": "--generate",
9348
+ "description": "Generate a 6-word passphrase and print it once",
9349
+ "required": false,
9350
+ "valueHint": null
9351
+ }],
9352
+ "aliases": [],
9353
+ "category": "CLI"
9354
+ },
9355
+ {
9356
+ "id": "pan-vault-passphrase-remove",
9357
+ "path": [
9358
+ "vault",
9359
+ "passphrase",
9360
+ "remove"
9361
+ ],
9362
+ "display": "/pan vault passphrase remove",
9363
+ "description": "Delete the passphrase unlock object; joining then needs the recovery phrase",
9364
+ "args": [],
9365
+ "options": [],
9366
+ "aliases": [],
9367
+ "category": "CLI"
9368
+ },
9369
+ {
9370
+ "id": "pan-vault-rotate-key",
9371
+ "path": ["vault", "rotate-key"],
9372
+ "display": "/pan vault rotate-key",
9373
+ "description": "Replace the vault key after losing a device: re-encrypt refs under a new key, keep old chunks readable, print a new recovery phrase",
9374
+ "args": [],
9375
+ "options": [
9376
+ {
9377
+ "flags": "--yes",
9378
+ "description": "Rotate without the confirmation prompt",
9379
+ "required": false,
9380
+ "valueHint": null
9381
+ },
9382
+ {
9383
+ "flags": "--passphrase-file <path>",
9384
+ "description": "Re-wrap passphrase unlock under the new key with the passphrase in this file",
9385
+ "required": true,
9386
+ "valueHint": "path"
9387
+ },
9388
+ {
9389
+ "flags": "--generate-passphrase",
9390
+ "description": "Re-wrap passphrase unlock under the new key with a generated 6-word passphrase, printed once",
9391
+ "required": false,
9392
+ "valueHint": null
9393
+ },
9394
+ {
9395
+ "flags": "--no-passphrase",
9396
+ "description": "Turn passphrase unlock off",
9397
+ "required": false,
9398
+ "valueHint": null
9399
+ }
9400
+ ],
9401
+ "aliases": [],
9402
+ "category": "CLI"
9403
+ },
9404
+ {
9405
+ "id": "pan-vault-status",
9406
+ "path": ["vault", "status"],
9407
+ "display": "/pan vault status",
9408
+ "description": "Show backend, this machine, owned records, last sync and the machine list",
9409
+ "args": [],
9410
+ "options": [{
9411
+ "flags": "--json",
9412
+ "description": "Output in JSON format",
9413
+ "required": false,
9414
+ "valueHint": null
9415
+ }],
9416
+ "aliases": [],
9417
+ "category": "CLI"
9418
+ },
9419
+ {
9420
+ "id": "pan-vault-save",
9421
+ "path": ["vault", "save"],
9422
+ "display": "/pan vault save",
9423
+ "description": "Settle one transcript (by session id or path) or many into the vault",
9424
+ "args": [{
9425
+ "name": "session-id-or-path",
9426
+ "required": false,
9427
+ "variadic": false
9428
+ }],
9429
+ "options": [
9430
+ {
9431
+ "flags": "--all",
9432
+ "description": "Settle every discovered transcript",
9433
+ "required": false,
9434
+ "valueHint": null
9435
+ },
9436
+ {
9437
+ "flags": "--since <date>",
9438
+ "description": "With --all: only transcripts modified on or after this date",
9439
+ "required": true,
9440
+ "valueHint": "date"
9441
+ },
9442
+ {
9443
+ "flags": "--harness <harness>",
9444
+ "description": "With --all: only this harness (claude-code, codex, ...)",
9445
+ "required": true,
9446
+ "valueHint": "harness"
9447
+ },
9448
+ {
9449
+ "flags": "--hook",
9450
+ "description": "Claude Code Stop-hook mode: read {session_id, transcript_path} JSON from stdin, print nothing, exit 0",
9451
+ "required": false,
9452
+ "valueHint": null
9453
+ }
9454
+ ],
9455
+ "aliases": [],
9456
+ "category": "CLI"
9457
+ },
9458
+ {
9459
+ "id": "pan-vault-sync",
9460
+ "path": ["vault", "sync"],
9461
+ "display": "/pan vault sync",
9462
+ "description": "Settle owned transcripts that grew, register this machine and refresh the list",
9463
+ "args": [],
9464
+ "options": [],
9465
+ "aliases": [],
9466
+ "category": "CLI"
9467
+ },
9468
+ {
9469
+ "id": "pan-vault-list",
9470
+ "path": ["vault", "list"],
9471
+ "display": "/pan vault list",
9472
+ "description": "List saved conversations from the local cache (never contacts the backend)",
9473
+ "args": [],
9474
+ "options": [{
9475
+ "flags": "--json",
9476
+ "description": "Output in JSON format",
9477
+ "required": false,
9478
+ "valueHint": null
9479
+ }],
9480
+ "aliases": [],
9481
+ "category": "CLI"
9482
+ },
9483
+ {
9484
+ "id": "pan-vault-show",
9485
+ "path": ["vault", "show"],
9486
+ "display": "/pan vault show",
9487
+ "description": "Print a saved conversation read-only with its versions",
9488
+ "args": [{
9489
+ "name": "id",
9490
+ "required": true,
9491
+ "variadic": false
9492
+ }],
9493
+ "options": [{
9494
+ "flags": "--json",
9495
+ "description": "Output in JSON format",
9496
+ "required": false,
9497
+ "valueHint": null
9498
+ }],
9499
+ "aliases": [],
9500
+ "category": "CLI"
9501
+ },
9502
+ {
9503
+ "id": "pan-vault-resume",
9504
+ "path": ["vault", "resume"],
9505
+ "display": "/pan vault resume",
9506
+ "description": "Continue a saved conversation here: <id> or <id>@<version>; adopts it and launches the harness",
9507
+ "args": [{
9508
+ "name": "id",
9509
+ "required": true,
9510
+ "variadic": false
9511
+ }],
9512
+ "options": [
9513
+ {
9514
+ "flags": "--cwd <dir>",
9515
+ "description": "Working directory to resume in (default: the saved cwd)",
9516
+ "required": true,
9517
+ "valueHint": "dir"
9518
+ },
9519
+ {
9520
+ "flags": "--no-launch",
9521
+ "description": "Print the launch command instead of running it",
9522
+ "required": false,
9523
+ "valueHint": null
9524
+ },
9525
+ {
9526
+ "flags": "--on-drift <choice>",
9527
+ "description": "When the cwd state differs from the saved state: continue | note | cancel",
9528
+ "required": true,
9529
+ "valueHint": "choice"
9530
+ },
9531
+ {
9532
+ "flags": "--no-code",
9533
+ "description": "Do not apply the saved code snapshot; only continue the conversation",
9534
+ "required": false,
9535
+ "valueHint": null
9536
+ },
9537
+ {
9538
+ "flags": "--worktree <dir>",
9539
+ "description": "Apply the code snapshot into a new git worktree at <dir> instead of the target checkout",
9540
+ "required": true,
9541
+ "valueHint": "dir"
9542
+ }
9543
+ ],
9544
+ "aliases": [],
9545
+ "category": "CLI"
9546
+ },
9547
+ {
9548
+ "id": "pan-vault-exclude",
9549
+ "path": ["vault", "exclude"],
9550
+ "display": "/pan vault exclude",
9551
+ "description": "Exclude conversations by cwd path, git origin or session id; an excluded saved record becomes a tombstone",
9552
+ "args": [{
9553
+ "name": "path",
9554
+ "required": false,
9555
+ "variadic": false
9556
+ }],
9557
+ "options": [{
9558
+ "flags": "--origin <url>",
9559
+ "description": "Exclude conversations whose git origin is this URL",
9560
+ "required": true,
9561
+ "valueHint": "url"
9562
+ }, {
9563
+ "flags": "--session <id>",
9564
+ "description": "Exclude one session by native session id or vault id",
9565
+ "required": true,
9566
+ "valueHint": "id"
9567
+ }],
9568
+ "aliases": [],
9569
+ "category": "CLI"
9570
+ },
9571
+ {
9572
+ "id": "pan-vault-include",
9573
+ "path": ["vault", "include"],
9574
+ "display": "/pan vault include",
9575
+ "description": "Remove an exclusion added with pan vault exclude",
9576
+ "args": [{
9577
+ "name": "path",
9578
+ "required": false,
9579
+ "variadic": false
9580
+ }],
9581
+ "options": [{
9582
+ "flags": "--origin <url>",
9583
+ "description": "Include conversations whose git origin is this URL again",
9584
+ "required": true,
9585
+ "valueHint": "url"
9586
+ }, {
9587
+ "flags": "--session <id>",
9588
+ "description": "Include one session again",
9589
+ "required": true,
9590
+ "valueHint": "id"
9591
+ }],
9592
+ "aliases": [],
9593
+ "category": "CLI"
9594
+ },
9595
+ {
9596
+ "id": "pan-vault-allow-secret",
9597
+ "path": ["vault", "allow-secret"],
9598
+ "display": "/pan vault allow-secret",
9599
+ "description": "Allow one blocked transcript line, or the blocked code lines of one file, for that record only",
9600
+ "args": [{
9601
+ "name": "id-or-path",
9602
+ "required": true,
9603
+ "variadic": false
9604
+ }, {
9605
+ "name": "line",
9606
+ "required": false,
9607
+ "variadic": false
9608
+ }],
9609
+ "options": [{
9610
+ "flags": "--file <path>",
9611
+ "description": "Allow the blocked lines of this file in the code snapshot (path relative to the repository root)",
9612
+ "required": true,
9613
+ "valueHint": "path"
9614
+ }],
9615
+ "aliases": [],
9616
+ "category": "CLI"
9617
+ },
9618
+ {
9619
+ "id": "pan-vault-evict",
9620
+ "path": ["vault", "evict"],
9621
+ "display": "/pan vault evict",
9622
+ "description": "Review the pending-deletion batch (default) or act on it; nothing is deleted without --confirm",
9623
+ "args": [],
9624
+ "options": [
9625
+ {
9626
+ "flags": "--review",
9627
+ "description": "Scan and print the batch with its fingerprint (default)",
9628
+ "required": false,
9629
+ "valueHint": null
9630
+ },
9631
+ {
9632
+ "flags": "--confirm <fingerprint>",
9633
+ "description": "Delete the reviewed files if the batch still matches this fingerprint",
9634
+ "required": true,
9635
+ "valueHint": "fingerprint"
9636
+ },
9637
+ {
9638
+ "flags": "--decline <vaultId>",
9639
+ "description": "Remove an entry from the batch and do not offer it again",
9640
+ "required": true,
9641
+ "valueHint": "vaultId"
9642
+ },
9643
+ {
9644
+ "flags": "--reoffer <vaultId>",
9645
+ "description": "Allow a declined entry to be offered again",
9646
+ "required": true,
9647
+ "valueHint": "vaultId"
9648
+ },
9649
+ {
9650
+ "flags": "--clear",
9651
+ "description": "Empty the batch without deleting or declining anything",
9652
+ "required": false,
9653
+ "valueHint": null
9654
+ }
9655
+ ],
9656
+ "aliases": [],
9657
+ "category": "CLI"
9658
+ },
9659
+ {
9660
+ "id": "pan-vault-restore",
9661
+ "path": ["vault", "restore"],
9662
+ "display": "/pan vault restore",
9663
+ "description": "Rebuild an evicted transcript byte for byte at its original path",
9664
+ "args": [{
9665
+ "name": "id",
9666
+ "required": true,
9667
+ "variadic": false
9668
+ }],
9669
+ "options": [{
9670
+ "flags": "--to <path>",
9671
+ "description": "Write the rebuilt file here instead of the recorded path",
9672
+ "required": true,
9673
+ "valueHint": "path"
9674
+ }],
9675
+ "aliases": [],
9676
+ "category": "CLI"
9677
+ },
8969
9678
  {
8970
9679
  "id": "pan-test",
8971
9680
  "path": ["test"],
@@ -12108,7 +12817,7 @@ const COMPOSER_COMMAND_MANIFEST = [
12108
12817
  "id": "pan-spawn",
12109
12818
  "path": ["spawn"],
12110
12819
  "display": "/pan spawn",
12111
- "description": "Create a worker pane for one xBRIEF item in the issue workspace",
12820
+ "description": "Create a worker pane for one xBRIEF item in its own item worktree",
12112
12821
  "args": [],
12113
12822
  "options": [
12114
12823
  {
@@ -12134,6 +12843,12 @@ const COMPOSER_COMMAND_MANIFEST = [
12134
12843
  "description": "Coding-agent harness (default: claude-code)",
12135
12844
  "required": true,
12136
12845
  "valueHint": "harness"
12846
+ },
12847
+ {
12848
+ "flags": "--shared",
12849
+ "description": "Run the worker in the issue workspace instead of an item worktree (foreman/operator only; serial use)",
12850
+ "required": false,
12851
+ "valueHint": null
12137
12852
  }
12138
12853
  ],
12139
12854
  "aliases": [],
@@ -12520,6 +13235,12 @@ const COMPOSER_COMMAND_MANIFEST = [
12520
13235
  "required": false,
12521
13236
  "valueHint": null
12522
13237
  },
13238
+ {
13239
+ "flags": "--force",
13240
+ "description": "Launch even while the host is CPU-saturated",
13241
+ "required": false,
13242
+ "valueHint": null
13243
+ },
12523
13244
  {
12524
13245
  "flags": "--no-wait",
12525
13246
  "description": "Return without waiting for the lane to start",
@@ -14602,6 +15323,47 @@ function laneActivityOf(row, now) {
14602
15323
  return "stopped";
14603
15324
  }
14604
15325
  //#endregion
14605
- export { ACP_BEHAVIOR, AGENT_ROLES, Activity, ActivityDetailedEvent, ActivityEntryEvent, ActivityTtsEvent, ActivityUpdatedEvent, AdmissionState, AgentActivityChangedEvent, AgentChannelReply, AgentChannelReplyEvent, AgentCompletedEvent, AgentContextSaturationChangedEvent, AgentCreatedEvent, AgentCurrentIssueSetEvent, AgentDirectoryResponse, AgentEnrichmentChangedEvent, AgentHealthKind, AgentHealthSnapshot, AgentHealthStatus, AgentHeartbeatDeadEvent, AgentHookFiredEvent, AgentId, AgentMessageReceivedEvent, AgentModelSetEvent, AgentOutput, AgentOutputReceivedEvent, AgentPermissionRequestedEvent, AgentPermissionResolvedEvent, AgentResolution, AgentResolutionChangedEvent, AgentRuntimeSnapshot, AgentSnapshot, AgentStartedEvent, AgentStateRestoredEvent, AgentStatus, AgentStatusChangedEvent, AgentStoppedEvent, AgentThinkingStartedEvent, AgentThinkingStoppedEvent, AgentTurnDiffCompletedEvent, AgentWaitingClearedEvent, AgentWaitingStartedEvent, ArtifactAgentHarness, ArtifactAgentRole, ArtifactCreateResponse, ArtifactDetailResponse, ArtifactHash, ArtifactId, ArtifactLifecycleState, ArtifactListEntry, ArtifactListResponse, ArtifactMetadata, ArtifactPublishResponse, ArtifactSlug, ArtifactStatusResponse, ArtifactUnshareResponse, ArtifactUrls, ArtifactValidationCode, ArtifactValidationFinding, ArtifactValidationResult, BackendPane, BackendPaneChangedEvent, BackendPaneRemovedEvent, BeadsFreshnessChangedEvent, CHANNEL_REPLY_KIND_VALUES, CLAUDE_CODE_BEHAVIOR, CODEX_BEHAVIOR, COMPANION_TERMINAL_CLOSE_BODY_KEYS, COMPANION_TERMINAL_OPEN_BODY_KEYS, COMPOSER_COMMAND_INSERT_OVERRIDES, COMPOSER_COMMAND_MANIFEST, COMPOSER_COMMAND_VARIANTS, CONTEXT_LAYER_KINDS, CONTEXT_PREVIEW_HARNESSES, ChannelPermissionRequestSnapshot, ChannelReplyArtifactRef, ChannelReplyKind, ChatMessage, ClaudeChannelPermissionBehavior, CompactBoundary, ContextEditableLayerRecord, ContextHarnessPreviews, ContextLayerDraft, ContextLayerKind, ContextLayerSaveRequest, ContextLayerSaveResponse, ContextLayerTarget, ContextLayersResponse, ContextPreviewDiagnostic, ContextPreviewHarness, ContextPreviewRequest, ContextPreviewResponse, ContextProjectSummary, ContextSyncRequest, ContextSyncResponse, ContextSyncTarget, ContextUsage, ContextWorkspaceSummary, ConversationCompactingChangedEvent, ConversationCostSummary, ConversationCreatedEvent, ConversationEvent, ConversationFilter, ConversationMovedEvent, ConversationPermissionChangedEvent, ConversationPullRequests, ConversationPullRequestsChangedEvent, ConversationResponse, ConversationTitleChangedEvent, CostEventRecordedEvent, DEFAULT_EFFORT, DEFAULT_MAX_MEMORY_OBSERVATIONS_PER_ISSUE, DEFAULT_MAX_TURN_DIFF_SUMMARIES_PER_AGENT, DashboardLifecycleCompletedEvent, DashboardLifecycleFailedEvent, DashboardLifecycleStartedEvent, DashboardSnapshot, DeepWipeRpc, DeployStalenessSnapshot, DerivedBranchState, DerivedIssueState, DerivedPrState, DirectoryEntry, DirectoryEntryKind, DirectoryEntryLocation, DirectoryEntrySource, DirectoryEntryState, DirectoryPause, DirectoryPauseBy, DirectoryProviderError, DirectoryScope, DirectoryTranscriptRef, DiscoveredSessionSnapshot, DomainEvent, EDITORS, EFFORT_LEVELS, EditorIdSchema, EffortLevelSchema, EmbedProgressEvent, EmbedProgressSnapshot, EmbedSessionsRpc, EnrichCompleteEvent, EnrichProgressEvent, EnrichProgressSnapshot, EnrichSessionsRpc, EnrichStatsSnapshot, ExtractionProviderConfig, ExtractionProviderTarget, FeatureNode, FeatureRegistryEntry, FeatureRegistryStatus, FlywheelAgent, FlywheelAgentStatus, FlywheelAgentSummary, FlywheelBugRateCriterion, FlywheelConversationSummary, FlywheelDerivedStatus, FlywheelEffort, FlywheelFreshness, FlywheelHarness, FlywheelHeadline, FlywheelHttpUrl, FlywheelInFlightRow, FlywheelJournalSummary, FlywheelLastTick, FlywheelOrchestrator, FlywheelOrderBookSummary, FlywheelOrders, FlywheelP0Criterion, FlywheelParkedItem, FlywheelPipelineItem, FlywheelPipelineStatus, FlywheelPipelineVerb, FlywheelPolicies, FlywheelRunId, FlywheelRunState, FlywheelScope, FlywheelStats, FlywheelStatsCriterionStatus, FlywheelStatsTrend, FlywheelStatsWindow, FlywheelStatus, FlywheelSubstrateBug, FlywheelSubstrateBugRow, FlywheelSubstrateBugStatus, FlywheelSubstrateSeverity, FlywheelSuggestion, FlywheelSuggestionAction, FlywheelSuggestionPriority, FlywheelSystemStatus, GITHUB_QUOTA_BUCKETS, GITHUB_QUOTA_CALLERS, GITHUB_QUOTA_POOLS, GetAvailableEditorsRpc, GetConversationCostByWorkspaceRpc, GetConversationCostRpc, GetConversationStatsRpc, GetDiscoveredSessionRpc, GetSessionsFeedFacetsRpc, GetSnapshotRpc, GitHubQuotaBucket, GitHubQuotaCaller, GitHubQuotaCallerUsage, GitHubQuotaChangedEvent, GitHubQuotaPause, GitHubQuotaPool, GitHubQuotaSample, GitHubQuotaSnapshot, GitHubQuotaUsage, GitHubRateLimitKind, GlobalContextLayerRecord, GlobalContextLayerTarget, HOOK_INVENTORY, HealthReason, HealthState, HostHealthMetrics, HostPlatform, HygieneFinding, HygienePullRequest, HygieneReport, INITIAL_READ_MODEL_STATE, ISSUE_ATTENTIONS, ISSUE_STATES, ISSUE_STATE_PRECEDENCE, IssueAttention, IssueId, IssueState, IssueStateChangedEvent, IssueStatusChangedEvent, IssueTransitionedEvent, IssuesDeltaEvent, IssuesSnapshotEvent, IssuesUpdatedEvent, KIMI_CODE_BEHAVIOR, KNOWN_HARNESSES, LANE_STARTING_GRACE_MS, LegacySystemHealthSummary, LegacyWebhookRelaySummary, LinearMcpAuthCallbackRelayedEvent, LinearMcpAuthHealthyEvent, LinearMcpAuthNotifiedEvent, LinearMcpAuthRequiredEvent, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, MAX_CHANNEL_REPLY_ARTIFACT_LABEL_LENGTH, MAX_CHANNEL_REPLY_ARTIFACT_REFS, MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH, MAX_CHANNEL_REPLY_SUMMARY_LENGTH, MEMBERSHIP_UNAVAILABLE_REASONS, MUSE_BEHAVIOR, MemoryAgentRole, MemoryHealthChangedEvent, MemoryIdentity, MemoryObservation, MemoryObservationCreatedEvent, MemoryResetMarkerCreatedEvent, MemoryRollupTriggeredEvent, MemoryStatus, MemoryStatusPhase, MemoryStatusUpdatedEvent, MemoryTokenUsage, MergeReadyEvent, ModelOrigin, ModelOriginEntry, NON_ESSENTIAL_GITHUB_CALLERS, OHMYPI_BEHAVIOR, OPENCODE_BEHAVIOR, OVERDECK_AGENT_PROTOCOL_VERSION, OVERDECK_DASHBOARD_PROTOCOL_VERSION, OpenInEditorInput, OperatorInterventionEvent, OrderBook, OrderBookIndexEntry, OrderBookItem, OrderBookLane, OrderBookPosture, OrderBookSettings, OrderBookStatus, PIPELINE_MEMBERSHIP_LOADING_CODE, PRIME_AGENT_BEHAVIOR, PanRpcError, PanRpcGroup, PendingTurn, PipelineReviewCompletedEvent, PipelineReviewStartedEvent, PipelineTestCompletedEvent, PipelineTestStartedEvent, PipelineVerificationFailedEvent, PipelineVerificationStartedEvent, PlanItemStatusChangedEvent, PlanItemsUnblockedEvent, PlanSubitemStatusChangedEvent, PlanningFailedEvent, PlanningStartedEvent, PlanningSyncEvent, PrChecksState, PrReviewState, ProjectCiHeadObservedEvent, ProjectCiSnapshot, ProjectCiSuite, ProjectCiSuiteObservedEvent, ProjectContextLayerRecord, ProjectContextLayerTarget, ProjectDeployChangedEvent, ProjectDeployPhase, ProjectDeploySnapshot, ProjectSessionTree, ProposedPlan, PullRequestKey, PullRequestLink, PullRequestLinkListing, PullRequestLinkSource, PullRequestLinkedConversation, PullRequestSnapshot, PullRequestState, RagDecision, RagDecisionSource, ReadFileAtPathInput, ReadFileAtPathResult, ReadFileAtPathRpc, ReadWorkspaceFileInput, ReadWorkspaceFileResult, ReadWorkspaceFileRpc, ReplayEventsRpc, ResetMarker, ResetMarkerScope, ResizeTerminalRpc, ResolveFilePathExistsInput, ResolveFilePathExistsResult, ResolveFilePathExistsRpc, ResourceStats, ResourcesUpdatedEvent, RestartGateChangedEvent, RestartGateKind, RestartGateOutcome, RestartGateRequest, RestartGateSnapshot, ReviewApprovedEvent, ReviewCoordinatorDiedEvent, ReviewCoordinatorStartedEvent, ReviewReviewerCompletedEvent, ReviewReviewerStartedEvent, ReviewSpecialistTimedOutEvent, ReviewVerdictDispatchedEvent, ReviewVerdictRejectedEvent, ReviewVerdictRestoreBlockedEvent, ReviewerRoundMetadata, ReviewerRoundSummary, Role, SINGLETON_AGENT_IDS, ScanCompleteEvent, ScanConversationsRpc, ScanProgressEvent, ScanProgressSnapshot, ScanResult, ScanStartedEvent, SearchConversationsRpc, SendTerminalInputRpc, SequenceNumber, ServiceHealthSnapshot, ServiceHealthStatus, SessionNode, SessionNodePresence, SessionNodeType, SessionTreeDelta, SessionsFeedFacetsSnapshot, SessionsFeedRowSnapshot, SessionsFeedSource, ShadowInferenceUpdateEvent, ShellOpenInEditorRpc, SpecialistCompletedEvent, SpecialistFailedEvent, SpecialistLifecycle, SpecialistStartedEvent, StartAgentRpc, StartPlanningRpc, SubagentHumanInput, SubagentSummary, SubscribeAgentOutputRpc, SubscribeConversationMessagesRpc, SubscribeDomainEventsRpc, SubscribeIssueEventsRpc, SubscribeProjectSessionTreeRpc, SubscribeTerminalRpc, SubstrateBugFiledEvent, SweepEscalatedEvent, SweepRecommendationEvent, SweepScanEvent, SystemHealthConsumer, SystemHealthSeverityChangedEvent, SystemHealthSnapshot, SystemHeartbeatEvent, TELEMETRY_CLI_VERBS, TELEMETRY_EVENT_CATALOG, TELEMETRY_EVENT_NAMES, TELEMETRY_PROPERTY_DOMAINS, TERMINAL_BACKEND_NAMES, TerminalCloseRpc, TerminalOpenRpc, TerminalOutput, TerminalResizeRpc, TerminalWriteRpc, TestPassedEvent, ThinkingState, TickMarker, TickMarkerPhase, TurnDiffFileChange, TurnDiffSummary, WIRED_HOOK_INVENTORY, WIRED_HOOK_NAMES, WS_METHODS, WaitingReason, WaitingState, WorkCompletedEvent, WorkLogEntry, WorkspaceAbortedEvent, WorkspaceArtifactsResponse, WorkspaceContextLayerRecord, WorkspaceContextLayerTarget, WorkspaceCreatedEvent, WorkspaceDeletedEvent, WorkspaceDestroyedEvent, WorkspaceWipeStartedEvent, WriteFileAtPathInput, WriteFileAtPathResult, WriteFileAtPathRpc, applyEvent, applyEvents, applyIssueDelta, bucketQuotaPoints, bucketQuotaRemaining, canonicalPullRequestUrl, companionTerminalKindFor, compareEffort, compareIssueIds, createIssueDelta, decodeFlywheelDerivedStatus, decodeFlywheelStats, deriveProjectCi, encodeFlywheelStats, getHarness, getHarnessBehavior, getMaxMemoryObservationsPerIssue, getMaxTurnDiffSummariesPerAgent, getRuntimeBehavior, indexPanesByAgentKey, isAgentRole, isAgentSessionName, isChannelReplyKind, isConfiguredPullRequestRepo, isEffortLevel, isIssueAttention, isIssueState, isSingletonConversation, isTerminalBackendName, isTerminalTurnDiffSummaryStatus, laneActivityOf, normalizeChannelReplyPayload, omitTurnDiffSummariesForAgent, paneAgentKey, parsePullRequestRef, projectLegacySystemHealthSummary, repoFromRemoteUrl, resolveEffectivePullRequest, syncSnapshot, trimMemoryObservations, trimTurnDiffSummaries, withPaneLivenessAlias };
15326
+ //#region src/environment.ts
15327
+ /** Wire protocol version a client and server must agree on. */
15328
+ const ENVIRONMENT_PROTOCOL_VERSION = 1;
15329
+ const EnvironmentId = Schema.String.pipe(Schema.brand("EnvironmentId"));
15330
+ const EnvironmentCapabilities = Schema.Struct({
15331
+ /** `POST /api/pairing/*` is available. */
15332
+ pairing: Schema.Boolean,
15333
+ /** `GET/DELETE /api/devices` is available. */
15334
+ deviceSessions: Schema.Boolean,
15335
+ /** `/ws/*` upgrades require a credential (PAN-1166). */
15336
+ terminalAuth: Schema.Boolean
15337
+ });
15338
+ const EnvironmentDescriptor = Schema.Struct({
15339
+ descriptorVersion: Schema.Literal(1),
15340
+ environmentId: EnvironmentId,
15341
+ label: Schema.String,
15342
+ platform: Schema.Struct({
15343
+ os: Schema.String,
15344
+ arch: Schema.String
15345
+ }),
15346
+ /** Exact package version of the serving Overdeck. */
15347
+ serverVersion: Schema.String,
15348
+ /** The server's `ENVIRONMENT_PROTOCOL_VERSION`. */
15349
+ protocolVersion: Schema.Number,
15350
+ capabilities: EnvironmentCapabilities
15351
+ });
15352
+ /** A server-local id qualified by the environment that owns it. */
15353
+ const ScopedRef = (localId) => Schema.Struct({
15354
+ environmentId: EnvironmentId,
15355
+ localId
15356
+ });
15357
+ const ScopedProjectRef = ScopedRef(Schema.String);
15358
+ const ScopedIssueRef = ScopedRef(Schema.String);
15359
+ const ScopedAgentRef = ScopedRef(Schema.String);
15360
+ const ScopedConversationRef = ScopedRef(Schema.String);
15361
+ const ScopedTerminalRef = ScopedRef(Schema.String);
15362
+ /** True only when the server speaks exactly the client's protocol version. */
15363
+ function isProtocolCompatible(descriptor, clientProtocolVersion) {
15364
+ return descriptor.protocolVersion === clientProtocolVersion;
15365
+ }
15366
+ //#endregion
15367
+ export { ACP_BEHAVIOR, AGENT_ROLES, Activity, ActivityDetailedEvent, ActivityEntryEvent, ActivityTtsEvent, ActivityUpdatedEvent, AdmissionState, AgentActivityChangedEvent, AgentChannelReply, AgentChannelReplyEvent, AgentCompletedEvent, AgentContextSaturationChangedEvent, AgentCreatedEvent, AgentCurrentIssueSetEvent, AgentDirectoryResponse, AgentEnrichmentChangedEvent, AgentHealthKind, AgentHealthSnapshot, AgentHealthStatus, AgentHeartbeatDeadEvent, AgentHookFiredEvent, AgentId, AgentMessageReceivedEvent, AgentModelSetEvent, AgentOutput, AgentOutputReceivedEvent, AgentPermissionRequestedEvent, AgentPermissionResolvedEvent, AgentResolution, AgentResolutionChangedEvent, AgentRuntimeSnapshot, AgentSnapshot, AgentStartedEvent, AgentStateRestoredEvent, AgentStatus, AgentStatusChangedEvent, AgentStoppedEvent, AgentThinkingStartedEvent, AgentThinkingStoppedEvent, AgentTurnDiffCompletedEvent, AgentWaitingClearedEvent, AgentWaitingStartedEvent, ArtifactAgentHarness, ArtifactAgentRole, ArtifactCreateResponse, ArtifactDetailResponse, ArtifactHash, ArtifactId, ArtifactLifecycleState, ArtifactListEntry, ArtifactListResponse, ArtifactMetadata, ArtifactPublishResponse, ArtifactSlug, ArtifactStatusResponse, ArtifactUnshareResponse, ArtifactUrls, ArtifactValidationCode, ArtifactValidationFinding, ArtifactValidationResult, BackendPane, BackendPaneChangedEvent, BackendPaneRemovedEvent, BeadsFreshnessChangedEvent, CHANNEL_REPLY_KIND_VALUES, CLAUDE_CODE_BEHAVIOR, CODEX_BEHAVIOR, COMPANION_TERMINAL_CLOSE_BODY_KEYS, COMPANION_TERMINAL_OPEN_BODY_KEYS, COMPOSER_COMMAND_INSERT_OVERRIDES, COMPOSER_COMMAND_MANIFEST, COMPOSER_COMMAND_VARIANTS, CONTEXT_LAYER_KINDS, CONTEXT_PREVIEW_HARNESSES, ChannelPermissionRequestSnapshot, ChannelReplyArtifactRef, ChannelReplyKind, ChatMessage, ClaudeChannelPermissionBehavior, CompactBoundary, ContextEditableLayerRecord, ContextHarnessPreviews, ContextLayerDraft, ContextLayerKind, ContextLayerSaveRequest, ContextLayerSaveResponse, ContextLayerTarget, ContextLayersResponse, ContextPreviewDiagnostic, ContextPreviewHarness, ContextPreviewRequest, ContextPreviewResponse, ContextProjectSummary, ContextSyncRequest, ContextSyncResponse, ContextSyncTarget, ContextUsage, ContextWorkspaceSummary, ConversationCompactingChangedEvent, ConversationCostSummary, ConversationCreatedEvent, ConversationEvent, ConversationFilter, ConversationMovedEvent, ConversationPermissionChangedEvent, ConversationPullRequests, ConversationPullRequestsChangedEvent, ConversationResponse, ConversationTitleChangedEvent, CostEventRecordedEvent, DEFAULT_EFFORT, DEFAULT_MAX_MEMORY_OBSERVATIONS_PER_ISSUE, DEFAULT_MAX_TURN_DIFF_SUMMARIES_PER_AGENT, DashboardLifecycleCompletedEvent, DashboardLifecycleFailedEvent, DashboardLifecycleStartedEvent, DashboardSnapshot, DeepWipeRpc, DeployStalenessSnapshot, DerivedBranchState, DerivedIssueState, DerivedPrState, DerivedWorkStart, DirectoryEntry, DirectoryEntryKind, DirectoryEntryLocation, DirectoryEntrySource, DirectoryEntryState, DirectoryPause, DirectoryPauseBy, DirectoryProviderError, DirectoryScope, DirectoryTranscriptRef, DiscoveredSessionSnapshot, DomainEvent, EDITORS, EFFORT_LEVELS, ENVIRONMENT_PROTOCOL_VERSION, EditorIdSchema, EffortLevelSchema, EmbedProgressEvent, EmbedProgressSnapshot, EmbedSessionsRpc, EnrichCompleteEvent, EnrichProgressEvent, EnrichProgressSnapshot, EnrichSessionsRpc, EnrichStatsSnapshot, EnvironmentCapabilities, EnvironmentDescriptor, EnvironmentId, ExtractionProviderConfig, ExtractionProviderTarget, FeatureNode, FeatureRegistryEntry, FeatureRegistryStatus, FlywheelAgent, FlywheelAgentStatus, FlywheelAgentSummary, FlywheelBugRateCriterion, FlywheelConversationSummary, FlywheelDerivedStatus, FlywheelEffort, FlywheelFreshness, FlywheelHarness, FlywheelHeadline, FlywheelHttpUrl, FlywheelInFlightRow, FlywheelJournalSummary, FlywheelLastTick, FlywheelOrchestrator, FlywheelOrderBookSummary, FlywheelOrders, FlywheelP0Criterion, FlywheelParkedItem, FlywheelPipelineItem, FlywheelPipelineStatus, FlywheelPipelineVerb, FlywheelPolicies, FlywheelRunId, FlywheelRunState, FlywheelScope, FlywheelStats, FlywheelStatsCriterionStatus, FlywheelStatsTrend, FlywheelStatsWindow, FlywheelStatus, FlywheelSubstrateBug, FlywheelSubstrateBugRow, FlywheelSubstrateBugStatus, FlywheelSubstrateSeverity, FlywheelSuggestion, FlywheelSuggestionAction, FlywheelSuggestionPriority, FlywheelSystemStatus, GITHUB_QUOTA_BUCKETS, GITHUB_QUOTA_CALLERS, GITHUB_QUOTA_POOLS, GetAvailableEditorsRpc, GetConversationCostByWorkspaceRpc, GetConversationCostRpc, GetConversationStatsRpc, GetDiscoveredSessionRpc, GetSessionsFeedFacetsRpc, GetSnapshotRpc, GitHubQuotaBucket, GitHubQuotaCaller, GitHubQuotaCallerUsage, GitHubQuotaChangedEvent, GitHubQuotaPause, GitHubQuotaPool, GitHubQuotaSample, GitHubQuotaSnapshot, GitHubQuotaUsage, GitHubRateLimitKind, GlobalContextLayerRecord, GlobalContextLayerTarget, HOOK_INVENTORY, HealthReason, HealthState, HostHealthMetrics, HostPlatform, HygieneFinding, HygienePullRequest, HygieneReport, INITIAL_READ_MODEL_STATE, ISSUE_ATTENTIONS, ISSUE_STATES, ISSUE_STATE_PRECEDENCE, IssueAttention, IssueId, IssueState, IssueStateChangedEvent, IssueStatusChangedEvent, IssueTransitionedEvent, IssuesDeltaEvent, IssuesSnapshotEvent, IssuesUpdatedEvent, KIMI_CODE_BEHAVIOR, KNOWN_HARNESSES, LANE_STARTING_GRACE_MS, LegacySystemHealthSummary, LegacyWebhookRelaySummary, LinearMcpAuthCallbackRelayedEvent, LinearMcpAuthHealthyEvent, LinearMcpAuthNotifiedEvent, LinearMcpAuthRequiredEvent, ListDiscoveredSessionsRpc, ListSessionsFeedRpc, MAX_CHANNEL_REPLY_ARTIFACT_LABEL_LENGTH, MAX_CHANNEL_REPLY_ARTIFACT_REFS, MAX_CHANNEL_REPLY_ARTIFACT_URI_LENGTH, MAX_CHANNEL_REPLY_SUMMARY_LENGTH, MEMBERSHIP_UNAVAILABLE_REASONS, MUSE_BEHAVIOR, MemoryAgentRole, MemoryHealthChangedEvent, MemoryIdentity, MemoryObservation, MemoryObservationCreatedEvent, MemoryResetMarkerCreatedEvent, MemoryRollupTriggeredEvent, MemoryStatus, MemoryStatusPhase, MemoryStatusUpdatedEvent, MemoryTokenUsage, MergeReadyEvent, ModelOrigin, ModelOriginEntry, NON_ESSENTIAL_GITHUB_CALLERS, OHMYPI_BEHAVIOR, OPENCODE_BEHAVIOR, OVERDECK_AGENT_PROTOCOL_VERSION, OVERDECK_DASHBOARD_PROTOCOL_VERSION, OpenInEditorInput, OperatorInterventionEvent, OrderBook, OrderBookIndexEntry, OrderBookItem, OrderBookLane, OrderBookPosture, OrderBookSettings, OrderBookStatus, PIPELINE_MEMBERSHIP_LOADING_CODE, PRIME_AGENT_BEHAVIOR, PanRpcError, PanRpcGroup, PendingTurn, PipelineReviewCompletedEvent, PipelineReviewStartedEvent, PipelineTestCompletedEvent, PipelineTestStartedEvent, PipelineVerificationFailedEvent, PipelineVerificationStartedEvent, PlanItemStatusChangedEvent, PlanItemsUnblockedEvent, PlanSubitemStatusChangedEvent, PlanningFailedEvent, PlanningStartedEvent, PlanningSyncEvent, PrChecksState, PrReviewState, ProjectCiHeadObservedEvent, ProjectCiSnapshot, ProjectCiSuite, ProjectCiSuiteObservedEvent, ProjectContextLayerRecord, ProjectContextLayerTarget, ProjectDeployChangedEvent, ProjectDeployPhase, ProjectDeploySnapshot, ProjectSessionTree, ProposedPlan, PullRequestKey, PullRequestLink, PullRequestLinkListing, PullRequestLinkSource, PullRequestLinkedConversation, PullRequestSnapshot, PullRequestState, RagDecision, RagDecisionSource, ReadFileAtPathInput, ReadFileAtPathResult, ReadFileAtPathRpc, ReadWorkspaceFileInput, ReadWorkspaceFileResult, ReadWorkspaceFileRpc, ReplayEventsRpc, ResetMarker, ResetMarkerScope, ResizeTerminalRpc, ResolveFilePathExistsInput, ResolveFilePathExistsResult, ResolveFilePathExistsRpc, ResourceStats, ResourcesUpdatedEvent, RestartGateChangedEvent, RestartGateKind, RestartGateOutcome, RestartGateRequest, RestartGateSnapshot, ReviewApprovedEvent, ReviewCoordinatorDiedEvent, ReviewCoordinatorStartedEvent, ReviewReviewerCompletedEvent, ReviewReviewerStartedEvent, ReviewSpecialistTimedOutEvent, ReviewVerdictDispatchedEvent, ReviewVerdictRejectedEvent, ReviewVerdictRestoreBlockedEvent, ReviewerRoundMetadata, ReviewerRoundSummary, Role, SINGLETON_AGENT_IDS, ScanCompleteEvent, ScanConversationsRpc, ScanProgressEvent, ScanProgressSnapshot, ScanResult, ScanStartedEvent, ScopedAgentRef, ScopedConversationRef, ScopedIssueRef, ScopedProjectRef, ScopedRef, ScopedTerminalRef, SearchConversationsRpc, SendTerminalInputRpc, SequenceNumber, ServiceHealthSnapshot, ServiceHealthStatus, SessionNode, SessionNodePresence, SessionNodeType, SessionTreeDelta, SessionsFeedFacetsSnapshot, SessionsFeedRowSnapshot, SessionsFeedSource, ShadowInferenceUpdateEvent, ShellOpenInEditorRpc, SpecialistCompletedEvent, SpecialistFailedEvent, SpecialistLifecycle, SpecialistStartedEvent, StartAgentRpc, StartPlanningRpc, SubagentHumanInput, SubagentSummary, SubscribeAgentOutputRpc, SubscribeConversationMessagesRpc, SubscribeDomainEventsRpc, SubscribeIssueEventsRpc, SubscribeProjectSessionTreeRpc, SubscribeTerminalRpc, SubstrateBugFiledEvent, SweepEscalatedEvent, SweepRecommendationEvent, SweepScanEvent, SystemHealthConsumer, SystemHealthSeverityChangedEvent, SystemHealthSnapshot, SystemHeartbeatEvent, TELEMETRY_CLI_VERBS, TELEMETRY_EVENT_CATALOG, TELEMETRY_EVENT_NAMES, TELEMETRY_PROPERTY_DOMAINS, TERMINAL_BACKEND_NAMES, TerminalCloseRpc, TerminalOpenRpc, TerminalOutput, TerminalResizeRpc, TerminalWriteRpc, TestPassedEvent, ThinkingState, TickMarker, TickMarkerPhase, TurnDiffFileChange, TurnDiffSummary, TurnEndAssessment, WIRED_HOOK_INVENTORY, WIRED_HOOK_NAMES, WS_METHODS, WaitingReason, WaitingState, WorkCompletedEvent, WorkLogEntry, WorkspaceAbortedEvent, WorkspaceArtifactsResponse, WorkspaceContextLayerRecord, WorkspaceContextLayerTarget, WorkspaceCreatedEvent, WorkspaceDeletedEvent, WorkspaceDestroyedEvent, WorkspaceWipeStartedEvent, WriteFileAtPathInput, WriteFileAtPathResult, WriteFileAtPathRpc, applyEvent, applyEvents, applyIssueDelta, bucketQuotaPoints, bucketQuotaRemaining, canonicalPullRequestUrl, companionTerminalKindFor, compareEffort, compareIssueIds, createIssueDelta, decodeFlywheelDerivedStatus, decodeFlywheelStats, deriveProjectCi, encodeFlywheelStats, getHarness, getHarnessBehavior, getMaxMemoryObservationsPerIssue, getMaxTurnDiffSummariesPerAgent, getRuntimeBehavior, indexPanesByAgentKey, isAgentRole, isAgentSessionName, isChannelReplyKind, isConfiguredPullRequestRepo, isEffortLevel, isIssueAttention, isIssueState, isProtocolCompatible, isSingletonConversation, isTerminalBackendName, isTerminalTurnDiffSummaryStatus, laneActivityOf, normalizeChannelReplyPayload, omitTurnDiffSummariesForAgent, paneAgentKey, parsePullRequestRef, projectLegacySystemHealthSummary, repoFromRemoteUrl, resolveEffectivePullRequest, syncSnapshot, trimMemoryObservations, trimTurnDiffSummaries, withPaneLivenessAlias };
14606
15368
 
14607
15369
  //# sourceMappingURL=index.mjs.map