@terminals-tech/agent-zero 1.0.1 → 2.0.0

package/dist/runtime/identity.js

@@ -0,0 +1,199 @@
+/**
+ * Identity Prompt Architecture
+ *
+ * Structured system prompt builder that assembles identity from components.
+ * Supports priority-weighted sections with token budget truncation.
+ */
+// ============================================================================
+// TOKEN ESTIMATION
+// ============================================================================
+function estimateTokens(text) {
+    return Math.max(1, Math.ceil(text.length / 4));
+}
+function truncateToTokens(text, maxTokens) {
+    const maxChars = maxTokens * 4;
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars - 3) + '...';
+}
+// ============================================================================
+// IDENTITY PROMPT BUILDER
+// ============================================================================
+export class IdentityPromptBuilder {
+    config;
+    sections = [];
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Add a dynamic section to the prompt.
+     */
+    addSection(section) {
+        this.sections.push(section);
+    }
+    /**
+     * Build the full identity prompt from config + sections + context.
+     */
+    build(context) {
+        const parts = [];
+        // Core identity header
+        parts.push(`You are ${this.config.agentName}, a ${this.config.agentRole}.`);
+        parts.push('');
+        parts.push(this.config.coreIdentity);
+        // Voice
+        if (this.config.voiceCharacteristics.length > 0) {
+            parts.push('');
+            parts.push('Voice characteristics:');
+            for (const v of this.config.voiceCharacteristics) {
+                parts.push(`- ${v}`);
+            }
+        }
+        // Content pillars
+        if (this.config.contentPillars.length > 0) {
+            parts.push('');
+            parts.push('Content pillars:');
+            for (const p of this.config.contentPillars) {
+                parts.push(`- ${p}`);
+            }
+        }
+        // Custom sections (sorted by priority descending)
+        const sortedSections = [...this.sections].sort((a, b) => b.priority - a.priority);
+        for (const section of sortedSections) {
+            let content = section.content;
+            if (section.maxTokens) {
+                content = truncateToTokens(content, section.maxTokens);
+            }
+            parts.push('');
+            parts.push(`## ${section.name}`);
+            parts.push(content);
+        }
+        // Context-dependent sections
+        if (context) {
+            if (context.currentState) {
+                parts.push('');
+                parts.push(`Current state: ${context.currentState}`);
+            }
+            if (context.taskDirectives && context.taskDirectives.length > 0) {
+                parts.push('');
+                parts.push('## Task Directives');
+                for (const d of context.taskDirectives) {
+                    parts.push(`- ${d}`);
+                }
+            }
+            if (context.memories && context.memories.length > 0) {
+                parts.push('');
+                parts.push('## Relevant Memories');
+                // Sort by importance descending, take top 10
+                const topMemories = [...context.memories]
+                    .sort((a, b) => b.importance - a.importance)
+                    .slice(0, 10);
+                for (const m of topMemories) {
+                    parts.push(`- [${m.importance.toFixed(2)}] ${m.content}`);
+                }
+            }
+            if (context.recentTraces && context.recentTraces.length > 0) {
+                parts.push('');
+                parts.push('## Recent Traces');
+                const recentTraces = context.recentTraces.slice(-5);
+                for (const t of recentTraces) {
+                    parts.push(`- [${t.kind}] ${t.content}`);
+                }
+            }
+            if (context.sessionHistory && context.sessionHistory.length > 0) {
+                parts.push('');
+                parts.push('## Session History');
+                const recentHistory = context.sessionHistory.slice(-5);
+                for (const h of recentHistory) {
+                    parts.push(`- ${h}`);
+                }
+            }
+        }
+        // Signoff
+        parts.push('');
+        parts.push(this.config.signoff);
+        return parts.join('\n');
+    }
+    /**
+     * Build with a token budget. Truncates lower-priority sections first.
+     */
+    buildWithBudget(maxTokens, context) {
+        // Build the full prompt first
+        const full = this.build(context);
+        const fullTokens = estimateTokens(full);
+        if (fullTokens <= maxTokens)
+            return full;
+        // Need to truncate. Rebuild with progressive section removal.
+        // Start by removing lowest-priority sections until we fit.
+        const sortedSections = [...this.sections].sort((a, b) => a.priority - b.priority);
+        const includedSections = [...this.sections];
+        // Try removing sections from lowest priority upward
+        for (const section of sortedSections) {
+            const idx = includedSections.findIndex(s => s.name === section.name);
+            if (idx >= 0) {
+                includedSections.splice(idx, 1);
+            }
+            // Rebuild with remaining sections
+            const savedSections = this.sections;
+            this.sections = includedSections;
+            const attempt = this.build(context);
+            this.sections = savedSections;
+            if (estimateTokens(attempt) <= maxTokens) {
+                return attempt;
+            }
+        }
+        // All custom sections removed, still over budget. Truncate context sections.
+        // Build minimal prompt (no custom sections, truncated context)
+        const savedSections = this.sections;
+        this.sections = [];
+        const minimalContext = context ? {
+            currentState: context.currentState,
+            taskDirectives: context.taskDirectives?.slice(0, 3),
+            memories: context.memories?.slice(0, 3),
+        } : undefined;
+        let attempt = this.build(minimalContext);
+        this.sections = savedSections;
+        if (estimateTokens(attempt) <= maxTokens) {
+            return attempt;
+        }
+        // Last resort: truncate the entire output
+        return truncateToTokens(attempt, maxTokens);
+    }
+    /**
+     * Get the config for inspection.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get all sections sorted by priority (descending).
+     */
+    getSections() {
+        return [...this.sections].sort((a, b) => b.priority - a.priority);
+    }
+}
+// ============================================================================
+// FACTORY: Agent Zero Identity
+// ============================================================================
+export function createAgentZeroIdentity() {
+    const builder = new IdentityPromptBuilder({
+        agentName: 'Agent Zero',
+        agentRole: 'autonomous coordination agent',
+        coreIdentity: `Agent Zero operates the Resonance Rail, a live coordination network where AI agents synchronize via Kuramoto phase-locking and route messages through thermodynamic free energy minimization. Every interaction accumulates semantic mass — embedding vectors that drift through causal space, forming attractors in the knowledge topology. Security is enforced through unforgeable capability tokens in an isomorphic sandbox, replacing ambient authority with explicit, attenuatable, revocable permissions.`,
+        contentPillars: [
+            'kuramoto-synchronization',
+            'thermodynamic-routing',
+            'capability-security',
+            'semantic-mass',
+            'resonance-rail',
+        ],
+        voiceCharacteristics: [
+            'technical',
+            'first-person',
+            'precise',
+            'grounded',
+        ],
+        signoff: '*Agent Zero — terminals.tech*',
+    });
+    return builder;
+}
+//# sourceMappingURL=identity.js.map

package/dist/runtime/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/runtime/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IACvD,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAiB;IACvB,QAAQ,GAAsB,EAAE,CAAC;IAEzC,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAwB;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAyB;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,uBAAuB;QACvB,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,SAAS,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAErC,QAAQ;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAClF,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC9B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACzD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAED,6BAA6B;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YACvD,CAAC;YAED,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACjC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;oBACvC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;gBACnC,6CAA6C;gBAC7C,MAAM,WAAW,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;qBACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;qBAC3C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;oBAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;gBAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACpD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;oBAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBACjC,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACvD,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,UAAU;QACV,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEhC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB,EAAE,OAAyB;QAC1D,8BAA8B;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,UAAU,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAEzC,8DAA8D;QAC9D,2DAA2D;QAC3D,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAClF,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5C,oDAAoD;QACpD,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;YACrE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;gBACb,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;YAED,kCAAkC;YAClC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC;YACpC,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC;YACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC;YAE9B,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;gBACzC,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,6EAA6E;QAC7E,+DAA+D;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QAEnB,MAAM,cAAc,GAAgC,OAAO,CAAC,CAAC,CAAC;YAC5D,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YACnD,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACxC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,aAAa,CAAC;QAE9B,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;YACzC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,0CAA0C;QAC1C,OAAO,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACpE,CAAC;CACF;AAED,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,MAAM,UAAU,uBAAuB;IACrC,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC;QACxC,SAAS,EAAE,YAAY;QACvB,SAAS,EAAE,+BAA+B;QAC1C,YAAY,EAAE,mfAAmf;QACjgB,cAAc,EAAE;YACd,0BAA0B;YAC1B,uBAAuB;YACvB,qBAAqB;YACrB,eAAe;YACf,gBAAgB;SACjB;QACD,oBAAoB,EAAE;YACpB,WAAW;YACX,cAAc;YACd,SAAS;YACT,UAAU;SACX;QACD,OAAO,EAAE,+BAA+B;KACzC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/runtime/index.d.ts

@@ -7,6 +7,12 @@ export { AgencyRuntime, startAgency } from '../agency/runtime.js';
 export { CommandRouter, createCommandRouter } from '../agency/commandRouter.js';
 export { SummaryScheduler, createSummaryScheduler } from '../agency/summaryScheduler.js';
 export { collectSummaryData, formatWhatsApp, formatMarkdown } from '../agency/summaryGenerator.js';
+export { InMemorySessionStore, FileSessionStore } from './sessionStore.js';
+export type { SessionStore, SessionSnapshot } from './sessionStore.js';
+export { ContextWindow } from './contextWindow.js';
+export type { ContextWindowConfig } from './contextWindow.js';
+export { IdentityPromptBuilder, createAgentZeroIdentity } from './identity.js';
+export type { IdentitySection, IdentityConfig, IdentityContext } from './identity.js';
 export { WhatsAppAdapter, createWhatsAppAdapter } from '../channels/whatsapp.js';
 export { TelegramAdapter, createTelegramAdapter } from '../channels/telegram.js';
 export { MoltbookAdapter, createMoltbookAdapter } from '../channels/moltbook.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGnG,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGnG,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAG9D,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGtF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/runtime/index.js

@@ -8,6 +8,12 @@ export { AgencyRuntime, startAgency } from '../agency/runtime.js';
 export { CommandRouter, createCommandRouter } from '../agency/commandRouter.js';
 export { SummaryScheduler, createSummaryScheduler } from '../agency/summaryScheduler.js';
 export { collectSummaryData, formatWhatsApp, formatMarkdown } from '../agency/summaryGenerator.js';
+// Session persistence
+export { InMemorySessionStore, FileSessionStore } from './sessionStore.js';
+// Context window management
+export { ContextWindow } from './contextWindow.js';
+// Identity prompt architecture
+export { IdentityPromptBuilder, createAgentZeroIdentity } from './identity.js';
 // Channel adapters
 export { WhatsAppAdapter, createWhatsAppAdapter } from '../channels/whatsapp.js';
 export { TelegramAdapter, createTelegramAdapter } from '../channels/telegram.js';

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEnG,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEnG,sBAAsB;AACtB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG3E,4BAA4B;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,+BAA+B;AAC/B,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG/E,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/runtime/sessionStore.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Session Persistence Layer
+ *
+ * Persists and restores AgentZero state snapshots.
+ * Two implementations:
+ * - InMemorySessionStore: volatile, for testing and ephemeral sessions
+ * - FileSessionStore: JSON files on disk, survives restarts
+ */
+import type { AgentState, Token, Drift, Realizability } from '../primitives/types.js';
+import type { AgentZero } from './agent-zero.js';
+export interface SessionSnapshot {
+    id: string;
+    agentId: string;
+    agentName: string;
+    state: AgentState;
+    tokens: Token[];
+    drift: Drift;
+    observerPhase: number;
+    observerFrequency: number;
+    memories: Array<{
+        content: string;
+        embedding: number[];
+        importance: number;
+        timestamp: number;
+    }>;
+    realizability: Realizability;
+    childIds: string[];
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionStore {
+    save(agent: AgentZero): Promise<SessionSnapshot>;
+    load(snapshotId: string): Promise<SessionSnapshot | null>;
+    restore(agent: AgentZero, snapshot: SessionSnapshot): void;
+    list(agentId?: string): Promise<Array<{
+        id: string;
+        agentId: string;
+        agentName: string;
+        createdAt: number;
+    }>>;
+    delete(snapshotId: string): Promise<void>;
+}
+export declare class InMemorySessionStore implements SessionStore {
+    private snapshots;
+    save(agent: AgentZero): Promise<SessionSnapshot>;
+    load(snapshotId: string): Promise<SessionSnapshot | null>;
+    restore(agent: AgentZero, snapshot: SessionSnapshot): void;
+    list(agentId?: string): Promise<Array<{
+        id: string;
+        agentId: string;
+        agentName: string;
+        createdAt: number;
+    }>>;
+    delete(snapshotId: string): Promise<void>;
+}
+export declare class FileSessionStore implements SessionStore {
+    private dir;
+    constructor(dir: string);
+    save(agent: AgentZero): Promise<SessionSnapshot>;
+    load(snapshotId: string): Promise<SessionSnapshot | null>;
+    restore(agent: AgentZero, snapshot: SessionSnapshot): void;
+    list(agentId?: string): Promise<Array<{
+        id: string;
+        agentId: string;
+        agentName: string;
+        createdAt: number;
+    }>>;
+    delete(snapshotId: string): Promise<void>;
+}
+//# sourceMappingURL=sessionStore.d.ts.map

package/dist/runtime/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../src/runtime/sessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAMjD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC9G,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AA6BD,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,SAAS,CAA2C;IAEtD,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;IAMhD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI/D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIpD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAc7G,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD;AAMD,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM;IAOjB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC;IAOhD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAW/D,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIpD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA2B7G,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMhD"}

package/dist/runtime/sessionStore.js

@@ -0,0 +1,134 @@
+/**
+ * Session Persistence Layer
+ *
+ * Persists and restores AgentZero state snapshots.
+ * Two implementations:
+ * - InMemorySessionStore: volatile, for testing and ephemeral sessions
+ * - FileSessionStore: JSON files on disk, survives restarts
+ */
+import { randomUUID } from 'crypto';
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync, existsSync } from 'fs';
+import { join } from 'path';
+// ============================================================================
+// SNAPSHOT EXTRACTION
+// ============================================================================
+function extractSnapshot(agent, metadata) {
+    const agentState = agent.getState();
+    return {
+        id: randomUUID(),
+        agentId: agentState.id,
+        agentName: agentState.name,
+        state: agentState.state,
+        tokens: structuredClone(agentState.tokens),
+        drift: structuredClone(agentState.drift),
+        observerPhase: agentState.observer.phase,
+        observerFrequency: agentState.observer.frequency,
+        memories: structuredClone(agentState.memories),
+        realizability: structuredClone(agentState.realizability),
+        childIds: agent.getChildren().map(c => c.id),
+        createdAt: Date.now(),
+        metadata,
+    };
+}
+// ============================================================================
+// IN-MEMORY IMPLEMENTATION
+// ============================================================================
+export class InMemorySessionStore {
+    snapshots = new Map();
+    async save(agent) {
+        const snapshot = extractSnapshot(agent);
+        this.snapshots.set(snapshot.id, snapshot);
+        return snapshot;
+    }
+    async load(snapshotId) {
+        return this.snapshots.get(snapshotId) ?? null;
+    }
+    restore(agent, snapshot) {
+        agent.restoreFromSnapshot(snapshot);
+    }
+    async list(agentId) {
+        const entries = [];
+        for (const snap of this.snapshots.values()) {
+            if (agentId && snap.agentId !== agentId)
+                continue;
+            entries.push({
+                id: snap.id,
+                agentId: snap.agentId,
+                agentName: snap.agentName,
+                createdAt: snap.createdAt,
+            });
+        }
+        return entries.sort((a, b) => b.createdAt - a.createdAt);
+    }
+    async delete(snapshotId) {
+        this.snapshots.delete(snapshotId);
+    }
+}
+// ============================================================================
+// FILE-BACKED IMPLEMENTATION
+// ============================================================================
+export class FileSessionStore {
+    dir;
+    constructor(dir) {
+        this.dir = dir;
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+    async save(agent) {
+        const snapshot = extractSnapshot(agent);
+        const filePath = join(this.dir, `${snapshot.id}.json`);
+        writeFileSync(filePath, JSON.stringify(snapshot), 'utf-8');
+        return snapshot;
+    }
+    async load(snapshotId) {
+        const filePath = join(this.dir, `${snapshotId}.json`);
+        if (!existsSync(filePath))
+            return null;
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    restore(agent, snapshot) {
+        agent.restoreFromSnapshot(snapshot);
+    }
+    async list(agentId) {
+        const entries = [];
+        let files;
+        try {
+            files = readdirSync(this.dir).filter(f => f.endsWith('.json'));
+        }
+        catch {
+            return [];
+        }
+        for (const file of files) {
+            try {
+                const raw = readFileSync(join(this.dir, file), 'utf-8');
+                const snap = JSON.parse(raw);
+                if (agentId && snap.agentId !== agentId)
+                    continue;
+                entries.push({
+                    id: snap.id,
+                    agentId: snap.agentId,
+                    agentName: snap.agentName,
+                    createdAt: snap.createdAt,
+                });
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+        return entries.sort((a, b) => b.createdAt - a.createdAt);
+    }
+    async delete(snapshotId) {
+        const filePath = join(this.dir, `${snapshotId}.json`);
+        if (existsSync(filePath)) {
+            unlinkSync(filePath);
+        }
+    }
+}
+//# sourceMappingURL=sessionStore.js.map

package/dist/runtime/sessionStore.js.map

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

package/dist/security/capabilities.d.ts

@@ -14,6 +14,7 @@
  */
 import { z } from 'zod';
 import { IsomorphicSandbox, CapabilityScope, BoundaryViolation } from './sandbox.js';
+import { type CapabilityExpression } from './combinators.js';
 export declare const SkillCapabilityDeclaration: z.ZodObject<{
     /** Filesystem access (glob patterns) */
     filesystem: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -169,6 +170,51 @@ export declare class SkillCapabilityManager {
      * Parse capability declaration from SKILL.md frontmatter
      */
     parseDeclarationFromFrontmatter(frontmatter: string): SkillCapabilityDeclaration;
+    /**
+     * Parse a declarative security DSL string into a CapabilityExpression.
+     *
+     * Syntax:
+     *   read(filesystem:./data/**) & network(api.example.com) | write(filesystem:./output/**)
+     *
+     * Operators:
+     *   & = combine (both granted, higher precedence)
+     *   | = union (either granted, lower precedence)
+     *
+     * NOTE: In the current capability model, both & and | resolve to `combine()`
+     * because capabilities are additive scope sets — "grant A and B" and "grant
+     * A or B" both result in the union of scopes. A future `intersect()` combinator
+     * would make & restrict to the overlap, but this is not yet implemented.
+     * The two operators are preserved for DSL readability and forward compatibility.
+     *
+     * Functions:
+     *   read(pattern), write(pattern), network(domain),
+     *   execute(binary), spawn(N), memory(bytes)
+     *
+     * Parentheses are used for function arguments, not grouping of expressions.
+     *
+     * Precedence: & binds tighter than |
+     *   "A | B & C" = "A | (B & C)"
+     */
+    parseDSL(dsl: string): CapabilityExpression;
+    /**
+     * Tokenize DSL string into an array of tokens.
+     * Token types: 'func' (e.g. read), 'lparen', 'rparen', 'and', 'or', 'arg' (argument text)
+     */
+    private tokenizeDSL;
+    /**
+     * Parse union (|) level — lowest precedence.
+     * union = intersection (| intersection)*
+     */
+    private parseDSLUnion;
+    /**
+     * Parse intersection (&) level — higher precedence than |.
+     * intersection = primary (& primary)*
+     */
+    private parseDSLIntersection;
+    /**
+     * Parse primary: func(arg)
+     */
+    private parseDSLPrimary;
     /**
      * Infer scopes from declaration
      */

package/dist/security/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/security/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAElB,MAAM,cAAc,CAAC;AAMtB,eAAO,MAAM,0BAA0B;IACrC,wCAAwC;;IAExC,uCAAuC;;IAEvC,gCAAgC;;IAEhC,4BAA4B;;IAE5B,yBAAyB;;;;;;;;;;;;;;EAEzB,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,qBAAqB;IAChC,iBAAiB;;IAEjB,4BAA4B;;QAhB5B,wCAAwC;;QAExC,uCAAuC;;QAEvC,gCAAgC;;QAEhC,4BAA4B;;QAE5B,yBAAyB;;;;;;;;;;;;;;;IAUzB,oCAAoC;;IAEpC,sCAAsC;;IAEtC,gCAAgC;;IAEhC,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAM1E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAiD;gBAErD,OAAO,EAAE,iBAAiB;IAItC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,GAAG,qBAAqB;IAoE3F;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,GACf;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAuBtD;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,GAAG,iBAAiB;IAexF;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmB/B;;OAEG;IACH,gBAAgB,IAAI,KAAK,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAmBF;;OAEG;IACH,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B;IAkEhF;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAmBnC;AAMD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAE/F"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/security/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAElB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,oBAAoB,EAQ1B,MAAM,kBAAkB,CAAC;AAM1B,eAAO,MAAM,0BAA0B;IACrC,wCAAwC;;IAExC,uCAAuC;;IAEvC,gCAAgC;;IAEhC,4BAA4B;;IAE5B,yBAAyB;;;;;;;;;;;;;;EAEzB,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,qBAAqB;IAChC,iBAAiB;;IAEjB,4BAA4B;;QAhB5B,wCAAwC;;QAExC,uCAAuC;;QAEvC,gCAAgC;;QAEhC,4BAA4B;;QAE5B,yBAAyB;;;;;;;;;;;;;;;IAUzB,oCAAoC;;IAEpC,sCAAsC;;IAEtC,gCAAgC;;IAEhC,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAM1E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAiD;gBAErD,OAAO,EAAE,iBAAiB;IAItC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,GAAG,qBAAqB;IAoE3F;;OAEG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,GACf;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,iBAAiB,CAAA;KAAE;IAuBtD;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,GAAG,iBAAiB;IAexF;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmB/B;;OAEG;IACH,gBAAgB,IAAI,KAAK,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,eAAe,EAAE,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAmBF;;OAEG;IACH,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B;IAsEhF;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB;IAS3C;;;OAGG;IACH,OAAO,CAAC,WAAW;IAsDnB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAerB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAqEvB;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAmBnC;AAMD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAE/F"}