@n8n/agents 0.7.0 → 0.8.0

package/dist/sdk/catalog.js.map

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

package/dist/sdk/memory.d.ts

@@ -1,24 +1,24 @@
-import type { z } from 'zod';
-import type { BuiltMemory, MemoryConfig, SemanticRecallConfig, TitleGenerationConfig } from '../types';
-type ZodObjectSchema = z.ZodObject<z.ZodRawShape>;
+import { DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS, DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET } from '../runtime/observation-log-defaults';
+import type { BuiltMemory, MemoryConfig, ObservationalMemoryConfig, SemanticRecallConfig, TitleGenerationConfig } from '../types';
+import type { ModelConfig } from '../types/sdk/agent';
+export { DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS, DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET };
+export interface ResolveObservationalMemoryConfigOptions {
+    defaultModel: ModelConfig;
+}
+export declare function resolveObservationalMemoryConfig(config: ObservationalMemoryConfig, options: ResolveObservationalMemoryConfigOptions): ObservationalMemoryConfig;
+export declare function resolveMemoryConfigDefaults(config: MemoryConfig, options: ResolveObservationalMemoryConfigOptions): MemoryConfig;
+export declare function normalizeMemoryConfig(config: MemoryConfig): MemoryConfig;
 export declare class Memory {
     private lastMessagesValue;
     private semanticRecallConfig?;
-    private workingMemorySchema?;
-    private workingMemoryTemplate?;
-    private workingMemoryScope;
-    private workingMemoryInstruction?;
     private memoryBackend?;
     private titleGenerationConfig?;
+    private observationalMemoryConfig?;
     get lastMessageCount(): number;
     storage(backend: 'memory' | BuiltMemory): this;
     lastMessages(count: number): this;
     semanticRecall(config: SemanticRecallConfig): this;
-    structured(schema: ZodObjectSchema): this;
-    freeform(template: string): this;
-    scope(s: 'resource' | 'thread'): this;
-    instruction(text: string): this;
     titleGeneration(config: boolean | TitleGenerationConfig): this;
+    observationalMemory(config?: ObservationalMemoryConfig): this;
     build(): MemoryConfig;
 }
-export {};

package/dist/sdk/memory.js

@@ -1,13 +1,65 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Memory = void 0;
+exports.Memory = exports.DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET = exports.DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS = void 0;
+exports.resolveObservationalMemoryConfig = resolveObservationalMemoryConfig;
+exports.resolveMemoryConfigDefaults = resolveMemoryConfigDefaults;
+exports.normalizeMemoryConfig = normalizeMemoryConfig;
 const memory_store_1 = require("../runtime/memory-store");
-const working_memory_1 = require("../runtime/working-memory");
+const observation_log_defaults_1 = require("../runtime/observation-log-defaults");
+Object.defineProperty(exports, "DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS", { enumerable: true, get: function () { return observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS; } });
+Object.defineProperty(exports, "DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET", { enumerable: true, get: function () { return observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET; } });
+const observation_log_store_1 = require("../runtime/observation-log-store");
 const DEFAULT_LAST_MESSAGES = 10;
+function resolveObservationalMemoryConfig(config, options) {
+    const observerModel = options.defaultModel;
+    const reflectorModel = options.defaultModel;
+    return {
+        observerThresholdTokens: config.observerThresholdTokens ?? observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_OBSERVER_THRESHOLD_TOKENS,
+        reflectorThresholdTokens: config.reflectorThresholdTokens ?? observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_REFLECTOR_THRESHOLD_TOKENS,
+        renderTokenBudget: config.renderTokenBudget ?? observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_RENDER_TOKEN_BUDGET,
+        observationLogTailLimit: config.observationLogTailLimit ?? observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_TAIL_LIMIT,
+        lockTtlMs: config.lockTtlMs ?? observation_log_defaults_1.DEFAULT_OBSERVATION_LOG_LOCK_TTL_MS,
+        observe: config.observe ?? (0, observation_log_defaults_1.createObservationLogObserveFn)(observerModel),
+        reflect: config.reflect ?? (0, observation_log_defaults_1.createObservationLogReflectFn)(reflectorModel),
+    };
+}
+function resolveMemoryConfigDefaults(config, options) {
+    if (!config.observationalMemory) {
+        return config;
+    }
+    const observationalMemoryConfig = config.observationLog?.renderTokenBudget !== undefined &&
+        config.observationalMemory.renderTokenBudget === undefined
+        ? {
+            ...config.observationalMemory,
+            renderTokenBudget: config.observationLog.renderTokenBudget,
+        }
+        : config.observationalMemory;
+    const observationalMemory = resolveObservationalMemoryConfig(observationalMemoryConfig, options);
+    return normalizeMemoryConfig({
+        ...config,
+        observationalMemory,
+    });
+}
+function normalizeMemoryConfig(config) {
+    if (!config.observationalMemory) {
+        return config;
+    }
+    if (!(0, observation_log_store_1.hasObservationLogStore)(config.memory)) {
+        throw new Error("Observational memory requires a storage backend that implements BuiltObservationLogStore (e.g. n8n's N8nMemory).");
+    }
+    return {
+        ...config,
+        observationLog: {
+            ...config.observationLog,
+            ...(config.observationalMemory.renderTokenBudget !== undefined && {
+                renderTokenBudget: config.observationalMemory.renderTokenBudget,
+            }),
+        },
+    };
+}
 class Memory {
     constructor() {
         this.lastMessagesValue = DEFAULT_LAST_MESSAGES;
-        this.workingMemoryScope = 'resource';
     }
     get lastMessageCount() {
         return this.lastMessagesValue;
@@ -29,22 +81,6 @@ class Memory {
         this.semanticRecallConfig = config;
         return this;
     }
-    structured(schema) {
-        this.workingMemorySchema = schema;
-        return this;
-    }
-    freeform(template) {
-        this.workingMemoryTemplate = template;
-        return this;
-    }
-    scope(s) {
-        this.workingMemoryScope = s;
-        return this;
-    }
-    instruction(text) {
-        this.workingMemoryInstruction = text;
-        return this;
-    }
     titleGeneration(config) {
         if (config === true) {
             this.titleGenerationConfig = {};
@@ -57,15 +93,11 @@ class Memory {
         }
         return this;
     }
+    observationalMemory(config = {}) {
+        this.observationalMemoryConfig = config;
+        return this;
+    }
     build() {
-        if (this.workingMemorySchema && this.workingMemoryTemplate !== undefined) {
-            throw new Error('Working memory cannot use both .structured() and .freeform(). ' +
-                'Choose one: .structured(zodSchema) for typed state, or .freeform(template) for free-form text.');
-        }
-        if (this.workingMemoryTemplate !== undefined && this.workingMemoryTemplate.trim() === '') {
-            throw new Error('Free-form working memory template cannot be empty. ' +
-                'Provide a markdown template with slots for the agent to fill.');
-        }
         const memory = this.memoryBackend ?? new memory_store_1.InMemoryMemory();
         if (this.semanticRecallConfig) {
             if (!memory.queryEmbeddings && !memory.search) {
@@ -76,35 +108,23 @@ class Memory {
                     ".semanticRecall({ topK: 5, embedder: 'openai/text-embedding-3-small' })");
             }
         }
-        let workingMemory;
-        if (this.workingMemorySchema) {
-            workingMemory = {
-                template: (0, working_memory_1.templateFromSchema)(this.workingMemorySchema),
-                structured: true,
-                schema: this.workingMemorySchema,
-                scope: this.workingMemoryScope,
-                ...(this.workingMemoryInstruction !== undefined && {
-                    instruction: this.workingMemoryInstruction,
-                }),
-            };
-        }
-        else if (this.workingMemoryTemplate !== undefined) {
-            workingMemory = {
-                template: this.workingMemoryTemplate,
-                structured: false,
-                scope: this.workingMemoryScope,
-                ...(this.workingMemoryInstruction !== undefined && {
-                    instruction: this.workingMemoryInstruction,
-                }),
-            };
-        }
-        return {
+        const baseConfig = {
             memory,
             lastMessages: this.lastMessagesValue,
-            workingMemory,
             semanticRecall: this.semanticRecallConfig,
             titleGeneration: this.titleGenerationConfig,
         };
+        if (!this.observationalMemoryConfig) {
+            return normalizeMemoryConfig(baseConfig);
+        }
+        if (!(0, observation_log_store_1.hasObservationLogStore)(memory)) {
+            throw new Error("Observational memory requires a storage backend that implements BuiltObservationLogStore (e.g. n8n's N8nMemory).");
+        }
+        return normalizeMemoryConfig({
+            ...baseConfig,
+            memory,
+            observationalMemory: this.observationalMemoryConfig,
+        });
     }
 }
 exports.Memory = Memory;

package/dist/sdk/memory.js.map

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

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

@@ -28,16 +28,6 @@ export declare abstract class BaseMemory<TConstructorOptions extends JSONObject
             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;

package/dist/storage/base-memory.js

@@ -27,12 +27,6 @@ class BaseMemory {
     search(_query, _opts) {
         throw new Error('Method not implemented.');
     }
-    getWorkingMemory(_params) {
-        throw new Error('Method not implemented.');
-    }
-    saveWorkingMemory(_params, _content) {
-        throw new Error('Method not implemented.');
-    }
     saveEmbeddings(_opts) {
         throw new Error('Method not implemented.');
     }

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

@@ -1 +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,gBAAgB,CAAE,OAIjB;QACA,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IACD,iBAAiB,CAChB,OAA+E,EAC/E,QAAgB;QAEhB,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;AAvFD,gCAuFC"}
+{"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,12 +1,13 @@
 export type { JSONValue, JSONObject, JSONArray } from './utils/json';
 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, ObservationCapableMemory, MemoryDescriptor, SemanticRecallConfig, MemoryConfig, CheckpointStore, TitleGenerationConfig, } from './sdk/memory';
-export type { BuiltObservationStore, CompactFn, NewObservation, Observation, ObservationCursor, ObservationLockHandle, ObservationalMemoryConfig, ObserveFn, ScopeKind, } from './sdk/observation';
-export { OBSERVATION_SCHEMA_VERSION } from './sdk/observation';
+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,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentEvent = exports.OBSERVATION_SCHEMA_VERSION = void 0;
-var observation_1 = require("./sdk/observation");
-Object.defineProperty(exports, "OBSERVATION_SCHEMA_VERSION", { enumerable: true, get: function () { return observation_1.OBSERVATION_SCHEMA_VERSION; } });
+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":";;;AAiFA,iDAA+D;AAAtD,yHAAA,0BAA0B,OAAA;AA4BnC,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

@@ -34,6 +34,7 @@ export type AgentEventData = {
     type: AgentEvent.Error;
     message: string;
     error: unknown;
+    source?: 'observer' | 'reflector';
 };
 export type AgentEventHandler = (data: AgentEventData) => void;
 export interface AgentMiddleware {

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

@@ -7,6 +7,11 @@ export interface AgentBuilder {
     model(providerOrIdOrConfig: string | ModelConfig, modelName?: 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;

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

@@ -114,11 +114,17 @@ export type StreamChunk = ContentMetadata & ({
 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;

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

@@ -1,7 +1,6 @@
-import type { z } from 'zod';
 import type { ModelConfig, SerializableAgentState } from './agent';
 import type { AgentDbMessage } from './message';
-import type { BuiltObservationStore, ObservationalMemoryConfig } from './observation';
+import type { BuiltObservationLogStore, ObservationLogObserveFn, ObservationLogReflectFn } from './observation-log';
 import type { JSONObject } from '../utils/json';
 export interface MemoryDescriptor<TParams extends JSONObject = JSONObject> {
     name: string;
@@ -23,10 +22,7 @@ export interface BuiltMemory {
     getMessages(threadId: string, opts?: {
         limit?: number;
         before?: Date;
-        since?: {
-            sinceCreatedAt: Date;
-            sinceMessageId: string;
-        };
+        resourceId?: string;
     }): Promise<AgentDbMessage[]>;
     saveMessages(args: {
         threadId: string;
@@ -44,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;
@@ -93,16 +79,22 @@ export interface TitleGenerationConfig {
     instructions?: string;
     sync?: boolean;
 }
-export type ObservationCapableMemory = BuiltMemory & BuiltObservationStore;
+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;
 }

package/dist/types/sdk/observation-log.d.ts

@@ -0,0 +1,99 @@
+import type { AgentDbMessage } from './message';
+export declare const OBSERVATION_LOG_MARKERS: readonly ["critical", "important", "info", "completion"];
+export type ObservationLogMarker = (typeof OBSERVATION_LOG_MARKERS)[number];
+export declare const OBSERVATION_LOG_STATUSES: readonly ["active", "superseded", "dropped"];
+export type ObservationLogStatus = (typeof OBSERVATION_LOG_STATUSES)[number];
+export type ObservationLogScopeKind = 'thread' | 'resource';
+export type ObservationLogTaskKind = 'observer' | 'reflector';
+export declare function createObservationLogThreadScopeId(threadId: string, resourceId: string): string;
+export declare function createObservationLogThreadScopePrefix(threadId: string): string;
+export interface ObservationLogScope {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+}
+export interface ObservationLogTaskLockHandle extends ObservationLogScope {
+    taskKind: ObservationLogTaskKind;
+    holderId: string;
+    heldUntil: Date;
+}
+export interface ObservationLogEntry extends ObservationLogScope {
+    id: string;
+    marker: ObservationLogMarker;
+    text: string;
+    parentId: string | null;
+    tokenCount: number;
+    status: ObservationLogStatus;
+    supersededBy: string | null;
+    createdAt: Date;
+}
+export interface NewObservationLogEntry extends ObservationLogScope {
+    marker: ObservationLogMarker;
+    text: string;
+    parentId?: string | null;
+    tokenCount?: number;
+    createdAt?: Date;
+}
+export interface ObservationLogReadOptions extends ObservationLogScope {
+    status?: ObservationLogStatus;
+    parentId?: string | null;
+    limit?: number;
+    order?: 'asc' | 'desc';
+}
+export interface ObservationLogMerge {
+    supersedes: string[];
+    marker: ObservationLogMarker;
+    text: string;
+    parentId?: string | null;
+    tokenCount?: number;
+    createdAt?: Date;
+}
+export interface ObservationLogReflection {
+    drop: string[];
+    merge: ObservationLogMerge[];
+}
+export interface ObservationLogReflectionResult {
+    droppedIds: string[];
+    supersededIds: string[];
+    inserted: ObservationLogEntry[];
+}
+export type TokenCounter = (text: string) => number;
+export declare const estimateObservationTokens: TokenCounter;
+export interface ObservationLogObserverInput {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    now: Date;
+    deltaMessages: AgentDbMessage[];
+    transcript: string;
+    transcriptTokenCount: number;
+    observationLogTail: ObservationLogEntry[];
+    renderedObservationLogTail: string | null;
+}
+export type ObservationLogObserveFn = (input: ObservationLogObserverInput) => Promise<string>;
+export interface ObservationLogReflectorInput {
+    scopeKind: ObservationLogScopeKind;
+    scopeId: string;
+    now: Date;
+    activeObservationLog: ObservationLogEntry[];
+    renderedObservationLog: string;
+    tokenCount: number;
+    tokenBudget: number;
+}
+export type ObservationLogReflectFn = (input: ObservationLogReflectorInput) => Promise<string>;
+export interface BuiltObservationLogStore {
+    appendObservationLogEntries(rows: NewObservationLogEntry[]): Promise<ObservationLogEntry[]>;
+    getActiveObservationLog(scope: ObservationLogScope & {
+        limit?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<ObservationLogEntry[]>;
+    getObservationLog(opts: ObservationLogReadOptions): Promise<ObservationLogEntry[]>;
+    dropObservationLogEntries(ids: string[]): Promise<void>;
+    supersedeObservationLogEntries(ids: string[], supersededBy: string): Promise<void>;
+    applyObservationLogReflection(scope: ObservationLogScope, reflection: ObservationLogReflection): Promise<ObservationLogReflectionResult>;
+}
+export interface BuiltObservationLogTaskLockStore {
+    acquireObservationLogTaskLock(scopeKind: ObservationLogScopeKind, scopeId: string, taskKind: ObservationLogTaskKind, opts: {
+        ttlMs: number;
+        holderId: string;
+    }): Promise<ObservationLogTaskLockHandle | null>;
+    releaseObservationLogTaskLock(handle: ObservationLogTaskLockHandle): Promise<void>;
+}

package/dist/types/sdk/observation-log.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateObservationTokens = exports.OBSERVATION_LOG_STATUSES = exports.OBSERVATION_LOG_MARKERS = void 0;
+exports.createObservationLogThreadScopeId = createObservationLogThreadScopeId;
+exports.createObservationLogThreadScopePrefix = createObservationLogThreadScopePrefix;
+exports.OBSERVATION_LOG_MARKERS = ['critical', 'important', 'info', 'completion'];
+exports.OBSERVATION_LOG_STATUSES = ['active', 'superseded', 'dropped'];
+const OBSERVATION_LOG_THREAD_SCOPE_PREFIX = 'thread';
+function createObservationLogThreadScopeId(threadId, resourceId) {
+    return `${OBSERVATION_LOG_THREAD_SCOPE_PREFIX}:${encodeURIComponent(threadId)}:resource:${encodeURIComponent(resourceId)}`;
+}
+function createObservationLogThreadScopePrefix(threadId) {
+    return `${OBSERVATION_LOG_THREAD_SCOPE_PREFIX}:${encodeURIComponent(threadId)}:resource:`;
+}
+const estimateObservationTokens = (text) => Math.ceil(text.length / 4);
+exports.estimateObservationTokens = estimateObservationTokens;
+//# sourceMappingURL=observation-log.js.map

package/dist/types/sdk/observation-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-log.js","sourceRoot":"","sources":["../../../src/types/sdk/observation-log.ts"],"names":[],"mappings":";;;AAgBA,8EAEC;AAED,sFAEC;AApBY,QAAA,uBAAuB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAInF,QAAA,wBAAwB,GAAG,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAU,CAAC;AAQrF,MAAM,mCAAmC,GAAG,QAAQ,CAAC;AAErD,SAAgB,iCAAiC,CAAC,QAAgB,EAAE,UAAkB;IACrF,OAAO,GAAG,mCAAmC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,aAAa,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;AAC5H,CAAC;AAED,SAAgB,qCAAqC,CAAC,QAAgB;IACrE,OAAO,GAAG,mCAAmC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,YAAY,CAAC;AAC3F,CAAC;AA6DM,MAAM,yBAAyB,GAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAA/E,QAAA,yBAAyB,6BAAsD"}