odai-dsh-agent 0.2.5 → 0.2.7

package/preset/odai/runtime/semantic-memory-store.d.mts

@@ -0,0 +1,110 @@
+import type { DshAgent, DshMessage, UnknownRecord } from "./runtime-types.mjs";
+export declare const MEMORY_STORE_SCHEMA_VERSION = 1;
+export declare const MEMORY_EXTRACTOR_VERSION = 1;
+export declare const MEMORY_MODES: readonly ["auto", "off"];
+export declare const MEMORY_CATEGORIES: readonly ["preference", "decision", "constraint", "fact"];
+export declare const MEMORY_STATUSES: readonly ["pending", "active", "superseded"];
+export type MemoryMode = (typeof MEMORY_MODES)[number];
+export type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];
+export type MemoryStatus = (typeof MEMORY_STATUSES)[number];
+export type MemoryConfidence = "high" | "medium";
+export type MemoryExtraction = "local-explicit" | "tool-exact-excerpt";
+export interface MemorySettings {
+    readonly mode?: MemoryMode;
+}
+export interface EffectiveMemorySettings {
+    readonly mode: MemoryMode;
+    readonly source: "deployment-config" | "deployment-default" | "persisted";
+}
+export interface MemoryScope {
+    readonly kind: "global" | "project";
+    readonly key: string;
+    readonly label?: string;
+}
+export interface MemoryProvenance {
+    readonly sourceKind: "direct-user";
+    readonly sessionHash: string;
+    readonly messageHash: string;
+    readonly turn: number;
+    readonly eventSeq?: number;
+    readonly excerptSha256: string;
+    readonly observedAt: number;
+    readonly extraction: MemoryExtraction;
+    readonly extractorVersion: 1;
+}
+export interface MemoryEntry {
+    readonly id: string;
+    readonly scope: MemoryScope;
+    readonly category: MemoryCategory;
+    readonly subject: string;
+    readonly value: string;
+    readonly status: MemoryStatus;
+    readonly confidence: MemoryConfidence;
+    readonly supersedes: readonly string[];
+    readonly conflictsWith: readonly string[];
+    readonly provenance: readonly MemoryProvenance[];
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly occurrences: number;
+}
+export interface MemoryStore {
+    readonly schemaVersion: 1;
+    readonly settings: MemorySettings;
+    readonly entries: readonly MemoryEntry[];
+}
+export interface MutableMemoryEntry {
+    id: string;
+    scope: MemoryScope;
+    category: MemoryCategory;
+    subject: string;
+    value: string;
+    status: MemoryStatus;
+    confidence: MemoryConfidence;
+    supersedes: string[];
+    conflictsWith: string[];
+    provenance: MemoryProvenance[];
+    createdAt: number;
+    updatedAt: number;
+    occurrences: number;
+}
+export interface MutableMemoryStore {
+    schemaVersion: 1;
+    settings: {
+        mode?: MemoryMode;
+    };
+    entries: MutableMemoryEntry[];
+}
+export interface MemoryMutationOutcome extends UnknownRecord {
+    changed?: boolean;
+}
+export interface DirectUserProvenanceOptions {
+    agent: DshAgent;
+    message: DshMessage;
+    turn: number | undefined;
+    excerpt: string;
+    extraction: MemoryExtraction;
+    now?: number;
+}
+export declare const DEFAULT_MEMORY_SETTINGS: Readonly<{
+    mode: MemoryMode;
+}>;
+export declare const MAX_MEMORY_ENTRIES = 1000;
+export declare const MAX_MEMORY_PROVENANCE = 8;
+export declare const MAX_MEMORY_VALUE_CHARS = 600;
+export declare class MemoryStoreValidationError extends Error {
+}
+export declare function resolveMemoryStorePath(configuredPath: unknown, env?: Readonly<Record<string, string | undefined>>): string;
+export declare function readMemoryStore(storePath: string): Readonly<MemoryStore>;
+export declare function mutateMemoryStore<TOutcome extends MemoryMutationOutcome>(storePath: string, mutate: (store: MutableMemoryStore) => TOutcome): Readonly<TOutcome & {
+    store: Readonly<MemoryStore>;
+}>;
+export declare function resetMemoryStore(storePath: string): Readonly<MemoryStore>;
+export declare function effectiveMemorySettings(storePath: string, configured?: {
+    mode?: MemoryMode;
+}): Readonly<EffectiveMemorySettings>;
+export declare function globalMemoryScope(): Readonly<MemoryScope>;
+export declare function projectMemoryScope(cwd: unknown): Readonly<MemoryScope> | undefined;
+export declare function directUserProvenance(options: DirectUserProvenanceOptions): Readonly<MemoryProvenance> | undefined;
+export declare function memoryRecordId(scope: MemoryScope, category: MemoryCategory, subject: string, value: string): string;
+export declare function memoryValueDigest(value: string): string;
+//# sourceMappingURL=semantic-memory-store.d.mts.map

package/preset/odai/runtime/semantic-memory-store.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-memory-store.d.mts","sourceRoot":"","sources":["../src/semantic-memory-store.mts"],"names":[],"mappings":"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"}