@n8n/agents 0.8.1 → 0.9.1

package/dist/skills/validator.js

@@ -0,0 +1,336 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNTIME_SKILL_NAME_PATTERN = void 0;
+exports.validateRuntimeSkill = validateRuntimeSkill;
+exports.parseRuntimeSkillMarkdown = parseRuntimeSkillMarkdown;
+const yaml_1 = require("yaml");
+const types_1 = require("./types");
+exports.RUNTIME_SKILL_NAME_PATTERN = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const RUNTIME_SKILL_FRONTMATTER_FIELDS = [
+    'name',
+    'description',
+    'recommended_tools',
+    'allowed_tools',
+    'interface',
+    'policy',
+    'dependencies',
+    'platforms',
+    'version',
+    'license',
+    'compatibility',
+    'metadata',
+];
+function validateRuntimeSkill(skill) {
+    const errors = [];
+    requiredString(skill.id, 'id', errors);
+    requiredString(skill.name, 'name', errors);
+    requiredString(skill.description, 'description', errors);
+    requiredString(skill.instructions, 'instructions', errors);
+    if (errors.length > 0)
+        return { ok: false, errors };
+    return { ok: true, skill };
+}
+function parseRuntimeSkillMarkdown(content, options = {}) {
+    const frontmatter = parseFrontmatter(content, options.sourcePath ?? options.path ?? types_1.RUNTIME_SKILL_FILE_NAME);
+    if (!frontmatter.ok)
+        return frontmatter;
+    const errors = [];
+    rejectUnknownFields(frontmatter.data, RUNTIME_SKILL_FRONTMATTER_FIELDS, undefined, errors);
+    const name = requiredFrontmatterString(frontmatter.data, 'name', errors);
+    if (name && (options.validateName ?? true) && !exports.RUNTIME_SKILL_NAME_PATTERN.test(name)) {
+        errors.push({
+            code: 'invalid_name',
+            message: `Invalid skill name "${name}"`,
+            field: 'name',
+            hint: 'Use lowercase letters, numbers, dots, underscores, or dashes; max length is 64.',
+        });
+    }
+    const description = requiredFrontmatterString(frontmatter.data, 'description', errors);
+    const recommendedTools = optionalStringArray(frontmatter.data, 'recommended_tools', errors);
+    const allowedTools = optionalStringArray(frontmatter.data, 'allowed_tools', errors);
+    const skillInterface = optionalSkillInterface(frontmatter.data, errors);
+    const policy = optionalSkillPolicy(frontmatter.data, errors);
+    const dependencies = optionalSkillDependencies(frontmatter.data, errors);
+    const platforms = optionalStringArray(frontmatter.data, 'platforms', errors)?.map((platform) => platform.toLowerCase());
+    const version = optionalFrontmatterString(frontmatter.data, 'version', errors);
+    const license = optionalFrontmatterString(frontmatter.data, 'license', errors);
+    const compatibility = optionalFrontmatterString(frontmatter.data, 'compatibility', errors);
+    const metadata = optionalFrontmatterRecord(frontmatter.data, 'metadata', errors);
+    if (errors.length > 0 || !name || !description)
+        return { ok: false, errors };
+    return validateRuntimeSkill({
+        id: options.id ?? name,
+        name,
+        description,
+        instructions: frontmatter.body.trim(),
+        ...(options.sourceName ? { sourceName: options.sourceName } : {}),
+        ...(options.path ? { path: options.path } : {}),
+        ...(options.sourcePath ? { sourcePath: options.sourcePath } : {}),
+        ...(options.directory ? { directory: options.directory } : {}),
+        ...(options.sourceDirectory ? { sourceDirectory: options.sourceDirectory } : {}),
+        ...(options.category ? { category: options.category } : {}),
+        ...(recommendedTools ? { recommendedTools } : {}),
+        ...(allowedTools ? { allowedTools } : {}),
+        ...(skillInterface ? { interface: skillInterface } : {}),
+        ...(policy ? { policy } : {}),
+        ...(dependencies ? { dependencies } : {}),
+        ...(version ? { version } : {}),
+        ...(license ? { license } : {}),
+        ...(compatibility ? { compatibility } : {}),
+        ...(platforms ? { platforms } : {}),
+        ...((options.metadata ?? metadata)
+            ? { metadata: { ...(metadata ?? {}), ...(options.metadata ?? {}) } }
+            : {}),
+    });
+}
+function parseFrontmatter(content, sourcePath) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---') {
+        return {
+            ok: false,
+            errors: [
+                {
+                    code: 'missing_frontmatter',
+                    message: `${types_1.RUNTIME_SKILL_FILE_NAME} must start with a YAML frontmatter delimiter`,
+                    path: sourcePath,
+                },
+            ],
+        };
+    }
+    const endIndex = lines.findIndex((line, index) => index > 0 && line.trim() === '---');
+    if (endIndex === -1) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    code: 'unterminated_frontmatter',
+                    message: `${types_1.RUNTIME_SKILL_FILE_NAME} frontmatter must end with a YAML delimiter`,
+                    path: sourcePath,
+                },
+            ],
+        };
+    }
+    let data;
+    try {
+        data = (0, yaml_1.parse)(lines.slice(1, endIndex).join('\n'));
+    }
+    catch (error) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    code: 'invalid_yaml',
+                    message: `${types_1.RUNTIME_SKILL_FILE_NAME} frontmatter YAML is invalid: ${error instanceof Error ? error.message : String(error)}`,
+                    path: sourcePath,
+                },
+            ],
+        };
+    }
+    if (!isRecord(data)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    code: 'frontmatter_not_object',
+                    message: `${types_1.RUNTIME_SKILL_FILE_NAME} frontmatter must be a YAML object`,
+                    path: sourcePath,
+                },
+            ],
+        };
+    }
+    return { ok: true, data, body: lines.slice(endIndex + 1).join('\n') };
+}
+function requiredString(value, field, errors, displayField = field) {
+    const normalized = optionalString(value);
+    if (!normalized) {
+        errors.push({
+            code: 'missing_required_field',
+            message: `Missing required field "${displayField}"`,
+            field: displayField,
+        });
+    }
+    return normalized;
+}
+function requiredFrontmatterString(frontmatter, field, errors, displayField = field) {
+    return requiredString(frontmatter[field], field, errors, displayField);
+}
+function optionalFrontmatterString(frontmatter, field, errors, displayField = field) {
+    const value = frontmatter[field];
+    if (value === undefined || value === null)
+        return undefined;
+    const normalized = optionalString(value);
+    if (!normalized) {
+        errors.push({
+            code: 'invalid_field',
+            message: `Field "${displayField}" must be a non-empty string`,
+            field: displayField,
+        });
+    }
+    return normalized;
+}
+function optionalStringArray(frontmatter, field, errors, displayField = field) {
+    const value = frontmatter[field];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'string' && value.trim() !== '')
+        return [value.trim()];
+    if (!Array.isArray(value)) {
+        errors.push({
+            code: 'invalid_field',
+            message: `Field "${displayField}" must be a string array`,
+            field: displayField,
+        });
+        return undefined;
+    }
+    const strings = value
+        .map((item) => optionalString(item))
+        .filter((item) => Boolean(item));
+    if (strings.length !== value.length) {
+        errors.push({
+            code: 'invalid_field',
+            message: `Field "${displayField}" must contain only non-empty strings`,
+            field: displayField,
+        });
+    }
+    return strings.length > 0 ? strings : undefined;
+}
+function optionalFrontmatterRecord(frontmatter, field, errors, displayField = field) {
+    const value = frontmatter[field];
+    if (value === undefined || value === null)
+        return undefined;
+    if (!isRecord(value)) {
+        errors.push({
+            code: 'invalid_field',
+            message: `Field "${displayField}" must be a YAML object`,
+            field: displayField,
+        });
+        return undefined;
+    }
+    return value;
+}
+function optionalBoolean(frontmatter, field, errors, displayField = field) {
+    const value = frontmatter[field];
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== 'boolean') {
+        errors.push({
+            code: 'invalid_field',
+            message: `Field "${displayField}" must be a boolean`,
+            field: displayField,
+        });
+        return undefined;
+    }
+    return value;
+}
+function optionalSkillInterface(frontmatter, errors) {
+    const value = optionalFrontmatterRecord(frontmatter, 'interface', errors);
+    if (!value)
+        return undefined;
+    rejectUnknownFields(value, ['display_name', 'short_description', 'default_prompt', 'icon', 'brand_color'], 'interface', errors);
+    const displayName = optionalFrontmatterString(value, 'display_name', errors, 'interface.display_name');
+    const shortDescription = optionalFrontmatterString(value, 'short_description', errors, 'interface.short_description');
+    const defaultPrompt = optionalFrontmatterString(value, 'default_prompt', errors, 'interface.default_prompt');
+    const icon = optionalFrontmatterString(value, 'icon', errors, 'interface.icon');
+    const brandColor = optionalFrontmatterString(value, 'brand_color', errors, 'interface.brand_color');
+    const skillInterface = {
+        ...(displayName ? { displayName } : {}),
+        ...(shortDescription ? { shortDescription } : {}),
+        ...(defaultPrompt ? { defaultPrompt } : {}),
+        ...(icon ? { icon } : {}),
+        ...(brandColor ? { brandColor } : {}),
+    };
+    return hasContractFields(skillInterface) ? skillInterface : undefined;
+}
+function optionalSkillPolicy(frontmatter, errors) {
+    const value = optionalFrontmatterRecord(frontmatter, 'policy', errors);
+    if (!value)
+        return undefined;
+    rejectUnknownFields(value, ['allow_implicit_invocation', 'product'], 'policy', errors);
+    const allowImplicitInvocation = optionalBoolean(value, 'allow_implicit_invocation', errors, 'policy.allow_implicit_invocation');
+    const product = optionalFrontmatterString(value, 'product', errors, 'policy.product');
+    const policy = {
+        ...(allowImplicitInvocation !== undefined ? { allowImplicitInvocation } : {}),
+        ...(product ? { product } : {}),
+    };
+    return hasContractFields(policy) ? policy : undefined;
+}
+function optionalSkillDependencies(frontmatter, errors) {
+    const value = optionalFrontmatterRecord(frontmatter, 'dependencies', errors);
+    if (!value)
+        return undefined;
+    rejectUnknownFields(value, ['tools', 'secrets', 'mcp_servers'], 'dependencies', errors);
+    const tools = optionalStringArray(value, 'tools', errors, 'dependencies.tools');
+    const secrets = optionalStringArray(value, 'secrets', errors, 'dependencies.secrets');
+    const mcpServers = optionalMcpServers(value, errors);
+    const dependencies = {
+        ...(tools ? { tools } : {}),
+        ...(secrets ? { secrets } : {}),
+        ...(mcpServers ? { mcpServers } : {}),
+    };
+    return hasContractFields(dependencies) ? dependencies : undefined;
+}
+function optionalMcpServers(frontmatter, errors) {
+    const value = frontmatter.mcp_servers;
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value)) {
+        errors.push({
+            code: 'invalid_field',
+            message: 'Field "dependencies.mcp_servers" must be an array',
+            field: 'dependencies.mcp_servers',
+        });
+        return undefined;
+    }
+    const servers = [];
+    value.forEach((item, index) => {
+        const field = `dependencies.mcp_servers[${index}]`;
+        if (!isRecord(item)) {
+            errors.push({
+                code: 'invalid_field',
+                message: `Field "${field}" must be a YAML object`,
+                field,
+            });
+            return;
+        }
+        rejectUnknownFields(item, ['name', 'description', 'transport', 'url', 'command'], field, errors);
+        const name = requiredFrontmatterString(item, 'name', errors, `${field}.name`);
+        const description = optionalFrontmatterString(item, 'description', errors, `${field}.description`);
+        const transport = optionalFrontmatterString(item, 'transport', errors, `${field}.transport`);
+        const url = optionalFrontmatterString(item, 'url', errors, `${field}.url`);
+        const command = optionalFrontmatterString(item, 'command', errors, `${field}.command`);
+        if (!name)
+            return;
+        servers.push({
+            name,
+            ...(description ? { description } : {}),
+            ...(transport ? { transport } : {}),
+            ...(url ? { url } : {}),
+            ...(command ? { command } : {}),
+        });
+    });
+    return servers.length > 0 ? servers : undefined;
+}
+function rejectUnknownFields(value, allowedFields, fieldPrefix, errors) {
+    const allowed = new Set(allowedFields);
+    for (const field of Object.keys(value)) {
+        if (allowed.has(field))
+            continue;
+        const nestedField = fieldPrefix ? `${fieldPrefix}.${field}` : field;
+        errors.push({
+            code: 'unknown_field',
+            message: `Unknown field "${nestedField}"`,
+            field: nestedField,
+            hint: 'Use metadata for extension data outside the skill contract.',
+        });
+    }
+}
+function hasContractFields(value) {
+    return Object.keys(value).length > 0;
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=validator.js.map

package/dist/skills/validator.js.map

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

package/dist/types/index.d.ts

@@ -4,10 +4,10 @@ export type { Provider, AnthropicThinkingConfig, OpenAIThinkingConfig, GoogleThi
 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, 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 { Thread, BuiltMemory, BuiltEpisodicMemoryStore, EpisodicMemoryConfig, EpisodicMemoryCursor, EpisodicMemoryEmbeddingProviderOptions, EpisodicMemoryEntry, EpisodicMemoryEntrySource, EpisodicMemoryExtractFn, EpisodicMemoryExtraction, EpisodicMemoryExtractionCandidate, EpisodicMemoryExtractorInput, EpisodicMemoryMethods, EpisodicMemoryPrompts, EpisodicMemoryReflectFn, EpisodicMemoryReflection, EpisodicMemoryReflectionApply, EpisodicMemoryReflectionApplyMerge, EpisodicMemoryReflectionMerge, EpisodicMemoryReflectionResult, EpisodicMemoryReflectorInput, EpisodicMemoryScope, EpisodicMemorySearchOptions, EpisodicMemoryStatus, EpisodicMemoryTaskLockHandle, EpisodicMemoryTaskLockMethods, NewEpisodicMemoryCursor, NewEpisodicMemoryEntry, NewEpisodicMemoryEntrySource, NewEpisodicMemoryEntrySourceForEntry, RetrievedEpisodicMemoryEntry, ObservationCapableMemory, MemoryDescriptor, SemanticRecallConfig, MemoryConfig, ObservationLogMemoryConfig, ObservationalMemoryConfig, CheckpointStore, TitleGenerationConfig, } from './sdk/memory';
+export type { ObservationCursor } from './sdk/observation';
+export type { BuiltObservationLogStore, BuiltObservationLogTaskLockStore, NewObservationLogEntry, ObservationLogEntry, ObservationLogMarker, ObservationLogMerge, ObservationLogObserveFn, ObservationLogObserverInput, ObservationLogReadOptions, ObservationLogReflectFn, ObservationLogReflectorInput, ObservationLogReflection, ObservationLogReflectionResult, ObservationLogScope, ObservationLogStatus, ObservationLogTaskKind, ObservationLogTaskLockHandle, TokenCounter, } from './sdk/observation-log';
+export { 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,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentEvent = exports.OBSERVATION_LOG_STATUSES = exports.OBSERVATION_LOG_MARKERS = exports.estimateObservationTokens = exports.createObservationLogThreadScopePrefix = exports.createObservationLogThreadScopeId = void 0;
+exports.AgentEvent = exports.OBSERVATION_LOG_STATUSES = exports.OBSERVATION_LOG_MARKERS = exports.estimateObservationTokens = 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; } });

package/dist/types/index.js.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA4HA,yDAI+B;AAH9B,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,7 +34,7 @@ export type AgentEventData = {
     type: AgentEvent.Error;
     message: string;
     error: unknown;
-    source?: 'observer' | 'reflector';
+    source?: 'observer' | 'reflector' | 'episodic-memory';
 };
 export type AgentEventHandler = (data: AgentEventData) => void;
 export interface AgentMiddleware {

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

@@ -1,8 +1,9 @@
-import type { ModelConfig } from './agent';
+import type { ExecutionOptions, ModelConfig } from './agent';
 import type { BuiltEval } from './eval';
 import type { BuiltGuardrail } from './guardrail';
 import type { CheckpointStore } from './memory';
 import type { BuiltProviderTool, BuiltTool } from './tool';
+import type { RuntimeSkill, RuntimeSkillSource } from '../../skills';
 export interface AgentBuilder {
     model(providerOrIdOrConfig: string | ModelConfig, modelName?: string): this;
     instructions(text: string): this;
@@ -12,6 +13,7 @@ export interface AgentBuilder {
             topK?: number;
         };
     }): this;
+    skills(sourceOrSkills: RuntimeSkillSource | RuntimeSkill[]): this;
     providerTool(t: BuiltProviderTool): this;
     thinking(provider: string, config?: Record<string, unknown>): this;
     toolCallConcurrency(n: number): this;
@@ -24,4 +26,5 @@ export interface AgentBuilder {
     structuredOutput(schema: unknown): this;
     telemetry(t: unknown): this;
     mcp(client: unknown): this;
+    configuration(options: ExecutionOptions): this;
 }

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

@@ -8,7 +8,7 @@ import type { AgentEvent, AgentEventHandler } from '../runtime/event';
 import type { SerializedMessageList } from '../runtime/message-list';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONValue } from '../utils/json';
-export type FinishReason = 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other';
+export type FinishReason = 'stop' | 'max-iterations' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other';
 export type TokenUsage<T extends Record<string, unknown> = Record<string, unknown>> = {
     promptTokens: number;
     completionTokens: number;
@@ -212,6 +212,7 @@ export interface SerializableAgentState {
     finishReason?: FinishReason;
     usage?: TokenUsage;
     executionOptions?: PersistedExecutionOptions;
+    iterationCount?: number;
 }
 export type AgentPersistenceOptions = {
     threadId: string;

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

@@ -1,6 +1,7 @@
-import type { ModelConfig, SerializableAgentState } from './agent';
+import type { EmbeddingModel } from 'ai';
+import type { AgentExecutionCounter, ModelConfig, SerializableAgentState } from './agent';
 import type { AgentDbMessage } from './message';
-import type { BuiltObservationLogStore, ObservationLogObserveFn, ObservationLogReflectFn } from './observation-log';
+import type { BuiltObservationLogStore, ObservationLogEntry, ObservationLogObserveFn, ObservationLogReflectFn, ObservationLogScope } from './observation-log';
 import type { JSONObject } from '../utils/json';
 export interface MemoryDescriptor<TParams extends JSONObject = JSONObject> {
     name: string;
@@ -61,6 +62,7 @@ export interface BuiltMemory {
         id: string;
         score: number;
     }>>;
+    episodic?: EpisodicMemoryMethods;
     close?(): Promise<void>;
     describe(): MemoryDescriptor;
 }
@@ -74,6 +76,154 @@ export interface SemanticRecallConfig {
     embedder?: string;
     apiKey?: string;
 }
+export type EpisodicMemoryStatus = 'active' | 'superseded' | 'dropped';
+export interface EpisodicMemoryScope {
+    resourceId: string;
+}
+export interface EpisodicMemoryEntry {
+    id: string;
+    resourceId: string;
+    content: string;
+    contentHash: string;
+    status: EpisodicMemoryStatus;
+    supersededBy: string | null;
+    embedding?: number[];
+    embeddingModel?: string;
+    metadata?: JSONObject | null;
+    createdAt: Date;
+    updatedAt: Date;
+    lastSeenAt: Date;
+}
+export type NewEpisodicMemoryEntry = Omit<EpisodicMemoryEntry, 'id' | 'contentHash' | 'status' | 'supersededBy' | 'createdAt' | 'updatedAt' | 'lastSeenAt'> & {
+    contentHash?: string;
+    createdAt?: Date;
+    lastSeenAt?: Date;
+};
+export interface EpisodicMemoryEntrySource {
+    id: string;
+    memoryEntryId: string;
+    observationId: string;
+    threadId: string;
+    evidenceText: string;
+    createdAt: Date;
+}
+export type NewEpisodicMemoryEntrySource = Omit<EpisodicMemoryEntrySource, 'id' | 'createdAt'> & {
+    createdAt?: Date;
+};
+export type NewEpisodicMemoryEntrySourceForEntry = Omit<NewEpisodicMemoryEntrySource, 'memoryEntryId'>;
+export interface EpisodicMemoryCursor extends ObservationLogScope {
+    lastIndexedObservationId: string;
+    lastIndexedObservationCreatedAt: Date;
+    updatedAt: Date;
+}
+export type NewEpisodicMemoryCursor = Omit<EpisodicMemoryCursor, 'updatedAt'> & {
+    updatedAt?: Date;
+};
+export interface RetrievedEpisodicMemoryEntry extends EpisodicMemoryEntry {
+    lexicalScore: number;
+    vectorScore: number;
+    rrfScore: number;
+    finalScore: number;
+}
+export interface EpisodicMemorySearchOptions {
+    topK?: number;
+    queryEmbedding?: number[];
+    includeStatuses?: EpisodicMemoryStatus[];
+}
+export interface EpisodicMemoryTaskLockHandle {
+    resourceId: string;
+    holderId: string;
+    heldUntil: Date;
+}
+export interface EpisodicMemoryTaskLockMethods {
+    acquire(resourceId: string, opts: {
+        ttlMs: number;
+        holderId: string;
+    }): Promise<EpisodicMemoryTaskLockHandle | null>;
+    release(handle: EpisodicMemoryTaskLockHandle): Promise<void>;
+}
+export interface EpisodicMemoryMethods {
+    saveEntryWithSources(entry: NewEpisodicMemoryEntry, sources: NewEpisodicMemoryEntrySourceForEntry[]): Promise<EpisodicMemoryEntry | null>;
+    searchEntries(scope: EpisodicMemoryScope, query: string, opts?: EpisodicMemorySearchOptions): Promise<RetrievedEpisodicMemoryEntry[]>;
+    getEntrySources(entryIds: string[]): Promise<EpisodicMemoryEntrySource[]>;
+    applyReflection(scope: EpisodicMemoryScope, reflection: EpisodicMemoryReflectionApply): Promise<EpisodicMemoryReflectionResult>;
+    getCursor(scope: ObservationLogScope): Promise<EpisodicMemoryCursor | null>;
+    setCursor(cursor: NewEpisodicMemoryCursor): Promise<void>;
+    taskLock?: EpisodicMemoryTaskLockMethods;
+}
+export interface BuiltEpisodicMemoryStore {
+    episodic: EpisodicMemoryMethods;
+}
+export interface EpisodicMemoryExtractionCandidate {
+    content: string;
+    sources: Array<{
+        observationId: string;
+        evidence: string;
+    }>;
+}
+export interface EpisodicMemoryExtractorInput {
+    scope: EpisodicMemoryScope;
+    observationScope: ObservationLogScope;
+    now: Date;
+    observations: ObservationLogEntry[];
+    renderedObservations: string;
+    existingEntries: RetrievedEpisodicMemoryEntry[];
+    executionCounter?: AgentExecutionCounter;
+}
+export interface EpisodicMemoryExtraction {
+    entries: EpisodicMemoryExtractionCandidate[];
+}
+export type EpisodicMemoryExtractFn = (input: EpisodicMemoryExtractorInput) => Promise<EpisodicMemoryExtraction>;
+export interface EpisodicMemoryReflectionMerge {
+    supersedes: string[];
+    content: string;
+}
+export interface EpisodicMemoryReflection {
+    drop: string[];
+    merge: EpisodicMemoryReflectionMerge[];
+}
+export interface EpisodicMemoryReflectorInput {
+    scope: EpisodicMemoryScope;
+    now: Date;
+    seedEntryIds: string[];
+    entries: RetrievedEpisodicMemoryEntry[];
+    sources: EpisodicMemoryEntrySource[];
+    executionCounter?: AgentExecutionCounter;
+}
+export type EpisodicMemoryReflectFn = (input: EpisodicMemoryReflectorInput) => Promise<EpisodicMemoryReflection>;
+export interface EpisodicMemoryReflectionApplyMerge {
+    supersedes: string[];
+    entry: NewEpisodicMemoryEntry;
+}
+export interface EpisodicMemoryReflectionApply {
+    drop: string[];
+    merge: EpisodicMemoryReflectionApplyMerge[];
+}
+export interface EpisodicMemoryReflectionResult {
+    droppedIds: string[];
+    supersededIds: string[];
+    inserted: EpisodicMemoryEntry[];
+}
+export interface EpisodicMemoryPrompts {
+    extraction?: string;
+    reflection?: string;
+    recallToolInstruction?: string;
+}
+export interface EpisodicMemoryEmbeddingProviderOptions {
+    apiKey?: string;
+    baseURL?: string;
+}
+export interface EpisodicMemoryConfig {
+    enabled?: boolean;
+    topK?: number;
+    maxEntriesPerRun?: number;
+    embedder?: EmbeddingModel;
+    embeddingModel?: string;
+    embeddingProviderOptions?: string | EpisodicMemoryEmbeddingProviderOptions;
+    extract?: EpisodicMemoryExtractFn;
+    reflect?: EpisodicMemoryReflectFn;
+    prompts?: EpisodicMemoryPrompts;
+}
 export interface TitleGenerationConfig {
     model?: ModelConfig;
     instructions?: string;
@@ -96,6 +246,7 @@ interface MemoryConfigBase {
     lastMessages: number;
     observationLog?: ObservationLogMemoryConfig;
     semanticRecall?: SemanticRecallConfig;
+    episodicMemory?: EpisodicMemoryConfig;
     titleGeneration?: TitleGenerationConfig;
 }
 export type MemoryConfig = (MemoryConfigBase & {