aec-agent 1.0.0

package/dist/components/trace-service/trace-service.js

@@ -0,0 +1,288 @@
+// ---------------------------------------------------------------------------
+// TraceService — the "control room" that records everything the AI agent does
+//
+// ANALOGY: Think of this like a security camera system in a building.
+// - The TraceService is the central recording system
+// - "Spans" are individual camera clips (e.g. "door opened at 2:00, closed at 2:05")
+// - "Sinks" are where the footage goes (TV monitor, hard drive, cloud backup)
+// - "Context" tracks which room the camera is currently watching
+//
+// WHY IT EXISTS: When an AI agent processes a user message, many things happen
+// internally — it reads context, calls the LLM, executes tools, loops back.
+// Without tracing, this is a black box. TraceService makes it transparent
+// by recording each step (a "span") with timing, and sending that data
+// to any number of outputs ("sinks") — a console log, an SSE stream to
+// a web dashboard, a file, etc.
+//
+// THE 80/20: The two things that matter most are:
+// 1. startSpan() — call this when a step BEGINS, get back a handle
+// 2. handle.end() — call this when the step FINISHES, it records duration
+// Everything else supports these two operations.
+// ---------------------------------------------------------------------------
+export class TraceService {
+    // List of outputs that want to receive trace data.
+    // Example: a ConsoleTraceSink that prints to terminal,
+    // or an SseTraceSink that streams to a web browser.
+    // When this list is EMPTY, tracing is essentially free (no-op).
+    sinks = [];
+    // Active "recording sessions" — one per agent run.
+    // Each context tracks which span is currently "open" so that
+    // new spans automatically become children of the current one.
+    // Key = traceId (a unique ID for this entire agent run).
+    activeContexts = new Map();
+    // --- Sink management: add/remove outputs that receive trace data ---
+    // Register a new output destination for trace data.
+    // Call this BEFORE the agent starts processing to capture everything.
+    addSink(sink) {
+        this.sinks.push(sink);
+    }
+    // Unregister an output destination.
+    // Call this when the output is no longer needed (e.g. browser disconnected).
+    removeSink(sink) {
+        const idx = this.sinks.indexOf(sink);
+        if (idx !== -1)
+            this.sinks.splice(idx, 1);
+    }
+    // Read-only view of all registered sinks (for inspection/testing).
+    getSinks() {
+        return this.sinks;
+    }
+    // ── Trace context management ──
+    // A "context" represents one complete agent run (user sends message → agent replies).
+    // It carries a unique traceId and knows which span is currently "open"
+    // so child spans can automatically nest under their parent.
+    // Start a new recording session for an agent run.
+    // Returns a context object that you pass to startSpan() calls.
+    // The optional traceId parameter lets you provide your own ID
+    // (useful for correlating with external systems); otherwise a random one is generated.
+    createContext(traceId) {
+        const id = traceId ?? crypto.randomUUID();
+        const ctx = new MutableTraceContext(id);
+        this.activeContexts.set(id, ctx);
+        return ctx;
+    }
+    // Look up an existing recording session by its traceId.
+    getContext(traceId) {
+        return this.activeContexts.get(traceId);
+    }
+    // Clean up a recording session when the agent run is complete.
+    // Prevents memory from growing indefinitely as more runs happen.
+    removeContext(traceId) {
+        this.activeContexts.delete(traceId);
+    }
+    // ── Span lifecycle ──
+    // A "span" is a single timed step: "model call started at X, ended at Y, took 2000ms".
+    // Spans form a TREE: the root span is the entire run, iteration spans are children
+    // of the run, model-call spans are children of iterations, tool calls are children
+    // of iterations too. This tree structure lets a UI render a collapsible timeline.
+    // Begin recording a new step. Returns a "handle" — a remote control for this span.
+    // When the step finishes, call handle.end() to record the end time and duration.
+    //
+    // Parameters:
+    //   ctx        — the recording session (from createContext)
+    //   name       — human-readable label like "model-call" or "schedule-lookup"
+    //   kind       — category: "run", "iteration", "model-call", "tool-dispatch", etc.
+    //   attributes — extra data to attach (e.g. { model: "claude-sonnet", iteration: 3 })
+    //
+    // THE KEY OPTIMIZATION: when no sinks are registered, this returns a NoOpSpanHandle
+    // that does absolutely nothing — no object allocation, no timing, no overhead.
+    // This means tracing is free to leave wired up in production with no sinks.
+    startSpan(ctx, name, kind, attributes) {
+        // Fast path: if nobody is listening, don't do any work
+        if (this.sinks.length === 0) {
+            return new NoOpSpanHandle(ctx, name, kind);
+        }
+        // Build the span data object — this is the "recording" for this step
+        const span = {
+            traceId: ctx.traceId, // which agent run this belongs to
+            spanId: crypto.randomUUID(), // unique ID for THIS specific step
+            parentSpanId: ctx.currentSpanId, // which step "contains" this one (the parent)
+            name, // human label: "model-call", "context-assembly"
+            kind, // category: "run" | "iteration" | "model-call" | ...
+            startTime: Date.now(), // when this step began (milliseconds since epoch)
+            status: "in-progress", // will change to "ok" or "error" when end() is called
+            attributes: attributes ? { ...attributes } : {}, // extra key-value data
+            events: [], // notable moments during the span (rarely used)
+        };
+        // PARENT-CHILD NESTING: push this span onto the context stack.
+        // Any span started AFTER this one (but before it ends) will
+        // automatically have this span as its parent.
+        // Think of it like nested folders: Run > Iteration > Model Call > ...
+        const mutableCtx = this.activeContexts.get(ctx.traceId);
+        if (mutableCtx) {
+            mutableCtx.pushSpan(span.spanId);
+        }
+        // Tell all sinks "a new step just started" (they can show a spinner, log it, etc.)
+        this.notifyStart(span);
+        // Return a handle so the caller can later call handle.end() when this step is done
+        return new LiveSpanHandle(span, this, mutableCtx ?? null);
+    }
+    // ── Sink notifications (internal) ──
+    // These methods broadcast span events to ALL registered sinks.
+    // Called internally by startSpan() and by LiveSpanHandle.end().
+    // Tell all sinks: "a step just started"
+    notifyStart(span) {
+        for (const sink of this.sinks) {
+            sink.onSpanStart(span);
+        }
+    }
+    // Tell all sinks: "a step just finished" (with duration, status, final attributes)
+    notifyEnd(span) {
+        for (const sink of this.sinks) {
+            sink.onSpanEnd(span);
+        }
+    }
+    // Force all sinks to push out any buffered data.
+    // Useful at the end of a request to make sure everything is sent.
+    async flush() {
+        for (const sink of this.sinks) {
+            await sink.flush();
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// MutableTraceContext — the "breadcrumb trail" that tracks nesting
+//
+// ANALOGY: Imagine you're exploring nested folders on your computer.
+// The spanStack is like your address bar showing the path:
+//   Run > Iteration-1 > Model-Call
+// When you open a deeper folder (start a child span), it gets pushed on.
+// When you close it (end the span), it gets popped off.
+// This way, the next span you open automatically knows its parent.
+// ---------------------------------------------------------------------------
+export class MutableTraceContext {
+    // The unique ID for this entire agent run.
+    // All spans in this run share the same traceId.
+    traceId;
+    // Stack of currently-open span IDs, from outermost to innermost.
+    // Example mid-run: ["run-span-id", "iteration-1-span-id", "model-call-span-id"]
+    // The LAST item is always the "current" span — new spans become its children.
+    spanStack = [];
+    constructor(traceId) {
+        this.traceId = traceId;
+    }
+    // Returns the span ID at the top of the stack (the innermost open span).
+    // Returns undefined when no spans are open (happens at the very start/end).
+    // New spans will have this value as their parentSpanId.
+    get currentSpanId() {
+        return this.spanStack.length > 0
+            ? this.spanStack[this.spanStack.length - 1]
+            : undefined;
+    }
+    // Called when a new span starts — pushes it onto the stack
+    // so it becomes the new "current" parent for any deeper spans.
+    pushSpan(spanId) {
+        this.spanStack.push(spanId);
+    }
+    // Called when a span ends — removes it from the stack
+    // so its parent becomes "current" again.
+    popSpan() {
+        this.spanStack.pop();
+    }
+}
+// ---------------------------------------------------------------------------
+// LiveSpanHandle — the "remote control" for an active span
+//
+// When you call traceService.startSpan(), you get back one of these.
+// It holds a reference to the span data and lets you:
+//   1. Add events (notable moments during the span)
+//   2. Set extra attributes (data you learn after the span started)
+//   3. End the span (records end time, calculates duration, notifies sinks)
+//
+// IMPORTANT: end() can only be called ONCE. Calling it again is a no-op.
+// This prevents double-counting or corrupted timing.
+// ---------------------------------------------------------------------------
+class LiveSpanHandle {
+    span;
+    service;
+    ctx;
+    constructor(
+    // The actual span data object that gets sent to sinks
+    span, 
+    // Reference back to the TraceService so we can notify sinks when ending
+    service, 
+    // Reference to the context so we can pop this span off the stack when ending
+    ctx) {
+        this.span = span;
+        this.service = service;
+        this.ctx = ctx;
+    }
+    // Record a notable moment DURING the span (rarely needed).
+    // Example: addEvent("retry", { attempt: 2, reason: "timeout" })
+    addEvent(name, attributes) {
+        this.span.events.push({
+            name,
+            timestamp: Date.now(),
+            attributes,
+        });
+    }
+    // Attach additional data to the span after it was started.
+    // Example: setAttributes({ model: "claude-opus", temperature: 0.7 })
+    // Merges with any attributes already set — doesn't replace them.
+    setAttributes(attributes) {
+        Object.assign(this.span.attributes, attributes);
+    }
+    // FINISH the span — this is the most important method.
+    // Records the end time, calculates how long the step took,
+    // determines success/error status, pops the context stack,
+    // and tells all sinks "this step is done, here's the final data."
+    //
+    // The optional attributes parameter lets you add final data
+    // that's only known when the step completes:
+    //   handle.end({ inputTokens: 1500, outputTokens: 300, stopReason: "end_turn" })
+    end(attributes) {
+        // Guard: if already ended, do nothing (prevents double-end bugs)
+        if (this.span.endTime !== undefined)
+            return;
+        // Merge any final attributes
+        if (attributes) {
+            Object.assign(this.span.attributes, attributes);
+        }
+        // Record timing: when it ended and how long it took
+        this.span.endTime = Date.now();
+        this.span.durationMs = this.span.endTime - this.span.startTime;
+        // Determine status: if there's an "error" attribute, mark as error
+        this.span.status = this.span.attributes["error"] ? "error" : "ok";
+        // Pop this span off the nesting stack so the parent becomes "current" again
+        if (this.ctx) {
+            this.ctx.popSpan();
+        }
+        // Broadcast to all sinks: "this step finished, here's the complete data"
+        this.service.notifyEnd(this.span);
+    }
+}
+// ---------------------------------------------------------------------------
+// NoOpSpanHandle — the "do nothing" handle for zero overhead
+//
+// WHY THIS EXISTS: When no sinks are registered (nobody is listening),
+// there's no point recording timing data, allocating UUIDs, or managing
+// the context stack. This class has empty method bodies that do nothing,
+// so the agent loop runs at full speed with no tracing overhead.
+//
+// The calling code doesn't need to check "is tracing enabled?" before
+// every span — it always gets back a SpanHandle. When sinks are present,
+// it's a LiveSpanHandle that records everything. When no sinks exist,
+// it's this NoOpSpanHandle that silently ignores all calls.
+// ---------------------------------------------------------------------------
+class NoOpSpanHandle {
+    span;
+    constructor(ctx, name, kind) {
+        // Minimal span object with dummy values — only exists to satisfy the type
+        this.span = {
+            traceId: ctx.traceId,
+            spanId: "",
+            parentSpanId: ctx.currentSpanId,
+            name,
+            kind,
+            startTime: 0,
+            status: "ok",
+            attributes: {},
+            events: [],
+        };
+    }
+    // All methods are intentionally empty — no work to do when nobody is listening
+    addEvent(_name, _attributes) { }
+    setAttributes(_attributes) { }
+    end(_attributes) { }
+}
+//# sourceMappingURL=trace-service.js.map

package/dist/components/trace-service/trace-service.js.map

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

package/dist/components/trace-service/types/sink.d.ts

@@ -0,0 +1,7 @@
+import type { TraceSpan } from "./span.js";
+export interface TraceSink {
+    onSpanStart(span: TraceSpan): void;
+    onSpanEnd(span: TraceSpan): void;
+    flush(): void | Promise<void>;
+}
+//# sourceMappingURL=sink.d.ts.map

package/dist/components/trace-service/types/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../../../src/components/trace-service/types/sink.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}

package/dist/components/trace-service/types/sink.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// TraceSink — pluggable output interface for trace consumers
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=sink.js.map

package/dist/components/trace-service/types/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../../../src/components/trace-service/types/sink.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E"}

package/dist/components/trace-service/types/span.d.ts

@@ -0,0 +1,31 @@
+export type SpanKind = "run" | "iteration" | "context-assembly" | "compaction" | "memory-recall" | "model-call" | "tool-dispatch" | "skill-dispatch" | "sandbox-op";
+export type SpanStatus = "ok" | "error" | "in-progress";
+export interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: SpanKind;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    status: SpanStatus;
+    attributes: Record<string, unknown>;
+    events: SpanEvent[];
+}
+export interface SpanEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, unknown>;
+}
+export interface SpanHandle {
+    readonly span: TraceSpan;
+    addEvent(name: string, attributes?: Record<string, unknown>): void;
+    setAttributes(attributes: Record<string, unknown>): void;
+    end(attributes?: Record<string, unknown>): void;
+}
+export interface TraceContext {
+    readonly traceId: string;
+    readonly currentSpanId: string | undefined;
+}
+//# sourceMappingURL=span.d.ts.map

package/dist/components/trace-service/types/span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../../../src/components/trace-service/types/span.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAChB,KAAK,GACL,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,YAAY,CAAC;AAEjB,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAMD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACnE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjD;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C"}

package/dist/components/trace-service/types/span.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Trace types — structured span-tree observability for the agent loop
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=span.js.map

package/dist/components/trace-service/types/span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.js","sourceRoot":"","sources":["../../../../src/components/trace-service/types/span.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E"}

package/dist/create-agent.d.ts

@@ -0,0 +1,5 @@
+import type { AgentConfig } from "./components/llm-provider-hub/providers/types.js";
+import { AgentCore } from "./agent-core.js";
+import type { Agent } from "./components/multi-agent-orchestration/agent/agent.js";
+export declare function createAgent(config?: AgentConfig, core?: AgentCore): Agent;
+//# sourceMappingURL=create-agent.d.ts.map

package/dist/create-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.d.ts","sourceRoot":"","sources":["../src/create-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAEpF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uDAAuD,CAAC;AAGnF,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAuDzE"}

package/dist/create-agent.js

@@ -0,0 +1,57 @@
+import { resolveProvider } from "./components/llm-provider-hub/providers/registry.js";
+import { AgentCore } from "./agent-core.js";
+import { ESSENTIAL_SKILL_NAMES } from "./components/skill-hub/built-in-skills/essential-skills.js";
+export function createAgent(config, core) {
+    const agentCore = core ?? new AgentCore();
+    if (config?.persistence) {
+        agentCore.usePersistence(config.persistence);
+    }
+    if (config?.provider && config.apiKey && config.model) {
+        const adapter = resolveProvider(config.provider, {
+            apiKey: config.apiKey,
+            model: config.model,
+            baseUrl: config.baseUrl,
+        });
+        agentCore.useLLMProvider(adapter);
+    }
+    if (config?.tools) {
+        for (const tool of config.tools)
+            agentCore.useTool(tool);
+    }
+    const appSkillNames = [];
+    if (config?.skills) {
+        for (const skill of config.skills)
+            appSkillNames.push(agentCore.skillHub.register(skill, "app").name);
+    }
+    const toolNames = config?.tools?.map((t) => t.definition.name) ?? [];
+    // The essential skills plus the app's; each is used only when the agent has the tools it requires.
+    const skillNames = [...new Set([...ESSENTIAL_SKILL_NAMES, ...appSkillNames])];
+    return agentCore.spawnAgent({
+        id: crypto.randomUUID(),
+        name: config?.provider ? `${config.provider}-agent` : "agent",
+        systemPrompt: config?.systemPrompt ?? "You are a helpful assistant.",
+        provider: config?.provider,
+        tools: toolNames,
+        skills: skillNames,
+        compactor: {
+            contextWindowTokens: 200_000,
+            threshold: 0.8,
+            minTailUserMessages: 4,
+            protectFirstN: 2,
+            proactivePruneTokens: 50_000,
+            oldToolResultMinTokens: 2_000,
+            tailTargetRatio: 0.2,
+            protectLastN: 10,
+            summarizeMaxOutputTokens: 4_096,
+        },
+        memory: {
+            enabled: true,
+            updateSoul: false,
+            updateUser: true,
+            consolidation: {
+                intervalMinutes: 30,
+            },
+        },
+    });
+}
+//# sourceMappingURL=create-agent.js.map

package/dist/create-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent.js","sourceRoot":"","sources":["../src/create-agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAEnG,MAAM,UAAU,WAAW,CAAC,MAAoB,EAAE,IAAgB;IAChE,MAAM,SAAS,GAAG,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;IAE1C,IAAI,MAAM,EAAE,WAAW,EAAE,CAAC;QACxB,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,MAAM,EAAE,QAAQ,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACtD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC/C,MAAM,EAAE,MAAM,CAAC,MAAO;YACtB,KAAK,EAAE,MAAM,CAAC,KAAM;YACpB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;QACH,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;YAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IACxG,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACrE,mGAAmG;IACnG,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,qBAAqB,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IAE9E,OAAO,SAAS,CAAC,UAAU,CAAC;QAC1B,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,QAAQ,CAAC,CAAC,CAAC,OAAO;QAC7D,YAAY,EAAE,MAAM,EAAE,YAAY,IAAI,8BAA8B;QACpE,QAAQ,EAAE,MAAM,EAAE,QAAQ;QAC1B,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE;YACT,mBAAmB,EAAE,OAAO;YAC5B,SAAS,EAAE,GAAG;YACd,mBAAmB,EAAE,CAAC;YACtB,aAAa,EAAE,CAAC;YAChB,oBAAoB,EAAE,MAAM;YAC5B,sBAAsB,EAAE,KAAK;YAC7B,eAAe,EAAE,GAAG;YACpB,YAAY,EAAE,EAAE;YAChB,wBAAwB,EAAE,KAAK;SAChC;QACD,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,KAAK;YACjB,UAAU,EAAE,IAAI;YAChB,aAAa,EAAE;gBACb,eAAe,EAAE,EAAE;aACpB;SACF;KACF,CAAU,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+export { createAgent } from "./create-agent.js";
+export { AgentCore } from "./agent-core.js";
+export { registerProvider, listProviders, } from "./components/llm-provider-hub/providers/registry.js";
+export { AnthropicLLMModelProvider, } from "./components/llm-provider-hub/providers/anthropic-provider.js";
+export { OpenAICompatibleLLMModelProvider, } from "./components/llm-provider-hub/providers/openai-compatible-provider.js";
+export type { AgentConfig, ProviderConfig, ProviderFactory, } from "./components/llm-provider-hub/providers/types.js";
+export type { Agent } from "./components/multi-agent-orchestration/agent/agent.js";
+export type { RunOptions, RunResult } from "./components/multi-agent-orchestration/agent/agent-loop/types.js";
+export { PersistenceHub } from "./components/persistence-hub/persistence-hub.js";
+export { TraceService } from "./components/trace-service/trace-service.js";
+export { ConsoleTraceSink } from "./components/trace-service/console-trace-sink.js";
+export { WebSearchTool } from "./components/tool-hub/built-in-tools/web/web-search-tool.js";
+export type { WebSearchToolOptions } from "./components/tool-hub/built-in-tools/web/web-search-tool.js";
+export { WebExtractTool } from "./components/tool-hub/built-in-tools/web/web-extract-tool.js";
+export type { WebExtractToolOptions } from "./components/tool-hub/built-in-tools/web/web-extract-tool.js";
+export { DuckDuckGoSearchProvider } from "./components/tool-hub/built-in-tools/web/duckduckgo-search-provider.js";
+export type { DuckDuckGoSearchProviderOptions } from "./components/tool-hub/built-in-tools/web/duckduckgo-search-provider.js";
+export type { WebSearchProvider, WebSearchQuery, WebSearchResult, } from "./components/tool-hub/built-in-tools/web/types.js";
+export { ClarifyTool } from "./components/tool-hub/built-in-tools/interaction/clarify-tool.js";
+export { DefaultToolPolicy } from "./components/tool-hub/policies/default-tool-policy.js";
+export type { DefaultToolPolicyOptions } from "./components/tool-hub/policies/default-tool-policy.js";
+export { createWorkspaceTools, WORKSPACE_TOOL_NAMES } from "./components/tool-hub/built-in-tools/workspace/create-workspace-tools.js";
+export { ReadFileTool } from "./components/tool-hub/built-in-tools/workspace/read-file-tool.js";
+export { WriteFileTool } from "./components/tool-hub/built-in-tools/workspace/write-file-tool.js";
+export { EditFileTool } from "./components/tool-hub/built-in-tools/workspace/edit-file-tool.js";
+export { ListFilesTool } from "./components/tool-hub/built-in-tools/workspace/list-files-tool.js";
+export { SearchFilesTool } from "./components/tool-hub/built-in-tools/workspace/search-files-tool.js";
+export { TerminalTool } from "./components/tool-hub/built-in-tools/workspace/terminal-tool.js";
+export { RunCodeTool } from "./components/tool-hub/built-in-tools/workspace/run-code-tool.js";
+export type { WorkspaceToolOptions } from "./components/tool-hub/built-in-tools/workspace/types.js";
+export { SkillManageTool } from "./components/tool-hub/built-in-tools/skills/skill-manage-tool.js";
+export { SkillViewTool } from "./components/tool-hub/built-in-tools/skills/skill-view-tool.js";
+export { SKILL_WORKSPACE_DIR } from "./components/tool-hub/built-in-tools/skills/skill-workspace.js";
+export { SkillHub } from "./components/skill-hub/skill-hub.js";
+export { ESSENTIAL_SKILLS, ESSENTIAL_SKILL_NAMES } from "./components/skill-hub/built-in-skills/essential-skills.js";
+export { parseSkillPackage, normalizeSkillPath, SKILL_LIMITS, SKILL_NAME_PATTERN } from "./components/skill-hub/skill-format.js";
+export type { ParsedSkill } from "./components/skill-hub/skill-format.js";
+export type { Skill, SkillFile, SkillFrontmatter, SkillPackage, SkillSource, } from "./components/skill-hub/types/skill.js";
+export type { AgentSkills } from "./components/skill-hub/types/agent-skills.js";
+export { createArtifactTools, ARTIFACT_TOOL_NAMES } from "./components/tool-hub/built-in-tools/artifacts/create-artifact-tools.js";
+export { SaveArtifactTool } from "./components/tool-hub/built-in-tools/artifacts/save-artifact-tool.js";
+export { UpdateArtifactTool } from "./components/tool-hub/built-in-tools/artifacts/update-artifact-tool.js";
+export { ReadArtifactTool } from "./components/tool-hub/built-in-tools/artifacts/read-artifact-tool.js";
+export { ListArtifactsTool } from "./components/tool-hub/built-in-tools/artifacts/list-artifacts-tool.js";
+export type { ArtifactToolOptions } from "./components/tool-hub/built-in-tools/artifacts/types.js";
+export { ArtifactHub } from "./components/artifact-hub/artifact-hub.js";
+export type { Artifact, ArtifactFile, ArtifactFileStatus, ArtifactOrigin, ArtifactQuery, ArtifactRead, ArtifactReadOptions, ArtifactRef, ArtifactVersion, ArtifactView, ArtifactWrite, SaveArtifactInput, UpdateArtifactInput, } from "./components/artifact-hub/types/artifact.js";
+export type { ArtifactFilter, ArtifactStore } from "./components/persistence-hub/types/artifact-store.js";
+export { MemoryArtifactStore } from "./components/persistence-hub/default-stores/memory-artifact-store.js";
+export { SandboxHub } from "./components/sandbox-hub/sandbox-hub.js";
+export { defaultSandboxApprovalPolicy } from "./components/sandbox-hub/approval-policy.js";
+export { WORKSPACE_ROOT, AGENTS_DIR, agentLayout, isWithinRoots, resolveLogicalPath, } from "./components/sandbox-hub/logical-path.js";
+export type { DirEntry, EntryType, SandboxCapability, SandboxKind, SandboxLimits, SandboxTraits, ExecOptions, ExecRequest, ExecResult, SandboxView, FileContent, FileStat, ListOptions, ListResult, OpOptions, ReadOptions, SearchMatch, SearchQuery, SearchResult, WriteOptions, WriteResult, Sandbox, } from "./components/sandbox-hub/types/sandbox.js";
+export type { CreateSandboxContext, SandboxSpec, ResourceLimits, SandboxProvider, } from "./components/sandbox-hub/types/provider.js";
+export type { OwnSandboxConfig, SandboxApprovalPolicy, SandboxHubPolicy, SandboxOperation, SandboxSelection, } from "./components/sandbox-hub/types/policy.js";
+export { DockerSandboxProvider, DOCKER_DEFAULT_LIMITS } from "./components/sandbox-hub/docker/docker-sandbox-provider.js";
+export type { DockerSandboxSettings } from "./components/sandbox-hub/docker/docker-sandbox-provider.js";
+export type { DockerSandbox } from "./components/sandbox-hub/docker/docker-sandbox.js";
+export type { DockerSandboxProviderOptions } from "./components/sandbox-hub/docker/types.js";
+export { AEC_SANDBOX_IMAGE, AEC_SANDBOX_DOCKERFILE } from "./components/sandbox-hub/docker/aec-sandbox-image.js";
+export { HostSandboxProvider, HOST_DEFAULT_LIMITS } from "./components/sandbox-hub/host/host-sandbox-provider.js";
+export type { HostSandboxProviderOptions } from "./components/sandbox-hub/host/host-sandbox-provider.js";
+export type { HostSandbox } from "./components/sandbox-hub/host/host-sandbox.js";
+export { LLMProviderHub } from "./components/llm-provider-hub/llm-provider-hub.js";
+export { BedrockLLMModelProvider, } from "./components/llm-provider-hub/providers/bedrock-provider.js";
+export { OpenAISubscriptionProvider, } from "./components/llm-provider-hub/providers/openai-subscription-provider.js";
+export { resolveProvider } from "./components/llm-provider-hub/providers/registry.js";
+export type { Plugin } from "./kernel/interfaces/plugin.js";
+export type { Kernel } from "./kernel/interfaces/kernel.js";
+export type { LLMModelProvider, ModelOptions, LLMModelInfo, LLMModelCapabilities, LLMModelPricing, LLMModelRecord, } from "./components/llm-provider-hub/types.js";
+export { toLLMModelRecord } from "./components/llm-provider-hub/types.js";
+export type { ApprovalDecision, ApprovalRequest, AuthorizationHook, ClarifyRequest, ClarifyResponse, InteractionHandler, JsonSchema, ToolContext, ToolDefinition, ToolHandler, ToolOutput, ToolPolicy, ToolPolicyDecision, ToolRisk, } from "./components/tool-hub/types.js";
+export type { EventBus, EventHandler, Unsubscribe } from "./components/event-handler/types.js";
+export type { AgentStore } from "./components/persistence-hub/types/agent-store.js";
+export type { ProviderRecord, ProviderStore, } from "./components/persistence-hub/types/provider-store.js";
+export type { SessionStore } from "./components/persistence-hub/types/session-store.js";
+export type { MessageStore, MessageStoreSlice, } from "./components/persistence-hub/types/message-store.js";
+export type { MemoryStore, MemoryFilter } from "./components/persistence-hub/types/memory-store.js";
+export type { SkillRecord, SkillStore } from "./components/persistence-hub/types/skill-store.js";
+export type { Middleware, MiddlewareContext, } from "./components/multi-agent-orchestration/agent/context-manager/types.js";
+export type { ScheduledJobContext, ScheduledJobDefinition, ScheduledJobHandler, ScheduledJobOutput, } from "./components/multi-agent-orchestration/agent/scheduled-job-manager/types.js";
+export type { AgentProfile, } from "./components/multi-agent-orchestration/agent/types.js";
+export type { CompactorConfig, CompactorResult, } from "./components/multi-agent-orchestration/agent/agent-loop/components/compactor.types.js";
+export type { ConsolidationTrigger, MemoryConfig, MemoryRecallConfig, } from "./components/multi-agent-orchestration/agent/memory-system/types/config.js";
+export type { TraceSink } from "./components/trace-service/types/sink.js";
+export type { Event, Message, ModelResponse, Session, SessionFilter, StreamChunk, TokenUsage, ToolCall, ToolCallProgress, ToolResult, } from "./kernel/types.js";
+export { SDKEventType } from "./components/event-handler/events.js";
+export type { ArtifactDeletedPayload, ArtifactWrittenPayload, SDKEventTypeValue, SDKEventPayloadMap, UserMessagePayload, IterationPayload, ModelRequestedPayload, ModelRespondedPayload, DispatchStartPayload, DispatchEndPayload, DispatchRetryPayload, DispatchFailedPayload, ToolDeniedPayload, ToolApprovalRequestedPayload, ToolApprovalResolvedPayload, RunCompletedPayload, MaxIterationsPayload, JobCompletedPayload, JobFailedPayload, } from "./components/event-handler/events.js";
+export { SDKError } from "./kernel/errors/sdk-error.js";
+export { ModelError } from "./kernel/errors/model-error.js";
+export type { ModelErrorCode } from "./kernel/errors/model-error.js";
+export { ToolError } from "./kernel/errors/tool-error.js";
+export type { ToolErrorCode } from "./kernel/errors/tool-error.js";
+export { PolicyError } from "./kernel/errors/policy-error.js";
+export type { PolicyErrorCode } from "./kernel/errors/policy-error.js";
+export { SessionError } from "./kernel/errors/session-error.js";
+export type { SessionErrorCode } from "./kernel/errors/session-error.js";
+export { SkillError } from "./kernel/errors/skill-error.js";
+export { SandboxError } from "./kernel/errors/sandbox-error.js";
+export { ArtifactError } from "./kernel/errors/artifact-error.js";
+export type { ArtifactErrorCode } from "./kernel/errors/artifact-error.js";
+export type { SandboxErrorCode } from "./kernel/errors/sandbox-error.js";
+export type { SkillErrorCode } from "./kernel/errors/skill-error.js";
+export type { TraceSpan, SpanKind, SpanStatus, SpanEvent, SpanHandle, TraceContext, } from "./components/trace-service/types/span.js";
+export { MockLLMModelProvider } from "./testing/mock-llm-model-provider.js";
+export { InMemorySessionStore } from "./testing/mock-session-store.js";
+export { ScheduleLookupTool, BudgetQueryTool, DocumentSearchTool, SendRfiTool } from "./testing/mock-tools.js";
+export { InMemorySandboxProvider } from "./testing/in-memory-sandbox.js";
+export type { InMemorySandboxProviderOptions } from "./testing/in-memory-sandbox.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,aAAa,GACd,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EACL,yBAAyB,GAC1B,MAAM,+DAA+D,CAAC;AACvE,OAAO,EACL,gCAAgC,GACjC,MAAM,uEAAuE,CAAC;AAC/E,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,kDAAkD,CAAC;AAC1D,YAAY,EAAE,KAAK,EAAE,MAAM,uDAAuD,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kEAAkE,CAAC;AAC9G,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAGpF,OAAO,EAAE,aAAa,EAAE,MAAM,6DAA6D,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,YAAY,EAAE,qBAAqB,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,wBAAwB,EAAE,MAAM,wEAAwE,CAAC;AAClH,YAAY,EAAE,+BAA+B,EAAE,MAAM,wEAAwE,CAAC;AAC9H,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kEAAkE,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,YAAY,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAEtG,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0EAA0E,CAAC;AACtI,OAAO,EAAE,YAAY,EAAE,MAAM,kEAAkE,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,mEAAmE,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,kEAAkE,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,mEAAmE,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,qEAAqE,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,MAAM,iEAAiE,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,iEAAiE,CAAC;AAC9F,YAAY,EAAE,oBAAoB,EAAE,MAAM,yDAAyD,CAAC;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,kEAAkE,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,gEAAgE,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,gEAAgE,CAAC;AAGrG,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AACjI,YAAY,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EACV,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAGhF,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,yEAAyE,CAAC;AACnI,OAAO,EAAE,gBAAgB,EAAE,MAAM,sEAAsE,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wEAAwE,CAAC;AAC5G,OAAO,EAAE,gBAAgB,EAAE,MAAM,sEAAsE,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uEAAuE,CAAC;AAC1G,YAAY,EAAE,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AAGnG,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACxE,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,6CAA6C,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sDAAsD,CAAC;AAC1G,OAAO,EAAE,mBAAmB,EAAE,MAAM,sEAAsE,CAAC;AAG3G,OAAO,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EACL,cAAc,EAEd,UAAU,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,0CAA0C,CAAC;AAClD,YAAY,EACV,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,OAAO,GACR,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AAC1H,YAAY,EAAE,qBAAqB,EAAE,MAAM,4DAA4D,CAAC;AACxG,YAAY,EAAE,aAAa,EAAE,MAAM,mDAAmD,CAAC;AACvF,YAAY,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAEjH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAClH,YAAY,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACzG,YAAY,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAGjF,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EACL,uBAAuB,GACxB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EACL,0BAA0B,GAC3B,MAAM,yEAAyE,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AAGtF,YAAY,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,QAAQ,GACT,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAC/F,YAAY,EAAE,UAAU,EAAE,MAAM,mDAAmD,CAAC;AACpF,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,sDAAsD,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACxF,YAAY,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,qDAAqD,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oDAAoD,CAAC;AACpG,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mDAAmD,CAAC;AACjG,YAAY,EACV,UAAU,EACV,iBAAiB,GAClB,MAAM,uEAAuE,CAAC;AAC/E,YAAY,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6EAA6E,CAAC;AACrF,YAAY,EACV,YAAY,GACb,MAAM,uDAAuD,CAAC;AAC/D,YAAY,EACV,eAAe,EACf,eAAe,GAChB,MAAM,uFAAuF,CAAC;AAC/F,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,GACnB,MAAM,4EAA4E,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,YAAY,EACV,KAAK,EACL,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,YAAY,EACV,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,GACb,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC/G,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,YAAY,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC"}