@calliopelabs/cli 3.0.0 → 3.2.0

package/dist/goals/types.d.ts

@@ -0,0 +1,174 @@
+import type { ProjectIdentity, ProjectPlan, PathGrant, GoalRunLink } from '../orchestration/types.js';
+import type { SupervisionPolicy } from '../supervision/types.js';
+export interface GoalLimits {
+    tokenBudget: number;
+    costBudgetNanos: number;
+    timeBudgetMs: number;
+    planningTokens: number;
+    planningCostNanos: number;
+    planningTimeMs: number;
+    maxOutputTokens: number;
+    maxAgents: number;
+    maxTasks: number;
+    maxDepth: number;
+    maxConcurrent: number;
+}
+export interface GoalManifest {
+    version: 1 | 2 | 3 | 4 | 5;
+    id: string;
+    createdAt: string;
+    deadline: number;
+    project: ProjectIdentity;
+    runsRoot: string;
+    goal: string;
+    preference: {
+        provider: string;
+        model?: string;
+    };
+    workspace: {
+        allowedTools: string[];
+        allowedPaths: PathGrant[];
+    };
+    limits: GoalLimits;
+    team?: GoalTeam;
+    supervision?: GoalSupervision;
+    planningRepair?: {
+        version: 1;
+        maxRetries: number;
+    };
+    hash: string;
+    routing?: import('./routing.js').GoalRouting;
+}
+/** Operator intent captured before planning; the proposed graph supplies account IDs. */
+export interface GoalSupervision extends Pick<SupervisionPolicy, 'version' | 'maxRounds' | 'maxStalledRounds' | 'maxOutputTokens' | 'principle' | 'allowedActions' | 'reasoningEffort'> {
+    image: string;
+    controller?: GoalManifest['preference'];
+    reviewer?: GoalManifest['preference'];
+}
+export interface GoalTeam {
+    version: 1;
+    reviewer?: GoalManifest['preference'];
+    workers?: GoalManifest['preference'];
+    maxAttempts?: number;
+}
+export interface GoalAllocation {
+    id: string;
+    phase: 'planning' | 'execution';
+    runId: string;
+    planHash: string;
+    tokens: number;
+    costNanos: number;
+    deadline: number;
+}
+export interface PlanningSpend {
+    tokens: number;
+    costNanos: number;
+    revision: string;
+}
+export type ProposalSource = {
+    kind: 'agent';
+    runId: string;
+    artifactId: string;
+    artifactHash: string;
+    eventId: string;
+} | {
+    kind: 'human';
+    path: string;
+    sha256: string;
+};
+export interface GoalProposal {
+    version: 1;
+    goalId: string;
+    goalManifestHash: string;
+    plan: ProjectPlan;
+    planHash: string;
+    knowledgeStatus: 'proposed';
+    confidence: null;
+    inferred: boolean;
+    source: ProposalSource;
+    hash: string;
+}
+export type GoalStatus = 'created' | 'planning' | 'review_required' | 'approved' | 'running' | 'partial' | 'completed' | 'failed' | 'denied' | 'cancelled';
+export type GoalChange = {
+    type: 'planning_allocated';
+    allocation: GoalAllocation;
+} | {
+    type: 'planning_finished';
+    status: 'review_required' | 'failed' | 'denied' | 'cancelled';
+    spend: PlanningSpend | null;
+    proposalHash: string | null;
+    reason: string;
+} | {
+    type: 'proposal_revised';
+    proposalHash: string;
+} | {
+    type: 'execution_allocated';
+    allocation: GoalAllocation;
+    proposalHash: string;
+    source: 'cli' | 'repl';
+} | {
+    type: 'execution_started';
+    runId: string;
+} | {
+    type: 'execution_interrupted';
+    runId: string;
+    status: 'failed' | 'denied' | 'cancelled';
+    reason: string;
+} | {
+    type: 'execution_finished';
+    runId: string;
+    revision: string;
+    status: 'completed' | 'partial' | 'failed' | 'denied' | 'cancelled';
+    completed: number;
+    total: number;
+} | {
+    type: 'cancelled';
+    source: 'cli' | 'repl';
+};
+export interface GoalEvent {
+    version: 1;
+    id: string;
+    goalId: string;
+    sequence: number;
+    at: string;
+    previous: string;
+    change: GoalChange;
+    hash: string;
+}
+export interface GoalProjection {
+    version: 1;
+    id: string;
+    revision: string;
+    status: GoalStatus;
+    revoked: boolean;
+    planning: GoalAllocation | null;
+    execution: GoalAllocation | null;
+    planningSpend: PlanningSpend | null;
+    planningFrozen: boolean;
+    proposalHash: string | null;
+    approvedProposalHash: string | null;
+    result: {
+        runId: string;
+        revision: string;
+        status: GoalStatus;
+        completed: number;
+        total: number;
+    } | null;
+}
+export interface GoalInspection {
+    manifest: GoalManifest;
+    events: GoalEvent[];
+    state: GoalProjection;
+    proposal: GoalProposal | null;
+}
+export interface GoalOwner {
+    id: string;
+    check: () => void;
+    release: () => void;
+}
+export interface BoundRun {
+    id: string;
+    createdAt: string;
+    goal: GoalRunLink;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/goals/types.d.ts.map

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

package/dist/goals/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/goals/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/goals/types.ts"],"names":[],"mappings":""}

package/dist/goals/validation.d.ts

@@ -0,0 +1,17 @@
+import type { GoalRunLink } from '../orchestration/types.js';
+import type { GoalManifest, GoalProposal, GoalAllocation, GoalLimits, PlanningSpend, ProposalSource } from './types.js';
+export declare const GOAL_TOOLS: string[];
+export declare const MAX_GOAL_EVENTS = 10000, MAX_GOAL_BYTES: number, MAX_GOAL_EVENT_BYTES = 16384;
+export declare const signed: <T extends object>(body: T) => T & {
+    hash: string;
+};
+export declare function verifyHash(value: Record<string, unknown>): void;
+export declare function validateGoalLimits(value: unknown): GoalLimits;
+export declare function validateGoalManifest(value: unknown): GoalManifest;
+export declare function validateGoalLink(value: unknown): GoalRunLink;
+export declare function validateAllocation(value: unknown, manifest: GoalManifest, phase: 'planning' | 'execution'): GoalAllocation;
+export declare function validatePlanningSpend(value: unknown): PlanningSpend;
+export declare function validateProposalSource(value: unknown): ProposalSource;
+export declare function validateGoalProposal(value: unknown, manifest: GoalManifest, spend?: PlanningSpend): GoalProposal;
+export declare function assertGoalProject(manifest: GoalManifest, cwd?: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/goals/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/goals/validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAC,YAAY,EAAC,YAAY,EAAC,cAAc,EAAC,UAAU,EAAC,aAAa,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAKjH,eAAO,MAAM,UAAU,UAA0F,CAAC;AAClH,eAAO,MAAM,eAAe,QAAM,EAAC,cAAc,QAAa,EAAC,oBAAoB,QAAM,CAAC;AAC1F,eAAO,MAAM,MAAM,GAAE,CAAC,SAAS,MAAM,QAAO,CAAC,KAAE,CAAC,GAAC;IAAC,IAAI,EAAC,MAAM,CAAA;CAA+C,CAAC;AAC7G,wBAAgB,UAAU,CAAC,KAAK,EAAC,MAAM,CAAC,MAAM,EAAC,OAAO,CAAC,GAAE,IAAI,CAAqH;AAClL,wBAAgB,kBAAkB,CAAC,KAAK,EAAC,OAAO,GAAE,UAAU,CAK3D;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAC,OAAO,GAAE,YAAY,CAe/D;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAC,OAAO,GAAE,WAAW,CAG1D;AACD,wBAAgB,kBAAkB,CAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,EAAC,YAAY,EAAC,KAAK,EAAC,UAAU,GAAC,WAAW,GAAE,cAAc,CAIlH;AACD,wBAAgB,qBAAqB,CAAC,KAAK,EAAC,OAAO,GAAE,aAAa,CAEjE;AACD,wBAAgB,sBAAsB,CAAC,KAAK,EAAC,OAAO,GAAE,cAAc,CAInE;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,EAAC,YAAY,EAAC,KAAK,CAAC,EAAC,aAAa,GAAE,YAAY,CAa1G;AACD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAC,YAAY,EAAC,GAAG,SAAsB,GAAE,IAAI,CAEtF"}

package/dist/goals/validation.js

@@ -0,0 +1,172 @@
+import { isAbsolute } from 'node:path';
+import { canonicalJson, digest, projectIdentity } from '../approvals/index.js';
+import { getProviderNames } from '../config.js';
+import { analyzePlan, array, shape, integer, text, strings, pathName, uuid, hex, iso, permits, fail, MAX_PLAN_BYTES } from '../orchestration/validation.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { validateGoalTeam } from './team.js';
+import { validateGoalRouting, applyGoalRouting } from './routing.js';
+import { validateGoalSupervision, validateSupervisedGoalPlan } from './supervised.js';
+export const GOAL_TOOLS = ['think', 'read_file', 'list_files', 'write_file', 'edit_file', 'brain_search', 'brain_entity'];
+export const MAX_GOAL_EVENTS = 10000, MAX_GOAL_BYTES = 16 * 1024 * 1024, MAX_GOAL_EVENT_BYTES = 16384;
+export const signed = (body) => ({ ...body, hash: digest(canonicalJson(body)) });
+export function verifyHash(value) { const { hash, ...body } = value; if (!hex(hash) || digest(canonicalJson(body)) !== hash)
+    fail('Goal record hash is invalid.'); }
+export function validateGoalLimits(value) {
+    shape(value, ['tokenBudget', 'costBudgetNanos', 'timeBudgetMs', 'planningTokens', 'planningCostNanos', 'planningTimeMs', 'maxOutputTokens', 'maxAgents', 'maxTasks', 'maxDepth', 'maxConcurrent']);
+    integer(value.tokenBudget, 2, 100000000);
+    integer(value.costBudgetNanos, 0, 1e13);
+    integer(value.timeBudgetMs, 2, 86400000);
+    integer(value.planningTokens, 1, value.tokenBudget - 1);
+    integer(value.planningCostNanos, 0, value.costBudgetNanos);
+    integer(value.planningTimeMs, 1, value.timeBudgetMs);
+    integer(value.maxOutputTokens, 1, value.planningTokens);
+    integer(value.maxAgents, 1, 256);
+    integer(value.maxTasks, 1, 1024);
+    integer(value.maxDepth, 0, 8);
+    integer(value.maxConcurrent, 1, 16);
+    return value;
+}
+export function validateGoalManifest(value) {
+    shape(value, ['version', 'id', 'createdAt', 'deadline', 'project', 'runsRoot', 'goal', 'preference', 'workspace', 'limits', 'hash'], ['team', 'supervision', 'planningRepair', 'routing']);
+    if (![1, 2, 3, 4, 5].includes(Number(value.version)) || typeof value.version !== 'number' || !uuid(value.id) || !iso(value.createdAt))
+        fail('Invalid goal identity or version.');
+    text(value.goal);
+    validateGoalLimits(value.limits);
+    if (value.version === 2 || (value.version === 3 || value.version === 4 || value.version === 5) && value.team !== undefined) {
+        const team = validateGoalTeam(value.team), limits = value.limits;
+        if (team.reviewer && (limits.maxAgents < 2 || limits.maxTasks < 2 || limits.maxDepth < 1 || limits.planningTokens < 2))
+            fail('A plan reviewer requires two agents, two tasks, depth one and two planning tokens.');
+    }
+    else if (value.team !== undefined)
+        fail('Version 1 goals cannot contain team configuration.');
+    if (value.version === 3 || (value.version === 4 || value.version === 5) && value.supervision !== undefined) {
+        const s = validateGoalSupervision(value.supervision), limits = value.limits;
+        if (limits.maxAgents < (s.reviewer ? 3 : 2) || limits.maxDepth < 1 || s.maxOutputTokens > limits.tokenBudget - limits.planningTokens)
+            fail('Supervised goals need controller/worker capacity and output within their execution allowance.');
+    }
+    else if (value.supervision !== undefined)
+        fail('Supervision requires a version 3 or 4 goal manifest.');
+    if (value.version === 4 || value.version === 5 && value.planningRepair !== undefined) {
+        shape(value.planningRepair, ['version', 'maxRetries']);
+        if (value.planningRepair.version !== 1)
+            fail('Unknown planning repair version.');
+        integer(value.planningRepair.maxRetries, 1, 2);
+    }
+    else if (value.planningRepair !== undefined)
+        fail('Planning repair requires a version 4 goal manifest.');
+    if (value.version === 5)
+        validateGoalRouting(value.routing);
+    else if (value.routing !== undefined)
+        fail('Smart routing requires a version 5 goal manifest.');
+    integer(value.deadline, Date.parse(value.createdAt) + 1, Date.parse(value.createdAt) + 86400000);
+    if (value.deadline !== Date.parse(value.createdAt) + value.limits.timeBudgetMs)
+        fail('Goal deadline differs from its original allowance.');
+    shape(value.project, ['root', 'key']);
+    text(value.project.root, 4096);
+    if (!isAbsolute(value.project.root) || !hex(value.project.key))
+        fail('Invalid goal project identity.');
+    text(value.runsRoot, 4096);
+    if (!isAbsolute(value.runsRoot))
+        fail('Goal runs require an absolute private store.');
+    shape(value.preference, ['provider'], ['model']);
+    if (value.preference.provider !== 'auto' && !getProviderNames().includes(value.preference.provider))
+        fail('Unknown goal provider.');
+    if (value.preference.model !== undefined)
+        text(value.preference.model, 256);
+    const allowedTools = value.supervision !== undefined ? [...GOAL_TOOLS, 'shell'] : GOAL_TOOLS;
+    shape(value.workspace, ['allowedTools', 'allowedPaths']);
+    strings(value.workspace.allowedTools, allowedTools.length);
+    if (value.workspace.allowedTools.some(t => !allowedTools.includes(t)))
+        fail('Goal tools require supported containment.');
+    if (value.supervision !== undefined && !value.workspace.allowedTools.includes('shell'))
+        fail('Supervised goals require contained verification authority.');
+    array(value.workspace.allowedPaths, 256);
+    const paths = new Set();
+    for (const grant of value.workspace.allowedPaths) {
+        shape(grant, ['path', 'access']);
+        pathName(grant.path);
+        if (!['read', 'write'].includes(String(grant.access)) || paths.has(grant.path))
+            fail('Invalid goal path grant.');
+        paths.add(grant.path);
+    }
+    verifyHash(value);
+    if (Buffer.byteLength(canonicalJson(value)) > MAX_PLAN_BYTES)
+        fail('Goal manifest exceeds its size limit.');
+    return value;
+}
+export function validateGoalLink(value) {
+    shape(value, ['version', 'root', 'id', 'manifestHash', 'allocationId', 'phase']);
+    text(value.root, 4096);
+    if (value.version !== 1 || !isAbsolute(value.root) || !uuid(value.id) || !hex(value.manifestHash) || !uuid(value.allocationId) || !['planning', 'execution'].includes(String(value.phase)))
+        fail('Invalid parent goal linkage.');
+    return value;
+}
+export function validateAllocation(value, manifest, phase) {
+    shape(value, ['id', 'phase', 'runId', 'planHash', 'tokens', 'costNanos', 'deadline']);
+    if (!uuid(value.id) || !uuid(value.runId) || !hex(value.planHash) || value.phase !== phase)
+        fail('Invalid goal allocation.');
+    integer(value.tokens, 1, phase === 'planning' ? manifest.limits.planningTokens : manifest.limits.tokenBudget);
+    integer(value.costNanos, 0, phase === 'planning' ? manifest.limits.planningCostNanos : manifest.limits.costBudgetNanos);
+    integer(value.deadline, Date.parse(manifest.createdAt) + 1, phase === 'planning' ? Date.parse(manifest.createdAt) + manifest.limits.planningTimeMs : manifest.deadline);
+    return value;
+}
+export function validatePlanningSpend(value) {
+    shape(value, ['tokens', 'costNanos', 'revision']);
+    integer(value.tokens, 0, Number.MAX_SAFE_INTEGER);
+    integer(value.costNanos, 0, Number.MAX_SAFE_INTEGER);
+    if (!hex(value.revision))
+        fail('Planning spend needs its ledger revision.');
+    return value;
+}
+export function validateProposalSource(value) {
+    shape(value, ['kind'], ['runId', 'artifactId', 'artifactHash', 'eventId', 'path', 'sha256']);
+    if (value.kind === 'agent') {
+        shape(value, ['kind', 'runId', 'artifactId', 'artifactHash', 'eventId']);
+        if (!uuid(value.runId) || !uuid(value.eventId) || !hex(value.artifactHash))
+            fail('Invalid proposal provenance.');
+        text(value.artifactId, 64);
+    }
+    else if (value.kind === 'human') {
+        shape(value, ['kind', 'path', 'sha256']);
+        pathName(value.path);
+        if (!hex(value.sha256))
+            fail('Invalid human proposal source.');
+    }
+    else
+        fail('Unknown proposal source.');
+    return value;
+}
+export function validateGoalProposal(value, manifest, spend) {
+    if (spend !== undefined)
+        validatePlanningSpend(spend);
+    shape(value, ['version', 'goalId', 'goalManifestHash', 'plan', 'planHash', 'knowledgeStatus', 'confidence', 'inferred', 'source', 'hash']);
+    if (value.version !== 1 || value.goalId !== manifest.id || value.goalManifestHash !== manifest.hash || value.knowledgeStatus !== 'proposed' || value.confidence !== null || typeof value.inferred !== 'boolean')
+        fail('Invalid proposed knowledge state.');
+    const source = validateProposalSource(value.source);
+    if (value.inferred !== (source.kind === 'agent'))
+        fail('Proposal inference marker differs from its source.');
+    const analysis = analyzePlan(value.plan), p = analysis.plan, l = manifest.limits;
+    if (value.planHash !== analysis.hash)
+        fail('Proposal plan hash is invalid.');
+    if (p.limits.tokenBudget > l.tokenBudget - (spend?.tokens ?? 0) || Math.floor(p.limits.costBudgetUsd * 1e9) > l.costBudgetNanos - (spend?.costNanos ?? 0) || p.limits.timeBudgetMs > l.timeBudgetMs || p.limits.maxAgents > l.maxAgents || p.limits.maxTasks > l.maxTasks || p.limits.maxDepth > l.maxDepth || p.limits.maxConcurrent > l.maxConcurrent)
+        fail('Proposed plan exceeds the remaining goal allowance.');
+    if (manifest.team?.maxAttempts !== undefined && p.agents.some(agent => agent.escalationPolicy.maxRetries >= manifest.team.maxAttempts))
+        fail('Proposal exceeds the goal task attempt limit.');
+    if (p.workspace.allowedTools.some(t => !manifest.workspace.allowedTools.includes(t)) || p.workspace.allowedPaths.some(g => !permits(manifest.workspace.allowedPaths, g.path, g.access)))
+        fail('Proposed workspace exceeds the reviewed goal scope.');
+    validateSupervisedGoalPlan(p, manifest);
+    if (!manifest.routing && p.agents.some(a => a.routing || a.childRouting))
+        fail('A goal must opt into Smart routing before planning.');
+    if (manifest.routing && canonicalJson(applyGoalRouting(structuredClone(p), manifest, 'execution')) !== canonicalJson(p))
+        fail('Proposal routing differs from the captured goal policy.');
+    verifyHash(value);
+    if (Buffer.byteLength(JSON.stringify(value)) > MAX_PLAN_BYTES + 8192)
+        fail('Proposal exceeds its byte limit.');
+    return value;
+}
+export function assertGoalProject(manifest, cwd = manifest.project.root) {
+    const identity = projectIdentity(cwd);
+    if (identity.project !== manifest.project.root || identity.projectKey !== manifest.project.key)
+        throw new OrchestrationError('policy-denied', 'Goal belongs to another or replaced project.');
+}
+//# sourceMappingURL=validation.js.map

package/dist/goals/validation.js.map

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

package/dist/headless.d.ts

@@ -13,6 +13,7 @@ export interface HeadlessEvent {
 }
 export type HeadlessOutputMode = 'json' | 'text';
 export interface HeadlessOptions {
+    signal?: AbortSignal;
     provider?: LLMProvider;
     model?: string;
     prompt?: string;

package/dist/headless.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../src/headless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,KAAK,EAAW,WAAW,EAAY,MAAM,YAAY,CAAC;AAMjE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAiGD,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAsT3E"}
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../src/headless.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,OAAO,KAAK,EAAW,WAAW,EAAE,MAAM,YAAY,CAAC;AAMvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0CD,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA+I3E"}