@wirecat/drive-cli 0.0.0-stage → 0.2.0

package/dist/knowledge-commands.js

@@ -0,0 +1,184 @@
+import { CliError } from "@wirecat/cli-base";
+import { FACT_STATUSES, FACT_TYPES, MEMORY_KINDS } from "@wirecat/cli-messaging/store";
+import { Option } from "commander";
+import { extractMemories } from "./extraction.js";
+export const installKnowledgeCommands = (program, helpers) => {
+    const { run, output, positive, offset } = helpers;
+    program.commands
+        .find((command) => command.name() === "documents")
+        ?.command("context")
+        .argument("<document>")
+        .description("Source document, tags, links, notes, memories and observed editors")
+        .action(async (doc) => output(await run(doc, (k, p, ref) => k.context(p, ref))));
+    const tags = program.command("tags").description("Local tags on shared documents; preserved through resync");
+    for (const action of ["list", "add", "remove"]) {
+        const command = tags.command(action).argument("<document>");
+        if (action !== "list")
+            command.argument("<tags...>");
+        command.action(async (doc, values = []) => output({ tags: await run(doc, (k, p, ref) => k.tags(p, ref, action, action === "list" ? [] : values)) }));
+    }
+    const links = program
+        .command("links")
+        .description("Connect documents to shared people, projects, notes and other references");
+    links
+        .command("list")
+        .argument("<document>")
+        .action(async (doc) => output({ items: await run(doc, (k, p, ref) => k.links(p, ref)) }));
+    links
+        .command("add")
+        .argument("<document>")
+        .argument("<target-reference>")
+        .addOption(new Option("--kind <kind>")
+        .choices(["links-to", "about", "evidence", "created-from", "related-to", "assigned-to"])
+        .default("related-to"))
+        .option("--role <role>")
+        .option("--evidence <text>")
+        .action(async (doc, to, args) => output(await run(doc, (k, p, ref) => k.addLink(p, ref, { to, ...args }))));
+    links
+        .command("remove")
+        .argument("<document>")
+        .argument("<link-id>")
+        .action(async (doc, id) => output(await run(doc, (k, p, ref) => k.removeLink(p, ref, id))));
+    const notes = program.command("notes").alias("memos").description("Local shared memos about a source document");
+    notes
+        .command("add")
+        .argument("<document>")
+        .argument("<text>")
+        .option("--title <title>")
+        .action(async (doc, text, args) => output(await run(doc, (k, p, ref) => k.addNote(p, ref, text, args.title))));
+    notes
+        .command("list")
+        .argument("<document>")
+        .option("--search <text>")
+        .option("--limit <n>", "maximum notes", positive, 50)
+        .option("--offset <n>", "notes to skip", offset, 0)
+        .action(async (doc, args) => output(await run(doc, (k, p, ref) => k.notes(p, ref, args))));
+    notes
+        .command("show")
+        .argument("<document>")
+        .argument("<note-reference>")
+        .action(async (doc, noteRef) => output(await run(doc, (k, p, ref) => k.note(p, ref, noteRef))));
+    notes
+        .command("edit")
+        .argument("<document>")
+        .argument("<note-reference>")
+        .argument("<text>")
+        .requiredOption("--revision <n>", "revision from notes show; refuses stale edits", positive)
+        .action(async (doc, noteRef, text, args) => output(await run(doc, (k, p, ref) => k.editNote(p, ref, noteRef, text, args.revision))));
+    notes
+        .command("remove")
+        .argument("<document>")
+        .argument("<note-reference>")
+        .action(async (doc, noteRef) => output(await run(doc, (k, p, ref) => k.removeNote(p, ref, noteRef))));
+    const memories = program
+        .command("memories")
+        .description("Evidence-backed shared memories; AI output remains proposed");
+    memories
+        .command("add")
+        .argument("<document>")
+        .argument("<text>")
+        .addOption(new Option("--scope <scope>").choices(["personal", "work"]).makeOptionMandatory())
+        .addOption(new Option("--kind <kind>").choices(MEMORY_KINDS).default("summary"))
+        .option("--supersedes <memory-reference>", "replace an earlier memory about this same source")
+        .action(async (doc, body, args) => output(await run(doc, (k, p, ref) => k.addMemory(p, ref, { body, ...args, status: "proposed" }))));
+    memories
+        .command("list")
+        .argument("<document>")
+        .addOption(new Option("--scope <scope>").choices(["personal", "work"]))
+        .addOption(new Option("--kind <kind>").choices(MEMORY_KINDS))
+        .option("--limit <n>", "maximum memories", positive, 50)
+        .action(async (doc, args) => output({ items: await run(doc, (k, p, ref) => k.memories(p, ref, args)) }));
+    for (const action of ["show", "confirm", "stale"])
+        memories
+            .command(action)
+            .argument("<document>")
+            .argument("<memory-reference>")
+            .action(async (doc, memoryRef) => output(await run(doc, (k, p, ref) => k.memory(p, ref, memoryRef, action))));
+    memories
+        .command("search")
+        .argument("<document>")
+        .argument("<query>")
+        .addOption(new Option("--scope <scope>").choices(["personal", "work"]).makeOptionMandatory())
+        .action(async (doc, query, args) => output(await run(doc, (k, p, ref) => k.searchMemories(p, ref, query, args.scope))));
+    memories
+        .command("extract")
+        .argument("<document>")
+        .description("Explicitly send selected text to the configured shared model; preview proposals or save them")
+        .addOption(new Option("--scope <scope>").choices(["personal", "work"]).makeOptionMandatory())
+        .option("--tab <id>", "extract only this cached Google Docs tab")
+        .option("--save", "save proposed memories with quotes and source snapshot hash")
+        .action(async (doc, args) => {
+        const source = helpers.document(doc);
+        const text = args.tab ? source.snapshot.tabs.find((tab) => tab.id === args.tab)?.text : source.snapshot.text;
+        if (text === undefined)
+            throw new CliError("not_found", "tab was not found in this imported document");
+        const result = await extractMemories(text, helpers.complete());
+        const current = helpers.document(doc);
+        if (current.hash !== source.hash)
+            throw new CliError("validation_error", "source changed during extraction; no memories were saved");
+        const provenance = {
+            document: source.ref,
+            fileId: source.id,
+            hash: source.hash,
+            url: source.snapshot.metadata.url,
+            tab: args.tab ?? null,
+        };
+        const saved = args.save
+            ? await run(doc, async (k, p, ref) => {
+                if (helpers.document(doc).hash !== source.hash)
+                    throw new CliError("validation_error", "source changed during extraction; no memories were saved");
+                const items = [];
+                const by = { bot: "drive-memory", model: result.model };
+                for (const item of result.items) {
+                    const body = `${item.body}\n\nSource quote: ${item.quote}\nSnapshot: ${source.hash}`;
+                    items.push(item.kind === "fact"
+                        ? await k.addFact(p, ref, { statement: body, type: "fact", scope: args.scope, by })
+                        : await k.addMemory(p, ref, {
+                            kind: item.kind,
+                            body,
+                            scope: args.scope,
+                            status: "proposed",
+                            author: by,
+                        }));
+                }
+                return items;
+            })
+            : [];
+        output({ ...result, provenance, saved });
+    });
+    const facts = program
+        .command("facts")
+        .description("What happened, as a document shows it; yours are accepted, an extraction's stay proposed");
+    facts
+        .command("add")
+        .argument("<document>")
+        .argument("<statement>")
+        .addOption(new Option("--type <type>").choices(FACT_TYPES).default("fact"))
+        .addOption(new Option("--scope <scope>").choices(["personal", "work"]))
+        .action(async (doc, statement, args) => output(await run(doc, (k, p, ref) => k.addFact(p, ref, { statement, ...args }))));
+    facts
+        .command("list")
+        .argument("<document>")
+        .addOption(new Option("--type <type>").choices(FACT_TYPES))
+        .addOption(new Option("--status <status>").choices(FACT_STATUSES))
+        .option("--limit <n>", "maximum facts", positive, 50)
+        .action(async (doc, args) => output({ items: await run(doc, (k, p, ref) => k.facts(p, ref, args)) }));
+    for (const action of ["show", "accept"])
+        facts
+            .command(action)
+            .argument("<document>")
+            .argument("<fact-reference>")
+            .action(async (doc, factRef) => output(await run(doc, (k, p, ref) => k.fact(p, ref, factRef, action))));
+    const people = program.command("people").description("Google-observed identities and explicit links to shared people");
+    people
+        .command("list")
+        .argument("<document>")
+        .action(async (doc) => output(await run(doc, (k, p, ref) => k.people(p, ref))));
+    people
+        .command("link")
+        .argument("<document>")
+        .argument("<google-id>")
+        .argument("<person-reference>")
+        .action(async (doc, googleId, personRef) => output(await run(doc, (k, p, ref) => k.linkPerson(p, ref, googleId, personRef))));
+};
+//# sourceMappingURL=knowledge-commands.js.map

package/dist/knowledge-commands.js.map

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

package/dist/knowledge.d.ts

@@ -0,0 +1,50 @@
+import type { Author, Fact, Link, LinkInput, Memory, MemoryInput, MessageStore, Note, PersonRecord } from "@wirecat/cli-messaging/store";
+import type { FileMetadata, GoogleUser } from "./model.js";
+export interface DocumentKnowledge {
+    matches(principal: string, ref: string, filters: {
+        tag?: string;
+        person?: string;
+    }): Promise<boolean>;
+    context(principal: string, ref: string): Promise<unknown>;
+    tags(principal: string, ref: string, action: "list" | "add" | "remove", tags?: string[]): Promise<string[]>;
+    links(principal: string, ref: string): Promise<Link[]>;
+    addLink(principal: string, ref: string, input: Omit<LinkInput, "from" | "origin">): Promise<Link>;
+    removeLink(principal: string, ref: string, id: string): Promise<unknown>;
+    notes(principal: string, ref: string, options?: {
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    addNote(principal: string, ref: string, text: string, title?: string): Promise<Note>;
+    note(principal: string, ref: string, noteRef: string): Promise<Note>;
+    editNote(principal: string, ref: string, noteRef: string, text: string, revision: number): Promise<Note>;
+    removeNote(principal: string, ref: string, noteRef: string): Promise<unknown>;
+    addMemory(principal: string, ref: string, input: Pick<MemoryInput, "body" | "kind" | "scope" | "status" | "supersedes"> & {
+        author?: MemoryInput["author"];
+    }): Promise<Memory>;
+    memories(principal: string, ref: string, options?: {
+        scope?: Memory["scope"];
+        kind?: Memory["kind"];
+        limit?: number;
+    }): Promise<Memory[]>;
+    memory(principal: string, ref: string, memoryRef: string, action?: "show" | "confirm" | "stale"): Promise<Memory>;
+    searchMemories(principal: string, ref: string, query: string, scope: Memory["scope"]): Promise<unknown>;
+    addFact(principal: string, ref: string, input: {
+        statement: string;
+        type: Fact["type"];
+        scope?: Memory["scope"];
+        by?: Author;
+    }): Promise<Fact>;
+    facts(principal: string, ref: string, options?: {
+        type?: Fact["type"];
+        status?: Fact["status"];
+        limit?: number;
+    }): Promise<Fact[]>;
+    fact(principal: string, ref: string, factRef: string, action?: "show" | "accept"): Promise<Fact>;
+    people(principal: string, ref: string): Promise<unknown>;
+    linkPerson(principal: string, ref: string, googleId: string, personRef: string): Promise<PersonRecord>;
+}
+export declare const googleUserId: (user: GoogleUser) => string | undefined;
+export declare const documentKnowledge: (store: MessageStore, folder: (principal: string) => Promise<string | undefined>) => DocumentKnowledge;
+export declare const saveContributors: (store: MessageStore, principal: string, metadata: Pick<FileMetadata, "id" | "owners" | "lastModifiedBy" | "version" | "modifiedAt">, documentId: string, register?: boolean) => Promise<void>;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/knowledge.d.ts.map

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

package/dist/knowledge.js

@@ -0,0 +1,249 @@
+import { CliError } from "@wirecat/cli-base";
+import { normalizeTag } from "@wirecat/cli-messaging";
+export const googleUserId = (user) => user.id || (user.email ? `email:${user.email.trim().toLowerCase()}` : undefined);
+export const documentKnowledge = (store, folder) => {
+    const document = async (principal, ref) => {
+        const note = await store.notes.resolveNote(ref);
+        const folderId = await folder(principal);
+        if (!folderId || !note || note.source !== "file" || note.folderId !== folderId || note.deletedAt)
+            throw new CliError("not_found", "document is not imported in this Google account");
+        return note;
+    };
+    const noteFor = async (principal, ref, noteRef) => {
+        await document(principal, ref);
+        const note = await store.notes.resolveNote(noteRef);
+        const linked = (await store.notes.links({ from: noteRef })).some((link) => link.to === ref && link.kind === "about");
+        // A note's primary subject is included by the shared about query, not necessarily a links row.
+        if (note?.source !== "internal" || note.deletedAt)
+            throw new CliError("not_found", "note is not attached to this document");
+        if (linked)
+            return note;
+        for (let offset = 0; offset <= 10000; offset += 500) {
+            const page = await store.notes.notes({ source: "internal", about: ref, limit: 500, offset });
+            if (page.items.some((n) => n.ref === noteRef))
+                return note;
+            if (!page.hasMore)
+                throw new CliError("not_found", "note is not attached to this document");
+        }
+        throw new CliError("provider_error", "document note lookup exceeded its bound");
+    };
+    const memoryFor = async (principal, ref, memoryRef) => {
+        await document(principal, ref);
+        const memory = await store.memories.get(memoryRef);
+        if (memory.subject !== ref || !memory.evidence.includes(ref))
+            throw new CliError("not_found", "memory is not attached to this document");
+        return memory;
+    };
+    const factFor = async (principal, ref, factRef) => {
+        await document(principal, ref);
+        const fact = await store.facts.get(factRef);
+        if (fact.subject !== ref || !fact.evidence.includes(ref))
+            throw new CliError("not_found", "fact is not attached to this document");
+        return fact;
+    };
+    const port = {
+        matches: async (principal, ref, filters) => {
+            const note = await document(principal, ref);
+            if (filters.tag &&
+                !(await store.knowledge.tags(null, { type: "document", id: note.id })).includes(normalizeTag(filters.tag)))
+                return false;
+            if (filters.person && !(await store.notes.links({ from: ref })).some((link) => link.to === filters.person))
+                return false;
+            return true;
+        },
+        context: async (principal, ref) => {
+            const note = await document(principal, ref);
+            return {
+                document: note,
+                tags: await store.notes.noteTags(ref),
+                links: await store.notes.links({ from: ref }),
+                notes: await store.notes.notes({ source: "internal", about: ref, limit: 100 }),
+                memories: await store.memories.list({ subject: ref, limit: 100 }),
+                facts: await store.facts.list({ subject: ref, limit: 100 }),
+                people: await port.people(principal, ref),
+            };
+        },
+        tags: async (principal, ref, action, tags = []) => {
+            const note = await document(principal, ref);
+            const target = { type: "document", id: note.id };
+            if (action === "add")
+                return store.knowledge.addTags(null, target, tags);
+            if (action === "remove")
+                return store.knowledge.removeTags(null, target, tags);
+            return store.knowledge.tags(null, target);
+        },
+        links: async (principal, ref) => {
+            await document(principal, ref);
+            return store.notes.links({ from: ref });
+        },
+        addLink: async (principal, ref, input) => {
+            await document(principal, ref);
+            return store.notes.addLink({ ...input, from: ref, origin: "owner" });
+        },
+        removeLink: async (principal, ref, id) => {
+            const links = await port.links(principal, ref);
+            if (!links.some((link) => link.id === id && link.origin === "owner"))
+                throw new CliError("not_found", "owner link is not attached to this document");
+            return store.notes.removeLink(id);
+        },
+        notes: async (principal, ref, options) => {
+            await document(principal, ref);
+            return store.notes.notes({ ...options, source: "internal", about: ref });
+        },
+        addNote: async (principal, ref, text, title) => {
+            await document(principal, ref);
+            return store.notes.addNote({ text, ...(title ? { title } : {}), about: [ref] });
+        },
+        note: noteFor,
+        editNote: async (principal, ref, noteRef, text, revision) => {
+            const note = await noteFor(principal, ref, noteRef);
+            return store.notes.editNote(note.id, text, revision);
+        },
+        removeNote: async (principal, ref, noteRef) => {
+            const note = await noteFor(principal, ref, noteRef);
+            return store.notes.removeNote(note.id);
+        },
+        addMemory: async (principal, ref, input) => {
+            await document(principal, ref);
+            if (input.supersedes)
+                await memoryFor(principal, ref, input.supersedes);
+            return store.memories.add({ ...input, subject: ref, evidence: [ref], author: input.author ?? "owner" });
+        },
+        memories: async (principal, ref, options) => {
+            await document(principal, ref);
+            return store.memories.list({ ...options, subject: ref });
+        },
+        memory: async (principal, ref, memoryRef, action = "show") => {
+            const memory = await memoryFor(principal, ref, memoryRef);
+            if (action === "confirm")
+                return store.memories.confirm(memory.ref);
+            if (action === "stale")
+                return store.memories.markStale(memory.ref);
+            return memory;
+        },
+        searchMemories: async (principal, ref, query, scope) => {
+            await document(principal, ref);
+            const candidates = await store.memories.search(query, { scope, limit: 200 });
+            return {
+                items: candidates.filter((memory) => memory.subject === ref),
+                candidateLimitReached: candidates.length === 200,
+            };
+        },
+        addFact: async (principal, ref, { statement, type, scope, by }) => {
+            await document(principal, ref);
+            return store.facts.add({
+                type,
+                statement,
+                by: by ?? "owner",
+                subject: ref,
+                evidence: [ref],
+                ...(scope === undefined ? {} : { scope }),
+            });
+        },
+        facts: async (principal, ref, options) => {
+            await document(principal, ref);
+            return store.facts.list({ ...options, subject: ref });
+        },
+        fact: async (principal, ref, factRef, action = "show") => {
+            const fact = await factFor(principal, ref, factRef);
+            return action === "accept" ? store.facts.accept(fact.ref) : fact;
+        },
+        people: async (principal, ref) => {
+            const note = await document(principal, ref);
+            const metadata = note.frontMatter;
+            const contributors = [
+                ...(metadata.owners ?? []).map((user) => ({ ...user, role: "owner" })),
+                ...(metadata.lastModifiedBy ? [{ ...metadata.lastModifiedBy, role: "last-editor" }] : []),
+            ];
+            return {
+                items: await Promise.all(contributors.map(async (user) => {
+                    const id = googleUserId(user);
+                    const person = id ? await store.personOf({ provider: "google-drive", id }) : undefined;
+                    return { ...user, googleId: id ?? null, person: person ? { ref: `person:${person.uid}`, ...person } : null };
+                })),
+                coverage: "owners and last editor supplied by Google; not a complete list of historical editors",
+            };
+        },
+        linkPerson: async (principal, ref, googleId, personRef) => {
+            const note = await document(principal, ref);
+            const metadata = note.frontMatter;
+            const users = [...(metadata.owners ?? []), ...(metadata.lastModifiedBy ? [metadata.lastModifiedBy] : [])];
+            if (!users.some((user) => googleUserId(user) === googleId))
+                throw new CliError("not_found", "Google identity was not observed on this document");
+            if (!personRef.startsWith("person:"))
+                throw new CliError("validation_error", "target must be a person reference");
+            const person = await store.personByUid(personRef.slice(7));
+            if (!person?.identities[0])
+                throw new CliError("not_found", "target person has no known identity");
+            const linked = await store.linkIdentities(person.identities[0], { provider: "google-drive", id: googleId }, {
+                method: "manual",
+                by: "drive",
+            });
+            // Identity decisions leave already-imported file links pointing at the former person.
+            // Refresh observed Google roles without touching the owner's relationships or names.
+            for (const sourceFolder of await store.notes.folders()) {
+                if (!sourceFolder.name.startsWith("google-drive:"))
+                    continue;
+                for (let offset = 0; offset <= 10000; offset += 500) {
+                    const page = await store.notes.notes({ folderId: sourceFolder.id, source: "file", limit: 500, offset });
+                    for (const source of page.items) {
+                        const data = source.frontMatter;
+                        if (data?.source !== "google-drive" || !data.fileId)
+                            continue;
+                        const contributors = [...(data.owners ?? []), ...(data.lastModifiedBy ? [data.lastModifiedBy] : [])];
+                        if (!contributors.some((user) => googleUserId(user) === googleId))
+                            continue;
+                        await saveContributors(store, sourceFolder.name.slice("google-drive:".length), {
+                            id: data.fileId,
+                            owners: data.owners,
+                            lastModifiedBy: data.lastModifiedBy,
+                            version: data.sourceVersion,
+                            modifiedAt: data.modifiedAt,
+                        }, source.id, false);
+                    }
+                    if (!page.hasMore)
+                        break;
+                    if (offset === 10000)
+                        throw new CliError("provider_error", "identity linked; document relationship refresh exceeded its bound");
+                }
+            }
+            return linked;
+        },
+    };
+    return port;
+};
+export const saveContributors = async (store, principal, metadata, documentId, register = true) => {
+    const users = [
+        ...(metadata.owners ?? []).map((user) => ({ user, role: "owner" })),
+        ...(metadata.lastModifiedBy ? [{ user: metadata.lastModifiedBy, role: "last-editor" }] : []),
+    ];
+    const key = { provider: "google-drive", account: principal };
+    const identified = users.flatMap(({ user, role }) => {
+        const id = googleUserId(user);
+        return id ? [{ id, user, role }] : [];
+    });
+    if (register && identified.length) {
+        await store.saveAccount(key, { name: "Google Drive" });
+        await store.savePeople(key, identified.map(({ id, user }) => ({ id, name: user.name ?? user.email ?? null })));
+    }
+    const links = [];
+    for (const { id, user, role } of identified) {
+        const person = await store.personOf({ provider: "google-drive", id });
+        if (person)
+            links.push({
+                kind: "related-to",
+                to: `person:${person.uid}`,
+                role,
+                evidence: JSON.stringify({
+                    fileId: metadata.id,
+                    version: metadata.version,
+                    modifiedAt: metadata.modifiedAt,
+                    user,
+                }),
+                provenance: "google-drive:files.get",
+                confirmed: false,
+            });
+    }
+    await store.notes.replaceFileLinks(documentId, links);
+};
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

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

package/dist/login.d.ts

@@ -0,0 +1,25 @@
+import { type KeyringStore } from "@wirecat/cli-base";
+import { OAuth2Client } from "google-auth-library";
+import { type OAuthApplication } from "./config.js";
+export interface LoginOptions {
+    env: NodeJS.ProcessEnv;
+    profile: string;
+    application: OAuthApplication;
+    storage: "keyring" | "file";
+    keyring?: KeyringStore;
+    openBrowser: (url: string) => Promise<void>;
+    showUrl: (url: string) => void;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    makeClient?: (redirect: string) => OAuth2Client;
+    identity?: (client: OAuth2Client) => Promise<string>;
+    write?: boolean;
+    activity?: boolean;
+    apps?: boolean;
+}
+export declare const login: (options: LoginOptions) => Promise<{
+    profile: string;
+    signedIn: true;
+    storage: string;
+}>;
+//# sourceMappingURL=login.d.ts.map

package/dist/login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.d.ts","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EAAyD,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACzG,OAAO,EAAE,KAAK,gBAAgB,EAAwC,MAAM,aAAa,CAAA;AAIzF,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,CAAA;IAC7B,OAAO,EAAE,SAAS,GAAG,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,CAAA;IAC/C,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AACD,eAAO,MAAM,KAAK,YAAmB,YAAY,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiH/G,CAAA"}