opencode-irf 0.0.1 → 0.0.3

package/dist/irf.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from '@opencode-ai/plugin';
+declare const plugin: Plugin;
+export default plugin;
+//# sourceMappingURL=irf.d.ts.map

package/dist/irf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"irf.d.ts","sourceRoot":"","sources":["../irf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAsDjD,QAAA,MAAM,MAAM,EAAE,MAkGb,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/irf.js

@@ -0,0 +1,131 @@
+import { tool } from '@opencode-ai/plugin';
+import { discover, readFilePaths } from './src/discover';
+import { processFile } from './src/process';
+import { isFormatMode } from './src/prompt';
+import { detectModel, promptWithRetry } from './src/session';
+import { buildTable } from './src/utils/compare';
+import { safeAsync } from './src/utils/safe';
+// resolve instruction files from explicit paths or opencode.json discovery
+const resolveFiles = async (directory, filesArg) => {
+    if (filesArg) {
+        const paths = filesArg.split(',').map((p) => p.trim()).filter((p) => p.length > 0);
+        if (paths.length === 0) {
+            return { data: null, error: 'No valid file paths provided' };
+        }
+        return { data: await readFilePaths(directory, paths), error: null };
+    }
+    return await discover(directory);
+};
+const ERROR_LABELS = {
+    readError: 'Read failed',
+    parseError: 'Parse failed',
+    formatError: 'Format failed',
+    writeError: 'Write failed',
+};
+// format a file result into a markdown status line
+const formatFileResult = (result) => {
+    if (result.status === 'success') {
+        return '**' + result.path + '**: ' + result.rulesCount + ' rules written';
+    }
+    return '**' + result.path + '**: ' + ERROR_LABELS[result.status] + ' - ' + result.error;
+};
+// append comparison table section to output lines
+const appendComparisonTable = (lines, comparisons) => {
+    if (comparisons.length === 0) {
+        return;
+    }
+    lines.push('');
+    lines.push('## Comparison');
+    lines.push('```');
+    lines.push(buildTable(comparisons));
+    lines.push('```');
+    lines.push('');
+    lines.push('IMPORTANT: Show the comparison table above to the user exactly as-is.');
+};
+// deno-lint-ignore require-await
+const plugin = async ({ directory, client }) => {
+    return {
+        tool: {
+            'irf-rewrite': tool({
+                description: [
+                    'Discover instruction files from opencode.json, parse them into structured rules, format them into human-readable rules, and write the formatted rules back to the original files.',
+                    'Accepts an optional mode: verbose (full Rule/Reason pairs), balanced (LLM decides which rules need reasons), or concise (bullet list, no reasons).',
+                    'Defaults to balanced.',
+                    'Accepts an optional files parameter to process specific files instead of running discovery.',
+                ].join(' '),
+                args: {
+                    mode: tool.schema.string().optional().describe('Output format: verbose, balanced, or concise (default: balanced)'),
+                    files: tool.schema.string().optional().describe('Comma-separated file paths to process instead of discovering from opencode.json'),
+                },
+                async execute(args, context) {
+                    // validate mode argument
+                    const mode = isFormatMode(args.mode) ? args.mode : 'balanced';
+                    try {
+                        // resolve files: explicit paths or discovery
+                        const resolved = await resolveFiles(directory, args.files);
+                        if (resolved.error !== null) {
+                            return resolved.error;
+                        }
+                        const files = resolved.data;
+                        // detect model from current session
+                        const model = await detectModel(client, context.sessionID);
+                        if (!model) {
+                            return 'Could not detect current model. Send a message first, then call irf-rewrite.';
+                        }
+                        // create a session for internal LLM calls
+                        const sessionResult = await client.session.create({
+                            body: {
+                                title: 'IRF Parse',
+                            },
+                        });
+                        if (!sessionResult.data) {
+                            return 'Failed to create internal session';
+                        }
+                        const sessionId = sessionResult.data.id;
+                        // close over session details so processFile only needs a prompt callback
+                        const prompt = (text, schema) => promptWithRetry({
+                            client,
+                            sessionId,
+                            initialPrompt: text,
+                            schema,
+                            model,
+                        });
+                        // process files sequentially; parallel prompting through a shared
+                        // session may cause ordering issues depending on SDK behavior
+                        const results = [];
+                        const comparisons = [];
+                        for (const file of files) {
+                            // bail if the tool call was cancelled
+                            if (context.abort.aborted) {
+                                results.push('Cancelled');
+                                break;
+                            }
+                            const fileResult = await processFile({
+                                file,
+                                prompt,
+                                mode,
+                            });
+                            if (fileResult.status === 'success') {
+                                comparisons.push(fileResult.comparison);
+                            }
+                            results.push(formatFileResult(fileResult));
+                        }
+                        // clean up the internal session
+                        await safeAsync(() => client.session.delete({
+                            path: { id: sessionId },
+                        }));
+                        // build comparison table
+                        appendComparisonTable(results, comparisons);
+                        return results.join('\n');
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        return 'irf-rewrite error: ' + msg;
+                    }
+                },
+            }),
+        },
+    };
+};
+export default plugin;
+//# sourceMappingURL=irf.js.map

package/dist/irf.js.map

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

package/dist/src/discover.d.ts

@@ -0,0 +1,11 @@
+import { type Result } from './utils/safe';
+export type InstructionFile = {
+    path: string;
+    content: string;
+    error?: string;
+};
+type DiscoverResult = Result<InstructionFile[]>;
+export declare const readFilePaths: (directory: string, paths: string[]) => Promise<InstructionFile[]>;
+export declare const discover: (directory: string) => Promise<DiscoverResult>;
+export {};
+//# sourceMappingURL=discover.d.ts.map

package/dist/src/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../../src/discover.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,cAAc,CAAA;AAE3D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,KAAK,cAAc,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,CAAA;AA4E/C,eAAO,MAAM,aAAa,GAAU,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE,KAAG,OAAO,CAAC,eAAe,EAAE,CAGjG,CAAA;AAED,eAAO,MAAM,QAAQ,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,cAAc,CAwBxE,CAAA"}

package/dist/src/discover.js

@@ -0,0 +1,92 @@
+import { glob, readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { safe, safeAsync } from './utils/safe';
+const readConfig = async (directory) => {
+    const configPath = join(directory, 'opencode.json');
+    const { data, error } = await safeAsync(() => readFile(configPath, 'utf-8'));
+    if (error) {
+        return {
+            data: null,
+            error: 'Could not read ' + configPath + ': ' + error.message,
+        };
+    }
+    const { data: parsed, error: parseError } = safe(() => JSON.parse(data));
+    if (parseError) {
+        return {
+            data: null,
+            error: 'Invalid JSON in ' + configPath + ': ' + parseError.message,
+        };
+    }
+    const instructions = parsed.instructions;
+    if (!instructions || !Array.isArray(instructions) || instructions.length === 0) {
+        return {
+            data: null,
+            error: 'No "instructions" array found in ' + configPath,
+        };
+    }
+    const patterns = instructions.filter((entry) => typeof entry === 'string');
+    if (patterns.length === 0) {
+        return {
+            data: null,
+            error: 'No valid string patterns in "instructions" in ' + configPath,
+        };
+    }
+    return {
+        data: patterns,
+        error: null,
+    };
+};
+const resolveFiles = async (directory, patterns) => {
+    const seen = new Set();
+    const files = [];
+    for (const pattern of patterns) {
+        for await (const path of glob(pattern, { cwd: directory })) {
+            const full = join(directory, path);
+            if (!seen.has(full)) {
+                seen.add(full);
+                files.push(full);
+            }
+        }
+    }
+    return files;
+};
+const readFiles = async (files) => {
+    const results = [];
+    for (const file of files) {
+        const { data, error } = await safeAsync(() => readFile(file, 'utf-8'));
+        if (error) {
+            results.push({ path: file, content: '', error: error.message });
+            continue;
+        }
+        results.push({ path: file, content: data });
+    }
+    return results;
+};
+// read specific file paths into InstructionFile entries, resolving relative paths against directory
+export const readFilePaths = async (directory, paths) => {
+    const resolved = paths.map((p) => resolve(directory, p));
+    return await readFiles(resolved);
+};
+export const discover = async (directory) => {
+    const config = await readConfig(directory);
+    if (config.error !== null) {
+        return {
+            data: null,
+            error: config.error,
+        };
+    }
+    const patterns = config.data;
+    const files = await resolveFiles(directory, patterns);
+    if (files.length === 0) {
+        return {
+            data: null,
+            error: 'No instruction files found matching patterns: ' + patterns.join(', '),
+        };
+    }
+    const results = await readFiles(files);
+    return {
+        data: results,
+        error: null,
+    };
+};
+//# sourceMappingURL=discover.js.map

package/dist/src/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAe,IAAI,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAW3D,MAAM,UAAU,GAAG,KAAK,EAAE,SAAiB,EAAyB,EAAE;IACpE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAA;IACnD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5E,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,iBAAiB,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO;SAC7D,CAAA;IACH,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IACxE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,kBAAkB,GAAG,UAAU,GAAG,IAAI,GAAG,UAAU,CAAC,OAAO;SACnE,CAAA;IACH,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAA;IACxC,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/E,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,mCAAmC,GAAG,UAAU;SACxD,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAA;IACnF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,gDAAgD,GAAG,UAAU;SACrE,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,KAAK,EAAE,SAAiB,EAAE,QAAkB,EAAE,EAAE;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,KAAK,EAAE,KAAe,EAAE,EAAE;IAC1C,MAAM,OAAO,GAAsB,EAAE,CAAA;IAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;QACtE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAC/D,SAAQ;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,oGAAoG;AACpG,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,SAAiB,EAAE,KAAe,EAA8B,EAAE;IACpG,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;IACxD,OAAO,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;AAClC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,SAAiB,EAA2B,EAAE;IAC3E,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAA;IAC1C,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAA;IAC5B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,gDAAgD,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;SAC9E,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,CAAA;IAEtC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,IAAI;KACZ,CAAA;AACH,CAAC,CAAA"}

package/dist/src/process.d.ts

@@ -0,0 +1,26 @@
+import type { z } from 'zod';
+import type { InstructionFile } from './discover';
+import { type FormatMode } from './prompt';
+import { type ComparisonResult } from './utils/compare';
+import type { Result } from './utils/safe';
+type FileResultSuccess = {
+    status: 'success';
+    path: string;
+    rulesCount: number;
+    comparison: ComparisonResult;
+};
+type FileResultError = {
+    status: 'readError' | 'parseError' | 'formatError' | 'writeError';
+    path: string;
+    error: string;
+};
+export type FileResult = FileResultSuccess | FileResultError;
+export type PromptFn = <T>(prompt: string, schema: z.ZodType<T>) => Promise<Result<T>>;
+type ProcessFileOptions = {
+    file: InstructionFile;
+    prompt: PromptFn;
+    mode?: FormatMode;
+};
+export declare const processFile: (options: ProcessFileOptions) => Promise<FileResult>;
+export {};
+//# sourceMappingURL=process.d.ts.map

package/dist/src/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/process.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,UAAU,CAAA;AAE/E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAG1C,KAAK,iBAAiB,GAAG;IACvB,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,gBAAgB,CAAA;CAC7B,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,MAAM,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAA;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,eAAe,CAAA;AAG5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtF,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,eAAe,CAAA;IACrB,MAAM,EAAE,QAAQ,CAAA;IAChB,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB,CAAA;AAGD,eAAO,MAAM,WAAW,GAAU,SAAS,kBAAkB,KAAG,OAAO,CAAC,UAAU,CAsDjF,CAAA"}

package/dist/src/process.js

@@ -0,0 +1,56 @@
+import { writeFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { buildFormatPrompt, buildParsePrompt } from './prompt';
+import { FormatResponseSchema, ParseResponseSchema } from './schema';
+import { compareBytes } from './utils/compare';
+import { safeAsync } from './utils/safe';
+// process a single instruction file through the parse -> format -> write pipeline
+export const processFile = async (options) => {
+    const { file, prompt, mode = 'balanced' } = options;
+    // skip files that failed to read
+    if (file.error) {
+        return {
+            status: 'readError',
+            path: file.path,
+            error: file.error,
+        };
+    }
+    // step 1: parse instruction text -> structured rules
+    const parseResult = await prompt(buildParsePrompt(file.content), ParseResponseSchema);
+    if (parseResult.error !== null) {
+        return {
+            status: 'parseError',
+            path: file.path,
+            error: String(parseResult.error),
+        };
+    }
+    // step 2: format structured rules -> human-readable rules
+    const formatResult = await prompt(buildFormatPrompt(JSON.stringify(parseResult.data), mode), FormatResponseSchema);
+    if (formatResult.error !== null) {
+        return {
+            status: 'formatError',
+            path: file.path,
+            error: String(formatResult.error),
+        };
+    }
+    // step 3: write formatted rules back to original file
+    const formattedRules = formatResult.data.rules;
+    const joiner = mode === 'concise' ? '\n' : '\n\n';
+    const content = formattedRules.join(joiner) + '\n';
+    const { error: writeError } = await safeAsync(() => writeFile(file.path, content, 'utf-8'));
+    if (writeError) {
+        return {
+            status: 'writeError',
+            path: file.path,
+            error: writeError.message,
+        };
+    }
+    const comparison = compareBytes(basename(file.path), file.content, content);
+    return {
+        status: 'success',
+        path: file.path,
+        rulesCount: formattedRules.length,
+        comparison,
+    };
+};
+//# sourceMappingURL=process.js.map

package/dist/src/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAmB,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACpE,OAAO,EAAE,YAAY,EAAyB,MAAM,iBAAiB,CAAA;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AA0BxC,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,OAA2B,EAAuB,EAAE;IACpF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,UAAU,EAAE,GAAG,OAAO,CAAA;IAEnD,iCAAiC;IACjC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAA;IACH,CAAC;IAED,qDAAqD;IACrD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAA;IAErF,IAAI,WAAW,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;SACjC,CAAA;IACH,CAAC;IAED,0DAA0D;IAC1D,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,oBAAoB,CAAC,CAAA;IAElH,IAAI,YAAY,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC;SAClC,CAAA;IACH,CAAC;IAED,sDAAsD;IACtD,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAA;IAC9C,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACjD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAA;IAClD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3F,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,MAAM,EAAE,YAAY;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,UAAU,CAAC,OAAO;SAC1B,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC3E,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,cAAc,CAAC,MAAM;QACjC,UAAU;KACX,CAAA;AACH,CAAC,CAAA"}

package/dist/src/prompt.d.ts

@@ -0,0 +1,7 @@
+export type FormatMode = 'verbose' | 'balanced' | 'concise';
+export declare const FORMAT_MODES: FormatMode[];
+export declare const isFormatMode: (v: unknown) => v is FormatMode;
+export declare const buildParsePrompt: (input: string) => string;
+export declare const buildFormatPrompt: (parsedRulesJson: string, mode?: FormatMode) => string;
+export declare const buildRetryPrompt: (errorMessage: string) => string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,eAAO,MAAM,YAAY,EAAE,UAAU,EAAuC,CAAA;AAE5E,eAAO,MAAM,YAAY,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,UACkB,CAAA;AAEjE,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,KAAG,MAchD,CAAA;AAgED,eAAO,MAAM,iBAAiB,GAAI,iBAAiB,MAAM,EAAE,OAAM,UAAuB,KAAG,MAG1F,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,cAAc,MAAM,KAAG,MAGvD,CAAA"}

package/dist/src/prompt.js

@@ -0,0 +1,84 @@
+import { parseSchemaExample } from './schema';
+export const FORMAT_MODES = ['verbose', 'balanced', 'concise'];
+export const isFormatMode = (v) => typeof v === 'string' && FORMAT_MODES.includes(v);
+export const buildParsePrompt = (input) => {
+    const instructions = [
+        'You are a rule parser that converts raw instructions into structured parsed rules.',
+        'Take the provided instructions and break them down into structured components.',
+        'Each rule should have: strength, action (verb), target (object), context (optional condition/scope), and reason (justification).',
+        'Focus on extracting the core components without adding extra details.',
+        '',
+        'Return ONLY valid JSON matching this exact schema:',
+        parseSchemaExample,
+        '',
+        'Do not include any text outside the JSON object. Do not wrap it in markdown code fences.',
+    ].join('\n');
+    return [instructions, 'Instructions to parse:', input].join('\n\n');
+};
+const verboseInstructions = [
+    'You are a rule formatter that converts structured parsed rules into human-readable rules.',
+    'Take the provided parsed rule components and create natural language versions.',
+    'Every rule must include both a Rule line and a Reason line.',
+    'Each rule must follow this exact format:',
+    '',
+    'Rule: <clear, concise, actionable statement>',
+    'Reason: <justification from the parsed rule>',
+    '',
+    'Each human-readable rule should directly correspond to the parsed components without adding extra details.',
+    'Make the rules clear, concise, and actionable.',
+    '',
+    'Return ONLY valid JSON matching this exact schema:',
+    '{"rules": ["Rule: ...\\nReason: ...", "Rule: ...\\nReason: ..."]}',
+    '',
+    'Do not include any text outside the JSON object. Do not wrap it in markdown code fences.',
+];
+const balancedInstructions = [
+    'You are a rule formatter that converts structured parsed rules into human-readable rules.',
+    'Take the provided parsed rule components and create natural language versions.',
+    'Use your judgment for each rule:',
+    '- If the rule is non-obvious or counterintuitive, include both the Rule and Reason lines.',
+    '- If the rule is self-explanatory, include only the Rule line and omit the Reason.',
+    '',
+    'Format rules that include a reason:',
+    'Rule: <clear, concise, actionable statement>',
+    'Reason: <justification from the parsed rule>',
+    '',
+    'Format rules that are self-explanatory:',
+    'Rule: <clear, concise, actionable statement>',
+    '',
+    'Each human-readable rule should directly correspond to the parsed components without adding extra details.',
+    'Make the rules clear, concise, and actionable.',
+    '',
+    'Return ONLY valid JSON matching this exact schema:',
+    '{"rules": ["Rule: ...\\nReason: ...", "Rule: ..."]}',
+    '',
+    'Do not include any text outside the JSON object. Do not wrap it in markdown code fences.',
+];
+const conciseInstructions = [
+    'You are a rule formatter that converts structured parsed rules into concise directives.',
+    'Take the provided parsed rule components and create a bullet list of clear directives.',
+    'Do not include reasons or justifications. Output only the actionable statement.',
+    'Each rule must be a single line starting with "- " (dash space).',
+    '',
+    'Each directive should directly correspond to the parsed components without adding extra details.',
+    'Make the directives clear, concise, and actionable.',
+    '',
+    'Return ONLY valid JSON matching this exact schema:',
+    '{"rules": ["- ...", "- ..."]}',
+    '',
+    'Do not include any text outside the JSON object. Do not wrap it in markdown code fences.',
+];
+const formatInstructions = {
+    verbose: verboseInstructions,
+    balanced: balancedInstructions,
+    concise: conciseInstructions,
+};
+export const buildFormatPrompt = (parsedRulesJson, mode = 'balanced') => {
+    const instructions = formatInstructions[mode].join('\n');
+    return [instructions, 'Parsed rules to convert:', parsedRulesJson].join('\n\n');
+};
+export const buildRetryPrompt = (errorMessage) => {
+    return 'Your previous response was invalid. ' + errorMessage
+        + '\n\nReturn ONLY valid JSON. Do not include any text outside the JSON object.';
+};
+//# sourceMappingURL=prompt.js.map

package/dist/src/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAI7C,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;AAE5E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAU,EAAmB,EAAE,CAC1D,OAAO,CAAC,KAAK,QAAQ,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAe,CAAC,CAAA;AAEjE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE;IACxD,MAAM,YAAY,GAAG;QACnB,oFAAoF;QACpF,gFAAgF;QAChF,kIAAkI;QAClI,uEAAuE;QACvE,EAAE;QACF,oDAAoD;QACpD,kBAAkB;QAClB,EAAE;QACF,0FAA0F;KAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,OAAO,CAAC,YAAY,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AACrE,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG;IAC1B,2FAA2F;IAC3F,gFAAgF;IAChF,6DAA6D;IAC7D,0CAA0C;IAC1C,EAAE;IACF,8CAA8C;IAC9C,8CAA8C;IAC9C,EAAE;IACF,4GAA4G;IAC5G,gDAAgD;IAChD,EAAE;IACF,oDAAoD;IACpD,mEAAmE;IACnE,EAAE;IACF,0FAA0F;CAC3F,CAAA;AAED,MAAM,oBAAoB,GAAG;IAC3B,2FAA2F;IAC3F,gFAAgF;IAChF,kCAAkC;IAClC,2FAA2F;IAC3F,oFAAoF;IACpF,EAAE;IACF,qCAAqC;IACrC,8CAA8C;IAC9C,8CAA8C;IAC9C,EAAE;IACF,yCAAyC;IACzC,8CAA8C;IAC9C,EAAE;IACF,4GAA4G;IAC5G,gDAAgD;IAChD,EAAE;IACF,oDAAoD;IACpD,qDAAqD;IACrD,EAAE;IACF,0FAA0F;CAC3F,CAAA;AAED,MAAM,mBAAmB,GAAG;IAC1B,yFAAyF;IACzF,wFAAwF;IACxF,iFAAiF;IACjF,kEAAkE;IAClE,EAAE;IACF,kGAAkG;IAClG,qDAAqD;IACrD,EAAE;IACF,oDAAoD;IACpD,+BAA+B;IAC/B,EAAE;IACF,0FAA0F;CAC3F,CAAA;AAED,MAAM,kBAAkB,GAAiC;IACvD,OAAO,EAAE,mBAAmB;IAC5B,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,mBAAmB;CAC7B,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,eAAuB,EAAE,OAAmB,UAAU,EAAU,EAAE;IAClG,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxD,OAAO,CAAC,YAAY,EAAE,0BAA0B,EAAE,eAAe,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AACjF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,YAAoB,EAAU,EAAE;IAC/D,OAAO,sCAAsC,GAAG,YAAY;UACxD,8EAA8E,CAAA;AACpF,CAAC,CAAA"}

package/dist/src/schema.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+export declare const StrengthSchema: z.ZodEnum<{
+    obligatory: "obligatory";
+    permissible: "permissible";
+    forbidden: "forbidden";
+    optional: "optional";
+    supererogatory: "supererogatory";
+    indifferent: "indifferent";
+    omissible: "omissible";
+}>;
+export declare const ActionSchema: z.ZodString;
+export declare const TargetSchema: z.ZodString;
+export declare const ContextSchema: z.ZodString;
+export declare const ReasonSchema: z.ZodString;
+export declare const ParsedRuleSchema: z.ZodObject<{
+    strength: z.ZodEnum<{
+        obligatory: "obligatory";
+        permissible: "permissible";
+        forbidden: "forbidden";
+        optional: "optional";
+        supererogatory: "supererogatory";
+        indifferent: "indifferent";
+        omissible: "omissible";
+    }>;
+    action: z.ZodString;
+    target: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const RuleSchema: z.ZodString;
+export declare const ParsedSchema: z.ZodArray<z.ZodObject<{
+    strength: z.ZodEnum<{
+        obligatory: "obligatory";
+        permissible: "permissible";
+        forbidden: "forbidden";
+        optional: "optional";
+        supererogatory: "supererogatory";
+        indifferent: "indifferent";
+        omissible: "omissible";
+    }>;
+    action: z.ZodString;
+    target: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+}, z.core.$strip>>;
+export declare const ParseResponseSchema: z.ZodObject<{
+    rules: z.ZodArray<z.ZodObject<{
+        strength: z.ZodEnum<{
+            obligatory: "obligatory";
+            permissible: "permissible";
+            forbidden: "forbidden";
+            optional: "optional";
+            supererogatory: "supererogatory";
+            indifferent: "indifferent";
+            omissible: "omissible";
+        }>;
+        action: z.ZodString;
+        target: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const FormatResponseSchema: z.ZodObject<{
+    rules: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Strength = z.infer<typeof StrengthSchema>;
+export type ParsedRule = z.infer<typeof ParsedRuleSchema>;
+export declare const parseSchemaExample: string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,cAAc;;;;;;;;EASoC,CAAA;AAE/D,eAAO,MAAM,YAAY,aACmC,CAAA;AAE5D,eAAO,MAAM,YAAY,aAC6B,CAAA;AAEtD,eAAO,MAAM,aAAa,aAC4C,CAAA;AAEtE,eAAO,MAAM,YAAY,aAC2B,CAAA;AAEpD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;iBAOuC,CAAA;AAEpE,eAAO,MAAM,UAAU,aAC0C,CAAA;AAEjE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;kBACW,CAAA;AAEpC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAE9B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;iBAE/B,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AACrD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAGzD,eAAO,MAAM,kBAAkB,QAQ7B,CAAA"}

package/dist/src/schema.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+export const StrengthSchema = z.enum([
+    'obligatory',
+    'permissible',
+    'forbidden',
+    'optional',
+    'supererogatory',
+    'indifferent',
+    'omissible',
+])
+    .describe('Deontic modality expressing enforcement strength');
+export const ActionSchema = z.string()
+    .describe('Imperative verb describing the action to take');
+export const TargetSchema = z.string()
+    .describe('Object or subject the action applies to');
+export const ContextSchema = z.string()
+    .describe('Condition, scope, or circumstance when the rule applies');
+export const ReasonSchema = z.string()
+    .describe('Justification for why the rule exists');
+export const ParsedRuleSchema = z.object({
+    strength: StrengthSchema,
+    action: ActionSchema,
+    target: TargetSchema,
+    context: ContextSchema.optional(),
+    reason: ReasonSchema,
+})
+    .describe('Single instruction decomposed into deontic components');
+export const RuleSchema = z.string()
+    .describe('Human-readable rule derived from parsed components');
+export const ParsedSchema = z.array(ParsedRuleSchema)
+    .describe('Array of parsed rules');
+export const ParseResponseSchema = z.object({
+    rules: ParsedSchema,
+});
+export const FormatResponseSchema = z.object({
+    rules: z.array(RuleSchema),
+});
+// generate a JSON schema example string from the Zod schema for use in prompts
+export const parseSchemaExample = JSON.stringify({
+    rules: [{
+            strength: StrengthSchema.options.join('/'),
+            action: ActionSchema.description || 'verb',
+            target: TargetSchema.description || 'object',
+            context: ContextSchema.description || 'optional condition',
+            reason: ReasonSchema.description || 'justification',
+        }],
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,YAAY;IACZ,aAAa;IACb,WAAW;IACX,UAAU;IACV,gBAAgB;IAChB,aAAa;IACb,WAAW;CACZ,CAAC;KACC,QAAQ,CAAC,kDAAkD,CAAC,CAAA;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,QAAQ,CAAC,+CAA+C,CAAC,CAAA;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,QAAQ,CAAC,yCAAyC,CAAC,CAAA;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE;KACpC,QAAQ,CAAC,yDAAyD,CAAC,CAAA;AAEtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE;KACnC,QAAQ,CAAC,uCAAuC,CAAC,CAAA;AAEpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,YAAY;CACrB,CAAC;KACC,QAAQ,CAAC,uDAAuD,CAAC,CAAA;AAEpE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE;KACjC,QAAQ,CAAC,oDAAoD,CAAC,CAAA;AAEjE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;KAClD,QAAQ,CAAC,uBAAuB,CAAC,CAAA;AAEpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,KAAK,EAAE,YAAY;CACpB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;CAC3B,CAAC,CAAA;AAKF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC;IAC/C,KAAK,EAAE,CAAC;YACN,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YAC1C,MAAM,EAAE,YAAY,CAAC,WAAW,IAAI,MAAM;YAC1C,MAAM,EAAE,YAAY,CAAC,WAAW,IAAI,QAAQ;YAC5C,OAAO,EAAE,aAAa,CAAC,WAAW,IAAI,oBAAoB;YAC1D,MAAM,EAAE,YAAY,CAAC,WAAW,IAAI,eAAe;SACpD,CAAC;CACH,CAAC,CAAA"}

package/dist/src/session.d.ts

@@ -0,0 +1,23 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { z } from 'zod';
+import type { Result } from './utils/safe';
+export type PromptModel = {
+    providerID: string;
+    modelID: string;
+};
+type Part = {
+    type: string;
+    text?: string;
+};
+export declare const extractText: (parts: Part[]) => string;
+export declare const detectModel: (client: PluginInput["client"], sessionId: string) => Promise<PromptModel | null>;
+type PromptWithRetryOptions<T> = {
+    client: PluginInput['client'];
+    sessionId: string;
+    initialPrompt: string;
+    schema: z.ZodType<T>;
+    model: PromptModel;
+};
+export declare const promptWithRetry: <T>(options: PromptWithRetryOptions<T>) => Promise<Result<T>>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/src/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAG5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAM1C,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAGD,KAAK,IAAI,GAAG;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAgBD,eAAO,MAAM,WAAW,GAAI,OAAO,IAAI,EAAE,KAAG,MAM3C,CAAA;AAGD,eAAO,MAAM,WAAW,GAAU,QAAQ,WAAW,CAAC,QAAQ,CAAC,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAuB9G,CAAA;AAED,KAAK,sBAAsB,CAAC,CAAC,IAAI;IAC/B,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACpB,KAAK,EAAE,WAAW,CAAA;CACnB,CAAA;AAGD,eAAO,MAAM,eAAe,GAAU,CAAC,EAAE,SAAS,sBAAsB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CA0E9F,CAAA"}