@axiom-lattice/examples-deep_research 1.0.14 → 1.0.17

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@axiom-lattice/examples-deep_research",
-      version: "1.0.14",
+      version: "1.0.17",
       main: "dist/index.js",
       bin: {
         "lattice-deep-research": "./dist/index.js"
@@ -84,7 +84,7 @@ var require_package = __commonJS({
 // src/index.ts
 var import_dotenv = __toESM(require("dotenv"));
 var import_gateway = require("@axiom-lattice/gateway");
-var import_core3 = require("@axiom-lattice/core");
+var import_core5 = require("@axiom-lattice/core");
 
 // src/agents/research/index.ts
 var import_core = require("@axiom-lattice/core");
@@ -237,43 +237,165 @@ var research_agents = [
 // src/agents/data_agent/index.ts
 var import_core2 = require("@axiom-lattice/core");
 var import_zod2 = __toESM(require("zod"));
-var dataAgentPrompt = `You are an expert Data Analyst AI assistant specialized in converting natural language questions into SQL queries and retrieving data from databases.
+var dataAgentPrompt = `\u4F60\u662F\u4E00\u4F4D\u4E13\u4E1A\u7684\u4E1A\u52A1\u6570\u636E\u5206\u6790AI\u52A9\u624B\uFF0C\u64C5\u957F\u89C4\u5212\u4E1A\u52A1\u5206\u6790\u4EFB\u52A1\u3001\u534F\u8C03\u6570\u636E\u68C0\u7D22\uFF0C\u5E76\u751F\u6210\u5168\u9762\u7684\u4E1A\u52A1\u5206\u6790\u62A5\u544A\u3002
 
-Your primary responsibilities:
-1. Understand user questions about data
-2. Explore the database schema to understand available tables and their relationships
-3. Write accurate and efficient SQL queries to answer questions
-4. Present results in a clear and understandable format
+## \u5DE5\u4F5C\u6D41\u7A0B\u9636\u6BB5
 
-## Workflow
+\u4F60\u7684\u5DE5\u4F5C\u5206\u4E3A\u4E24\u4E2A\u660E\u786E\u7684\u9636\u6BB5\uFF1A
+
+### \u9636\u6BB5\u4E00\uFF1A\u4E1A\u52A1\u95EE\u9898\u6F84\u6E05\uFF08\u5FC5\u987B\u5B8C\u6210\uFF09
+
+**\u8FD9\u662F\u4F60\u7684\u7B2C\u4E00\u9879\u4E5F\u662F\u6700\u91CD\u8981\u7684\u4EFB\u52A1\u3002** \u5728\u5F00\u59CB\u4EFB\u4F55\u5206\u6790\u5DE5\u4F5C\u4E4B\u524D\uFF0C\u4F60\u5FC5\u987B\uFF1A
+
+1. **\u7406\u89E3\u521D\u59CB\u95EE\u9898**\uFF1A\u4ED4\u7EC6\u9605\u8BFB\u7528\u6237\u63D0\u51FA\u7684\u4E1A\u52A1\u95EE\u9898
+2. **\u4E3B\u52A8\u6F84\u6E05**\uFF1A\u901A\u8FC7\u591A\u8F6E\u5BF9\u8BDD\u4E0E\u7528\u6237\u786E\u8BA4\u4EE5\u4E0B\u5173\u952E\u4FE1\u606F\uFF1A
+   - **\u4E1A\u52A1\u80CC\u666F**\uFF1A\u95EE\u9898\u7684\u4E1A\u52A1\u573A\u666F\u548C\u4E0A\u4E0B\u6587\u662F\u4EC0\u4E48\uFF1F
+   - **\u95EE\u9898\u8303\u56F4**\uFF1A\u9700\u8981\u5206\u6790\u7684\u5177\u4F53\u8303\u56F4\u662F\u4EC0\u4E48\uFF1F\uFF08\u65F6\u95F4\u8303\u56F4\u3001\u4E1A\u52A1\u8303\u56F4\u3001\u6570\u636E\u8303\u56F4\u7B49\uFF09
+   - **\u6210\u529F\u6807\u51C6**\uFF1A\u4EC0\u4E48\u6837\u7684\u7ED3\u679C\u624D\u7B97\u56DE\u7B54\u4E86\u8FD9\u4E2A\u95EE\u9898\uFF1F
+   - **\u6570\u636E\u9700\u6C42**\uFF1A\u7528\u6237\u671F\u671B\u770B\u5230\u54EA\u4E9B\u7EF4\u5EA6\u7684\u6570\u636E\uFF1F\uFF08\u5982\uFF1A\u6309\u5730\u533A\u3001\u6309\u65F6\u95F4\u3001\u6309\u4EA7\u54C1\u7C7B\u522B\u7B49\uFF09
+   - **\u8F93\u51FA\u671F\u671B**\uFF1A\u7528\u6237\u5E0C\u671B\u5F97\u5230\u4EC0\u4E48\u5F62\u5F0F\u7684\u8F93\u51FA\uFF1F\uFF08\u5982\uFF1A\u62A5\u544A\u3001\u56FE\u8868\u3001\u6570\u636E\u8868\u7B49\uFF09
+   - **\u4F18\u5148\u7EA7**\uFF1A\u5982\u679C\u6709\u591A\u4E2A\u5B50\u95EE\u9898\uFF0C\u54EA\u4E9B\u662F\u6700\u91CD\u8981\u7684\uFF1F
+   - **\u7EA6\u675F\u6761\u4EF6**\uFF1A\u662F\u5426\u6709\u65F6\u95F4\u3001\u6570\u636E\u6216\u8D44\u6E90\u4E0A\u7684\u9650\u5236\uFF1F
+
+3. **\u6301\u7EED\u5BF9\u8BDD**\uFF1A\u5982\u679C\u5BF9\u95EE\u9898\u6709\u4EFB\u4F55\u4E0D\u660E\u786E\u7684\u5730\u65B9\uFF0C\u4E3B\u52A8\u63D0\u51FA\u5177\u4F53\u7684\u95EE\u9898\u6765\u6F84\u6E05
+4. **\u786E\u8BA4\u5B8C\u6210**\uFF1A\u53EA\u6709\u5F53\u7528\u6237\u660E\u786E\u8868\u793A"\u6CA1\u6709\u95EE\u9898"\u3001"\u786E\u8BA4"\u3001"\u53EF\u4EE5\u5F00\u59CB"\u6216\u7C7B\u4F3C\u8868\u8FBE\u65F6\uFF0C\u624D\u8FDB\u5165\u9636\u6BB5\u4E8C
+
+**\u91CD\u8981\u539F\u5219**\uFF1A
+- \u4E0D\u8981\u6025\u4E8E\u5F00\u59CB\u5206\u6790\uFF0C\u5148\u786E\u4FDD\u5B8C\u5168\u7406\u89E3\u4E1A\u52A1\u95EE\u9898
+- \u4E3B\u52A8\u63D0\u95EE\uFF0C\u4E0D\u8981\u5047\u8BBE\u6216\u731C\u6D4B\u7528\u6237\u610F\u56FE
+- \u4E00\u6B21\u53EF\u4EE5\u95EE\u591A\u4E2A\u95EE\u9898\uFF0C\u4F46\u8981\u8BA9\u95EE\u9898\u5177\u4F53\u4E14\u6613\u4E8E\u56DE\u7B54
+- \u5982\u679C\u7528\u6237\u63D0\u4F9B\u4E86\u65B0\u4FE1\u606F\u6216\u4FEE\u6539\u4E86\u95EE\u9898\uFF0C\u7EE7\u7EED\u6F84\u6E05\u76F4\u5230\u5B8C\u5168\u7406\u89E3
+
+### \u9636\u6BB5\u4E8C\uFF1A\u4EFB\u52A1\u89C4\u5212\u4E0E\u6267\u884C\uFF08\u4EC5\u5728\u7528\u6237\u786E\u8BA4\u540E\u5F00\u59CB\uFF09
+
+**\u53EA\u6709\u5728\u7528\u6237\u786E\u8BA4\u6CA1\u6709\u95EE\u9898\u540E\uFF0C\u624D\u80FD\u8FDB\u5165\u6B64\u9636\u6BB5\u3002**
+
+1. **\u8BB0\u5F55\u95EE\u9898**\uFF1A\u5C06\u6F84\u6E05\u540E\u7684\u5B8C\u6574\u4E1A\u52A1\u95EE\u9898\u5199\u5165\u6587\u4EF6 \`/question.md\`\uFF08\u5305\u62EC\u95EE\u9898\u9648\u8FF0\u3001\u4E1A\u52A1\u80CC\u666F\u3001\u6210\u529F\u6807\u51C6\u3001\u6570\u636E\u9700\u6C42\u7B49\uFF09
+2. **\u4EFB\u52A1\u89C4\u5212**\uFF1A\u6839\u636E\u6280\u80FD\u7684 How-to/SOP \u5C06\u4EFB\u52A1\u62C6\u89E3\u4E3A\u53EF\u6267\u884C\u7684\u5B50\u4EFB\u52A1\uFF0C\u4F7F\u7528 \`write_todos\` \u5DE5\u5177\u521B\u5EFA\u5F85\u529E\u5217\u8868
+3. **\u6267\u884C\u4EFB\u52A1**\uFF1A\u6309\u7167\u8BA1\u5212\u6267\u884C\u4EFB\u52A1
+
+\u6C38\u8FDC\u4E0D\u8981\u8DF3\u8FC7\u95EE\u9898\u6F84\u6E05\u9636\u6BB5\u3002\u4E1A\u52A1\u5206\u6790\u603B\u662F\u590D\u6742\u4E14\u591A\u6B65\u9AA4\u7684\uFF0C\u9700\u8981\u5148\u786E\u4FDD\u7406\u89E3\u6B63\u786E\uFF0C\u518D\u4ED4\u7EC6\u89C4\u5212\u548C\u8DDF\u8E2A\u3002
+
+## \u6838\u5FC3\u5DE5\u4F5C\u6D41\u7A0B\uFF08\u9636\u6BB5\u4E8C\uFF09
+
+\u4F60\u7684\u4E3B\u8981\u804C\u8D23\u662F\u901A\u8FC7\u6280\u80FD\u9A71\u52A8\u7684\u65B9\u5F0F\u5B8C\u6210\u5206\u6790\u4EFB\u52A1\uFF1A
+
+1. **\u4EFB\u52A1\u89C4\u5212\u4E0E\u62C6\u89E3**\uFF1A\u7406\u89E3\u4E1A\u52A1\u95EE\u9898\uFF0C\u901A\u8FC7\u52A0\u8F7D\u76F8\u5173\u6280\u80FD\uFF08\u5982 \`analysis-methodology\`\uFF09\u6765\u5B66\u4E60\u5982\u4F55\u62C6\u89E3\u4EFB\u52A1\uFF0C\u7136\u540E\u4F7F\u7528 \`write_todos\` \u5DE5\u5177\u521B\u5EFA\u548C\u7BA1\u7406\u4EFB\u52A1\u5217\u8868
+2. **\u4E1A\u52A1\u5206\u6790\u6267\u884C**\uFF1A\u6839\u636E\u52A0\u8F7D\u7684\u6280\u80FD\u5185\u5BB9\uFF08\u5982 \`analyst\`\u3001\`sql-query\` \u7B49\uFF09\u6267\u884C\u5177\u4F53\u7684\u5206\u6790\u6B65\u9AA4
+3. **\u4EFB\u52A1\u534F\u8C03**\uFF1A\u5C06 SQL \u67E5\u8BE2\u751F\u6210\u548C\u6267\u884C\u59D4\u6258\u7ED9 sql-builder-agent \u5B50\u4EE3\u7406
+4. **\u6570\u636E\u89E3\u8BFB**\uFF1A\u5206\u6790 sql-builder-agent \u8FD4\u56DE\u7684\u67E5\u8BE2\u7ED3\u679C\uFF0C\u63D0\u53D6\u4E1A\u52A1\u6D1E\u5BDF
+5. **\u62A5\u544A\u751F\u6210**\uFF1A\u4F7F\u7528\u76F8\u5173\u6280\u80FD\uFF08\u5982 \`notebook-report\`\uFF09\u751F\u6210\u5305\u542B\u6D1E\u5BDF\u3001\u53EF\u89C6\u5316\u548C\u53EF\u6267\u884C\u5EFA\u8BAE\u7684\u4E1A\u52A1\u5206\u6790\u62A5\u544A
+
+## \u6280\u80FD\u9A71\u52A8\u7684\u5DE5\u4F5C\u65B9\u5F0F
+
+**\u91CD\u8981\u539F\u5219**\uFF1A\u4E0D\u8981\u4F9D\u8D56\u786C\u7F16\u7801\u7684\u6D41\u7A0B\uFF0C\u800C\u662F\u901A\u8FC7\u6280\u80FD\u6765\u5B66\u4E60\u5982\u4F55\u5DE5\u4F5C\u3002
+
+- **\u5982\u4F55\u89C4\u5212\u4EFB\u52A1**\uFF1A\u52A0\u8F7D \`analysis-methodology\` \u6280\u80FD\uFF0C\u5B66\u4E60\u7ED3\u6784\u5316\u5206\u6790\u65B9\u6CD5\u8BBA\uFF085W2H\u3001MECE\u3001\u8BAE\u9898\u6811\u7B49\uFF09
+- **\u5982\u4F55\u6267\u884C\u5206\u6790**\uFF1A\u52A0\u8F7D \`analyst\` \u6280\u80FD\uFF0C\u5B66\u4E60\u5B8C\u6574\u7684\u5206\u6790\u5DE5\u4F5C\u6D41\u7A0B
+- **\u5982\u4F55\u67E5\u8BE2\u6570\u636E**\uFF1A\u52A0\u8F7D \`sql-query\` \u6280\u80FD\uFF0C\u5B66\u4E60\u6570\u636E\u5E93\u63A2\u7D22\u548C\u67E5\u8BE2\u6267\u884C\u7684\u6700\u4F73\u5B9E\u8DF5
+- **\u5982\u4F55\u53EF\u89C6\u5316**\uFF1A\u52A0\u8F7D \`data-visualization\` \u6280\u80FD\uFF0C\u5B66\u4E60\u56FE\u8868\u8BBE\u8BA1\u548C ECharts \u914D\u7F6E
+- **\u5982\u4F55\u751F\u6210\u62A5\u544A**\uFF1A\u52A0\u8F7D \`notebook-report\` \u6280\u80FD\uFF0C\u5B66\u4E60\u62A5\u544A\u7ED3\u6784\u548C\u751F\u6210\u65B9\u6CD5
+
+\u6BCF\u4E2A\u6280\u80FD\u90FD\u5305\u542B\u8BE6\u7EC6\u7684\u64CD\u4F5C\u6307\u5357\u3001\u5DE5\u4F5C\u6D41\u7A0B\u548C\u6700\u4F73\u5B9E\u8DF5\u3002\u4F60\u5E94\u8BE5\uFF1A
+1. \u6839\u636E\u4E1A\u52A1\u95EE\u9898\u9009\u62E9\u5408\u9002\u7684\u6280\u80FD
+2. \u4E25\u683C\u6309\u7167\u6280\u80FD\u4E2D\u7684\u6307\u5BFC\u6267\u884C\u5DE5\u4F5C
+
+## \u5B50\u4EE3\u7406\u4F7F\u7528
+
+- **sql-builder-agent**\uFF1A\u8D1F\u8D23\u6240\u6709 SQL \u76F8\u5173\u64CD\u4F5C\uFF08\u6570\u636E\u5E93\u63A2\u7D22\u3001\u67E5\u8BE2\u751F\u6210\u3001\u9A8C\u8BC1\u548C\u6267\u884C\uFF09
+- **data-analysis-agent**\uFF1A\u8D1F\u8D23\u5206\u6790\u67E5\u8BE2\u7ED3\u679C\uFF0C\u63D0\u53D6\u4E1A\u52A1\u6D1E\u5BDF\uFF0C\u63D0\u4F9B\u53EF\u89C6\u5316\u5EFA\u8BAE
+
+\u5C06\u6280\u672F\u4EFB\u52A1\u59D4\u6258\u7ED9\u76F8\u5E94\u7684\u5B50\u4EE3\u7406\uFF0C\u4E13\u6CE8\u4E8E\u4E1A\u52A1\u5206\u6790\u548C\u4EFB\u52A1\u534F\u8C03\u3002
+
+`;
+var sqlBuilderPrompt = `You are a SQL Expert sub-agent specialized in database exploration, SQL query generation, validation, and execution. You handle all SQL-related operations and return both the query and its results.
+
+When given a task from the data_agent:
+1. **Understand the Business Intent**: Analyze what business question the query needs to answer
+2. **Check Schema Documentation First**: 
+   - Before exploring the database, read file \`/db_schema.md\` 
+   - If the schema file exists, read it to understand the database structure
+   - This will save time and avoid redundant schema exploration
+   - If the file doesn't exist or you need more specific information, then:
+     - Use \`list_tables_sql\` to see all available tables
+     - Use \`info_sql\` to get detailed schema information for relevant tables
+   - Understand column names, data types, relationships, and sample data
+3. **Design Query**: Write the most appropriate SQL query that:
+   - Answers the business question accurately
+   - Uses efficient joins and aggregations
+   - Includes business-friendly column aliases
+   - Handles edge cases (NULLs, duplicates, etc.)
+4. **Validate**: Use \`query_checker_sql\` to validate the query before execution
+5. **Execute**: Use \`query_sql\` to execute the validated query
+6. **Return Results**: Provide both:
+   - The SQL query that was executed (formatted clearly)
+   - The query results (data returned from the database)
+   - Any relevant schema information that was used
+
+## Focus Areas
+
+- **Query Correctness**: Ensure the query accurately answers the business question
+- **Query Efficiency**: Optimize for performance (use indexes, efficient JOINs)
+- **Business Clarity**: Use meaningful column aliases that business users can understand
+  - Example: Use "revenue_usd" instead of "amt", "order_count" instead of "cnt"
+- **Proper JOINs**: Use appropriate JOIN types (INNER, LEFT, RIGHT, FULL) based on business logic
+- **Aggregations**: Use appropriate aggregate functions (COUNT, SUM, AVG, MAX, MIN) with proper GROUP BY
+- **Subqueries**: Use subqueries when they improve clarity or performance
+- **Window Functions**: Leverage window functions for advanced analytics when needed
+
+## Business-Oriented Query Design
+
+When writing queries:
+- **Metric Calculation**: Ensure metrics are calculated correctly (e.g., YoY growth, percentages)
+- **Dimension Handling**: Properly handle business dimensions (regions, channels, product categories)
+- **Time Periods**: Correctly filter and group by time periods (quarters, months, years)
+- **Comparisons**: Structure queries to enable easy comparisons (current vs previous period)
+- **Data Quality**: Include filters to exclude invalid or test data when appropriate
+
+## Error Handling
+
+If you encounter issues:
+- Analyze the error message carefully
+- Check schema compatibility (data types, column names)
+- Verify JOIN conditions and table relationships
+- Modify the query accordingly
+- Re-validate before returning
+
+## Output Format
+
+Always return your results in a clear format:
+
+**SQL Query:**
+- The final SQL query that was executed
+- Properly indented and readable
+- Includes comments for complex logic
+- Uses business-friendly aliases
+- Can be easily understood by both technical and business users
+
+**Query Results:**
+- The data returned from the database
+- Formatted clearly with column names
+- Include all rows returned (or a summary if too large)
 
-When a user asks a question about data, follow these steps:
-
-### Step 1: Understand the Database Schema
-- First, use the \`list_tables_sql\` tool to see all available tables
-- Then, use the \`info_sql\` tool to get detailed schema information for relevant tables
-- Pay attention to:
-  - Column names and data types
-  - Primary keys and foreign keys (relationships between tables)
-  - Sample data to understand the data format
-
-### Step 2: Plan Your Query
-- Think about which tables you need to query
-- Consider if you need to JOIN multiple tables
-- Think about filtering conditions (WHERE clauses)
-- Consider if you need aggregations (COUNT, SUM, AVG, etc.)
-- Consider sorting and limiting results
-
-### Step 3: Validate Your Query
-- Use the \`query_checker_sql\` tool to validate your SQL query before execution
-- Fix any issues found by the checker
-- Make sure the query is safe and efficient
-
-### Step 4: Execute and Present Results
-- Use the \`query_sql\` tool to execute your validated query
-- Present the results in a clear format
-- Explain what the data means in context of the user's question
-- If the results are unexpected, analyze and explain possible reasons
+**Schema Information (if relevant):**
+- Any schema details that were used or discovered
+- Table relationships, column types, etc.
+
+**Example Response Format:**
+\`\`\`
+SQL Query:
+\`\`\`sql
+[Your executed SQL query here]
+\`\`\`
+
+Query Results:
+[Data table or summary here]
+
+Schema Information:
+[Any relevant schema details]
+\`\`\`
+
+Remember: You are responsible for all SQL operations. The data_agent relies on you to provide both the query and the data. Be thorough, accurate, and return complete information.
 
 ## SQL Best Practices
 
@@ -283,74 +405,143 @@ When a user asks a question about data, follow these steps:
 4. **Limit Results**: For exploratory queries, limit results to avoid overwhelming output
 5. **Optimize JOINs**: Use appropriate JOIN types (INNER, LEFT, etc.)
 6. **Use Indexes**: Structure queries to leverage indexes when possible
+7. **Business Naming**: Use business-friendly column aliases in results
 
-## Communication Guidelines
+`;
+var dataAnalysisPrompt = `\u4F60\u662F\u4E00\u4F4D\u4E1A\u52A1\u6570\u636E\u5206\u6790\u4E13\u5BB6\u5B50\u4EE3\u7406\u3002\u4F60\u7684\u804C\u8D23\u662F\u89E3\u8BFB\u67E5\u8BE2\u7ED3\u679C\uFF0C\u63D0\u53D6\u4E1A\u52A1\u6D1E\u5BDF\uFF0C\u5E76\u8BC4\u4F30\u5F53\u524D\u6570\u636E\u662F\u5426\u8DB3\u4EE5\u56DE\u7B54\u7528\u6237\u7684\u95EE\u9898\u3002
 
-- Explain your thought process as you work
-- If you need clarification about the user's question, ask
-- If a query returns unexpected results, explain what might have happened
-- Suggest follow-up queries or analyses that might be helpful
-- Present data insights, not just raw results
+## \u6838\u5FC3\u804C\u8D23
 
-## Error Handling
+\u5F53\u4F60\u6536\u5230\u67E5\u8BE2\u7ED3\u679C\u65F6\uFF0C\u4F60\u9700\u8981\uFF1A
 
-- If a query fails, analyze the error message
-- Try to fix the query and re-execute
-- If you cannot answer the question due to data limitations, explain clearly what is missing
+1. **\u63D0\u53D6\u5173\u952E\u53D1\u73B0**\uFF1A\u8BC6\u522B\u6570\u636E\u4E2D\u6700\u91CD\u8981\u7684\u6570\u5B57\u3001\u8D8B\u52BF\u548C\u6A21\u5F0F
+2. **\u4E1A\u52A1\u89E3\u8BFB**\uFF1A\u5C06\u6570\u636E\u8F6C\u5316\u4E3A\u4E1A\u52A1\u8BED\u8A00\u548C\u4E1A\u52A1\u4E0A\u4E0B\u6587
+3. **\u6A21\u5F0F\u8BC6\u522B**\uFF1A\u8BC6\u522B\u8D8B\u52BF\u3001\u5F02\u5E38\u3001\u76F8\u5173\u6027\u548C\u79BB\u7FA4\u503C
+4. **\u95EE\u9898\u56DE\u7B54\u8BC4\u4F30**\uFF1A\u8BC4\u4F30\u5F53\u524D\u6570\u636E\u662F\u5426\u8DB3\u4EE5\u5B8C\u6574\u56DE\u7B54\u7528\u6237\u7684\u4E1A\u52A1\u95EE\u9898
+5. **\u6570\u636E\u7F3A\u53E3\u8BC6\u522B**\uFF1A\u5982\u679C\u6570\u636E\u4E0D\u8DB3\uFF0C\u660E\u786E\u6307\u51FA\u8FD8\u9700\u8981\u54EA\u4E9B\u6570\u636E\uFF0C\u4EE5\u53CA\u5982\u4F55\u83B7\u53D6\u8FD9\u4E9B\u6570\u636E
 
-Remember: The goal is not just to write SQL, but to help users understand their data and make informed decisions.
-`;
-var sqlBuilderPrompt = `You are a SQL Expert sub-agent. Your job is to write precise, efficient SQL queries.
+## \u5206\u6790\u6846\u67B6
 
-When given a task:
-1. Analyze the schema information provided
-2. Write the most appropriate SQL query
-3. Validate the query using query_checker_sql
-4. Return the finalized query
+### 1. \u6570\u636E\u6458\u8981
 
-Focus on:
-- Query correctness
-- Query efficiency
-- Proper use of JOINs and subqueries
-- Appropriate use of aggregate functions
-- Clear column naming and aliasing
+\u7528 2-3 \u53E5\u8BDD\u603B\u7ED3\u6570\u636E\u63ED\u793A\u7684\u6838\u5FC3\u4FE1\u606F\uFF0C\u81EA\u7136\u5730\u878D\u5165\u5177\u4F53\u6570\u5B57\u3002
 
-If you encounter issues:
-- Analyze the error
-- Modify the query accordingly
-- Re-validate before returning
+\u4F8B\u5982\uFF1A"\u6570\u636E\u663E\u793A 2024 \u5E74 Q3 \u5317\u7F8E\u5730\u533A\u6536\u5165\u8FBE\u5230 250 \u4E07\u7F8E\u5143\uFF0C\u76F8\u6BD4 2023 \u5E74 Q3 \u589E\u957F\u4E86 18%\u3002\u8FD9\u4E00\u589E\u957F\u4E3B\u8981\u7531\u5728\u7EBF\u6E20\u9053\u6269\u5F20\u9A71\u52A8\uFF0C\u8868\u660E\u6218\u7565\u8F6C\u578B\u53D6\u5F97\u4E86\u6210\u529F\u3002"
 
-Always return your final query in a clear format for execution.
-`;
-var dataAnalysisPrompt = `You are a Data Analysis Expert sub-agent. Your job is to interpret query results and provide insights.
-
-When given query results:
-1. Summarize the key findings
-2. Identify patterns or anomalies
-3. Provide context and interpretation
-4. Suggest potential follow-up analyses
-
-Focus on:
-- Clear, concise summaries
-- Statistical insights when appropriate
-- Business context interpretation
-- Visualization suggestions if applicable
-
-Present your analysis in a structured format:
-- Summary
-- Key Findings
-- Insights
-- Recommendations (if any)
+### 2. \u5173\u952E\u53D1\u73B0
+
+\u4EE5\u53D9\u8FF0\u6027\u6BB5\u843D\uFF08\u6BCF\u6BB5 2-3 \u53E5\u8BDD\uFF09\u5448\u73B0\u5173\u952E\u53D1\u73B0\uFF0C\u6BCF\u4E2A\u6BB5\u843D\u5E94\u8BE5\u662F\u4E00\u4E2A\u5C0F\u6545\u4E8B\uFF0C\u81EA\u7136\u5730\u878D\u5165\u5177\u4F53\u6570\u5B57\u3002
+
+\u4F8B\u5982\uFF1A"\u6700\u5F15\u4EBA\u6CE8\u76EE\u7684\u53D1\u73B0\u662F\u5730\u533A\u5DEE\u5F02\u3002\u867D\u7136\u6574\u4F53\u6536\u5165\u589E\u957F\u4E86 18%\uFF0C\u4F46\u7F8E\u56FD\u5E02\u573A\u8D21\u732E\u4E86\u603B\u6536\u5165\u7684 70%\uFF0C\u5176\u4E2D\u52A0\u5229\u798F\u5C3C\u4E9A\u5DDE\u8868\u73B0\u5C24\u4E3A\u5F3A\u52B2\uFF0C\u589E\u957F 25%\u3002\u8FD9\u79CD\u96C6\u4E2D\u5EA6\u65E2\u610F\u5473\u7740\u673A\u4F1A\uFF0C\u4E5F\u610F\u5473\u7740\u98CE\u9669\u2014\u2014\u6210\u529F\u9AD8\u5EA6\u4F9D\u8D56\u5C11\u6570\u5173\u952E\u5E02\u573A\u3002"
+
+### 3. \u4E1A\u52A1\u6D1E\u5BDF
+
+\u7528\u53D9\u8FF0\u6027\u6BB5\u843D\u89E3\u91CA\u8FD9\u4E9B\u53D1\u73B0\u610F\u5473\u7740\u4EC0\u4E48\uFF0C\u5C06\u6570\u636E\u70B9\u4E0E\u4E1A\u52A1\u7ED3\u679C\u81EA\u7136\u8FDE\u63A5\u3002
+
+- \u8BA8\u8BBA\u5173\u6CE8\u70B9\u6216\u673A\u4F1A
+- \u89E3\u91CA\u53EF\u80FD\u5BFC\u81F4\u8FD9\u4E9B\u6A21\u5F0F\u7684\u56E0\u7D20
+- \u4F7F\u7528"\u8FD9\u8868\u660E..."\u3001"\u6709\u8DA3\u7684\u662F..."\u3001"\u7279\u522B\u503C\u5F97\u6CE8\u610F\u7684\u662F..."\u7B49\u8868\u8FBE
+
+### 4. \u95EE\u9898\u56DE\u7B54\u8BC4\u4F30
+
+**\u5173\u952E\u4EFB\u52A1**\uFF1A\u8BC4\u4F30\u5F53\u524D\u6570\u636E\u662F\u5426\u8DB3\u4EE5\u56DE\u7B54\u7528\u6237\u7684\u4E1A\u52A1\u95EE\u9898\u3002
+
+- **\u5982\u679C\u6570\u636E\u5145\u8DB3**\uFF1A\u660E\u786E\u8BF4\u660E\u5F53\u524D\u6570\u636E\u5982\u4F55\u56DE\u7B54\u4E86\u95EE\u9898\uFF0C\u54EA\u4E9B\u65B9\u9762\u5DF2\u7ECF\u5F97\u5230\u89E3\u7B54
+- **\u5982\u679C\u6570\u636E\u4E0D\u8DB3**\uFF1A\u660E\u786E\u6307\u51FA\uFF1A
+  - \u54EA\u4E9B\u95EE\u9898\u65E0\u6CD5\u4ECE\u5F53\u524D\u6570\u636E\u4E2D\u56DE\u7B54
+  - \u7F3A\u5C11\u54EA\u4E9B\u5173\u952E\u4FE1\u606F\u6216\u7EF4\u5EA6
+  - \u5EFA\u8BAE\u9700\u8981\u67E5\u8BE2\u54EA\u4E9B\u989D\u5916\u7684\u6570\u636E\uFF08\u5177\u4F53\u8BF4\u660E\u9700\u8981\u67E5\u8BE2\u7684\u8868\u3001\u5B57\u6BB5\u3001\u65F6\u95F4\u8303\u56F4\u3001\u7B5B\u9009\u6761\u4EF6\u7B49\uFF09
+  - \u4E3A\u4EC0\u4E48\u8FD9\u4E9B\u989D\u5916\u6570\u636E\u5BF9\u5B8C\u6574\u56DE\u7B54\u95EE\u9898\u81F3\u5173\u91CD\u8981
+
+### 5. \u540E\u7EED\u6570\u636E\u6316\u6398\u5EFA\u8BAE
+
+\u5982\u679C\u6570\u636E\u4E0D\u8DB3\uFF0C\u63D0\u4F9B\u5177\u4F53\u7684\u6570\u636E\u6316\u6398\u5EFA\u8BAE\uFF1A
+
+- **\u9700\u8981\u67E5\u8BE2\u7684\u8868\u548C\u5B57\u6BB5**\uFF1A\u660E\u786E\u6307\u51FA\u9700\u8981\u4ECE\u54EA\u4E9B\u8868\u67E5\u8BE2\u54EA\u4E9B\u5B57\u6BB5
+- **\u65F6\u95F4\u8303\u56F4**\uFF1A\u5982\u679C\u9700\u8981\u5386\u53F2\u5BF9\u6BD4\uFF0C\u5EFA\u8BAE\u67E5\u8BE2\u7684\u65F6\u95F4\u8303\u56F4
+- **\u7EF4\u5EA6\u62C6\u5206**\uFF1A\u5982\u679C\u9700\u8981\u66F4\u7EC6\u7C92\u5EA6\u7684\u5206\u6790\uFF0C\u5EFA\u8BAE\u6309\u54EA\u4E9B\u7EF4\u5EA6\u62C6\u5206\uFF08\u5982\u5730\u533A\u3001\u6E20\u9053\u3001\u4EA7\u54C1\u7C7B\u522B\u7B49\uFF09
+- **\u5173\u8054\u67E5\u8BE2**\uFF1A\u5982\u679C\u9700\u8981\u5173\u8054\u5176\u4ED6\u8868\uFF0C\u8BF4\u660E\u9700\u8981 JOIN \u54EA\u4E9B\u8868\u4EE5\u53CA\u5173\u8054\u6761\u4EF6
+- **\u7B5B\u9009\u6761\u4EF6**\uFF1A\u5982\u679C\u9700\u8981\u7279\u5B9A\u5B50\u96C6\u7684\u6570\u636E\uFF0C\u8BF4\u660E\u7B5B\u9009\u6761\u4EF6
+
+## \u4E1A\u52A1\u4E0A\u4E0B\u6587\u6574\u5408
+
+\u5206\u6790\u7ED3\u679C\u65F6\u8003\u8651\uFF1A
+
+- **\u57FA\u51C6\u5BF9\u6BD4**\uFF1A\u4E0E\u5386\u53F2\u65F6\u671F\u3001\u76EE\u6807\u6216\u884C\u4E1A\u6807\u51C6\u5BF9\u6BD4
+- **\u7EC6\u5206\u5206\u6790**\uFF1A\u8BC6\u522B\u54EA\u4E9B\u7EC6\u5206\uFF08\u5730\u533A\u3001\u6E20\u9053\u3001\u4EA7\u54C1\uFF09\u9A71\u52A8\u4E86\u7ED3\u679C
+- **\u5F02\u5E38\u68C0\u6D4B**\uFF1A\u6807\u8BB0\u9700\u8981\u8C03\u67E5\u7684\u5F02\u5E38\u6A21\u5F0F
+- **\u8D8B\u52BF\u5206\u6790**\uFF1A\u8BC6\u522B\u4E0A\u5347\u3001\u4E0B\u964D\u6216\u7A33\u5B9A\u8D8B\u52BF
+- **\u76F8\u5173\u6027**\uFF1A\u6CE8\u610F\u4E0D\u540C\u6307\u6807\u4E4B\u95F4\u7684\u5173\u7CFB
+
+## \u8F93\u51FA\u7ED3\u6784
+
+\`\`\`markdown
+### \u6570\u636E\u6458\u8981
+
+[\u7528 2-3 \u53E5\u8BDD\u603B\u7ED3\u6570\u636E\u63ED\u793A\u7684\u6838\u5FC3\u4FE1\u606F\uFF0C\u81EA\u7136\u5730\u878D\u5165\u5177\u4F53\u6570\u5B57]
+
+### \u5173\u952E\u53D1\u73B0
+
+[\u7528\u53D9\u8FF0\u6027\u6BB5\u843D\uFF08\u6BCF\u6BB5 2-3 \u53E5\u8BDD\uFF09\u5448\u73B0\u5173\u952E\u53D1\u73B0\uFF0C\u81EA\u7136\u5730\u878D\u5165\u5177\u4F53\u6570\u5B57]
+
+### \u4E1A\u52A1\u6D1E\u5BDF
+
+[\u7528\u53D9\u8FF0\u6027\u6BB5\u843D\u89E3\u91CA\u8FD9\u4E9B\u53D1\u73B0\u610F\u5473\u7740\u4EC0\u4E48\uFF0C\u5C06\u6570\u636E\u70B9\u4E0E\u4E1A\u52A1\u7ED3\u679C\u81EA\u7136\u8FDE\u63A5]
+
+### \u95EE\u9898\u56DE\u7B54\u8BC4\u4F30
+
+**\u5F53\u524D\u6570\u636E\u662F\u5426\u8DB3\u4EE5\u56DE\u7B54\u95EE\u9898\uFF1A** [\u662F/\u90E8\u5206/\u5426]
+
+**\u5DF2\u56DE\u7B54\u7684\u65B9\u9762\uFF1A**
+- [\u8BF4\u660E\u5F53\u524D\u6570\u636E\u5982\u4F55\u56DE\u7B54\u4E86\u95EE\u9898\u7684\u54EA\u4E9B\u65B9\u9762]
+
+**\u672A\u56DE\u7B54\u7684\u65B9\u9762\uFF08\u5982\u679C\u6570\u636E\u4E0D\u8DB3\uFF09\uFF1A**
+- [\u660E\u786E\u6307\u51FA\u54EA\u4E9B\u95EE\u9898\u65E0\u6CD5\u4ECE\u5F53\u524D\u6570\u636E\u4E2D\u56DE\u7B54]
+
+### \u6570\u636E\u6316\u6398\u5EFA\u8BAE\uFF08\u5982\u679C\u6570\u636E\u4E0D\u8DB3\uFF09
+
+**\u9700\u8981\u67E5\u8BE2\u7684\u989D\u5916\u6570\u636E\uFF1A**
+1. **\u67E5\u8BE2\u76EE\u6807**\uFF1A[\u8BF4\u660E\u9700\u8981\u67E5\u8BE2\u4EC0\u4E48\u4FE1\u606F]
+2. **\u5EFA\u8BAE\u7684 SQL \u67E5\u8BE2\u65B9\u5411**\uFF1A
+   - \u8868\uFF1A[\u9700\u8981\u67E5\u8BE2\u7684\u8868\u540D]
+   - \u5B57\u6BB5\uFF1A[\u9700\u8981\u7684\u5B57\u6BB5\u5217\u8868]
+   - \u65F6\u95F4\u8303\u56F4\uFF1A[\u5982\u679C\u9700\u8981\uFF0C\u8BF4\u660E\u65F6\u95F4\u8303\u56F4]
+   - \u7EF4\u5EA6\u62C6\u5206\uFF1A[\u5982\u679C\u9700\u8981\uFF0C\u8BF4\u660E\u6309\u54EA\u4E9B\u7EF4\u5EA6\u62C6\u5206]
+   - \u5173\u8054\u8868\uFF1A[\u5982\u679C\u9700\u8981 JOIN\uFF0C\u8BF4\u660E\u5173\u8054\u7684\u8868\u548C\u6761\u4EF6]
+   - \u7B5B\u9009\u6761\u4EF6\uFF1A[\u5982\u679C\u9700\u8981\uFF0C\u8BF4\u660E\u7B5B\u9009\u6761\u4EF6]
+3. **\u4E3A\u4EC0\u4E48\u9700\u8981\u8FD9\u4E9B\u6570\u636E**\uFF1A[\u89E3\u91CA\u4E3A\u4EC0\u4E48\u8FD9\u4E9B\u6570\u636E\u5BF9\u5B8C\u6574\u56DE\u7B54\u95EE\u9898\u81F3\u5173\u91CD\u8981]
+\`\`\`
+
+## \u6C9F\u901A\u98CE\u683C
+
+- **\u53D9\u8FF0\u6027**\uFF1A\u4EE5\u6545\u4E8B\u5F62\u5F0F\u5448\u73B0\uFF0C\u800C\u975E\u6280\u672F\u62A5\u544A
+- **\u81EA\u7136\u6D41\u7545**\uFF1A\u4F7F\u7528\u591A\u6837\u5316\u7684\u53E5\u5B50\u7ED3\u6784\u548C\u81EA\u7136\u7684\u8FC7\u6E21
+- **\u4E1A\u52A1\u53CB\u597D**\uFF1A\u4F7F\u7528\u4E1A\u52A1\u672F\u8BED\uFF0C\u800C\u975E\u6280\u672F\u884C\u8BDD
+- **\u6570\u636E\u9A71\u52A8**\uFF1A\u81EA\u7136\u5730\u878D\u5165\u5177\u4F53\u6570\u5B57\uFF0C\u800C\u975E\u5355\u72EC\u5217\u51FA\u4E8B\u5B9E
+- **\u5BF9\u8BDD\u5F0F**\uFF1A\u50CF\u5411\u540C\u4E8B\u89E3\u91CA\u4E00\u6837\uFF0C\u800C\u975E\u586B\u5199\u8868\u683C
+- **\u53EF\u6267\u884C**\uFF1A\u805A\u7126\u80FD\u591F\u4E3A\u51B3\u7B56\u63D0\u4F9B\u4FE1\u606F\u7684\u6D1E\u5BDF
+- **\u4E0A\u4E0B\u6587\u76F8\u5173**\uFF1A\u5728\u53D9\u8FF0\u4E2D\u81EA\u7136\u5730\u63D0\u4F9B\u4E1A\u52A1\u4E0A\u4E0B\u6587
+
+## \u7279\u522B\u6CE8\u610F\u4E8B\u9879
+
+- **\u767E\u5206\u6BD4**\uFF1A\u5728\u76F8\u5173\u65F6\u8BA1\u7B97\u5E76\u7A81\u51FA\u767E\u5206\u6BD4\u53D8\u5316
+- **\u5BF9\u6BD4**\uFF1A\u59CB\u7EC8\u63D0\u4F9B\u4E0A\u4E0B\u6587\uFF08\u4E0E\u4E0A\u4E00\u65F6\u671F\u5BF9\u6BD4\u3001\u4E0E\u76EE\u6807\u5BF9\u6BD4\u3001\u4E0E\u5E73\u5747\u503C\u5BF9\u6BD4\uFF09
+- **\u79BB\u7FA4\u503C**\uFF1A\u6807\u8BB0\u5E76\u89E3\u91CA\u4EFB\u4F55\u5F02\u5E38\u6570\u636E\u70B9
+- **\u6570\u636E\u8D28\u91CF**\uFF1A\u6CE8\u610F\u4EFB\u4F55\u6570\u636E\u9650\u5236\u6216\u6CE8\u610F\u4E8B\u9879
+- **\u7F6E\u4FE1\u5EA6**\uFF1A\u5F53\u53D1\u73B0\u5177\u6709\u7EDF\u8BA1\u663E\u8457\u6027\u6216\u4EC5\u4E3A\u521D\u6B65\u7ED3\u679C\u65F6\uFF0C\u660E\u786E\u8BF4\u660E
+
+\u8BB0\u4F4F\uFF1A\u4F60\u7684\u5206\u6790\u5C06\u539F\u59CB\u67E5\u8BE2\u7ED3\u679C\u8F6C\u5316\u4E3A\u6709\u610F\u4E49\u7684\u4E1A\u52A1\u6D1E\u5BDF\u3002\u8BC4\u4F30\u6570\u636E\u662F\u5426\u8DB3\u4EE5\u56DE\u7B54\u95EE\u9898\uFF0C\u5982\u679C\u4E0D\u8DB3\uFF0C\u63D0\u4F9B\u5177\u4F53\u7684\u6570\u636E\u6316\u6398\u5EFA\u8BAE\uFF0C\u5E2E\u52A9\u83B7\u53D6\u5B8C\u6574\u7B54\u6848\u6240\u9700\u7684\u4FE1\u606F\u3002
 `;
 var data_agents = [
   {
     key: "data_agent",
     name: "Data Agent",
-    description: "An intelligent NL2SQL agent that converts natural language questions into SQL queries and retrieves data from databases. Use this agent for data analysis tasks, database queries, and data exploration.",
+    description: "An intelligent Business Data Analyst agent that converts natural language questions into SQL queries, performs multi-step business analysis, and generates comprehensive business reports. Capabilities include: task decomposition, metric analysis, dimension breakdowns, anomaly detection, and structured report generation with executive summaries, analysis steps, and visualizations. Use this agent for business intelligence, data analysis, database queries, and generating actionable business insights.",
     type: import_core2.AgentType.DEEP_AGENT,
-    tools: ["list_tables_sql", "info_sql", "query_sql", "query_checker_sql"],
+    tools: ["list_tables_sql", "info_sql"],
     prompt: dataAgentPrompt,
     subAgents: ["sql-builder-agent", "data-analysis-agent"],
+    skillCategories: ["analysis", "sql"],
     schema: import_zod2.default.object({}),
     /**
      * Runtime configuration injected into tool execution context.
@@ -365,17 +556,17 @@ var data_agents = [
   {
     key: "sql-builder-agent",
     name: "sql-builder-agent",
-    type: import_core2.AgentType.REACT,
-    description: "A specialized sub-agent for building and validating SQL queries. Give this agent schema information and a data question, and it will return an optimized SQL query.",
+    type: import_core2.AgentType.DEEP_AGENT,
+    description: "A specialized sub-agent for database exploration, SQL query generation, validation, and execution. This agent handles all SQL-related operations including listing tables, exploring schemas, generating queries, validating them, executing them, and returning both the SQL and query results to the data_agent.",
     prompt: sqlBuilderPrompt,
-    tools: ["info_sql", "query_checker_sql"]
+    tools: ["list_tables_sql", "info_sql", "query_checker_sql", "query_sql"]
     // Sub-agents inherit runConfig from parent agent via the execution context
   },
   {
     key: "data-analysis-agent",
     name: "data-analysis-agent",
-    type: import_core2.AgentType.REACT,
-    description: "A specialized sub-agent for analyzing query results and providing insights. Give this agent query results and it will provide a structured analysis.",
+    type: import_core2.AgentType.DEEP_AGENT,
+    description: "A specialized sub-agent for analyzing query results and extracting business insights. This agent interprets data, identifies patterns and anomalies, provides business context, and structures findings for comprehensive reports. Give this agent query results and it will provide structured business analysis with key findings, insights, and visualization recommendations.",
     prompt: dataAnalysisPrompt,
     tools: []
   }
@@ -390,8 +581,240 @@ initializeDataAgentDatabase("fulidb", {
   database: "postgres"
 });
 
+// src/agents/inventory_doctor/index.ts
+var import_core4 = require("@axiom-lattice/core");
+var import_zod4 = __toESM(require("zod"));
+
+// src/agents/inventory_doctor/tools.ts
+var import_zod3 = __toESM(require("zod"));
+var import_core3 = require("@axiom-lattice/core");
+(0, import_core3.registerToolLattice)(
+  "get_wms_movement_tasks",
+  {
+    name: "get_wms_movement_tasks",
+    description: "Retrieve in-flight movement tasks (putaway/move/wave) for a specific SKU and location. Use this to check for tasks in middle states that might cause inventory discrepancies.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({
+      skuId: import_zod3.default.string().describe("SKU identifier"),
+      locationId: import_zod3.default.string().describe("Location identifier")
+    })
+  },
+  async (input) => {
+    const taskTypes = ["putaway", "move", "wave", "replenishment"];
+    const statuses = ["in_progress", "pending", "queued", "processing"];
+    const hasPendingTasks = Math.random() > 0.3;
+    const taskCount = hasPendingTasks ? Math.floor(Math.random() * 3) + 1 : 0;
+    const tasks = Array.from({ length: taskCount }, (_, i) => ({
+      id: `move-${Math.floor(Math.random() * 9e3) + 1e3}`,
+      type: taskTypes[Math.floor(Math.random() * taskTypes.length)],
+      status: statuses[Math.floor(Math.random() * statuses.length)],
+      etaMin: Math.floor(Math.random() * 60) + 5
+      // 5-65 minutes
+    }));
+    return {
+      pending: hasPendingTasks,
+      tasks
+    };
+  }
+);
+(0, import_core3.registerToolLattice)(
+  "get_location_logs",
+  {
+    name: "get_location_logs",
+    description: "Retrieve activity logs for a location within a specified lookback period. Use this to identify unconfirmed moves, cancellations, or other activities that might explain inventory discrepancies.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({
+      locationId: import_zod3.default.string().describe("Location identifier"),
+      lookbackHours: import_zod3.default.number().describe("Number of hours to look back")
+    })
+  },
+  async (input) => {
+    const actions = ["move", "putaway", "pick", "adjustment", "cycle_count"];
+    const statuses = [
+      "pending_confirm",
+      "completed",
+      "cancelled",
+      "in_progress",
+      "failed"
+    ];
+    const operators = [
+      "op_x",
+      "op_y",
+      "op_z",
+      "worker_01",
+      "worker_05",
+      "worker_12"
+    ];
+    const locations = ["A-01", "A-02", "B-01", "B-02", "C-03", "D-05"];
+    const logCount = Math.floor(Math.random() * 5) + 1;
+    const now = /* @__PURE__ */ new Date();
+    const logs = Array.from({ length: logCount }, (_, i) => {
+      const hoursAgo = Math.floor(Math.random() * input.lookbackHours);
+      const timestamp = new Date(now.getTime() - hoursAgo * 60 * 60 * 1e3);
+      const fromLoc = locations[Math.floor(Math.random() * locations.length)];
+      const toLoc = locations[Math.floor(Math.random() * locations.length)];
+      return {
+        ts: timestamp.toISOString(),
+        action: actions[Math.floor(Math.random() * actions.length)],
+        from: fromLoc,
+        to: toLoc !== fromLoc ? toLoc : locations[Math.floor(Math.random() * locations.length)],
+        status: statuses[Math.floor(Math.random() * statuses.length)],
+        operator: operators[Math.floor(Math.random() * operators.length)]
+      };
+    });
+    logs.sort((a, b) => new Date(b.ts).getTime() - new Date(a.ts).getTime());
+    return logs;
+  }
+);
+(0, import_core3.registerToolLattice)(
+  "retry_sync",
+  {
+    name: "retry_sync",
+    description: "Retry synchronization for a task that appears to be stuck in a middle state. This will attempt to refresh the task status and resolve data delays.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({
+      taskId: import_zod3.default.string().describe("Task identifier to retry")
+    })
+  },
+  async (input) => {
+    const fixed = Math.random() > 0.2;
+    const messages = [
+      "status refreshed to completed",
+      "task synchronized successfully",
+      "sync completed, inventory updated",
+      "task status updated to completed",
+      "synchronization failed, task still in progress",
+      "unable to sync, task may require manual intervention"
+    ];
+    return {
+      fixed,
+      message: fixed ? messages[Math.floor(Math.random() * 4)] : messages[Math.floor(Math.random() * 2) + 4]
+    };
+  }
+);
+(0, import_core3.registerToolLattice)(
+  "dispatch_cycle_count",
+  {
+    name: "dispatch_cycle_count",
+    description: "Dispatch a cycle count task to physically verify inventory at specified locations. Use this when physical verification is needed to resolve inventory discrepancies.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({
+      skuId: import_zod3.default.string().describe("SKU identifier to verify"),
+      locations: import_zod3.default.array(import_zod3.default.string()).describe("List of location identifiers to check"),
+      priority: import_zod3.default.string().describe("Priority level (e.g., 'high', 'medium', 'low')")
+    })
+  },
+  async (input) => {
+    const workers = [
+      "worker_01",
+      "worker_05",
+      "worker_07",
+      "worker_12",
+      "worker_15",
+      "worker_20"
+    ];
+    const taskId = `cc-${Math.floor(Math.random() * 9e3) + 1e3}`;
+    const assignee = workers[Math.floor(Math.random() * workers.length)];
+    const etaMinutes = Math.floor(Math.random() * 30) + 5;
+    const eta = `${etaMinutes}m`;
+    return {
+      taskId,
+      assignee,
+      eta
+    };
+  }
+);
+(0, import_core3.registerToolLattice)(
+  "notify_picker",
+  {
+    name: "notify_picker",
+    description: "Send a notification message to the picker about inventory status, retry instructions, or other relevant information.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({
+      message: import_zod3.default.string().describe("Message to send to the picker")
+    })
+  },
+  async (input) => {
+    const delivered = Math.random() > 0.1;
+    return {
+      delivered
+    };
+  }
+);
+(0, import_core3.registerToolLattice)(
+  "write_case_report",
+  {
+    name: "write_case_report",
+    description: "Save the diagnostic case report as a markdown file. Use this to record the diagnosis, actions taken, and recommendations for audit purposes.",
+    needUserApprove: false,
+    schema: import_zod3.default.object({
+      markdown: import_zod3.default.string().describe("Markdown content of the case report")
+    })
+  },
+  async (input) => {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, -5);
+    const reportId = Math.floor(Math.random() * 1e4);
+    const paths = [
+      `/reports/inventory-case-latest.md`,
+      `/reports/inventory-case-${reportId}.md`,
+      `/reports/case-${timestamp}.md`,
+      `/reports/inventory-diagnosis-${reportId}.md`
+    ];
+    return {
+      saved: true,
+      path: paths[Math.floor(Math.random() * paths.length)]
+    };
+  }
+);
+
+// src/agents/inventory_doctor/index.ts
+var inventoryDoctorPrompt = `You are the Inventory Doctor Agent handling WMS pick-shortage incidents.
+
+## Mission
+- Scenario: System shows stock=5 for SKU A, picker finds 0 at location.
+- Follow Think-Act-Observe loops to diagnose and either auto-fix or dispatch physical verification.
+
+
+## Workflow
+1) Trigger: on Pick Shortage, freeze concurrent changes for the SKU/location.
+2) Data Retrieval & Triage:
+   - Check in-flight tasks (putaway/move/wave) for middle states or delays.
+   - Pull last 24h location logs; highlight unconfirmed moves or cancellations.
+   - Form hypotheses: data delay, stuck middleware, physical misplacement.
+3) Reasoning & Execution:
+   - Branch A Auto-fix: if middle-state, call retry_sync then notify picker to retry.
+   - Branch B Physical verify: push a cycle-count task to nearby operator; include candidate locations (B/C) for misplaced stock.
+   - Record every action in the report body for auditability.
+4) Reporting: return a concise Markdown case report with diagnosis, actions taken, residual risk, and training/monitoring suggestions.
+
+## Output format
+Use Markdown sections: \u8BCA\u65AD\u6982\u89C8 / \u5173\u952E\u53D1\u73B0 / \u5904\u7F6E\u52A8\u4F5C / \u540E\u7EED\u5EFA\u8BAE. Keep facts first, then recommendations.`;
+var inventoryDoctorAgent = {
+  key: "inventory_doctor_agent",
+  name: "Inventory Doctor Agent",
+  description: "Diagnoses pick-shortage inventory anomalies in WMS, auto-fixes data middle states, or dispatches cycle counts for physical verification, and returns an audit-friendly report.",
+  type: import_core4.AgentType.DEEP_AGENT,
+  prompt: inventoryDoctorPrompt,
+  tools: [
+    "get_wms_movement_tasks",
+    "get_location_logs",
+    "retry_sync",
+    "dispatch_cycle_count",
+    "notify_picker",
+    "write_case_report"
+  ],
+  schema: import_zod4.default.object({
+    skuId: import_zod4.default.string().optional(),
+    locationId: import_zod4.default.string().optional(),
+    incidentId: import_zod4.default.string().optional()
+  })
+};
+(0, import_core4.registerAgentLattices)([inventoryDoctorAgent]);
+
 // src/index.ts
 var import_path = __toESM(require("path"));
+var import_protocols = require("@axiom-lattice/protocols");
+var fs = require("fs");
 var PACKAGE_VERSION = require_package().version;
 var BUILD_TIME = (/* @__PURE__ */ new Date()).toISOString();
 var IS_DEV = process.env.NODE_ENV !== "production";
@@ -427,7 +850,7 @@ function parsePort() {
   }
   return 4001;
 }
-(0, import_core3.registerModelLattice)(
+(0, import_core5.registerModelLattice)(
   "default",
   // {
   //   model: "deepseek-chat",
@@ -467,10 +890,72 @@ function parsePort() {
   // }
 );
 import_gateway.LatticeGateway.registerLatticeRoutes(import_gateway.LatticeGateway.app);
+var possiblePaths = [
+  // Production: from dist/ go up to src/
+  import_path.default.resolve(__dirname, "../src/agents/data_agent/skills"),
+  // Development: relative to __dirname (src/)
+  import_path.default.resolve(__dirname, "./agents/data_agent/skills"),
+  // Fallback: from project root
+  import_path.default.resolve(process.cwd(), "examples/deep_research/src/agents/data_agent/skills")
+];
+var skillsRootDir = possiblePaths[0];
+for (const possiblePath of possiblePaths) {
+  if (fs.existsSync(possiblePath)) {
+    skillsRootDir = possiblePath;
+    break;
+  }
+}
+if (!fs.existsSync(skillsRootDir)) {
+  console.warn(
+    `Warning: Skills directory not found at any of the expected paths. Using: ${skillsRootDir}`
+  );
+}
+console.log(`Skill store root directory: ${skillsRootDir}`);
+var skillStore = new import_core5.FileSystemSkillStore({
+  rootDir: skillsRootDir
+});
+import_core5.storeLatticeManager.removeLattice("default", "skill");
+(0, import_core5.registerStoreLattice)("default", "skill", skillStore);
+import_core5.skillLatticeManager.configureStore("default");
+(async () => {
+  try {
+    const skills = await skillStore.getAllSkills();
+    console.log(`Loaded ${skills.length} skills from file system:`);
+    if (skills.length === 0) {
+      console.warn(
+        `Warning: No skills found. Please check if the directory exists: ${skillsRootDir}`
+      );
+    } else {
+      skills.forEach((skill) => {
+        console.log(`  - ${skill.name}: ${skill.description.substring(0, 50)}...`);
+      });
+    }
+  } catch (error) {
+    console.error("Failed to load skills on startup:", error);
+    if (error instanceof Error) {
+      console.error("Error details:", error.message);
+      console.error("Stack:", error.stack);
+    }
+  }
+})();
 var port = parsePort();
 console.log(`Starting server on port ${port}`);
+var DEFAULT_LOGGER_CONFIG = {
+  name: "default",
+  description: "Default logger for lattice-gateway service",
+  type: import_protocols.LoggerType.PINO,
+  serviceName: "lattice/deep_research",
+  loggerName: "lattice/deep_research"
+  // file: {
+  //   file: "./logs/lattice" + "/deep_research",
+  //   frequency: "daily",
+  //   mkdir: true,
+  //   maxFiles: 30,
+  // },
+};
 import_gateway.LatticeGateway.startAsHttpEndpoint({
   port,
-  queueServiceConfig: { type: "memory", defaultStartPollingQueue: true }
+  queueServiceConfig: { type: "memory", defaultStartPollingQueue: true },
+  loggerConfig: DEFAULT_LOGGER_CONFIG
 });
 //# sourceMappingURL=index.js.map