@mastra/react 1.0.0-beta.25 → 1.0.3-alpha.0

package/LICENSE.md

@@ -1,3 +1,18 @@
+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:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `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/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,GAAI,UAAU,eAAe,EAAE,KAAG,MAAM,GAAG,SAY/E,CAAC"}

package/dist/agent/hooks.d.ts

@@ -0,0 +1,91 @@
+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[];
+    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[];
+    approveToolCall: (toolCallId: string) => 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":"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"}

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

@@ -0,0 +1,2 @@
+export declare function convertSignalDataToBase64String(content: string | ArrayBuffer | Uint8Array): 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,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAYlG"}

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"}