@pasko70/pibo 1.9.13 → 1.10.1

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 (163) hide show
  1. package/README.md +183 -183
  2. package/context/codex-base-prompt.md +148 -148
  3. package/context/compute-worker.md +23 -23
  4. package/context/pibo-compaction-prompt.md +100 -100
  5. package/context/pibo-native-tooling.md +18 -18
  6. package/context/pibo-system-prompt.md +77 -77
  7. package/dist/apps/chat/agent-profiles.js +2 -2
  8. package/dist/apps/chat/agent-store.js +263 -250
  9. package/dist/apps/chat/chat-request-normalizers.js +17 -0
  10. package/dist/apps/chat/data/chat-data-mappers.js +2 -0
  11. package/dist/apps/chat/data/project-service.js +168 -168
  12. package/dist/apps/chat/data/read-state-service.js +18 -18
  13. package/dist/apps/chat/data/session-query-service.js +25 -25
  14. package/dist/apps/chat/data/timeline-query-service.js +19 -19
  15. package/dist/apps/chat/loop-api.js +181 -0
  16. package/dist/apps/chat/static-assets.js +854 -854
  17. package/dist/apps/chat/web-app.js +36 -16
  18. package/dist/apps/chat/workflow-manual-trigger-runtime.js +149 -46
  19. package/dist/apps/chat/workflow-persistence.js +255 -255
  20. package/dist/apps/chat-ui/assets/{dist-BZ2eTC4f.js → dist-3Sts0Afa.js} +1 -1
  21. package/dist/apps/chat-ui/assets/{dist-BHa-kcGl.js → dist-4NlLjLs7.js} +1 -1
  22. package/dist/apps/chat-ui/assets/{dist-yCYNNb5d.js → dist-BA6mhAec.js} +1 -1
  23. package/dist/apps/chat-ui/assets/{dist-D811wJeV.js → dist-BPl-fzRB.js} +1 -1
  24. package/dist/apps/chat-ui/assets/{dist-Dq4GxJi3.js → dist-BPnn9e2B.js} +1 -1
  25. package/dist/apps/chat-ui/assets/{dist-CzE6k3F3.js → dist-BpfBSMzK.js} +1 -1
  26. package/dist/apps/chat-ui/assets/{dist-CnVsqwSG.js → dist-Cvx5M97R.js} +1 -1
  27. package/dist/apps/chat-ui/assets/{dist-WyXdYl-w.js → dist-DnXWNQRm.js} +1 -1
  28. package/dist/apps/chat-ui/assets/{dist-BNMu92bb.js → dist-hU-2oAb6.js} +1 -1
  29. package/dist/apps/chat-ui/assets/{dist-BCB6zezO.js → dist-r31x5Fcc.js} +1 -1
  30. package/dist/apps/chat-ui/assets/{dist-HqTN67dc.js → dist-uF6UXzI7.js} +1 -1
  31. package/dist/apps/chat-ui/assets/index-CaTGYBOS.js +173 -0
  32. package/dist/apps/chat-ui/assets/{index-C0x9nEcf.css → index-al8DeEjA.css} +1 -1
  33. package/dist/apps/chat-ui/index.html +18 -18
  34. package/dist/apps/chat-ui/manifest.webmanifest +25 -25
  35. package/dist/apps/chat-ui/sw.js +47 -47
  36. package/dist/apps/chat-vscode-web/assets/index-CK4SMZuu.js +41 -0
  37. package/dist/apps/chat-vscode-web/index.html +13 -13
  38. package/dist/apps/cli-ui/cliSessionsCommand.js +23 -23
  39. package/dist/apps/context-files-ui/index.html +11 -11
  40. package/dist/cli-session/localSessionSource.js +34 -12
  41. package/dist/cli.js +61 -44
  42. package/dist/compute/cli.js +54 -54
  43. package/dist/compute/resource-health.js +35 -2
  44. package/dist/core/events.js +6 -1
  45. package/dist/core/routed-session.js +97 -5
  46. package/dist/core/runtime.js +6 -1
  47. package/dist/core/session-router.js +27 -8
  48. package/dist/cron/cli.js +15 -15
  49. package/dist/cron/store.js +49 -49
  50. package/dist/data/cli.js +23 -23
  51. package/dist/data/event-log.js +23 -23
  52. package/dist/data/ingest-service.js +3 -1
  53. package/dist/data/message-store.js +27 -27
  54. package/dist/data/navigation-store.js +9 -9
  55. package/dist/data/observation-store.js +4 -4
  56. package/dist/data/payload-store.js +17 -17
  57. package/dist/data/schema.js +433 -433
  58. package/dist/data/session-store.js +4 -4
  59. package/dist/data/telemetry-queries.js +54 -54
  60. package/dist/data/telemetry.js +197 -197
  61. package/dist/debug/events.js +12 -12
  62. package/dist/debug/failures.js +6 -6
  63. package/dist/debug/index.js +231 -227
  64. package/dist/debug/messages.js +6 -6
  65. package/dist/debug/pty.js +124 -124
  66. package/dist/debug/session.js +29 -29
  67. package/dist/debug/tools.js +5 -5
  68. package/dist/debug/trace.js +42 -7
  69. package/dist/debug/web-snapshot-browser-scripts.js +294 -294
  70. package/dist/debug/web-streaming-browser-library.js +925 -925
  71. package/dist/debug/web-streaming-browser-scripts.js +232 -232
  72. package/dist/debug/web-streaming-provider-telemetry.js +4 -4
  73. package/dist/debug/web.js +93 -93
  74. package/dist/gateway/cli.js +19 -19
  75. package/dist/gateway/server.js +4 -2
  76. package/dist/gateway/web.js +2 -2
  77. package/dist/index.js +1 -0
  78. package/dist/loops/accounting.js +19 -0
  79. package/dist/loops/channel.js +8 -0
  80. package/dist/loops/cli.js +224 -0
  81. package/dist/loops/plugin.js +16 -0
  82. package/dist/loops/prompts.js +86 -0
  83. package/dist/loops/service.js +446 -0
  84. package/dist/loops/stopping.js +170 -0
  85. package/dist/loops/store.js +642 -0
  86. package/dist/loops/templates.js +232 -0
  87. package/dist/loops/tools.js +184 -0
  88. package/dist/loops/types.js +1 -0
  89. package/dist/mcp/config-command.js +53 -53
  90. package/dist/mcp/index.js +21 -21
  91. package/dist/mcp/registry.js +11 -11
  92. package/dist/pi-packages/cli.js +11 -11
  93. package/dist/plugins/builtin.js +8 -0
  94. package/dist/plugins/context-files-store.js +110 -110
  95. package/dist/plugins/context-files.js +4 -4
  96. package/dist/plugins/registry.js +23 -12
  97. package/dist/ralph/cli.js +18 -18
  98. package/dist/ralph/templates.js +140 -140
  99. package/dist/reliability/store.js +256 -229
  100. package/dist/runs/lifecycle.js +59 -0
  101. package/dist/runs/registry.js +47 -1
  102. package/dist/runs/tools.js +31 -13
  103. package/dist/session-ui/terminalRows.js +66 -2
  104. package/dist/sessions/pibo-data-store.js +16 -16
  105. package/dist/sessions/sqlite-store.js +53 -53
  106. package/dist/setup/cli.js +58 -58
  107. package/dist/shared/trace-async-agent-runs.js +4 -4
  108. package/dist/shared/trace-event-projection.js +59 -19
  109. package/dist/shared/trace-nodes.js +5 -0
  110. package/dist/shared/trace-page-merge.js +15 -0
  111. package/dist/shared/trace-run-notifications.js +3 -1
  112. package/dist/signals/projector.js +6 -2
  113. package/dist/tools/agent-browser-wrapper.js +80 -80
  114. package/dist/tools/browser-pool.js +50 -0
  115. package/dist/tools/browser-use-cdp.js +12 -12
  116. package/dist/tools/browser-use-leases.js +12 -8
  117. package/dist/tools/browser-use-wrapper.js +762 -762
  118. package/dist/tools/guides.js +596 -538
  119. package/dist/tools/index.js +123 -99
  120. package/dist/tools/registry.js +21 -3
  121. package/dist/tools/runtime/node-worker-source.js +205 -205
  122. package/dist/tools/runtime/python-worker-source.js +177 -177
  123. package/dist/vscode/cli.js +9 -9
  124. package/dist/web-annotations/cdp.js +900 -900
  125. package/dist/web-annotations/store.js +96 -96
  126. package/docs/README.md +23 -23
  127. package/docs/ops/install-developer-host.md +112 -112
  128. package/docs/ops/install-user-host.md +96 -96
  129. package/docs/ops/upgrade-user-to-developer-host.md +69 -69
  130. package/docs/ops/vscode-extension-release.md +160 -160
  131. package/package.json +99 -95
  132. package/skills/builtin/graphify/SKILL.md +52 -52
  133. package/skills/builtin/loop/SKILL.md +78 -0
  134. package/skills/builtin/pi-agent-harness/SKILL.md +319 -319
  135. package/skills/builtin/pi-agent-harness/agents/openai.yaml +4 -4
  136. package/skills/builtin/pibo-docker-system/SKILL.md +170 -170
  137. package/skills/builtin/pibo-spec-writing/SKILL.md +330 -330
  138. package/skills/builtin/prd/SKILL.md +143 -143
  139. package/skills/builtin/ralph-loop/SKILL.md +361 -359
  140. package/skills/builtin/ralph-prd-json/SKILL.md +123 -123
  141. package/skills/builtin/skill-creator/LICENSE.txt +201 -201
  142. package/skills/builtin/skill-creator/SKILL.md +513 -513
  143. package/skills/builtin/skill-creator/agents/analyzer.md +274 -274
  144. package/skills/builtin/skill-creator/agents/comparator.md +202 -202
  145. package/skills/builtin/skill-creator/agents/grader.md +223 -223
  146. package/skills/builtin/skill-creator/assets/eval_review.html +146 -146
  147. package/skills/builtin/skill-creator/eval-viewer/generate_review.py +471 -471
  148. package/skills/builtin/skill-creator/eval-viewer/viewer.html +1325 -1325
  149. package/skills/builtin/skill-creator/references/schemas.md +430 -430
  150. package/skills/builtin/skill-creator/scripts/aggregate_benchmark.py +401 -401
  151. package/skills/builtin/skill-creator/scripts/generate_report.py +326 -326
  152. package/skills/builtin/skill-creator/scripts/improve_description.py +247 -247
  153. package/skills/builtin/skill-creator/scripts/package_skill.py +136 -136
  154. package/skills/builtin/skill-creator/scripts/quick_validate.py +102 -102
  155. package/skills/builtin/skill-creator/scripts/run_eval.py +310 -310
  156. package/skills/builtin/skill-creator/scripts/run_loop.py +328 -328
  157. package/skills/builtin/skill-creator/scripts/utils.py +47 -47
  158. package/skills/builtin/web-annotations/SKILL.md +93 -93
  159. package/src/mcp/LICENSE.mcp-cli +21 -21
  160. package/dist/apps/chat-ui/assets/index-DwHJfmiF.js +0 -173
  161. package/dist/apps/chat-vscode-web/assets/index-BAMxIaI_.js +0 -41
  162. package/dist/apps/vscode-artifacts/latest.vsix +0 -0
  163. package/dist/apps/vscode-artifacts/pibo-vscode-ext-1.9.13.vsix +0 -0
@@ -985,6 +985,10 @@ function compactRunRow(run) {
985
985
  policy: run.completionPolicy,
986
986
  consumed: run.consumed,
987
987
  updatedAt: run.updatedAt,
988
+ timeoutMs: run.timeoutMs,
989
+ timeoutAt: run.timeoutAt,
990
+ timeoutPhase: run.timeoutPhase,
991
+ serviceWarning: run.serviceWarning,
988
992
  summary: run.summary,
989
993
  };
990
994
  }
@@ -1010,275 +1014,275 @@ function payloadType(payload) {
1010
1014
  return typeof candidate.type === "string" ? candidate.type : undefined;
1011
1015
  }
1012
1016
  function printDebugDiscovery() {
1013
- console.log(`pibo debug - inspect local Pibo data
1014
-
1015
- Commands:
1016
- db Inspect and query local SQLite stores
1017
- session Inspect one Pibo Session by id or Chat URL
1018
- summary Show compact session diagnosis and drill-down commands
1019
- messages List or show stored user/assistant messages
1020
- final Show the latest assistant message
1021
- trace Rebuild the Chat Web trace view for one Pibo Session
1022
- events Inspect compact event payload fields for one Pibo Session
1023
- tool Inspect one grouped tool call
1024
- failures List failed tool calls and trace/session errors
1025
- jobs Inspect durable Pibo jobs and DLQ
1026
- runs Inspect durable yielded runs
1027
- resources Show gateway memory reserve, related child processes, and heavy daemons
1028
- signals Inspect live session signal snapshots through Chat Web APIs
1029
- telemetry Inspect runtime observability telemetry
1030
- web Inspect browser render state via CDP
1031
- pty Run and inspect interactive CLI/TUI commands under a PTY
1032
-
1033
- Next:
1034
- pibo debug db
1035
- pibo debug summary <pibo-session-id>
1036
- pibo debug final <pibo-session-id>
1037
- pibo debug messages <pibo-session-id> list
1038
- pibo debug trace <pibo-session-id> --running-only
1039
- pibo debug events stream --topic pibo.output
1040
- pibo debug resources --json
1041
- pibo debug signals tree ps_...
1042
- pibo debug telemetry sessions --active
1043
- pibo debug web targets
1044
- pibo debug pty run -- pibo tui:sessions --demo
1017
+ console.log(`pibo debug - inspect local Pibo data
1018
+
1019
+ Commands:
1020
+ db Inspect and query local SQLite stores
1021
+ session Inspect one Pibo Session by id or Chat URL
1022
+ summary Show compact session diagnosis and drill-down commands
1023
+ messages List or show stored user/assistant messages
1024
+ final Show the latest assistant message
1025
+ trace Rebuild the Chat Web trace view for one Pibo Session
1026
+ events Inspect compact event payload fields for one Pibo Session
1027
+ tool Inspect one grouped tool call
1028
+ failures List failed tool calls and trace/session errors
1029
+ jobs Inspect durable Pibo jobs and DLQ
1030
+ runs Inspect durable yielded runs
1031
+ resources Show gateway memory reserve, related child processes, and heavy daemons
1032
+ signals Inspect live session signal snapshots through Chat Web APIs
1033
+ telemetry Inspect runtime observability telemetry
1034
+ web Inspect browser render state via CDP
1035
+ pty Run and inspect interactive CLI/TUI commands under a PTY
1036
+
1037
+ Next:
1038
+ pibo debug db
1039
+ pibo debug summary <pibo-session-id>
1040
+ pibo debug final <pibo-session-id>
1041
+ pibo debug messages <pibo-session-id> list
1042
+ pibo debug trace <pibo-session-id> --running-only
1043
+ pibo debug events stream --topic pibo.output
1044
+ pibo debug resources --json
1045
+ pibo debug signals tree ps_...
1046
+ pibo debug telemetry sessions --active
1047
+ pibo debug web targets
1048
+ pibo debug pty run -- pibo tui:sessions --demo
1045
1049
  `);
1046
1050
  }
1047
1051
  function printDebugResourcesDiscovery() {
1048
- console.log(`pibo debug resources - inspect gateway resource guard state
1049
-
1050
- Usage:
1051
- pibo debug resources [--json]
1052
-
1053
- Reports:
1054
- Gateway RSS/heap headroom, host free-memory reserve, direct child processes, and known heavy local daemons such as ComfyUI or Unity when process listing is available.
1055
-
1056
- Environment:
1057
- PIBO_GATEWAY_RESOURCE_GUARD=warn|block|off
1058
- PIBO_GATEWAY_MIN_FREE_MEMORY_BYTES=<bytes>
1059
- PIBO_GATEWAY_MIN_HEAP_AVAILABLE_BYTES=<bytes>
1060
- PIBO_GATEWAY_MAX_RSS_BYTES=<bytes>
1061
- PIBO_GATEWAY_KNOWN_DAEMON_WARNING_RSS_BYTES=<bytes>
1062
-
1063
- Next:
1064
- pibo debug resources --json
1065
- pibo compute health --json
1052
+ console.log(`pibo debug resources - inspect gateway resource guard state
1053
+
1054
+ Usage:
1055
+ pibo debug resources [--json]
1056
+
1057
+ Reports:
1058
+ Gateway RSS/heap headroom, host free-memory reserve, direct child processes, and known heavy local daemons such as ComfyUI or Unity when process listing is available.
1059
+
1060
+ Environment:
1061
+ PIBO_GATEWAY_RESOURCE_GUARD=warn|block|off
1062
+ PIBO_GATEWAY_MIN_FREE_MEMORY_BYTES=<bytes>
1063
+ PIBO_GATEWAY_MIN_HEAP_AVAILABLE_BYTES=<bytes>
1064
+ PIBO_GATEWAY_MAX_RSS_BYTES=<bytes>
1065
+ PIBO_GATEWAY_KNOWN_DAEMON_WARNING_RSS_BYTES=<bytes>
1066
+
1067
+ Next:
1068
+ pibo debug resources --json
1069
+ pibo compute health --json
1066
1070
  `);
1067
1071
  }
1068
1072
  function printDebugSignalsDiscovery() {
1069
- console.log(`pibo debug signals - inspect live Session Signal snapshots
1070
-
1071
- Usage:
1072
- pibo debug signals session <pibo-session-id> [--json] [--cookie <path>]
1073
- pibo debug signals tree <root-pibo-session-id> [--json] [--cookie <path>]
1074
-
1075
- Environment:
1076
- PIBO_GATEWAY_URL=http://127.0.0.1:4788
1077
-
1078
- Auth:
1079
- --cookie <path> reads a Cookie header value from a local file.
1080
- --auth-header <value> sends an Authorization header. Values are not printed.
1081
-
1082
- Next:
1083
- pibo debug signals tree ps_...
1073
+ console.log(`pibo debug signals - inspect live Session Signal snapshots
1074
+
1075
+ Usage:
1076
+ pibo debug signals session <pibo-session-id> [--json] [--cookie <path>]
1077
+ pibo debug signals tree <root-pibo-session-id> [--json] [--cookie <path>]
1078
+
1079
+ Environment:
1080
+ PIBO_GATEWAY_URL=http://127.0.0.1:4788
1081
+
1082
+ Auth:
1083
+ --cookie <path> reads a Cookie header value from a local file.
1084
+ --auth-header <value> sends an Authorization header. Values are not printed.
1085
+
1086
+ Next:
1087
+ pibo debug signals tree ps_...
1084
1088
  `);
1085
1089
  }
1086
1090
  function printDebugTelemetryDiscovery() {
1087
- console.log(`pibo debug telemetry - inspect bounded runtime observability telemetry
1088
-
1089
- Usage:
1090
- pibo debug telemetry sessions [--active] [--stale] [--limit n] [--json]
1091
- pibo debug telemetry session <pibo-session-id> [--limit n] [--json]
1092
- pibo debug telemetry turn <turn-id-or-event-id> [--events] [--limit n] [--json]
1093
- pibo debug telemetry provider <provider-request-id> [--json]
1094
- pibo debug telemetry provider <provider-request-id> events [--after seq] [--fields a,b] [--limit n] [--json]
1095
- pibo debug telemetry provider <provider-request-id> payload <preview-or-event-summary-id> [--json]
1096
- pibo debug telemetry tool <tool-call-id> [--json]
1097
- pibo debug telemetry stale [--threshold-ms n] [--limit n] [--json]
1098
- pibo debug telemetry stats [--retention class] [--json]
1099
- pibo debug telemetry prune --retention class --before iso-date [--dry-run|--apply] [--json]
1100
-
1101
- Commands:
1102
- sessions List recent, active, or stale telemetry sessions
1103
- session Show compact session telemetry and next turn/provider/tool commands
1104
- turn Show a phase timeline for one turn or event id
1105
- provider Show provider request summary, event pages, and preview-unavailable diagnostics
1106
- tool Show tool-call argument and execution telemetry
1107
- stale List read-only stale active work
1108
- stats Show telemetry retention counts and byte estimates
1109
- prune Dry-run telemetry retention cleanup unless --apply is explicit
1110
-
1111
- Next:
1112
- pibo debug telemetry sessions --active
1113
- pibo debug telemetry session ps_...
1114
- pibo debug telemetry turn turn_...
1115
- pibo debug telemetry provider pr_... events --limit 20
1091
+ console.log(`pibo debug telemetry - inspect bounded runtime observability telemetry
1092
+
1093
+ Usage:
1094
+ pibo debug telemetry sessions [--active] [--stale] [--limit n] [--json]
1095
+ pibo debug telemetry session <pibo-session-id> [--limit n] [--json]
1096
+ pibo debug telemetry turn <turn-id-or-event-id> [--events] [--limit n] [--json]
1097
+ pibo debug telemetry provider <provider-request-id> [--json]
1098
+ pibo debug telemetry provider <provider-request-id> events [--after seq] [--fields a,b] [--limit n] [--json]
1099
+ pibo debug telemetry provider <provider-request-id> payload <preview-or-event-summary-id> [--json]
1100
+ pibo debug telemetry tool <tool-call-id> [--json]
1101
+ pibo debug telemetry stale [--threshold-ms n] [--limit n] [--json]
1102
+ pibo debug telemetry stats [--retention class] [--json]
1103
+ pibo debug telemetry prune --retention class --before iso-date [--dry-run|--apply] [--json]
1104
+
1105
+ Commands:
1106
+ sessions List recent, active, or stale telemetry sessions
1107
+ session Show compact session telemetry and next turn/provider/tool commands
1108
+ turn Show a phase timeline for one turn or event id
1109
+ provider Show provider request summary, event pages, and preview-unavailable diagnostics
1110
+ tool Show tool-call argument and execution telemetry
1111
+ stale List read-only stale active work
1112
+ stats Show telemetry retention counts and byte estimates
1113
+ prune Dry-run telemetry retention cleanup unless --apply is explicit
1114
+
1115
+ Next:
1116
+ pibo debug telemetry sessions --active
1117
+ pibo debug telemetry session ps_...
1118
+ pibo debug telemetry turn turn_...
1119
+ pibo debug telemetry provider pr_... events --limit 20
1116
1120
  `);
1117
1121
  }
1118
1122
  function printDebugDbDiscovery() {
1119
- console.log(`pibo debug db - inspect local SQLite stores
1120
-
1121
- Stores:
1122
- home ${getPiboHome()}
1123
- pibo-data pibo.sqlite unified sessions, rooms, events, messages, observations, navigation, stats
1124
- sessions pibo.sqlite V2 alias for session metadata
1125
- chat pibo.sqlite V2 alias for Chat Web data
1126
- agents chat-agents.sqlite
1127
- auth auth.sqlite
1128
- bindings session-bindings.sqlite
1129
- reliability pibo-events.sqlite
1130
-
1131
- Commands:
1132
- stores List known stores and paths
1133
- tables <store> List tables only
1134
- schema <store> List tables and columns
1135
- query <store> <sql> Run read-only SQL
1136
-
1137
- Next:
1138
- pibo debug db schema pibo-data
1139
- pibo debug db query pibo-data "select id, profile from sessions limit 5"
1123
+ console.log(`pibo debug db - inspect local SQLite stores
1124
+
1125
+ Stores:
1126
+ home ${getPiboHome()}
1127
+ pibo-data pibo.sqlite unified sessions, rooms, events, messages, observations, navigation, stats
1128
+ sessions pibo.sqlite V2 alias for session metadata
1129
+ chat pibo.sqlite V2 alias for Chat Web data
1130
+ agents chat-agents.sqlite
1131
+ auth auth.sqlite
1132
+ bindings session-bindings.sqlite
1133
+ reliability pibo-events.sqlite
1134
+
1135
+ Commands:
1136
+ stores List known stores and paths
1137
+ tables <store> List tables only
1138
+ schema <store> List tables and columns
1139
+ query <store> <sql> Run read-only SQL
1140
+
1141
+ Next:
1142
+ pibo debug db schema pibo-data
1143
+ pibo debug db query pibo-data "select id, profile from sessions limit 5"
1140
1144
  `);
1141
1145
  }
1142
1146
  function printDebugSessionDiscovery() {
1143
- console.log(`pibo debug session - inspect one Pibo Session
1144
-
1145
- Usage:
1146
- pibo debug session <url-or-pibo-session-id> [--events] [--limit n] [--json]
1147
-
1148
- Inputs:
1149
- ps_...
1150
- /apps/chat/rooms/<roomId>/sessions/<piboSessionId>
1151
- /apps/chat/sessions/<piboSessionId>
1152
-
1153
- Next:
1154
- pibo debug session ps_...
1147
+ console.log(`pibo debug session - inspect one Pibo Session
1148
+
1149
+ Usage:
1150
+ pibo debug session <url-or-pibo-session-id> [--events] [--limit n] [--json]
1151
+
1152
+ Inputs:
1153
+ ps_...
1154
+ /apps/chat/rooms/<roomId>/sessions/<piboSessionId>
1155
+ /apps/chat/sessions/<piboSessionId>
1156
+
1157
+ Next:
1158
+ pibo debug session ps_...
1155
1159
  `);
1156
1160
  }
1157
1161
  function printDebugSummaryDiscovery() {
1158
- console.log(`pibo debug summary - compact diagnosis with drill-down commands
1159
-
1160
- Usage:
1161
- pibo debug summary <pibo-session-id> [--json]
1162
-
1163
- Next:
1164
- pibo debug final ps_...
1165
- pibo debug failures ps_...
1166
- pibo debug messages ps_... list
1162
+ console.log(`pibo debug summary - compact diagnosis with drill-down commands
1163
+
1164
+ Usage:
1165
+ pibo debug summary <pibo-session-id> [--json]
1166
+
1167
+ Next:
1168
+ pibo debug final ps_...
1169
+ pibo debug failures ps_...
1170
+ pibo debug messages ps_... list
1167
1171
  `);
1168
1172
  }
1169
1173
  function printDebugMessagesDiscovery() {
1170
- console.log(`pibo debug messages - list or show stored chat messages
1171
-
1172
- Usage:
1173
- pibo debug messages <pibo-session-id> list [--limit n] [--json]
1174
- pibo debug messages <pibo-session-id> show <selector> [--full|--no-truncate] [--from n --bytes n] [--max-bytes n] [--plain] [--json]
1175
-
1176
- Selectors:
1177
- 1, last, assistant:last, user:last, stream:<stream-id>, msg:<event-id>
1178
-
1179
- Next:
1180
- pibo debug messages ps_... list
1181
- pibo debug messages ps_... show assistant:last --full
1174
+ console.log(`pibo debug messages - list or show stored chat messages
1175
+
1176
+ Usage:
1177
+ pibo debug messages <pibo-session-id> list [--limit n] [--json]
1178
+ pibo debug messages <pibo-session-id> show <selector> [--full|--no-truncate] [--from n --bytes n] [--max-bytes n] [--plain] [--json]
1179
+
1180
+ Selectors:
1181
+ 1, last, assistant:last, user:last, stream:<stream-id>, msg:<event-id>
1182
+
1183
+ Next:
1184
+ pibo debug messages ps_... list
1185
+ pibo debug messages ps_... show assistant:last --full
1182
1186
  `);
1183
1187
  }
1184
1188
  function printDebugFinalDiscovery() {
1185
- console.log(`pibo debug final - show the latest assistant message
1186
-
1187
- Usage:
1188
- pibo debug final <pibo-session-id> [--max-bytes n] [--from n --bytes n] [--no-truncate] [--plain] [--json]
1189
-
1190
- Note:
1191
- Full messages may contain private data. Use --no-truncate intentionally.
1192
-
1193
- Next:
1194
- pibo debug final ps_...
1195
- pibo debug final ps_... --no-truncate
1189
+ console.log(`pibo debug final - show the latest assistant message
1190
+
1191
+ Usage:
1192
+ pibo debug final <pibo-session-id> [--max-bytes n] [--from n --bytes n] [--no-truncate] [--plain] [--json]
1193
+
1194
+ Note:
1195
+ Full messages may contain private data. Use --no-truncate intentionally.
1196
+
1197
+ Next:
1198
+ pibo debug final ps_...
1199
+ pibo debug final ps_... --no-truncate
1196
1200
  `);
1197
1201
  }
1198
1202
  function printDebugToolDiscovery() {
1199
- console.log(`pibo debug tool - inspect one grouped tool call
1200
-
1201
- Usage:
1202
- pibo debug tool <pibo-session-id> <tool-call-id> [--args|--output|--error] [--no-truncate] [--json]
1203
-
1204
- Next:
1205
- pibo debug failures ps_...
1206
- pibo debug tool ps_... call_... --output --no-truncate
1203
+ console.log(`pibo debug tool - inspect one grouped tool call
1204
+
1205
+ Usage:
1206
+ pibo debug tool <pibo-session-id> <tool-call-id> [--args|--output|--error] [--no-truncate] [--json]
1207
+
1208
+ Next:
1209
+ pibo debug failures ps_...
1210
+ pibo debug tool ps_... call_... --output --no-truncate
1207
1211
  `);
1208
1212
  }
1209
1213
  function printDebugFailuresDiscovery() {
1210
- console.log(`pibo debug failures - list failed tool calls and trace/session errors
1211
-
1212
- Usage:
1213
- pibo debug failures <pibo-session-id> [--limit n] [--json]
1214
-
1215
- Next:
1216
- pibo debug failures ps_...
1217
- pibo debug tool ps_... <tool-call-id> --output
1214
+ console.log(`pibo debug failures - list failed tool calls and trace/session errors
1215
+
1216
+ Usage:
1217
+ pibo debug failures <pibo-session-id> [--limit n] [--json]
1218
+
1219
+ Next:
1220
+ pibo debug failures ps_...
1221
+ pibo debug tool ps_... <tool-call-id> --output
1218
1222
  `);
1219
1223
  }
1220
1224
  function printDebugTraceDiscovery() {
1221
- console.log(`pibo debug trace - rebuild one Chat Web trace view
1222
-
1223
- Usage:
1224
- pibo debug trace <pibo-session-id> [--running-only] [--check] [--medium] [--json]
1225
- pibo debug trace <pibo-session-id> show <node-id> [--json]
1226
-
1227
- Output:
1228
- Compact trace nodes from the same buildTraceView logic used by /api/chat/trace.
1229
- --check adds consistency diagnostics for ids, parents, ordering, and links.
1230
-
1231
- Next:
1232
- pibo debug trace ps_... --check
1233
- pibo debug trace ps_... --medium
1234
- pibo debug trace ps_... show <node-id>
1225
+ console.log(`pibo debug trace - rebuild one Chat Web trace view
1226
+
1227
+ Usage:
1228
+ pibo debug trace <pibo-session-id> [--running-only] [--check] [--medium] [--json]
1229
+ pibo debug trace <pibo-session-id> show <node-id> [--json]
1230
+
1231
+ Output:
1232
+ Compact trace nodes from the same buildTraceView logic used by /api/chat/trace.
1233
+ --check adds consistency diagnostics for ids, parents, ordering, and links.
1234
+
1235
+ Next:
1236
+ pibo debug trace ps_... --check
1237
+ pibo debug trace ps_... --medium
1238
+ pibo debug trace ps_... show <node-id>
1235
1239
  `);
1236
1240
  }
1237
1241
  function printDebugEventsDiscovery() {
1238
- console.log(`pibo debug events - inspect compact event payload fields and Pibo event streams
1239
-
1240
- Usage:
1241
- pibo debug events <pibo-session-id> [list] [--type name] [--fields a,b.c] [--limit n] [--json]
1242
- pibo debug events <pibo-session-id> show <stream-id-or-event-id> [--payload|--raw] [--field path] [--no-truncate] [--json]
1243
- pibo debug events stream [--topic topic] [--after stream_id] [--limit n] [--json]
1244
- pibo debug events stats [--topic topic] [--session pibo-session-id] [--retention class] [--json]
1245
- pibo debug events prune --topic topic --retention class --before iso-date [--limit n] [--destructive] [--json]
1246
- pibo debug events compact-deltas [--dry-run|--apply] [--store pibo-data|chat|reliability] [--session ps_...] [--json]
1247
- pibo debug events consumers [--json]
1248
-
1249
- Examples:
1250
- pibo debug events ps_... --type tool_execution_finished --fields toolName,toolCallId,result.details.status
1251
- pibo debug events ps_... show 356910 --field attributes_json.inlinePayload
1252
-
1253
- Next:
1254
- pibo debug events ps_... --limit 20
1255
- pibo debug events ps_... show <stream-id> --payload
1256
- pibo debug events stats --topic pibo.output --retention live_delta
1257
- pibo debug events stream --topic pibo.output --after 123
1242
+ console.log(`pibo debug events - inspect compact event payload fields and Pibo event streams
1243
+
1244
+ Usage:
1245
+ pibo debug events <pibo-session-id> [list] [--type name] [--fields a,b.c] [--limit n] [--json]
1246
+ pibo debug events <pibo-session-id> show <stream-id-or-event-id> [--payload|--raw] [--field path] [--no-truncate] [--json]
1247
+ pibo debug events stream [--topic topic] [--after stream_id] [--limit n] [--json]
1248
+ pibo debug events stats [--topic topic] [--session pibo-session-id] [--retention class] [--json]
1249
+ pibo debug events prune --topic topic --retention class --before iso-date [--limit n] [--destructive] [--json]
1250
+ pibo debug events compact-deltas [--dry-run|--apply] [--store pibo-data|chat|reliability] [--session ps_...] [--json]
1251
+ pibo debug events consumers [--json]
1252
+
1253
+ Examples:
1254
+ pibo debug events ps_... --type tool_execution_finished --fields toolName,toolCallId,result.details.status
1255
+ pibo debug events ps_... show 356910 --field attributes_json.inlinePayload
1256
+
1257
+ Next:
1258
+ pibo debug events ps_... --limit 20
1259
+ pibo debug events ps_... show <stream-id> --payload
1260
+ pibo debug events stats --topic pibo.output --retention live_delta
1261
+ pibo debug events stream --topic pibo.output --after 123
1258
1262
  `);
1259
1263
  }
1260
1264
  function printDebugJobsDiscovery() {
1261
- console.log(`pibo debug jobs - inspect durable Pibo jobs
1262
-
1263
- Usage:
1264
- pibo debug jobs list [--queue queue] [--limit n] [--json]
1265
- pibo debug jobs dead [--queue queue] [--limit n] [--json]
1266
- pibo debug jobs replay <job-id> [--json]
1267
-
1268
- Next:
1269
- pibo debug jobs list --queue runs
1270
- pibo debug jobs dead --queue runs
1265
+ console.log(`pibo debug jobs - inspect durable Pibo jobs
1266
+
1267
+ Usage:
1268
+ pibo debug jobs list [--queue queue] [--limit n] [--json]
1269
+ pibo debug jobs dead [--queue queue] [--limit n] [--json]
1270
+ pibo debug jobs replay <job-id> [--json]
1271
+
1272
+ Next:
1273
+ pibo debug jobs list --queue runs
1274
+ pibo debug jobs dead --queue runs
1271
1275
  `);
1272
1276
  }
1273
1277
  function printDebugRunsDiscovery() {
1274
- console.log(`pibo debug runs - inspect durable yielded runs
1275
-
1276
- Usage:
1277
- pibo debug runs list <pibo-session-id> [--json]
1278
- pibo debug runs inspect <run-id> [--json]
1279
-
1280
- Next:
1281
- pibo debug runs list ps_...
1278
+ console.log(`pibo debug runs - inspect durable yielded runs
1279
+
1280
+ Usage:
1281
+ pibo debug runs list <pibo-session-id> [--json]
1282
+ pibo debug runs inspect <run-id> [--json]
1283
+
1284
+ Next:
1285
+ pibo debug runs list ps_...
1282
1286
  `);
1283
1287
  }
1284
1288
  function formatSchemaText(tables) {
@@ -103,12 +103,12 @@ function readMessages(piboSessionId, store, limit) {
103
103
  try {
104
104
  if (!tableExists(db, "event_log"))
105
105
  return { rows: [], limited: false };
106
- const rows = db.prepare(`
107
- SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json
108
- FROM event_log
109
- WHERE session_id = ?
110
- ORDER BY stream_id ASC
111
- LIMIT ?
106
+ const rows = db.prepare(`
107
+ SELECT stream_id, session_id, session_sequence, event_id, type, created_at, preview_text, attributes_json
108
+ FROM event_log
109
+ WHERE session_id = ?
110
+ ORDER BY stream_id ASC
111
+ LIMIT ?
112
112
  `).all(piboSessionId, limit + 1);
113
113
  const messages = [];
114
114
  for (const row of rows) {