@mastra/memory 0.0.0-error-handler-fix-20251020202607 → 0.0.0-esbuild-bundle-worker-20260807182016
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +4656 -3
- package/LICENSE.md +15 -0
- package/README.md +26 -1
- package/dist/_types/@internal_ai-sdk-v4/dist/index.d.ts +7450 -0
- package/dist/docs/SKILL.md +62 -0
- package/dist/docs/assets/SOURCE_MAP.json +11 -0
- package/dist/docs/references/docs-agents-agent-approval.md +664 -0
- package/dist/docs/references/docs-agents-networks.md +184 -0
- package/dist/docs/references/docs-capabilities-subagents.md +454 -0
- package/dist/docs/references/docs-evals-evals-with-memory.md +146 -0
- package/dist/docs/references/docs-long-running-agents-background-tasks.md +382 -0
- package/dist/docs/references/docs-long-running-agents-goals.md +118 -0
- package/dist/docs/references/docs-memory-memory-processors.md +385 -0
- package/dist/docs/references/docs-memory-message-history.md +348 -0
- package/dist/docs/references/docs-memory-multi-user-threads.md +208 -0
- package/dist/docs/references/docs-memory-observational-memory.md +835 -0
- package/dist/docs/references/docs-memory-overview.md +266 -0
- package/dist/docs/references/docs-memory-semantic-recall.md +401 -0
- package/dist/docs/references/docs-memory-working-memory.md +431 -0
- package/dist/docs/references/docs-storage-overview.md +214 -0
- package/dist/docs/references/reference-core-getMemory.md +51 -0
- package/dist/docs/references/reference-core-listMemory.md +57 -0
- package/dist/docs/references/reference-file-based-agents-memory.md +58 -0
- package/dist/docs/references/reference-memory-clone-utilities.md +203 -0
- package/dist/docs/references/reference-memory-cloneThread.md +173 -0
- package/dist/docs/references/reference-memory-createThread.md +70 -0
- package/dist/docs/references/reference-memory-getThreadById.md +26 -0
- package/dist/docs/references/reference-memory-listThreads.md +147 -0
- package/dist/docs/references/reference-memory-memory-class.md +148 -0
- package/dist/docs/references/reference-memory-observational-memory.md +877 -0
- package/dist/docs/references/reference-memory-summarizeConversation.md +99 -0
- package/dist/docs/references/reference-memory-summarizeThread.md +93 -0
- package/dist/docs/references/reference-processors-token-limiter-processor.md +158 -0
- package/dist/docs/references/reference-storage-dsql.md +430 -0
- package/dist/docs/references/reference-storage-dynamodb.md +284 -0
- package/dist/docs/references/reference-storage-libsql.md +143 -0
- package/dist/docs/references/reference-storage-mongodb.md +267 -0
- package/dist/docs/references/reference-storage-postgresql.md +531 -0
- package/dist/docs/references/reference-storage-redis.md +268 -0
- package/dist/docs/references/reference-storage-upstash.md +162 -0
- package/dist/docs/references/reference-vectors-libsql.md +307 -0
- package/dist/docs/references/reference-vectors-mongodb.md +567 -0
- package/dist/docs/references/reference-vectors-pg.md +430 -0
- package/dist/docs/references/reference-vectors-upstash.md +296 -0
- package/dist/index.cjs +35 -893
- package/dist/index.d.ts +465 -62
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -887
- package/dist/processors/index.cjs +32 -165
- package/dist/processors/index.d.ts +1 -2
- package/dist/processors/index.d.ts.map +1 -1
- package/dist/processors/index.js +2 -158
- package/dist/processors/observational-memory/activation-ttl.d.ts +4 -0
- package/dist/processors/observational-memory/activation-ttl.d.ts.map +1 -0
- package/dist/processors/observational-memory/anchor-ids.d.ts +4 -0
- package/dist/processors/observational-memory/anchor-ids.d.ts.map +1 -0
- package/dist/processors/observational-memory/buffering-coordinator.d.ts +61 -0
- package/dist/processors/observational-memory/buffering-coordinator.d.ts.map +1 -0
- package/dist/processors/observational-memory/built-in-extractors.d.ts +15 -0
- package/dist/processors/observational-memory/built-in-extractors.d.ts.map +1 -0
- package/dist/processors/observational-memory/constants.d.ts +74 -0
- package/dist/processors/observational-memory/constants.d.ts.map +1 -0
- package/dist/processors/observational-memory/date-utils.d.ts +41 -0
- package/dist/processors/observational-memory/date-utils.d.ts.map +1 -0
- package/dist/processors/observational-memory/debug.d.ts +3 -0
- package/dist/processors/observational-memory/debug.d.ts.map +1 -0
- package/dist/processors/observational-memory/extracted-values.d.ts +44 -0
- package/dist/processors/observational-memory/extracted-values.d.ts.map +1 -0
- package/dist/processors/observational-memory/extraction-runner.d.ts +22 -0
- package/dist/processors/observational-memory/extraction-runner.d.ts.map +1 -0
- package/dist/processors/observational-memory/extractor.d.ts +76 -0
- package/dist/processors/observational-memory/extractor.d.ts.map +1 -0
- package/dist/processors/observational-memory/index.d.ts +30 -0
- package/dist/processors/observational-memory/index.d.ts.map +1 -0
- package/dist/processors/observational-memory/internal-request-context.d.ts +17 -0
- package/dist/processors/observational-memory/internal-request-context.d.ts.map +1 -0
- package/dist/processors/observational-memory/markers.d.ts +118 -0
- package/dist/processors/observational-memory/markers.d.ts.map +1 -0
- package/dist/processors/observational-memory/message-utils.d.ts +83 -0
- package/dist/processors/observational-memory/message-utils.d.ts.map +1 -0
- package/dist/processors/observational-memory/model-by-input-tokens.d.ts +14 -0
- package/dist/processors/observational-memory/model-by-input-tokens.d.ts.map +1 -0
- package/dist/processors/observational-memory/model-context.d.ts +2 -0
- package/dist/processors/observational-memory/model-context.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-groups.d.ts +15 -0
- package/dist/processors/observational-memory/observation-groups.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-strategies/async-buffer.d.ts +39 -0
- package/dist/processors/observational-memory/observation-strategies/async-buffer.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-strategies/base.d.ts +122 -0
- package/dist/processors/observational-memory/observation-strategies/base.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-strategies/index.d.ts +7 -0
- package/dist/processors/observational-memory/observation-strategies/index.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-strategies/resource-scoped.d.ts +43 -0
- package/dist/processors/observational-memory/observation-strategies/resource-scoped.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-strategies/sync.d.ts +41 -0
- package/dist/processors/observational-memory/observation-strategies/sync.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-strategies/types.d.ts +103 -0
- package/dist/processors/observational-memory/observation-strategies/types.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-turn/index.d.ts +4 -0
- package/dist/processors/observational-memory/observation-turn/index.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-turn/load-memory-context.d.ts +9 -0
- package/dist/processors/observational-memory/observation-turn/load-memory-context.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-turn/step.d.ts +53 -0
- package/dist/processors/observational-memory/observation-turn/step.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-turn/turn.d.ts +139 -0
- package/dist/processors/observational-memory/observation-turn/turn.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-turn/types.d.ts +46 -0
- package/dist/processors/observational-memory/observation-turn/types.d.ts.map +1 -0
- package/dist/processors/observational-memory/observation-utils.d.ts +16 -0
- package/dist/processors/observational-memory/observation-utils.d.ts.map +1 -0
- package/dist/processors/observational-memory/observational-memory.d.ts +930 -0
- package/dist/processors/observational-memory/observational-memory.d.ts.map +1 -0
- package/dist/processors/observational-memory/observer-agent.d.ts +190 -0
- package/dist/processors/observational-memory/observer-agent.d.ts.map +1 -0
- package/dist/processors/observational-memory/observer-runner.d.ts +141 -0
- package/dist/processors/observational-memory/observer-runner.d.ts.map +1 -0
- package/dist/processors/observational-memory/operation-registry.d.ts +14 -0
- package/dist/processors/observational-memory/operation-registry.d.ts.map +1 -0
- package/dist/processors/observational-memory/processor.d.ts +70 -0
- package/dist/processors/observational-memory/processor.d.ts.map +1 -0
- package/dist/processors/observational-memory/reflector-agent.d.ts +62 -0
- package/dist/processors/observational-memory/reflector-agent.d.ts.map +1 -0
- package/dist/processors/observational-memory/reflector-runner.d.ts +133 -0
- package/dist/processors/observational-memory/reflector-runner.d.ts.map +1 -0
- package/dist/processors/observational-memory/repro-capture.d.ts +33 -0
- package/dist/processors/observational-memory/repro-capture.d.ts.map +1 -0
- package/dist/processors/observational-memory/retry.d.ts +63 -0
- package/dist/processors/observational-memory/retry.d.ts.map +1 -0
- package/dist/processors/observational-memory/string-utils.d.ts +13 -0
- package/dist/processors/observational-memory/string-utils.d.ts.map +1 -0
- package/dist/processors/observational-memory/summarize.d.ts +92 -0
- package/dist/processors/observational-memory/summarize.d.ts.map +1 -0
- package/dist/processors/observational-memory/temporal-markers.d.ts +4 -0
- package/dist/processors/observational-memory/temporal-markers.d.ts.map +1 -0
- package/dist/processors/observational-memory/temporary-memory.d.ts +8 -0
- package/dist/processors/observational-memory/temporary-memory.d.ts.map +1 -0
- package/dist/processors/observational-memory/thresholds.d.ts +52 -0
- package/dist/processors/observational-memory/thresholds.d.ts.map +1 -0
- package/dist/processors/observational-memory/token-counter.d.ts +57 -0
- package/dist/processors/observational-memory/token-counter.d.ts.map +1 -0
- package/dist/processors/observational-memory/tool-result-helpers.d.ts +12 -0
- package/dist/processors/observational-memory/tool-result-helpers.d.ts.map +1 -0
- package/dist/processors/observational-memory/tracing.d.ts +17 -0
- package/dist/processors/observational-memory/tracing.d.ts.map +1 -0
- package/dist/processors/observational-memory/types.d.ts +997 -0
- package/dist/processors/observational-memory/types.d.ts.map +1 -0
- package/dist/processors/observational-memory/working-memory-extractor.d.ts +5 -0
- package/dist/processors/observational-memory/working-memory-extractor.d.ts.map +1 -0
- package/dist/processors/working-memory-state/index.d.ts +2 -0
- package/dist/processors/working-memory-state/index.d.ts.map +1 -0
- package/dist/processors/working-memory-state/processor.d.ts +53 -0
- package/dist/processors/working-memory-state/processor.d.ts.map +1 -0
- package/dist/src-C1tlhGeW.js +28559 -0
- package/dist/src-C1tlhGeW.js.map +1 -0
- package/dist/src-DqoifKIy.cjs +28813 -0
- package/dist/src-DqoifKIy.cjs.map +1 -0
- package/dist/tools/om-tools.d.ts +172 -0
- package/dist/tools/om-tools.d.ts.map +1 -0
- package/dist/tools/working-memory.d.ts +33 -28
- package/dist/tools/working-memory.d.ts.map +1 -1
- package/package.json +36 -28
- package/dist/index.cjs.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/processors/index.cjs.map +0 -1
- package/dist/processors/index.js.map +0 -1
- package/dist/processors/token-limiter.d.ts +0 -32
- package/dist/processors/token-limiter.d.ts.map +0 -1
- package/dist/processors/tool-call-filter.d.ts +0 -20
- package/dist/processors/tool-call-filter.d.ts.map +0 -1
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { ProcessorContext } from '@mastra/core/processors';
|
|
2
|
+
import type { RequestContext } from '@mastra/core/request-context';
|
|
3
|
+
import type { Memory } from '../../index.js';
|
|
4
|
+
import type { Extractor, ExtractorSource } from './extractor.js';
|
|
5
|
+
export interface ExtractedValueMetadata {
|
|
6
|
+
currentTask?: string;
|
|
7
|
+
suggestedResponse?: string;
|
|
8
|
+
threadTitle?: string;
|
|
9
|
+
extracted?: Record<string, unknown>;
|
|
10
|
+
}
|
|
11
|
+
export interface ExtractionFailure {
|
|
12
|
+
slug: string;
|
|
13
|
+
error: string;
|
|
14
|
+
}
|
|
15
|
+
export interface ExtractedBuiltInValues {
|
|
16
|
+
currentTask?: string;
|
|
17
|
+
suggestedContinuation?: string;
|
|
18
|
+
threadTitle?: string;
|
|
19
|
+
}
|
|
20
|
+
export declare function normalizeExtractedValues(values?: Record<string, unknown>): Record<string, unknown> | undefined;
|
|
21
|
+
export declare function mergeExtractedValues(...valueSets: Array<Record<string, unknown> | undefined>): Record<string, unknown> | undefined;
|
|
22
|
+
export declare function mergeExtractionFailures(...failureSets: Array<ExtractionFailure[] | undefined>): ExtractionFailure[] | undefined;
|
|
23
|
+
export declare function getPriorExtractedValues(metadata?: ExtractedValueMetadata, extractors?: readonly Extractor<any>[]): Record<string, unknown> | undefined;
|
|
24
|
+
export declare function buildExtractedValueContextSections(extractors: readonly Extractor<any>[], values?: Record<string, unknown>): string[];
|
|
25
|
+
export declare function getBuiltInExtractedValues(values?: Record<string, unknown>): ExtractedBuiltInValues;
|
|
26
|
+
export declare function filterUserExtractedValues(values?: Record<string, unknown>, extractors?: readonly Extractor<any>[]): Record<string, unknown> | undefined;
|
|
27
|
+
export declare function buildThreadMetadataFromExtractedValues(extractors: readonly Extractor<any>[], values?: Record<string, unknown>): ExtractedValueMetadata;
|
|
28
|
+
export declare function applyExtractorHooks(opts: {
|
|
29
|
+
source: ExtractorSource;
|
|
30
|
+
extractors: readonly Extractor<any>[];
|
|
31
|
+
values?: Record<string, unknown>;
|
|
32
|
+
failures?: ExtractionFailure[];
|
|
33
|
+
previousValues?: Record<string, unknown>;
|
|
34
|
+
threadId: string;
|
|
35
|
+
resourceId?: string;
|
|
36
|
+
mainAgent?: ProcessorContext['agent'];
|
|
37
|
+
memory?: Memory;
|
|
38
|
+
sendSignal?: ProcessorContext['sendSignal'];
|
|
39
|
+
requestContext?: RequestContext;
|
|
40
|
+
}): Promise<{
|
|
41
|
+
values?: Record<string, unknown>;
|
|
42
|
+
failures?: ExtractionFailure[];
|
|
43
|
+
}>;
|
|
44
|
+
//# sourceMappingURL=extracted-values.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"extracted-values.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/extracted-values.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { Agent, AgentMemoryOption } from '@mastra/core/agent';
|
|
2
|
+
import type { ObservabilityContext } from '@mastra/core/observability';
|
|
3
|
+
import type { RequestContext } from '@mastra/core/request-context';
|
|
4
|
+
import type { Extractor, ExtractorSource } from './extractor.js';
|
|
5
|
+
export interface StructuredExtractionResult {
|
|
6
|
+
values: Record<string, unknown>;
|
|
7
|
+
failures: Array<{
|
|
8
|
+
slug: string;
|
|
9
|
+
error: string;
|
|
10
|
+
}>;
|
|
11
|
+
}
|
|
12
|
+
export declare function extractStructuredValues(opts: {
|
|
13
|
+
agent: Agent<any, any, any, any>;
|
|
14
|
+
source: ExtractorSource;
|
|
15
|
+
extractors?: readonly Extractor<any>[];
|
|
16
|
+
memory?: AgentMemoryOption;
|
|
17
|
+
priorExtractedValues?: Record<string, unknown>;
|
|
18
|
+
requestContext?: RequestContext;
|
|
19
|
+
observabilityContext?: ObservabilityContext;
|
|
20
|
+
abortSignal?: AbortSignal;
|
|
21
|
+
}): Promise<StructuredExtractionResult>;
|
|
22
|
+
//# sourceMappingURL=extraction-runner.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"extraction-runner.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/extraction-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9D,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAmBD,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAuGtC"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import type { ProcessorContext } from '@mastra/core/processors';
|
|
2
|
+
import type { RequestContext } from '@mastra/core/request-context';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import type { Memory } from '../../index.js';
|
|
5
|
+
type ExtractorMode = 'inline' | 'structured';
|
|
6
|
+
export type ExtractorSource = 'observer' | 'reflector';
|
|
7
|
+
export interface ExtractorRuntimeContext {
|
|
8
|
+
source: ExtractorSource;
|
|
9
|
+
threadId?: string;
|
|
10
|
+
resourceId?: string;
|
|
11
|
+
mainAgent?: ProcessorContext['agent'];
|
|
12
|
+
memory?: Memory;
|
|
13
|
+
requestContext?: RequestContext;
|
|
14
|
+
}
|
|
15
|
+
export interface ExtractorOnExtractedContext<T = unknown> extends ExtractorRuntimeContext {
|
|
16
|
+
extractor: Extractor<T>;
|
|
17
|
+
threadId: string;
|
|
18
|
+
previous?: T;
|
|
19
|
+
current: T;
|
|
20
|
+
sendSignal?: ProcessorContext['sendSignal'];
|
|
21
|
+
}
|
|
22
|
+
type MaybePromise<T> = T | Promise<T>;
|
|
23
|
+
type ExtractorConfigValue<TValue> = TValue | ((context: ExtractorRuntimeContext) => MaybePromise<TValue>);
|
|
24
|
+
export interface ExtractorConfig<T = unknown> {
|
|
25
|
+
/** Human-readable extractor name. Converted to a stable kebab-case slug for XML tags and metadata keys. */
|
|
26
|
+
name: string;
|
|
27
|
+
/** Instructions describing what this extractor should return. */
|
|
28
|
+
instructions: ExtractorConfigValue<string>;
|
|
29
|
+
/** Zod schema used for structured extraction. Omit to extract an inline string value from the observer/reflector output. */
|
|
30
|
+
schema?: ExtractorConfigValue<z.ZodType<T> | undefined>;
|
|
31
|
+
/** Whether the previous extraction should be shown to the extractor prompt. Defaults to true. */
|
|
32
|
+
includePreviousExtraction?: boolean;
|
|
33
|
+
/** Dot-separated OM metadata path for persistence. Defaults to `extracted.<slug>`. Set false to skip OM metadata persistence. */
|
|
34
|
+
metadataKeyPath?: string | false;
|
|
35
|
+
/** Optional lifecycle hook invoked after a value is parsed and before it is persisted. */
|
|
36
|
+
onExtracted?: (context: ExtractorOnExtractedContext<T>) => Promise<T | void | undefined> | T | void | undefined;
|
|
37
|
+
/** Retry with JSON prompt injection when native structured output returns an empty object. */
|
|
38
|
+
retryStructuredExtractionOnEmptyObject?: boolean;
|
|
39
|
+
}
|
|
40
|
+
export declare const BUILT_IN_EXTRACTOR_SLUGS: readonly string[];
|
|
41
|
+
export type BuiltInExtractorSlug = (typeof BUILT_IN_EXTRACTOR_SLUGS)[number];
|
|
42
|
+
export declare function isBuiltInExtractorSlug(slug: string): slug is BuiltInExtractorSlug;
|
|
43
|
+
export declare function slugifyExtractorName(name: string): string;
|
|
44
|
+
export declare class Extractor<T = unknown> {
|
|
45
|
+
readonly name: string;
|
|
46
|
+
readonly slug: string;
|
|
47
|
+
readonly instructions: string;
|
|
48
|
+
readonly schema: z.ZodType<T>;
|
|
49
|
+
readonly mode: ExtractorMode;
|
|
50
|
+
readonly includePreviousExtraction: boolean;
|
|
51
|
+
readonly metadataKeyPath: string | false;
|
|
52
|
+
readonly onExtracted?: ExtractorConfig<T>['onExtracted'];
|
|
53
|
+
readonly retryStructuredExtractionOnEmptyObject: boolean;
|
|
54
|
+
/** @internal */
|
|
55
|
+
readonly internal: boolean;
|
|
56
|
+
private readonly instructionsConfig;
|
|
57
|
+
private readonly schemaConfig?;
|
|
58
|
+
constructor(config: ExtractorConfig<T>, internal?: boolean);
|
|
59
|
+
resolve(context: ExtractorRuntimeContext): Promise<Extractor<T>>;
|
|
60
|
+
}
|
|
61
|
+
export declare function resolveExtractors(extractors: readonly Extractor<any>[], context: ExtractorRuntimeContext): Promise<Extractor<any>[]>;
|
|
62
|
+
export declare function validateExtractorList(extractors: readonly Extractor<any>[]): Extractor<any>[];
|
|
63
|
+
export declare function parseExtractorValue<T>(extractor: Extractor<T>, raw: string): T;
|
|
64
|
+
export interface ParsedExtractedValues {
|
|
65
|
+
values: Record<string, unknown>;
|
|
66
|
+
failures: Array<{
|
|
67
|
+
slug: string;
|
|
68
|
+
error: string;
|
|
69
|
+
}>;
|
|
70
|
+
}
|
|
71
|
+
export declare function parseExtractedValues(output: string, extractors: readonly Extractor<any>[]): ParsedExtractedValues;
|
|
72
|
+
export declare function stripExtractorSections(output: string, extractors: readonly Extractor<any>[]): string;
|
|
73
|
+
export declare function buildExtractorOutputSections(extractors: readonly Extractor<any>[]): string;
|
|
74
|
+
export declare function buildExtractorPriorLines(extractors: readonly Extractor<any>[], priorExtractedValues?: Record<string, unknown>): string[];
|
|
75
|
+
export {};
|
|
76
|
+
//# sourceMappingURL=extractor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/extractor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Observational Memory (OM)
|
|
3
|
+
*
|
|
4
|
+
* A memory system that keeps agents performant across long conversations by:
|
|
5
|
+
* 1. Automatically compressing turn-based message history into structured observations
|
|
6
|
+
* 2. Reflecting on observations when they grow too large
|
|
7
|
+
*
|
|
8
|
+
* Three-agent architecture:
|
|
9
|
+
* - Actor: The main agent, sees observations + recent unobserved messages
|
|
10
|
+
* - Observer: Extracts observations when history exceeds threshold
|
|
11
|
+
* - Reflector: Condenses observations when they exceed threshold
|
|
12
|
+
*/
|
|
13
|
+
export { ObservationalMemory } from './observational-memory.js';
|
|
14
|
+
export { OBSERVATIONAL_MEMORY_DEFAULTS, OBSERVATION_CONTINUATION_HINT, OBSERVATION_CONTEXT_PROMPT, OBSERVATION_CONTEXT_INSTRUCTIONS, } from './constants.js';
|
|
15
|
+
export { ObservationalMemoryProcessor } from './processor.js';
|
|
16
|
+
export type { MemoryContextProvider } from './processor.js';
|
|
17
|
+
export { getObservationsAsOf } from './observation-utils.js';
|
|
18
|
+
export { ModelByInputTokens, type ModelByInputTokensConfig } from './model-by-input-tokens.js';
|
|
19
|
+
export { Extractor } from './extractor.js';
|
|
20
|
+
export type { ExtractorConfig, ExtractorOnExtractedContext, ExtractorRuntimeContext, ExtractorSource, } from './extractor.js';
|
|
21
|
+
export { WorkingMemoryExtractor } from './working-memory-extractor.js';
|
|
22
|
+
export { summarizeConversation } from './summarize.js';
|
|
23
|
+
export type { SummarizeConversationOptions, SummarizeConversationResult, SummarizeModel } from './summarize.js';
|
|
24
|
+
export type { ObservationalMemoryConfig, ObservationDebugEvent, ObserveHooks, ObserveHookContext, ObserveHookUsage, ObserveTrigger, ObservationConfig, ReflectionConfig, ObserverResult, ReflectorResult, ObservationMarkerConfig, DataOmObservationStartPart, DataOmObservationEndPart, DataOmObservationFailedPart, DataOmStatusPart, DataOmThreadUpdatePart, DataOmObservationPart, DataOmBufferingStartPart, DataOmBufferingEndPart, DataOmBufferingFailedPart, DataOmBufferingPart, DataOmActivationPart, DataOmPart, } from './types.js';
|
|
25
|
+
export { OBSERVER_SYSTEM_PROMPT, buildObserverSystemPrompt, buildObserverPrompt, parseObserverOutput, optimizeObservationsForContext, formatMessagesForObserver, hasCurrentTaskSection, extractCurrentTask, type ObserverResult as ObserverAgentResult, } from './observer-agent.js';
|
|
26
|
+
export type { ObservationalMemoryRecord, ObservationalMemoryScope, ObservationalMemoryOriginType, CreateObservationalMemoryInput, UpdateActiveObservationsInput, UpdateBufferedObservationsInput, CreateReflectionGenerationInput, } from '@mastra/core/storage';
|
|
27
|
+
export { TokenCounter } from './token-counter.js';
|
|
28
|
+
export { injectAnchorIds, stripEphemeralAnchorIds, parseAnchorId } from './anchor-ids.js';
|
|
29
|
+
export { parseObservationGroups, stripObservationGroups, wrapInObservationGroup, renderObservationGroupsForReflection, reconcileObservationGroupsFromReflection, deriveObservationGroupProvenance, combineObservationGroupRanges, type ObservationGroup, } from './observation-groups.js';
|
|
30
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,gCAAgC,GACjC,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,eAAe,EACf,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7G,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EAEf,uBAAuB,EAEvB,0BAA0B,EAC1B,wBAAwB,EACxB,2BAA2B,EAC3B,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EAErB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EAEnB,oBAAoB,EACpB,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,cAAc,IAAI,mBAAmB,GAC3C,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,oCAAoC,EACpC,wCAAwC,EACxC,gCAAgC,EAChC,6BAA6B,EAC7B,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { RequestContext } from '@mastra/core/request-context';
|
|
2
|
+
/**
|
|
3
|
+
* OM observer/reflector agents are implementation-detail agents invoked from
|
|
4
|
+
* inside a parent agent run. They should keep request-scoped values such as
|
|
5
|
+
* auth, versions, routing hints, and resource id, but they must not present as
|
|
6
|
+
* another run on the parent thread or core's cross-agent thread wait can block
|
|
7
|
+
* on the parent run that is waiting for OM to complete.
|
|
8
|
+
*
|
|
9
|
+
* A fresh RequestContext clone is always returned so that memory-scoped writes
|
|
10
|
+
* made by the internal agent run (e.g. the `MastraMemory` entry that agent.generate
|
|
11
|
+
* sets from the observer's temporary `structured-observer` memory) cannot leak back
|
|
12
|
+
* into the parent's RequestContext. Without this isolation the parent's OM turn later
|
|
13
|
+
* reads the temporary observer's resourceId and injects a continuation message that
|
|
14
|
+
* fails MessageList's resourceId validation.
|
|
15
|
+
*/
|
|
16
|
+
export declare function withOmInternalThreadId(requestContext: RequestContext | undefined, omAgentId: string): RequestContext | undefined;
|
|
17
|
+
//# sourceMappingURL=internal-request-context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"internal-request-context.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/internal-request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEpF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,cAAc,GAAG,SAAS,EAC1C,SAAS,EAAE,MAAM,GAChB,cAAc,GAAG,SAAS,CAW5B"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
import type { DataOmActivationPart, DataOmBufferingEndPart, DataOmBufferingFailedPart, DataOmBufferingStartPart, DataOmObservationEndPart, DataOmObservationFailedPart, DataOmObservationStartPart, DataOmThreadUpdatePart, ObservationMarkerConfig, OmOperationType } from './types.js';
|
|
2
|
+
/**
|
|
3
|
+
* Create a start marker for when observation begins.
|
|
4
|
+
*/
|
|
5
|
+
export declare function createObservationStartMarker(params: {
|
|
6
|
+
cycleId: string;
|
|
7
|
+
operationType: 'observation' | 'reflection';
|
|
8
|
+
tokensToObserve: number;
|
|
9
|
+
recordId: string;
|
|
10
|
+
threadId: string;
|
|
11
|
+
threadIds: string[];
|
|
12
|
+
config: ObservationMarkerConfig;
|
|
13
|
+
}): DataOmObservationStartPart;
|
|
14
|
+
/**
|
|
15
|
+
* Create an end marker for when observation completes successfully.
|
|
16
|
+
*/
|
|
17
|
+
export declare function createObservationEndMarker(params: {
|
|
18
|
+
cycleId: string;
|
|
19
|
+
operationType: 'observation' | 'reflection';
|
|
20
|
+
startedAt: string;
|
|
21
|
+
tokensObserved: number;
|
|
22
|
+
observationTokens: number;
|
|
23
|
+
observations?: string;
|
|
24
|
+
currentTask?: string;
|
|
25
|
+
suggestedResponse?: string;
|
|
26
|
+
extractedValues?: Record<string, unknown>;
|
|
27
|
+
extractionFailures?: Array<{
|
|
28
|
+
slug: string;
|
|
29
|
+
error: string;
|
|
30
|
+
}>;
|
|
31
|
+
recordId: string;
|
|
32
|
+
threadId: string;
|
|
33
|
+
}): DataOmObservationEndPart;
|
|
34
|
+
/**
|
|
35
|
+
* Create a failed marker for when observation fails.
|
|
36
|
+
*/
|
|
37
|
+
export declare function createObservationFailedMarker(params: {
|
|
38
|
+
cycleId: string;
|
|
39
|
+
operationType: 'observation' | 'reflection';
|
|
40
|
+
startedAt: string;
|
|
41
|
+
tokensAttempted: number;
|
|
42
|
+
error: string;
|
|
43
|
+
recordId: string;
|
|
44
|
+
threadId: string;
|
|
45
|
+
}): DataOmObservationFailedPart;
|
|
46
|
+
/**
|
|
47
|
+
* Create a start marker for when async buffering begins.
|
|
48
|
+
*/
|
|
49
|
+
export declare function createBufferingStartMarker(params: {
|
|
50
|
+
cycleId: string;
|
|
51
|
+
operationType: OmOperationType;
|
|
52
|
+
tokensToBuffer: number;
|
|
53
|
+
recordId: string;
|
|
54
|
+
threadId: string;
|
|
55
|
+
threadIds: string[];
|
|
56
|
+
config: ObservationMarkerConfig;
|
|
57
|
+
}): DataOmBufferingStartPart;
|
|
58
|
+
/**
|
|
59
|
+
* Create an end marker for when async buffering completes successfully.
|
|
60
|
+
*/
|
|
61
|
+
export declare function createBufferingEndMarker(params: {
|
|
62
|
+
cycleId: string;
|
|
63
|
+
operationType: OmOperationType;
|
|
64
|
+
startedAt: string;
|
|
65
|
+
tokensBuffered: number;
|
|
66
|
+
bufferedTokens: number;
|
|
67
|
+
recordId: string;
|
|
68
|
+
threadId: string;
|
|
69
|
+
observations?: string;
|
|
70
|
+
extractedValues?: Record<string, unknown>;
|
|
71
|
+
extractionFailures?: Array<{
|
|
72
|
+
slug: string;
|
|
73
|
+
error: string;
|
|
74
|
+
}>;
|
|
75
|
+
}): DataOmBufferingEndPart;
|
|
76
|
+
/**
|
|
77
|
+
* Create a failed marker for when async buffering fails.
|
|
78
|
+
*/
|
|
79
|
+
export declare function createBufferingFailedMarker(params: {
|
|
80
|
+
cycleId: string;
|
|
81
|
+
operationType: OmOperationType;
|
|
82
|
+
startedAt: string;
|
|
83
|
+
tokensAttempted: number;
|
|
84
|
+
error: string;
|
|
85
|
+
recordId: string;
|
|
86
|
+
threadId: string;
|
|
87
|
+
}): DataOmBufferingFailedPart;
|
|
88
|
+
/**
|
|
89
|
+
* Create an activation marker for when buffered observations are activated.
|
|
90
|
+
*/
|
|
91
|
+
export declare function createActivationMarker(params: {
|
|
92
|
+
cycleId: string;
|
|
93
|
+
operationType: OmOperationType;
|
|
94
|
+
chunksActivated: number;
|
|
95
|
+
tokensActivated: number;
|
|
96
|
+
observationTokens: number;
|
|
97
|
+
messagesActivated: number;
|
|
98
|
+
recordId: string;
|
|
99
|
+
threadId: string;
|
|
100
|
+
generationCount: number;
|
|
101
|
+
observations?: string;
|
|
102
|
+
triggeredBy?: 'threshold' | 'ttl' | 'provider_change';
|
|
103
|
+
lastActivityAt?: number;
|
|
104
|
+
ttlExpiredMs?: number;
|
|
105
|
+
previousModel?: string;
|
|
106
|
+
currentModel?: string;
|
|
107
|
+
config: ObservationMarkerConfig;
|
|
108
|
+
}): DataOmActivationPart;
|
|
109
|
+
/**
|
|
110
|
+
* Create a thread update marker when the observer suggests a new thread title.
|
|
111
|
+
*/
|
|
112
|
+
export declare function createThreadUpdateMarker(params: {
|
|
113
|
+
cycleId: string;
|
|
114
|
+
threadId: string;
|
|
115
|
+
oldTitle?: string;
|
|
116
|
+
newTitle: string;
|
|
117
|
+
}): DataOmThreadUpdatePart;
|
|
118
|
+
//# sourceMappingURL=markers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/markers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import type { MastraDBMessage, MessageList } from '@mastra/core/agent';
|
|
2
|
+
import type { BufferedObservationChunk, ObservationalMemoryRecord } from '@mastra/core/storage';
|
|
3
|
+
/**
|
|
4
|
+
* Find the index of the last completed observation boundary (end marker) in a message's parts.
|
|
5
|
+
* Returns -1 if no completed observation is found.
|
|
6
|
+
*/
|
|
7
|
+
export declare function findLastCompletedObservationBoundary(message: MastraDBMessage): number;
|
|
8
|
+
/**
|
|
9
|
+
* Get unobserved parts from a message.
|
|
10
|
+
* If the message has a completed observation (start + end), only return parts after the end.
|
|
11
|
+
* If observation is in progress (start without end), include parts before the start.
|
|
12
|
+
* Otherwise, return all parts.
|
|
13
|
+
*/
|
|
14
|
+
export declare function getUnobservedParts(message: MastraDBMessage): MastraDBMessage['content']['parts'];
|
|
15
|
+
/**
|
|
16
|
+
* Check if a message has any unobserved parts.
|
|
17
|
+
*/
|
|
18
|
+
export declare function hasUnobservedParts(message: MastraDBMessage): boolean;
|
|
19
|
+
/**
|
|
20
|
+
* Compute a cursor pointing at the latest message by createdAt.
|
|
21
|
+
* Used to derive a stable observation boundary for replay pruning.
|
|
22
|
+
*/
|
|
23
|
+
export declare function getLastObservedMessageCursor(messages: MastraDBMessage[]): {
|
|
24
|
+
createdAt: string;
|
|
25
|
+
id: string;
|
|
26
|
+
} | undefined;
|
|
27
|
+
/**
|
|
28
|
+
* Check if a message is at or before a cursor (by createdAt then id).
|
|
29
|
+
*/
|
|
30
|
+
export declare function isMessageAtOrBeforeCursor(msg: MastraDBMessage, cursor: {
|
|
31
|
+
createdAt: string;
|
|
32
|
+
id: string;
|
|
33
|
+
}): boolean;
|
|
34
|
+
/**
|
|
35
|
+
* Get the messages Observational Memory is allowed to work with.
|
|
36
|
+
*
|
|
37
|
+
* Messages supplied through the `context` option are per-run ephemeral input. Core's
|
|
38
|
+
* persistence contract already treats them as never-persist: `MessageStateManager` routes
|
|
39
|
+
* them into `userContextMessages`, and `drainUnsavedMessages` only drains input/response.
|
|
40
|
+
*
|
|
41
|
+
* OM builds its windows from `get.all.db()`, which includes context messages, and then
|
|
42
|
+
* seals and persists candidates directly — turning ephemeral context into durable user
|
|
43
|
+
* messages. Excluding them here keeps OM's window, sealing, persistence and token
|
|
44
|
+
* accounting consistent with that contract.
|
|
45
|
+
*/
|
|
46
|
+
export declare function getObservableMessages(messageList: MessageList): MastraDBMessage[];
|
|
47
|
+
/**
|
|
48
|
+
* Safely extract buffered observation chunks from a record.
|
|
49
|
+
* Handles both array and JSON-string formats, returning empty array if malformed.
|
|
50
|
+
*/
|
|
51
|
+
/**
|
|
52
|
+
* Filter out already-observed messages from the in-memory context.
|
|
53
|
+
* Uses marker-boundary pruning (preferred) or record-based fallback.
|
|
54
|
+
*
|
|
55
|
+
* The `fallbackCursor` is optional — callers that need it should resolve it
|
|
56
|
+
* from thread metadata before calling this function.
|
|
57
|
+
*/
|
|
58
|
+
export declare function filterObservedMessages(opts: {
|
|
59
|
+
messageList: MessageList;
|
|
60
|
+
record?: ObservationalMemoryRecord;
|
|
61
|
+
useMarkerBoundaryPruning?: boolean;
|
|
62
|
+
fallbackCursor?: {
|
|
63
|
+
createdAt: string;
|
|
64
|
+
id: string;
|
|
65
|
+
};
|
|
66
|
+
preserveMessageIds?: Set<string>;
|
|
67
|
+
}): void;
|
|
68
|
+
export declare function getBufferedChunks(record: ObservationalMemoryRecord | null | undefined): BufferedObservationChunk[];
|
|
69
|
+
/**
|
|
70
|
+
* Sort threads by their oldest unobserved message.
|
|
71
|
+
* Returns thread IDs in order from oldest to most recent.
|
|
72
|
+
*/
|
|
73
|
+
/**
|
|
74
|
+
* Combine active and buffered observations for the buffering observer context.
|
|
75
|
+
*/
|
|
76
|
+
export declare function combineObservationsForBuffering(activeObservations: string | undefined, bufferedObservations: string | undefined): string | undefined;
|
|
77
|
+
export declare function sortThreadsByOldestMessage(messagesByThread: Map<string, MastraDBMessage[]>): string[];
|
|
78
|
+
/**
|
|
79
|
+
* Strip any thread tags that the Observer might have added.
|
|
80
|
+
* Thread attribution is handled externally by the system, not by the Observer.
|
|
81
|
+
*/
|
|
82
|
+
export declare function stripThreadTags(observations: string): string;
|
|
83
|
+
//# sourceMappingURL=message-utils.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"message-utils.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/message-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEhG;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAYrF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAoBhG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,eAAe,EAAE,GAC1B;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAS/C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAMlH;AA+FD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,eAAe,EAAE,CAKjF;AAED;;;GAGG;AACH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,cAAc,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC,GAAG,IAAI,CAoFP;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,wBAAwB,EAAE,CAYlH;AAED;;;GAGG;AACH;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,0BAA0B,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GAAG,MAAM,EAAE,CAQrG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAM5D"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { AgentConfig } from '@mastra/core/agent';
|
|
2
|
+
import type { MastraModelConfig } from '@mastra/core/llm';
|
|
3
|
+
type TieredModelTarget = MastraModelConfig;
|
|
4
|
+
export interface ModelByInputTokensConfig {
|
|
5
|
+
upTo: Record<number, TieredModelTarget>;
|
|
6
|
+
}
|
|
7
|
+
export declare class ModelByInputTokens {
|
|
8
|
+
private readonly thresholds;
|
|
9
|
+
constructor(config: ModelByInputTokensConfig);
|
|
10
|
+
resolve(inputTokens: number): AgentConfig['model'];
|
|
11
|
+
getThresholds(): number[];
|
|
12
|
+
}
|
|
13
|
+
export {};
|
|
14
|
+
//# sourceMappingURL=model-by-input-tokens.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"model-by-input-tokens.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/model-by-input-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,KAAK,iBAAiB,GAAG,iBAAiB,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACzC;AAyCD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwD;gBAEvE,MAAM,EAAE,wBAAwB;IAI5C,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC;IAclD,aAAa,IAAI,MAAM,EAAE;CAG1B"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"model-context.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/model-context.ts"],"names":[],"mappings":"AAoBA,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAalF"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
export interface ObservationGroup {
|
|
2
|
+
id: string;
|
|
3
|
+
range: string;
|
|
4
|
+
content: string;
|
|
5
|
+
kind?: string;
|
|
6
|
+
}
|
|
7
|
+
export declare function generateAnchorId(): string;
|
|
8
|
+
export declare function wrapInObservationGroup(observations: string, range: string, id?: string, _sourceGroupIds?: string[], kind?: string): string;
|
|
9
|
+
export declare function parseObservationGroups(observations: string): ObservationGroup[];
|
|
10
|
+
export declare function stripObservationGroups(observations: string): string;
|
|
11
|
+
export declare function combineObservationGroupRanges(groups: ObservationGroup[]): string;
|
|
12
|
+
export declare function renderObservationGroupsForReflection(observations: string): string | null;
|
|
13
|
+
export declare function deriveObservationGroupProvenance(content: string, groups: ObservationGroup[]): ObservationGroup[];
|
|
14
|
+
export declare function reconcileObservationGroupsFromReflection(content: string, sourceObservations: string): string | null;
|
|
15
|
+
//# sourceMappingURL=observation-groups.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observation-groups.d.ts","sourceRoot":"","sources":["../../../src/processors/observational-memory/observation-groups.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAkDD,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,EAAE,SAAqB,EACvB,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAIR;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA0B/E;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASnE;AASD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAgBhF;AAED,wBAAgB,oCAAoC,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBxF;AAOD,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAiChH;AAED,wBAAgB,wCAAwC,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAyBnH"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { MastraDBMessage } from '@mastra/core/agent';
|
|
2
|
+
import { ObservationStrategy } from './base.js';
|
|
3
|
+
import type { StrategyDeps } from './base.js';
|
|
4
|
+
import type { ObservationRunOpts, ObserverOutput, ProcessedObservation } from './types.js';
|
|
5
|
+
export declare class AsyncBufferObservationStrategy extends ObservationStrategy {
|
|
6
|
+
private readonly startedAt;
|
|
7
|
+
private readonly cycleId;
|
|
8
|
+
private priorExtractedValues?;
|
|
9
|
+
constructor(deps: StrategyDeps, opts: ObservationRunOpts);
|
|
10
|
+
get needsLock(): boolean;
|
|
11
|
+
get needsReflection(): boolean;
|
|
12
|
+
get rethrowOnFailure(): boolean;
|
|
13
|
+
protected generateCycleId(): string;
|
|
14
|
+
prepare(): Promise<{
|
|
15
|
+
messages: MastraDBMessage[];
|
|
16
|
+
existingObservations: string;
|
|
17
|
+
}>;
|
|
18
|
+
emitStartMarkers(_cycleId: string): Promise<void>;
|
|
19
|
+
observe(existingObservations: string, messages: MastraDBMessage[]): Promise<{
|
|
20
|
+
extractedValues: Record<string, unknown> | undefined;
|
|
21
|
+
extractionFailures: import("../extracted-values").ExtractionFailure[] | undefined;
|
|
22
|
+
observations: string;
|
|
23
|
+
currentTask?: string;
|
|
24
|
+
suggestedContinuation?: string;
|
|
25
|
+
threadTitle?: string;
|
|
26
|
+
extractors?: readonly import("..").Extractor<any>[];
|
|
27
|
+
usage?: {
|
|
28
|
+
inputTokens?: number;
|
|
29
|
+
outputTokens?: number;
|
|
30
|
+
totalTokens?: number;
|
|
31
|
+
};
|
|
32
|
+
providerMetadata?: import("@mastra/core/stream").ProviderMetadata;
|
|
33
|
+
}>;
|
|
34
|
+
process(output: ObserverOutput, _existingObservations: string): Promise<ProcessedObservation>;
|
|
35
|
+
persist(processed: ProcessedObservation): Promise<void>;
|
|
36
|
+
emitEndMarkers(_cycleId: string, processed: ProcessedObservation): Promise<void>;
|
|
37
|
+
emitFailedMarkers(_cycleId: string, error: unknown): Promise<void>;
|
|
38
|
+
}
|
|
39
|
+
//# sourceMappingURL=async-buffer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"async-buffer.d.ts","sourceRoot":"","sources":["../../../../src/processors/observational-memory/observation-strategies/async-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAc1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAExF,qBAAa,8BAA+B,SAAQ,mBAAmB;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,oBAAoB,CAAC,CAA0B;gBAE3C,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB;IAMxD,IAAI,SAAS,YAEZ;IACD,IAAI,eAAe,YAElB;IACD,IAAI,gBAAgB,YAEnB;cAEkB,eAAe,IAAI,MAAM;IAItC,OAAO;;;;IAQP,gBAAgB,CAAC,QAAQ,EAAE,MAAM;IAIjC,OAAO,CAAC,oBAAoB,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE;;;;;;;;;uBAqJ9D,CAAC;wBAAsB,CAAC;uBAAqB,CAAC;;;;IApHjD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA6C7F,OAAO,CAAC,SAAS,EAAE,oBAAoB;IAkEvC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,oBAAoB;IA6BhE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAkBzD"}
|