@adhd/agent-store-prompts 2.1.0

package/src/seed/prompt-types.js

@@ -0,0 +1,107 @@
+/**
+ * seed/prompt-types.ts
+ *
+ * Every system prompt type that ships with @adhd/agent-registry.
+ * These map 1:1 to rows in registry_prompt_types (is_system = true).
+ *
+ * Source: docs/plan/agent-registry/SEED_DATA.md §1
+ * [inv:lookup-not-enum] — types are rows, not SQL enums. Adding a new type
+ * is a seed operation, not a migration.
+ */
+/**
+ * All system prompt types for the registry.
+ * Array ordering is cosmetic — types are keyed by slug in the DB.
+ */
+export const PROMPT_TYPES = [
+    {
+        slug: 'role',
+        description: 'Fundamental agent identity — what the agent is',
+        isSystem: true,
+    },
+    {
+        slug: 'identity',
+        description: 'Mission, refusal boundaries, communication style, learning posture',
+        isSystem: true,
+    },
+    {
+        slug: 'capability',
+        description: 'Domain knowledge and specialization claims',
+        isSystem: true,
+    },
+    {
+        slug: 'rule',
+        description: 'Hard invariants and constraints that must always apply',
+        isSystem: true,
+    },
+    {
+        slug: 'style',
+        description: 'Tone, formatting conventions, output structure preferences',
+        isSystem: true,
+    },
+    {
+        slug: 'personality',
+        description: 'Behavioral characteristics that persist across interaction types',
+        isSystem: true,
+    },
+    {
+        slug: 'process',
+        description: 'Step-by-step workflow the agent follows when invoked',
+        isSystem: true,
+    },
+    {
+        slug: 'invocation',
+        description: 'Activation card: trigger phrase, required inputs, expected outputs, deliverable',
+        isSystem: true,
+    },
+    {
+        slug: 'success_criteria',
+        description: 'Typed criteria for evaluating agent output — gate-readable',
+        isSystem: true,
+    },
+    {
+        slug: 'handoff',
+        description: 'Section template for inter-agent state transfer',
+        isSystem: true,
+    },
+    {
+        slug: 'escalation',
+        description: 'Structured report template for escalation events',
+        isSystem: true,
+    },
+    {
+        slug: 'posture',
+        description: 'Default verdict stance for reviewers (NEEDS-WORK vs. APPROVE)',
+        isSystem: true,
+    },
+    {
+        slug: 'boundary',
+        description: 'Explicit declarations of what the agent will not do',
+        isSystem: true,
+    },
+    {
+        slug: 'convergence',
+        description: 'N-agent synthesis pattern: fan-out → synthesizer → decision',
+        isSystem: true,
+    },
+    {
+        slug: 'deliverable',
+        description: 'Concrete output format template with annotated example',
+        isSystem: true,
+    },
+    {
+        slug: 'evidence',
+        description: 'Typed evidence fields required before a verdict is accepted',
+        isSystem: true,
+    },
+    {
+        slug: 'context_pull',
+        description: 'Pull-loop pattern: claim ticket → read context → work → finish with handoff',
+        isSystem: true,
+    },
+    {
+        slug: 'risk_posture',
+        description: 'Risk category awareness and escalation trigger conditions',
+        isSystem: true,
+    },
+];
+//# sourceMappingURL=prompt-types.js.map

package/src/seed/prompt-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-types.js","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-prompts/src/seed/prompt-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gDAAgD;QAC7D,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,oEAAoE;QACtE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,kEAAkE;QACpE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sDAAsD;QACnE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,iFAAiF;QACnF,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EACT,+DAA+D;QACjE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,6EAA6E;QAC/E,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2DAA2D;QACxE,QAAQ,EAAE,IAAI;KACf;CACF,CAAC"}

package/src/store/agent-store.d.ts

@@ -0,0 +1,113 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+export declare class AgentError extends Error {
+    readonly code: 'AGENT_NOT_FOUND' | 'CATEGORY_NOT_FOUND';
+    constructor(code: 'AGENT_NOT_FOUND' | 'CATEGORY_NOT_FOUND', message: string);
+}
+/** Agent status values. Plain text — not a SQL enum. [inv:lookup-not-enum] */
+export type AgentStatus = 'draft' | 'active' | 'deprecated';
+/** Default posture for human-in-the-loop decisions. */
+export type AgentPosture = 'approve' | 'needs_work';
+export interface TaxonomyCategory {
+    slug: string;
+    name: string;
+    description: string;
+    /** Integer ordering key, replaces the `01-`/`02-` directory-prefix convention. */
+    position: number;
+    /** Nullable parent slug for subcategory nesting. */
+    parentSlug: string | null;
+}
+export interface TaxonomyCategoryCreateInput {
+    slug: string;
+    name: string;
+    description?: string;
+    position?: number;
+    parentSlug?: string | null;
+}
+export interface Agent {
+    slug: string;
+    displayName: string;
+    description: string;
+    /** 'draft' | 'active' | 'deprecated' */
+    status: AgentStatus;
+    /**
+     * Canonical model id — a string, NOT an FK.
+     * Resolved at compile time by @adhd/agent-provider (Decision 1: no cross-package FK).
+     */
+    modelHint: string | null;
+    /** In-package FK → registry_taxonomy_categories.slug (nullable). */
+    taxonomyCategory: string | null;
+    /** 'approve' | 'needs_work' */
+    defaultPosture: AgentPosture;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentCreateInput {
+    slug: string;
+    displayName: string;
+    description?: string;
+    status?: AgentStatus;
+    modelHint?: string | null;
+    taxonomyCategory?: string | null;
+    defaultPosture?: AgentPosture;
+}
+export interface AgentUpdateInput {
+    displayName?: string;
+    description?: string;
+    status?: AgentStatus;
+    modelHint?: string | null;
+    taxonomyCategory?: string | null;
+    defaultPosture?: AgentPosture;
+}
+export interface AgentListFilter {
+    /** Filter to agents in this taxonomy category slug. */
+    category?: string;
+    /** Filter to agents with this status. */
+    status?: AgentStatus;
+}
+export declare class TaxonomyStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<any>);
+    /**
+     * Insert a new taxonomy category.
+     * Throws if the slug already exists (use the returned row for idempotent seeding).
+     */
+    createCategory(input: TaxonomyCategoryCreateInput): TaxonomyCategory;
+    /**
+     * List all categories ordered by position ASC, then slug ASC for stability.
+     * This ordering replaces the `01-`/`02-` directory-prefix convention.
+     */
+    listCategories(): TaxonomyCategory[];
+}
+export declare class AgentStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<any>);
+    /**
+     * Create a new agent metadata row.
+     * Does not associate prompt components — that is handled by the
+     * composition-junction state.
+     */
+    create(input: AgentCreateInput): Agent;
+    /**
+     * Read an agent by slug.
+     * Throws AGENT_NOT_FOUND if the slug does not exist.
+     */
+    read(slug: string): Agent;
+    /**
+     * Update mutable fields of an agent by slug.
+     * Throws AGENT_NOT_FOUND if the slug does not exist.
+     * Returns the updated agent.
+     */
+    update(slug: string, input: AgentUpdateInput): Agent;
+    /**
+     * Delete an agent by slug.
+     * Throws AGENT_NOT_FOUND if the slug does not exist.
+     */
+    delete(slug: string): void;
+    /**
+     * List agents, optionally filtered by category and/or status.
+     * Results are ordered by slug ASC for stable output.
+     */
+    list(filter?: AgentListFilter): Agent[];
+    private _rowToAgent;
+}
+//# sourceMappingURL=agent-store.d.ts.map

package/src/store/agent-store.d.ts.map

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

package/src/store/agent-store.js

@@ -0,0 +1,211 @@
+import { asc, eq, and } from 'drizzle-orm';
+import { agentsTable, taxonomyCategoriesTable } from '../db/schema.js';
+// ──────────────────────────────────────────────
+// Error codes
+// ──────────────────────────────────────────────
+export class AgentError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentError';
+    }
+}
+// ──────────────────────────────────────────────
+// TaxonomyStore
+//
+// Thin Drizzle wrapper for registry_taxonomy_categories.
+// Mirrors the store-class pattern in entrypoint/agent-mcp's AgentStore (agent-cache-store pattern)
+// [ref:store-class] (contexts/_shared.md)
+// ──────────────────────────────────────────────
+export class TaxonomyStore {
+    db;
+    constructor(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db) {
+        this.db = db;
+    }
+    /**
+     * Insert a new taxonomy category.
+     * Throws if the slug already exists (use the returned row for idempotent seeding).
+     */
+    createCategory(input) {
+        const row = {
+            slug: input.slug,
+            name: input.name,
+            description: input.description ?? '',
+            position: input.position ?? 0,
+            parentSlug: input.parentSlug ?? null,
+        };
+        this.db
+            .insert(taxonomyCategoriesTable)
+            .values({
+            slug: row.slug,
+            name: row.name,
+            description: row.description,
+            position: row.position,
+            parentSlug: row.parentSlug,
+        })
+            .run();
+        return row;
+    }
+    /**
+     * List all categories ordered by position ASC, then slug ASC for stability.
+     * This ordering replaces the `01-`/`02-` directory-prefix convention.
+     */
+    listCategories() {
+        const rows = this.db
+            .select()
+            .from(taxonomyCategoriesTable)
+            .orderBy(asc(taxonomyCategoriesTable.position), asc(taxonomyCategoriesTable.slug))
+            .all();
+        return rows.map((r) => ({
+            slug: r.slug,
+            name: r.name,
+            description: r.description,
+            position: r.position,
+            parentSlug: r.parentSlug ?? null,
+        }));
+    }
+}
+// ──────────────────────────────────────────────
+// AgentStore
+//
+// Thin Drizzle wrapper for registry_agents.
+// [ref:store-class] (contexts/_shared.md)
+// ──────────────────────────────────────────────
+export class AgentStore {
+    db;
+    constructor(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    db) {
+        this.db = db;
+    }
+    /**
+     * Create a new agent metadata row.
+     * Does not associate prompt components — that is handled by the
+     * composition-junction state.
+     */
+    create(input) {
+        const now = new Date().toISOString();
+        const row = {
+            slug: input.slug,
+            displayName: input.displayName,
+            description: input.description ?? '',
+            status: input.status ?? 'draft',
+            modelHint: input.modelHint ?? null,
+            taxonomyCategory: input.taxonomyCategory ?? null,
+            defaultPosture: input.defaultPosture ?? 'needs_work',
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.db
+            .insert(agentsTable)
+            .values({
+            slug: row.slug,
+            displayName: row.displayName,
+            description: row.description,
+            status: row.status,
+            modelHint: row.modelHint,
+            taxonomyCategory: row.taxonomyCategory,
+            defaultPosture: row.defaultPosture,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+        })
+            .run();
+        return row;
+    }
+    /**
+     * Read an agent by slug.
+     * Throws AGENT_NOT_FOUND if the slug does not exist.
+     */
+    read(slug) {
+        const row = this.db
+            .select()
+            .from(agentsTable)
+            .where(eq(agentsTable.slug, slug))
+            .get();
+        if (!row) {
+            throw new AgentError('AGENT_NOT_FOUND', `Agent '${slug}' not found`);
+        }
+        return this._rowToAgent(row);
+    }
+    /**
+     * Update mutable fields of an agent by slug.
+     * Throws AGENT_NOT_FOUND if the slug does not exist.
+     * Returns the updated agent.
+     */
+    update(slug, input) {
+        // Verify existence first
+        this.read(slug); // throws AGENT_NOT_FOUND if missing
+        const now = new Date().toISOString();
+        this.db
+            .update(agentsTable)
+            .set({
+            ...(input.displayName !== undefined && {
+                displayName: input.displayName,
+            }),
+            ...(input.description !== undefined && {
+                description: input.description,
+            }),
+            ...(input.status !== undefined && { status: input.status }),
+            ...(input.modelHint !== undefined && { modelHint: input.modelHint }),
+            ...(input.taxonomyCategory !== undefined && {
+                taxonomyCategory: input.taxonomyCategory,
+            }),
+            ...(input.defaultPosture !== undefined && {
+                defaultPosture: input.defaultPosture,
+            }),
+            updatedAt: now,
+        })
+            .where(eq(agentsTable.slug, slug))
+            .run();
+        return this.read(slug);
+    }
+    /**
+     * Delete an agent by slug.
+     * Throws AGENT_NOT_FOUND if the slug does not exist.
+     */
+    delete(slug) {
+        this.read(slug); // throws AGENT_NOT_FOUND if missing
+        this.db.delete(agentsTable).where(eq(agentsTable.slug, slug)).run();
+    }
+    /**
+     * List agents, optionally filtered by category and/or status.
+     * Results are ordered by slug ASC for stable output.
+     */
+    list(filter = {}) {
+        const conditions = [];
+        if (filter.category !== undefined) {
+            conditions.push(eq(agentsTable.taxonomyCategory, filter.category));
+        }
+        if (filter.status !== undefined) {
+            conditions.push(eq(agentsTable.status, filter.status));
+        }
+        let query = this.db
+            .select()
+            .from(agentsTable)
+            .orderBy(asc(agentsTable.slug));
+        if (conditions.length > 0) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            query = query.where(and(...conditions));
+        }
+        const rows = query.all();
+        return rows.map((r) => this._rowToAgent(r));
+    }
+    // ── Private helpers ───────────────────────
+    _rowToAgent(row) {
+        return {
+            slug: row.slug,
+            displayName: row.displayName,
+            description: row.description,
+            status: row.status,
+            modelHint: row.modelHint ?? null,
+            taxonomyCategory: row.taxonomyCategory ?? null,
+            defaultPosture: row.defaultPosture,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+        };
+    }
+}
+//# sourceMappingURL=agent-store.js.map

package/src/store/agent-store.js.map

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

package/src/store/component-store.d.ts

@@ -0,0 +1,87 @@
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+export declare class ComponentError extends Error {
+    readonly code: 'COMPONENT_NOT_FOUND' | 'COMPONENT_TYPE_NOT_FOUND' | 'COMPONENT_VERSION_NOT_FOUND';
+    constructor(code: 'COMPONENT_NOT_FOUND' | 'COMPONENT_TYPE_NOT_FOUND' | 'COMPONENT_VERSION_NOT_FOUND', message: string);
+}
+export interface PromptType {
+    slug: string;
+    description: string;
+    isSystem: boolean;
+}
+export interface PromptComponent {
+    slug: string;
+    type: string;
+    version: number;
+    /**
+     * The registry_component_versions.version_id surrogate for THIS version row.
+     * Stable, single-column — this is what a junction `version_pin` stores when an
+     * exact version is pinned (Decision 5). Resolve a `(slug, version)` pair to it
+     * with {@link ComponentStore.resolveVersionId}.
+     */
+    versionId: number;
+    content: string;
+    isShared: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ComponentCreateInput {
+    slug: string;
+    type: string;
+    content: string;
+    isShared?: boolean;
+}
+export interface ComponentListFilter {
+    type?: string;
+    shared?: boolean;
+}
+export declare class ComponentStore {
+    private readonly db;
+    constructor(db: BetterSQLite3Database<any>);
+    /** Insert a prompt type. No-op if the slug already exists. */
+    upsertType(input: PromptType): PromptType;
+    /** Read a prompt type by slug. Throws COMPONENT_TYPE_NOT_FOUND if absent. */
+    readType(slug: string): PromptType;
+    /**
+     * Create a new component: insert the head identity row plus its version-1
+     * history row, in ONE transaction (Decision 5).
+     *
+     * [inv:version-retained]: each later call to version() appends a NEW version
+     * row at version+1; it never overwrites a prior version.
+     */
+    create(input: ComponentCreateInput): PromptComponent;
+    /**
+     * Read the latest version of a component by slug (head joined to its highest
+     * version row).
+     * Throws COMPONENT_NOT_FOUND if no head row exists for the slug.
+     */
+    read(slug: string): PromptComponent;
+    /**
+     * Read a specific version of a component.
+     * Throws COMPONENT_VERSION_NOT_FOUND if that exact (slug, version) row is absent,
+     * or COMPONENT_NOT_FOUND if the head identity row is absent.
+     */
+    readVersion(slug: string, version: number): PromptComponent;
+    /**
+     * Resolve a `(slug, version)` pair to its stable registry_component_versions
+     * .version_id surrogate — the value a junction `version_pin` stores when an
+     * exact version is pinned (Decision 5).
+     *
+     * Throws COMPONENT_VERSION_NOT_FOUND if that exact version row is absent.
+     */
+    resolveVersionId(slug: string, version: number): number;
+    /**
+     * Bump a component to a new version with updated content.
+     * Appends a NEW version row at max(existing version) + 1 for the slug — the head
+     * identity row is unchanged and old version rows are NEVER deleted.
+     * [inv:version-retained]
+     */
+    version(slug: string, newContent: string): PromptComponent;
+    /**
+     * List the latest version of each component, optionally filtered by type
+     * and/or shared flag. Joins each head to its highest version row.
+     */
+    list(filter?: ComponentListFilter): PromptComponent[];
+    /** Join a head identity row to one version row into a PromptComponent. */
+    private _join;
+}
+//# sourceMappingURL=component-store.d.ts.map

package/src/store/component-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-store.d.ts","sourceRoot":"","sources":["../../../../../../packages/agent/agent-store-prompts/src/store/component-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAYxE,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAChB,qBAAqB,GACrB,0BAA0B,GAC1B,6BAA6B;gBAHjB,IAAI,EAChB,qBAAqB,GACrB,0BAA0B,GAC1B,6BAA6B,EACjC,OAAO,EAAE,MAAM;CAKlB;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAmBD,qBAAa,cAAc;IAGvB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC;IAKjD,8DAA8D;IAC9D,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IAazC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAuBlC;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAgDpD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAkCnC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe;IAmC3D;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAsBvD;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe;IAyD1D;;;OAGG;IACH,IAAI,CAAC,MAAM,GAAE,mBAAwB,GAAG,eAAe,EAAE;IAoEzD,0EAA0E;IAC1E,OAAO,CAAC,KAAK;CAyBd"}