@framers/agentos 0.1.51 → 0.1.52

package/dist/memory/AgentMemory.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @fileoverview AgentMemory — high-level facade for the cognitive memory system.
+ *
+ * Provides a simple, developer-friendly API that wraps CognitiveMemoryManager.
+ * Users don't need to know about PAD mood models, HEXACO traits, or internal
+ * memory architecture.
+ *
+ * Usage:
+ * ```typescript
+ * import { AgentMemory } from '@framers/agentos';
+ *
+ * // Option A: Wrap an existing CognitiveMemoryManager (wunderland does this)
+ * const memory = AgentMemory.wrap(existingManager);
+ *
+ * // Option B: Create standalone (you provide the manager config)
+ * const memory = new AgentMemory(cognitiveMemoryManager);
+ * await memory.initialize(config);
+ *
+ * // Simple API
+ * await memory.remember("User prefers dark mode");
+ * const results = await memory.recall("what does the user prefer?");
+ * await memory.observe('user', "Can you help me with my TMJ?");
+ * const context = await memory.getContext("TMJ treatment", { tokenBudget: 2000 });
+ * ```
+ *
+ * @module agentos/memory/AgentMemory
+ */
+import type { MemoryTrace, MemoryType, MemoryScope, MemorySourceType, ScoredMemoryTrace, AssembledMemoryContext, MemoryHealthReport, CognitiveRetrievalResult } from './types.js';
+import type { CognitiveMemoryConfig } from './config.js';
+import type { ICognitiveMemoryManager } from './CognitiveMemoryManager.js';
+import type { ObservationNote } from './observation/MemoryObserver.js';
+import type { ProspectiveMemoryItem } from './prospective/ProspectiveMemoryManager.js';
+export interface RecallResult {
+    /** Relevant memory traces sorted by relevance. */
+    memories: ScoredMemoryTrace[];
+    /** Partially retrieved traces (tip-of-the-tongue). */
+    partial: CognitiveRetrievalResult['partiallyRetrieved'];
+    /** Retrieval diagnostics. */
+    diagnostics: CognitiveRetrievalResult['diagnostics'];
+}
+export interface RememberResult {
+    trace: MemoryTrace;
+    success: boolean;
+}
+export interface SearchOptions {
+    /** Maximum results. Default: 10. */
+    limit?: number;
+    /** Memory type filter. */
+    types?: MemoryType[];
+    /** Tags filter. */
+    tags?: string[];
+    /** Minimum confidence. Default: 0. */
+    minConfidence?: number;
+}
+/**
+ * High-level memory facade for AI agents.
+ *
+ * Wraps `ICognitiveMemoryManager` with a simple API that hides
+ * PAD mood models, HEXACO traits, and internal architecture.
+ */
+export declare class AgentMemory {
+    private manager;
+    private _initialized;
+    constructor(manager?: ICognitiveMemoryManager);
+    /**
+     * Create an AgentMemory wrapping an existing CognitiveMemoryManager.
+     * Use this in wunderland where the manager is already constructed.
+     */
+    static wrap(manager: ICognitiveMemoryManager): AgentMemory;
+    /**
+     * Initialize with full config. Only needed when constructing standalone
+     * (not via `AgentMemory.wrap()`).
+     */
+    initialize(config: CognitiveMemoryConfig): Promise<void>;
+    /**
+     * Store information in long-term memory.
+     *
+     * @example
+     * await memory.remember("User prefers dark mode");
+     * await memory.remember("Deploy by Friday", { type: 'prospective', tags: ['deadline'] });
+     */
+    remember(content: string, options?: {
+        type?: MemoryType;
+        scope?: MemoryScope;
+        scopeId?: string;
+        sourceType?: MemorySourceType;
+        tags?: string[];
+        entities?: string[];
+        importance?: number;
+    }): Promise<RememberResult>;
+    /**
+     * Recall memories relevant to a query.
+     *
+     * @example
+     * const results = await memory.recall("what does the user prefer?");
+     * for (const m of results.memories) {
+     *   console.log(m.content, m.retrievalScore);
+     * }
+     */
+    recall(query: string, options?: SearchOptions): Promise<RecallResult>;
+    /**
+     * Search memories (alias for recall with simpler return).
+     */
+    search(query: string, options?: SearchOptions): Promise<ScoredMemoryTrace[]>;
+    /**
+     * Feed a conversation turn to the observational memory system.
+     * The Observer creates dense notes when the token threshold is reached.
+     *
+     * @example
+     * await memory.observe('user', "Can you help me debug this?");
+     * await memory.observe('assistant', "Sure! The issue is in your useEffect...");
+     */
+    observe(role: 'user' | 'assistant' | 'system' | 'tool', content: string): Promise<ObservationNote[] | null>;
+    /**
+     * Get assembled memory context for prompt injection within a token budget.
+     */
+    getContext(query: string, options?: {
+        tokenBudget?: number;
+    }): Promise<AssembledMemoryContext>;
+    /**
+     * Register a prospective memory (reminder/intention).
+     */
+    remind(input: Omit<ProspectiveMemoryItem, 'id' | 'triggered' | 'createdAt' | 'cueEmbedding'> & {
+        cueText?: string;
+    }): Promise<ProspectiveMemoryItem | null>;
+    /** List active reminders. */
+    reminders(): Promise<ProspectiveMemoryItem[]>;
+    /** Run consolidation cycle. */
+    consolidate(): Promise<void>;
+    /** Memory health diagnostics. */
+    health(): Promise<MemoryHealthReport>;
+    /** Shutdown and release resources. */
+    shutdown(): Promise<void>;
+    get isInitialized(): boolean;
+    /** Access the underlying manager for advanced usage. */
+    get raw(): ICognitiveMemoryManager;
+    private ensureReady;
+}
+//# sourceMappingURL=AgentMemory.d.ts.map

package/dist/memory/AgentMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentMemory.d.ts","sourceRoot":"","sources":["../../src/memory/AgentMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAY,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAOvF,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,sDAAsD;IACtD,OAAO,EAAE,wBAAwB,CAAC,oBAAoB,CAAC,CAAC;IACxD,6BAA6B;IAC7B,WAAW,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,CAAC,EAAE,uBAAuB;IAI7C;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW;IAM1D;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9D;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,cAAc,CAAC;IAkB1B;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAe3E;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKlF;;;;;;;OAOG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,EAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC;IAKpC;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,sBAAsB,CAAC;IAKlC;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC,GAAG;QACtF,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAKxC,6BAA6B;IACvB,SAAS,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAKnD,+BAA+B;IACzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,iCAAiC;IAC3B,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAK3C,sCAAsC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,wDAAwD;IACxD,IAAI,GAAG,IAAI,uBAAuB,CAEjC;IAED,OAAO,CAAC,WAAW;CAKpB"}

package/dist/memory/AgentMemory.js

@@ -0,0 +1,177 @@
+/**
+ * @fileoverview AgentMemory — high-level facade for the cognitive memory system.
+ *
+ * Provides a simple, developer-friendly API that wraps CognitiveMemoryManager.
+ * Users don't need to know about PAD mood models, HEXACO traits, or internal
+ * memory architecture.
+ *
+ * Usage:
+ * ```typescript
+ * import { AgentMemory } from '@framers/agentos';
+ *
+ * // Option A: Wrap an existing CognitiveMemoryManager (wunderland does this)
+ * const memory = AgentMemory.wrap(existingManager);
+ *
+ * // Option B: Create standalone (you provide the manager config)
+ * const memory = new AgentMemory(cognitiveMemoryManager);
+ * await memory.initialize(config);
+ *
+ * // Simple API
+ * await memory.remember("User prefers dark mode");
+ * const results = await memory.recall("what does the user prefer?");
+ * await memory.observe('user', "Can you help me with my TMJ?");
+ * const context = await memory.getContext("TMJ treatment", { tokenBudget: 2000 });
+ * ```
+ *
+ * @module agentos/memory/AgentMemory
+ */
+import { CognitiveMemoryManager } from './CognitiveMemoryManager.js';
+// ── Neutral mood (no emotional bias in encoding/retrieval) ──
+const NEUTRAL_MOOD = { valence: 0, arousal: 0, dominance: 0 };
+/**
+ * High-level memory facade for AI agents.
+ *
+ * Wraps `ICognitiveMemoryManager` with a simple API that hides
+ * PAD mood models, HEXACO traits, and internal architecture.
+ */
+export class AgentMemory {
+    constructor(manager) {
+        this._initialized = false;
+        this.manager = manager ?? new CognitiveMemoryManager();
+    }
+    /**
+     * Create an AgentMemory wrapping an existing CognitiveMemoryManager.
+     * Use this in wunderland where the manager is already constructed.
+     */
+    static wrap(manager) {
+        const mem = new AgentMemory(manager);
+        mem._initialized = true; // assume the passed manager is already initialized
+        return mem;
+    }
+    /**
+     * Initialize with full config. Only needed when constructing standalone
+     * (not via `AgentMemory.wrap()`).
+     */
+    async initialize(config) {
+        if (this._initialized)
+            return;
+        await this.manager.initialize(config);
+        this._initialized = true;
+    }
+    /**
+     * Store information in long-term memory.
+     *
+     * @example
+     * await memory.remember("User prefers dark mode");
+     * await memory.remember("Deploy by Friday", { type: 'prospective', tags: ['deadline'] });
+     */
+    async remember(content, options) {
+        this.ensureReady();
+        try {
+            const trace = await this.manager.encode(content, NEUTRAL_MOOD, 'neutral', {
+                type: options?.type ?? 'episodic',
+                scope: options?.scope ?? 'thread',
+                scopeId: options?.scopeId,
+                sourceType: options?.sourceType ?? 'user_statement',
+                tags: options?.tags,
+                entities: options?.entities,
+                contentSentiment: options?.importance,
+            });
+            return { trace, success: true };
+        }
+        catch {
+            return { trace: null, success: false };
+        }
+    }
+    /**
+     * Recall memories relevant to a query.
+     *
+     * @example
+     * const results = await memory.recall("what does the user prefer?");
+     * for (const m of results.memories) {
+     *   console.log(m.content, m.retrievalScore);
+     * }
+     */
+    async recall(query, options) {
+        this.ensureReady();
+        const result = await this.manager.retrieve(query, NEUTRAL_MOOD, {
+            topK: options?.limit ?? 10,
+            types: options?.types,
+            tags: options?.tags,
+            minConfidence: options?.minConfidence,
+        });
+        return {
+            memories: result.retrieved,
+            partial: result.partiallyRetrieved,
+            diagnostics: result.diagnostics,
+        };
+    }
+    /**
+     * Search memories (alias for recall with simpler return).
+     */
+    async search(query, options) {
+        const result = await this.recall(query, options);
+        return result.memories;
+    }
+    /**
+     * Feed a conversation turn to the observational memory system.
+     * The Observer creates dense notes when the token threshold is reached.
+     *
+     * @example
+     * await memory.observe('user', "Can you help me debug this?");
+     * await memory.observe('assistant', "Sure! The issue is in your useEffect...");
+     */
+    async observe(role, content) {
+        this.ensureReady();
+        return this.manager.observe?.(role, content, NEUTRAL_MOOD) ?? null;
+    }
+    /**
+     * Get assembled memory context for prompt injection within a token budget.
+     */
+    async getContext(query, options) {
+        this.ensureReady();
+        return this.manager.assembleForPrompt(query, options?.tokenBudget ?? 2000, NEUTRAL_MOOD);
+    }
+    /**
+     * Register a prospective memory (reminder/intention).
+     */
+    async remind(input) {
+        this.ensureReady();
+        return this.manager.registerProspective?.(input) ?? null;
+    }
+    /** List active reminders. */
+    async reminders() {
+        this.ensureReady();
+        return this.manager.listProspective?.() ?? [];
+    }
+    /** Run consolidation cycle. */
+    async consolidate() {
+        this.ensureReady();
+        await this.manager.runConsolidation?.();
+    }
+    /** Memory health diagnostics. */
+    async health() {
+        this.ensureReady();
+        return this.manager.getMemoryHealth();
+    }
+    /** Shutdown and release resources. */
+    async shutdown() {
+        if (!this._initialized)
+            return;
+        await this.manager.shutdown();
+        this._initialized = false;
+    }
+    get isInitialized() {
+        return this._initialized;
+    }
+    /** Access the underlying manager for advanced usage. */
+    get raw() {
+        return this.manager;
+    }
+    ensureReady() {
+        if (!this._initialized) {
+            throw new Error('AgentMemory not initialized. Call await memory.initialize(config) or use AgentMemory.wrap().');
+        }
+    }
+}
+//# sourceMappingURL=AgentMemory.js.map

package/dist/memory/AgentMemory.js.map

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

package/dist/memory/index.d.ts

@@ -20,6 +20,8 @@ export { assembleMemoryContext } from './prompt/MemoryPromptAssembler.js';
 export type { MemoryAssemblerInput } from './prompt/MemoryPromptAssembler.js';
 export { formatMemoryTrace, formatMemoryTraces } from './prompt/MemoryFormatters.js';
 export type { FormattingStyle } from './prompt/MemoryFormatters.js';
+export { AgentMemory } from './AgentMemory.js';
+export type { RecallResult, RememberResult, SearchOptions } from './AgentMemory.js';
 export { CognitiveMemoryManager } from './CognitiveMemoryManager.js';
 export type { ICognitiveMemoryManager } from './CognitiveMemoryManager.js';
 export { createCognitiveMemoryDescriptor } from './extension/CognitiveMemoryExtension.js';

package/dist/memory/index.d.ts.map

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

package/dist/memory/index.js

@@ -16,7 +16,9 @@ export { MemoryStore } from './store/MemoryStore.js';
 // --- Prompt Assembly ---
 export { assembleMemoryContext } from './prompt/MemoryPromptAssembler.js';
 export { formatMemoryTrace, formatMemoryTraces } from './prompt/MemoryFormatters.js';
-// --- Orchestrator ---
+// --- High-level facade ---
+export { AgentMemory } from './AgentMemory.js';
+// --- Orchestrator (advanced) ---
 export { CognitiveMemoryManager } from './CognitiveMemoryManager.js';
 // --- Extension ---
 export { createCognitiveMemoryDescriptor } from './extension/CognitiveMemoryExtension.js';

package/dist/memory/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAG9C,gBAAgB;AAChB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAG5C,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,0BAA0B;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGrF,uBAAuB;AACvB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,oBAAoB;AACpB,OAAO,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAY1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,uCAAuC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,uCAAuC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,2CAA2C;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGjF,4CAA4C;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAYxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAG9C,gBAAgB;AAChB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAG5C,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAG7E,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,0BAA0B;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGrF,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,kCAAkC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,oBAAoB;AACpB,OAAO,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAY1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGlE,uCAAuC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,uCAAuC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,2CAA2C;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGjF,4CAA4C;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAYxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",