@earendil-works/pi-coding-agent 0.75.5 → 0.77.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/CHANGELOG.md +73 -0
  2. package/README.md +4 -0
  3. package/dist/cli/args.d.ts +2 -0
  4. package/dist/cli/args.d.ts.map +1 -1
  5. package/dist/cli/args.js +15 -0
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/config.d.ts.map +1 -1
  8. package/dist/config.js +15 -2
  9. package/dist/config.js.map +1 -1
  10. package/dist/core/agent-session-services.d.ts +1 -0
  11. package/dist/core/agent-session-services.d.ts.map +1 -1
  12. package/dist/core/agent-session-services.js +1 -0
  13. package/dist/core/agent-session-services.js.map +1 -1
  14. package/dist/core/agent-session.d.ts +5 -1
  15. package/dist/core/agent-session.d.ts.map +1 -1
  16. package/dist/core/agent-session.js +28 -4
  17. package/dist/core/agent-session.js.map +1 -1
  18. package/dist/core/compaction/compaction.d.ts.map +1 -1
  19. package/dist/core/compaction/compaction.js +18 -24
  20. package/dist/core/compaction/compaction.js.map +1 -1
  21. package/dist/core/extensions/runner.d.ts +1 -1
  22. package/dist/core/extensions/runner.d.ts.map +1 -1
  23. package/dist/core/extensions/runner.js +8 -2
  24. package/dist/core/extensions/runner.js.map +1 -1
  25. package/dist/core/extensions/types.d.ts +7 -5
  26. package/dist/core/extensions/types.d.ts.map +1 -1
  27. package/dist/core/extensions/types.js.map +1 -1
  28. package/dist/core/model-registry.d.ts.map +1 -1
  29. package/dist/core/model-registry.js +65 -13
  30. package/dist/core/model-registry.js.map +1 -1
  31. package/dist/core/model-resolver.d.ts.map +1 -1
  32. package/dist/core/model-resolver.js +1 -1
  33. package/dist/core/model-resolver.js.map +1 -1
  34. package/dist/core/output-guard.d.ts +1 -0
  35. package/dist/core/output-guard.d.ts.map +1 -1
  36. package/dist/core/output-guard.js +52 -22
  37. package/dist/core/output-guard.js.map +1 -1
  38. package/dist/core/package-manager.d.ts.map +1 -1
  39. package/dist/core/package-manager.js +16 -4
  40. package/dist/core/package-manager.js.map +1 -1
  41. package/dist/core/resolve-config-value.d.ts +9 -1
  42. package/dist/core/resolve-config-value.d.ts.map +1 -1
  43. package/dist/core/resolve-config-value.js +134 -11
  44. package/dist/core/resolve-config-value.js.map +1 -1
  45. package/dist/core/sdk.d.ts +2 -0
  46. package/dist/core/sdk.d.ts.map +1 -1
  47. package/dist/core/sdk.js +10 -6
  48. package/dist/core/sdk.js.map +1 -1
  49. package/dist/core/session-manager.d.ts +6 -7
  50. package/dist/core/session-manager.d.ts.map +1 -1
  51. package/dist/core/session-manager.js +75 -28
  52. package/dist/core/session-manager.js.map +1 -1
  53. package/dist/core/settings-manager.d.ts +2 -0
  54. package/dist/core/settings-manager.d.ts.map +1 -1
  55. package/dist/core/settings-manager.js +14 -9
  56. package/dist/core/settings-manager.js.map +1 -1
  57. package/dist/core/system-prompt.d.ts.map +1 -1
  58. package/dist/core/system-prompt.js +0 -3
  59. package/dist/core/system-prompt.js.map +1 -1
  60. package/dist/main.d.ts.map +1 -1
  61. package/dist/main.js +61 -16
  62. package/dist/main.js.map +1 -1
  63. package/dist/migrations.d.ts.map +1 -1
  64. package/dist/migrations.js +118 -1
  65. package/dist/migrations.js.map +1 -1
  66. package/dist/modes/interactive/components/login-dialog.d.ts +1 -3
  67. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  68. package/dist/modes/interactive/components/login-dialog.js +2 -4
  69. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  70. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  71. package/dist/modes/interactive/components/user-message.js +1 -1
  72. package/dist/modes/interactive/components/user-message.js.map +1 -1
  73. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  74. package/dist/modes/interactive/interactive-mode.js +25 -6
  75. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  76. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  77. package/dist/modes/interactive/theme/theme.js +10 -0
  78. package/dist/modes/interactive/theme/theme.js.map +1 -1
  79. package/dist/modes/rpc/rpc-client.d.ts +3 -0
  80. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  81. package/dist/modes/rpc/rpc-client.js +64 -7
  82. package/dist/modes/rpc/rpc-client.js.map +1 -1
  83. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  84. package/dist/modes/rpc/rpc-mode.js +18 -4
  85. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  86. package/dist/modes/rpc/rpc-types.d.ts +1 -0
  87. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  88. package/dist/modes/rpc/rpc-types.js.map +1 -1
  89. package/dist/utils/deprecation.d.ts +4 -0
  90. package/dist/utils/deprecation.d.ts.map +1 -0
  91. package/dist/utils/deprecation.js +13 -0
  92. package/dist/utils/deprecation.js.map +1 -0
  93. package/dist/utils/json.d.ts +3 -0
  94. package/dist/utils/json.d.ts.map +1 -0
  95. package/dist/utils/json.js +7 -0
  96. package/dist/utils/json.js.map +1 -0
  97. package/docs/custom-provider.md +13 -10
  98. package/docs/development.md +1 -1
  99. package/docs/extensions.md +12 -6
  100. package/docs/models.md +25 -12
  101. package/docs/providers.md +13 -5
  102. package/docs/sdk.md +6 -0
  103. package/docs/settings.md +6 -2
  104. package/docs/terminal-setup.md +6 -0
  105. package/docs/usage.md +4 -0
  106. package/examples/extensions/README.md +1 -0
  107. package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
  108. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  109. package/examples/extensions/custom-provider-anthropic/package.json +1 -1
  110. package/examples/extensions/custom-provider-gitlab-duo/index.ts +1 -1
  111. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  112. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  113. package/examples/extensions/input-transform-streaming.ts +39 -0
  114. package/examples/extensions/sandbox/package-lock.json +2 -2
  115. package/examples/extensions/sandbox/package.json +1 -1
  116. package/examples/extensions/with-deps/package-lock.json +2 -2
  117. package/examples/extensions/with-deps/package.json +1 -1
  118. package/npm-shrinkwrap.json +71 -56
  119. package/package.json +6 -6
@@ -93,6 +93,7 @@ export class AgentSession {
93
93
  _extensionRunnerRef;
94
94
  _initialActiveToolNames;
95
95
  _allowedToolNames;
96
+ _excludedToolNames;
96
97
  _baseToolsOverride;
97
98
  _sessionStartEvent;
98
99
  _extensionUIContext;
@@ -123,6 +124,7 @@ export class AgentSession {
123
124
  this._extensionRunnerRef = config.extensionRunnerRef;
124
125
  this._initialActiveToolNames = config.initialActiveToolNames;
125
126
  this._allowedToolNames = config.allowedToolNames ? new Set(config.allowedToolNames) : undefined;
127
+ this._excludedToolNames = config.excludedToolNames ? new Set(config.excludedToolNames) : undefined;
126
128
  this._baseToolsOverride = config.baseToolsOverride;
127
129
  this._sessionStartEvent = config.sessionStartEvent ?? { type: "session_start", reason: "startup" };
128
130
  // Always subscribe to agent events for internal handling
@@ -467,6 +469,16 @@ export class AgentSession {
467
469
  * Call this when completely done with the session.
468
470
  */
469
471
  dispose() {
472
+ try {
473
+ this.abortRetry();
474
+ this.abortCompaction();
475
+ this.abortBranchSummary();
476
+ this.abortBash();
477
+ this.agent.abort();
478
+ }
479
+ catch {
480
+ // Dispose must succeed even if an abort hook throws.
481
+ }
470
482
  this._extensionRunner.invalidate("This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().");
471
483
  this._disconnectFromAgent();
472
484
  this._eventListeners = [];
@@ -507,13 +519,14 @@ export class AgentSession {
507
519
  return this.agent.state.tools.map((t) => t.name);
508
520
  }
509
521
  /**
510
- * Get all configured tools with name, description, parameter schema, and source metadata.
522
+ * Get all configured tools with name, description, parameter schema, prompt guidelines, and source metadata.
511
523
  */
512
524
  getAllTools() {
513
525
  return Array.from(this._toolDefinitions.values()).map(({ definition, sourceInfo }) => ({
514
526
  name: definition.name,
515
527
  description: definition.description,
516
528
  parameters: definition.parameters,
529
+ promptGuidelines: definition.promptGuidelines,
517
530
  sourceInfo,
518
531
  }));
519
532
  }
@@ -668,7 +681,12 @@ export class AgentSession {
668
681
  });
669
682
  this._retryAttempt = 0;
670
683
  }
671
- return await this._checkCompaction(msg);
684
+ if (await this._checkCompaction(msg)) {
685
+ return true;
686
+ }
687
+ // The agent loop drains both queues before emitting agent_end. Any messages
688
+ // here were queued by agent_end extension handlers and need a continuation.
689
+ return this.agent.hasQueuedMessages();
672
690
  }
673
691
  /**
674
692
  * Send a prompt to the agent.
@@ -698,7 +716,7 @@ export class AgentSession {
698
716
  let currentText = text;
699
717
  let currentImages = options?.images;
700
718
  if (this._extensionRunner.hasHandlers("input")) {
701
- const inputResult = await this._extensionRunner.emitInput(currentText, currentImages, options?.source ?? "interactive");
719
+ const inputResult = await this._extensionRunner.emitInput(currentText, currentImages, options?.source ?? "interactive", this.isStreaming ? options?.streamingBehavior : undefined);
702
720
  if (inputResult.action === "handled") {
703
721
  preflightResult?.(true);
704
722
  return;
@@ -1796,7 +1814,8 @@ export class AgentSession {
1796
1814
  const previousRegistryNames = new Set(this._toolRegistry.keys());
1797
1815
  const previousActiveToolNames = this.getActiveToolNames();
1798
1816
  const allowedToolNames = this._allowedToolNames;
1799
- const isAllowedTool = (name) => !allowedToolNames || allowedToolNames.has(name);
1817
+ const excludedToolNames = this._excludedToolNames;
1818
+ const isAllowedTool = (name) => (!allowedToolNames || allowedToolNames.has(name)) && !excludedToolNames?.has(name);
1800
1819
  const registeredTools = this._extensionRunner.getAllRegisteredTools();
1801
1820
  const allCustomTools = [
1802
1821
  ...registeredTools,
@@ -1926,6 +1945,9 @@ export class AgentSession {
1926
1945
  // =========================================================================
1927
1946
  // Auto-Retry
1928
1947
  // =========================================================================
1948
+ _isNonRetryableProviderLimitError(errorMessage) {
1949
+ return /GoUsageLimitError|FreeUsageLimitError|Monthly usage limit reached|available balance|insufficient_quota|out of budget|quota exceeded|billing/i.test(errorMessage);
1950
+ }
1929
1951
  /**
1930
1952
  * Check if an error is retryable (overloaded, rate limit, server errors).
1931
1953
  * Context overflow errors are NOT retryable (handled by compaction instead).
@@ -1938,6 +1960,8 @@ export class AgentSession {
1938
1960
  if (isContextOverflow(message, contextWindow))
1939
1961
  return false;
1940
1962
  const err = message.errorMessage;
1963
+ if (this._isNonRetryableProviderLimitError(err))
1964
+ return false;
1941
1965
  // Match: overloaded_error, provider returned error, rate limit, 429, 500, 502, 503, 504, service unavailable, network/connection errors (including connection lost), WebSocket transport closes/errors, fetch failed, premature stream endings, HTTP/2 closed before response, terminated, retry delay exceeded
1942
1966
  return /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|websocket.?closed|websocket.?error|other side closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|stream ended before message_stop|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i.test(err);
1943
1967
  }