@mastra/inngest 1.2.2 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,229 @@
 # @mastra/inngest
 
+## 1.3.0
+
+### Minor Changes
+
+- Add durable agents with resumable streams ([#12557](https://github.com/mastra-ai/mastra/pull/12557))
+
+  Durable agents make agent execution resilient to disconnections, crashes, and long-running operations.
+
+  ### The Problem
+
+  Standard agent streaming has two fragility points:
+  1. **Connection drops** - If a client disconnects mid-stream (network blip, browser refresh, mobile app backgrounded), all subsequent events are lost. The client has no way to "catch up" on what they missed.
+  2. **Long-running operations** - Agent loops with tool calls can take minutes. Holding an HTTP connection open that long is unreliable. If the server restarts or the connection times out, the work is lost.
+
+  ### The Solution
+
+  **Resumable streams** solve connection drops. Every event is cached with a sequential index. If a client disconnects at event 5, they can reconnect and request events starting from index 6. They receive cached events immediately, then continue with live events as they arrive.
+
+  **Durable execution** solves long-running operations. Instead of executing the agent loop directly in the HTTP request, execution happens in a workflow engine (built-in evented engine or Inngest). The HTTP request just subscribes to events. If the connection drops, execution continues. The client can reconnect anytime to observe progress.
+
+  ### Usage
+
+  Wrap any existing `Agent` with durability using factory functions:
+
+  ```typescript
+  import { Agent } from '@mastra/core/agent';
+  import { createDurableAgent } from '@mastra/core/agent/durable';
+
+  const agent = new Agent({
+    id: 'my-agent',
+    model: openai('gpt-4'),
+    instructions: 'You are helpful',
+  });
+
+  const durableAgent = createDurableAgent({ agent });
+  ```
+
+  **Factory functions for different execution strategies:**
+
+  | Factory                                  | Execution                           | Use Case                        |
+  | ---------------------------------------- | ----------------------------------- | ------------------------------- |
+  | `createDurableAgent({ agent })`          | Local, synchronous                  | Development, simple deployments |
+  | `createEventedAgent({ agent })`          | Fire-and-forget via workflow engine | Long-running operations         |
+  | `createInngestAgent({ agent, inngest })` | Inngest-powered                     | Production, distributed systems |
+
+  ### Resumable Streams
+
+  ```typescript
+  // Start streaming
+  const { runId, output } = await durableAgent.stream('Analyze this data...');
+
+  // Client disconnects at event 5...
+
+  // Reconnect and resume from where we left off
+  const { output: resumed } = await durableAgent.observe(runId, { offset: 6 });
+  // Receives events 6, 7, 8... from cache, then continues with live events
+  ```
+
+  ### PubSub and Cache
+
+  Durable agents use two infrastructure components:
+
+  | Component  | Purpose                                   | Default               |
+  | ---------- | ----------------------------------------- | --------------------- |
+  | **PubSub** | Real-time event delivery during streaming | `EventEmitterPubSub`  |
+  | **Cache**  | Stores events for replay on reconnection  | `InMemoryServerCache` |
+
+  When `stream()` is called, events flow through pubsub in real-time. The cache stores each event with a sequential index. When `observe()` is called, missed events replay from cache before continuing with live events.
+
+  **Configure via Mastra instance (recommended):**
+
+  ```typescript
+  const mastra = new Mastra({
+    cache: new RedisServerCache({ url: 'redis://...' }),
+    pubsub: new RedisPubSub({ url: 'redis://...' }),
+    agents: {
+      // Inherits cache and pubsub from Mastra
+      myAgent: createDurableAgent({ agent }),
+    },
+  });
+  ```
+
+  **Configure per-agent (overrides Mastra):**
+
+  ```typescript
+  const durableAgent = createDurableAgent({
+    agent,
+    cache: new RedisServerCache({ url: 'redis://...' }),
+    pubsub: new RedisPubSub({ url: 'redis://...' }),
+  });
+  ```
+
+  **Disable caching (streams won't be resumable):**
+
+  ```typescript
+  const durableAgent = createDurableAgent({ agent, cache: false });
+  ```
+
+  For single-instance deployments, the defaults work fine. For multi-instance deployments (load balancer, horizontal scaling), use Redis-backed implementations so any instance can serve reconnection requests.
+
+  ### Class Hierarchy
+  - `DurableAgent` extends `Agent` - base class with resumable streams
+  - `EventedAgent` extends `DurableAgent` - fire-and-forget execution
+  - `InngestAgent` extends `DurableAgent` - Inngest-powered execution
+
+- Update peer dependencies to match core package version bump (1.0.5) ([#12557](https://github.com/mastra-ai/mastra/pull/12557))
+
+### Patch Changes
+
+- Updated dependencies [[`920c757`](https://github.com/mastra-ai/mastra/commit/920c75799c6bd71787d86deaf654a35af4c839ca), [`d587199`](https://github.com/mastra-ai/mastra/commit/d5871993c0371bde2b0717d6b47194755baa1443), [`1fe2533`](https://github.com/mastra-ai/mastra/commit/1fe2533c4382ca6858aac7c4b63e888c2eac6541), [`f8694b6`](https://github.com/mastra-ai/mastra/commit/f8694b6fa0b7a5cde71d794c3bbef4957c55bcb8)]:
+  - @mastra/core@1.30.0
+
+## 1.3.0-alpha.0
+
+### Minor Changes
+
+- Add durable agents with resumable streams ([#12557](https://github.com/mastra-ai/mastra/pull/12557))
+
+  Durable agents make agent execution resilient to disconnections, crashes, and long-running operations.
+
+  ### The Problem
+
+  Standard agent streaming has two fragility points:
+  1. **Connection drops** - If a client disconnects mid-stream (network blip, browser refresh, mobile app backgrounded), all subsequent events are lost. The client has no way to "catch up" on what they missed.
+  2. **Long-running operations** - Agent loops with tool calls can take minutes. Holding an HTTP connection open that long is unreliable. If the server restarts or the connection times out, the work is lost.
+
+  ### The Solution
+
+  **Resumable streams** solve connection drops. Every event is cached with a sequential index. If a client disconnects at event 5, they can reconnect and request events starting from index 6. They receive cached events immediately, then continue with live events as they arrive.
+
+  **Durable execution** solves long-running operations. Instead of executing the agent loop directly in the HTTP request, execution happens in a workflow engine (built-in evented engine or Inngest). The HTTP request just subscribes to events. If the connection drops, execution continues. The client can reconnect anytime to observe progress.
+
+  ### Usage
+
+  Wrap any existing `Agent` with durability using factory functions:
+
+  ```typescript
+  import { Agent } from '@mastra/core/agent';
+  import { createDurableAgent } from '@mastra/core/agent/durable';
+
+  const agent = new Agent({
+    id: 'my-agent',
+    model: openai('gpt-4'),
+    instructions: 'You are helpful',
+  });
+
+  const durableAgent = createDurableAgent({ agent });
+  ```
+
+  **Factory functions for different execution strategies:**
+
+  | Factory                                  | Execution                           | Use Case                        |
+  | ---------------------------------------- | ----------------------------------- | ------------------------------- |
+  | `createDurableAgent({ agent })`          | Local, synchronous                  | Development, simple deployments |
+  | `createEventedAgent({ agent })`          | Fire-and-forget via workflow engine | Long-running operations         |
+  | `createInngestAgent({ agent, inngest })` | Inngest-powered                     | Production, distributed systems |
+
+  ### Resumable Streams
+
+  ```typescript
+  // Start streaming
+  const { runId, output } = await durableAgent.stream('Analyze this data...');
+
+  // Client disconnects at event 5...
+
+  // Reconnect and resume from where we left off
+  const { output: resumed } = await durableAgent.observe(runId, { offset: 6 });
+  // Receives events 6, 7, 8... from cache, then continues with live events
+  ```
+
+  ### PubSub and Cache
+
+  Durable agents use two infrastructure components:
+
+  | Component  | Purpose                                   | Default               |
+  | ---------- | ----------------------------------------- | --------------------- |
+  | **PubSub** | Real-time event delivery during streaming | `EventEmitterPubSub`  |
+  | **Cache**  | Stores events for replay on reconnection  | `InMemoryServerCache` |
+
+  When `stream()` is called, events flow through pubsub in real-time. The cache stores each event with a sequential index. When `observe()` is called, missed events replay from cache before continuing with live events.
+
+  **Configure via Mastra instance (recommended):**
+
+  ```typescript
+  const mastra = new Mastra({
+    cache: new RedisServerCache({ url: 'redis://...' }),
+    pubsub: new RedisPubSub({ url: 'redis://...' }),
+    agents: {
+      // Inherits cache and pubsub from Mastra
+      myAgent: createDurableAgent({ agent }),
+    },
+  });
+  ```
+
+  **Configure per-agent (overrides Mastra):**
+
+  ```typescript
+  const durableAgent = createDurableAgent({
+    agent,
+    cache: new RedisServerCache({ url: 'redis://...' }),
+    pubsub: new RedisPubSub({ url: 'redis://...' }),
+  });
+  ```
+
+  **Disable caching (streams won't be resumable):**
+
+  ```typescript
+  const durableAgent = createDurableAgent({ agent, cache: false });
+  ```
+
+  For single-instance deployments, the defaults work fine. For multi-instance deployments (load balancer, horizontal scaling), use Redis-backed implementations so any instance can serve reconnection requests.
+
+  ### Class Hierarchy
+  - `DurableAgent` extends `Agent` - base class with resumable streams
+  - `EventedAgent` extends `DurableAgent` - fire-and-forget execution
+  - `InngestAgent` extends `DurableAgent` - Inngest-powered execution
+
+- Update peer dependencies to match core package version bump (1.0.5) ([#12557](https://github.com/mastra-ai/mastra/pull/12557))
+
+### Patch Changes
+
+- Updated dependencies [[`920c757`](https://github.com/mastra-ai/mastra/commit/920c75799c6bd71787d86deaf654a35af4c839ca), [`1fe2533`](https://github.com/mastra-ai/mastra/commit/1fe2533c4382ca6858aac7c4b63e888c2eac6541), [`f8694b6`](https://github.com/mastra-ai/mastra/commit/f8694b6fa0b7a5cde71d794c3bbef4957c55bcb8)]:
+  - @mastra/core@1.30.0-alpha.1
+
 ## 1.2.2
 
 ### Patch Changes

package/dist/__tests__/adapters/_utils.d.ts

@@ -1,8 +1,8 @@
 import { Mastra } from '@mastra/core/mastra';
 import { Inngest } from 'inngest';
 import type { InngestWorkflow } from '../../workflow.js';
-export declare const INNGEST_PORT = 4000;
-export declare const HANDLER_PORT = 4001;
+export declare const INNGEST_PORT = 4100;
+export declare const HANDLER_PORT = 4101;
 export declare function createTestInngest(id: string): Inngest<{
     id: string;
     baseUrl: string;

package/dist/__tests__/durable-agent.test.utils.d.ts

@@ -0,0 +1,43 @@
+import { Mastra } from '@mastra/core/mastra';
+import { Inngest } from 'inngest';
+export declare const INNGEST_PORT = 4100;
+export declare const HANDLER_PORT = 4101;
+/**
+ * Generate unique test ID to isolate each test.
+ * Uses a short UUID for readability in logs.
+ */
+export declare function generateTestId(): string;
+/**
+ * Get the shared Inngest client.
+ * All tests use the same Inngest client since workflow state is isolated by runId/agentId.
+ */
+export declare function getSharedInngest(): Inngest;
+/**
+ * Get the shared Mastra instance.
+ * @throws Error if called before setupSharedTestInfrastructure()
+ */
+export declare function getSharedMastra(): Mastra;
+/**
+ * Wait for Inngest to sync with the app.
+ */
+export declare function waitForInngestSync(ms?: number): Promise<void>;
+/**
+ * Initialize shared test infrastructure.
+ * Call this once in beforeAll for the test suite.
+ *
+ * This starts the Inngest dev server using npx (no Docker required).
+ */
+export declare function setupSharedTestInfrastructure(): Promise<void>;
+/**
+ * Teardown shared test infrastructure.
+ * Call this once in afterAll for the test suite.
+ */
+export declare function teardownSharedTestInfrastructure(): Promise<void>;
+/**
+ * Test setup result containing everything needed to run a test.
+ */
+export interface TestSetup {
+    mastra: Mastra;
+    cleanup: () => Promise<void>;
+}
+//# sourceMappingURL=durable-agent.test.utils.d.ts.map

package/dist/__tests__/durable-agent.test.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-agent.test.utils.d.ts","sourceRoot":"","sources":["../../src/__tests__/durable-agent.test.utils.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC,eAAO,MAAM,YAAY,OAAO,CAAC;AAYjC;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAS1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhE;AAqFD;;;;;GAKG;AACH,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,IAAI,CAAC,CAmDnE;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBtE;AAMD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B"}

package/dist/durable-agent/create-inngest-agent.d.ts

@@ -0,0 +1,300 @@
+/**
+ * Factory function to create an Inngest-powered durable agent.
+ *
+ * This provides a clean API for wrapping a Mastra Agent with Inngest's
+ * durable execution engine. The returned object can be registered with
+ * Mastra like any other agent, and the required workflow is automatically
+ * registered when added to Mastra.
+ *
+ * @example
+ * ```typescript
+ * import { Agent } from '@mastra/core/agent';
+ * import { createInngestAgent } from '@mastra/inngest';
+ * import { Inngest } from 'inngest';
+ * import { realtimeMiddleware } from '@inngest/realtime/middleware';
+ *
+ * const inngest = new Inngest({
+ *   id: 'my-app',
+ *   middleware: [realtimeMiddleware()],
+ * });
+ *
+ * const agent = new Agent({
+ *   id: 'my-agent',
+ *   name: 'My Agent',
+ *   instructions: 'You are a helpful assistant',
+ *   model: openai('gpt-4'),
+ * });
+ *
+ * const durableAgent = createInngestAgent({ agent, inngest });
+ *
+ * const mastra = new Mastra({
+ *   agents: { myAgent: durableAgent },
+ * });
+ *
+ * // Use the agent
+ * const { output, cleanup } = await durableAgent.stream('Hello!');
+ * const text = await output.text;
+ * cleanup();
+ * ```
+ */
+import type { Agent, AgentExecutionOptions } from '@mastra/core/agent';
+import type { AgentFinishEventData, AgentStepFinishEventData, AgentSuspendedEventData } from '@mastra/core/agent/durable';
+import type { MessageListInput } from '@mastra/core/agent/message-list';
+import type { MastraServerCache } from '@mastra/core/cache';
+import type { PubSub } from '@mastra/core/events';
+import type { Mastra } from '@mastra/core/mastra';
+import type { MastraModelOutput, ChunkType } from '@mastra/core/stream';
+import type { Workflow } from '@mastra/core/workflows';
+import type { Inngest } from 'inngest';
+/**
+ * Options for createInngestAgent factory function.
+ */
+export interface CreateInngestAgentOptions {
+    /** The Mastra Agent to wrap with durable execution */
+    agent: Agent<any, any, any>;
+    /** Inngest client instance */
+    inngest: Inngest;
+    /** Optional ID override (defaults to agent.id) */
+    id?: string;
+    /** Optional name override (defaults to agent.name) */
+    name?: string;
+    /** Optional PubSub override (defaults to InngestPubSub) */
+    pubsub?: PubSub;
+    /**
+     * Cache instance for storing stream events.
+     * Enables resumable streams - clients can disconnect and reconnect
+     * without missing events.
+     *
+     * When provided, the pubsub is wrapped with CachingPubSub.
+     */
+    cache?: MastraServerCache;
+    /** Mastra instance for observability (optional, set automatically when registered with Mastra) */
+    mastra?: Mastra;
+}
+/**
+ * Options for InngestAgent.stream()
+ */
+export interface InngestAgentStreamOptions<OUTPUT = undefined> {
+    /** Custom instructions that override the agent's default instructions */
+    instructions?: AgentExecutionOptions<OUTPUT>['instructions'];
+    /** Additional context messages */
+    context?: AgentExecutionOptions<OUTPUT>['context'];
+    /** Memory configuration */
+    memory?: AgentExecutionOptions<OUTPUT>['memory'];
+    /** Unique identifier for this execution run */
+    runId?: string;
+    /** Request Context */
+    requestContext?: AgentExecutionOptions<OUTPUT>['requestContext'];
+    /** Maximum number of steps */
+    maxSteps?: number;
+    /** Additional tool sets */
+    toolsets?: AgentExecutionOptions<OUTPUT>['toolsets'];
+    /** Client-side tools */
+    clientTools?: AgentExecutionOptions<OUTPUT>['clientTools'];
+    /** Tool selection strategy */
+    toolChoice?: AgentExecutionOptions<OUTPUT>['toolChoice'];
+    /** Model settings */
+    modelSettings?: AgentExecutionOptions<OUTPUT>['modelSettings'];
+    /** Require approval for all tool calls */
+    requireToolApproval?: boolean;
+    /** Automatically resume suspended tools */
+    autoResumeSuspendedTools?: boolean;
+    /** Maximum concurrent tool calls */
+    toolCallConcurrency?: number;
+    /** Include raw chunks in output */
+    includeRawChunks?: boolean;
+    /** Maximum processor retries */
+    maxProcessorRetries?: number;
+    /** Callback when chunk is received */
+    onChunk?: (chunk: ChunkType<OUTPUT>) => void | Promise<void>;
+    /** Callback when step finishes */
+    onStepFinish?: (result: AgentStepFinishEventData) => void | Promise<void>;
+    /** Callback when execution finishes */
+    onFinish?: (result: AgentFinishEventData) => void | Promise<void>;
+    /** Callback on error */
+    onError?: (error: Error) => void | Promise<void>;
+    /** Callback when workflow suspends */
+    onSuspended?: (data: AgentSuspendedEventData) => void | Promise<void>;
+}
+/**
+ * Result from InngestAgent.stream()
+ */
+export interface InngestAgentStreamResult<OUTPUT = undefined> {
+    /** The streaming output */
+    output: MastraModelOutput<OUTPUT>;
+    /** The full stream - delegates to output.fullStream for server compatibility */
+    readonly fullStream: ReadableStream<any>;
+    /** The unique run ID */
+    runId: string;
+    /** Thread ID if using memory */
+    threadId?: string;
+    /** Resource ID if using memory */
+    resourceId?: string;
+    /** Cleanup function */
+    cleanup: () => void;
+}
+/**
+ * An Inngest-powered durable agent.
+ *
+ * This interface represents an agent that uses Inngest's durable execution engine.
+ * It can be registered with Mastra like a regular Agent, and the required workflow
+ * is automatically registered.
+ *
+ * At runtime, a Proxy forwards all Agent method calls (e.g., `generate()`, `listTools()`,
+ * `getMemory()`) to the underlying agent. The index signature below reflects this:
+ * any property not explicitly declared here is available via the Proxy.
+ */
+export interface InngestAgent<TOutput = undefined> {
+    /** Agent ID */
+    readonly id: string;
+    /** Agent name */
+    readonly name: string;
+    /** The underlying Mastra Agent (for Mastra registration) */
+    readonly agent: Agent<any, any, TOutput>;
+    /** The Inngest client */
+    readonly inngest: Inngest;
+    /** The cache instance if resumable streams are enabled */
+    readonly cache?: MastraServerCache;
+    /**
+     * The PubSub instance used for streaming events.
+     * Returns the CachingPubSub wrapper if caching is enabled.
+     * @internal Used by the server's observe endpoint to subscribe to the correct PubSub instance.
+     */
+    readonly pubsub: PubSub;
+    /**
+     * Stream a response using Inngest's durable execution.
+     */
+    stream(messages: MessageListInput, options?: InngestAgentStreamOptions<TOutput>): Promise<InngestAgentStreamResult<TOutput>>;
+    /**
+     * Resume a suspended workflow execution.
+     */
+    resume(runId: string, resumeData: unknown, options?: {
+        threadId?: string;
+        resourceId?: string;
+        onChunk?: (chunk: ChunkType<TOutput>) => void | Promise<void>;
+        onStepFinish?: (result: AgentStepFinishEventData) => void | Promise<void>;
+        onFinish?: (result: AgentFinishEventData) => void | Promise<void>;
+        onError?: (error: Error) => void | Promise<void>;
+        onSuspended?: (data: AgentSuspendedEventData) => void | Promise<void>;
+    }): Promise<InngestAgentStreamResult<TOutput>>;
+    /**
+     * Prepare for durable execution without starting it.
+     */
+    prepare(messages: MessageListInput, options?: AgentExecutionOptions<TOutput>): Promise<{
+        runId: string;
+        messageId: string;
+        workflowInput: any;
+        threadId?: string;
+        resourceId?: string;
+    }>;
+    /**
+     * Observe (reconnect to) an existing stream.
+     * Use this to resume receiving events after a disconnection.
+     *
+     * @param runId - The run ID to observe
+     * @param options.offset - Resume from this event index (0-based). If omitted, replays all events.
+     */
+    observe(runId: string, options?: {
+        offset?: number;
+        onChunk?: (chunk: ChunkType<TOutput>) => void | Promise<void>;
+        onStepFinish?: (result: AgentStepFinishEventData) => void | Promise<void>;
+        onFinish?: (result: AgentFinishEventData) => void | Promise<void>;
+        onError?: (error: Error) => void | Promise<void>;
+        onSuspended?: (data: AgentSuspendedEventData) => void | Promise<void>;
+    }): Promise<Omit<InngestAgentStreamResult<TOutput>, 'threadId' | 'resourceId'> & {
+        runId: string;
+    }>;
+    /**
+     * Get the durable workflows required by this agent.
+     * Called by Mastra during agent registration.
+     * @internal
+     */
+    getDurableWorkflows(): Workflow<any, any, any, any, any, any, any>[];
+    /**
+     * Set the Mastra instance for observability.
+     * Called by Mastra during agent registration.
+     * @internal
+     */
+    __setMastra(mastra: Mastra): void;
+    /** Generate a non-streaming response. Forwarded to the underlying Agent. */
+    generate(messages: MessageListInput, options?: AgentExecutionOptions<any>): Promise<any>;
+    /** Get the agent's description. Forwarded to the underlying Agent. */
+    getDescription(): string;
+    /** Get the agent's instructions. Forwarded to the underlying Agent. */
+    getInstructions(...args: any[]): any;
+    /** List tools available to the agent. Forwarded to the underlying Agent. */
+    listTools(...args: any[]): any;
+    /** Get the agent's LLM configuration. Forwarded to the underlying Agent. */
+    getLLM(...args: any[]): any;
+    /** Get the agent's model. Forwarded to the underlying Agent. */
+    getModel(...args: any[]): any;
+    /** Get the agent's memory instance. Forwarded to the underlying Agent. */
+    getMemory(...args: any[]): any;
+    /** Check if agent has its own memory. Forwarded to the underlying Agent. */
+    hasOwnMemory(): boolean;
+    /** Get the agent's workspace. Forwarded to the underlying Agent. */
+    getWorkspace(...args: any[]): any;
+    /** List sub-agents. Forwarded to the underlying Agent. */
+    listAgents(...args: any[]): any;
+    /** List workflows. Forwarded to the underlying Agent. */
+    listWorkflows(...args: any[]): any;
+    /** Get default execution options. Forwarded to the underlying Agent. */
+    getDefaultOptions(...args: any[]): any;
+    /** Get legacy generate options. Forwarded to the underlying Agent. */
+    getDefaultGenerateOptionsLegacy(...args: any[]): any;
+    /** Get legacy stream options. Forwarded to the underlying Agent. */
+    getDefaultStreamOptionsLegacy(...args: any[]): any;
+    /** Get available models. Forwarded to the underlying Agent. */
+    getModelList(...args: any[]): any;
+    /** Get configured processor workflows. Forwarded to the underlying Agent. */
+    getConfiguredProcessorWorkflows(...args: any[]): any;
+    /** Get raw agent configuration. Forwarded to the underlying Agent. */
+    toRawConfig(...args: any[]): any;
+    /** Resume a streaming execution. Forwarded to the underlying Agent. */
+    resumeStream(...args: any[]): any;
+    /** Resume a generate execution. Forwarded to the underlying Agent. */
+    resumeGenerate(...args: any[]): any;
+    /** Approve a pending tool call. Forwarded to the underlying Agent. */
+    approveToolCall(...args: any[]): any;
+    /** @internal Update the agent's model. Forwarded to the underlying Agent. */
+    __updateModel(...args: any[]): any;
+    /** @internal Reset to original model. Forwarded to the underlying Agent. */
+    __resetToOriginalModel(...args: any[]): any;
+    /** @internal Set logger. Forwarded to the underlying Agent. */
+    __setLogger(...args: any[]): any;
+    /** @internal Register primitives. Forwarded to the underlying Agent. */
+    __registerPrimitives(...args: any[]): any;
+    /** @internal Register Mastra instance. Forwarded to the underlying Agent. */
+    __registerMastra(...args: any[]): any;
+}
+/**
+ * Create an Inngest-powered durable agent from a Mastra Agent.
+ *
+ * This factory function wraps a regular Mastra Agent with Inngest's durable
+ * execution capabilities. The returned InngestAgent can be registered with
+ * Mastra, and the required workflow will be automatically registered.
+ *
+ * @param options - Configuration options
+ * @returns An InngestAgent that can be registered with Mastra
+ *
+ * @example
+ * ```typescript
+ * const agent = new Agent({
+ *   id: 'my-agent',
+ *   instructions: 'You are helpful',
+ *   model: openai('gpt-4'),
+ * });
+ *
+ * const durableAgent = createInngestAgent({ agent, inngest });
+ *
+ * const mastra = new Mastra({
+ *   agents: { myAgent: durableAgent },
+ * });
+ * ```
+ */
+export declare function createInngestAgent<TOutput = undefined>(options: CreateInngestAgentOptions): InngestAgent<TOutput>;
+/**
+ * Check if an object is an InngestAgent
+ */
+export declare function isInngestAgent(obj: any): obj is InngestAgent;
+//# sourceMappingURL=create-inngest-agent.d.ts.map

package/dist/durable-agent/create-inngest-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-inngest-agent.d.ts","sourceRoot":"","sources":["../../src/durable-agent/create-inngest-agent.ts"],"names":[],"mappings":"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"}

package/dist/durable-agent/create-inngest-agentic-workflow.d.ts

@@ -0,0 +1,55 @@
+import type { Inngest } from 'inngest';
+/**
+ * Options for creating an Inngest durable agentic workflow
+ */
+export interface InngestDurableAgenticWorkflowOptions {
+    /** Inngest client instance */
+    inngest: Inngest;
+    /** Maximum number of agentic loop iterations */
+    maxSteps?: number;
+}
+/** Inngest-prefixed workflow IDs */
+export declare const InngestDurableStepIds: {
+    readonly AGENTIC_EXECUTION: "inngest:durable-agentic-execution";
+    readonly AGENTIC_LOOP: "inngest:durable-agentic-loop";
+};
+export declare function createInngestDurableAgenticWorkflow(options: InngestDurableAgenticWorkflowOptions): import("@mastra/core/workflows").Workflow<import("../types").InngestEngineType, never[], "inngest:durable-agentic-loop", any, {
+    runId: string;
+    agentId: string;
+    messageListState: any;
+    toolsMetadata: any[];
+    modelConfig: {
+        provider: string;
+        modelId: string;
+        specificationVersion?: string | undefined;
+        settings?: Record<string, any> | undefined;
+    };
+    options: any;
+    state: any;
+    messageId: string;
+    agentName?: string | undefined;
+    agentSpanData?: any;
+    modelSpanData?: any;
+    stepIndex?: number | undefined;
+}, {
+    messageListState: any;
+    messageId: string;
+    stepResult: any;
+    output: {
+        usage: any;
+        steps: any[];
+        text?: string | undefined;
+    };
+    state: any;
+}, {
+    messageListState: any;
+    messageId: string;
+    stepResult: any;
+    output: {
+        usage: any;
+        steps: any[];
+        text?: string | undefined;
+    };
+    state: any;
+}, unknown>;
+//# sourceMappingURL=create-inngest-agentic-workflow.d.ts.map

package/dist/durable-agent/create-inngest-agentic-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-inngest-agentic-workflow.d.ts","sourceRoot":"","sources":["../../src/durable-agent/create-inngest-agentic-workflow.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AA2BvC;;GAEG;AACH,MAAM,WAAW,oCAAoC;IACnD,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuCD,oCAAoC;AACpC,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAgUhG"}