pi-crew 0.1.51 → 0.2.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 (240) hide show
  1. package/CHANGELOG.md +56 -1
  2. package/README.md +176 -781
  3. package/agents/analyst.md +11 -11
  4. package/agents/critic.md +11 -11
  5. package/agents/executor.md +11 -11
  6. package/agents/explorer.md +11 -11
  7. package/agents/planner.md +11 -11
  8. package/agents/reviewer.md +11 -11
  9. package/agents/security-reviewer.md +11 -11
  10. package/agents/test-engineer.md +11 -11
  11. package/agents/verifier.md +70 -11
  12. package/agents/writer.md +11 -11
  13. package/docs/actions-reference.md +595 -0
  14. package/docs/commands-reference.md +347 -0
  15. package/docs/runtime-flow.md +148 -148
  16. package/index.ts +6 -6
  17. package/package.json +99 -99
  18. package/skills/async-worker-recovery/SKILL.md +42 -42
  19. package/skills/context-artifact-hygiene/SKILL.md +52 -52
  20. package/skills/delegation-patterns/SKILL.md +54 -54
  21. package/skills/mailbox-interactive/SKILL.md +40 -40
  22. package/skills/model-routing-context/SKILL.md +39 -39
  23. package/skills/multi-perspective-review/SKILL.md +58 -58
  24. package/skills/observability-reliability/SKILL.md +41 -41
  25. package/skills/orchestration/SKILL.md +157 -157
  26. package/skills/ownership-session-security/SKILL.md +41 -41
  27. package/skills/pi-extension-lifecycle/SKILL.md +39 -39
  28. package/skills/requirements-to-task-packet/SKILL.md +63 -63
  29. package/skills/resource-discovery-config/SKILL.md +41 -41
  30. package/skills/runtime-state-reader/SKILL.md +44 -44
  31. package/skills/secure-agent-orchestration-review/SKILL.md +45 -45
  32. package/skills/state-mutation-locking/SKILL.md +42 -42
  33. package/skills/systematic-debugging/SKILL.md +67 -67
  34. package/skills/ui-render-performance/SKILL.md +39 -39
  35. package/skills/verification-before-done/SKILL.md +57 -57
  36. package/skills/worktree-isolation/SKILL.md +39 -39
  37. package/src/adapters/claude-adapter.ts +25 -0
  38. package/src/adapters/codex-adapter.ts +21 -0
  39. package/src/adapters/cursor-adapter.ts +17 -0
  40. package/src/adapters/export-util.ts +137 -0
  41. package/src/adapters/index.ts +15 -0
  42. package/src/adapters/registry.ts +18 -0
  43. package/src/adapters/types.ts +23 -0
  44. package/src/agents/agent-config.ts +2 -0
  45. package/src/agents/agent-search.ts +98 -98
  46. package/src/agents/discover-agents.ts +2 -1
  47. package/src/config/config.ts +13 -1
  48. package/src/config/drift-detector.ts +211 -0
  49. package/src/config/markers.ts +327 -0
  50. package/src/config/resilient-parser.ts +108 -0
  51. package/src/config/suggestions.ts +74 -0
  52. package/src/extension/cross-extension-rpc.ts +103 -94
  53. package/src/extension/project-init.ts +21 -1
  54. package/src/extension/register.ts +45 -14
  55. package/src/extension/registration/commands.ts +77 -8
  56. package/src/extension/registration/subagent-tools.ts +10 -1
  57. package/src/extension/registration/team-tool.ts +10 -1
  58. package/src/extension/registration/viewers.ts +48 -34
  59. package/src/extension/run-bundle-schema.ts +89 -89
  60. package/src/extension/run-import.ts +25 -1
  61. package/src/extension/run-index.ts +5 -1
  62. package/src/extension/run-maintenance.ts +142 -68
  63. package/src/extension/team-manager-command.ts +10 -1
  64. package/src/extension/team-tool/api.ts +441 -441
  65. package/src/extension/team-tool/doctor.ts +28 -3
  66. package/src/extension/team-tool/handle-settings.ts +195 -188
  67. package/src/extension/team-tool/inspect.ts +41 -41
  68. package/src/extension/team-tool/intent-policy.ts +42 -42
  69. package/src/extension/team-tool/lifecycle-actions.ts +27 -8
  70. package/src/extension/team-tool/plan.ts +19 -19
  71. package/src/extension/team-tool/run.ts +12 -1
  72. package/src/extension/team-tool.ts +332 -322
  73. package/src/i18n.ts +184 -184
  74. package/src/observability/exporters/otlp-exporter.ts +92 -77
  75. package/src/prompt/prompt-runtime.ts +72 -72
  76. package/src/runtime/agent-memory.ts +72 -72
  77. package/src/runtime/agent-observability.ts +114 -114
  78. package/src/runtime/async-marker.ts +26 -26
  79. package/src/runtime/attention-events.ts +28 -28
  80. package/src/runtime/auto-resume.ts +100 -0
  81. package/src/runtime/background-runner.ts +11 -1
  82. package/src/runtime/cancellation-token.ts +89 -89
  83. package/src/runtime/cancellation.ts +61 -61
  84. package/src/runtime/capability-inventory.ts +116 -116
  85. package/src/runtime/child-pi.ts +7 -2
  86. package/src/runtime/compaction-summary.ts +271 -0
  87. package/src/runtime/completion-guard.ts +190 -190
  88. package/src/runtime/crash-recovery.ts +33 -1
  89. package/src/runtime/delta-conflict.ts +360 -0
  90. package/src/runtime/direct-run.ts +35 -35
  91. package/src/runtime/foreground-control.ts +82 -82
  92. package/src/runtime/green-contract.ts +46 -46
  93. package/src/runtime/group-join.ts +106 -106
  94. package/src/runtime/heartbeat-gradient.ts +28 -28
  95. package/src/runtime/heartbeat-watcher.ts +124 -124
  96. package/src/runtime/iteration-hooks.ts +264 -0
  97. package/src/runtime/live-agent-control.ts +88 -88
  98. package/src/runtime/live-control-realtime.ts +36 -36
  99. package/src/runtime/live-extension-bridge.ts +150 -150
  100. package/src/runtime/live-irc.ts +92 -92
  101. package/src/runtime/live-session-health.ts +100 -100
  102. package/src/runtime/loop-gates.ts +129 -0
  103. package/src/runtime/metric-parser.ts +40 -0
  104. package/src/runtime/notebook-helpers.ts +90 -90
  105. package/src/runtime/orphan-sentinel.ts +7 -7
  106. package/src/runtime/parallel-research.ts +44 -44
  107. package/src/runtime/phase-progress.ts +217 -0
  108. package/src/runtime/pi-args.ts +38 -11
  109. package/src/runtime/pi-json-output.ts +111 -111
  110. package/src/runtime/pi-spawn.ts +57 -7
  111. package/src/runtime/policy-engine.ts +79 -79
  112. package/src/runtime/post-checks.ts +122 -0
  113. package/src/runtime/progress-event-coalescer.ts +43 -43
  114. package/src/runtime/prose-compressor.ts +164 -164
  115. package/src/runtime/recovery-recipes.ts +74 -74
  116. package/src/runtime/result-extractor.ts +121 -121
  117. package/src/runtime/role-permission.ts +39 -39
  118. package/src/runtime/sensitive-paths.ts +2 -2
  119. package/src/runtime/session-resources.ts +25 -25
  120. package/src/runtime/session-snapshot.ts +59 -59
  121. package/src/runtime/session-usage.ts +79 -79
  122. package/src/runtime/sidechain-output.ts +29 -29
  123. package/src/runtime/stream-preview.ts +177 -177
  124. package/src/runtime/supervisor-contact.ts +59 -59
  125. package/src/runtime/task-display.ts +38 -38
  126. package/src/runtime/task-graph.ts +207 -0
  127. package/src/runtime/task-quality.ts +207 -0
  128. package/src/runtime/task-runner/capabilities.ts +78 -78
  129. package/src/runtime/task-runner/live-executor.ts +7 -1
  130. package/src/runtime/task-runner/progress.ts +119 -119
  131. package/src/runtime/task-runner/prompt-pipeline.ts +64 -64
  132. package/src/runtime/task-runner/result-utils.ts +14 -14
  133. package/src/runtime/task-runner/run-projection.ts +103 -103
  134. package/src/runtime/task-runner/state-helpers.ts +22 -22
  135. package/src/runtime/team-runner.ts +117 -7
  136. package/src/runtime/worker-heartbeat.ts +21 -21
  137. package/src/runtime/worker-startup.ts +57 -57
  138. package/src/runtime/workflow-state.ts +187 -0
  139. package/src/runtime/workspace-tree.ts +298 -298
  140. package/src/schema/config-schema.ts +11 -0
  141. package/src/schema/validation-types.ts +148 -0
  142. package/src/skills/skill-templates.ts +374 -0
  143. package/src/state/active-run-registry.ts +35 -11
  144. package/src/state/atomic-write.ts +33 -26
  145. package/src/state/contracts.ts +1 -0
  146. package/src/state/event-reconstructor.ts +217 -0
  147. package/src/state/locks.ts +2 -13
  148. package/src/state/mailbox.ts +4 -3
  149. package/src/state/state-store.ts +16 -6
  150. package/src/state/task-claims.ts +44 -44
  151. package/src/state/types.ts +9 -0
  152. package/src/state/usage.ts +29 -29
  153. package/src/subagents/async-entry.ts +1 -1
  154. package/src/subagents/index.ts +3 -3
  155. package/src/subagents/live/control.ts +1 -1
  156. package/src/subagents/live/manager.ts +1 -1
  157. package/src/subagents/live/realtime.ts +1 -1
  158. package/src/subagents/live/session-runtime.ts +1 -1
  159. package/src/subagents/manager.ts +1 -1
  160. package/src/subagents/spawn.ts +1 -1
  161. package/src/teams/team-serializer.ts +38 -38
  162. package/src/types/diff.d.ts +18 -18
  163. package/src/ui/crew-footer.ts +101 -101
  164. package/src/ui/crew-select-list.ts +111 -111
  165. package/src/ui/crew-widget.ts +5 -2
  166. package/src/ui/dashboard-panes/cancellation-pane.ts +42 -42
  167. package/src/ui/dashboard-panes/capability-pane.ts +59 -59
  168. package/src/ui/dashboard-panes/mailbox-pane.ts +35 -35
  169. package/src/ui/dashboard-panes/metrics-pane.ts +34 -34
  170. package/src/ui/dashboard-panes/progress-pane.ts +11 -0
  171. package/src/ui/dynamic-border.ts +25 -25
  172. package/src/ui/layout-primitives.ts +106 -106
  173. package/src/ui/loaders.ts +158 -158
  174. package/src/ui/render-coalescer.ts +51 -51
  175. package/src/ui/render-diff.ts +119 -119
  176. package/src/ui/render-scheduler.ts +143 -143
  177. package/src/ui/run-action-dispatcher.ts +10 -1
  178. package/src/ui/spinner.ts +17 -17
  179. package/src/ui/status-colors.ts +58 -58
  180. package/src/ui/syntax-highlight.ts +116 -116
  181. package/src/ui/transcript-entries.ts +258 -258
  182. package/src/utils/completion-dedupe.ts +63 -63
  183. package/src/utils/frontmatter.ts +68 -68
  184. package/src/utils/git.ts +262 -262
  185. package/src/utils/ids.ts +17 -17
  186. package/src/utils/incremental-reader.ts +104 -104
  187. package/src/utils/names.ts +27 -27
  188. package/src/utils/redaction.ts +44 -44
  189. package/src/utils/safe-paths.ts +47 -47
  190. package/src/utils/scan-cache.ts +136 -136
  191. package/src/utils/sleep.ts +40 -26
  192. package/src/utils/task-name-generator.ts +337 -337
  193. package/src/workflows/validate-workflow.ts +40 -40
  194. package/src/worktree/branch-freshness.ts +45 -45
  195. package/teams/default.team.md +12 -12
  196. package/teams/fast-fix.team.md +11 -11
  197. package/teams/implementation.team.md +18 -18
  198. package/teams/parallel-research.team.md +14 -14
  199. package/teams/research.team.md +11 -11
  200. package/teams/review.team.md +12 -12
  201. package/workflows/default.workflow.md +30 -29
  202. package/workflows/fast-fix.workflow.md +23 -22
  203. package/workflows/implementation.workflow.md +43 -43
  204. package/workflows/parallel-research.workflow.md +46 -46
  205. package/workflows/research.workflow.md +22 -22
  206. package/workflows/review.workflow.md +30 -30
  207. package/docs/refactor-tasks-phase3.md +0 -394
  208. package/docs/refactor-tasks-phase4.md +0 -564
  209. package/docs/refactor-tasks-phase5.md +0 -402
  210. package/docs/refactor-tasks-phase6.md +0 -662
  211. package/docs/refactor-tasks.md +0 -1484
  212. package/docs/research/AGENT-EXECUTION-ARCHITECTURE.md +0 -261
  213. package/docs/research/AGENT-LIFECYCLE-COMPARISON.md +0 -111
  214. package/docs/research/AUDIT_OH_MY_PI.md +0 -261
  215. package/docs/research/AUDIT_PI_CREW.md +0 -457
  216. package/docs/research/CAVEMAN-DEEP-RESEARCH.md +0 -281
  217. package/docs/research/COMPARISON_OH_MY_PI_VS_PI_CREW.md +0 -264
  218. package/docs/research/DEEP-RESEARCH-PI-POWERBAR.md +0 -343
  219. package/docs/research/DEEP_RESEARCH_SUBAGENT_ARCHITECTURE.md +0 -480
  220. package/docs/research/GAP_CLOSURE_IMPLEMENTATION_PLAN.md +0 -354
  221. package/docs/research/IMPLEMENTATION_PLAN.md +0 -385
  222. package/docs/research/LIVE-SESSION-PRODUCTION-READY-PLAN.md +0 -502
  223. package/docs/research/OH-MY-PI-DEEP-RESEARCH-v14.7.6.md +0 -266
  224. package/docs/research/REMAINING-GAPS-PLAN.md +0 -363
  225. package/docs/research/SESSION-SUMMARY-2026-05-08.md +0 -146
  226. package/docs/research/UI-RESPONSIVENESS-AUDIT.md +0 -173
  227. package/docs/research-awesome-agent-skills-distillation.md +0 -100
  228. package/docs/research-extension-examples.md +0 -297
  229. package/docs/research-extension-system.md +0 -324
  230. package/docs/research-oh-my-pi-distillation.md +0 -369
  231. package/docs/research-optimization-plan.md +0 -548
  232. package/docs/research-phase10-distillation.md +0 -199
  233. package/docs/research-phase11-distillation.md +0 -201
  234. package/docs/research-phase8-operator-experience-plan.md +0 -819
  235. package/docs/research-phase9-observability-reliability-plan.md +0 -1190
  236. package/docs/research-pi-coding-agent.md +0 -357
  237. package/docs/research-source-pi-crew-reference.md +0 -174
  238. package/docs/research-ui-optimization-plan.md +0 -480
  239. package/docs/source-runtime-refactor-map.md +0 -107
  240. package/src/utils/atomic-write.ts +0 -33
package/src/i18n.ts CHANGED
@@ -1,184 +1,184 @@
1
- import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
-
3
- type Params = Record<string, string | number>;
4
-
5
- const namespace = "pi-crew";
6
- const TEMPLATE_RE = /\{(\w+)\}/g;
7
-
8
- const fallback = {
9
- "agent.requiresPrompt": "Agent requires prompt.",
10
- "agent.started": "Agent {state}.",
11
- "agent.id": "Agent ID: {id}",
12
- "agent.type": "Type: {type}",
13
- "agent.description": "Description: {description}",
14
- "agent.retrieveHint": "Use get_subagent_result to retrieve output. Do not duplicate this agent's work.",
15
- "agent.foregroundStatus": "Agent {id} {status}.",
16
- "agent.noOutput": "No output.",
17
- "result.requiresAgentId": "get_subagent_result requires agent_id.",
18
- "result.notFound": "Agent not found: {id}",
19
- "result.unrecoverable": "Subagent was interrupted before its durable run id was recorded; it cannot be recovered after restart.",
20
- "result.waitAborted": "Waiting for subagent result was aborted.",
21
- "result.waitTimeout": "Timed out waiting for subagent result.",
22
- "result.stillRunning": "Agent is still running. Use wait=true or check again later.",
23
- "steer.noted": "Steering request noted for {id}.",
24
- "steer.unavailable": "Current default pi-crew backend is child-process, so mid-turn session.steer is not available yet.",
25
- "steer.cancelHint": "Use team cancel runId={runId} if the agent must be interrupted.",
26
- } as const;
27
-
28
- type Key = keyof typeof fallback;
29
-
30
- /** Map of locale → partial translations. Keys not present fall back to English. */
31
- const translations: Record<string, Partial<Record<Key, string>>> = {
32
- es: {
33
- "agent.requiresPrompt": "Agent requiere prompt.",
34
- "agent.started": "Agent {state}.",
35
- "agent.id": "ID del agente: {id}",
36
- "agent.type": "Tipo: {type}",
37
- "agent.description": "Descripción: {description}",
38
- "agent.retrieveHint": "Usa get_subagent_result para recuperar la salida. No dupliques el trabajo de este agente.",
39
- "agent.foregroundStatus": "Agent {id} {status}.",
40
- "agent.noOutput": "Sin salida.",
41
- "result.requiresAgentId": "get_subagent_result requiere agent_id.",
42
- "result.notFound": "Agente no encontrado: {id}",
43
- "result.unrecoverable": "El subagente fue interrumpido antes de registrar su ID de ejecución duradero; no se puede recuperar tras reiniciar.",
44
- "result.waitAborted": "Se canceló la espera del resultado del subagente.",
45
- "result.waitTimeout": "Se agotó el tiempo de espera del resultado del subagente.",
46
- "result.stillRunning": "El agente sigue ejecutándose. Usa wait=true o vuelve a comprobar más tarde.",
47
- "steer.noted": "Solicitud de dirección registrada para {id}.",
48
- "steer.unavailable": "El backend predeterminado actual de pi-crew es child-process, así que session.steer a mitad de turno aún no está disponible.",
49
- "steer.cancelHint": "Usa team cancel runId={runId} si hay que interrumpir el agente.",
50
- },
51
- fr: {
52
- "agent.requiresPrompt": "Agent nécessite un prompt.",
53
- "agent.started": "Agent {state}.",
54
- "agent.id": "ID de l'agent : {id}",
55
- "agent.type": "Type : {type}",
56
- "agent.description": "Description : {description}",
57
- "agent.retrieveHint": "Utilisez get_subagent_result pour récupérer la sortie. Ne dupliquez pas le travail de cet agent.",
58
- "agent.foregroundStatus": "Agent {id} {status}.",
59
- "agent.noOutput": "Aucune sortie.",
60
- "result.requiresAgentId": "get_subagent_result nécessite agent_id.",
61
- "result.notFound": "Agent introuvable : {id}",
62
- "result.unrecoverable": "Le sous-agent a été interrompu avant l'enregistrement de son ID d'exécution durable ; il ne peut pas être récupéré après redémarrage.",
63
- "result.waitAborted": "L'attente du résultat du sous-agent a été annulée.",
64
- "result.waitTimeout": "Délai d'attente du résultat du sous-agent dépassé.",
65
- "result.stillRunning": "L'agent est toujours en cours d'exécution. Utilisez wait=true ou réessayez plus tard.",
66
- "steer.noted": "Demande de pilotage enregistrée pour {id}.",
67
- "steer.unavailable": "Le backend pi-crew par défaut actuel est child-process, donc session.steer en milieu de tour n'est pas encore disponible.",
68
- "steer.cancelHint": "Utilisez team cancel runId={runId} si l'agent doit être interrompu.",
69
- },
70
- "pt-BR": {
71
- "agent.requiresPrompt": "Agent requer prompt.",
72
- "agent.started": "Agent {state}.",
73
- "agent.id": "ID do agente: {id}",
74
- "agent.type": "Tipo: {type}",
75
- "agent.description": "Descrição: {description}",
76
- "agent.retrieveHint": "Use get_subagent_result para recuperar a saída. Não duplique o trabalho deste agente.",
77
- "agent.foregroundStatus": "Agent {id} {status}.",
78
- "agent.noOutput": "Sem saída.",
79
- "result.requiresAgentId": "get_subagent_result requer agent_id.",
80
- "result.notFound": "Agente não encontrado: {id}",
81
- "result.unrecoverable": "O subagente foi interrompido antes que seu ID de execução durável fosse registrado; ele não pode ser recuperado após reiniciar.",
82
- "result.waitAborted": "A espera pelo resultado do subagente foi abortada.",
83
- "result.waitTimeout": "Tempo limite de espera pelo resultado do subagente esgotado.",
84
- "result.stillRunning": "O agente ainda está em execução. Use wait=true ou verifique novamente mais tarde.",
85
- "steer.noted": "Solicitação de orientação registrada para {id}.",
86
- "steer.unavailable": "O backend padrão atual do pi-crew é child-process, então session.steer no meio do turno ainda não está disponível.",
87
- "steer.cancelHint": "Use team cancel runId={runId} se o agente precisar ser interrompido.",
88
- },
89
- };
90
-
91
- // --- Runtime state ---
92
-
93
- let currentLocale: string | undefined;
94
- const warnedMissing = new Set<string>();
95
-
96
- // --- Helpers ---
97
-
98
- function format(template: string, params: Params = {}): string {
99
- return template.replace(TEMPLATE_RE, (_match, key) => String(params[key] ?? `{${key}}`));
100
- }
101
-
102
- function warnOnce(key: string): void {
103
- const tag = `${currentLocale}:${key}`;
104
- if (warnedMissing.has(tag)) return;
105
- warnedMissing.add(tag);
106
- process.stderr.write(`[pi-crew] i18n: missing "${key}" in locale "${currentLocale}" — using English\n`);
107
- }
108
-
109
- // --- Public API ---
110
-
111
- /**
112
- * Translate a key for the currently active locale.
113
- * Falls back to English, then to the raw key as a last resort.
114
- */
115
- export function t(key: Key, params?: Params): string {
116
- if (currentLocale && translations[currentLocale]) {
117
- const template = translations[currentLocale]?.[key];
118
- if (template) return format(template, params);
119
- warnOnce(key);
120
- }
121
- return format(fallback[key] ?? key, params);
122
- }
123
-
124
- /**
125
- * Register or extend translations for a locale at runtime.
126
- * Useful for contributors adding new language bundles without modifying i18n.ts.
127
- *
128
- * @example
129
- * addTranslations("vi", { "agent.requiresPrompt": "Agent cần prompt." })
130
- */
131
- export function addTranslations(locale: string, bundle: Partial<Record<Key, string>>): void {
132
- if (!locale) return;
133
- const existing = translations[locale];
134
- if (existing) {
135
- Object.assign(existing, bundle);
136
- } else {
137
- translations[locale] = { ...bundle };
138
- }
139
- }
140
-
141
- /**
142
- * Returns the list of currently registered locales (excluding English, which is always available).
143
- */
144
- export function listLocales(): string[] {
145
- return Object.keys(translations);
146
- }
147
-
148
- // --- Initialization ---
149
-
150
- export function initI18n(pi: ExtensionAPI): () => void {
151
- try {
152
- pi.events?.emit?.("pi-core/i18n/registerBundle", { namespace, defaultLocale: "en", fallback, translations });
153
- } catch {
154
- // Non-critical.
155
- }
156
- const unsubscribe = pi.events?.on?.("pi-core/i18n/localeChanged", (event: unknown) => {
157
- if (!event || typeof event !== "object") return;
158
- const raw = String((event as { locale?: unknown }).locale ?? "").trim();
159
- currentLocale = raw && translations[raw] ? raw : undefined;
160
- });
161
- try {
162
- pi.events?.emit?.("pi-core/i18n/requestApi", { namespace, onApi(api: { getLocale?: () => string | undefined }) {
163
- const raw = api.getLocale?.()?.trim();
164
- if (raw && translations[raw]) currentLocale = raw;
165
- } });
166
- } catch {
167
- // Non-critical.
168
- }
169
- return () => {
170
- currentLocale = undefined;
171
- unsubscribe?.();
172
- };
173
- }
174
-
175
- // --- Test helpers ---
176
-
177
- export function __test__resetI18n(): void {
178
- currentLocale = undefined;
179
- warnedMissing.clear();
180
- // Clear runtime-added translations but keep built-in ones.
181
- for (const key of Object.keys(translations)) {
182
- if (!["es", "fr", "pt-BR"].includes(key)) delete translations[key];
183
- }
184
- }
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+
3
+ type Params = Record<string, string | number>;
4
+
5
+ const namespace = "pi-crew";
6
+ const TEMPLATE_RE = /\{(\w+)\}/g;
7
+
8
+ const fallback = {
9
+ "agent.requiresPrompt": "Agent requires prompt.",
10
+ "agent.started": "Agent {state}.",
11
+ "agent.id": "Agent ID: {id}",
12
+ "agent.type": "Type: {type}",
13
+ "agent.description": "Description: {description}",
14
+ "agent.retrieveHint": "Use get_subagent_result to retrieve output. Do not duplicate this agent's work.",
15
+ "agent.foregroundStatus": "Agent {id} {status}.",
16
+ "agent.noOutput": "No output.",
17
+ "result.requiresAgentId": "get_subagent_result requires agent_id.",
18
+ "result.notFound": "Agent not found: {id}",
19
+ "result.unrecoverable": "Subagent was interrupted before its durable run id was recorded; it cannot be recovered after restart.",
20
+ "result.waitAborted": "Waiting for subagent result was aborted.",
21
+ "result.waitTimeout": "Timed out waiting for subagent result.",
22
+ "result.stillRunning": "Agent is still running. Use wait=true or check again later.",
23
+ "steer.noted": "Steering request noted for {id}.",
24
+ "steer.unavailable": "Current default pi-crew backend is child-process, so mid-turn session.steer is not available yet.",
25
+ "steer.cancelHint": "Use team cancel runId={runId} if the agent must be interrupted.",
26
+ } as const;
27
+
28
+ type Key = keyof typeof fallback;
29
+
30
+ /** Map of locale → partial translations. Keys not present fall back to English. */
31
+ const translations: Record<string, Partial<Record<Key, string>>> = {
32
+ es: {
33
+ "agent.requiresPrompt": "Agent requiere prompt.",
34
+ "agent.started": "Agent {state}.",
35
+ "agent.id": "ID del agente: {id}",
36
+ "agent.type": "Tipo: {type}",
37
+ "agent.description": "Descripción: {description}",
38
+ "agent.retrieveHint": "Usa get_subagent_result para recuperar la salida. No dupliques el trabajo de este agente.",
39
+ "agent.foregroundStatus": "Agent {id} {status}.",
40
+ "agent.noOutput": "Sin salida.",
41
+ "result.requiresAgentId": "get_subagent_result requiere agent_id.",
42
+ "result.notFound": "Agente no encontrado: {id}",
43
+ "result.unrecoverable": "El subagente fue interrumpido antes de registrar su ID de ejecución duradero; no se puede recuperar tras reiniciar.",
44
+ "result.waitAborted": "Se canceló la espera del resultado del subagente.",
45
+ "result.waitTimeout": "Se agotó el tiempo de espera del resultado del subagente.",
46
+ "result.stillRunning": "El agente sigue ejecutándose. Usa wait=true o vuelve a comprobar más tarde.",
47
+ "steer.noted": "Solicitud de dirección registrada para {id}.",
48
+ "steer.unavailable": "El backend predeterminado actual de pi-crew es child-process, así que session.steer a mitad de turno aún no está disponible.",
49
+ "steer.cancelHint": "Usa team cancel runId={runId} si hay que interrumpir el agente.",
50
+ },
51
+ fr: {
52
+ "agent.requiresPrompt": "Agent nécessite un prompt.",
53
+ "agent.started": "Agent {state}.",
54
+ "agent.id": "ID de l'agent : {id}",
55
+ "agent.type": "Type : {type}",
56
+ "agent.description": "Description : {description}",
57
+ "agent.retrieveHint": "Utilisez get_subagent_result pour récupérer la sortie. Ne dupliquez pas le travail de cet agent.",
58
+ "agent.foregroundStatus": "Agent {id} {status}.",
59
+ "agent.noOutput": "Aucune sortie.",
60
+ "result.requiresAgentId": "get_subagent_result nécessite agent_id.",
61
+ "result.notFound": "Agent introuvable : {id}",
62
+ "result.unrecoverable": "Le sous-agent a été interrompu avant l'enregistrement de son ID d'exécution durable ; il ne peut pas être récupéré après redémarrage.",
63
+ "result.waitAborted": "L'attente du résultat du sous-agent a été annulée.",
64
+ "result.waitTimeout": "Délai d'attente du résultat du sous-agent dépassé.",
65
+ "result.stillRunning": "L'agent est toujours en cours d'exécution. Utilisez wait=true ou réessayez plus tard.",
66
+ "steer.noted": "Demande de pilotage enregistrée pour {id}.",
67
+ "steer.unavailable": "Le backend pi-crew par défaut actuel est child-process, donc session.steer en milieu de tour n'est pas encore disponible.",
68
+ "steer.cancelHint": "Utilisez team cancel runId={runId} si l'agent doit être interrompu.",
69
+ },
70
+ "pt-BR": {
71
+ "agent.requiresPrompt": "Agent requer prompt.",
72
+ "agent.started": "Agent {state}.",
73
+ "agent.id": "ID do agente: {id}",
74
+ "agent.type": "Tipo: {type}",
75
+ "agent.description": "Descrição: {description}",
76
+ "agent.retrieveHint": "Use get_subagent_result para recuperar a saída. Não duplique o trabalho deste agente.",
77
+ "agent.foregroundStatus": "Agent {id} {status}.",
78
+ "agent.noOutput": "Sem saída.",
79
+ "result.requiresAgentId": "get_subagent_result requer agent_id.",
80
+ "result.notFound": "Agente não encontrado: {id}",
81
+ "result.unrecoverable": "O subagente foi interrompido antes que seu ID de execução durável fosse registrado; ele não pode ser recuperado após reiniciar.",
82
+ "result.waitAborted": "A espera pelo resultado do subagente foi abortada.",
83
+ "result.waitTimeout": "Tempo limite de espera pelo resultado do subagente esgotado.",
84
+ "result.stillRunning": "O agente ainda está em execução. Use wait=true ou verifique novamente mais tarde.",
85
+ "steer.noted": "Solicitação de orientação registrada para {id}.",
86
+ "steer.unavailable": "O backend padrão atual do pi-crew é child-process, então session.steer no meio do turno ainda não está disponível.",
87
+ "steer.cancelHint": "Use team cancel runId={runId} se o agente precisar ser interrompido.",
88
+ },
89
+ };
90
+
91
+ // --- Runtime state ---
92
+
93
+ let currentLocale: string | undefined;
94
+ const warnedMissing = new Set<string>();
95
+
96
+ // --- Helpers ---
97
+
98
+ function format(template: string, params: Params = {}): string {
99
+ return template.replace(TEMPLATE_RE, (_match, key) => String(params[key] ?? `{${key}}`));
100
+ }
101
+
102
+ function warnOnce(key: string): void {
103
+ const tag = `${currentLocale}:${key}`;
104
+ if (warnedMissing.has(tag)) return;
105
+ warnedMissing.add(tag);
106
+ process.stderr.write(`[pi-crew] i18n: missing "${key}" in locale "${currentLocale}" — using English\n`);
107
+ }
108
+
109
+ // --- Public API ---
110
+
111
+ /**
112
+ * Translate a key for the currently active locale.
113
+ * Falls back to English, then to the raw key as a last resort.
114
+ */
115
+ export function t(key: Key, params?: Params): string {
116
+ if (currentLocale && translations[currentLocale]) {
117
+ const template = translations[currentLocale]?.[key];
118
+ if (template) return format(template, params);
119
+ warnOnce(key);
120
+ }
121
+ return format(fallback[key] ?? key, params);
122
+ }
123
+
124
+ /**
125
+ * Register or extend translations for a locale at runtime.
126
+ * Useful for contributors adding new language bundles without modifying i18n.ts.
127
+ *
128
+ * @example
129
+ * addTranslations("vi", { "agent.requiresPrompt": "Agent cần prompt." })
130
+ */
131
+ export function addTranslations(locale: string, bundle: Partial<Record<Key, string>>): void {
132
+ if (!locale) return;
133
+ const existing = translations[locale];
134
+ if (existing) {
135
+ Object.assign(existing, bundle);
136
+ } else {
137
+ translations[locale] = { ...bundle };
138
+ }
139
+ }
140
+
141
+ /**
142
+ * Returns the list of currently registered locales (excluding English, which is always available).
143
+ */
144
+ export function listLocales(): string[] {
145
+ return Object.keys(translations);
146
+ }
147
+
148
+ // --- Initialization ---
149
+
150
+ export function initI18n(pi: ExtensionAPI): () => void {
151
+ try {
152
+ pi.events?.emit?.("pi-core/i18n/registerBundle", { namespace, defaultLocale: "en", fallback, translations });
153
+ } catch {
154
+ // Non-critical.
155
+ }
156
+ const unsubscribe = pi.events?.on?.("pi-core/i18n/localeChanged", (event: unknown) => {
157
+ if (!event || typeof event !== "object") return;
158
+ const raw = String((event as { locale?: unknown }).locale ?? "").trim();
159
+ currentLocale = raw && translations[raw] ? raw : undefined;
160
+ });
161
+ try {
162
+ pi.events?.emit?.("pi-core/i18n/requestApi", { namespace, onApi(api: { getLocale?: () => string | undefined }) {
163
+ const raw = api.getLocale?.()?.trim();
164
+ if (raw && translations[raw]) currentLocale = raw;
165
+ } });
166
+ } catch {
167
+ // Non-critical.
168
+ }
169
+ return () => {
170
+ currentLocale = undefined;
171
+ unsubscribe?.();
172
+ };
173
+ }
174
+
175
+ // --- Test helpers ---
176
+
177
+ export function __test__resetI18n(): void {
178
+ currentLocale = undefined;
179
+ warnedMissing.clear();
180
+ // Clear runtime-added translations but keep built-in ones.
181
+ for (const key of Object.keys(translations)) {
182
+ if (!["es", "fr", "pt-BR"].includes(key)) delete translations[key];
183
+ }
184
+ }
@@ -1,77 +1,92 @@
1
- import { logInternalError } from "../../utils/internal-error.ts";
2
- import type { MetricRegistry } from "../metric-registry.ts";
3
- import type { MetricSnapshot } from "../metrics-primitives.ts";
4
- import type { MetricExporter } from "./adapter.ts";
5
-
6
- export interface OTLPExporterOptions {
7
- endpoint: string;
8
- headers?: Record<string, string>;
9
- intervalMs?: number;
10
- timeoutMs?: number;
11
- }
12
-
13
- function pointValues(snapshot: MetricSnapshot): unknown[] {
14
- if (snapshot.type === "histogram") {
15
- return snapshot.values.map((value) => ({
16
- attributes: Object.entries(value.labels).map(([key, item]) => ({ key, value: { stringValue: String(item) } })),
17
- count: "count" in value ? value.count : undefined,
18
- sum: "sum" in value ? value.sum : undefined,
19
- bucketCounts: "counts" in value ? value.counts : undefined,
20
- explicitBounds: "buckets" in value ? value.buckets : undefined,
21
- }));
22
- }
23
- return snapshot.values.map((value) => ({ attributes: Object.entries(value.labels).map(([key, item]) => ({ key, value: { stringValue: String(item) } })), asDouble: "value" in value ? value.value : undefined, count: "count" in value ? value.count : undefined, sum: "sum" in value ? value.sum : undefined }));
24
- }
25
-
26
- export function convertToOTLP(snapshots: MetricSnapshot[]): unknown {
27
- return {
28
- resourceMetrics: [{
29
- resource: { attributes: [{ key: "service.name", value: { stringValue: "pi-crew" } }] },
30
- scopeMetrics: [{
31
- scope: { name: "pi-crew" },
32
- metrics: snapshots.map((snapshot) => ({ name: snapshot.name, description: snapshot.description, [snapshot.type === "histogram" ? "histogram" : snapshot.type === "gauge" ? "gauge" : "sum"]: { dataPoints: pointValues(snapshot) } })),
33
- }],
34
- }],
35
- };
36
- }
37
-
38
- export class OTLPExporter implements MetricExporter {
39
- name = "otlp";
40
- private timer?: ReturnType<typeof setInterval>;
41
- private readonly opts: OTLPExporterOptions;
42
- private readonly registry: MetricRegistry;
43
-
44
- constructor(opts: OTLPExporterOptions, registry: MetricRegistry) {
45
- this.opts = opts;
46
- this.registry = registry;
47
- }
48
-
49
- start(): void {
50
- this.dispose();
51
- this.timer = setInterval(() => { void this.push(this.registry.snapshot()); }, this.opts.intervalMs ?? 60_000);
52
- this.timer.unref();
53
- }
54
-
55
- async push(snapshots: MetricSnapshot[]): Promise<void> {
56
- try {
57
- const timeoutMs = this.opts.timeoutMs ?? 10_000;
58
- const controller = new AbortController();
59
- const timer = setTimeout(() => controller.abort(), timeoutMs);
60
- try {
61
- const response = await fetch(this.opts.endpoint, { method: "POST", headers: { "content-type": "application/json", ...(this.opts.headers ?? {}) }, body: JSON.stringify(convertToOTLP(snapshots)), signal: controller.signal });
62
- if (!response.ok) {
63
- logInternalError("otlp-export-http", new Error(`HTTP ${response.status}: ${response.statusText}`), `endpoint=${this.opts.endpoint}`);
64
- }
65
- } finally {
66
- clearTimeout(timer);
67
- }
68
- } catch (error) {
69
- logInternalError("otlp-export", error);
70
- }
71
- }
72
-
73
- dispose(): void {
74
- if (this.timer) clearInterval(this.timer);
75
- this.timer = undefined;
76
- }
77
- }
1
+ import { logInternalError } from "../../utils/internal-error.ts";
2
+ import { redactSecrets } from "../../utils/redaction.ts";
3
+ import type { MetricRegistry } from "../metric-registry.ts";
4
+ import type { MetricSnapshot } from "../metrics-primitives.ts";
5
+ import type { MetricExporter } from "./adapter.ts";
6
+
7
+ export interface OTLPExporterOptions {
8
+ endpoint: string;
9
+ headers?: Record<string, string>;
10
+ intervalMs?: number;
11
+ timeoutMs?: number;
12
+ }
13
+
14
+ function pointValues(snapshot: MetricSnapshot): unknown[] {
15
+ const MAX_LABEL_LENGTH = 256;
16
+ if (snapshot.type === "histogram") {
17
+ return snapshot.values.map((value) => ({
18
+ attributes: Object.entries(value.labels).map(([key, item]) => {
19
+ const redacted = redactSecrets({ [key]: item }) as Record<string, string>;
20
+ const val = String(redacted[key] ?? item);
21
+ return { key, value: { stringValue: val.length > MAX_LABEL_LENGTH ? val.slice(0, MAX_LABEL_LENGTH) : val } };
22
+ }),
23
+ count: "count" in value ? value.count : undefined,
24
+ sum: "sum" in value ? value.sum : undefined,
25
+ bucketCounts: "counts" in value ? value.counts : undefined,
26
+ explicitBounds: "buckets" in value ? value.buckets : undefined,
27
+ }));
28
+ }
29
+ return snapshot.values.map((value) => ({
30
+ attributes: Object.entries(value.labels).map(([key, item]) => {
31
+ const redacted = redactSecrets({ [key]: item }) as Record<string, string>;
32
+ const val = String(redacted[key] ?? item);
33
+ return { key, value: { stringValue: val.length > MAX_LABEL_LENGTH ? val.slice(0, MAX_LABEL_LENGTH) : val } };
34
+ }),
35
+ asDouble: "value" in value ? value.value : undefined,
36
+ count: "count" in value ? value.count : undefined,
37
+ sum: "sum" in value ? value.sum : undefined,
38
+ }));
39
+ }
40
+
41
+ export function convertToOTLP(snapshots: MetricSnapshot[]): unknown {
42
+ return {
43
+ resourceMetrics: [{
44
+ resource: { attributes: [{ key: "service.name", value: { stringValue: "pi-crew" } }] },
45
+ scopeMetrics: [{
46
+ scope: { name: "pi-crew" },
47
+ metrics: snapshots.map((snapshot) => ({ name: snapshot.name, description: snapshot.description, [snapshot.type === "histogram" ? "histogram" : snapshot.type === "gauge" ? "gauge" : "sum"]: { dataPoints: pointValues(snapshot) } })),
48
+ }],
49
+ }],
50
+ };
51
+ }
52
+
53
+ export class OTLPExporter implements MetricExporter {
54
+ name = "otlp";
55
+ private timer?: ReturnType<typeof setInterval>;
56
+ private readonly opts: OTLPExporterOptions;
57
+ private readonly registry: MetricRegistry;
58
+
59
+ constructor(opts: OTLPExporterOptions, registry: MetricRegistry) {
60
+ this.opts = opts;
61
+ this.registry = registry;
62
+ }
63
+
64
+ start(): void {
65
+ this.dispose();
66
+ this.timer = setInterval(() => { void this.push(this.registry.snapshot()); }, this.opts.intervalMs ?? 60_000);
67
+ this.timer.unref();
68
+ }
69
+
70
+ async push(snapshots: MetricSnapshot[]): Promise<void> {
71
+ try {
72
+ const timeoutMs = this.opts.timeoutMs ?? 10_000;
73
+ const controller = new AbortController();
74
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
75
+ try {
76
+ const response = await fetch(this.opts.endpoint, { method: "POST", headers: { "content-type": "application/json", ...(this.opts.headers ?? {}) }, body: JSON.stringify(convertToOTLP(snapshots)), signal: controller.signal });
77
+ if (!response.ok) {
78
+ logInternalError("otlp-export-http", new Error(`HTTP ${response.status}: ${response.statusText}`), `endpoint=${this.opts.endpoint}`);
79
+ }
80
+ } finally {
81
+ clearTimeout(timer);
82
+ }
83
+ } catch (error) {
84
+ logInternalError("otlp-export", error);
85
+ }
86
+ }
87
+
88
+ dispose(): void {
89
+ if (this.timer) clearInterval(this.timer);
90
+ this.timer = undefined;
91
+ }
92
+ }