@goliapkg/sentori-cli 0.5.2 → 0.6.0

package/lib/mcp.js

@@ -0,0 +1,371 @@
+// v1.2 W9 — Sentori MCP server.
+//
+// Stdio JSON-RPC 2.0 transport per the Model Context Protocol spec
+// (https://modelcontextprotocol.io/). LLM clients (Claude Code,
+// custom agents) spawn `sentori-cli mcp serve` as a subprocess and
+// pipe MCP messages over stdin/stdout. Each tool call translates
+// 1:1 to the existing admin API; the MCP layer is pure protocol
+// glue + auth-passthrough.
+//
+// Why CLI-hosted instead of server-hosted MCP:
+//   - The Sentori server exposes admin endpoints over HTTPS already;
+//     spinning up a parallel MCP endpoint would duplicate auth +
+//     route boilerplate.
+//   - LLM clients expect MCP servers to be local stdio subprocesses
+//     (Claude Code config, gptme, etc.). The CLI is the natural
+//     binary to embed it in — the operator already has it installed
+//     and a token configured.
+//   - Easier to ship + version with the rest of the CLI.
+import { createInterface } from 'node:readline';
+/** Run the MCP server over stdio. Returns when stdin closes. */
+export async function runMcpServer(ctx) {
+    const tools = buildTools();
+    const toolMap = new Map(tools.map((t) => [t.name, t]));
+    const rl = createInterface({ input: process.stdin });
+    for await (const line of rl) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let req;
+        try {
+            req = JSON.parse(trimmed);
+        }
+        catch {
+            // Per spec, malformed requests get a parse-error response with
+            // null id.
+            send({
+                error: { code: -32700, message: 'Parse error' },
+                id: null,
+                jsonrpc: '2.0',
+            });
+            continue;
+        }
+        // Notifications (no `id`) get no response.
+        const isNotification = req.id === undefined || req.id === null;
+        try {
+            const result = await dispatch(req, toolMap, ctx, tools);
+            if (!isNotification) {
+                send({ id: req.id ?? null, jsonrpc: '2.0', result });
+            }
+        }
+        catch (e) {
+            if (!isNotification) {
+                send({
+                    error: { code: -32603, message: e.message },
+                    id: req.id ?? null,
+                    jsonrpc: '2.0',
+                });
+            }
+        }
+    }
+}
+function send(resp) {
+    process.stdout.write(JSON.stringify(resp) + '\n');
+}
+async function dispatch(req, toolMap, ctx, tools) {
+    switch (req.method) {
+        case 'initialize':
+            return {
+                capabilities: { tools: {} },
+                protocolVersion: '2024-11-05',
+                serverInfo: { name: 'sentori', version: '1.0' },
+            };
+        case 'notifications/initialized':
+            return {};
+        case 'tools/list':
+            return {
+                tools: tools.map((t) => ({
+                    description: t.description,
+                    inputSchema: t.inputSchema,
+                    name: t.name,
+                })),
+            };
+        case 'tools/call': {
+            const params = (req.params ?? {});
+            const name = params.name;
+            if (typeof name !== 'string')
+                throw new Error('missing tools/call.name');
+            const tool = toolMap.get(name);
+            if (!tool)
+                throw new Error(`unknown tool: ${name}`);
+            const result = await tool.handler(params.arguments ?? {}, ctx);
+            return {
+                content: [
+                    {
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                        type: 'text',
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`method not found: ${req.method}`);
+    }
+}
+// ── Tool implementations ─────────────────────────────────────────
+async function adminGet(ctx, path) {
+    const url = `${ctx.apiUrl.replace(/\/+$/, '')}/admin/api${path}`;
+    const resp = await fetch(url, {
+        headers: { Authorization: `Bearer ${ctx.token}` },
+    });
+    if (!resp.ok)
+        throw new Error(`GET ${path} → ${resp.status} ${resp.statusText}`);
+    return (await resp.json());
+}
+async function adminPatch(ctx, path, body) {
+    const url = `${ctx.apiUrl.replace(/\/+$/, '')}/admin/api${path}`;
+    const resp = await fetch(url, {
+        body: JSON.stringify(body),
+        headers: {
+            Authorization: `Bearer ${ctx.token}`,
+            'Content-Type': 'application/json',
+        },
+        method: 'PATCH',
+    });
+    if (!resp.ok)
+        throw new Error(`PATCH ${path} → ${resp.status} ${resp.statusText}`);
+    return (await resp.json());
+}
+async function adminPost(ctx, path, body) {
+    const url = `${ctx.apiUrl.replace(/\/+$/, '')}/admin/api${path}`;
+    const resp = await fetch(url, {
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+        headers: {
+            Authorization: `Bearer ${ctx.token}`,
+            'Content-Type': 'application/json',
+        },
+        method: 'POST',
+    });
+    if (!resp.ok)
+        throw new Error(`POST ${path} → ${resp.status} ${resp.statusText}`);
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
+async function adminPut(ctx, path) {
+    const url = `${ctx.apiUrl.replace(/\/+$/, '')}/admin/api${path}`;
+    const resp = await fetch(url, {
+        headers: { Authorization: `Bearer ${ctx.token}` },
+        method: 'PUT',
+    });
+    if (!resp.ok)
+        throw new Error(`PUT ${path} → ${resp.status} ${resp.statusText}`);
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
+async function adminDelete(ctx, path) {
+    const url = `${ctx.apiUrl.replace(/\/+$/, '')}/admin/api${path}`;
+    const resp = await fetch(url, {
+        headers: { Authorization: `Bearer ${ctx.token}` },
+        method: 'DELETE',
+    });
+    if (!resp.ok)
+        throw new Error(`DELETE ${path} → ${resp.status} ${resp.statusText}`);
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
+function asString(v, name) {
+    if (typeof v !== 'string' || v.length === 0) {
+        throw new Error(`${name} is required (string)`);
+    }
+    return v;
+}
+function asOptionalString(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    if (typeof v !== 'string')
+        throw new Error('expected string');
+    return v;
+}
+export function buildTools() {
+    return [
+        {
+            description: 'List issues for a Sentori project, with optional status / priority / label filters.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const usp = new URLSearchParams();
+                const status = asOptionalString(args.status) ?? 'any';
+                usp.set('status', status);
+                if (args.priority)
+                    usp.set('priority', String(args.priority));
+                if (args.label)
+                    usp.set('labels', String(args.label));
+                if (typeof args.limit === 'number')
+                    usp.set('limit', String(args.limit));
+                return await adminGet(ctx, `/projects/${projectId}/issues?${usp}`);
+            },
+            inputSchema: {
+                properties: {
+                    label: { type: 'string' },
+                    limit: { type: 'number' },
+                    priority: { type: 'string' },
+                    projectId: { type: 'string' },
+                    status: { type: 'string' },
+                },
+                required: ['projectId'],
+                type: 'object',
+            },
+            name: 'sentori_issue_list',
+        },
+        {
+            description: 'Get full detail for one Sentori issue including its activity feed.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                const [issue, activity] = await Promise.all([
+                    adminGet(ctx, `/projects/${projectId}/issues/${issueId}`),
+                    adminGet(ctx, `/projects/${projectId}/issues/${issueId}/activity`),
+                ]);
+                return { activity, issue };
+            },
+            inputSchema: {
+                properties: {
+                    issueId: { type: 'string' },
+                    projectId: { type: 'string' },
+                },
+                required: ['projectId', 'issueId'],
+                type: 'object',
+            },
+            name: 'sentori_issue_get',
+        },
+        {
+            description: 'Add a comment to a Sentori issue.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                const body = asString(args.body, 'body');
+                return await adminPost(ctx, `/projects/${projectId}/issues/${issueId}/comments`, {
+                    body,
+                });
+            },
+            inputSchema: {
+                properties: {
+                    body: { type: 'string' },
+                    issueId: { type: 'string' },
+                    projectId: { type: 'string' },
+                },
+                required: ['projectId', 'issueId', 'body'],
+                type: 'object',
+            },
+            name: 'sentori_issue_comment',
+        },
+        {
+            description: 'Transition an issue to a new status (active|silenced|muted|resolved|closed).',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                const status = asString(args.status, 'status');
+                return await adminPatch(ctx, `/projects/${projectId}/issues/${issueId}`, {
+                    status,
+                });
+            },
+            inputSchema: {
+                properties: {
+                    issueId: { type: 'string' },
+                    projectId: { type: 'string' },
+                    status: {
+                        enum: ['active', 'silenced', 'muted', 'resolved', 'closed'],
+                        type: 'string',
+                    },
+                },
+                required: ['projectId', 'issueId', 'status'],
+                type: 'object',
+            },
+            name: 'sentori_issue_transition',
+        },
+        {
+            description: 'Assign an issue to a user, or pass userId=null to unassign.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                const userId = args.userId === null ? null : asOptionalString(args.userId);
+                return await adminPatch(ctx, `/projects/${projectId}/issues/${issueId}`, {
+                    assigneeUserId: userId ?? null,
+                });
+            },
+            inputSchema: {
+                properties: {
+                    issueId: { type: 'string' },
+                    projectId: { type: 'string' },
+                    userId: { type: ['string', 'null'] },
+                },
+                required: ['projectId', 'issueId', 'userId'],
+                type: 'object',
+            },
+            name: 'sentori_issue_assign',
+        },
+        {
+            description: 'Set the triage priority on an issue.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                const priority = asString(args.priority, 'priority');
+                return await adminPatch(ctx, `/projects/${projectId}/issues/${issueId}`, {
+                    priority,
+                });
+            },
+            inputSchema: {
+                properties: {
+                    issueId: { type: 'string' },
+                    priority: { enum: ['p0', 'p1', 'p2', 'p3'], type: 'string' },
+                    projectId: { type: 'string' },
+                },
+                required: ['projectId', 'issueId', 'priority'],
+                type: 'object',
+            },
+            name: 'sentori_issue_set_priority',
+        },
+        {
+            description: 'Replace the label set on an issue. Pass [] to clear all.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                if (!Array.isArray(args.labels))
+                    throw new Error('labels must be string[]');
+                const labels = args.labels.map((l) => {
+                    if (typeof l !== 'string')
+                        throw new Error('each label must be a string');
+                    return l;
+                });
+                return await adminPatch(ctx, `/projects/${projectId}/issues/${issueId}`, {
+                    labels,
+                });
+            },
+            inputSchema: {
+                properties: {
+                    issueId: { type: 'string' },
+                    labels: { items: { type: 'string' }, type: 'array' },
+                    projectId: { type: 'string' },
+                },
+                required: ['projectId', 'issueId', 'labels'],
+                type: 'object',
+            },
+            name: 'sentori_issue_set_labels',
+        },
+        {
+            description: 'Subscribe (watch=true) or unsubscribe (watch=false) the configured caller to an issue.',
+            handler: async (args, ctx) => {
+                const projectId = asString(args.projectId, 'projectId');
+                const issueId = asString(args.issueId, 'issueId');
+                const watch = args.watch === true;
+                if (watch) {
+                    return await adminPut(ctx, `/projects/${projectId}/issues/${issueId}/watch`);
+                }
+                return await adminDelete(ctx, `/projects/${projectId}/issues/${issueId}/watch`);
+            },
+            inputSchema: {
+                properties: {
+                    issueId: { type: 'string' },
+                    projectId: { type: 'string' },
+                    watch: { type: 'boolean' },
+                },
+                required: ['projectId', 'issueId', 'watch'],
+                type: 'object',
+            },
+            name: 'sentori_issue_watch',
+        },
+    ];
+}
+//# sourceMappingURL=mcp.js.map

package/lib/mcp.js.map

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

package/lib/push.d.ts

@@ -0,0 +1,42 @@
+export type PushClientConfig = {
+    apiUrl: string;
+    projectId: string;
+    token: string;
+};
+type AdminCredentialRow = {
+    provider: string;
+    config: Record<string, unknown>;
+    updatedAt: string;
+};
+type Ticket = {
+    id: string;
+    status: 'queued' | 'sent' | 'failed';
+    providerOutcome?: string | null;
+    error?: string | null;
+    retryCount: number;
+    createdAt: string;
+    sentAt?: string | null;
+};
+/** Parse a CLI flag value that may be `@file.json` (read from disk
+ *  and parse) or a literal JSON string. */
+export declare function parseJsonArg(raw: string, kind: string): unknown;
+export declare function pushCredsList(cfg: PushClientConfig): Promise<AdminCredentialRow[]>;
+export declare function pushCredsSet(cfg: PushClientConfig, provider: string, config: unknown, secret: unknown): Promise<{
+    ok: boolean;
+}>;
+export declare function pushCredsDelete(cfg: PushClientConfig, provider: string): Promise<void>;
+export type SendOpts = {
+    to: string;
+    title?: string;
+    body?: string;
+    data?: unknown;
+    priority?: 'high' | 'normal';
+    ttl?: number;
+    idempotencyKey?: string;
+};
+export declare function pushSend(cfg: PushClientConfig, opts: SendOpts): Promise<Ticket>;
+export declare function pushReceipt(cfg: PushClientConfig, sendId: string): Promise<{
+    ticket: Ticket;
+}>;
+export {};
+//# sourceMappingURL=push.d.ts.map

package/lib/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,MAAM,GAAG;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AA+BD;2CAC2C;AAC3C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAe/D;AAID,wBAAsB,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAKxF;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,GACd,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAc1B;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CASf;AAID,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBrF;AAED,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAK7B"}

package/lib/push.js

@@ -0,0 +1,92 @@
+// v2.12 — `sentori-cli push *` commands.
+//
+// Wraps the v2.7 admin REST + v2.7 ingest endpoints so operators can
+// drive credential CRUD, ad-hoc sends, and receipt lookups from the
+// terminal without touching curl.
+//
+// `push send`     POST /v1/push/send         (ingest Bearer)
+// `push receipt`  GET  /v1/push/receipts/:id (ingest Bearer)
+// `push creds list`    GET    /admin/api/projects/:id/push/credentials   (admin Bearer)
+// `push creds set`     PUT    /admin/api/projects/:id/push/credentials   (admin Bearer)
+// `push creds delete`  DELETE /admin/api/projects/:id/push/credentials/:provider
+import { readFileSync } from 'node:fs';
+const VALID_PROVIDERS = new Set(['apns', 'fcm', 'webpush', 'hcm', 'mipush']);
+function joinUrl(base, path) {
+    return `${base.replace(/\/+$/, '')}${path}`;
+}
+async function bearerFetch(url, token, init) {
+    const resp = await fetch(url, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            ...(init?.headers ?? {}),
+        },
+    });
+    if (!resp.ok) {
+        const detail = await resp.text().catch(() => '');
+        throw new Error(`${resp.status} ${resp.statusText}${detail ? ` — ${detail.slice(0, 300)}` : ''}`);
+    }
+    const txt = await resp.text();
+    return (txt ? JSON.parse(txt) : null);
+}
+/** Parse a CLI flag value that may be `@file.json` (read from disk
+ *  and parse) or a literal JSON string. */
+export function parseJsonArg(raw, kind) {
+    if (raw.startsWith('@')) {
+        const path = raw.slice(1);
+        const body = readFileSync(path, 'utf-8');
+        try {
+            return JSON.parse(body);
+        }
+        catch (e) {
+            throw new Error(`${kind} file ${path} is not valid JSON: ${e.message}`);
+        }
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`${kind} arg is not valid JSON: ${e.message}`);
+    }
+}
+// ── credential CRUD ───────────────────────────────────────────────
+export async function pushCredsList(cfg) {
+    return bearerFetch(joinUrl(cfg.apiUrl, `/admin/api/projects/${cfg.projectId}/push/credentials`), cfg.token);
+}
+export async function pushCredsSet(cfg, provider, config, secret) {
+    if (!VALID_PROVIDERS.has(provider)) {
+        throw new Error(`invalid provider '${provider}'; expected one of ${[...VALID_PROVIDERS].join('/')}`);
+    }
+    return bearerFetch(joinUrl(cfg.apiUrl, `/admin/api/projects/${cfg.projectId}/push/credentials`), cfg.token, {
+        body: JSON.stringify({ provider, config, secret }),
+        method: 'PUT',
+    });
+}
+export async function pushCredsDelete(cfg, provider) {
+    await bearerFetch(joinUrl(cfg.apiUrl, `/admin/api/projects/${cfg.projectId}/push/credentials/${provider}`), cfg.token, { method: 'DELETE' });
+}
+export async function pushSend(cfg, opts) {
+    const payload = {
+        to: opts.to,
+        title: opts.title,
+        body: opts.body,
+        data: opts.data,
+        idempotencyKey: opts.idempotencyKey,
+    };
+    if (opts.priority || opts.ttl != null) {
+        payload.options = { priority: opts.priority, ttl: opts.ttl };
+    }
+    const resp = await bearerFetch(joinUrl(cfg.apiUrl, '/v1/push/send'), cfg.token, {
+        body: JSON.stringify(payload),
+        method: 'POST',
+    });
+    if (!resp.tickets?.length) {
+        throw new Error('server returned no tickets');
+    }
+    return resp.tickets[0];
+}
+export async function pushReceipt(cfg, sendId) {
+    return bearerFetch(joinUrl(cfg.apiUrl, `/v1/push/receipts/${encodeURIComponent(sendId)}`), cfg.token);
+}
+//# sourceMappingURL=push.js.map

package/lib/push.js.map

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

package/lib/source-bundle.d.ts

@@ -0,0 +1,28 @@
+import type { AdminUpload } from './native-artifacts.js';
+export type SourceBundleUploadOptions = AdminUpload & {
+    /** v1.4 W26 — optional module label so polyrepo apps (main +
+     *  watch ext + share ext etc.) can upload multiple bundles per
+     *  (release, platform). Empty/undefined → unlabelled single
+     *  bundle (v1.3 W15 behaviour). */
+    module?: string;
+    /** Pre-built tar.gz archive of the project's source tree. */
+    path: string;
+    platform: 'android' | 'ios';
+};
+export type SourceBundleUploadResult = {
+    contentHash: string;
+    kind: string;
+    sizeBytes: number;
+};
+export declare function uploadSourceBundle(opts: SourceBundleUploadOptions): Promise<SourceBundleUploadResult>;
+/** Walk `dir`, pick platform-relevant source files, and tar.gz them
+ *  into a temp file. Caller is responsible for invoking `cleanup()`.
+ *  Uses the system `tar` binary; that's portable enough on macOS +
+ *  Linux + WSL, which covers every realistic CI environment Sentori
+ *  ships to. Native Windows CI without WSL would need to gzip the
+ *  archive themselves (the pre-built-path mode still works). */
+export declare function buildSourceBundleFromDir(dir: string, platform: 'android' | 'ios'): Promise<{
+    cleanup: () => Promise<void>;
+    path: string;
+}>;
+//# sourceMappingURL=source-bundle.d.ts.map

package/lib/source-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-bundle.d.ts","sourceRoot":"","sources":["../src/source-bundle.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAyBxD,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG;IACpD;;;uCAGmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAuDD;;;;;gEAKgE;AAChE,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,GAAG,KAAK,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCzD"}