@falai/agent 4.0.0-alpha.17 → 4.0.0-alpha.19

package/src/core/Speak.ts

@@ -345,6 +345,7 @@ function buildPrompt<C, D>(
       ...body,
       instructionsSection([{ caption: "[Always]", items: req.instructions }], scope),
       inputSection(req.input, req.history),
+      saidSection(req.said),
       formatSection(envelope, options.fields),
     ),
   };
@@ -366,6 +367,21 @@ function inputSection(input: SpeakRequest["input"], history: History): string |
   return input.retry && history.at(-1)?.role === "user" ? ANSWER_PENDING : SPEAK_FIRST;
 }
 
+/**
+ * What this turn already sent before the reply. It sits after the customer's message because that is
+ * when it went out; `history` stops before the turn, so it is the only place the model sees it.
+ */
+function saidSection(said: SpeakRequest["said"]): string | null {
+  const lines = said.map(({ text, media }) =>
+    `- ${[text.trim() && `"${text.trim()}"`, media && `[media: ${media.slug}]`].filter(Boolean).join(" ")}`);
+  if (!lines.length) return null;
+  return [
+    "## Already sent",
+    "You already sent these messages this turn, in this order, and your reply goes out right after them. Do not repeat what they say.",
+    ...lines,
+  ].join("\n");
+}
+
 /** The envelope restated in words, for providers that follow the schema by prompt only. */
 function formatSection(envelope: Envelope, fields: FieldDefs): string {
   const lines = [

package/src/core/contracts.ts

@@ -8,7 +8,7 @@
  */
 
 import type { TokenUsage } from "../types/ai.js";
-import type { Idle } from "../types/agent.js";
+import type { Idle, OutboundMessage } from "../types/agent.js";
 import type { FieldDef, Flow, Instruction, StepBase, TalkStep } from "../types/flow.js";
 import type { History } from "../types/history.js";
 import type { Run, StepOutcomeCode } from "../types/session.js";
@@ -78,6 +78,11 @@ export interface SpeakRequest<C = unknown, D = unknown> {
   context: C;
   data: Partial<D>;
   history: History;
+  /**
+   * What this turn already sent before the reply, in order: a `say`, a fixed question. `history` ends
+   * before the turn, so without these the model cannot see them and says the same thing again.
+   */
+  said: OutboundMessage[];
   now: Date;
   /** Already filtered by their `if`; `when` stays for the prompt. */
   instructions: Instruction<C, D>[];

package/src/providers/ProviderAdapter.ts

@@ -100,7 +100,9 @@ export interface RequestConfig {
    * How hard the model thinks, bound as this provider's default. What absent
    * means is the shape's own business, not one rule: on Gemini it is the
    * model's dynamic thinking; on the OpenAI and OpenRouter dialects nothing is
-   * sent and not thinking is the default anyway; on the Anthropic shape — so
+   * sent, so the model decides — `medium` on GPT-5 and older, and on
+   * OpenRouter GLM 5.3 Flash thinks on most of the hosts that serve it. Set
+   * `"none"` where a turn must not think; on the Anthropic shape — so
    * `AnthropicProvider` and `ZaiProvider` — `@providerkit/core` resolves an
    * absent effort to `"none"`, and Z.ai is sent an explicit disabled marker
    * because its endpoint reads silence as thinking ON. Set a level to ask for