sqlew 3.7.3 → 3.8.0

package/dist/tools/files/actions/record.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Record a file change with optional layer assignment and description
+ * Auto-registers the file and agent if they don't exist
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { RecordFileChangeParams, RecordFileChangeResponse } from '../types.js';
+/**
+ * Record a file change with optional layer assignment and description.
+ * Auto-registers the file and agent if they don't exist.
+ *
+ * @param params - File change parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Success response with change ID and timestamp
+ */
+export declare function recordFileChange(params: RecordFileChangeParams, adapter?: DatabaseAdapter): Promise<RecordFileChangeResponse>;
+//# sourceMappingURL=record.d.ts.map

package/dist/tools/files/actions/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/tools/files/actions/record.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAM7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEpF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,wBAAwB,CAAC,CAoBnC"}

package/dist/tools/files/actions/record.js

@@ -0,0 +1,37 @@
+/**
+ * Record a file change with optional layer assignment and description
+ * Auto-registers the file and agent if they don't exist
+ */
+import { getAdapter } from '../../../database.js';
+import { getProjectContext } from '../../../utils/project-context.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { validateActionParams } from '../internal/validation.js';
+import { recordFileChangeInternal } from '../internal/queries.js';
+/**
+ * Record a file change with optional layer assignment and description.
+ * Auto-registers the file and agent if they don't exist.
+ *
+ * @param params - File change parameters
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Success response with change ID and timestamp
+ */
+export async function recordFileChange(params, adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    try {
+        // Validate parameters
+        validateActionParams('file', 'record', params);
+        // Fail-fast: Validate project context is initialized (Constraint #29)
+        const projectId = getProjectContext().getProjectId();
+        // Use transaction for atomicity with connection retry
+        return await connectionManager.executeWithRetry(async () => {
+            return await actualAdapter.transaction(async (trx) => {
+                return await recordFileChangeInternal(params, actualAdapter, projectId, trx);
+            });
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to record file change: ${message}`);
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/tools/files/actions/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../../../src/tools/files/actions/record.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,iBAAiB,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAGlE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA8B,EAC9B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAE9C,IAAI,CAAC;QACH,sBAAsB;QACtB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE/C,sEAAsE;QACtE,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC,YAAY,EAAE,CAAC;QAErD,sDAAsD;QACtD,OAAO,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;YACzD,OAAO,MAAM,aAAa,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACnD,OAAO,MAAM,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;YAC/E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/tools/files/actions/sqlite-flush.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Forces SQLite WAL (Write-Ahead Log) checkpoint to flush pending transactions
+ * to the main database file. Essential for Git workflow to ensure .db file is
+ * up-to-date before committing to version control.
+ *
+ * SQLite WAL Mode:
+ * - Writes go to .db-wal file, not main .db file
+ * - Without flush, .db file is stale, .db-wal has latest data
+ * - Git commits should include up-to-date .db file for clean diffs
+ *
+ * Checkpoint Modes:
+ * - TRUNCATE: Most aggressive, blocks until complete, ensures ALL data flushed
+ * - This is the correct mode for Git workflow
+ *
+ * @returns FlushWALResponse with pages flushed count
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import type { FlushWALResponse } from '../../../types.js';
+/**
+ * Forces SQLite WAL checkpoint to flush pending transactions to main database file
+ * SQLite-specific operation - returns error for MySQL/PostgreSQL
+ *
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Checkpoint result with pages flushed
+ */
+export declare function sqliteFlush(adapter?: DatabaseAdapter): Promise<FlushWALResponse>;
+//# sourceMappingURL=sqlite-flush.d.ts.map

package/dist/tools/files/actions/sqlite-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-flush.d.ts","sourceRoot":"","sources":["../../../../src/tools/files/actions/sqlite-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA0C3B"}

package/dist/tools/files/actions/sqlite-flush.js

@@ -0,0 +1,66 @@
+/**
+ * Forces SQLite WAL (Write-Ahead Log) checkpoint to flush pending transactions
+ * to the main database file. Essential for Git workflow to ensure .db file is
+ * up-to-date before committing to version control.
+ *
+ * SQLite WAL Mode:
+ * - Writes go to .db-wal file, not main .db file
+ * - Without flush, .db file is stale, .db-wal has latest data
+ * - Git commits should include up-to-date .db file for clean diffs
+ *
+ * Checkpoint Modes:
+ * - TRUNCATE: Most aggressive, blocks until complete, ensures ALL data flushed
+ * - This is the correct mode for Git workflow
+ *
+ * @returns FlushWALResponse with pages flushed count
+ */
+import { getAdapter } from '../../../database.js';
+import connectionManager from '../../../utils/connection-manager.js';
+import { validateActionParams } from '../../../utils/parameter-validator.js';
+/**
+ * Forces SQLite WAL checkpoint to flush pending transactions to main database file
+ * SQLite-specific operation - returns error for MySQL/PostgreSQL
+ *
+ * @param adapter - Optional database adapter (for testing)
+ * @returns Checkpoint result with pages flushed
+ */
+export async function sqliteFlush(adapter) {
+    const actualAdapter = adapter ?? getAdapter();
+    const knex = actualAdapter.getKnex();
+    try {
+        // Validate parameters
+        validateActionParams('file', 'sqlite_flush', {});
+        // Check if using SQLite (WAL mode is SQLite-specific)
+        const client = knex.client.config.client;
+        if (!['better-sqlite3', 'sqlite3'].includes(client)) {
+            return {
+                success: false,
+                mode: 'TRUNCATE',
+                pages_flushed: 0,
+                message: `WAL checkpoint is SQLite-specific. Current database: ${client}`
+            };
+        }
+        return await connectionManager.executeWithRetry(async () => {
+            // Execute TRUNCATE checkpoint - most aggressive mode
+            // Blocks until complete, ensures all WAL data written to main DB file
+            // Returns array: [[busy, log, checkpointed]]
+            // - busy: number of frames not checkpointed due to locks
+            // - log: total number of frames in WAL file
+            // - checkpointed: number of frames checkpointed
+            const result = await knex.raw('PRAGMA wal_checkpoint(TRUNCATE)');
+            // Parse result array format from Knex
+            const pagesFlushed = result?.[0]?.[0]?.[2] || 0;
+            return {
+                success: true,
+                mode: 'TRUNCATE',
+                pages_flushed: pagesFlushed,
+                message: `WAL checkpoint completed successfully. ${pagesFlushed} pages flushed to main database file.`
+            };
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to flush WAL: ${message}`);
+    }
+}
+//# sourceMappingURL=sqlite-flush.js.map

package/dist/tools/files/actions/sqlite-flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-flush.js","sourceRoot":"","sources":["../../../../src/tools/files/actions/sqlite-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,iBAAiB,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAG7E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAyB;IAEzB,MAAM,aAAa,GAAG,OAAO,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,sBAAsB;QACtB,oBAAoB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;QAEjD,sDAAsD;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,UAAU;gBAChB,aAAa,EAAE,CAAC;gBAChB,OAAO,EAAE,wDAAwD,MAAM,EAAE;aAC1E,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,IAAI,EAAE;YACzD,qDAAqD;YACrD,sEAAsE;YACtE,6CAA6C;YAC7C,yDAAyD;YACzD,4CAA4C;YAC5C,gDAAgD;YAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iCAAiC,CAAQ,CAAC;YAExE,sCAAsC;YACtC,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,UAAU;gBAChB,aAAa,EAAE,YAAY;gBAC3B,OAAO,EAAE,0CAA0C,YAAY,uCAAuC;aACvG,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/tools/files/help/example.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Example action for file tool
+ */
+export declare function fileExample(): any;
+//# sourceMappingURL=example.d.ts.map

package/dist/tools/files/help/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../../../src/tools/files/help/example.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,WAAW,IAAI,GAAG,CA6FjC"}

package/dist/tools/files/help/example.js

@@ -0,0 +1,98 @@
+/**
+ * Example action for file tool
+ */
+export function fileExample() {
+    return {
+        tool: 'file',
+        description: 'Comprehensive file tracking examples for multi-agent coordination',
+        scenarios: {
+            basic_tracking: {
+                title: 'Basic File Change Tracking',
+                examples: [
+                    {
+                        scenario: 'Record file modification',
+                        request: '{ action: "record", file_path: "src/api/users.ts", agent_name: "refactor-agent", change_type: "modified", layer: "business", description: "Added email validation" }',
+                        explanation: 'Track changes with layer and description'
+                    },
+                    {
+                        scenario: 'Get recent changes by agent',
+                        request: '{ action: "get", agent_name: "refactor-agent", limit: 10 }',
+                        explanation: 'View what an agent has been working on'
+                    },
+                    {
+                        scenario: 'Track changes to specific file',
+                        request: '{ action: "get", file_path: "src/api/users.ts" }',
+                        explanation: 'See all modifications to a particular file'
+                    }
+                ]
+            },
+            file_locking: {
+                title: 'Concurrent Access Prevention',
+                workflow: [
+                    {
+                        step: 1,
+                        action: 'Check if file is locked',
+                        request: '{ action: "check_lock", file_path: "src/database/schema.sql", lock_duration: 300 }',
+                        result: '{ locked: false } or { locked: true, locked_by: "agent-name", locked_at: "timestamp" }'
+                    },
+                    {
+                        step: 2,
+                        action: 'If not locked, record change (creates lock)',
+                        request: '{ action: "record", file_path: "src/database/schema.sql", agent_name: "migration-agent", change_type: "modified" }'
+                    },
+                    {
+                        step: 3,
+                        action: 'Lock expires after 5 minutes (default) or specified duration'
+                    }
+                ]
+            },
+            layer_organization: {
+                title: 'Tracking by Architecture Layer',
+                examples: [
+                    {
+                        scenario: 'Get all presentation layer changes',
+                        request: '{ action: "get", layer: "presentation", limit: 20 }',
+                        explanation: 'View frontend/UI changes across agents'
+                    },
+                    {
+                        scenario: 'Track infrastructure changes',
+                        request: '{ action: "get", layer: "infrastructure", change_type: "modified" }',
+                        explanation: 'Monitor config and deployment file changes'
+                    }
+                ]
+            },
+            batch_tracking: {
+                title: 'Batch File Operations',
+                examples: [
+                    {
+                        scenario: 'Record multiple file changes atomically',
+                        request: '{ action: "record_batch", file_changes: [{"file_path": "src/api.ts", "agent_name": "bot1", "change_type": "modified", "layer": "presentation"}, {"file_path": "src/types.ts", "agent_name": "bot1", "change_type": "modified", "layer": "data"}], atomic: true }',
+                        explanation: 'All changes recorded or none (transaction)'
+                    }
+                ]
+            }
+        },
+        best_practices: {
+            change_tracking: [
+                'Always specify layer for better organization',
+                'Include description for non-obvious changes',
+                'Use check_lock before modifying shared files',
+                'Track both creation and deletion of files'
+            ],
+            lock_management: [
+                'Default lock duration is 300 seconds (5 minutes)',
+                'Locks prevent concurrent modifications',
+                'Locks auto-expire - no manual unlock needed',
+                'Use appropriate lock_duration for operation complexity'
+            ],
+            layer_assignment: [
+                'presentation: UI components, API controllers',
+                'business: Services, domain logic',
+                'data: Models, repositories, migrations',
+                'infrastructure: Config, deployment, CI/CD',
+                'cross-cutting: Utilities used across layers'
+            ]
+        }
+    };
+}
+//# sourceMappingURL=example.js.map

package/dist/tools/files/help/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../../../src/tools/files/help/example.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mEAAmE;QAChF,SAAS,EAAE;YACT,cAAc,EAAE;gBACd,KAAK,EAAE,4BAA4B;gBACnC,QAAQ,EAAE;oBACR;wBACE,QAAQ,EAAE,0BAA0B;wBACpC,OAAO,EAAE,sKAAsK;wBAC/K,WAAW,EAAE,0CAA0C;qBACxD;oBACD;wBACE,QAAQ,EAAE,6BAA6B;wBACvC,OAAO,EAAE,4DAA4D;wBACrE,WAAW,EAAE,wCAAwC;qBACtD;oBACD;wBACE,QAAQ,EAAE,gCAAgC;wBAC1C,OAAO,EAAE,kDAAkD;wBAC3D,WAAW,EAAE,4CAA4C;qBAC1D;iBACF;aACF;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE,8BAA8B;gBACrC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,yBAAyB;wBACjC,OAAO,EAAE,oFAAoF;wBAC7F,MAAM,EAAE,wFAAwF;qBACjG;oBACD;wBACE,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,6CAA6C;wBACrD,OAAO,EAAE,oHAAoH;qBAC9H;oBACD;wBACE,IAAI,EAAE,CAAC;wBACP,MAAM,EAAE,8DAA8D;qBACvE;iBACF;aACF;YACD,kBAAkB,EAAE;gBAClB,KAAK,EAAE,gCAAgC;gBACvC,QAAQ,EAAE;oBACR;wBACE,QAAQ,EAAE,oCAAoC;wBAC9C,OAAO,EAAE,qDAAqD;wBAC9D,WAAW,EAAE,wCAAwC;qBACtD;oBACD;wBACE,QAAQ,EAAE,8BAA8B;wBACxC,OAAO,EAAE,qEAAqE;wBAC9E,WAAW,EAAE,4CAA4C;qBAC1D;iBACF;aACF;YACD,cAAc,EAAE;gBACd,KAAK,EAAE,uBAAuB;gBAC9B,QAAQ,EAAE;oBACR;wBACE,QAAQ,EAAE,yCAAyC;wBACnD,OAAO,EAAE,kQAAkQ;wBAC3Q,WAAW,EAAE,4CAA4C;qBAC1D;iBACF;aACF;SACF;QACD,cAAc,EAAE;YACd,eAAe,EAAE;gBACf,8CAA8C;gBAC9C,6CAA6C;gBAC7C,8CAA8C;gBAC9C,2CAA2C;aAC5C;YACD,eAAe,EAAE;gBACf,kDAAkD;gBAClD,wCAAwC;gBACxC,6CAA6C;gBAC7C,wDAAwD;aACzD;YACD,gBAAgB,EAAE;gBAChB,8CAA8C;gBAC9C,kCAAkC;gBAClC,wCAAwC;gBACxC,2CAA2C;gBAC3C,6CAA6C;aAC9C;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/files/help/help.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Help action for file tool
+ */
+export declare function fileHelp(): any;
+//# sourceMappingURL=help.d.ts.map

package/dist/tools/files/help/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../src/tools/files/help/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,QAAQ,IAAI,GAAG,CAwB9B"}

package/dist/tools/files/help/help.js

@@ -0,0 +1,29 @@
+/**
+ * Help action for file tool
+ */
+export function fileHelp() {
+    return {
+        tool: 'file',
+        description: 'Track file changes across agents with layer classification',
+        note: '💡 TIP: Use action: "example" to see comprehensive usage scenarios and real-world examples for all file tracking actions.',
+        actions: {
+            record: 'Record file change. Params: file_path (required), agent_name (required), change_type (required), layer, description',
+            get: 'Get file changes. Params: file_path, agent_name, layer, change_type, since, limit',
+            check_lock: 'Check if file locked. Params: file_path (required), lock_duration',
+            record_batch: 'Batch record file changes (FR-005). Params: file_changes (required, array of RecordFileChangeParams, max: 50), atomic (optional, boolean, default: true). Returns: {success, inserted, failed, results}. ATOMIC MODE (atomic: true): All file changes succeed or all fail as a single transaction. IF ANY record fails, entire batch is rolled back and error is thrown. NON-ATOMIC MODE (atomic: false): Each file change is processed independently. If some fail, others still succeed. Returns partial results with per-item success/error status. RECOMMENDATION FOR AI AGENTS: Use atomic:false by default for best-effort recording. Use atomic:true only when all-or-nothing guarantee is required. 52% token reduction vs individual calls.'
+        },
+        examples: {
+            record: '{ action: "record", file_path: "src/index.ts", agent_name: "refactor-bot", change_type: "modified", layer: "infrastructure" }',
+            get: '{ action: "get", agent_name: "refactor-bot", layer: "infrastructure", limit: 10 }',
+            check_lock: '{ action: "check_lock", file_path: "src/index.ts", lock_duration: 300 }',
+            record_batch: '{ action: "record_batch", file_changes: [{"file_path": "src/types.ts", "agent_name": "bot1", "change_type": "modified", "layer": "data"}, {"file_path": "src/index.ts", "agent_name": "bot1", "change_type": "modified", "layer": "infrastructure"}], atomic: true }'
+        },
+        documentation: {
+            workflows: 'docs/WORKFLOWS.md - File locking patterns, concurrent file access workflows (602 lines, ~30k tokens)',
+            tool_reference: 'docs/TOOL_REFERENCE.md - File tool parameters, batch operations (471 lines, ~24k tokens)',
+            shared_concepts: 'docs/SHARED_CONCEPTS.md - Layer definitions, enum values (change_type), atomic mode (339 lines, ~17k tokens)',
+            best_practices: 'docs/BEST_PRACTICES.md - File tracking best practices (345 lines, ~17k tokens)'
+        }
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/tools/files/help/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../src/tools/files/help/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,QAAQ;IACtB,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE,2HAA2H;QACjI,OAAO,EAAE;YACP,MAAM,EAAE,qHAAqH;YAC7H,GAAG,EAAE,mFAAmF;YACxF,UAAU,EAAE,mEAAmE;YAC/E,YAAY,EAAE,stBAAstB;SACruB;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,+HAA+H;YACvI,GAAG,EAAE,mFAAmF;YACxF,UAAU,EAAE,yEAAyE;YACrF,YAAY,EAAE,sQAAsQ;SACrR;QACD,aAAa,EAAE;YACb,SAAS,EAAE,sGAAsG;YACjH,cAAc,EAAE,0FAA0F;YAC1G,eAAe,EAAE,8GAA8G;YAC/H,cAAc,EAAE,gFAAgF;SACjG;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/files/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * File tool - Barrel export
+ *
+ * Exports all file-related actions from modular structure
+ */
+export { recordFileChange } from './actions/record.js';
+export { getFileChanges } from './actions/get.js';
+export { checkFileLock } from './actions/check-lock.js';
+export { recordFileChangeBatch } from './actions/record-batch.js';
+export { sqliteFlush } from './actions/sqlite-flush.js';
+export { fileHelp } from './help/help.js';
+export { fileExample } from './help/example.js';
+export type { RecordFileChangeParams, GetFileChangesParams, CheckFileLockParams, RecordFileChangeBatchParams, RecordFileChangeResponse, GetFileChangesResponse, CheckFileLockResponse, RecordFileChangeBatchResponse, RecentFileChange } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/files/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EACjB,MAAM,YAAY,CAAC"}

package/dist/tools/files/index.js

@@ -0,0 +1,15 @@
+/**
+ * File tool - Barrel export
+ *
+ * Exports all file-related actions from modular structure
+ */
+// Action exports
+export { recordFileChange } from './actions/record.js';
+export { getFileChanges } from './actions/get.js';
+export { checkFileLock } from './actions/check-lock.js';
+export { recordFileChangeBatch } from './actions/record-batch.js';
+export { sqliteFlush } from './actions/sqlite-flush.js';
+// Help exports
+export { fileHelp } from './help/help.js';
+export { fileExample } from './help/example.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/files/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,eAAe;AACf,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tools/files/internal/queries.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared database queries for file operations
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import { Knex } from 'knex';
+import type { RecordFileChangeParams, RecordFileChangeResponse } from '../types.js';
+/**
+ * Internal helper: Record file change without transaction wrapper
+ * Used by recordFileChange (with transaction) and recordFileChangeBatch (manages its own transaction)
+ *
+ * @param params - File change parameters
+ * @param adapter - Database adapter instance
+ * @param projectId - Project ID
+ * @param trx - Optional transaction
+ * @returns Success response with change ID and timestamp
+ */
+export declare function recordFileChangeInternal(params: RecordFileChangeParams, adapter: DatabaseAdapter, projectId: number, trx?: Knex.Transaction): Promise<RecordFileChangeResponse>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/tools/files/internal/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../../src/tools/files/internal/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEpF;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,IAAI,CAAC,WAAW,GACrB,OAAO,CAAC,wBAAwB,CAAC,CAsDnC"}

package/dist/tools/files/internal/queries.js

@@ -0,0 +1,63 @@
+/**
+ * Shared database queries for file operations
+ */
+import { getOrCreateFile, getOrCreateAgent, getLayerId } from '../../../database.js';
+import { STRING_TO_CHANGE_TYPE, STANDARD_LAYERS } from '../../../constants.js';
+import { validateChangeType } from '../../../utils/validators.js';
+import { logFileRecord } from '../../../utils/activity-logging.js';
+/**
+ * Internal helper: Record file change without transaction wrapper
+ * Used by recordFileChange (with transaction) and recordFileChangeBatch (manages its own transaction)
+ *
+ * @param params - File change parameters
+ * @param adapter - Database adapter instance
+ * @param projectId - Project ID
+ * @param trx - Optional transaction
+ * @returns Success response with change ID and timestamp
+ */
+export async function recordFileChangeInternal(params, adapter, projectId, trx) {
+    const knex = trx || adapter.getKnex();
+    // Validate change_type
+    validateChangeType(params.change_type);
+    const changeTypeInt = STRING_TO_CHANGE_TYPE[params.change_type];
+    // Validate layer if provided
+    let layerId = null;
+    if (params.layer) {
+        if (!STANDARD_LAYERS.includes(params.layer)) {
+            throw new Error(`Invalid layer: ${params.layer}. Must be one of: ${STANDARD_LAYERS.join(', ')}`);
+        }
+        layerId = await getLayerId(adapter, params.layer, trx);
+        if (layerId === null) {
+            throw new Error(`Layer not found: ${params.layer}`);
+        }
+    }
+    // Auto-register file and agent (v3.7.3: pass projectId)
+    const fileId = await getOrCreateFile(adapter, projectId, params.file_path, trx);
+    const agentId = await getOrCreateAgent(adapter, params.agent_name, trx);
+    // Current timestamp
+    const ts = Math.floor(Date.now() / 1000);
+    // Insert file change record with project_id
+    const [changeId] = await knex('t_file_changes').insert({
+        file_id: fileId,
+        agent_id: agentId,
+        layer_id: layerId,
+        change_type: changeTypeInt,
+        description: params.description || null,
+        project_id: projectId,
+        ts: ts
+    });
+    // Activity logging (replaces trigger)
+    await logFileRecord(knex, {
+        file_path: params.file_path,
+        change_type: changeTypeInt,
+        agent_id: agentId,
+        layer_id: layerId || undefined
+    });
+    const timestamp = new Date(ts * 1000).toISOString();
+    return {
+        success: true,
+        change_id: Number(changeId),
+        timestamp: timestamp,
+    };
+}
+//# sourceMappingURL=queries.js.map

package/dist/tools/files/internal/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../../src/tools/files/internal/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGnE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA8B,EAC9B,OAAwB,EACxB,SAAiB,EACjB,GAAsB;IAEtB,MAAM,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtC,uBAAuB;IACvB,kBAAkB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEhE,6BAA6B;IAC7B,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAY,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,KAAK,qBAAqB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAExE,oBAAoB;IACpB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEzC,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;QACrD,OAAO,EAAE,MAAM;QACf,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;QACvC,UAAU,EAAE,SAAS;QACrB,EAAE,EAAE,EAAE;KACP,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,aAAa,CAAC,IAAI,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,WAAW,EAAE,aAAa;QAC1B,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,OAAO,IAAI,SAAS;KAC/B,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAEpD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC3B,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC"}

package/dist/tools/files/internal/validation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Parameter validation utilities for file operations
+ */
+import { validateChangeType } from '../../../utils/validators.js';
+import { validateActionParams, validateBatchParams } from '../../../utils/parameter-validator.js';
+import type { DatabaseAdapter } from '../../../adapters/types.js';
+import { BatchValidationError } from '../../../utils/batch-validation.js';
+/**
+ * Validate layer parameter
+ */
+export declare function validateLayerParam(layer?: string): void;
+export { validateChangeType, validateActionParams, validateBatchParams };
+/**
+ * Validate single file change item in batch operation
+ * Accumulates all validation errors for the item
+ */
+export declare function validateFileChangeItem(item: any, index: number, adapter: DatabaseAdapter, errors: BatchValidationError[]): Promise<void>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/tools/files/internal/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/tools/files/internal/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAElG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,oBAAoB,EAGrB,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAMvD;AAGD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;AAOzE;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,GAAG,EACT,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,oBAAoB,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/tools/files/internal/validation.js

@@ -0,0 +1,40 @@
+/**
+ * Parameter validation utilities for file operations
+ */
+import { validateChangeType } from '../../../utils/validators.js';
+import { validateActionParams, validateBatchParams } from '../../../utils/parameter-validator.js';
+import { STANDARD_LAYERS } from '../../../constants.js';
+import { validateRequiredField, validateEnum, } from '../../../utils/batch-validation.js';
+/**
+ * Validate layer parameter
+ */
+export function validateLayerParam(layer) {
+    if (layer && !STANDARD_LAYERS.includes(layer)) {
+        throw new Error(`Invalid layer: ${layer}. Must be one of: ${STANDARD_LAYERS.join(', ')}`);
+    }
+}
+// Re-export common validators
+export { validateChangeType, validateActionParams, validateBatchParams };
+/**
+ * Valid change types for file operations
+ */
+const VALID_CHANGE_TYPES = ['created', 'modified', 'deleted'];
+/**
+ * Validate single file change item in batch operation
+ * Accumulates all validation errors for the item
+ */
+export async function validateFileChangeItem(item, index, adapter, errors) {
+    const identifier = item.file_path || `Item ${index + 1}`;
+    // Required: file_path
+    validateRequiredField(item.file_path, 'file_path', index, identifier, errors);
+    // Required: agent_name
+    validateRequiredField(item.agent_name, 'agent_name', index, identifier, errors);
+    // Required: change_type
+    validateRequiredField(item.change_type, 'change_type', index, identifier, errors);
+    validateEnum(item.change_type, 'change_type', VALID_CHANGE_TYPES, index, identifier, errors);
+    // Optional but must be valid: layer
+    if (item.layer !== undefined) {
+        validateEnum(item.layer, 'layer', STANDARD_LAYERS, index, identifier, errors);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/tools/files/internal/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../../src/tools/files/internal/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAEL,qBAAqB,EACrB,YAAY,GACb,MAAM,oCAAoC,CAAC;AAE5C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAY,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,qBAAqB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;AAEzE;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,IAAS,EACT,KAAa,EACb,OAAwB,EACxB,MAA8B;IAE9B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,IAAI,QAAQ,KAAK,GAAG,CAAC,EAAE,CAAC;IAEzD,sBAAsB;IACtB,qBAAqB,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE9E,uBAAuB;IACvB,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAEhF,wBAAwB;IACxB,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClF,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAE7F,oCAAoC;IACpC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7B,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;AACH,CAAC"}

package/dist/tools/files/types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * File-specific types
+ * Re-exports from main types module
+ */
+export type { RecordFileChangeParams, GetFileChangesParams, CheckFileLockParams, RecordFileChangeBatchParams, RecordFileChangeResponse, GetFileChangesResponse, CheckFileLockResponse, RecordFileChangeBatchResponse, RecentFileChange } from '../../types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/files/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EACjB,MAAM,gBAAgB,CAAC"}

package/dist/tools/files/types.js

@@ -0,0 +1,6 @@
+/**
+ * File-specific types
+ * Re-exports from main types module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/files/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/files/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/tools/help/actions/batch-guide.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Help Tool - batch_guide Action
+ * Get guidance for batch operations
+ */
+import { DatabaseAdapter } from '../../../adapters/index.js';
+import { HelpBatchGuideParams, HelpBatchGuideResult } from '../types.js';
+/**
+ * Get batch operation guide
+ * Queries database for batch-specific examples and adds best practices
+ */
+export declare function batchGuide(params: HelpBatchGuideParams, adapter?: DatabaseAdapter): Promise<HelpBatchGuideResult | {
+    error: string;
+}>;
+//# sourceMappingURL=batch-guide.d.ts.map

package/dist/tools/help/actions/batch-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-guide.d.ts","sourceRoot":"","sources":["../../../../src/tools/help/actions/batch-guide.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAe,MAAM,aAAa,CAAC;AAEtF;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,oBAAoB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA2DnD"}