@mastra/react 0.0.0-key-fix-20260227010020 → 0.0.0-knowledge-org-scope-20260902233451

package/LICENSE.md

@@ -1,3 +1,20 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named `ee/` within this
+  repository, including but not limited to:
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
 # Apache License 2.0
 
 Copyright (c) 2025 Kepler Software, Inc.

package/README.md

@@ -0,0 +1,37 @@
+# @mastra/react
+
+`@mastra/react` provides React context, hooks, message utilities, voice helpers, and UI primitives for applications that connect to a Mastra server. Wrap the application once with `MastraReactProvider`, then access the configured client throughout the component tree.
+
+## Installation
+
+```bash
+npm install @mastra/react
+```
+
+## Usage
+
+```tsx
+import { MastraReactProvider } from '@mastra/react';
+
+export function App({ children }: { children: React.ReactNode }) {
+  return <MastraReactProvider baseUrl="http://localhost:4111">{children}</MastraReactProvider>;
+}
+```
+
+## Documentation
+
+`MastraReactProvider` constructs and shares the Mastra client. In addition to `baseUrl`, it accepts custom headers, an API prefix, fetch credentials, and a custom `fetch` implementation for applications that need authentication or request instrumentation. Use `useMastraClient()` when a component needs direct access to the underlying client.
+
+The package exports agent hooks such as `useChat` for generated or streamed conversations, including optimistic messages, tool calls, approvals, task signals, aborts, and reconnection to active runs. It also exports workflow hooks and `WorkflowStepFactory` for consuming workflow state and streamed step results.
+
+Voice helpers include browser speech recognition, microphone recording, and Web Audio playback. Message utilities expose Mastra's database message types and accumulation helpers, while the `@mastra/react/ui` entry point provides reusable message, code, icon, button, entity, and tooltip components. Import `@mastra/react/styles.css` when using the packaged UI components.
+
+React 19 or newer is required. The package also expects compatible versions of `@mastra/core` and Zod in the consuming application.
+
+## Changelog
+
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/client-sdks/react/CHANGELOG.md) for version history and release notes.
+
+## Support
+
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/dist/agent/extract-tasks.d.ts

@@ -0,0 +1,10 @@
+import type { MastraDBMessage } from '@mastra/core/agent/message-list';
+import type { TaskItem } from '@mastra/core/signals';
+import type { ChunkType } from '@mastra/core/stream';
+export declare const TASK_TOOL_NAMES: Set<string>;
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+export declare const isTaskItemArray: (value: unknown) => value is TaskItem[];
+export declare const extractTasksFromSignalChunk: (chunk: ChunkType) => TaskItem[] | undefined;
+export declare const extractTasksFromToolResultChunk: (chunk: ChunkType) => TaskItem[] | undefined;
+export declare const extractLatestTasksFromMessages: (messages: MastraDBMessage[]) => TaskItem[];
+//# sourceMappingURL=extract-tasks.d.ts.map

package/dist/agent/extract-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-tasks.d.ts","sourceRoot":"","sources":["../../src/agent/extract-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,qBAAqB,CAAC;AAEpE,eAAO,MAAM,eAAe,aAAwE,CAAC;AAUrG,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAC;AAKvE,eAAO,MAAM,eAAe,UAAW,OAAO,KAAG,KAAK,IAAI,QAAQ,EAS/D,CAAC;AA6BJ,eAAO,MAAM,2BAA2B,UAAW,SAAS,KAAG,QAAQ,EAAE,GAAG,SAG3E,CAAC;AAEF,eAAO,MAAM,+BAA+B,UAAW,SAAS,KAAG,QAAQ,EAAE,GAAG,SAO/E,CAAC;AAqBF,eAAO,MAAM,8BAA8B,aAAc,eAAe,EAAE,KAAG,QAAQ,EAmBpF,CAAC"}

package/dist/agent/extractRunIdFromMessages.d.ts

@@ -0,0 +1,10 @@
+import type { MastraDBMessage } from '@mastra/core/agent/message-list';
+/**
+ * Scan initial DB-shape messages for any pending approvals, suspended tools, or
+ * `requireApprovalMetadata` entries and return the first non-empty `runId`.
+ *
+ * Metadata is read off `message.content.metadata`, the canonical location for
+ * MastraDBMessage UX hints.
+ */
+export declare const extractRunIdFromMessages: (messages: MastraDBMessage[]) => string | undefined;
+//# sourceMappingURL=extractRunIdFromMessages.d.ts.map

package/dist/agent/extractRunIdFromMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractRunIdFromMessages.d.ts","sourceRoot":"","sources":["../../src/agent/extractRunIdFromMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAyBvE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,aAAc,eAAe,EAAE,KAAG,MAAM,GAAG,SAY/E,CAAC"}

package/dist/agent/hooks.d.ts

@@ -0,0 +1,98 @@
+import type { MastraDBMessage } from '@mastra/core/agent/message-list';
+import type { CoreUserMessage } from '@mastra/core/llm';
+import type { TracingOptions } from '@mastra/core/observability';
+import type { RequestContext } from '@mastra/core/request-context';
+import type { ChunkType, NetworkChunkType } from '@mastra/core/stream';
+import type { ClientToolsInput, ModelSettings } from './types.js';
+export interface MastraChatProps {
+    agentId: string;
+    resourceId?: string;
+    threadId?: string;
+    initialMessages?: MastraDBMessage[];
+    /** Persistent request context used for tool approval/decline calls (e.g. agentVersionId). */
+    requestContext?: RequestContext;
+    /**
+     * Client-side tool definitions. Forwarded once to `subscribeToThread` so
+     * the client-js subscription drives the full client-tool execution loop
+     * (execute, emit tool-result, continuation) without any logic in React.
+     */
+    clientTools?: ClientToolsInput;
+    onSignalSent?: (signalId: string, preview: string) => void;
+    onSignalEcho?: (signalId: string) => void;
+    onThreadSignalsUnsupported?: () => void;
+    /**
+     * Use the agent-signals streaming path (sendSignal + subscribeToThread).
+     * Defaults to `false`; set to `true` to opt into thread signals.
+     */
+    enableThreadSignals?: boolean;
+}
+interface SharedArgs {
+    coreUserMessages: CoreUserMessage[];
+    model?: string;
+    requestContext?: RequestContext;
+    threadId?: string;
+    modelSettings?: ModelSettings;
+    signal?: AbortSignal;
+    tracingOptions?: TracingOptions;
+}
+export type SendMessageArgs = {
+    message: string;
+    coreUserMessages?: CoreUserMessage[];
+} & (({
+    mode: 'generate';
+} & Omit<GenerateArgs, 'coreUserMessages'>) | ({
+    mode: 'stream';
+} & Omit<StreamArgs, 'coreUserMessages'>) | ({
+    mode: 'network';
+} & Omit<NetworkArgs, 'coreUserMessages'>) | ({
+    mode?: undefined;
+} & Omit<StreamArgs, 'coreUserMessages'>));
+export type GenerateArgs = SharedArgs & {
+    onFinish?: (messages: MastraDBMessage[]) => Promise<void>;
+    clientTools?: ClientToolsInput;
+};
+export type StreamArgs = SharedArgs & {
+    onChunk?: (chunk: ChunkType) => Promise<void>;
+    clientTools?: ClientToolsInput;
+    signalId?: string;
+    /**
+     * Client-generated correlation id stamped on the optimistic pending bubble
+     * and the outgoing message metadata so the server echo can reconcile them.
+     */
+    clientMessageId?: string;
+};
+export type NetworkArgs = SharedArgs & {
+    onNetworkChunk?: (chunk: NetworkChunkType) => Promise<void>;
+};
+export declare const useChat: ({ agentId, resourceId, threadId, initialMessages, requestContext: propsRequestContext, clientTools: hookClientTools, onSignalSent, onSignalEcho, onThreadSignalsUnsupported, enableThreadSignals, }: MastraChatProps) => {
+    setMessages: import("react").Dispatch<import("react").SetStateAction<MastraDBMessage[]>>;
+    sendMessage: ({ mode, ...args }: SendMessageArgs) => Promise<void>;
+    isRunning: boolean;
+    isAwaitingToolApproval: boolean;
+    messages: MastraDBMessage[];
+    tasks: {
+        content: string;
+        status: "completed" | "in_progress" | "pending";
+        activeForm: string;
+        id: string;
+    }[];
+    approveToolCall: (toolCallId: string, resumeData?: unknown) => Promise<void>;
+    declineToolCall: (toolCallId: string) => Promise<void>;
+    approveToolCallGenerate: (toolCallId: string) => Promise<void>;
+    declineToolCallGenerate: (toolCallId: string) => Promise<void>;
+    cancelRun: () => void;
+    toolCallApprovals: {
+        [toolCallId: string]: {
+            status: 'approved' | 'declined';
+        };
+    };
+    approveNetworkToolCall: (toolName: string, runId?: string) => Promise<void>;
+    declineNetworkToolCall: (toolName: string, runId?: string) => Promise<void>;
+    networkToolCallApprovals: {
+        [toolName: string]: {
+            status: 'approved' | 'declined';
+        };
+    };
+};
+export {};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/agent/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/agent/hooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,eAAe,EAA4B,MAAM,iCAAiC,CAAC;AAE3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAiB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAkBtF,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAyI/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC;IACpC,6FAA6F;IAC7F,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,0BAA0B,CAAC,EAAE,MAAM,IAAI,CAAC;IACxC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,UAAU;IAClB,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;CAAE,GAAG,CACtF,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC,GAC/D,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,GAC3D,CAAC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC,GAC7D,CAAC;IAAE,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAChE,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG;IACtC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG;IACrC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC;AAoDF,eAAO,MAAM,OAAO,wMAWjB,eAAe;;qCA63ByC,eAAe;;;;;;;;;;kCA/O7B,MAAM,eAAe,OAAO;kCAqE5B,MAAM;0CAkDE,MAAM;0CA2BN,MAAM;;;;oBAzwBvB,UAAU,GAAG,UAAU;;;uCAoyBT,MAAM,UAAU,MAAM;uCAiCtB,MAAM,UAAU,MAAM;;;oBAl0BtC,UAAU,GAAG,UAAU;;;CAu6BxD,CAAC"}

package/dist/agent/signal-data.d.ts

@@ -0,0 +1,5 @@
+export declare const uint8ArrayToBase64: (bytes: Uint8Array) => string;
+export declare function convertSignalDataToBase64String(content: string | ArrayBuffer | Uint8Array): string;
+/** Canonical DB `file` part `data` for optimistic UI and memory-shaped storage. */
+export declare function encodeFilePartDataForStorage(data: string | URL | ArrayBuffer | Uint8Array, mimeType: string): string;
+//# sourceMappingURL=signal-data.d.ts.map

package/dist/agent/signal-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-data.d.ts","sourceRoot":"","sources":["../../src/agent/signal-data.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,UAAW,UAAU,KAAG,MAOtD,CAAC;AAEF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAOlG;AAED,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,WAAW,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBpH"}

package/dist/{src/agent → agent}/types.d.ts

@@ -1,3 +1,7 @@
+import type { GenerateLegacyParams } from '@mastra/client-js';
+import type { ToolsInput } from '@mastra/core/agent';
+export type ClientToolsInput = ToolsInput;
+export type ProviderOptionsInput = GenerateLegacyParams['providerOptions'];
 export interface ModelSettings {
     frequencyPenalty?: number;
     presencePenalty?: number;
@@ -8,9 +12,10 @@ export interface ModelSettings {
     topK?: number;
     topP?: number;
     instructions?: string;
-    providerOptions?: Record<string, unknown>;
+    providerOptions?: ProviderOptionsInput;
     chatWithGenerate?: boolean;
     chatWithStream?: boolean;
     chatWithNetwork?: boolean;
     requireToolApproval?: boolean;
 }
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAC1C,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}