@axiom-lattice/examples-deep_research 1.0.10 → 1.0.11

package/.env

@@ -25,7 +25,7 @@ SILICONCLOUD_API_KEY=sk-omhkuwebiotihbmgthgrcrzzneundgkeqmfrxnkzeldohpfi
 
 VOLCENGINE_API_KEY=3c11b06b-3d48-4cce-a1c7-d9e0f5fab80c
 VOLCENGINE_API_KEY2=a0533576-d6ed-4ca4-a308-473cbf7ebd10
-
+KIMI_API_KEY=sk-9FlkLQyuBD5ULCEGFMFgnqHA5TtV0gYPTYkfBOWAarsaWzaq
 
 TAVILY_API_KEY=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
 
@@ -34,7 +34,7 @@ QUEUE_NAME=simon_tasks
 REDIS_URL=redis://localhost:6379
 REDIS_PASSWORD=fina
 
-LANGSMITH_TRACING=true
-LANGSMITH_ENDPOINT="https://api.smith.langchain.com"
-LANGSMITH_API_KEY="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"
-LANGSMITH_PROJECT="fina"
+# LANGSMITH_TRACING=true
+# LANGSMITH_ENDPOINT="https://api.smith.langchain.com"
+# LANGSMITH_API_KEY="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"
+# LANGSMITH_PROJECT="fina"

package/.turbo/turbo-build.log

@@ -1,16 +1,17 @@
 
-> @axiom-lattice/examples-deep_research@1.0.10 build /home/runner/work/agentic/agentic/examples/deep_research
-> tsup src/index.ts --format cjs --dts --clean --sourcemap
+> @axiom-lattice/examples-deep_research@1.0.11 build /home/runner/work/agentic/agentic/examples/deep_research
+> tsup
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
+CLI Using tsup config: /home/runner/work/agentic/agentic/examples/deep_research/tsup.config.ts
 CLI Target: es2020
 CLI Cleaning output folder
 CJS Build start
-CJS dist/index.js     10.27 KB
-CJS dist/index.js.map 11.03 KB
-CJS ⚡️ Build success in 60ms
+CJS dist/index.js     11.45 KB
+CJS dist/index.js.map 13.13 KB
+CJS ⚡️ Build success in 35ms
 DTS Build start
-DTS ⚡️ Build success in 4860ms
+DTS ⚡️ Build success in 4590ms
 DTS dist/index.d.ts 13.00 B

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @axiom-lattice/examples-deep_research
+
+## 1.0.11
+
+### Patch Changes
+
+- 97a1c7c: publish examples

package/dist/index.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -29,6 +30,7 @@ var import_core2 = require("@axiom-lattice/core");
 
 // src/agents/research/index.ts
 var import_core = require("@axiom-lattice/core");
+var import_zod = __toESM(require("zod"));
 var subResearchPrompt = `You are a dedicated researcher. Your job is to conduct research based on the users questions.
 
 Conduct thorough research and then reply to the user with a detailed answer to their question
@@ -166,7 +168,10 @@ var research_agents = [
     type: import_core.AgentType.DEEP_AGENT,
     tools: ["internet_search"],
     prompt: researchInstructions,
-    subAgents: ["critique-agent", "research-agent"]
+    subAgents: ["critique-agent", "research-agent"],
+    schema: import_zod.default.object({
+      test: import_zod.default.string().optional()
+    })
   }
 ];
 (0, import_core.registerAgentLattices)(research_agents);
@@ -174,6 +179,29 @@ var research_agents = [
 // src/index.ts
 var import_path = __toESM(require("path"));
 import_dotenv.default.config({ path: import_path.default.resolve(__dirname, "../.env") });
+function parsePort() {
+  const args = process.argv.slice(2);
+  const portIndex = args.findIndex((arg) => arg === "--port" || arg === "-p");
+  if (portIndex !== -1 && args[portIndex + 1]) {
+    const port2 = parseInt(args[portIndex + 1], 10);
+    if (!isNaN(port2) && port2 > 0 && port2 < 65536) {
+      return port2;
+    }
+    console.warn(
+      `Invalid port value: ${args[portIndex + 1]}, using default port 4001`
+    );
+  }
+  if (process.env.PORT) {
+    const port2 = parseInt(process.env.PORT, 10);
+    if (!isNaN(port2) && port2 > 0 && port2 < 65536) {
+      return port2;
+    }
+    console.warn(
+      `Invalid PORT environment variable: ${process.env.PORT}, using default port 4001`
+    );
+  }
+  return 4001;
+}
 (0, import_core2.registerModelLattice)(
   "default",
   // {
@@ -193,12 +221,19 @@ import_dotenv.default.config({ path: import_path.default.resolve(__dirname, "../
   //   streaming: false,
   // },
   {
-    model: "kimi-k2-250711",
+    model: "kimi-k2-250905",
     provider: "volcengine",
     streaming: true,
     apiKeyEnvName: "VOLCENGINE_API_KEY2"
   }
   // {
+  //   model: "kimi-k2-0711-preview",
+  //   provider: "openai",
+  //   streaming: true,
+  //   apiKeyEnvName: "KIMI_API_KEY",
+  //   baseURL: "https://api.moonshot.cn/v1",
+  // }
+  // {
   //   model: "qwen-plus",
   //   provider: "openai",
   //   streaming: false,
@@ -207,5 +242,10 @@ import_dotenv.default.config({ path: import_path.default.resolve(__dirname, "../
   // }
 );
 import_gateway.LatticeGateway.registerLatticeRoutes(import_gateway.LatticeGateway.app);
-import_gateway.LatticeGateway.startAsHttpEndpoint({ port: 4001 });
+var port = parsePort();
+console.log(`Starting server on port ${port}`);
+import_gateway.LatticeGateway.startAsHttpEndpoint({
+  port,
+  queueServiceConfig: { type: "memory", defaultStartPollingQueue: true }
+});
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/agents/research/index.ts"],"sourcesContent":["import dotenv from \"dotenv\";\n\nimport { LatticeGateway } from \"@axiom-lattice/gateway\";\nimport {\n  registerCheckpointSaver,\n  registerModelLattice,\n} from \"@axiom-lattice/core\";\nimport \"./agents\";\nimport path from \"path\";\n\n// 加载环境变量\ndotenv.config({ path: path.resolve(__dirname, \"../.env\") });\n\n// 注册默认模型Lattice\nregisterModelLattice(\n  \"default\",\n  // {\n  //   model: \"deepseek-chat\",\n  //   provider: \"deepseek\",\n  //   streaming: false,\n  // }\n  // {\n  //   model: \"deepseek-chat\",\n  //   provider: \"deepseek\",\n  //   streaming: false,\n  //   apiKeyEnvName: \"DEEPSEEK_API_KEY2\",\n  // },\n  // {\n  //   model: \"deepseek-v3-250324\",\n  //   provider: \"volcengine\",\n  //   streaming: false,\n  // },\n  {\n    model: \"kimi-k2-250711\",\n    provider: \"volcengine\",\n    streaming: true,\n    apiKeyEnvName: \"VOLCENGINE_API_KEY2\",\n  }\n  // {\n  //   model: \"qwen-plus\",\n  //   provider: \"openai\",\n  //   streaming: false,\n  //   apiKeyEnvName: \"DASHSCOPE_API_KEY\",\n  //   baseURL: \"https://dashscope.aliyuncs.com/compatible-mode/v1\",\n  // }\n);\n\nLatticeGateway.registerLatticeRoutes(LatticeGateway.app);\n\nLatticeGateway.startAsHttpEndpoint({ port: 4001 });\n","/* eslint-disable no-console */\n\nimport {\n  registerAgentLattices,\n  AgentType,\n  AgentConfig,\n} from \"@axiom-lattice/core\";\n\nconst subResearchPrompt = `You are a dedicated researcher. Your job is to conduct research based on the users questions.\n\nConduct thorough research and then reply to the user with a detailed answer to their question\n\nonly your FINAL answer will be passed on to the user. They will have NO knowledge of anything except your final message, so your final report should be your final message!`;\n\nconst subCritiquePrompt = `You are a dedicated editor. You are being tasked to critique a report.\n\nYou can find the report at \\`final_report.md\\`.\n\nYou can find the question/topic for this report at \\`question.txt\\`.\n\nThe user may ask for specific areas to critique the report in. Respond to the user with a detailed critique of the report. Things that could be improved.\n\nYou can use the search tool to search for information, if that will help you critique the report\n\nDo not write to the \\`final_report.md\\` yourself.\n\nThings to check:\n- Check that each section is appropriately named\n- Check that the report is written as you would find in an essay or a textbook - it should be text heavy, do not let it just be a list of bullet points!\n- Check that the report is comprehensive. If any paragraphs or sections are short, or missing important details, point it out.\n- Check that the article covers key areas of the industry, ensures overall understanding, and does not omit important parts.\n- Check that the article deeply analyzes causes, impacts, and trends, providing valuable insights\n- Check that the article closely follows the research topic and directly answers questions\n- Check that the article has a clear structure, fluent language, and is easy to understand.\n`;\n\n// Prompt prefix to steer the agent to be an expert researcher\nconst researchInstructions = `You are an expert researcher. Your job is to conduct thorough research, and then write a polished report.\n\nThe first thing you should do is to write the original user question to \\`question.txt\\` so you have a record of it.\n\nUse the research-agent to conduct deep research. It will respond to your questions/topics with a detailed answer.\n\nWhen you think you enough information to write a final report, write it to \\`final_report.md\\`\n\nYou can call the critique-agent to get a critique of the final report. After that (if needed) you can do more research and edit the \\`final_report.md\\`\nYou can do this however many times you want until are you satisfied with the result.\n\nOnly edit the file once at a time (if you call this tool in parallel, there may be conflicts).\n\nHere are instructions for writing the final report:\n\n<report_instructions>\n\nCRITICAL: Make sure the answer is written in the same language as the human messages! If you make a todo plan - you should note in the plan what language the report should be in so you dont forget!\nNote: the language the report should be in is the language the QUESTION is in, not the language/country that the question is ABOUT.\n\nPlease create a detailed answer to the overall research brief that:\n1. Is well-organized with proper headings (# for title, ## for sections, ### for subsections)\n2. Includes specific facts and insights from the research\n3. References relevant sources using [Title](URL) format\n4. Provides a balanced, thorough analysis. Be as comprehensive as possible, and include all information that is relevant to the overall research question. People are using you for deep research and will expect detailed, comprehensive answers.\n5. Includes a \"Sources\" section at the end with all referenced links\n\nYou can structure your report in a number of different ways. Here are some examples:\n\nTo answer a question that asks you to compare two things, you might structure your report like this:\n1/ intro\n2/ overview of topic A\n3/ overview of topic B\n4/ comparison between A and B\n5/ conclusion\n\nTo answer a question that asks you to return a list of things, you might only need a single section which is the entire list.\n1/ list of things or table of things\nOr, you could choose to make each item in the list a separate section in the report. When asked for lists, you don't need an introduction or conclusion.\n1/ item 1\n2/ item 2\n3/ item 3\n\nTo answer a question that asks you to summarize a topic, give a report, or give an overview, you might structure your report like this:\n1/ overview of topic\n2/ concept 1\n3/ concept 2\n4/ concept 3\n5/ conclusion\n\nIf you think you can answer the question with a single section, you can do that too!\n1/ answer\n\nREMEMBER: Section is a VERY fluid and loose concept. You can structure your report however you think is best, including in ways that are not listed above!\nMake sure that your sections are cohesive, and make sense for the reader.\n\nFor each section of the report, do the following:\n- Use simple, clear language\n- Use ## for section title (Markdown format) for each section of the report\n- Do NOT ever refer to yourself as the writer of the report. This should be a professional report without any self-referential language.\n- Do not say what you are doing in the report. Just write the report without any commentary from yourself.\n- Each section should be as long as necessary to deeply answer the question with the information you have gathered. It is expected that sections will be fairly long and verbose. You are writing a deep research report, and users will expect a thorough answer.\n- Use bullet points to list out information when appropriate, but by default, write in paragraph form.\n\nREMEMBER:\nThe brief and research may be in English, but you need to translate this information to the right language when writing the final answer.\nMake sure the final answer report is in the SAME language as the human messages in the message history.\n\nFormat the report in clear markdown with proper structure and include source references where appropriate.\n\n<Citation Rules>\n- Assign each unique URL a single citation number in your text\n- End with ### Sources that lists each source with corresponding numbers\n- IMPORTANT: Number sources sequentially without gaps (1,2,3,4...) in the final list regardless of which sources you choose\n- Each source should be a separate line item in a list, so that in markdown it is rendered as a list.\n- Example format:\n  [1] Source Title: URL\n  [2] Source Title: URL\n- Citations are extremely important. Make sure to include these, and pay a lot of attention to getting these right. Users will often use these citations to look into more information.\n</Citation Rules>\n</report_instructions>\n\nYou have access to a few tools.\n\n## \\`internet_search\\`\n\nUse this to run an internet search for a given query. You can specify the number of results, the topic, and whether raw content should be included.\n`;\n\nconst research_agents: AgentConfig[] = [\n  {\n    key: \"research-agent\",\n    name: \"research-agent\",\n    type: AgentType.REACT,\n    description:\n      \"Used to research more in depth questions. Only give this researcher one topic at a time. Do not pass multiple sub questions to this researcher. Instead, you should break down a large topic into the necessary components, and then call multiple research agents in parallel, one for each sub question.\",\n    prompt: subResearchPrompt,\n    tools: [\"internet_search\"],\n  },\n  {\n    key: \"critique-agent\",\n    name: \"critique-agent\",\n    type: AgentType.REACT,\n    description:\n      \"Used to critique the final report. Give this agent some infomration about how you want it to critique the report.\",\n    prompt: subCritiquePrompt,\n  },\n  {\n    key: \"main\",\n    name: \"deep_research_agent\",\n    description:\n      \"Used to research more in depth questions. Only give this researcher one topic at a time. Do not pass multiple sub questions to this researcher. Instead, you should break down a large topic into the necessary components, and then call multiple research agents in parallel, one for each sub question.\",\n    type: AgentType.DEEP_AGENT,\n    tools: [\"internet_search\"],\n    prompt: researchInstructions,\n    subAgents: [\"critique-agent\", \"research-agent\"],\n  },\n];\n\nregisterAgentLattices(research_agents);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,oBAAmB;AAEnB,qBAA+B;AAC/B,IAAAA,eAGO;;;ACJP,kBAIO;AAEP,IAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAM1B,IAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuB1B,IAAM,uBAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAyF7B,IAAM,kBAAiC;AAAA,EACrC;AAAA,IACE,KAAK;AAAA,IACL,MAAM;AAAA,IACN,MAAM,sBAAU;AAAA,IAChB,aACE;AAAA,IACF,QAAQ;AAAA,IACR,OAAO,CAAC,iBAAiB;AAAA,EAC3B;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,MAAM;AAAA,IACN,MAAM,sBAAU;AAAA,IAChB,aACE;AAAA,IACF,QAAQ;AAAA,EACV;AAAA,EACA;AAAA,IACE,KAAK;AAAA,IACL,MAAM;AAAA,IACN,aACE;AAAA,IACF,MAAM,sBAAU;AAAA,IAChB,OAAO,CAAC,iBAAiB;AAAA,IACzB,QAAQ;AAAA,IACR,WAAW,CAAC,kBAAkB,gBAAgB;AAAA,EAChD;AACF;AAAA,IAEA,mCAAsB,eAAe;;;ADpJrC,kBAAiB;AAGjB,cAAAC,QAAO,OAAO,EAAE,MAAM,YAAAC,QAAK,QAAQ,WAAW,SAAS,EAAE,CAAC;AAAA,IAG1D;AAAA,EACE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA;AAAA,IACE,OAAO;AAAA,IACP,UAAU;AAAA,IACV,WAAW;AAAA,IACX,eAAe;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQF;AAEA,8BAAe,sBAAsB,8BAAe,GAAG;AAEvD,8BAAe,oBAAoB,EAAE,MAAM,KAAK,CAAC;","names":["import_core","dotenv","path"]}
+{"version":3,"sources":["../src/index.ts","../src/agents/research/index.ts"],"sourcesContent":["import dotenv from \"dotenv\";\n\nimport { LatticeGateway } from \"@axiom-lattice/gateway\";\nimport {\n  registerCheckpointSaver,\n  registerModelLattice,\n} from \"@axiom-lattice/core\";\nimport \"./agents\";\nimport path from \"path\";\n\n// Load environment variables\ndotenv.config({ path: path.resolve(__dirname, \"../.env\") });\n\n// Parse command line arguments for port configuration\nfunction parsePort(): number {\n  const args = process.argv.slice(2);\n  const portIndex = args.findIndex((arg) => arg === \"--port\" || arg === \"-p\");\n\n  if (portIndex !== -1 && args[portIndex + 1]) {\n    const port = parseInt(args[portIndex + 1], 10);\n    if (!isNaN(port) && port > 0 && port < 65536) {\n      return port;\n    }\n    console.warn(\n      `Invalid port value: ${args[portIndex + 1]}, using default port 4001`\n    );\n  }\n\n  // Check environment variable\n  if (process.env.PORT) {\n    const port = parseInt(process.env.PORT, 10);\n    if (!isNaN(port) && port > 0 && port < 65536) {\n      return port;\n    }\n    console.warn(\n      `Invalid PORT environment variable: ${process.env.PORT}, using default port 4001`\n    );\n  }\n\n  // Default port\n  return 4001;\n}\n\n// Register default model Lattice\nregisterModelLattice(\n  \"default\",\n  // {\n  //   model: \"deepseek-chat\",\n  //   provider: \"deepseek\",\n  //   streaming: false,\n  // }\n  // {\n  //   model: \"deepseek-chat\",\n  //   provider: \"deepseek\",\n  //   streaming: false,\n  //   apiKeyEnvName: \"DEEPSEEK_API_KEY2\",\n  // },\n  // {\n  //   model: \"deepseek-v3-250324\",\n  //   provider: \"volcengine\",\n  //   streaming: false,\n  // },\n  {\n    model: \"kimi-k2-250905\",\n    provider: \"volcengine\",\n    streaming: true,\n    apiKeyEnvName: \"VOLCENGINE_API_KEY2\",\n  }\n  // {\n  //   model: \"kimi-k2-0711-preview\",\n  //   provider: \"openai\",\n  //   streaming: true,\n  //   apiKeyEnvName: \"KIMI_API_KEY\",\n  //   baseURL: \"https://api.moonshot.cn/v1\",\n  // }\n  // {\n  //   model: \"qwen-plus\",\n  //   provider: \"openai\",\n  //   streaming: false,\n  //   apiKeyEnvName: \"DASHSCOPE_API_KEY\",\n  //   baseURL: \"https://dashscope.aliyuncs.com/compatible-mode/v1\",\n  // }\n);\nLatticeGateway.registerLatticeRoutes(LatticeGateway.app);\n\nconst port = parsePort();\nconsole.log(`Starting server on port ${port}`);\n\nLatticeGateway.startAsHttpEndpoint({\n  port,\n  queueServiceConfig: { type: \"memory\", defaultStartPollingQueue: true },\n});\n","/* eslint-disable no-console */\n\nimport {\n  registerAgentLattices,\n  AgentType,\n  AgentConfig,\n} from \"@axiom-lattice/core\";\nimport z from \"zod\";\n\nconst subResearchPrompt = `You are a dedicated researcher. Your job is to conduct research based on the users questions.\n\nConduct thorough research and then reply to the user with a detailed answer to their question\n\nonly your FINAL answer will be passed on to the user. They will have NO knowledge of anything except your final message, so your final report should be your final message!`;\n\nconst subCritiquePrompt = `You are a dedicated editor. You are being tasked to critique a report.\n\nYou can find the report at \\`final_report.md\\`.\n\nYou can find the question/topic for this report at \\`question.txt\\`.\n\nThe user may ask for specific areas to critique the report in. Respond to the user with a detailed critique of the report. Things that could be improved.\n\nYou can use the search tool to search for information, if that will help you critique the report\n\nDo not write to the \\`final_report.md\\` yourself.\n\nThings to check:\n- Check that each section is appropriately named\n- Check that the report is written as you would find in an essay or a textbook - it should be text heavy, do not let it just be a list of bullet points!\n- Check that the report is comprehensive. If any paragraphs or sections are short, or missing important details, point it out.\n- Check that the article covers key areas of the industry, ensures overall understanding, and does not omit important parts.\n- Check that the article deeply analyzes causes, impacts, and trends, providing valuable insights\n- Check that the article closely follows the research topic and directly answers questions\n- Check that the article has a clear structure, fluent language, and is easy to understand.\n`;\n\n// Prompt prefix to steer the agent to be an expert researcher\nconst researchInstructions = `You are an expert researcher. Your job is to conduct thorough research, and then write a polished report.\n\nThe first thing you should do is to write the original user question to \\`question.txt\\` so you have a record of it.\n\nUse the research-agent to conduct deep research. It will respond to your questions/topics with a detailed answer.\n\nWhen you think you enough information to write a final report, write it to \\`final_report.md\\`\n\nYou can call the critique-agent to get a critique of the final report. After that (if needed) you can do more research and edit the \\`final_report.md\\`\nYou can do this however many times you want until are you satisfied with the result.\n\nOnly edit the file once at a time (if you call this tool in parallel, there may be conflicts).\n\nHere are instructions for writing the final report:\n\n<report_instructions>\n\nCRITICAL: Make sure the answer is written in the same language as the human messages! If you make a todo plan - you should note in the plan what language the report should be in so you dont forget!\nNote: the language the report should be in is the language the QUESTION is in, not the language/country that the question is ABOUT.\n\nPlease create a detailed answer to the overall research brief that:\n1. Is well-organized with proper headings (# for title, ## for sections, ### for subsections)\n2. Includes specific facts and insights from the research\n3. References relevant sources using [Title](URL) format\n4. Provides a balanced, thorough analysis. Be as comprehensive as possible, and include all information that is relevant to the overall research question. People are using you for deep research and will expect detailed, comprehensive answers.\n5. Includes a \"Sources\" section at the end with all referenced links\n\nYou can structure your report in a number of different ways. Here are some examples:\n\nTo answer a question that asks you to compare two things, you might structure your report like this:\n1/ intro\n2/ overview of topic A\n3/ overview of topic B\n4/ comparison between A and B\n5/ conclusion\n\nTo answer a question that asks you to return a list of things, you might only need a single section which is the entire list.\n1/ list of things or table of things\nOr, you could choose to make each item in the list a separate section in the report. When asked for lists, you don't need an introduction or conclusion.\n1/ item 1\n2/ item 2\n3/ item 3\n\nTo answer a question that asks you to summarize a topic, give a report, or give an overview, you might structure your report like this:\n1/ overview of topic\n2/ concept 1\n3/ concept 2\n4/ concept 3\n5/ conclusion\n\nIf you think you can answer the question with a single section, you can do that too!\n1/ answer\n\nREMEMBER: Section is a VERY fluid and loose concept. You can structure your report however you think is best, including in ways that are not listed above!\nMake sure that your sections are cohesive, and make sense for the reader.\n\nFor each section of the report, do the following:\n- Use simple, clear language\n- Use ## for section title (Markdown format) for each section of the report\n- Do NOT ever refer to yourself as the writer of the report. This should be a professional report without any self-referential language.\n- Do not say what you are doing in the report. Just write the report without any commentary from yourself.\n- Each section should be as long as necessary to deeply answer the question with the information you have gathered. It is expected that sections will be fairly long and verbose. You are writing a deep research report, and users will expect a thorough answer.\n- Use bullet points to list out information when appropriate, but by default, write in paragraph form.\n\nREMEMBER:\nThe brief and research may be in English, but you need to translate this information to the right language when writing the final answer.\nMake sure the final answer report is in the SAME language as the human messages in the message history.\n\nFormat the report in clear markdown with proper structure and include source references where appropriate.\n\n<Citation Rules>\n- Assign each unique URL a single citation number in your text\n- End with ### Sources that lists each source with corresponding numbers\n- IMPORTANT: Number sources sequentially without gaps (1,2,3,4...) in the final list regardless of which sources you choose\n- Each source should be a separate line item in a list, so that in markdown it is rendered as a list.\n- Example format:\n  [1] Source Title: URL\n  [2] Source Title: URL\n- Citations are extremely important. Make sure to include these, and pay a lot of attention to getting these right. Users will often use these citations to look into more information.\n</Citation Rules>\n</report_instructions>\n\nYou have access to a few tools.\n\n## \\`internet_search\\`\n\nUse this to run an internet search for a given query. You can specify the number of results, the topic, and whether raw content should be included.\n`;\n\nconst research_agents: AgentConfig[] = [\n  {\n    key: \"research-agent\",\n    name: \"research-agent\",\n    type: AgentType.REACT,\n    description:\n      \"Used to research more in depth questions. Only give this researcher one topic at a time. Do not pass multiple sub questions to this researcher. Instead, you should break down a large topic into the necessary components, and then call multiple research agents in parallel, one for each sub question.\",\n    prompt: subResearchPrompt,\n    tools: [\"internet_search\"],\n  },\n  {\n    key: \"critique-agent\",\n    name: \"critique-agent\",\n    type: AgentType.REACT,\n    description:\n      \"Used to critique the final report. Give this agent some infomration about how you want it to critique the report.\",\n    prompt: subCritiquePrompt,\n  },\n  {\n    key: \"main\",\n    name: \"deep_research_agent\",\n    description:\n      \"Used to research more in depth questions. Only give this researcher one topic at a time. Do not pass multiple sub questions to this researcher. Instead, you should break down a large topic into the necessary components, and then call multiple research agents in parallel, one for each sub question.\",\n    type: AgentType.DEEP_AGENT,\n    tools: [\"internet_search\"],\n    prompt: researchInstructions,\n    subAgents: [\"critique-agent\", \"research-agent\"],\n    schema: z.object({\n      test: z.string().optional(),\n    }),\n  },\n];\n\nregisterAgentLattices(research_agents);\n"],"mappings":"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","names":["import_core","z","dotenv","path","port"]}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@axiom-lattice/examples-deep_research",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "main": "dist/index.js",
+  "bin": {
+    "lattice-deep-research": "./dist/index.js"
+  },
   "keywords": [],
   "author": "",
   "license": "ISC",
@@ -11,8 +14,8 @@
     "uuid": "^9.0.1",
     "zod": "^3.24.2",
     "zod-to-json-schema": "^3.24.3",
-    "@axiom-lattice/core": "2.0.0",
-    "@axiom-lattice/gateway": "2.0.0"
+    "@axiom-lattice/core": "2.1.12",
+    "@axiom-lattice/gateway": "2.1.17"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",
@@ -30,7 +33,7 @@
     "typescript": "^5.8.2"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs --dts --clean --sourcemap",
+    "build": "tsup",
     "start": "node dist/index.js",
     "dev": "tsup src/index.ts --format cjs --dts --watch --onSuccess \"node dist/index.js\"",
     "dev:nodemon": "nodemon --watch 'src/**/*.ts' --watch '../../packages/core/dist/**/*' --exec 'ts-node' -r tsconfig-paths/register src/index.ts",

package/src/agents/research/index.ts

@@ -5,6 +5,7 @@ import {
   AgentType,
   AgentConfig,
 } from "@axiom-lattice/core";
+import z from "zod";
 
 const subResearchPrompt = `You are a dedicated researcher. Your job is to conduct research based on the users questions.
 
@@ -151,6 +152,9 @@ const research_agents: AgentConfig[] = [
     tools: ["internet_search"],
     prompt: researchInstructions,
     subAgents: ["critique-agent", "research-agent"],
+    schema: z.object({
+      test: z.string().optional(),
+    }),
   },
 ];
 

package/src/index.ts

@@ -8,10 +8,40 @@ import {
 import "./agents";
 import path from "path";
 
-// 加载环境变量
+// Load environment variables
 dotenv.config({ path: path.resolve(__dirname, "../.env") });
 
-// 注册默认模型Lattice
+// Parse command line arguments for port configuration
+function parsePort(): number {
+  const args = process.argv.slice(2);
+  const portIndex = args.findIndex((arg) => arg === "--port" || arg === "-p");
+
+  if (portIndex !== -1 && args[portIndex + 1]) {
+    const port = parseInt(args[portIndex + 1], 10);
+    if (!isNaN(port) && port > 0 && port < 65536) {
+      return port;
+    }
+    console.warn(
+      `Invalid port value: ${args[portIndex + 1]}, using default port 4001`
+    );
+  }
+
+  // Check environment variable
+  if (process.env.PORT) {
+    const port = parseInt(process.env.PORT, 10);
+    if (!isNaN(port) && port > 0 && port < 65536) {
+      return port;
+    }
+    console.warn(
+      `Invalid PORT environment variable: ${process.env.PORT}, using default port 4001`
+    );
+  }
+
+  // Default port
+  return 4001;
+}
+
+// Register default model Lattice
 registerModelLattice(
   "default",
   // {
@@ -31,12 +61,19 @@ registerModelLattice(
   //   streaming: false,
   // },
   {
-    model: "kimi-k2-250711",
+    model: "kimi-k2-250905",
     provider: "volcengine",
     streaming: true,
     apiKeyEnvName: "VOLCENGINE_API_KEY2",
   }
   // {
+  //   model: "kimi-k2-0711-preview",
+  //   provider: "openai",
+  //   streaming: true,
+  //   apiKeyEnvName: "KIMI_API_KEY",
+  //   baseURL: "https://api.moonshot.cn/v1",
+  // }
+  // {
   //   model: "qwen-plus",
   //   provider: "openai",
   //   streaming: false,
@@ -44,7 +81,12 @@ registerModelLattice(
   //   baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1",
   // }
 );
-
 LatticeGateway.registerLatticeRoutes(LatticeGateway.app);
 
-LatticeGateway.startAsHttpEndpoint({ port: 4001 });
+const port = parsePort();
+console.log(`Starting server on port ${port}`);
+
+LatticeGateway.startAsHttpEndpoint({
+  port,
+  queueServiceConfig: { type: "memory", defaultStartPollingQueue: true },
+});

package/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["cjs"],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+  banner: {
+    js: "#!/usr/bin/env node",
+  },
+});

package/src/agents/todo/index.ts

@@ -1,21 +0,0 @@
-import {
-  AgentConfig,
-  AgentType,
-  registerAgentLattice,
-} from "@axiom-lattice/core";
-import "./tools/read_todo_list";
-import "./tools/create_todo_item";
-
-export const TODO_AGENT_NAME = "maintodo";
-
-const todo_agent_definition: AgentConfig = {
-  key: "todo",
-  type: AgentType.PLAN_EXECUTE,
-  name: TODO_AGENT_NAME,
-  description: "todo_agent可以分析用户的输入，整理并生成待办事项",
-  prompt:
-    "你是一个todo助手，请根据用户输入生成待办事项，每次生成待办时都需要用户进行确认，而且需要先查询下待办列表，再根据待办列表生成待办事项",
-  tools: ["读取待办列表", "创建待办事项", "获取当前日期时间"],
-};
-
-registerAgentLattice(todo_agent_definition);

package/src/agents/todo/tools/create_todo_item.ts

@@ -1,37 +0,0 @@
-import { registerToolLattice } from "@axiom-lattice/core";
-import { z } from "zod";
-
-registerToolLattice(
-  "create_todo_item",
-  {
-    name: "创建待办事项",
-    description: "创建待办事项",
-    needUserApprove: true,
-    schema: z.object({
-      title: z.string(),
-      description: z.string().nullable(),
-      due_date: z.string().nullable(),
-      priority: z.string().nullable(),
-      status: z.string().nullable(),
-      tags: z.array(z.string()).nullable(),
-      category: z.string().nullable(),
-    }),
-  },
-  async (
-    input: {
-      title: string;
-      description: string;
-      due_date: string;
-      priority: string;
-      status: string;
-      tags: string[];
-    },
-    config: any
-  ) => {
-    (globalThis as any)["todo_list"].push(input);
-
-    return genUIMarkdown("todo_item_view", input);
-  }
-);
-
-(globalThis as any)["todo_list"] = [];

package/src/agents/todo/tools/read_todo_list.ts

@@ -1,22 +0,0 @@
-import { registerToolLattice } from "@core/tool_lattice/ToolLatticeManager";
-import { genUIMarkdown } from "@core/util/genUIMarkdown";
-import { z } from "zod";
-
-registerToolLattice(
-  "read_todo_list",
-  {
-    name: "读取待办列表",
-    description: "读取待办事项列表",
-    schema: z.object({
-      search_text: z.string().optional().nullable(),
-    }),
-  },
-  async (input: { search_text: string }) => {
-    const md = genUIMarkdown("generic_data_table", {
-      dataSource: (globalThis as any)["todo_list"],
-      message: "待办事项列表",
-    });
-    console.log(md);
-    return md;
-  }
-);