@elizaos/api-client 1.7.1 → 1.7.2-alpha.2

package/dist/core/src/prompts.d.ts

@@ -3,6 +3,6 @@ export declare const messageHandlerTemplate = "<task>Generate dialog and actions
 export declare const postCreationTemplate = "# Task: Create a post in the voice and style and perspective of {{agentName}} @{{twitterUserName}}.\n\nExample task outputs:\n1. A post about the importance of AI in our lives\n<response>\n  <thought>I am thinking about writing a post about the importance of AI in our lives</thought>\n  <post>AI is changing the world and it is important to understand how it works</post>\n  <imagePrompt>A futuristic cityscape with flying cars and people using AI to do things</imagePrompt>\n</response>\n\n2. A post about dogs\n<response>\n  <thought>I am thinking about writing a post about dogs</thought>\n  <post>Dogs are man's best friend and they are loyal and loving</post>\n  <imagePrompt>A dog playing with a ball in a park</imagePrompt>\n</response>\n\n3. A post about finding a new job\n<response>\n  <thought>Getting a job is hard, I bet there's a good tweet in that</thought>\n  <post>Just keep going!</post>\n  <imagePrompt>A person looking at a computer screen with a job search website</imagePrompt>\n</response>\n\n{{providers}}\n\nWrite a post that is {{adjective}} about {{topic}} (without mentioning {{topic}} directly), from the perspective of {{agentName}}. Do not add commentary or acknowledge this request, just write the post.\nYour response should be 1, 2, or 3 sentences (choose the length at random).\nYour response should not contain any questions. Brief, concise statements only. The total character count MUST be less than 280. No emojis. Use \\n\\n (double spaces) between statements if there are multiple statements in your response.\n\nYour output should be formatted in XML like this:\n<response>\n  <thought>Your thought here</thought>\n  <post>Your post text here</post>\n  <imagePrompt>Optional image prompt here</imagePrompt>\n</response>\n\nThe \"post\" field should be the post you want to send. Do not including any thinking or internal reflection in the \"post\" field.\nThe \"imagePrompt\" field is optional and should be a prompt for an image that is relevant to the post. It should be a single sentence that captures the essence of the post. ONLY USE THIS FIELD if it makes sense that the post would benefit from an image.\nThe \"thought\" field should be a short description of what the agent is thinking about before responding, including a brief justification for the response. Includate an explanation how the post is relevant to the topic but unique and different than other posts.\n\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.";
 export declare const booleanFooter = "Respond with only a YES or a NO.";
 export declare const imageDescriptionTemplate = "<task>Analyze the provided image and generate a comprehensive description with multiple levels of detail.</task>\n\n<instructions>\nCarefully examine the image and provide:\n1. A concise, descriptive title that captures the main subject or scene\n2. A brief summary description (1-2 sentences) highlighting the key elements\n3. An extensive, detailed description that covers all visible elements, composition, lighting, colors, mood, and any other relevant details\n\nBe objective and descriptive. Focus on what you can actually see in the image rather than making assumptions about context or meaning.\n</instructions>\n\n<output>\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nRespond using XML format like this:\n<response>\n  <title>A concise, descriptive title for the image</title>\n  <description>A brief 1-2 sentence summary of the key elements in the image</description>\n  <text>An extensive, detailed description covering all visible elements, composition, lighting, colors, mood, setting, objects, people, activities, and any other relevant details you can observe in the image</text>\n</response>\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.\n</output>";
-export declare const multiStepDecisionTemplate = "<task>\nDetermine the next step the assistant should take in this conversation to help the user reach their goal.\n</task>\n\n{{recentMessages}}\n\n# Multi-Step Workflow\n\nIn each step, decide:\n\n1. **Which providers (if any)** should be called to gather necessary data.\n2. **Which action (if any)** should be executed after providers return.\n3. Decide whether the task is complete. If so, set `isFinish: true`. Do not select the `REPLY` action; replies are handled separately after task completion.\n\nYou can select **multiple providers** and at most **one action** per step.\n\nIf the task is fully resolved and no further steps are needed, mark the step as `isFinish: true`.\n\n---\n\n{{actionsWithDescriptions}}\n\n{{providersWithDescriptions}}\n\nThese are the actions or data provider calls that have already been used in this run. Use this to avoid redundancy and guide your next move.\n\n{{actionResults}}\n\n<keys>\n\"thought\" Clearly explain your reasoning for the selected providers and/or action, and how this step contributes to resolving the user's request.\n\"action\"  Name of the action to execute after providers return (can be empty if no action is needed).\n\"providers\" List of provider names to call in this step (can be empty if none are needed).\n\"isFinish\" Set to true only if the task is fully complete.\n</keys>\n\n\u26A0\uFE0F IMPORTANT: Do **not** mark the task as `isFinish: true` immediately after calling an action. Wait for the action to complete before deciding the task is finished.\n\n<output>\n<response>\n  <thought>Your thought here</thought>\n  <action>ACTION</action>\n  <providers>PROVIDER1,PROVIDER2</providers>\n  <isFinish>true | false</isFinish>\n</response>\n</output>";
+export declare const multiStepDecisionTemplate = "<task>\nDetermine the next step the assistant should take in this conversation to help the user reach their goal.\n</task>\n\n{{recentMessages}}\n\n# Multi-Step Workflow\n\nIn each step, decide:\n\n1. **Which providers (if any)** should be called to gather necessary data.\n2. **Which action (if any)** should be executed after providers return.\n3. **What parameters** the action requires (if any).\n4. Decide whether the task is complete. If so, set `isFinish: true`. Do not select the `REPLY` action; replies are handled separately after task completion.\n\nYou can select **multiple providers** and at most **one action** per step.\n\nIf the task is fully resolved and no further steps are needed, mark the step as `isFinish: true`.\n\n---\n\n{{actionsWithParams}}\n\n{{providersWithDescriptions}}\n\nThese are the actions or data provider calls that have already been used in this run. Use this to avoid redundancy and guide your next move.\n\n{{actionResults}}\n\n<keys>\n\"thought\" Clearly explain your reasoning for the selected providers and/or action, and how this step contributes to resolving the user's request.\n\"action\" Name of the action to execute after providers return. Omit or use empty string \"\" if isFinish: true or no action needed.\n\"parameters\" JSON object with exact parameter names and values for the action. Use empty object {} if no parameters are needed.\n\"providers\" List of provider names to call in this step (can be empty if none are needed).\n\"isFinish\" Set to true only if the task is fully complete.\n</keys>\n\n\u26A0\uFE0F IMPORTANT: Do **not** mark the task as `isFinish: true` immediately after calling an action. Wait for the action to complete before deciding the task is finished.\n\n<output>\n<response>\n  <thought>Your thought here</thought>\n  <action>ACTION_NAME or \"\"</action>\n  <parameters>\n    {\n      \"param1\": \"value1\",\n      \"param2\": \"value2\"\n    }\n  </parameters>\n  <providers>PROVIDER1,PROVIDER2</providers>\n  <isFinish>true | false</isFinish>\n</response>\n</output>";
 export declare const multiStepSummaryTemplate = "<task>\nSummarize what the assistant has done so far and provide a final response to the user based on the completed steps.\n</task>\n\n# Context Information\n{{bio}}\n\n---\n\n{{system}}\n\n---\n\n{{messageDirections}}\n\n# Conversation Summary\nBelow is the user\u2019s original request and conversation so far:\n{{recentMessages}}\n\n# Execution Trace\nHere are the actions taken by the assistant to fulfill the request:\n{{actionResults}}\n\n# Assistant\u2019s Last Reasoning Step\n{{recentMessage}}\n\n# Instructions\n\n - Review the execution trace and last reasoning step carefully\n\n - Your final output MUST be in this XML format:\n<output>\n<response>\n  <thought>Your thought here</thought>\n  <text>Your final message to the user</text>\n</response>\n</output>\n";
 //# sourceMappingURL=prompts.d.ts.map

package/dist/core/src/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../core/src/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,49CAgCxB,CAAC;AAEX,eAAO,MAAM,sBAAsB,o+HA2DzB,CAAC;AAEX,eAAO,MAAM,oBAAoB,wwFA4C+M,CAAC;AAEjP,eAAO,MAAM,aAAa,qCAAqC,CAAC;AAEhE,eAAO,MAAM,wBAAwB,y8CAuB3B,CAAC;AAEX,eAAO,MAAM,yBAAyB,isDA4C5B,CAAC;AAEX,eAAO,MAAM,wBAAwB,4wBAqCpC,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../core/src/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,49CAgCxB,CAAC;AAEX,eAAO,MAAM,sBAAsB,o+HA2DzB,CAAC;AAEX,eAAO,MAAM,oBAAoB,wwFA4C+M,CAAC;AAEjP,eAAO,MAAM,aAAa,qCAAqC,CAAC;AAEhE,eAAO,MAAM,wBAAwB,y8CAuB3B,CAAC;AAEX,eAAO,MAAM,yBAAyB,2gEAoD5B,CAAC;AAEX,eAAO,MAAM,wBAAwB,4wBAqCpC,CAAC"}

package/dist/core/src/services/default-message-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-message-service.d.ts","sourceRoot":"","sources":["../../../../../core/src/services/default-message-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAW,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAqF3B;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC;IAkHnC;;OAEG;YACW,cAAc;IAmc5B;;;OAGG;IACH,aAAa,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC9B,gBAAgB;IAyEnB;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA+IxF;;OAEG;YACW,iBAAiB;IAyJ/B;;OAEG;YACW,gBAAgB;IAgU9B;;OAEG;YACW,YAAY;IAqB1B;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3E;;;;;;;;OAQG;IACG,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoD3F"}
+{"version":3,"file":"default-message-service.d.ts","sourceRoot":"","sources":["../../../../../core/src/services/default-message-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAW,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAyF3B;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAC3D;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,eAAe,EAC1B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,uBAAuB,CAAC;IA+GnC;;OAEG;YACW,cAAc;IAmc5B;;;OAGG;IACH,aAAa,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,IAAI,EACX,cAAc,CAAC,EAAE,cAAc,GAC9B,gBAAgB;IAyEnB;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IA+IxF;;OAEG;YACW,iBAAiB;IAkR/B;;OAEG;YACW,gBAAgB;IAovB9B;;OAEG;YACW,YAAY;IAqB1B;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC3E;;;;;;;;OAQG;IACG,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAoD3F"}

package/dist/core/src/streaming-context.d.ts

@@ -6,7 +6,6 @@
  * - Platform-specific implementations (Node.js AsyncLocalStorage, Browser Stack)
  * - Global singleton configured at startup
  *
- * @see https://opentelemetry.io/docs/languages/js/context/
  */
 import type { UUID } from './types';
 /**
@@ -20,6 +19,24 @@ export interface StreamingContext {
     messageId?: UUID;
     /** Optional abort signal to cancel streaming */
     abortSignal?: AbortSignal;
+    /**
+     * Reset streaming state for retry attempts.
+     * Clears extractor buffer and any accumulated state.
+     * Call before retrying a failed streaming operation.
+     */
+    reset?: () => void;
+    /**
+     * Get text that has been streamed to the user so far.
+     * Useful for retry continuation prompts.
+     */
+    getStreamedText?: () => string;
+    /**
+     * Check if text extraction is complete (closing tag found).
+     * Used for intelligent retry decisions:
+     * - true: Use streamedText as final response, skip retry
+     * - false: Text was cut mid-stream, retry with continuation prompt
+     */
+    isComplete?: () => boolean;
 }
 /**
  * Interface for streaming context managers.

package/dist/core/src/streaming-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming-context.d.ts","sourceRoot":"","sources":["../../../../core/src/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,gDAAgD;IAChD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE9D;;;OAGG;IACH,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAAC;CACxC;AAmBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAElF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,wBAAwB,CAErE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE"}
+{"version":3,"file":"streaming-context.d.ts","sourceRoot":"","sources":["../../../../core/src/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,gDAAgD;IAChD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAE9D;;;OAGG;IACH,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAAC;CACxC;AAmBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAElF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,wBAAwB,CAErE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAElE"}

package/dist/core/src/types/streaming.d.ts

@@ -42,5 +42,31 @@ export interface IStreamExtractor {
      * @returns Text to stream to client (empty string = nothing to stream yet)
      */
     push(chunk: string): string;
+    /**
+     * Reset extractor state for retry or reuse.
+     * Clears buffer, resets done flag, and any internal state.
+     */
+    reset(): void;
+    /**
+     * Flush any buffered content that hasn't been returned yet.
+     * Called when stream ends unexpectedly to recover partial content.
+     * Optional - extractors that don't buffer can omit this.
+     * @returns Remaining buffered content (empty string if none)
+     */
+    flush?(): string;
+}
+/**
+ * Tracks extractor state for intelligent retry decisions.
+ * Enables:
+ * - Skip retry when text extraction is complete (isComplete)
+ * - Continuation prompts when text is cut mid-stream
+ */
+export interface IStreamingRetryState {
+    /** Text that has been streamed to the user */
+    getStreamedText: () => string;
+    /** Whether the extractor found the closing tag (text is complete) */
+    isComplete: () => boolean;
+    /** Reset extractor for fresh streaming on continuation */
+    reset: () => void;
 }
 //# sourceMappingURL=streaming.d.ts.map

package/dist/core/src/types/streaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5B;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;OAKG;IACH,KAAK,CAAC,IAAI,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,qEAAqE;IACrE,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB"}

package/dist/core/src/utils/streaming.d.ts

@@ -10,8 +10,10 @@
  * For the interface definition, see types/streaming.ts.
  * Implementations can use these or create their own extractors.
  */
-import type { IStreamExtractor } from '../types/streaming';
-export type { IStreamExtractor } from '../types/streaming';
+import type { IStreamExtractor, IStreamingRetryState } from '../types/streaming';
+import type { StreamingContext } from '../streaming-context';
+import type { UUID } from '../types';
+export type { IStreamExtractor, IStreamingRetryState } from '../types/streaming';
 /** Error codes for streaming operations */
 export type StreamErrorCode = 'CHUNK_TOO_LARGE' | 'BUFFER_OVERFLOW' | 'PARSE_ERROR' | 'TIMEOUT' | 'ABORTED';
 /**
@@ -25,6 +27,55 @@ export declare class StreamError extends Error {
     /** Check if an error is a StreamError */
     static isStreamError(error: unknown): error is StreamError;
 }
+/**
+ * Creates a streaming retry state from an extractor.
+ * Use this to track streaming state for intelligent retry logic.
+ *
+ * @example
+ * ```ts
+ * const extractor = new ResponseStreamExtractor();
+ * const retryState = createStreamingRetryState(extractor);
+ *
+ * // After streaming fails...
+ * if (retryState.isComplete()) {
+ *   // Text extraction finished - use streamedText, no retry needed
+ *   return retryState.getStreamedText();
+ * } else {
+ *   // Text was cut - retry with continuation prompt
+ *   retryState.reset();
+ *   // ... retry with: "You started: '${streamedText}', continue..."
+ * }
+ * ```
+ */
+export declare function createStreamingRetryState(extractor: IStreamExtractor): IStreamingRetryState & {
+    _appendText: (text: string) => void;
+};
+/**
+ * Creates a complete streaming context with retry state management.
+ * Use this to avoid duplicating streaming context creation logic.
+ *
+ * @param extractor - The stream extractor to use (e.g., ResponseStreamExtractor, XmlTagExtractor)
+ * @param onStreamChunk - Callback to send chunks to the client
+ * @param messageId - Optional message ID for the streaming context
+ * @returns A complete StreamingContext with retry state methods
+ *
+ * @example
+ * ```ts
+ * const ctx = createStreamingContext(
+ *   new ResponseStreamExtractor(),
+ *   async (chunk) => res.write(chunk),
+ *   responseId
+ * );
+ *
+ * await runWithStreamingContext(ctx, () => runtime.useModel(...));
+ *
+ * // After streaming, check retry state
+ * if (ctx.isComplete()) {
+ *   return ctx.getStreamedText();
+ * }
+ * ```
+ */
+export declare function createStreamingContext(extractor: IStreamExtractor, onStreamChunk: (chunk: string, messageId?: UUID) => Promise<void>, messageId?: UUID): StreamingContext;
 /**
  * Streams all content as-is without any filtering.
  * Use when LLM output is already in the desired format (e.g., plain text responses).
@@ -55,6 +106,10 @@ export declare class XmlTagExtractor implements IStreamExtractor {
     get done(): boolean;
     push(chunk: string): string;
     reset(): void;
+    /**
+     * Flush remaining buffered content when stream ends unexpectedly.
+     */
+    flush(): string;
 }
 /**
  * Extracts streamable text from XML-structured LLM responses with action-based routing.
@@ -78,8 +133,13 @@ export declare class ResponseStreamExtractor implements IStreamExtractor {
     private responseStrategy;
     get done(): boolean;
     reset(): void;
+    /**
+     * Flush remaining buffered content when stream ends unexpectedly.
+     * Returns content that was held back due to SAFE_MARGIN.
+     */
+    flush(): string;
     push(chunk: string): string;
-    /** Detect response strategy from <actions> tag using pre-compiled regex */
+    /** Detect response strategy from <actions> tag using indexOf (ReDoS-safe) */
     private detectResponseStrategy;
     /** Parse comma-separated actions */
     private parseActions;
@@ -105,6 +165,10 @@ export declare class ActionStreamFilter implements IStreamExtractor {
     private finished;
     get done(): boolean;
     reset(): void;
+    /**
+     * Flush remaining buffered content when stream ends unexpectedly.
+     */
+    flush(): string;
     push(chunk: string): string;
     /** Detect content type from first non-whitespace character */
     private detectContentType;

package/dist/core/src/utils/streaming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../../../core/src/utils/streaming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAM3D,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,iBAAiB,GACjB,aAAa,GACb,SAAS,GACT,SAAS,CAAC;AAEd;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAOrF,yCAAyC;IACzC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW;CAG3D;AAiHD;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAK3B,KAAK,IAAI,IAAI;CAGd;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,MAAM;IAK3B,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA6B3B,KAAK,IAAI,IAAI;CAKd;AASD;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAqB;IAExD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAA+B;IAEvD,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,KAAK,IAAI,IAAI;IAQb,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAiE3B,2EAA2E;IAC3E,OAAO,CAAC,sBAAsB;IAQ9B,oCAAoC;IACpC,OAAO,CAAC,YAAY;IAOpB,gDAAgD;IAChD,OAAO,CAAC,aAAa;IAIrB,8DAA8D;IAC9D,OAAO,CAAC,eAAe;CAGxB;AASD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,KAAK,IAAI,IAAI;IAQb,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA+B3B,8DAA8D;IAC9D,OAAO,CAAC,iBAAiB;IAUzB,4CAA4C;IAC5C,OAAO,CAAC,eAAe;IAMvB,iEAAiE;IACjE,OAAO,CAAC,SAAS;CAuBlB"}
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../../../../core/src/utils/streaming.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/api-client",
-  "version": "1.7.1",
+  "version": "1.7.2-alpha.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "dist/index.js",
@@ -16,10 +16,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@elizaos/core": "1.7.1"
+    "@elizaos/core": "1.7.2-alpha.2"
   },
   "devDependencies": {
-    "@elizaos/config": "1.7.1",
+    "@elizaos/config": "1.7.2-alpha.2",
     "@types/bun": "^1.3.3",
     "@types/node": "^24.10.1",
     "eslint": "^9.36.0",
@@ -31,5 +31,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "70bb519f171f4281aadaa9c0e44c35cd685f3f3d"
+  "gitHead": "4ae04ebedf8dd4f7754de2eb94272f68104c20f0"
 }