@productbrain/cli 0.1.0-beta.1 → 0.1.0-beta.102

package/dist/commands/setup-resolver.js

@@ -0,0 +1,150 @@
+/**
+ * WP-336 E2 (CLI side): Dual-mode setup asset resolver for `pb handshake`.
+ *
+ * SetupMode:
+ *   local — reads skills/rules from .productbrain/ (current builder behavior, default).
+ *   chain — calls the Convex API (setup.getActiveSurface) and returns Chain-backed assets.
+ *
+ * The env var PB_SETUP_MODE controls which path runs:
+ *   unset or 'local' → local mode (no network call, fully offline-safe)
+ *   'chain'          → chain mode (requires authenticated kernelCall, user workspace)
+ *
+ * Chain: WP-336 (Agent Surface Foundation), DEC-619 (setup_receipt infrastructure)
+ */
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join, basename } from 'path';
+// ── Mode resolution ───────────────────────────────────────────────────────────
+/**
+ * Returns the active SetupMode.
+ * Reads PB_SETUP_MODE from process.env.
+ * Unknown values default to 'local' (fail-open for forward compat).
+ */
+export function getSetupMode() {
+    const raw = process.env.PB_SETUP_MODE;
+    if (raw === 'chain')
+        return 'chain';
+    return 'local';
+}
+// ── Local mode ────────────────────────────────────────────────────────────────
+/**
+ * Read a single Markdown file from a .productbrain/ sub-directory.
+ * Returns the file body after stripping a minimal YAML frontmatter block
+ * (lines between opening and closing ---). If no frontmatter is found,
+ * returns the full file content unchanged.
+ *
+ * We intentionally keep this light — the local mode is a contract test pass-through
+ * that verifies parity with the existing handshake.ts lines 443–507 pipeline.
+ */
+function stripFrontmatter(raw) {
+    const lines = raw.split('\n');
+    if (lines[0]?.trim() !== '---')
+        return raw;
+    const closeIdx = lines.indexOf('---', 1);
+    if (closeIdx === -1)
+        return raw;
+    return lines.slice(closeIdx + 1).join('\n').trimStart();
+}
+/**
+ * Read skills from .productbrain/skills/ and map them to SetupAsset[].
+ * Mirrors the shape produced by readCanonicalSkills() in portable-knowledge.ts.
+ * Does NOT apply level/stage filtering — that remains in the handshake pipeline.
+ */
+function readLocalSkillAssets(pbDir) {
+    const skillsDir = join(pbDir, 'skills');
+    if (!existsSync(skillsDir))
+        return [];
+    const files = readdirSync(skillsDir).filter((f) => f.endsWith('.md'));
+    return files.map((file) => {
+        const raw = readFileSync(join(skillsDir, file), 'utf8');
+        const displayName = basename(file, '.md');
+        return {
+            assetKind: 'skill',
+            displayName,
+            body: stripFrontmatter(raw),
+            source: 'authored',
+        };
+    });
+}
+/**
+ * Read rules from .productbrain/rules/ and map them to SetupAsset[].
+ * Mirrors the shape produced by readCanonicalRules() in portable-knowledge.ts.
+ */
+function readLocalRuleAssets(pbDir) {
+    const rulesDir = join(pbDir, 'rules');
+    if (!existsSync(rulesDir))
+        return [];
+    const files = readdirSync(rulesDir).filter((f) => f.endsWith('.md'));
+    return files.map((file) => {
+        const raw = readFileSync(join(rulesDir, file), 'utf8');
+        const displayName = basename(file, '.md');
+        return {
+            assetKind: 'rule',
+            displayName,
+            body: stripFrontmatter(raw),
+            source: 'authored',
+        };
+    });
+}
+/**
+ * Local mode: return skills + rules from .productbrain/.
+ *
+ * This is the identity pass-through — the assets returned here are the same
+ * files that handshake.ts lines 443–507 already read via readCanonicalSkills()
+ * and readCanonicalRules(). The resolver does NOT replace those calls; it is a
+ * parallel view used for contract testing and mode-switching.
+ */
+function resolveLocalAssets(pbDir) {
+    return [
+        ...readLocalSkillAssets(pbDir),
+        ...readLocalRuleAssets(pbDir),
+    ];
+}
+// ── Chain mode ────────────────────────────────────────────────────────────────
+/**
+ * Map a raw GetActiveSurfaceResult to a typed SetupAsset.
+ * Falls back gracefully on unexpected assetKind values.
+ */
+function mapChainAsset(raw) {
+    const assetKind = raw.assetKind === 'rule' ? 'rule'
+        : raw.assetKind === 'hook' ? 'hook'
+            : 'skill'; // default — skill is the safe fallback
+    const source = raw.source === 'authored' ? 'authored'
+        : raw.source === 'imported' ? 'imported'
+            : 'seeded';
+    return {
+        assetKind,
+        displayName: raw.displayName,
+        body: raw.body,
+        source,
+    };
+}
+/**
+ * Chain mode: call setup.getActiveSurface via the AKI gateway and return assets.
+ *
+ * workspaceId is injected server-side by the gateway (BR-18).
+ * personId is injected server-side by injectSessionAuth — the CLI does not pass it.
+ *
+ * @param kernelCall - the authenticated kernelCall function from the handshake flow
+ */
+async function resolveChainAssets(kernelCall) {
+    const results = await kernelCall('setup.getActiveSurface', {});
+    return results.map(mapChainAsset);
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+/**
+ * Resolve setup assets for the current mode.
+ *
+ * @param mode      - 'local' | 'chain', from getSetupMode()
+ * @param kernelCall - authenticated kernelCall function (from packages/cli/src/lib/client.ts)
+ *                    Only called in chain mode.
+ * @param cwd       - current working directory (for .productbrain/ path resolution)
+ */
+export async function resolveSetupAssets(mode, kernelCall, cwd) {
+    if (mode === 'chain') {
+        return resolveChainAssets(kernelCall);
+    }
+    // local mode — read from .productbrain/ (synchronous, no network)
+    const pbDir = join(cwd, '.productbrain');
+    return resolveLocalAssets(pbDir);
+}
+//# sourceMappingURL=setup-resolver.js.map

package/dist/commands/setup-resolver.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,15 @@
+/**
+ * pb setup — guided first-time onboarding: npm install → first capture.
+ * WP-301 Slice 3. Each step emits telemetry (STD-155 event names).
+ *
+ * Flow:
+ *   0. Check existing config → offer health check or continue to login
+ *   1. Account check → signup URL or login inline
+ *   2. Workspace binding confirmation
+ *   3. Guided first capture (starts a session, captures via MCP)
+ *   4. Summary with next-step hint
+ *
+ * WP-303 Slice 1: migrated from readline to @clack/prompts via lib/prompts.ts.
+ */
+export declare function runSetup(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9C"}

package/dist/commands/setup.js

@@ -0,0 +1,148 @@
+/**
+ * pb setup — guided first-time onboarding: npm install → first capture.
+ * WP-301 Slice 3. Each step emits telemetry (STD-155 event names).
+ *
+ * Flow:
+ *   0. Check existing config → offer health check or continue to login
+ *   1. Account check → signup URL or login inline
+ *   2. Workspace binding confirmation
+ *   3. Guided first capture (starts a session, captures via MCP)
+ *   4. Summary with next-step hint
+ *
+ * WP-303 Slice 1: migrated from readline to @clack/prompts via lib/prompts.ts.
+ */
+import { getConfig } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { readSession, writeSession } from '../lib/session.js';
+import { trackEvent } from '../lib/telemetry.js';
+import { runLogin } from './login.js';
+import { initTelemetry } from '../lib/telemetry.js';
+import { confirm as promptConfirm } from '../lib/prompts.js';
+import { bold } from '../lib/style.js';
+/** Mask an API key for display: show prefix + last 4 chars. */
+function maskKey(key) {
+    if (key.length <= 10)
+        return key.slice(0, 6) + '****';
+    return key.slice(0, 6) + '...' + key.slice(-4);
+}
+export async function runSetup() {
+    await runSetupFlow();
+}
+async function runSetupFlow() {
+    console.log('');
+    console.log('Product Brain — Setup');
+    console.log('=====================');
+    console.log('');
+    // Step 1: Check existing config
+    let hasValidConfig = false;
+    try {
+        const config = getConfig();
+        hasValidConfig = true;
+        console.log(`Already configured: ${maskKey(config.apiKey)}`);
+        console.log(`API endpoint: ${config.siteUrl}`);
+        console.log('');
+        // Verify workspace connectivity
+        let wsName = 'your workspace';
+        let wsId;
+        try {
+            const workspace = await kernelCall('resolveWorkspace', {});
+            if (workspace?.name) {
+                console.log(`Connected to workspace: ${workspace.name}`);
+                wsName = workspace.name;
+                wsId = workspace._id;
+            }
+            else {
+                console.log('Workspace connection verified.');
+            }
+            trackEvent('workspace_bound');
+        }
+        catch {
+            console.log('Warning: Could not verify workspace connection. Your key may be invalid.');
+            console.log('Run `pb login` to re-enter your API key.');
+            return;
+        }
+        console.log('');
+        // Already configured — go straight to onboarding conversation (WP-304)
+        await ensureSessionAndOnboard(wsName, wsId);
+        return;
+    }
+    catch {
+        // No valid config — continue to login
+    }
+    // Step 2: Account check + login (only if no valid config)
+    if (!hasValidConfig) {
+        console.log('To get started, you need a Product Brain account and API key.');
+        console.log('');
+        const hasAccount = await promptConfirm({ message: 'Do you have a Product Brain account?', initialValue: false });
+        if (!hasAccount) {
+            console.log('');
+            console.log('Create an account at: https://productbrain.io');
+            console.log('Then come back and run: pb setup');
+            console.log('');
+            return;
+        }
+        // Run login flow — handles key prompt, validation, and saving
+        console.log('');
+        await runLogin();
+        trackEvent('key_validated');
+        await runSetupPostLogin();
+        return;
+    }
+}
+async function runSetupPostLogin() {
+    console.log('');
+    let wsName = 'your workspace';
+    let wsId;
+    try {
+        const workspace = await kernelCall('resolveWorkspace', {});
+        if (workspace?.name) {
+            console.log(`Connected to workspace: ${workspace.name}`);
+            wsName = workspace.name;
+            wsId = workspace._id;
+        }
+        trackEvent('workspace_bound');
+    }
+    catch {
+        console.log('Could not reach workspace. Try: pb orient -b');
+        return;
+    }
+    await ensureSessionAndOnboard(wsName, wsId);
+}
+/** Ensure a session exists, then run the onboarding conversation. */
+async function ensureSessionAndOnboard(workspaceName, workspaceId) {
+    let session = readSession();
+    if (!session) {
+        try {
+            const resolvedWs = workspaceId
+                ? { _id: workspaceId, keyId: null }
+                : await kernelCall('resolveWorkspace', {});
+            if (!resolvedWs)
+                return;
+            const result = await kernelCall('agent.startSession', {
+                workspaceId: resolvedWs._id,
+                apiKeyId: resolvedWs.keyId,
+                clientKind: 'cli',
+            });
+            session = {
+                sessionId: result.sessionId,
+                workspaceId: resolvedWs._id,
+                workspaceName: workspaceName,
+                startedAt: new Date().toISOString(),
+                entriesCaptured: [],
+            };
+            writeSession(session);
+        }
+        catch {
+            // Session start failed — onboarding can still work for reads
+        }
+    }
+    // Initialize telemetry with workspace context
+    if (session?.workspaceId) {
+        initTelemetry(session.workspaceId);
+    }
+    else if (workspaceId) {
+        initTelemetry(workspaceId);
+    }
+    process.stdout.write(`\n  Setup complete. Run ${bold('pb session start')} to begin a session.\n\n`);
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,17 @@
+/**
+ * pb update <entry-id> — update fields on existing Chain entries.
+ * Resolves TEN-703. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * Thin client: validation lives in Convex (BR-104).
+ */
+interface UpdateOptions {
+    entryId: string;
+    field?: string[];
+    name?: string;
+    status?: string;
+    workflowStatus?: string;
+    note?: string;
+}
+export declare function runUpdate(options: UpdateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAyCD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJrE"}

package/dist/commands/update.js

@@ -0,0 +1,178 @@
+/**
+ * pb update <entry-id> — update fields on existing Chain entries.
+ * Resolves TEN-703. Requires active session (DEC-9, BR-8).
+ * BET-181 Slice 0: uses isJsonMode() for output branching.
+ * Thin client: validation lives in Convex (BR-104).
+ */
+import { getConfigOrGuide } from '../lib/config.js';
+import { kernelCall, kernelCallWithSession } from '../lib/client.js';
+import { readSession } from '../lib/session.js';
+import { isJsonMode } from '../lib/runner.js';
+import { stripConvexInternals } from '../lib/strip.js';
+import { formatUpdateReceipt } from '../formatters/update.js';
+import { formatEntry } from '../formatters/entry.js';
+import { CLIError, ErrorCode } from '../lib/errors.js';
+/**
+ * Parse --field key=value pairs into a data object.
+ * Splits on first `=` only to handle values containing `=`.
+ */
+function parseFields(fields) {
+    const data = {};
+    for (const f of fields) {
+        const eqIndex = f.indexOf('=');
+        if (eqIndex === -1) {
+            throw new CLIError(`Invalid --field format: "${f}". Expected key=value.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Use --field key=value (split on first "=").',
+            });
+        }
+        const key = f.slice(0, eqIndex).trim();
+        const value = f.slice(eqIndex + 1).trim();
+        if (!key) {
+            throw new CLIError(`Invalid --field format: "${f}". Key cannot be empty.`, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+                guidance: 'Provide a non-empty key before the "=" sign.',
+            });
+        }
+        data[key] = value;
+    }
+    return data;
+}
+export async function runUpdate(options) {
+    const config = await getConfigOrGuide(() => runUpdate(options));
+    if (!config)
+        return;
+    const json = isJsonMode();
+    // Require active session (DEC-9, BR-8)
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` first. Write access requires a tracked session (DEC-9).',
+        });
+    }
+    // Validate entryId
+    const entryId = options.entryId.trim();
+    if (!entryId) {
+        throw new CLIError('Entry ID is required.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Usage: pb update <entry-id> [options]',
+        });
+    }
+    // Build update args
+    const args = { entryId };
+    args.changedBy = `agent:${session.sessionId}`;
+    if (options.name) {
+        args.name = options.name;
+    }
+    if (options.status) {
+        args.status = options.status;
+    }
+    if (options.workflowStatus) {
+        args.workflowStatus = options.workflowStatus;
+    }
+    if (options.field && options.field.length > 0) {
+        args.data = parseFields(options.field);
+    }
+    if (options.note) {
+        args.changeNote = options.note;
+    }
+    // Must have at least one thing to update
+    if (!options.name && !options.status && !options.workflowStatus && (!options.field || options.field.length === 0)) {
+        throw new CLIError('Nothing to update.', {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: 'Provide at least one of: --field, --name, --status, --workflow-status',
+        });
+    }
+    if (!json)
+        process.stdout.write(`Updating ${entryId}...\n`);
+    let result;
+    try {
+        result = await kernelCallWithSession('chain.updateEntry', args);
+    }
+    catch (err) {
+        // McpError carries code + details from the server. Check by name to avoid
+        // class identity issues across module boundaries.
+        const mcpErr = err;
+        if (err instanceof Error && err.name === 'McpError') {
+            // Render structured validation errors for select/multi-select fields.
+            if (mcpErr.details && mcpErr.details.length > 0) {
+                const selectErrors = mcpErr.details.filter((d) => d.errorType === 'invalid_option' && d.validOptions);
+                if (selectErrors.length > 0) {
+                    const fieldMessages = selectErrors.map((d) => {
+                        const got = typeof d.invalidValue === 'string' ? d.invalidValue : JSON.stringify(d.invalidValue);
+                        return `Field '${d.fieldLabel}' must be one of: ${d.validOptions.join(', ')}. Got: '${got}'`;
+                    });
+                    throw new CLIError(`Validation failed: ${fieldMessages.join('; ')}`, {
+                        code: ErrorCode.VALIDATION_FAILED,
+                        category: 'validation',
+                    });
+                }
+            }
+            // Fallback: plain MCP error
+            throw new CLIError(mcpErr.message, {
+                code: ErrorCode.VALIDATION_FAILED,
+                category: 'validation',
+            });
+        }
+        throw err;
+    }
+    // Fetch the refreshed entry so the user sees current state, not just a receipt.
+    // Graceful degradation: if the get fails, still show the update receipt.
+    let refreshedEntry = null;
+    try {
+        refreshedEntry = await kernelCall('chain.getEntry', { entryId });
+    }
+    catch {
+        // Non-fatal — display issue, not a write failure
+    }
+    // BET-271 S1: Determine if any fields were rejected by normalization.
+    const rejectedFields = result.normalization?.rejected ?? [];
+    const hasRejected = rejectedFields.length > 0;
+    // Note: EntryFromApi has canonicalKey (e.g. "bet") but pb fields expects
+    // the collection slug (e.g. "bets"). Since the slug isn't available here,
+    // omit the collection hint — the user knows their entry type.
+    const collectionHint = '';
+    if (json) {
+        // Spread existing result fields flat (preserves backward compat with scripts
+        // that read .id / .warnings / etc.) and add `entry` alongside when available.
+        const output = { ...stripConvexInternals(result) };
+        if (refreshedEntry) {
+            output.entry = stripConvexInternals(refreshedEntry);
+        }
+        if (hasRejected) {
+            output.fieldsRejected = true;
+        }
+        process.stdout.write(JSON.stringify(output) + '\n');
+    }
+    else {
+        process.stdout.write('\n');
+        process.stdout.write(formatUpdateReceipt({
+            entryId,
+            changeNote: options.note,
+            fieldsChanged: options.field ?? [],
+            name: options.name,
+            status: options.status,
+            normalizationWarnings: result.normalizationWarnings ?? [],
+            validationWarnings: result.validationWarnings ?? [],
+        }) + '\n');
+        if (refreshedEntry) {
+            process.stdout.write('\n');
+            process.stdout.write(formatEntry(refreshedEntry) + '\n');
+        }
+    }
+    // BET-271 S1: Throw when fields were rejected — signals "not everything you asked for happened."
+    if (hasRejected) {
+        throw new CLIError(`Fields rejected: ${rejectedFields.join(', ')}.`, {
+            code: ErrorCode.VALIDATION_FAILED,
+            category: 'validation',
+            guidance: `Run \`pb fields${collectionHint}\` to see valid fields.`,
+        });
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/commands/usage.d.ts

@@ -0,0 +1,40 @@
+/**
+ * pb usage — Ink TUI dashboard for session and activity data (WP-322 S4, E2/FEAT-1011).
+ *
+ * Tabs:
+ *   Overview  — summary stats (total sessions, entries 30d, avg duration, last session)
+ *   Activity  — table: Date | Sessions | Entries | Relations | Gate Failures (30d)
+ *   Spend     — static placeholder (v1)
+ *   Insights  — text-based activity heatmap (30d)
+ *
+ * JSON mode (--json): fetches data and emits structured JSON to stdout, no Ink.
+ * Non-TTY fallback: plain-text summary.
+ *
+ * Keyboard:
+ *   Tab / Shift+Tab  — cycle tabs
+ *   q / Escape       — quit
+ *
+ * Chain: WP-322, DEC-572 (envelope SSOT, supersedes DEC-299), DEC-184 (clientKind)
+ */
+/** Mirrors agent.getActivityByDay response shape (added in S3). */
+export type ActivityDay = {
+    date: string;
+    sessionCount: number;
+    entriesCreated: number;
+    relationsCreated: number;
+    gateFailures: number;
+};
+type UsageData = {
+    activity: ActivityDay[];
+    workspaceId: string;
+};
+export type UsageDashboardProps = {
+    data: UsageData;
+    onExit: () => void;
+};
+export declare function UsageDashboard({ data, onExit }: UsageDashboardProps): import("react/jsx-runtime").JSX.Element;
+export declare function runUsage(options?: {
+    json?: boolean;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/commands/usage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AA8RF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,mBAAmB,2CAqCnE;AAkDD,wBAAsB,QAAQ,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC9E"}