@n8n/agents 0.6.0 → 0.8.0

package/dist/sdk/tool.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tool = void 0;
 exports.wrapToolForApproval = wrapToolForApproval;
 const zod_1 = require("zod");
+const zod_2 = require("../utils/zod");
 const APPROVAL_SUSPEND_SCHEMA = zod_1.z.object({
     type: zod_1.z.literal('approval'),
     toolName: zod_1.z.string(),
@@ -50,6 +51,10 @@ class Tool {
         this.desc = desc;
         return this;
     }
+    systemInstruction(text) {
+        this.systemInstructionText = text;
+        return this;
+    }
     input(schema) {
         const self = this;
         self.inputSchema = schema;
@@ -122,6 +127,7 @@ class Tool {
         const built = {
             name: this.name,
             description: this.desc,
+            systemInstruction: this.systemInstructionText,
             suspendSchema: this.suspendSchemaValue,
             resumeSchema: this.resumeSchemaValue,
             toMessage: this.toMessageFn,
@@ -139,6 +145,34 @@ class Tool {
         }
         return built;
     }
+    describe() {
+        if (!this.name)
+            throw new Error('Tool name is required');
+        if (!this.desc)
+            throw new Error(`Tool "${this.name}" requires a description`);
+        if (!this.inputSchema)
+            throw new Error(`Tool "${this.name}" requires an input schema`);
+        const inputSchema = (0, zod_2.isZodSchema)(this.inputSchema)
+            ? (0, zod_2.zodToJsonSchema)(this.inputSchema)
+            : this.inputSchema;
+        const outputSchema = this.outputSchema
+            ? (0, zod_2.isZodSchema)(this.outputSchema)
+                ? (0, zod_2.zodToJsonSchema)(this.outputSchema)
+                : this.outputSchema
+            : null;
+        return {
+            name: this.name,
+            description: this.desc,
+            systemInstruction: this.systemInstructionText ?? null,
+            inputSchema: inputSchema,
+            outputSchema: outputSchema,
+            hasSuspend: this.suspendSchemaValue !== undefined,
+            hasResume: this.resumeSchemaValue !== undefined,
+            hasToMessage: this.toMessageFn !== undefined,
+            requireApproval: this.requireApprovalValue ?? false,
+            providerOptions: this.providerOptionsValue ?? null,
+        };
+    }
 }
 exports.Tool = Tool;
 //# sourceMappingURL=tool.js.map

package/dist/sdk/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/sdk/tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/sdk/tool.ts"],"names":[],"mappings":"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"}

package/dist/sdk/verify.js

@@ -16,10 +16,7 @@ function verify(source) {
         errors.push("Scorer is deprecated. Use the Eval system instead: new Eval('name').check(...) or evals.correctness()");
     }
     if (/process\.env\b/.test(source)) {
-        errors.push('process.env is not available. Use .credential() for API keys, or const variables for configuration.');
-    }
-    if (!/\.credential\s*\(/.test(source)) {
-        errors.push("No .credential() found. Every agent must declare a credential (e.g. .credential('anthropic')).");
+        errors.push('process.env is not available. Use const variables for configuration.');
     }
     return { ok: errors.length === 0, errors };
 }

package/dist/sdk/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/sdk/verify.ts"],"names":[],"mappings":";;AAuBA,wBAoCC;AApCD,SAAgB,MAAM,CAAC,MAAc;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CACV,0FAA0F,CAC1F,CAAC;IACH,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACV,uGAAuG,CACvG,CAAC;IACH,CAAC;IAED,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CACV,qGAAqG,CACrG,CAAC;IACH,CAAC;IAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CACV,gGAAgG,CAChG,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/sdk/verify.ts"],"names":[],"mappings":";;AAuBA,wBA4BC;AA5BD,SAAgB,MAAM,CAAC,MAAc;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CACV,0FAA0F,CAC1F,CAAC;IACH,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACV,uGAAuG,CACvG,CAAC;IACH,CAAC;IAED,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC"}

package/dist/storage/base-memory.d.ts

@@ -0,0 +1,54 @@
+import type { BuiltMemory, MemoryDescriptor, Thread } from '../types/sdk/memory';
+import type { AgentDbMessage } from '../types/sdk/message';
+import type { JSONObject } from '../types/utils/json';
+export declare abstract class BaseMemory<TConstructorOptions extends JSONObject = JSONObject> implements BuiltMemory {
+    protected readonly name: string;
+    protected readonly constructorOptions: TConstructorOptions;
+    constructor(name: string, constructorOptions: TConstructorOptions);
+    getThread(_threadId: string): Promise<Thread | null>;
+    saveThread(_thread: Omit<Thread, 'createdAt' | 'updatedAt'>): Promise<Thread>;
+    deleteThread(_threadId: string): Promise<void>;
+    getMessages(_threadId: string, _opts?: {
+        limit?: number;
+        before?: Date;
+    }): Promise<AgentDbMessage[]>;
+    saveMessages(_args: {
+        threadId: string;
+        resourceId: string;
+        messages: AgentDbMessage[];
+    }): Promise<void>;
+    deleteMessages(_messageIds: string[]): Promise<void>;
+    search?(_query: string, _opts?: {
+        scope?: 'thread' | 'resource';
+        threadId?: string;
+        resourceId?: string;
+        topK?: number;
+        messageRange?: {
+            before: number;
+            after: number;
+        };
+    }): Promise<AgentDbMessage[]>;
+    saveEmbeddings?(_opts: {
+        scope?: 'thread' | 'resource';
+        threadId?: string;
+        resourceId?: string;
+        entries: Array<{
+            id: string;
+            vector: number[];
+            text: string;
+            model: string;
+        }>;
+    }): Promise<void>;
+    queryEmbeddings?(_opts: {
+        scope?: 'thread' | 'resource';
+        threadId?: string;
+        resourceId?: string;
+        vector: number[];
+        topK: number;
+    }): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+    close?(): Promise<void>;
+    describe(): MemoryDescriptor<TConstructorOptions>;
+}

package/dist/storage/base-memory.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseMemory = void 0;
+class BaseMemory {
+    constructor(name, constructorOptions) {
+        this.name = name;
+        this.constructorOptions = constructorOptions;
+    }
+    getThread(_threadId) {
+        throw new Error('Method not implemented.');
+    }
+    saveThread(_thread) {
+        throw new Error('Method not implemented.');
+    }
+    deleteThread(_threadId) {
+        throw new Error('Method not implemented.');
+    }
+    getMessages(_threadId, _opts) {
+        throw new Error('Method not implemented.');
+    }
+    saveMessages(_args) {
+        throw new Error('Method not implemented.');
+    }
+    deleteMessages(_messageIds) {
+        throw new Error('Method not implemented.');
+    }
+    search(_query, _opts) {
+        throw new Error('Method not implemented.');
+    }
+    saveEmbeddings(_opts) {
+        throw new Error('Method not implemented.');
+    }
+    queryEmbeddings(_opts) {
+        throw new Error('Method not implemented.');
+    }
+    close() {
+        throw new Error('Method not implemented.');
+    }
+    describe() {
+        return {
+            name: this.name,
+            constructorName: this.constructor.name,
+            connectionParams: this.constructorOptions,
+        };
+    }
+}
+exports.BaseMemory = BaseMemory;
+//# sourceMappingURL=base-memory.js.map

package/dist/storage/base-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-memory.js","sourceRoot":"","sources":["../../src/storage/base-memory.ts"],"names":[],"mappings":";;;AAKA,MAAsB,UAAU;IAG/B,YACoB,IAAY,EACZ,kBAAuC;QADvC,SAAI,GAAJ,IAAI,CAAQ;QACZ,uBAAkB,GAAlB,kBAAkB,CAAqB;IACxD,CAAC;IAEJ,SAAS,CAAC,SAAiB;QAC1B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,UAAU,CAAC,OAAgD;QAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,SAAiB;QAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,WAAW,CACV,SAAiB,EACjB,KAAyC;QAEzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,YAAY,CAAC,KAIZ;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,cAAc,CAAC,WAAqB;QACnC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CACL,MAAc,EACd,KAMC;QAED,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,cAAc,CAAE,KAKf;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,eAAe,CAAE,KAMhB;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK;QACJ,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,QAAQ;QACP,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YACtC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;SACzC,CAAC;IACH,CAAC;CACD;AA1ED,gCA0EC"}

package/dist/types/index.d.ts

@@ -1,10 +1,13 @@
 export type { JSONValue, JSONObject, JSONArray } from './utils/json';
-export type { MessageRole, MessageContent, ContentMetadata, ContentCitation, ContentText, ContentReasoning, ContentFile, ContentToolCall, ContentToolResult, ContentInvalidToolCall, ContentProvider, Message, AgentMessageBase, CustomAgentMessages, AgentMessage, AgentDbMessage, } from './sdk/message';
+export type { MessageRole, MessageContent, ContentMetadata, ContentCitation, ContentText, ContentReasoning, ContentFile, ContentToolCall, ContentInvalidToolCall, ContentProvider, Message, AgentMessageBase, CustomAgentMessages, AgentMessage, AgentDbMessage, } from './sdk/message';
 export type { Provider, AnthropicThinkingConfig, OpenAIThinkingConfig, GoogleThinkingConfig, XaiThinkingConfig, ThinkingConfigFor, ThinkingConfig, } from './sdk/provider';
-export type { AgentResult, StreamChunk, FinishReason, TokenUsage, ModelConfig, RunOptions, ExecutionOptions, PersistedExecutionOptions, ResumeOptions, GenerateResult, StreamResult, SubAgentUsage, BuiltAgent, AgentRunState, AgentResumeData, PendingToolCall, SerializableAgentState, } from './sdk/agent';
+export type { AgentResult, StreamChunk, FinishReason, TokenUsage, ModelConfig, RunOptions, ExecutionOptions, AgentExecutionCounter, PersistedExecutionOptions, ResumeOptions, GenerateResult, StreamResult, SubAgentUsage, BuiltAgent, AgentRunState, AgentResumeData, PendingToolCall, SerializableAgentState, } from './sdk/agent';
 export type { SerializedMessageList } from './runtime/message-list';
 export type { ToolContext, InterruptibleToolContext, BuiltTool, BuiltProviderTool, } from './sdk/tool';
-export type { Thread, BuiltMemory, SemanticRecallConfig, MemoryConfig, CheckpointStore, TitleGenerationConfig, } from './sdk/memory';
+export type { Thread, BuiltMemory, ObservationCapableMemory, MemoryDescriptor, SemanticRecallConfig, MemoryConfig, ObservationLogMemoryConfig, ObservationalMemoryConfig, CheckpointStore, TitleGenerationConfig, } from './sdk/memory';
+export type { ObservationCursor, ScopeKind, } from './sdk/observation';
+export type { BuiltObservationLogStore, BuiltObservationLogTaskLockStore, NewObservationLogEntry, ObservationLogEntry, ObservationLogMarker, ObservationLogMerge, ObservationLogObserveFn, ObservationLogObserverInput, ObservationLogReadOptions, ObservationLogReflectFn, ObservationLogReflectorInput, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScope, ObservationLogScopeKind, ObservationLogStatus, ObservationLogTaskKind, ObservationLogTaskLockHandle, TokenCounter, } from './sdk/observation-log';
+export { createObservationLogThreadScopeId, createObservationLogThreadScopePrefix, estimateObservationTokens, OBSERVATION_LOG_MARKERS, OBSERVATION_LOG_STATUSES, } from './sdk/observation-log';
 export type { EvalInput, EvalScore, JudgeFn, JudgeInput, CheckFn, JudgeHandlerFn, BuiltEval, EvalRunResult, EvalResults, } from './sdk/eval';
 export type { GuardrailType, GuardrailStrategy, PiiDetectionType, BuiltGuardrail, } from './sdk/guardrail';
 export type { BuiltTelemetry, AttributeValue, OpaqueTracer, OpaqueTracerProvider, } from './telemetry';

package/dist/types/index.js

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentEvent = void 0;
+exports.AgentEvent = exports.OBSERVATION_LOG_STATUSES = exports.OBSERVATION_LOG_MARKERS = exports.estimateObservationTokens = exports.createObservationLogThreadScopePrefix = exports.createObservationLogThreadScopeId = void 0;
+var observation_log_1 = require("./sdk/observation-log");
+Object.defineProperty(exports, "createObservationLogThreadScopeId", { enumerable: true, get: function () { return observation_log_1.createObservationLogThreadScopeId; } });
+Object.defineProperty(exports, "createObservationLogThreadScopePrefix", { enumerable: true, get: function () { return observation_log_1.createObservationLogThreadScopePrefix; } });
+Object.defineProperty(exports, "estimateObservationTokens", { enumerable: true, get: function () { return observation_log_1.estimateObservationTokens; } });
+Object.defineProperty(exports, "OBSERVATION_LOG_MARKERS", { enumerable: true, get: function () { return observation_log_1.OBSERVATION_LOG_MARKERS; } });
+Object.defineProperty(exports, "OBSERVATION_LOG_STATUSES", { enumerable: true, get: function () { return observation_log_1.OBSERVATION_LOG_STATUSES; } });
 var event_1 = require("./runtime/event");
 Object.defineProperty(exports, "AgentEvent", { enumerable: true, get: function () { return event_1.AgentEvent; } });
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA+FA,yCAA6C;AAApC,mGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAmGA,yDAM+B;AAL9B,oIAAA,iCAAiC,OAAA;AACjC,wIAAA,qCAAqC,OAAA;AACrC,4HAAA,yBAAyB,OAAA;AACzB,0HAAA,uBAAuB,OAAA;AACvB,2HAAA,wBAAwB,OAAA;AA6BzB,yCAA6C;AAApC,mGAAA,UAAU,OAAA"}

package/dist/types/runtime/event.d.ts

@@ -1,5 +1,4 @@
-import type { AgentPersistenceOptions } from '../sdk/agent';
-import type { AgentMessage, ContentToolResult } from '../sdk/message';
+import type { AgentMessage, ContentToolCall } from '../sdk/message';
 export declare const enum AgentEvent {
     AgentStart = "agent_start",
     AgentEnd = "agent_end",
@@ -9,11 +8,7 @@ export declare const enum AgentEvent {
     ToolExecutionEnd = "tool_execution_end",
     Error = "error"
 }
-export type SharedAgentEventData = {
-    runId: string;
-    persistence?: AgentPersistenceOptions;
-};
-export type AgentEventSpecificData = {
+export type AgentEventData = {
     type: AgentEvent.AgentStart;
 } | {
     type: AgentEvent.AgentEnd;
@@ -23,7 +18,7 @@ export type AgentEventSpecificData = {
 } | {
     type: AgentEvent.TurnEnd;
     message: AgentMessage;
-    toolResults: ContentToolResult[];
+    toolResults: ContentToolCall[];
 } | {
     type: AgentEvent.ToolExecutionStart;
     toolCallId: string;
@@ -39,8 +34,8 @@ export type AgentEventSpecificData = {
     type: AgentEvent.Error;
     message: string;
     error: unknown;
+    source?: 'observer' | 'reflector';
 };
-export type AgentEventData = SharedAgentEventData & AgentEventSpecificData;
 export type AgentEventHandler = (data: AgentEventData) => void;
 export interface AgentMiddleware {
     on: (event: AgentEvent, handler: AgentEventHandler) => void;

package/dist/types/runtime/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/types/runtime/event.ts"],"names":[],"mappings":";;;AAGA,IAAkB,UAQjB;AARD,WAAkB,UAAU;IAC3B,wCAA0B,CAAA;IAC1B,oCAAsB,CAAA;IACtB,sCAAwB,CAAA;IACxB,kCAAoB,CAAA;IACpB,yDAA2C,CAAA;IAC3C,qDAAuC,CAAA;IACvC,6BAAe,CAAA;AAChB,CAAC,EARiB,UAAU,0BAAV,UAAU,QAQ3B"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/types/runtime/event.ts"],"names":[],"mappings":";;;AAEA,IAAkB,UAQjB;AARD,WAAkB,UAAU;IAC3B,wCAA0B,CAAA;IAC1B,oCAAsB,CAAA;IACtB,sCAAwB,CAAA;IACxB,kCAAoB,CAAA;IACpB,yDAA2C,CAAA;IAC3C,qDAAuC,CAAA;IACvC,6BAAe,CAAA;AAChB,CAAC,EARiB,UAAU,0BAAV,UAAU,QAQ3B"}

package/dist/types/sdk/agent-builder.d.ts

@@ -1,21 +1,23 @@
 import type { ModelConfig } from './agent';
-import type { CredentialProvider } from './credential-provider';
 import type { BuiltEval } from './eval';
 import type { BuiltGuardrail } from './guardrail';
 import type { CheckpointStore } from './memory';
 import type { BuiltProviderTool, BuiltTool } from './tool';
 export interface AgentBuilder {
     model(providerOrIdOrConfig: string | ModelConfig, modelName?: string): this;
-    credential(name: string): this;
     instructions(text: string): this;
     tool(t: BuiltTool | BuiltTool[]): this;
+    deferredTool(t: BuiltTool | BuiltTool[], options?: {
+        search?: {
+            topK?: number;
+        };
+    }): this;
     providerTool(t: BuiltProviderTool): this;
     thinking(provider: string, config?: Record<string, unknown>): this;
     toolCallConcurrency(n: number): this;
     requireToolApproval(): this;
     memory(m: unknown): this;
     checkpoint(storage: 'memory' | CheckpointStore): this;
-    credentialProvider(p: CredentialProvider): this;
     inputGuardrail(g: BuiltGuardrail): this;
     outputGuardrail(g: BuiltGuardrail): this;
     eval(e: BuiltEval): this;

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

@@ -3,6 +3,7 @@ import type { LanguageModel } from 'ai';
 import type { JsonSchema7Type } from 'zod-to-json-schema';
 import type { AgentMessage, ContentMetadata } from './message';
 import type { BuiltTool } from './tool';
+import type { ProviderId, ProviderCredentials } from '../../runtime/provider-credentials';
 import type { AgentEvent, AgentEventHandler } from '../runtime/event';
 import type { SerializedMessageList } from '../runtime/message-list';
 import type { BuiltTelemetry } from '../telemetry';
@@ -22,11 +23,14 @@ export type TokenUsage<T extends Record<string, unknown> = Record<string, unknow
     };
     additionalMetadata?: T;
 };
-export type ModelConfig = string | {
+export type TypedModelConfig = {
+    [P in ProviderId]: {
+        id: `${P}/${string}`;
+    } & ProviderCredentials<P>;
+}[ProviderId];
+export type ModelConfig = string | TypedModelConfig | {
     id: string;
-    apiKey?: string;
-    url?: string;
-    headers?: Record<string, string>;
+    [k: string]: unknown;
 } | LanguageModel;
 export interface AgentResult {
     id?: string;
@@ -38,50 +42,89 @@ export interface AgentResult {
     output?: unknown;
 }
 export type StreamChunk = ContentMetadata & ({
-    type: 'finish';
-    finishReason: FinishReason;
-    usage?: TokenUsage;
-    model?: string;
-    structuredOutput?: unknown;
-    subAgentUsage?: SubAgentUsage[];
-    totalCost?: number;
+    type: 'start-step';
+} | {
+    type: 'finish-step';
+} | {
+    type: 'text-start';
+    id: string;
 } | {
     type: 'text-delta';
-    id?: string;
+    id: string;
     delta: string;
+} | {
+    type: 'text-end';
+    id: string;
+} | {
+    type: 'reasoning-start';
+    id: string;
 } | {
     type: 'reasoning-delta';
-    id?: string;
+    id: string;
     delta: string;
 } | {
-    type: 'tool-call-delta';
-    id?: string;
-    name?: string;
-    argumentsDelta?: string;
+    type: 'reasoning-end';
+    id: string;
 } | {
-    type: 'error';
-    error: unknown;
+    type: 'tool-input-start';
+    toolCallId: string;
+    toolName: string;
 } | {
-    type: 'message';
-    message: AgentMessage;
-    id?: string;
+    type: 'tool-input-delta';
+    toolCallId: string;
+    delta: string;
+} | {
+    type: 'tool-call';
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+} | {
+    type: 'tool-execution-start';
+    toolCallId: string;
+    toolName: string;
+} | {
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+    isError?: boolean;
 } | {
     type: 'tool-call-suspended';
-    runId?: string;
-    toolCallId?: string;
-    toolName?: string;
+    runId: string;
+    toolCallId: string;
+    toolName: string;
     input?: unknown;
     suspendPayload?: unknown;
     resumeSchema?: JsonSchema7Type;
+} | {
+    type: 'message';
+    message: AgentMessage;
+} | {
+    type: 'finish';
+    finishReason: FinishReason;
+    usage?: TokenUsage;
+    model?: string;
+    structuredOutput?: unknown;
+    subAgentUsage?: SubAgentUsage[];
+    totalCost?: number;
+} | {
+    type: 'error';
+    error: unknown;
 });
 export interface RunOptions {
     persistence?: AgentPersistenceOptions;
 }
+export interface AgentExecutionCounter {
+    incrementMessageCount(): void;
+    incrementToolCallCount(): void;
+    incrementTokenCount(tokenCount: number): void;
+}
 export interface ExecutionOptions {
     maxIterations?: number;
     abortSignal?: AbortSignal;
     providerOptions?: ProviderOptions;
     telemetry?: BuiltTelemetry;
+    executionCounter?: AgentExecutionCounter;
 }
 export interface PersistedExecutionOptions {
     maxIterations?: number;
@@ -117,12 +160,10 @@ export interface GenerateResult {
         resumeSchema?: JsonSchema7Type;
     }>;
     error?: unknown;
-    getState(): SerializableAgentState;
 }
 export interface StreamResult {
     runId: string;
     stream: ReadableStream<StreamChunk>;
-    getState(): SerializableAgentState;
 }
 export interface ResumeOptions {
     runId: string;
@@ -134,6 +175,7 @@ export interface BuiltAgent {
     stream(input: AgentMessage[] | string, options?: RunOptions & ExecutionOptions): Promise<StreamResult>;
     on(event: AgentEvent, handler: AgentEventHandler): void;
     asTool(description: string): BuiltTool;
+    getState(): SerializableAgentState;
     abort(): void;
     resume(method: 'generate', data: unknown, options: ResumeOptions & ExecutionOptions): Promise<GenerateResult>;
     resume(method: 'stream', data: unknown, options: ResumeOptions & ExecutionOptions): Promise<StreamResult>;
@@ -157,6 +199,7 @@ export type PendingToolCall = {
     suspended: true;
     suspendPayload: unknown;
     resumeSchema: JsonSchema7Type;
+    runId: string;
 } | {
     suspended: false;
 });

package/dist/types/sdk/credential-provider.d.ts

@@ -1,7 +1,6 @@
-export interface ResolvedCredential {
-    apiKey: string;
+export type ResolvedCredential = {
     [key: string]: unknown;
-}
+};
 export interface CredentialListItem {
     id: string;
     name: string;

package/dist/types/sdk/memory.d.ts

@@ -1,6 +1,12 @@
-import type { z } from 'zod';
 import type { ModelConfig, SerializableAgentState } from './agent';
 import type { AgentDbMessage } from './message';
+import type { BuiltObservationLogStore, ObservationLogObserveFn, ObservationLogReflectFn } from './observation-log';
+import type { JSONObject } from '../utils/json';
+export interface MemoryDescriptor<TParams extends JSONObject = JSONObject> {
+    name: string;
+    constructorName: string;
+    connectionParams: TParams | null;
+}
 export interface Thread {
     id: string;
     resourceId: string;
@@ -16,6 +22,7 @@ export interface BuiltMemory {
     getMessages(threadId: string, opts?: {
         limit?: number;
         before?: Date;
+        resourceId?: string;
     }): Promise<AgentDbMessage[]>;
     saveMessages(args: {
         threadId: string;
@@ -33,16 +40,6 @@ export interface BuiltMemory {
             after: number;
         };
     }): Promise<AgentDbMessage[]>;
-    getWorkingMemory?(params: {
-        threadId: string;
-        resourceId: string;
-        scope: 'resource' | 'thread';
-    }): Promise<string | null>;
-    saveWorkingMemory?(params: {
-        threadId: string;
-        resourceId: string;
-        scope: 'resource' | 'thread';
-    }, content: string): Promise<void>;
     saveEmbeddings?(opts: {
         scope?: 'thread' | 'resource';
         threadId?: string;
@@ -65,6 +62,7 @@ export interface BuiltMemory {
         score: number;
     }>>;
     close?(): Promise<void>;
+    describe(): MemoryDescriptor;
 }
 export interface SemanticRecallConfig {
     scope?: 'thread' | 'resource';
@@ -79,22 +77,37 @@ export interface SemanticRecallConfig {
 export interface TitleGenerationConfig {
     model?: ModelConfig;
     instructions?: string;
+    sync?: boolean;
 }
-export interface MemoryConfig {
-    memory: BuiltMemory;
+export type ObservationCapableMemory = BuiltMemory & BuiltObservationLogStore;
+export interface ObservationLogMemoryConfig {
+    renderTokenBudget?: number;
+}
+export interface ObservationalMemoryConfig {
+    observerThresholdTokens?: number;
+    reflectorThresholdTokens?: number;
+    renderTokenBudget?: number;
+    observationLogTailLimit?: number;
+    lockTtlMs?: number;
+    observe?: ObservationLogObserveFn;
+    reflect?: ObservationLogReflectFn;
+}
+interface MemoryConfigBase {
     lastMessages: number;
-    workingMemory?: {
-        template: string;
-        structured: boolean;
-        schema?: z.ZodObject<z.ZodRawShape>;
-        scope: 'resource' | 'thread';
-        instruction?: string;
-    };
+    observationLog?: ObservationLogMemoryConfig;
     semanticRecall?: SemanticRecallConfig;
     titleGeneration?: TitleGenerationConfig;
 }
+export type MemoryConfig = (MemoryConfigBase & {
+    memory: BuiltMemory;
+    observationalMemory?: undefined;
+}) | (MemoryConfigBase & {
+    memory: ObservationCapableMemory;
+    observationalMemory: ObservationalMemoryConfig;
+});
 export interface CheckpointStore {
     save(key: string, state: SerializableAgentState): Promise<void>;
     load(key: string): Promise<SerializableAgentState | undefined>;
     delete(key: string): Promise<void>;
 }
+export {};

package/dist/types/sdk/message.d.ts

@@ -1,7 +1,7 @@
 import type { ProviderOptions } from '@ai-sdk/provider-utils';
 import type { JSONValue } from '../utils/json';
 export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
-export type MessageContent = ContentText | ContentToolCall | ContentInvalidToolCall | ContentToolResult | ContentReasoning | ContentFile | ContentCitation | ContentProvider;
+export type MessageContent = ContentText | ContentToolCall | ContentInvalidToolCall | ContentReasoning | ContentFile | ContentCitation | ContentProvider;
 export interface ContentMetadata {
     providerMetadata?: Record<string, unknown>;
     providerOptions?: ProviderOptions;
@@ -30,18 +30,19 @@ export type ContentFile = ContentMetadata & {
 };
 export type ContentToolCall = ContentMetadata & {
     type: 'tool-call';
-    toolCallId?: string;
+    toolCallId: string;
     toolName: string;
     input: JSONValue;
     providerExecuted?: boolean;
-};
-export type ContentToolResult = ContentMetadata & {
-    type: 'tool-result';
-    toolName: string;
-    toolCallId: string;
-    result: JSONValue;
-    isError?: boolean;
-};
+} & ({
+    state: 'pending';
+} | {
+    state: 'resolved';
+    output: JSONValue;
+} | {
+    state: 'rejected';
+    error: string;
+});
 export type ContentInvalidToolCall = ContentMetadata & {
     type: 'invalid-tool-call';
     toolCallId?: string;