@agentuity/coder 2.0.7 → 2.0.8

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 (113) hide show
  1. package/AGENTS.md +43 -0
  2. package/README.md +75 -37
  3. package/dist/index.d.ts +1 -3
  4. package/dist/index.d.ts.map +1 -1
  5. package/dist/index.js +1 -1669
  6. package/dist/index.js.map +1 -1
  7. package/package.json +9 -12
  8. package/src/index.ts +51 -1996
  9. package/dist/chain-preview.d.ts +0 -55
  10. package/dist/chain-preview.d.ts.map +0 -1
  11. package/dist/chain-preview.js +0 -472
  12. package/dist/chain-preview.js.map +0 -1
  13. package/dist/client.d.ts +0 -44
  14. package/dist/client.d.ts.map +0 -1
  15. package/dist/client.js +0 -411
  16. package/dist/client.js.map +0 -1
  17. package/dist/commands.d.ts +0 -22
  18. package/dist/commands.d.ts.map +0 -1
  19. package/dist/commands.js +0 -99
  20. package/dist/commands.js.map +0 -1
  21. package/dist/footer.d.ts +0 -34
  22. package/dist/footer.d.ts.map +0 -1
  23. package/dist/footer.js +0 -249
  24. package/dist/footer.js.map +0 -1
  25. package/dist/handlers.d.ts +0 -24
  26. package/dist/handlers.d.ts.map +0 -1
  27. package/dist/handlers.js +0 -83
  28. package/dist/handlers.js.map +0 -1
  29. package/dist/hub-overlay-state.d.ts +0 -31
  30. package/dist/hub-overlay-state.d.ts.map +0 -1
  31. package/dist/hub-overlay-state.js +0 -78
  32. package/dist/hub-overlay-state.js.map +0 -1
  33. package/dist/hub-overlay.d.ts +0 -146
  34. package/dist/hub-overlay.d.ts.map +0 -1
  35. package/dist/hub-overlay.js +0 -2354
  36. package/dist/hub-overlay.js.map +0 -1
  37. package/dist/native-remote-ui-context.d.ts +0 -5
  38. package/dist/native-remote-ui-context.d.ts.map +0 -1
  39. package/dist/native-remote-ui-context.js +0 -30
  40. package/dist/native-remote-ui-context.js.map +0 -1
  41. package/dist/output-viewer.d.ts +0 -49
  42. package/dist/output-viewer.d.ts.map +0 -1
  43. package/dist/output-viewer.js +0 -389
  44. package/dist/output-viewer.js.map +0 -1
  45. package/dist/overlay.d.ts +0 -40
  46. package/dist/overlay.d.ts.map +0 -1
  47. package/dist/overlay.js +0 -225
  48. package/dist/overlay.js.map +0 -1
  49. package/dist/protocol.d.ts +0 -605
  50. package/dist/protocol.d.ts.map +0 -1
  51. package/dist/protocol.js +0 -4
  52. package/dist/protocol.js.map +0 -1
  53. package/dist/remote-lifecycle.d.ts +0 -61
  54. package/dist/remote-lifecycle.d.ts.map +0 -1
  55. package/dist/remote-lifecycle.js +0 -190
  56. package/dist/remote-lifecycle.js.map +0 -1
  57. package/dist/remote-session.d.ts +0 -128
  58. package/dist/remote-session.d.ts.map +0 -1
  59. package/dist/remote-session.js +0 -876
  60. package/dist/remote-session.js.map +0 -1
  61. package/dist/remote-tui.d.ts +0 -40
  62. package/dist/remote-tui.d.ts.map +0 -1
  63. package/dist/remote-tui.js +0 -867
  64. package/dist/remote-tui.js.map +0 -1
  65. package/dist/remote-ui-handler.d.ts +0 -5
  66. package/dist/remote-ui-handler.d.ts.map +0 -1
  67. package/dist/remote-ui-handler.js +0 -53
  68. package/dist/remote-ui-handler.js.map +0 -1
  69. package/dist/renderers.d.ts +0 -34
  70. package/dist/renderers.d.ts.map +0 -1
  71. package/dist/renderers.js +0 -669
  72. package/dist/renderers.js.map +0 -1
  73. package/dist/review.d.ts +0 -15
  74. package/dist/review.d.ts.map +0 -1
  75. package/dist/review.js +0 -154
  76. package/dist/review.js.map +0 -1
  77. package/dist/titlebar.d.ts +0 -3
  78. package/dist/titlebar.d.ts.map +0 -1
  79. package/dist/titlebar.js +0 -59
  80. package/dist/titlebar.js.map +0 -1
  81. package/dist/todo/index.d.ts +0 -3
  82. package/dist/todo/index.d.ts.map +0 -1
  83. package/dist/todo/index.js +0 -3
  84. package/dist/todo/index.js.map +0 -1
  85. package/dist/todo/store.d.ts +0 -6
  86. package/dist/todo/store.d.ts.map +0 -1
  87. package/dist/todo/store.js +0 -43
  88. package/dist/todo/store.js.map +0 -1
  89. package/dist/todo/types.d.ts +0 -13
  90. package/dist/todo/types.d.ts.map +0 -1
  91. package/dist/todo/types.js +0 -2
  92. package/dist/todo/types.js.map +0 -1
  93. package/src/chain-preview.ts +0 -621
  94. package/src/client.ts +0 -527
  95. package/src/commands.ts +0 -132
  96. package/src/footer.ts +0 -305
  97. package/src/handlers.ts +0 -113
  98. package/src/hub-overlay-state.ts +0 -127
  99. package/src/hub-overlay.ts +0 -3037
  100. package/src/native-remote-ui-context.ts +0 -41
  101. package/src/output-viewer.ts +0 -480
  102. package/src/overlay.ts +0 -294
  103. package/src/protocol.ts +0 -758
  104. package/src/remote-lifecycle.ts +0 -270
  105. package/src/remote-session.ts +0 -1080
  106. package/src/remote-tui.ts +0 -1020
  107. package/src/remote-ui-handler.ts +0 -86
  108. package/src/renderers.ts +0 -740
  109. package/src/review.ts +0 -201
  110. package/src/titlebar.ts +0 -63
  111. package/src/todo/index.ts +0 -2
  112. package/src/todo/store.ts +0 -49
  113. package/src/todo/types.ts +0 -14
@@ -1,867 +0,0 @@
1
- /**
2
- * Remote TUI — Native Pi Coding Agent Renderer for Remote Sessions
3
- *
4
- * Creates a real AgentSession + InteractiveMode backed by a remote sandbox
5
- * via Hub WebSocket, with the coder extension loaded for Hub UI (footer,
6
- * /hub overlay, commands, titlebar).
7
- *
8
- * Architecture:
9
- * Remote TUI → Hub WebSocket (controller) → Sandbox (Pi RPC mode)
10
- * - User input → agent.prompt() (monkey-patched) → RPC `prompt` → Hub → sandbox
11
- * - Sandbox Pi → AgentEvent stream → Hub broadcast → Agent.emit() → InteractiveMode renders natively
12
- * - Hub UI → coder extension (loaded via DefaultResourceLoader) provides footer, /hub, commands
13
- *
14
- * The local Agent never calls an LLM. Its prompt/steer/abort are monkey-patched
15
- * to send RPC commands. Its internal state is kept in sync with the remote agent
16
- * by mirroring state updates from each received event.
17
- *
18
- * The coder extension sees AGENTUITY_CODER_REMOTE_SESSION (Hub UI mode) +
19
- * AGENTUITY_CODER_NATIVE_REMOTE (skip legacy event rendering). It provides
20
- * Hub connection, footer, /hub overlay, commands, titlebar — but does NOT
21
- * intercept input or render events (this module handles both).
22
- *
23
- * IMPORTANT: Initialization order matters!
24
- * 1. Create RemoteSession (no connection yet)
25
- * 2. Create AgentSession, patch Agent/Session methods
26
- * 3. Register ALL event handlers on RemoteSession
27
- * 4. THEN connect — so hydration + replay events are captured
28
- */
29
- import { createAgentSession, DefaultResourceLoader, InteractiveMode, SessionManager, } from '@mariozechner/pi-coding-agent';
30
- import { getNativeRemoteExtensionContext, setNativeRemoteExtensionContext, waitForNativeRemoteExtensionContext, } from "./native-remote-ui-context.js";
31
- import { clearRemoteLifecycleWorkingMessage, getRemoteLifecycleActivityLabel, getRemoteLifecycleLabel, syncRemoteLifecycleWorkingMessage, } from "./remote-lifecycle.js";
32
- import { RemoteSession } from "./remote-session.js";
33
- import { agentuityCoderHub } from "./index.js";
34
- import { handleRemoteUiRequest, REMOTE_FIRE_AND_FORGET_UI_METHODS } from "./remote-ui-handler.js";
35
- const DEBUG = !!process.env['AGENTUITY_DEBUG'];
36
- function log(msg) {
37
- if (DEBUG)
38
- console.error(`[remote-tui] ${msg}`);
39
- }
40
- /**
41
- * Run the native Pi TUI connected to a remote sandbox session.
42
- *
43
- * This is the entry point for `agentuity coder start --remote <sessionId>`.
44
- * Creates an AgentSession with the coder extension loaded (Hub UI), then
45
- * monkey-patches the Agent for remote-backed execution.
46
- */
47
- export async function runRemoteTui(options) {
48
- const { hubWsUrl, sessionId } = options;
49
- log(`Starting remote TUI for session ${sessionId}`);
50
- log(`Hub URL: ${hubWsUrl}`);
51
- // Set env vars BEFORE loading the extension so it enters native remote mode
52
- process.env.AGENTUITY_CODER_HUB_URL = hubWsUrl;
53
- process.env.AGENTUITY_CODER_REMOTE_SESSION = sessionId;
54
- process.env.AGENTUITY_CODER_NATIVE_REMOTE = '1';
55
- setNativeRemoteExtensionContext(null);
56
- // ── 1. Create RemoteSession (NOT connected yet) ──
57
- // We register all handlers BEFORE connecting so that the hydration
58
- // message from the Hub (sent immediately after init) is captured.
59
- const remote = new RemoteSession(sessionId);
60
- // TODO: Remove/Change when we get Agentuity service level auth enabled, this is just temporary
61
- remote.apiKey = process.env.AGENTUITY_CODER_API_KEY || null;
62
- let hydrationStreamingDetected = false;
63
- let sessionResumeSeen = false;
64
- // ── 2. Create AgentSession with coder extension loaded ──
65
- // The extension provides Hub UI (footer, /hub overlay, commands, titlebar).
66
- // AGENTUITY_CODER_NATIVE_REMOTE=1 tells it to skip legacy event rendering.
67
- const cwd = process.cwd();
68
- const resourceLoader = new DefaultResourceLoader({
69
- cwd,
70
- noExtensions: true, // Skip file-system extension discovery
71
- extensionFactories: [agentuityCoderHub], // Load coder extension directly
72
- });
73
- await resourceLoader.reload();
74
- const { session } = await createAgentSession({
75
- sessionManager: SessionManager.inMemory(),
76
- tools: [], // No local tools — sandbox has all the tools
77
- resourceLoader,
78
- });
79
- log('AgentSession created');
80
- // NOTE: Do NOT call session.bindExtensions() here.
81
- // InteractiveMode.initExtensions() calls it with the proper uiContext.
82
- // Calling it early fires session_start twice, duplicating extension init.
83
- // Access the Agent instance (typed as `any` for monkey-patching)
84
- const agent = session.agent;
85
- let lifecycleState = remote.getLifecycleState();
86
- let lifecycleOwnsWorkingMessage = false;
87
- function applyLifecycleUi(state) {
88
- const ctx = getNativeRemoteExtensionContext();
89
- if (!ctx?.hasUI)
90
- return;
91
- const shortSession = state.sessionId.slice(0, 16);
92
- ctx.ui.setStatus('remote_connection', `Remote: ${shortSession}${shortSession.length < state.sessionId.length ? '...' : ''} ${getRemoteLifecycleLabel(state)}`);
93
- const activity = getRemoteLifecycleActivityLabel(state);
94
- if (activity) {
95
- ctx.ui.setStatus('remote_activity', activity);
96
- }
97
- else {
98
- ctx.ui.setStatus('remote_activity', state.isStreaming ? 'agent working...' : 'idle');
99
- }
100
- lifecycleOwnsWorkingMessage = syncRemoteLifecycleWorkingMessage(state, ctx.ui, lifecycleOwnsWorkingMessage);
101
- }
102
- remote.onLifecycleChange((state) => {
103
- lifecycleState = state;
104
- applyLifecycleUi(state);
105
- });
106
- void waitForNativeRemoteExtensionContext(10_000).then((ctx) => {
107
- if (!ctx)
108
- return;
109
- applyLifecycleUi(lifecycleState);
110
- });
111
- // ── 3. Patch Agent to be remote-backed ──
112
- // Track the running prompt promise so InteractiveMode waits correctly
113
- let runningPromptResolve = null;
114
- let syntheticAgentStartEmitted = false;
115
- // Override Agent.prompt — send RPC prompt command, block until agent_end
116
- agent.prompt = async (input) => {
117
- const text = extractPromptText(input);
118
- log(`agent.prompt called, extracted text: ${text ? text.slice(0, 80) : '(empty)'}`);
119
- if (!text)
120
- return;
121
- // Set streaming state — InteractiveMode checks this
122
- agent._state.isStreaming = true;
123
- agent._state.streamMessage = null;
124
- agent._state.error = undefined;
125
- // Create runningPrompt so waitForIdle() works
126
- const runPromise = new Promise((resolve) => {
127
- runningPromptResolve = resolve;
128
- });
129
- agent.runningPrompt = runPromise;
130
- // Emit synthetic agent_start so InteractiveMode shows "working" immediately
131
- syntheticAgentStartEmitted = true;
132
- agent.emit({ type: 'agent_start', agentName: 'lead', timestamp: Date.now() });
133
- // Send RPC command to sandbox
134
- remote.prompt(text);
135
- log(`Sent prompt: ${text.slice(0, 100)}`);
136
- // Block until agent_end received from remote
137
- await runPromise;
138
- };
139
- // Override Agent.steer — send RPC steer command
140
- agent.steer = (m) => {
141
- const text = extractMessageText(m);
142
- if (text) {
143
- remote.steer(text);
144
- log(`Sent steer: ${text.slice(0, 100)}`);
145
- }
146
- };
147
- // Override Agent.abort — send RPC abort command
148
- agent.abort = () => {
149
- remote.abort();
150
- log('Sent abort');
151
- resolveRunningPrompt();
152
- };
153
- // Override Agent.waitForIdle
154
- agent.waitForIdle = () => {
155
- return agent.runningPrompt ?? Promise.resolve();
156
- };
157
- // ── 4. Patch AgentSession methods ──
158
- // session.prompt() does model/API key validation before calling agent.prompt().
159
- // In remote mode, skip validation — the sandbox has the model/key.
160
- // InteractiveMode calls session.prompt(text, { streamingBehavior: "steer" })
161
- // when user types during streaming, and session.prompt(text, { streamingBehavior: "followUp" })
162
- // for Alt+Enter follow-ups. Handle these by routing to steer/followUp commands.
163
- session.prompt = async (text, options) => {
164
- const behavior = options?.streamingBehavior;
165
- log(`session.prompt called (behavior=${behavior ?? 'normal'}): ${text.slice(0, 80)}`);
166
- // Extension commands (start with /) — let AgentSession handle them
167
- // so extension-registered slash commands still work in remote mode
168
- if (text.startsWith('/') && session._tryExecuteExtensionCommand) {
169
- try {
170
- const handled = await session._tryExecuteExtensionCommand(text);
171
- if (handled) {
172
- log(`Extension command handled: ${text}`);
173
- return;
174
- }
175
- }
176
- catch (err) {
177
- log(`Extension command error: ${err}`);
178
- }
179
- }
180
- if (behavior === 'steer') {
181
- remote.steer(text);
182
- log(`Sent steer: ${text.slice(0, 80)}`);
183
- return;
184
- }
185
- if (behavior === 'followUp') {
186
- remote.sendCommand({ type: 'follow_up', message: text });
187
- log(`Sent follow-up: ${text.slice(0, 80)}`);
188
- return;
189
- }
190
- // Normal prompt — send to sandbox
191
- await agent.prompt(text);
192
- };
193
- session.steer = async (text) => {
194
- remote.steer(text);
195
- };
196
- session.followUp = async (text) => {
197
- remote.sendCommand({ type: 'follow_up', message: text });
198
- };
199
- session.abort = async () => {
200
- remote.abort();
201
- resolveRunningPrompt();
202
- };
203
- // Disable auto-compaction (sandbox handles it)
204
- session.setAutoCompactionEnabled(false);
205
- session.setAutoRetryEnabled(false);
206
- // ── 5. Wire up remote events → Agent event pipeline ──
207
- // Only emit LIVE events (from broadcast) to Agent → InteractiveMode.
208
- // Replay events (from Durable Stream) are historical — skip them.
209
- // Hydration is handled separately via session_hydration → agent.replaceMessages().
210
- //
211
- // Events that arrive before InteractiveMode is initialized are buffered
212
- // and flushed after init (InteractiveMode registers listeners during init,
213
- // so agent.emit() before that fires into the void).
214
- let interactiveModeReady = false;
215
- let eventBuffer = [];
216
- let seenMessageStart = false;
217
- let seenAgentStart = false;
218
- // Dedup guard: some events may arrive twice via different broadcast paths
219
- // (rpc_event envelope + direct lifecycle broadcast). Track recent live events
220
- // by type+timestamp to skip duplicates.
221
- const recentEventKeys = new Set();
222
- const DEDUP_WINDOW_MS = 100;
223
- // InteractiveMode adds a new assistant component on every assistant message_start.
224
- // Track active/completed remote messages so normal terminal events and late duplicates
225
- // do not spawn extra components.
226
- let assistantStreamActive = false;
227
- const recentCompletedAssistantMessageKeys = [];
228
- const completedAssistantMessageKeySet = new Set();
229
- function rememberCompletedAssistantMessage(key) {
230
- if (completedAssistantMessageKeySet.has(key))
231
- return;
232
- recentCompletedAssistantMessageKeys.push(key);
233
- completedAssistantMessageKeySet.add(key);
234
- if (recentCompletedAssistantMessageKeys.length > 32) {
235
- const expired = recentCompletedAssistantMessageKeys.shift();
236
- if (expired)
237
- completedAssistantMessageKeySet.delete(expired);
238
- }
239
- }
240
- function emitRemoteUserPrompt(text, timestamp) {
241
- const userMessage = {
242
- role: 'user',
243
- content: [{ type: 'text', text }],
244
- timestamp,
245
- };
246
- const syntheticEvents = [
247
- { type: 'message_start', message: userMessage },
248
- { type: 'message_end', message: userMessage },
249
- ];
250
- if (!interactiveModeReady) {
251
- eventBuffer.push(...syntheticEvents);
252
- log('Buffered synthetic user_prompt events (InteractiveMode not ready)');
253
- return;
254
- }
255
- for (const event of syntheticEvents) {
256
- agent.emit(event);
257
- }
258
- }
259
- remote.onEvent((rpcEvent) => {
260
- const source = rpcEvent._source ?? 'unknown';
261
- const isReplay = source === 'replay' ||
262
- rpcEvent.replay === true ||
263
- rpcEvent.isReplay === true;
264
- log(`Event received: ${rpcEvent.type} (source=${source})`);
265
- if (rpcEvent.type === 'session_resume') {
266
- sessionResumeSeen = true;
267
- log(`Session resume signaled (${typeof rpcEvent.streamId === 'string' ? rpcEvent.streamId : 'no stream id'})`);
268
- return;
269
- }
270
- if (rpcEvent.type === 'session_stream_ready') {
271
- log(`Durable stream ready (${typeof rpcEvent.streamId === 'string' ? rpcEvent.streamId : 'no stream id'})`);
272
- return;
273
- }
274
- if (rpcEvent.type === 'rpc_command_error') {
275
- const error = typeof rpcEvent.error === 'string'
276
- ? rpcEvent.error
277
- : 'Remote command failed';
278
- const ctx = getNativeRemoteExtensionContext();
279
- if (ctx?.hasUI) {
280
- ctx.ui.notify(error, 'warning');
281
- lifecycleOwnsWorkingMessage = clearRemoteLifecycleWorkingMessage(ctx.ui, lifecycleOwnsWorkingMessage);
282
- }
283
- agent._state.error = error;
284
- seenAgentStart = false;
285
- seenMessageStart = false;
286
- resolveRunningPrompt();
287
- assistantStreamActive = false;
288
- log(`Remote command error: ${error}`);
289
- return;
290
- }
291
- // session_hydration is handled separately below — skip it here
292
- if (rpcEvent.type === 'session_hydration')
293
- return;
294
- // Remote prompts from other controllers are broadcast as user_prompt.
295
- // Convert them to synthetic user message lifecycle events so InteractiveMode
296
- // renders them like locally-entered prompts. Replays are covered by hydration.
297
- if (rpcEvent.type === 'user_prompt') {
298
- if (isReplay) {
299
- log('Skipping replay user_prompt');
300
- return;
301
- }
302
- const promptText = typeof rpcEvent.content === 'string'
303
- ? rpcEvent.content
304
- : typeof rpcEvent.text === 'string'
305
- ? rpcEvent.text
306
- : '';
307
- if (!promptText.trim()) {
308
- log('Skipping empty user_prompt');
309
- return;
310
- }
311
- const promptTimestamp = typeof rpcEvent.timestamp === 'number'
312
- ? rpcEvent.timestamp
313
- : Date.now();
314
- log('Rendering live user_prompt as synthetic user message');
315
- emitRemoteUserPrompt(promptText, promptTimestamp);
316
- return;
317
- }
318
- // Skip user-role message events — the TUI already shows user messages
319
- // via InteractiveMode input or the synthetic user_prompt path above.
320
- // Pi emits message_start/end for both user and assistant messages; without
321
- // this guard the same prompt can appear twice.
322
- if (rpcEvent.type === 'message_start' || rpcEvent.type === 'message_end') {
323
- const msg = rpcEvent.message;
324
- if (msg?.role === 'user') {
325
- log(`Skipping ${rpcEvent.type} (role=user) — handled locally`);
326
- return;
327
- }
328
- }
329
- // Dedup: skip if we already processed the same event type + timestamp recently
330
- // Replays still check the cache, but they never populate it.
331
- const ts = rpcEvent.timestamp ?? 0;
332
- const dedupKey = `${rpcEvent.type}:${ts}`;
333
- if (recentEventKeys.has(dedupKey)) {
334
- log(`Dedup: skipping duplicate ${rpcEvent.type} (ts=${ts})`);
335
- return;
336
- }
337
- if (!isReplay && ts > 0) {
338
- recentEventKeys.add(dedupKey);
339
- setTimeout(() => recentEventKeys.delete(dedupKey), DEDUP_WINDOW_MS);
340
- }
341
- // Skip duplicate agent_start if we already emitted a synthetic one
342
- if (rpcEvent.type === 'agent_start' && syntheticAgentStartEmitted) {
343
- syntheticAgentStartEmitted = false;
344
- // Still update state from real event
345
- updateAgentState(agent, rpcEvent);
346
- return;
347
- }
348
- // Skip replay events — these are historical from Durable Stream
349
- if (isReplay) {
350
- log(`Skipping replay event: ${rpcEvent.type}`);
351
- return;
352
- }
353
- const hadSeenAgentStart = seenAgentStart;
354
- const hadSeenMessageStart = seenMessageStart;
355
- const assistantMessageKey = getRemoteAssistantMessageKey(rpcEvent);
356
- if (assistantMessageKey &&
357
- (rpcEvent.type === 'message_start' || rpcEvent.type === 'message_end') &&
358
- completedAssistantMessageKeySet.has(assistantMessageKey)) {
359
- log(`Dedup: skipping repeated assistant ${rpcEvent.type}`);
360
- return;
361
- }
362
- // State-based dedup for assistant message streaming.
363
- // Prevents duplicate AssistantMessageComponent from being added to the DOM.
364
- if (rpcEvent.type === 'message_start') {
365
- const msg = rpcEvent.message;
366
- if (msg?.role === 'assistant') {
367
- if (assistantStreamActive) {
368
- log(`Dedup: skipping duplicate assistant message_start (stream already active)`);
369
- return;
370
- }
371
- assistantStreamActive = true;
372
- }
373
- }
374
- if (rpcEvent.type === 'message_end') {
375
- const msg = rpcEvent.message;
376
- if (msg?.role === 'assistant') {
377
- assistantStreamActive = false;
378
- if (assistantMessageKey) {
379
- rememberCompletedAssistantMessage(assistantMessageKey);
380
- }
381
- }
382
- }
383
- if (rpcEvent.type === 'agent_end') {
384
- assistantStreamActive = false;
385
- }
386
- // Track streaming lifecycle events so we can inject synthetics when
387
- // we attach mid-stream (controller connected after agent already started).
388
- if (rpcEvent.type === 'agent_start')
389
- seenAgentStart = true;
390
- if (rpcEvent.type === 'agent_end') {
391
- seenAgentStart = false;
392
- seenMessageStart = false;
393
- }
394
- if (rpcEvent.type === 'message_start')
395
- seenMessageStart = true;
396
- if (rpcEvent.type === 'message_end')
397
- seenMessageStart = false;
398
- // Update agent internal state (mirrors Agent._runLoop behavior)
399
- updateAgentState(agent, rpcEvent);
400
- // Buffer events until InteractiveMode is ready to receive them
401
- if (!interactiveModeReady) {
402
- eventBuffer.push(rpcEvent);
403
- log(`Buffered event: ${rpcEvent.type} (InteractiveMode not ready)`);
404
- return;
405
- }
406
- // Mid-stream attach guard: if we receive message_update or message_end
407
- // without having seen message_start, inject synthetic agent_start +
408
- // message_start so InteractiveMode sets up its streaming component.
409
- // Without this, the events are silently dropped because
410
- // InteractiveMode.streamingComponent is null.
411
- // This happens when the controller connects mid-stream or after the
412
- // agent finishes — the broadcast of agent_start/message_start occurred
413
- // before the controller WebSocket was registered.
414
- let injectedSyntheticMessageStart = false;
415
- if ((rpcEvent.type === 'message_update' || rpcEvent.type === 'message_end') &&
416
- !hadSeenMessageStart) {
417
- log(`Live ${rpcEvent.type} without prior message_start — injecting synthetics`);
418
- if (!hadSeenAgentStart) {
419
- agent.emit({ type: 'agent_start', agentName: 'lead', timestamp: Date.now() });
420
- seenAgentStart = true;
421
- }
422
- agent.emit({
423
- type: 'message_start',
424
- message: {
425
- role: 'assistant',
426
- content: [],
427
- api: 'anthropic-messages',
428
- provider: 'anthropic',
429
- model: 'remote',
430
- usage: {
431
- input: 0,
432
- output: 0,
433
- cacheRead: 0,
434
- cacheWrite: 0,
435
- totalTokens: 0,
436
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
437
- },
438
- timestamp: Date.now(),
439
- },
440
- });
441
- seenMessageStart = true;
442
- assistantStreamActive = true;
443
- injectedSyntheticMessageStart = true;
444
- }
445
- // Emit to subscribers — InteractiveMode.handleEvent processes this
446
- agent.emit(rpcEvent);
447
- if (injectedSyntheticMessageStart && rpcEvent.type === 'message_end') {
448
- seenMessageStart = false;
449
- seenAgentStart = hadSeenAgentStart;
450
- assistantStreamActive = false;
451
- }
452
- // Resolve running prompt when agent finishes
453
- if (rpcEvent.type === 'agent_end') {
454
- resolveRunningPrompt();
455
- }
456
- });
457
- // ── 6. Wire up UI handlers for extension dialogs from sandbox ──
458
- remote.setUiHandler(async (request) => {
459
- const ctx = getNativeRemoteExtensionContext() ?? (await waitForNativeRemoteExtensionContext(10_000));
460
- if (!ctx) {
461
- log(`UI request: ${request.method} (${request.id}) timed out waiting for extension UI context`);
462
- return REMOTE_FIRE_AND_FORGET_UI_METHODS.has(request.method) ? undefined : null;
463
- }
464
- try {
465
- return await handleRemoteUiRequest(ctx, request);
466
- }
467
- catch (err) {
468
- log(`UI request handler error for ${request.method}: ${err instanceof Error ? err.message : String(err)}`);
469
- return REMOTE_FIRE_AND_FORGET_UI_METHODS.has(request.method) ? undefined : null;
470
- }
471
- });
472
- // ── 7. Handle hydration (initial state from Hub) ──
473
- // Hydration arrives as the message AFTER 'init' on the WebSocket.
474
- // remote.connect() resolves on 'init', so hydration arrives in the next
475
- // event loop tick. We use a promise to wait for it before creating
476
- // InteractiveMode (which calls renderInitialMessages from SessionManager).
477
- const sm = session.sessionManager;
478
- let resolveHydration;
479
- let hydrationComplete = false;
480
- const hydrationReady = new Promise((resolve) => {
481
- resolveHydration = () => {
482
- if (hydrationComplete)
483
- return;
484
- hydrationComplete = true;
485
- resolve();
486
- };
487
- });
488
- let hydrationCount = 0;
489
- remote.onEvent((event) => {
490
- if (event.type !== 'session_hydration')
491
- return;
492
- hydrationCount++;
493
- const entries = event.entries;
494
- // Extract task text from hydration (Hub includes session.sandbox?.task)
495
- const hydrationTask = event.task;
496
- // On reconnect (2nd+ hydration), clear SM to prevent duplicate accumulation.
497
- // agent.replaceMessages() already replaces state.messages, but SM only appends.
498
- if (hydrationCount > 1) {
499
- log(`Re-hydration #${hydrationCount} — clearing SessionManager to prevent duplicates`);
500
- try {
501
- if (typeof sm.clear === 'function') {
502
- sm.clear();
503
- }
504
- }
505
- catch (err) {
506
- log(`SM clear error (non-fatal): ${err}`);
507
- }
508
- }
509
- if (!entries?.length) {
510
- log('Received session_hydration with no entries');
511
- // Even with no entries, inject task as user message if available
512
- if (hydrationTask) {
513
- const taskMsg = {
514
- role: 'user',
515
- content: [{ type: 'text', text: hydrationTask }],
516
- timestamp: Date.now(),
517
- };
518
- agent.replaceMessages([taskMsg]);
519
- try {
520
- sm.appendMessage(taskMsg);
521
- }
522
- catch (err) {
523
- log(`SM append task error: ${err}`);
524
- }
525
- log('Injected task as user message (no entries)');
526
- }
527
- resolveHydration();
528
- return;
529
- }
530
- log(`Hydrating ${entries.length} entries (hydration #${hydrationCount})`);
531
- const agentMessages = [];
532
- // If we have a task and no user_prompt entry, inject the task as the first user message
533
- const hasUserEntry = entries.some((e) => e.type === 'user_prompt' || e.role === 'user');
534
- if (hydrationTask && !hasUserEntry) {
535
- const taskMsg = {
536
- role: 'user',
537
- content: [{ type: 'text', text: hydrationTask }],
538
- timestamp: Date.now(),
539
- };
540
- agentMessages.push(taskMsg);
541
- try {
542
- sm.appendMessage(taskMsg);
543
- }
544
- catch (err) {
545
- log(`SM append task error: ${err}`);
546
- }
547
- log('Injected task as user message');
548
- }
549
- for (const entry of entries) {
550
- const text = typeof entry.content === 'string'
551
- ? entry.content
552
- : Array.isArray(entry.content)
553
- ? entry.content
554
- .filter((c) => c.type === 'text' && typeof c.text === 'string')
555
- .map((c) => c.text)
556
- .join('\n')
557
- : '';
558
- if (!text)
559
- continue;
560
- // Hub conversation entries use type: 'message' for assistant, 'thinking' for thinking,
561
- // 'task_result' for delegation results, 'turn' for turn markers, 'user_prompt' for user input.
562
- // Only 'user_prompt' entries are user messages; everything else is assistant-side.
563
- const isAssistant = entry.role === 'assistant' ||
564
- entry.type === 'message' ||
565
- entry.type === 'thinking' ||
566
- entry.type === 'task_result' ||
567
- entry.type === 'assistant';
568
- if (isAssistant) {
569
- const msg = {
570
- role: 'assistant',
571
- content: [{ type: 'text', text }],
572
- api: 'anthropic-messages',
573
- provider: 'anthropic',
574
- model: 'remote',
575
- usage: {
576
- input: 0,
577
- output: 0,
578
- cacheRead: 0,
579
- cacheWrite: 0,
580
- totalTokens: 0,
581
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
582
- },
583
- stopReason: 'stop',
584
- timestamp: entry.timestamp ?? Date.now(),
585
- };
586
- agentMessages.push(msg);
587
- try {
588
- sm.appendMessage(msg);
589
- }
590
- catch (err) {
591
- log(`SM append error: ${err}`);
592
- }
593
- }
594
- else {
595
- const msg = {
596
- role: 'user',
597
- content: [{ type: 'text', text }],
598
- timestamp: entry.timestamp ?? Date.now(),
599
- };
600
- agentMessages.push(msg);
601
- try {
602
- sm.appendMessage(msg);
603
- }
604
- catch (err) {
605
- log(`SM append error: ${err}`);
606
- }
607
- }
608
- }
609
- if (agentMessages.length > 0) {
610
- agent.replaceMessages(agentMessages);
611
- log(`Hydrated ${agentMessages.length} agent messages (+ session manager)`);
612
- }
613
- else {
614
- log('Hydration: 0 messages after filtering (all entries had empty text?)');
615
- }
616
- // Restore streaming state from hydration — fixes first-connect miss
617
- const streamingState = event.streamingState;
618
- if (streamingState?.isStreaming) {
619
- agent._state.isStreaming = true;
620
- hydrationStreamingDetected = true;
621
- // Create runningPrompt so InteractiveMode knows we're busy
622
- if (!agent.runningPrompt) {
623
- const runPromise = new Promise((resolve) => {
624
- runningPromptResolve = resolve;
625
- });
626
- agent.runningPrompt = runPromise;
627
- }
628
- log(`Hydration: session is streaming with ${streamingState.activeTasks?.length ?? 0} active tasks`);
629
- }
630
- resolveHydration();
631
- });
632
- // ── 8. NOW connect to Hub ──
633
- // All handlers are registered, so hydration + replay events will be captured.
634
- log('Connecting to Hub (handlers registered)...');
635
- await remote.connect(hubWsUrl);
636
- log('Connected to Hub as controller');
637
- // Wait for hydration message (arrives right after init), with a timeout
638
- // in case this is the first connection and there's nothing to hydrate.
639
- await Promise.race([
640
- hydrationReady,
641
- new Promise((resolve) => {
642
- const waitStartedAt = Date.now();
643
- const poll = () => {
644
- if (hydrationComplete) {
645
- resolve();
646
- return;
647
- }
648
- const timeoutMs = sessionResumeSeen ? 5000 : 2000;
649
- if (Date.now() - waitStartedAt >= timeoutMs) {
650
- log('Hydration timeout — no session_hydration received');
651
- resolve();
652
- return;
653
- }
654
- setTimeout(poll, 50);
655
- };
656
- poll();
657
- }),
658
- ]);
659
- const smEntries = sm.getEntries?.() ?? [];
660
- log(`SessionManager has ${smEntries.length} entries after hydration`);
661
- log(`Post-hydration: SM has ${smEntries.length} entries, leafId=${sm.getLeafId?.() ?? 'N/A'}`);
662
- // ── 9. Start InteractiveMode — full native Pi TUI ──
663
- log('Creating InteractiveMode');
664
- const interactive = new InteractiveMode(session);
665
- log('InteractiveMode created, calling init...');
666
- await interactive.init();
667
- // Flush buffered events now that InteractiveMode is listening.
668
- // If the session was already streaming when we connected (mid-stream attach),
669
- // InteractiveMode needs agent_start + message_start to set up its streaming
670
- // components. Without these, message_update events are silently dropped
671
- // because InteractiveMode.streamingComponent is null.
672
- interactiveModeReady = true;
673
- if (hydrationStreamingDetected) {
674
- // Immediately emit agent_start + message_start so InteractiveMode shows
675
- // the streaming indicator right away, before any buffered events flush.
676
- // This prevents the blank screen gap between connect and first event.
677
- log('Hydration detected streaming — emitting immediate synthetics');
678
- agent.emit({ type: 'agent_start', agentName: 'lead', timestamp: Date.now() });
679
- agent.emit({
680
- type: 'message_start',
681
- message: {
682
- role: 'assistant',
683
- content: [],
684
- api: 'anthropic-messages',
685
- provider: 'anthropic',
686
- model: 'remote',
687
- usage: {
688
- input: 0,
689
- output: 0,
690
- cacheRead: 0,
691
- cacheWrite: 0,
692
- totalTokens: 0,
693
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
694
- },
695
- timestamp: Date.now(),
696
- },
697
- });
698
- seenAgentStart = true;
699
- seenMessageStart = true;
700
- assistantStreamActive = true;
701
- // Remove any agent_start/message_start from buffer since we already emitted them
702
- eventBuffer = eventBuffer.filter((e) => e.type !== 'agent_start' && e.type !== 'message_start');
703
- }
704
- if (eventBuffer.length > 0) {
705
- log(`Flushing ${eventBuffer.length} events: ${eventBuffer.map((e) => e.type).join(', ')}`);
706
- for (const buffered of eventBuffer) {
707
- agent.emit(buffered);
708
- if (buffered.type === 'agent_end') {
709
- resolveRunningPrompt();
710
- }
711
- }
712
- }
713
- eventBuffer = [];
714
- log('InteractiveMode initialized, calling run...');
715
- // Handle clean shutdown
716
- const cleanup = () => {
717
- remote.close();
718
- setNativeRemoteExtensionContext(null);
719
- interactive.stop();
720
- };
721
- process.on('SIGINT', cleanup);
722
- process.on('SIGTERM', cleanup);
723
- try {
724
- await interactive.run();
725
- }
726
- catch (err) {
727
- log(`InteractiveMode.run() threw: ${err instanceof Error ? err.stack : String(err)}`);
728
- throw err;
729
- }
730
- finally {
731
- remote.close();
732
- setNativeRemoteExtensionContext(null);
733
- log('Remote TUI exited');
734
- }
735
- // ── Helper: resolve the running prompt promise ──
736
- function resolveRunningPrompt() {
737
- syntheticAgentStartEmitted = false;
738
- agent._state.isStreaming = false;
739
- agent._state.streamMessage = null;
740
- agent._state.pendingToolCalls = new Set();
741
- if (runningPromptResolve) {
742
- runningPromptResolve();
743
- runningPromptResolve = null;
744
- agent.runningPrompt = undefined;
745
- }
746
- }
747
- }
748
- // ══════════════════════════════════════════════
749
- // Agent state synchronization
750
- // Mirrors Agent._runLoop state updates (agent.js lines 317-352)
751
- // ══════════════════════════════════════════════
752
- function updateAgentState(agent, event) {
753
- const state = agent._state;
754
- switch (event.type) {
755
- case 'agent_start':
756
- state.isStreaming = true;
757
- break;
758
- case 'agent_end':
759
- state.isStreaming = false;
760
- state.streamMessage = null;
761
- state.pendingToolCalls = new Set();
762
- break;
763
- case 'message_start':
764
- state.streamMessage = event.message;
765
- state.isStreaming = true;
766
- break;
767
- case 'message_update':
768
- state.streamMessage = event.message;
769
- break;
770
- case 'message_end':
771
- state.streamMessage = null;
772
- // NOTE: Do NOT push to state.messages here.
773
- // AgentSession._handleAgentEvent already persists via sessionManager.appendMessage().
774
- // Pushing here causes state.messages to accumulate duplicates with SM,
775
- // leading to visual duplicates if rebuildChatFromMessages() is ever triggered.
776
- break;
777
- case 'tool_execution_start': {
778
- const s = new Set(state.pendingToolCalls);
779
- s.add(event.toolCallId);
780
- state.pendingToolCalls = s;
781
- break;
782
- }
783
- case 'tool_execution_end': {
784
- const s = new Set(state.pendingToolCalls);
785
- s.delete(event.toolCallId);
786
- state.pendingToolCalls = s;
787
- break;
788
- }
789
- case 'thinking_start':
790
- state.isStreaming = true;
791
- break;
792
- case 'thinking_end':
793
- break;
794
- case 'tool_call':
795
- state.isStreaming = true;
796
- break;
797
- case 'tool_result':
798
- break;
799
- case 'task_start':
800
- state.isStreaming = true;
801
- break;
802
- case 'task_complete':
803
- case 'task_error':
804
- break;
805
- case 'turn_end': {
806
- const msg = event.message;
807
- if (msg?.role === 'assistant' && msg?.errorMessage) {
808
- state.error = msg.errorMessage;
809
- }
810
- break;
811
- }
812
- }
813
- }
814
- // ══════════════════════════════════════════════
815
- // Text extraction helpers
816
- // ══════════════════════════════════════════════
817
- function extractPromptText(input) {
818
- if (typeof input === 'string')
819
- return input;
820
- if (Array.isArray(input)) {
821
- return input.map(extractMessageText).filter(Boolean).join('\n');
822
- }
823
- return extractMessageText(input);
824
- }
825
- function extractMessageText(msg) {
826
- if (typeof msg === 'string')
827
- return msg;
828
- if (!msg || typeof msg !== 'object')
829
- return '';
830
- if (typeof msg.content === 'string')
831
- return msg.content;
832
- if (Array.isArray(msg.content)) {
833
- return msg.content
834
- .filter((c) => c?.type === 'text' && typeof c.text === 'string')
835
- .map((c) => c.text)
836
- .join('\n');
837
- }
838
- return '';
839
- }
840
- function getRemoteAssistantMessageKey(event) {
841
- if (event.type !== 'message_start' && event.type !== 'message_end')
842
- return undefined;
843
- const message = event.message;
844
- if (!message || typeof message !== 'object' || message.role !== 'assistant') {
845
- return undefined;
846
- }
847
- const messageId = typeof message.id === 'string' ? message.id : '';
848
- if (messageId)
849
- return `id:${messageId}`;
850
- const timestamp = typeof message.timestamp === 'number'
851
- ? String(message.timestamp)
852
- : typeof message.timestamp === 'string'
853
- ? message.timestamp
854
- : typeof event.timestamp === 'number'
855
- ? String(event.timestamp)
856
- : typeof event.timestamp === 'string'
857
- ? event.timestamp
858
- : '';
859
- if (timestamp)
860
- return `ts:${timestamp}`;
861
- const text = extractMessageText(message);
862
- if (!text)
863
- return undefined;
864
- const stopReason = typeof message.stopReason === 'string' ? message.stopReason : '';
865
- return `text:${stopReason}|${text}`;
866
- }
867
- //# sourceMappingURL=remote-tui.js.map