@agent-native/core 0.7.11 → 0.7.13

package/dist/jobs/tools.js

@@ -5,203 +5,179 @@ import { getRequestUserEmail, getRequestOrgId, } from "../server/request-context
 function getOwner() {
     return getRequestUserEmail() || "local@localhost";
 }
+async function runCreate(args) {
+    const { name, schedule, instructions, scope, runAs } = args;
+    if (!name || !schedule || !instructions) {
+        return JSON.stringify({
+            error: "name, schedule, and instructions are required",
+        });
+    }
+    if (!isValidCron(schedule)) {
+        return JSON.stringify({
+            error: `Invalid cron expression: "${schedule}". Use 5 fields: minute hour day-of-month month day-of-week.`,
+        });
+    }
+    const owner = scope === "personal" ? getOwner() : SHARED_OWNER;
+    const path = `jobs/${name}.md`;
+    const now = new Date();
+    const next = nextOccurrence(schedule, now);
+    const meta = {
+        schedule,
+        enabled: true,
+        createdBy: getOwner(),
+        orgId: getRequestOrgId() || undefined,
+        runAs: runAs === "shared" ? "shared" : "creator",
+        nextRun: next.toISOString(),
+    };
+    const content = buildJobContent(meta, instructions);
+    await resourcePut(owner, path, content);
+    return JSON.stringify({
+        created: true,
+        name,
+        path,
+        schedule,
+        scheduleDescription: describeCron(schedule),
+        nextRun: next.toISOString(),
+        scope: scope || "shared",
+    });
+}
+async function runList(args) {
+    const owner = getOwner();
+    // Fetch only current user's and shared jobs (not other users')
+    const [personal, shared] = await Promise.all([
+        resourceList(owner, "jobs/"),
+        resourceList(SHARED_OWNER, "jobs/"),
+    ]);
+    let resources = [...personal, ...shared];
+    if (args.scope === "personal")
+        resources = personal;
+    else if (args.scope === "shared")
+        resources = shared;
+    const metas = resources.filter((r) => r.path.endsWith(".md") && !r.path.endsWith(".keep"));
+    const jobs = await Promise.all(metas.map(async (r) => {
+        const full = await resourceGetByPath(r.owner, r.path);
+        const { meta } = parseJobFrontmatter(full?.content || "");
+        return {
+            name: r.path.replace(/^jobs\//, "").replace(/\.md$/, ""),
+            path: r.path,
+            scope: r.owner === SHARED_OWNER ? "shared" : "personal",
+            schedule: meta.schedule,
+            scheduleDescription: meta.schedule ? describeCron(meta.schedule) : "",
+            enabled: meta.enabled,
+            lastRun: meta.lastRun || null,
+            lastStatus: meta.lastStatus || null,
+            lastError: meta.lastError || null,
+            nextRun: meta.nextRun || null,
+        };
+    }));
+    if (jobs.length === 0) {
+        return "No recurring jobs configured. Use manage-jobs with action 'create' to create one.";
+    }
+    return JSON.stringify(jobs, null, 2);
+}
+async function runUpdate(args) {
+    const { name, schedule, instructions, enabled, scope, runAs } = args;
+    const path = `jobs/${name}.md`;
+    // Try to find the resource
+    let resource = await resourceGetByPath(SHARED_OWNER, path);
+    if (!resource && scope !== "shared") {
+        resource = await resourceGetByPath(getOwner(), path);
+    }
+    if (!resource) {
+        return JSON.stringify({ error: `Job "${name}" not found` });
+    }
+    const { meta, body } = parseJobFrontmatter(resource.content);
+    if (schedule) {
+        if (!isValidCron(schedule)) {
+            return JSON.stringify({
+                error: `Invalid cron expression: "${schedule}"`,
+            });
+        }
+        meta.schedule = schedule;
+        meta.nextRun = nextOccurrence(schedule).toISOString();
+    }
+    if (enabled !== undefined) {
+        meta.enabled = enabled === "true";
+    }
+    if (runAs === "creator" || runAs === "shared") {
+        meta.runAs = runAs;
+    }
+    const newBody = instructions || body;
+    const content = buildJobContent(meta, newBody);
+    await resourcePut(resource.owner, resource.path, content);
+    return JSON.stringify({
+        updated: true,
+        name,
+        schedule: meta.schedule,
+        scheduleDescription: describeCron(meta.schedule),
+        enabled: meta.enabled,
+        nextRun: meta.nextRun,
+    });
+}
 export function createJobTools() {
     return {
-        "create-job": {
+        "manage-jobs": {
             tool: {
-                description: "Create a recurring job that runs on a cron schedule. The job instructions describe what the agent should do each time it runs. The schedule uses standard 5-field cron format (minute hour day-of-month month day-of-week). Common patterns: '0 9 * * *' (daily 9am), '0 9 * * 1-5' (weekdays 9am), '0 * * * *' (every hour), '0 9 * * 1' (Mondays 9am), '*/30 * * * *' (every 30 min).",
+                description: `Manage recurring jobs that run on a cron schedule.
+
+Actions:
+- "create": Create a new recurring job. Requires name, schedule, and instructions.
+- "list": List all recurring jobs and their status (schedule, enabled, last run, next run).
+- "update": Update a job's schedule, instructions, or enabled state. Requires name.
+
+Cron format is 5 fields: minute hour day-of-month month day-of-week. Common patterns: '0 9 * * *' (daily 9am), '0 9 * * 1-5' (weekdays 9am), '0 * * * *' (every hour), '0 9 * * 1' (Mondays 9am), '*/30 * * * *' (every 30 min).`,
                 parameters: {
                     type: "object",
                     properties: {
-                        name: {
+                        action: {
                             type: "string",
-                            description: "Job name (hyphen-case, e.g. 'daily-scorecard-check'). Used as the filename.",
+                            description: "The action to perform.",
+                            enum: ["create", "list", "update"],
                         },
-                        schedule: {
-                            type: "string",
-                            description: "Cron expression (5 fields: minute hour day-of-month month day-of-week). Examples: '0 9 * * 1-5' (weekdays 9am), '0 */2 * * *' (every 2 hours).",
-                        },
-                        instructions: {
-                            type: "string",
-                            description: "What the agent should do when this job runs. Be specific — include which actions to call and what to do with the results.",
-                        },
-                        scope: {
-                            type: "string",
-                            description: "personal (only your jobs) or shared (team jobs). Default: shared.",
-                            enum: ["personal", "shared"],
-                        },
-                        runAs: {
-                            type: "string",
-                            description: "Who shared jobs execute as: creator or shared. Default: creator.",
-                            enum: ["creator", "shared"],
-                        },
-                    },
-                    required: ["name", "schedule", "instructions"],
-                },
-            },
-            run: async (args) => {
-                const { name, schedule, instructions, scope, runAs } = args;
-                if (!name || !schedule || !instructions) {
-                    return JSON.stringify({
-                        error: "name, schedule, and instructions are required",
-                    });
-                }
-                if (!isValidCron(schedule)) {
-                    return JSON.stringify({
-                        error: `Invalid cron expression: "${schedule}". Use 5 fields: minute hour day-of-month month day-of-week.`,
-                    });
-                }
-                const owner = scope === "personal" ? getOwner() : SHARED_OWNER;
-                const path = `jobs/${name}.md`;
-                const now = new Date();
-                const next = nextOccurrence(schedule, now);
-                const meta = {
-                    schedule,
-                    enabled: true,
-                    createdBy: getOwner(),
-                    orgId: getRequestOrgId() || undefined,
-                    runAs: runAs === "shared" ? "shared" : "creator",
-                    nextRun: next.toISOString(),
-                };
-                const content = buildJobContent(meta, instructions);
-                await resourcePut(owner, path, content);
-                return JSON.stringify({
-                    created: true,
-                    name,
-                    path,
-                    schedule,
-                    scheduleDescription: describeCron(schedule),
-                    nextRun: next.toISOString(),
-                    scope: scope || "shared",
-                });
-            },
-        },
-        "list-jobs": {
-            tool: {
-                description: "List all recurring jobs and their status (schedule, enabled, last run, last status, next run).",
-                parameters: {
-                    type: "object",
-                    properties: {
-                        scope: {
-                            type: "string",
-                            description: "Filter by scope: personal, shared, or all. Default: all.",
-                            enum: ["personal", "shared", "all"],
-                        },
-                    },
-                },
-            },
-            run: async (args) => {
-                const owner = getOwner();
-                // Fetch only current user's and shared jobs (not other users')
-                const [personal, shared] = await Promise.all([
-                    resourceList(owner, "jobs/"),
-                    resourceList(SHARED_OWNER, "jobs/"),
-                ]);
-                let resources = [...personal, ...shared];
-                if (args.scope === "personal")
-                    resources = personal;
-                else if (args.scope === "shared")
-                    resources = shared;
-                const metas = resources.filter((r) => r.path.endsWith(".md") && !r.path.endsWith(".keep"));
-                const jobs = await Promise.all(metas.map(async (r) => {
-                    const full = await resourceGetByPath(r.owner, r.path);
-                    const { meta } = parseJobFrontmatter(full?.content || "");
-                    return {
-                        name: r.path.replace(/^jobs\//, "").replace(/\.md$/, ""),
-                        path: r.path,
-                        scope: r.owner === SHARED_OWNER ? "shared" : "personal",
-                        schedule: meta.schedule,
-                        scheduleDescription: meta.schedule
-                            ? describeCron(meta.schedule)
-                            : "",
-                        enabled: meta.enabled,
-                        lastRun: meta.lastRun || null,
-                        lastStatus: meta.lastStatus || null,
-                        lastError: meta.lastError || null,
-                        nextRun: meta.nextRun || null,
-                    };
-                }));
-                if (jobs.length === 0) {
-                    return "No recurring jobs configured. Use create-job to create one.";
-                }
-                return JSON.stringify(jobs, null, 2);
-            },
-        },
-        "update-job": {
-            tool: {
-                description: "Update a recurring job's schedule, instructions, or enabled state.",
-                parameters: {
-                    type: "object",
-                    properties: {
                         name: {
                             type: "string",
-                            description: "Job name (e.g. 'daily-scorecard-check')",
+                            description: "Job name (hyphen-case, e.g. 'daily-scorecard-check'). Required for create and update.",
                         },
                         schedule: {
                             type: "string",
-                            description: "New cron expression (optional)",
+                            description: "Cron expression (5 fields: minute hour day-of-month month day-of-week). Required for create, optional for update.",
                         },
                         instructions: {
                             type: "string",
-                            description: "New job instructions (optional)",
+                            description: "What the agent should do when this job runs. Be specific — include which actions to call and what to do with the results. Required for create, optional for update.",
                         },
                         enabled: {
                             type: "string",
-                            description: "Enable or disable: 'true' or 'false' (optional)",
+                            description: "Enable or disable a job: 'true' or 'false'. Only used with update.",
                             enum: ["true", "false"],
                         },
                         scope: {
                             type: "string",
-                            description: "Which scope to search: personal, shared, or all. Default: all.",
+                            description: "For create: personal or shared (default: shared). For list: personal, shared, or all (default: all). For update: which scope to search (default: all).",
                             enum: ["personal", "shared", "all"],
                         },
                         runAs: {
                             type: "string",
-                            description: "Update execution principal to creator or shared.",
+                            description: "Who shared jobs execute as: creator or shared. Default: creator. Used with create and update.",
                             enum: ["creator", "shared"],
                         },
                     },
-                    required: ["name"],
+                    required: ["action"],
                 },
             },
             run: async (args) => {
-                const { name, schedule, instructions, enabled, scope, runAs } = args;
-                const path = `jobs/${name}.md`;
-                // Try to find the resource
-                let resource = await resourceGetByPath(SHARED_OWNER, path);
-                if (!resource && scope !== "shared") {
-                    resource = await resourceGetByPath(getOwner(), path);
-                }
-                if (!resource) {
-                    return JSON.stringify({ error: `Job "${name}" not found` });
-                }
-                const { meta, body } = parseJobFrontmatter(resource.content);
-                if (schedule) {
-                    if (!isValidCron(schedule)) {
+                switch (args.action) {
+                    case "create":
+                        return runCreate(args);
+                    case "list":
+                        return runList(args);
+                    case "update":
+                        return runUpdate(args);
+                    default:
                         return JSON.stringify({
-                            error: `Invalid cron expression: "${schedule}"`,
+                            error: `Unknown action "${args.action}". Use "create", "list", or "update".`,
                         });
-                    }
-                    meta.schedule = schedule;
-                    meta.nextRun = nextOccurrence(schedule).toISOString();
-                }
-                if (enabled !== undefined) {
-                    meta.enabled = enabled === "true";
-                }
-                if (runAs === "creator" || runAs === "shared") {
-                    meta.runAs = runAs;
                 }
-                const newBody = instructions || body;
-                const content = buildJobContent(meta, newBody);
-                await resourcePut(resource.owner, resource.path, content);
-                return JSON.stringify({
-                    updated: true,
-                    name,
-                    schedule: meta.schedule,
-                    scheduleDescription: describeCron(meta.schedule),
-                    enabled: meta.enabled,
-                    nextRun: meta.nextRun,
-                });
             },
         },
     };

package/dist/jobs/tools.js.map

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

package/dist/notifications/actions.d.ts

@@ -2,8 +2,8 @@
  * Framework-level agent actions for the notifications primitive.
  *
  * Registered as native tools (not template actions) so they're available in
- * every template. The agent uses `notify` to surface progress, completions,
- * and alerts to the user through the in-app inbox and any registered channels.
+ * every template. Consolidated into a single `manage-notifications` tool with
+ * an `action` parameter that dispatches to the correct implementation.
  */
 import type { ActionEntry } from "../agent/production-agent.js";
 export declare function createNotificationToolEntries(getCurrentUser: () => string): Record<string, ActionEntry>;

package/dist/notifications/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/notifications/actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAsH7B"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/notifications/actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,MAAM,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAkI7B"}

package/dist/notifications/actions.js

@@ -2,112 +2,120 @@
  * Framework-level agent actions for the notifications primitive.
  *
  * Registered as native tools (not template actions) so they're available in
- * every template. The agent uses `notify` to surface progress, completions,
- * and alerts to the user through the in-app inbox and any registered channels.
+ * every template. Consolidated into a single `manage-notifications` tool with
+ * an `action` parameter that dispatches to the correct implementation.
  */
 import { notify, listNotifications, countUnread } from "./registry.js";
 export function createNotificationToolEntries(getCurrentUser) {
     return {
-        notify: {
+        "manage-notifications": {
             tool: {
-                description: "Send a notification to the user. Always persisted to the in-app inbox so the bell + toast surface shows it. Registered channels (webhook, Slack, etc.) also run. Use `info` for FYI, `warning` for things the user should look at, `critical` for things that need immediate attention.",
+                description: [
+                    "Manage user notifications. Available actions:",
+                    "",
+                    '• action="send" — Send a notification to the user. Persisted to the in-app inbox so the bell + toast surface shows it. Registered channels (webhook, Slack, etc.) also run.',
+                    "  Required: severity, title. Optional: body, metadataJson, channels.",
+                    "",
+                    '• action="list" — List recent notifications for the current user. Useful when the user asks about prior alerts.',
+                    "  Optional: unreadOnly (boolean), limit (number, default 20, max 200).",
+                ].join("\n"),
                 parameters: {
                     type: "object",
                     properties: {
+                        action: {
+                            type: "string",
+                            enum: ["send", "list"],
+                            description: "The notification action to perform.",
+                        },
                         severity: {
                             type: "string",
                             enum: ["info", "warning", "critical"],
-                            description: "Severity level — drives styling and per-severity channel routing.",
+                            description: '(send) Severity level — drives styling and per-severity channel routing. Use "info" for FYI, "warning" for things the user should look at, "critical" for things that need immediate attention.',
                         },
                         title: {
                             type: "string",
-                            description: "Short, human-readable headline (≤100 chars).",
+                            description: "(send) Short, human-readable headline (≤100 chars).",
                         },
                         body: {
                             type: "string",
-                            description: "Optional longer description.",
+                            description: "(send) Optional longer description.",
                         },
                         metadataJson: {
                             type: "string",
-                            description: 'Optional JSON metadata (URLs, entity ids, etc.). Example: \'{"threadId":"abc","link":"/inbox/abc"}\'.',
+                            description: '(send) Optional JSON metadata (URLs, entity ids, etc.). Example: \'{"threadId":"abc","link":"/inbox/abc"}\'.',
                         },
                         channels: {
                             type: "string",
-                            description: 'Optional comma-separated channel allowlist (e.g. "inbox,webhook"). Omit to run all registered channels.',
+                            description: '(send) Optional comma-separated channel allowlist (e.g. "inbox,webhook"). Omit to run all registered channels.',
                         },
-                    },
-                    required: ["severity", "title"],
-                },
-            },
-            run: async (args) => {
-                const owner = getCurrentUser();
-                if (!args.severity || !args.title) {
-                    return "Error: --severity and --title are required.";
-                }
-                const severity = args.severity;
-                if (!["info", "warning", "critical"].includes(severity)) {
-                    return `Error: severity must be info, warning, or critical (got "${severity}").`;
-                }
-                let metadata;
-                if (args.metadataJson) {
-                    try {
-                        metadata = JSON.parse(args.metadataJson);
-                    }
-                    catch {
-                        return "Error: metadataJson must be valid JSON.";
-                    }
-                }
-                const channels = args.channels
-                    ? args.channels
-                        .split(",")
-                        .map((s) => s.trim())
-                        .filter(Boolean)
-                    : undefined;
-                const stored = await notify({
-                    severity,
-                    title: args.title,
-                    body: args.body || undefined,
-                    metadata,
-                    channels,
-                }, { owner });
-                return stored
-                    ? `Notification sent (id: ${stored.id})`
-                    : "Notification dispatched to channels (not persisted).";
-            },
-        },
-        "list-notifications": {
-            tool: {
-                description: "List recent notifications for the current user. Useful when the user asks about prior alerts.",
-                parameters: {
-                    type: "object",
-                    properties: {
                         unreadOnly: {
                             type: "boolean",
-                            description: "When true, only include unread notifications.",
+                            description: "(list) When true, only include unread notifications.",
                         },
                         limit: {
                             type: "number",
-                            description: "Max rows to return (default 20, max 200).",
+                            description: "(list) Max rows to return (default 20, max 200).",
                         },
                     },
+                    required: ["action"],
                 },
             },
             run: async (args) => {
                 const owner = getCurrentUser();
-                const rows = await listNotifications(owner, {
-                    unreadOnly: args.unreadOnly === true || args.unreadOnly === "true",
-                    limit: Math.min(Number(args.limit ?? 20), 200),
-                });
-                if (rows.length === 0) {
-                    return args.unreadOnly
-                        ? "No unread notifications."
-                        : "No notifications.";
+                const action = args.action;
+                switch (action) {
+                    case "send": {
+                        if (!args.severity || !args.title) {
+                            return "Error: severity and title are required for action=send.";
+                        }
+                        const severity = args.severity;
+                        if (!["info", "warning", "critical"].includes(severity)) {
+                            return `Error: severity must be info, warning, or critical (got "${severity}").`;
+                        }
+                        let metadata;
+                        if (args.metadataJson) {
+                            try {
+                                metadata = JSON.parse(args.metadataJson);
+                            }
+                            catch {
+                                return "Error: metadataJson must be valid JSON.";
+                            }
+                        }
+                        const channels = typeof args.channels === "string"
+                            ? args.channels
+                                .split(",")
+                                .map((s) => s.trim())
+                                .filter(Boolean)
+                            : undefined;
+                        const stored = await notify({
+                            severity,
+                            title: args.title,
+                            body: args.body || undefined,
+                            metadata,
+                            channels,
+                        }, { owner });
+                        return stored
+                            ? `Notification sent (id: ${stored.id})`
+                            : "Notification dispatched to channels (not persisted).";
+                    }
+                    case "list": {
+                        const rows = await listNotifications(owner, {
+                            unreadOnly: args.unreadOnly === true || args.unreadOnly === "true",
+                            limit: Math.min(Number(args.limit ?? 20), 200),
+                        });
+                        if (rows.length === 0) {
+                            return args.unreadOnly
+                                ? "No unread notifications."
+                                : "No notifications.";
+                        }
+                        const unreadCount = await countUnread(owner);
+                        const lines = rows.map((n) => `[${n.readAt ? " " : "•"}] (${n.severity}) ${n.title}${n.body ? ` — ${n.body}` : ""} · ${n.createdAt}`);
+                        return `${unreadCount} unread\n\n${lines.join("\n")}`;
+                    }
+                    default:
+                        return `Error: unknown action "${action}". Must be one of: send, list.`;
                 }
-                const unreadCount = await countUnread(owner);
-                const lines = rows.map((n) => `[${n.readAt ? " " : "•"}] (${n.severity}) ${n.title}${n.body ? ` — ${n.body}` : ""} · ${n.createdAt}`);
-                return `${unreadCount} unread\n\n${lines.join("\n")}`;
             },
-            readOnly: true,
         },
     };
 }

package/dist/notifications/actions.js.map

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

package/dist/observability/evals.d.ts

@@ -0,0 +1,22 @@
+import type { EvalResult, EvalCriteria } from "./types.js";
+import type { AgentEngine } from "../agent/engine/types.js";
+export declare function runAutomatedEvals(runId: string): Promise<EvalResult[]>;
+export declare function runLlmJudgeEval(runId: string, criteria: EvalCriteria, opts?: {
+    engine?: AgentEngine;
+    model?: string;
+    userId?: string | null;
+}): Promise<EvalResult | null>;
+export declare function runDatasetEval(datasetId: string, opts?: {
+    criteria?: EvalCriteria[];
+    engine?: AgentEngine;
+    model?: string;
+}): Promise<{
+    datasetId: string;
+    totalCases: number;
+    avgScore: number;
+    results: EvalResult[];
+}>;
+export declare function evaluateRun(runId: string, opts?: {
+    sampleRate?: number;
+}): Promise<EvalResult[]>;
+//# sourceMappingURL=evals.d.ts.map

package/dist/observability/evals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evals.d.ts","sourceRoot":"","sources":["../../src/observability/evals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA0I5D,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAsB5E;AA2DD,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACtE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6E5B;AAID,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC,CAkDD;AAuGD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,UAAU,EAAE,CAAC,CA6BvB"}