@earendil-works/pi-coding-agent 0.76.0 → 0.78.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 +68 -0
  2. package/README.md +9 -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 +23 -0
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/core/agent-session-services.d.ts +1 -0
  8. package/dist/core/agent-session-services.d.ts.map +1 -1
  9. package/dist/core/agent-session-services.js +1 -0
  10. package/dist/core/agent-session-services.js.map +1 -1
  11. package/dist/core/agent-session.d.ts +4 -1
  12. package/dist/core/agent-session.d.ts.map +1 -1
  13. package/dist/core/agent-session.js +23 -4
  14. package/dist/core/agent-session.js.map +1 -1
  15. package/dist/core/extensions/runner.d.ts +1 -1
  16. package/dist/core/extensions/runner.d.ts.map +1 -1
  17. package/dist/core/extensions/runner.js +8 -2
  18. package/dist/core/extensions/runner.js.map +1 -1
  19. package/dist/core/extensions/types.d.ts +7 -5
  20. package/dist/core/extensions/types.d.ts.map +1 -1
  21. package/dist/core/extensions/types.js.map +1 -1
  22. package/dist/core/model-registry.d.ts.map +1 -1
  23. package/dist/core/model-registry.js +65 -13
  24. package/dist/core/model-registry.js.map +1 -1
  25. package/dist/core/model-resolver.d.ts.map +1 -1
  26. package/dist/core/model-resolver.js +1 -1
  27. package/dist/core/model-resolver.js.map +1 -1
  28. package/dist/core/resolve-config-value.d.ts +9 -1
  29. package/dist/core/resolve-config-value.d.ts.map +1 -1
  30. package/dist/core/resolve-config-value.js +134 -11
  31. package/dist/core/resolve-config-value.js.map +1 -1
  32. package/dist/core/sdk.d.ts +2 -0
  33. package/dist/core/sdk.d.ts.map +1 -1
  34. package/dist/core/sdk.js +4 -5
  35. package/dist/core/sdk.js.map +1 -1
  36. package/dist/core/session-manager.d.ts +3 -5
  37. package/dist/core/session-manager.d.ts.map +1 -1
  38. package/dist/core/session-manager.js +42 -17
  39. package/dist/core/session-manager.js.map +1 -1
  40. package/dist/core/system-prompt.d.ts.map +1 -1
  41. package/dist/core/system-prompt.js +0 -3
  42. package/dist/core/system-prompt.js.map +1 -1
  43. package/dist/core/tools/edit.d.ts.map +1 -1
  44. package/dist/core/tools/edit.js +7 -10
  45. package/dist/core/tools/edit.js.map +1 -1
  46. package/dist/core/tools/find.d.ts.map +1 -1
  47. package/dist/core/tools/find.js.map +1 -1
  48. package/dist/core/tools/grep.d.ts.map +1 -1
  49. package/dist/core/tools/grep.js.map +1 -1
  50. package/dist/core/tools/ls.d.ts.map +1 -1
  51. package/dist/core/tools/ls.js +5 -7
  52. package/dist/core/tools/ls.js.map +1 -1
  53. package/dist/core/tools/read.d.ts.map +1 -1
  54. package/dist/core/tools/read.js +6 -7
  55. package/dist/core/tools/read.js.map +1 -1
  56. package/dist/core/tools/render-utils.d.ts +5 -2
  57. package/dist/core/tools/render-utils.d.ts.map +1 -1
  58. package/dist/core/tools/render-utils.js +17 -1
  59. package/dist/core/tools/render-utils.js.map +1 -1
  60. package/dist/core/tools/write.d.ts.map +1 -1
  61. package/dist/core/tools/write.js +5 -6
  62. package/dist/core/tools/write.js.map +1 -1
  63. package/dist/index.d.ts +2 -0
  64. package/dist/index.d.ts.map +1 -1
  65. package/dist/index.js +2 -0
  66. package/dist/index.js.map +1 -1
  67. package/dist/main.d.ts.map +1 -1
  68. package/dist/main.js +15 -2
  69. package/dist/main.js.map +1 -1
  70. package/dist/migrations.d.ts.map +1 -1
  71. package/dist/migrations.js +118 -1
  72. package/dist/migrations.js.map +1 -1
  73. package/dist/modes/interactive/components/login-dialog.d.ts +1 -3
  74. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  75. package/dist/modes/interactive/components/login-dialog.js +2 -4
  76. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  77. package/dist/modes/interactive/interactive-mode.d.ts +3 -0
  78. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  79. package/dist/modes/interactive/interactive-mode.js +59 -6
  80. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  81. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  82. package/dist/modes/interactive/theme/theme.js +10 -0
  83. package/dist/modes/interactive/theme/theme.js.map +1 -1
  84. package/dist/utils/deprecation.d.ts +4 -0
  85. package/dist/utils/deprecation.d.ts.map +1 -0
  86. package/dist/utils/deprecation.js +13 -0
  87. package/dist/utils/deprecation.js.map +1 -0
  88. package/dist/utils/json.d.ts +3 -0
  89. package/dist/utils/json.d.ts.map +1 -0
  90. package/dist/utils/json.js +7 -0
  91. package/dist/utils/json.js.map +1 -0
  92. package/docs/custom-provider.md +13 -10
  93. package/docs/development.md +1 -1
  94. package/docs/extensions.md +12 -6
  95. package/docs/models.md +25 -12
  96. package/docs/providers.md +13 -5
  97. package/docs/quickstart.md +1 -0
  98. package/docs/rpc.md +2 -1
  99. package/docs/sdk.md +6 -0
  100. package/docs/session-format.md +1 -1
  101. package/docs/sessions.md +8 -0
  102. package/docs/settings.md +1 -1
  103. package/docs/terminal-setup.md +2 -0
  104. package/docs/tui.md +2 -2
  105. package/docs/usage.md +9 -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 +54 -3
  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,