@cline/agents 0.0.83 → 0.0.84

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.
package/README.md CHANGED
@@ -178,6 +178,12 @@ Pass a `hooks` bag (`AgentRuntimeHooks`) to observe or influence the loop.
178
178
  All hooks may be async; any that return `{ stop: true, reason }` will halt the
179
179
  run with an `aborted` status.
180
180
 
181
+ `afterModel` also receives an optional `requestId`: the surfaced response's HTTP
182
+ `X-Request-ID`, when the model adapter exposes it. It is not the provider's
183
+ generation ID or a list of retry IDs. Missing IDs remain undefined, and early
184
+ failure/cancellation may skip `afterModel`. Hooks are awaited, so schedule
185
+ observational work separately (and catch its errors) to avoid delaying inference.
186
+
181
187
  ```ts
182
188
  new Agent({
183
189
  providerId,
@@ -62,9 +62,10 @@ export declare class AgentRuntime {
62
62
  private readonly tools;
63
63
  private hooks;
64
64
  /**
65
- * `appendContext` blocks collected from beforeTool/afterTool hooks during
66
- * the current iteration's tool executions, flushed as one user message
67
- * after the tool results so tool-result parts stay contiguous for
65
+ * `appendContext` blocks waiting to be injected as one user message.
66
+ * beforeRun hooks fill it before the run's first model request; beforeTool
67
+ * and afterTool hooks fill it during an iteration's tool executions and it
68
+ * flushes after the tool results, so tool-result parts stay contiguous for
68
69
  * providers that require them first in the following turn.
69
70
  */
70
71
  private pendingHookContexts;
@@ -73,11 +74,14 @@ export declare class AgentRuntime {
73
74
  private overflowRecoveryAttempted;
74
75
  private initialization?;
75
76
  private abortController?;
77
+ private modelSteerController?;
76
78
  private readonly telemetryProviderId?;
77
79
  private readonly telemetryModelId?;
78
80
  constructor(config: AgentRuntimeConfig);
79
81
  run(input: AgentRunInput): Promise<AgentRunResult>;
80
82
  continue(input?: AgentRunInput): Promise<AgentRunResult>;
83
+ /** Interrupt only the current model request; running tools finish normally. */
84
+ notifyPendingUserMessage(): void;
81
85
  abort(reason?: unknown): void;
82
86
  subscribe(listener: AgentEventListener): () => void;
83
87
  /**
@@ -98,6 +102,11 @@ export declare class AgentRuntime {
98
102
  private getCompletionReminderMessages;
99
103
  private addUserReminderMessage;
100
104
  private execute;
105
+ /**
106
+ * Injects the collected hook context blocks as one user message at the end
107
+ * of the conversation. Always delivers: the buffer is empty afterwards.
108
+ */
109
+ private flushPendingHookContexts;
101
110
  private callBeforeRunHooks;
102
111
  private callAfterRunHooks;
103
112
  /**
@@ -150,6 +159,7 @@ export declare class AgentRuntime {
150
159
  private generateAssistantMessageWithOverflowRecovery;
151
160
  private isRecoverableOverflowTurn;
152
161
  private generateAssistantMessage;
162
+ private generateAssistantMessageForRequest;
153
163
  private openTaskLifecycleStream;
154
164
  private captureTaskLifecycleFailure;
155
165
  private captureTaskLifecycle;
@@ -1 +1 @@
1
- {"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}