@halyard/cli 0.1.2 → 0.2.0

package/dist/commands/skills.js

@@ -0,0 +1,171 @@
+import { homedir } from 'node:os';
+import { Command } from 'commander';
+import { getAuthHeaders } from '../lib/auth.js';
+import { printJson, printTable } from '../lib/output.js';
+import { runPreflight } from '../lib/preflight.js';
+import { findRepoBinding, gitToplevel } from '../lib/repo-binding.js';
+import { discoverSelectedSkills, prepareSkill, projectScopeKey, runSkillsSync, } from '../lib/skills-sync.js';
+import { USER_SKILL_LOCATIONS, PROJECT_SKILL_LOCATIONS, } from '../lib/skills-discovery.js';
+function parseScope(value) {
+    if (value === 'user' || value === 'project' || value === 'all')
+        return value;
+    if (value === undefined)
+        return 'all';
+    console.error(`Invalid --scope "${String(value)}": expected user, project or all`);
+    process.exit(1);
+}
+/** The repo whose skills count as project scope: the binding root, else the git toplevel. */
+function resolveProjectRoot() {
+    return findRepoBinding()?.rootDir ?? gitToplevel(process.cwd()) ?? undefined;
+}
+function lookedIn(scope) {
+    const user = USER_SKILL_LOCATIONS.map((l) => `~/${l.dir}`);
+    const project = PROJECT_SKILL_LOCATIONS.map((l) => `<repo>/${l.dir}`);
+    const dirs = scope === 'user' ? user : scope === 'project' ? project : [...user, ...project];
+    return `Looked in: ${dirs.join(', ')}`;
+}
+/**
+ * One `skills list` row. `upload` says how many manifest files would go up
+ * with their bytes — SKILL.md rides as front-matter + body, so a lone
+ * SKILL.md reads `0/1 files` — which keeps the dry run honest about what
+ * the sync sends.
+ */
+export function skillListRow(skill, upload) {
+    const withContent = upload.files.filter((f) => f.content !== undefined).length;
+    return {
+        name: upload.name,
+        scope: skill.scope,
+        harnesses: skill.harnesses.join(','),
+        path: skill.relativePath,
+        files: upload.files.length,
+        upload: `${withContent}/${upload.files.length} files`,
+        hash: upload.treeHash.slice(0, 12),
+        description: upload.description ?? '',
+        locations: skill.locations,
+        dir: skill.dir,
+    };
+}
+function listAction() {
+    const opts = this.opts();
+    const scope = parseScope(opts.scope);
+    const json = !!this.optsWithGlobals().json;
+    const projectRoot = resolveProjectRoot();
+    const skills = discoverSelectedSkills({ scope, homeDir: homedir(), projectRoot });
+    const projectKey = projectRoot ? projectScopeKey(projectRoot) : '';
+    const rows = [];
+    for (const skill of skills) {
+        try {
+            const { upload, warnings } = prepareSkill(skill, skill.scope === 'project' ? projectKey : '');
+            for (const warning of warnings)
+                console.error(`warning: ${skill.relativePath}: ${warning}`);
+            rows.push(skillListRow(skill, upload));
+        }
+        catch (err) {
+            console.error(`error: ${skill.relativePath}: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    }
+    if (json) {
+        printJson(rows);
+        return;
+    }
+    if (rows.length === 0) {
+        console.log('No skills found.');
+        console.log(lookedIn(scope));
+        return;
+    }
+    printTable(rows, [
+        { key: 'name', header: 'NAME' },
+        { key: 'scope', header: 'SCOPE' },
+        { key: 'harnesses', header: 'HARNESSES' },
+        { key: 'path', header: 'PATH' },
+        { key: 'files', header: 'FILES' },
+        { key: 'upload', header: 'UPLOAD' },
+        { key: 'hash', header: 'HASH' },
+    ]);
+}
+async function syncAction() {
+    const opts = this.opts();
+    const globalOpts = this.optsWithGlobals();
+    const apiUrl = globalOpts.apiUrl;
+    const json = !!globalOpts.json;
+    const scope = parseScope(opts.scope);
+    const dryRun = !!opts.dryRun;
+    const force = !!opts.force;
+    const projectRoot = resolveProjectRoot();
+    const binding = findRepoBinding();
+    // --json keeps stdout for the summary object; progress goes to stderr.
+    const log = json ? console.error : console.log;
+    let target;
+    let authHeaders;
+    try {
+        target = await runPreflight({
+            apiUrl,
+            binding,
+            scopeLabel: scope === 'user' ? 'personal skills' : 'skills',
+            print: log,
+        });
+        authHeaders = await getAuthHeaders(apiUrl);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    if (scope !== 'user' && !projectRoot) {
+        log(scope === 'project'
+            ? 'Not inside a git repository - no project skills to sync.'
+            : 'Not inside a git repository - syncing personal skills only.');
+    }
+    log('Discovering skills...');
+    const summary = await runSkillsSync({
+        homeDir: homedir(),
+        projectRoot,
+        scope,
+        stateKey: target.stateKey,
+        authHeaders,
+        apiUrl,
+        dryRun,
+        force,
+        log,
+    });
+    if (json) {
+        printJson(summary);
+    }
+    else if (summary.found === 0) {
+        console.log('No skills found.');
+        console.log(lookedIn(scope));
+    }
+    else {
+        console.log('');
+        console.log(summaryLine(summary, dryRun));
+    }
+    if (summary.failed > 0)
+        process.exitCode = 1;
+}
+function summaryLine(summary, dryRun) {
+    if (dryRun) {
+        const pending = summary.found - summary.skipped - summary.failed;
+        return (`Dry run: ${summary.found} found, ${pending} would sync, ` +
+            `${summary.skipped} already synced, ${summary.failed} unreadable`);
+    }
+    return (`Skills sync complete: ${summary.found} found, ${summary.created} created, ` +
+        `${summary.updated} updated, ${summary.unchanged} unchanged, ` +
+        `${summary.skipped} already synced, ${summary.failed} failed`);
+}
+export function skillsCommand() {
+    const skills = new Command('skills').description('Discover agent skills (SKILL.md folders) on this machine and sync them to Halyard');
+    skills
+        .command('list')
+        .description('List the skills discovered in the user and project skill directories')
+        .option('--scope <scope>', 'user | project | all (default: all)')
+        .action(listAction);
+    skills
+        .command('sync')
+        .description('Upload new or changed skills to the knowledge base (fingerprint-deduplicated)')
+        .option('--scope <scope>', 'user | project | all (default: all)')
+        .option('--dry-run', 'Show what would be synced without uploading')
+        .option('--force', 'Ignore the local ledger and re-send every skill (server still dedupes)')
+        .action(syncAction);
+    return skills;
+}
+//# sourceMappingURL=skills.js.map

package/dist/commands/skills.js.map

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

package/dist/commands/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAYnC,wBAAgB,WAAW,IAAI,OAAO,CAgGrC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,wBAAgB,WAAW,IAAI,OAAO,CA6FrC"}

package/dist/commands/sync.js

@@ -1,21 +1,45 @@
-import { readFileSync } from 'node:fs';
 import { Command } from 'commander';
 import { getAuthHeaders } from '../lib/auth.js';
-import { discoverAllSessions } from '../lib/discovery.js';
-import { readSyncState, writeSyncState, isUploaded, markUploaded, hashFileContents, } from '../lib/sync-state.js';
-import { uploadSession } from '../lib/api-client.js';
+import { SESSION_PROVIDERS } from '../lib/discovery.js';
+import { findRepoBinding } from '../lib/repo-binding.js';
+import { runPreflight } from '../lib/preflight.js';
+import { discoverScopedSessions, uploadSessions } from '../lib/sync-runner.js';
+import { readSyncState, writeSyncState } from '../lib/sync-state.js';
 export function syncCommand() {
     return new Command('sync')
         .description('Discover and upload new session logs to Halyard')
-        .option('--provider <provider>', 'Filter by provider (claude, codex)')
+        .option('--provider <provider>', `Filter by provider (${SESSION_PROVIDERS.join(', ')})`)
         .option('--dry-run', 'Show what would be uploaded without uploading')
+        .option('--all', 'Sync every session on this machine, ignoring the repo binding scope')
         .action(async function () {
         const opts = this.opts();
         const globalOpts = this.optsWithGlobals();
         const apiUrl = globalOpts.apiUrl;
         const providerFilter = opts.provider;
         const dryRun = !!opts.dryRun;
-        // Authenticate
+        const all = !!opts.all;
+        const binding = findRepoBinding();
+        const scoped = binding !== null && !all;
+        // Preflight: resolve + print the destination org; hard-fail on a
+        // binding/credentials org mismatch (also under --dry-run). --all is the
+        // explicit machine-wide escape hatch, so it bypasses the binding guard
+        // along with the scoping (old behavior).
+        let target;
+        try {
+            target = await runPreflight({
+                apiUrl,
+                binding: scoped ? binding : null,
+                scopeLabel: scoped ? binding.rootDir : 'all sessions',
+            });
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+        if (!binding && !all) {
+            console.log('No .halyard.json repo binding found - syncing all sessions on this machine.\n' +
+                'Run `halyard setup --org <slug>` in a repo to scope sync to it.');
+        }
         let authHeaders;
         try {
             authHeaders = await getAuthHeaders(apiUrl);
@@ -24,60 +48,38 @@ export function syncCommand() {
             console.error(err instanceof Error ? err.message : String(err));
             process.exit(1);
         }
-        // Discover sessions
         console.log('Discovering session logs...');
-        const sessions = discoverAllSessions(providerFilter);
-        if (sessions.length === 0) {
+        const discovered = discoverScopedSessions({
+            providerFilter,
+            scopeRootDir: scoped ? binding.rootDir : undefined,
+        });
+        if (discovered.found === 0) {
             console.log('No session logs found.');
             if (!providerFilter) {
-                console.log('Looked in: ~/.claude/projects/ and ~/.codex/sessions/');
+                console.log('Looked in: ~/.claude/projects/, ~/.codex/sessions/, ~/.gemini/tmp/, the OpenCode store, and the Copilot CLI store');
             }
             return;
         }
-        console.log(`Found ${sessions.length} session log(s)`);
-        // Load sync state and filter out already-uploaded files
-        const syncState = readSyncState();
-        let uploaded = 0;
-        let skipped = 0;
-        let failed = 0;
-        for (const session of sessions) {
-            const content = readFileSync(session.filePath);
-            const hash = hashFileContents(content);
-            if (isUploaded(syncState, session.filePath, hash)) {
-                skipped++;
-                continue;
-            }
-            if (dryRun) {
-                const sizeKb = (session.sizeBytes / 1024).toFixed(1);
-                console.log(`  [dry-run] Would upload: ${session.filePath} (${sizeKb} KB)`);
-                uploaded++;
-                continue;
-            }
-            try {
-                const result = await uploadSession(session.filePath, session.provider, session.sessionId, authHeaders, apiUrl);
-                markUploaded(syncState, session.filePath, {
-                    sessionId: result.sessionId,
-                    uploadedAt: new Date().toISOString(),
-                    size: session.sizeBytes,
-                    hash,
-                });
-                const sizeKb = (session.sizeBytes / 1024).toFixed(1);
-                const status = result.status === 'duplicate' ? 'already exists' : 'uploaded';
-                console.log(`  ${status}: ${session.filePath} (${sizeKb} KB)`);
-                uploaded++;
-            }
-            catch (err) {
-                console.error(`  failed: ${session.filePath} - ${err instanceof Error ? err.message : String(err)}`);
-                failed++;
-            }
+        console.log(scoped
+            ? `Found ${discovered.found} session log(s); ${discovered.sessions.length} match this repo`
+            : `Found ${discovered.found} session log(s)`);
+        if (discovered.unresolved > 0) {
+            console.log(`Skipped ${discovered.unresolved} session(s) whose repo could not be determined ` +
+                `(\`halyard sync --all\` includes everything)`);
         }
-        // Save sync state
+        const syncState = readSyncState();
+        const totals = await uploadSessions(discovered.sessions, syncState, {
+            stateKey: target.stateKey,
+            authHeaders,
+            apiUrl,
+            dryRun,
+            log: console.log,
+        });
         if (!dryRun) {
             writeSyncState(syncState);
         }
-        // Summary
         console.log('');
-        console.log(`Sync complete: ${uploaded} uploaded, ${skipped} already synced, ${failed} failed`);
+        console.log(`Sync complete: ${totals.uploaded} uploaded, ${totals.skipped} already synced, ${totals.failed} failed`);
     });
 }
 //# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/users.d.ts

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+export interface UserUpdateOpts {
+    name?: string;
+    accessRole?: string;
+    roles?: string;
+    skills?: string;
+    availability?: string;
+    routable?: string;
+}
+/** Build the PATCH body from provided flags only (server treats undefined as no-change). */
+export declare function buildUserUpdateBody(opts: UserUpdateOpts): Record<string, unknown>;
+export declare function usersCommand(): Command;
+//# sourceMappingURL=users.d.ts.map

package/dist/commands/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/commands/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmBnC,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAWD,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASjF;AAED,wBAAgB,YAAY,IAAI,OAAO,CAwMtC"}

package/dist/commands/users.js

@@ -0,0 +1,205 @@
+import { Command } from 'commander';
+import { apiFetch, ApiError } from '../lib/http.js';
+import { printTable, printJson, formatDate, confirm, fail } from '../lib/output.js';
+const ACCESS_ROLES = ['ADMIN', 'MEMBER'];
+const AVAILABILITIES = ['ONLINE', 'AWAY', 'DND'];
+/** Split a comma-separated flag value; empty string clears the list. */
+function splitList(value) {
+    if (value.trim() === '')
+        return [];
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+/** Build the PATCH body from provided flags only (server treats undefined as no-change). */
+export function buildUserUpdateBody(opts) {
+    const body = {};
+    if (opts.name !== undefined)
+        body['name'] = opts.name;
+    if (opts.accessRole !== undefined)
+        body['accessRole'] = opts.accessRole;
+    if (opts.roles !== undefined)
+        body['roles'] = splitList(opts.roles);
+    if (opts.skills !== undefined)
+        body['skills'] = splitList(opts.skills);
+    if (opts.availability !== undefined)
+        body['availability'] = opts.availability;
+    if (opts.routable !== undefined)
+        body['routable'] = opts.routable === 'true';
+    return body;
+}
+export function usersCommand() {
+    const users = new Command('users').description('Manage users in the current organization');
+    users
+        .command('list')
+        .description('List users in the organization')
+        .action(async function () {
+        const globalOpts = this.optsWithGlobals();
+        const apiUrl = globalOpts.apiUrl;
+        let response;
+        try {
+            response = await apiFetch(apiUrl, '/api/v1/users');
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+        if (globalOpts.json) {
+            printJson(response);
+            return;
+        }
+        printTable(response.users, [
+            { key: 'id', header: 'ID' },
+            { key: 'name', header: 'NAME' },
+            { key: 'email', header: 'EMAIL' },
+            { key: 'accessRole', header: 'ACCESS' },
+            {
+                key: 'roles',
+                header: 'ROLES',
+                format: (v) => {
+                    const joined = Array.isArray(v) ? v.join(',') : '';
+                    if (joined === '')
+                        return '-';
+                    return joined.length > 30 ? `${joined.slice(0, 27)}...` : joined;
+                },
+            },
+            { key: 'availability', header: 'AVAILABILITY' },
+            { key: 'lastLoginAt', header: 'LAST LOGIN', format: formatDate },
+        ]);
+    });
+    users
+        .command('describe')
+        .description('Show details for a user')
+        .argument('<id>', 'User ID (from `halyard users list`)')
+        .action(async function (id) {
+        const globalOpts = this.optsWithGlobals();
+        const apiUrl = globalOpts.apiUrl;
+        let response;
+        try {
+            response = await apiFetch(apiUrl, `/api/v1/users/${id}`);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+        if (globalOpts.json) {
+            printJson(response);
+            return;
+        }
+        const user = response.user;
+        const counts = user['_count'];
+        const row = (label, value) => {
+            const rendered = value === null || value === undefined || value === ''
+                ? '-'
+                : Array.isArray(value)
+                    ? value.length > 0
+                        ? value.join(', ')
+                        : '-'
+                    : String(value);
+            console.log(`${label.padEnd(14)}${rendered}`);
+        };
+        row('ID:', user['id']);
+        row('Name:', user['name']);
+        row('Email:', user['email']);
+        row('Access role:', user['accessRole']);
+        row('Roles:', user['roles']);
+        row('Skills:', user['skills']);
+        row('Availability:', user['availability']);
+        row('Last login:', formatDate(user['lastLoginAt']));
+        row('Created:', formatDate(user['createdAt']));
+        if (counts) {
+            row('Sessions:', counts.sessions ?? 0);
+            row('Messages:', counts.messages ?? 0);
+        }
+    });
+    users
+        .command('update')
+        .description('Update a user (self, or others as admin)')
+        .argument('<id>', 'User ID')
+        .option('--name <name>', 'Display name')
+        .option('--access-role <role>', `Org access role (${ACCESS_ROLES.join('|')})`)
+        .option('--roles <roles>', 'Comma-separated role list; "" clears')
+        .option('--skills <skills>', 'Comma-separated skill list; "" clears')
+        .option('--availability <availability>', `Availability (${AVAILABILITIES.join('|')})`)
+        .option('--routable <true|false>', 'Whether teammate questions are routed to this user')
+        .action(async function (id) {
+        const globalOpts = this.optsWithGlobals();
+        const apiUrl = globalOpts.apiUrl;
+        const opts = this.opts();
+        const body = buildUserUpdateBody(opts);
+        if (Object.keys(body).length === 0) {
+            fail('Nothing to update; pass at least one of --name/--access-role/--roles/--skills/--availability/--routable');
+        }
+        if (opts.accessRole !== undefined &&
+            !ACCESS_ROLES.includes(opts.accessRole)) {
+            fail(`--access-role must be one of: ${ACCESS_ROLES.join(', ')}`);
+        }
+        if (opts.availability !== undefined &&
+            !AVAILABILITIES.includes(opts.availability)) {
+            fail(`--availability must be one of: ${AVAILABILITIES.join(', ')}`);
+        }
+        if (opts.routable !== undefined && !['true', 'false'].includes(opts.routable)) {
+            fail('--routable must be true or false');
+        }
+        let response;
+        try {
+            response = await apiFetch(apiUrl, `/api/v1/users/${id}`, {
+                method: 'PATCH',
+                body,
+            });
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+        if (globalOpts.json) {
+            printJson(response);
+            return;
+        }
+        console.log(`Updated user ${response.user.name ?? response.user.id}.`);
+    });
+    users
+        .command('invite')
+        .description('Invite a person by email. Invites are email-only and not tracked - there is no list or cancel.')
+        .argument('<email>', 'Email address to invite')
+        .action(async function (email) {
+        const globalOpts = this.optsWithGlobals();
+        const apiUrl = globalOpts.apiUrl;
+        try {
+            await apiFetch(apiUrl, '/api/v1/users/invite', { method: 'POST', body: { email } });
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+        if (globalOpts.json) {
+            printJson({ success: true, email });
+            return;
+        }
+        console.log(`Invite sent to ${email}.`);
+        console.log('Note: pending invites cannot be listed or canceled.');
+    });
+    users
+        .command('remove')
+        .description('Remove a user from the organization (admin only)')
+        .argument('<id>', 'User ID')
+        .option('-f, --force', 'Skip the confirmation prompt')
+        .action(async function (id) {
+        const globalOpts = this.optsWithGlobals();
+        const apiUrl = globalOpts.apiUrl;
+        const force = !!this.opts().force;
+        const confirmed = await confirm(`Remove user ${id}? This permanently deletes the user and their knowledge grants.`, { force });
+        if (!confirmed) {
+            fail('Aborted.');
+        }
+        try {
+            await apiFetch(apiUrl, `/api/v1/users/${id}`, { method: 'DELETE' });
+        }
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404) {
+                fail('User not found in this organization.');
+            }
+            fail(err instanceof Error ? err.message : String(err));
+        }
+        console.log('User removed.');
+    });
+    return users;
+}
+//# sourceMappingURL=users.js.map

package/dist/commands/users.js.map

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

package/dist/commands/whoami.d.ts

@@ -0,0 +1,21 @@
+import { Command } from 'commander';
+export interface MeResponse {
+    user: {
+        id: string;
+        email: string | null;
+        name: string | null;
+        accessRole: string;
+        isAdmin: boolean;
+    };
+    organization: {
+        id: string;
+        name: string;
+        slug: string;
+    } | null;
+    authenticatedVia?: {
+        type: string;
+        clientName: string | null;
+    };
+}
+export declare function whoamiCommand(): Command;
+//# sourceMappingURL=whoami.d.ts.map

package/dist/commands/whoami.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,OAAO,CAAA;KACjB,CAAA;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,GAAG,IAAI,CAAA;IACR,gBAAgB,CAAC,EAAE;QACjB,IAAI,EAAE,MAAM,CAAA;QACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAC1B,CAAA;CACF;AA4BD,wBAAgB,aAAa,IAAI,OAAO,CAuDvC"}