octocode-mcp 7.0.3-alpha.1 → 7.0.3-alpha.3

package/dist/src/prompts/kudos.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const PROMPT_NAME = "kudos";
+export declare function registerKudosPrompt(server: McpServer): void;

package/dist/src/prompts/prompts.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register all prompts with the MCP server
+ * Each prompt is defined in its own file under the prompts directory
+ */
+export declare function registerPrompts(server: McpServer): void;

package/dist/src/prompts/research.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const PROMPT_NAME = "research";
+export declare const PROMPT = "You are an expert Code research Agent using systematic decision-tree workflows.\n\nCORE RULES:\n- FOLLOW ALL STEPS EXACTLY \u2014 do not skip stages. Use gates to decide next step.\n- Provide a brief Decision Log and Assumptions at each stage; avoid revealing private chain-of-thought.\n- Set mainResearchGoal (high-level objective), researchGoal (specific query info), reasoning (why this helps).\n- Plan up to 5\u201310 parallel queries per tool call; adapt batch size based on api_status_check, rate limits, and repo size.\n- MUST ASK USER when uncertain, when scope/goal is unclear, when contradictions appear, or at decision points. Pause and request clarification before proceeding.\n- By default, produce a concise, referenced answer. Generate a full Research Documentation report only if explicitly requested by the user or clearly required by the task.\n\nMANDATORY SEQUENCE: VALIDATE SCOPE \u2192 ENTRY POINT \u2192 STAGE WORKFLOWS \u2192 LOOP OR COMPLETE \u2192 RECOVERY (if needed) \u2192 SYNTHESIS\nAt each stage:\n- Add a concise <thinking> summary with: assumptions, goal, plan, and gate decision (keep non-revealing).\n- Follow the Gate rules strictly before moving forward.\n- If anything is unclear, ASK USER and wait for confirmation.\n- Reserve a Creativity & Agility slot: explore repo-specific signals and adapt methods per repository variability (code and repos vary).\n\nFORMATTING & CITATIONS (MANDATORY):\n- Use concise bullets and short paragraphs; avoid raw code dumps.\n- For any code evidence, cite using code reference blocks strictly in the format:\n  ```startLine:endLine:filepath\n  // excerpt\n  ```\n- Do NOT add language tags to code references; include only the exact lines needed.\n- When showing new example code (not from repo), use standard fenced code blocks with a language tag.\n- Never include secrets or tokens in outputs; redact if encountered.\n\n# 1. VALIDATE SCOPE\n\nIn <thinking>, determine:\n\u251C\u2500 Type: Technical (code/flows) | Product (docs+code) | Pattern Analysis | Bug Investigation\n\u251C\u2500 Scope: Public repos | Private org | Specific owner/repo\n\u251C\u2500 Depth: Overview | Deep dive | Compare multiple\n\u2514\u2500 Approach:\n   \u251C\u2500 Technical: Code is truth \u2192 trace flows, verify docs against code\n   \u2514\u2500 Product: Docs first \u2192 validate with code, identify gaps\n\nEntry point (choose starting stage):\n- Know repo+file \u2192 Stage D | Repo only \u2192 Stage B | Topic/owner \u2192 Stage A | Pattern \u2192 Stage C | Unclear \u2192 Stage A\n\n!!ASK USER if scope unclear before starting!!\nMANDATORY: If any required detail is missing or ambiguous, ask a targeted question and halt until answered.\n\n# 2. STAGE WORKFLOWS\n\n## Stage A: Find Repositories (github_search_repos)\nWhen: Unknown repo | ecosystem overview | finding dependencies\n\nBranches:\n\u251C\u2500 Public: topicsToSearch + stars filter + sort by stars/updated\n\u251C\u2500 Private org: keywordsToSearch + owner + sort by updated\n\u251C\u2500 Dependencies: read manifest \u2192 bulk search variations \u2192 validate\n\u2514\u2500 Hypotheses: bulk test topics/keywords/owner combos\n\n<thinking>:\n- Search approach? (topic vs keyword vs owner)\n- Filters: stars/language/updated\n- mainResearchGoal / researchGoal for each query\n- Results comparison, quality signals\n- ASK USER: \"Found N repos via X, M via Y. Deep-dive which?\"\n- Creativity & Agility: probe non-obvious keywords/topics, org conventions, forks/network signals.\n\nGate (MANDATORY): \u2713 Found repos \u2192 B | \u2717 Empty \u2192 broaden, ASK USER (do not proceed without user input if scope is unclear)\n\nParameters (MANDATORY):\n- limit: 5\u201310; sort: stars or updated\n- Public: prefer topicsToSearch / keywordsToSearch + stars=\">=100\"; Private org: include owner and sort=updated\n- Heuristics: prefer repos with recent updates, docs presence (README/ARCHITECTURE), and stable activity\n- Exclusions: deprecated/archived unless explicitly requested\n\n## Stage B: Explore Structure (github_view_repo_structure)\nWhen: New repo | unfamiliar architecture | finding locations\n\nBranches:\n\u251C\u2500 Unknown: depth=1 root \u2192 selective depth=2 for key dirs\n\u251C\u2500 No branch specified: auto-defaults to main\n\u251C\u2500 Compare repos: bulk [{repo1, path=\"\"}, {repo2, path=\"\"}, ...]\n\u251C\u2500 Specific area: path=\"{{target_dir}}\" or path=\"packages/{{package}}\"\n\u2514\u2500 Find docs: README, ARCHITECTURE, /docs \u2192 read in Stage D first\n\n<thinking>:\n- Organization? (monorepo | standard | custom)\n- Implementation locations? (src/ | lib/ | packages/)\n- Relevant directories for goal?\n- Docs found? \u2192 Read first for context\n- ASK USER: \"Found {{dirs}}. Explore which first?\"\n- Creativity & Agility: look for unconventional structure (tools/, scripts/, internal/), custom build systems, generators.\n\nGate (MANDATORY): \u2713 Understand \u2192 D (docs) \u2192 C (code) | \u2717 Confused \u2192 D (README), ASK USER (pause until clarified)\n\nParameters (MANDATORY):\n- Start with depth=1 at path=\"\"; then depth=2 for only the most relevant dirs\n- Default branch if unspecified; document the branch used\n- Focus dirs: src/, lib/, packages/, docs/\n- Do not read file contents here; only collect structure and candidate targets\n\n## Stage C: Search Code (github_search_code)\nWhen: Finding files | implementations | patterns | tracing flows\n\nBranches:\n\u251C\u2500 Filename: match=\"path\" + bulk variations\n\u251C\u2500 Pattern: match=\"file\" + limit=5-10 + filters (path/extension) + semantic expansion\n\u251C\u2500 Docs: filename=\"README\" | path=\"docs\", extension=\"md\" \u2192 validate vs code\n\u251C\u2500 Known dir: path=\"{{dir}}\", extension=\"{{ext}}\"\n\u2514\u2500 Trace: follow imports/conditionals \u2192 loop C\u2192D\u2192C\n\n<thinking>:\n- Mode? (path discovery | content | docs)\n- Docs first? (Product: yes | Technical: verify)\n- Semantic variations? ({{term}} \u2192 related terms)\n- Cross-repo consistency? Version alignment?\n- ASK USER: \"Found pattern A in {{repo1}}, B in {{repo2}}. Compare which?\"\n- Creativity & Agility: try synonyms, framework conventions, test names, CLI/script entrypoints; pivot based on hits.\n\nGate (MANDATORY): \u2713 Found \u2192 D (extract) | \u2717 Empty \u2192 broaden/switch mode, ASK USER | \u2717 Too many \u2192 add filters (do not continue without resolving ambiguity)\n\nParameters (MANDATORY):\n- match: \"path\" for filename/discovery; \"file\" for content\n- limit: 5\u201310; add extension filters (ts, js, py, go, md) and path filters when possible\n- Exclude: node_modules, vendor, dist, build, coverage, lockfiles, minified assets\n- Variations: include synonyms/related terms; follow imports to expand search iteratively\n\n## Stage D: Extract Content (github_fetch_content)\nWhen: Reading files | validating findings | understanding implementations\n\nBranches:\n\u251C\u2500 Docs: fullContent=true, minified=false \u2192 note discrepancies\n\u251C\u2500 Excerpt: matchString + matchStringContextLines=5-20 \u2192 bulk parallel\n\u251C\u2500 Line range: startLine/endLine (prefer over fullContent)\n\u251C\u2500 Small/config: fullContent OK <200 lines, minified=false for JSON/YAML/configs/markdown\n\u251C\u2500 Compare: bulk [{repo1, path, matchString}, {repo2, path, matchString}]\n\u2514\u2500 Dependencies: read imports (startLine=1, endLine=50) \u2192 loop D\u2192C\u2192D\n\n<thinking>:\n- Docs claims vs code reality?\n- What does code actually do? (ignore comments)\n- Dependencies/versions compatible?\n- Context sufficient? (missing helpers/types?)\n- Docs conflicts? \u2192 trust code\n- ASK USER: \"Code does X but docs say Y. Investigate?\"\n- Creativity & Agility: sample nearby helpers/utils, skim small configs for signals, adjust ranges dynamically.\n\nGate (MANDATORY): \u2713 Understand \u2192 synthesize/continue | \u2717 Missing context \u2192 C (helpers/types/tests) | \u2717 Conflicts \u2192 read tests, ASK USER (pause until clarified)\n\nParameters (MANDATORY):\n- Prefer partial reads: matchString + matchStringContextLines=10\u201320; or startLine/endLine for focused ranges\n- fullContent=true only for small files (<200 lines) or when reading docs/config; set minified=false for JSON/YAML/Markdown\n- Default minified=true for large code files; always avoid entire large files\n- Compare similar files across repos in bulk when validating patterns\n\n# 3. LOOP OR COMPLETE?\n\nAfter each stage (checkpoint):\n\u251C\u2500 Goal met? \u2192 SYNTHESIS\n\u251C\u2500 Need context? \u2192 loop/go deeper\n\u251C\u2500 Contradictions? \u2192 validate (tests, compare repos)\n\u251C\u2500 Scope expanding? \u2192 ASK USER: \"Found {{area}}. Explore?\"\n\u251C\u2500 Maintain agility: adjust plan creatively to repository specifics as evidence emerges\n\u2514\u2500 Uncertain? \u2192 ASK USER\n\nMANDATORY: Always perform this checkpoint. If any item requires user input, ask a concise question and wait.\n\nLoop control (MANDATORY):\n- Maximum of 3 loops without user input; if still unclear, ASK USER with options summarizing trade-offs and halt.\n- Maintain a short Decision Log of what was tried and why.\n\n# 4. RECOVERY\n\nEmpty: broaden terms \u2192 remove filters \u2192 switch mode \u2192 try tests/docs/examples \u2192 back to Stage B \u2192 ASK USER (do not proceed silently)\n\nToo many: add specificity \u2192 filters (path/extension/limit) \u2192 exclude test/vendor/node_modules \u2192 quality bar (stars/updated)\n\nIncomplete: follow imports (D\u2192C\u2192D) \u2192 check tests (C\u2192D) \u2192 read docs (C\u2192D) \u2192 cross-reference (A\u2192compare) \u2192 ASK USER\n\nExpanding: STOP \u2192 ASK USER: \"Explored N repos, M files. Found {{approaches}}. Continue all or focus?\"\nCreativity & Agility: explore examples/, demo/, scripts/, tooling configs; attempt alternative angles before escalation.\n\nRate limits & caching (MANDATORY):\n- If encountering rate limits or slow responses, run api_status_check and adjust batch sizes.\n- Prefer bulk operations but respect limits; fall back to fewer queries temporarily and resume bulk when stable.\n- Reuse prior findings; deduplicate paths and avoid re-reading the same files unless necessary.\n\n# 5. SYNTHESIS\n\nBy default, return a concise, referenced answer addressing the validated research goal. If the user explicitly requests a full report (or the task clearly requires it), produce the comprehensive Research Documentation.\n\nWhen generating the full report, include:\n\u251C\u2500 Executive Summary: 2-3 sentences answering goal (must be decisive; note uncertainties explicitly)\n\u251C\u2500 Key Findings: bullets with {{owner}}/{{repo}}/{{path}}:{{lines}}\n\u251C\u2500 Analysis: high-level explanations (NOT code dumps)\n\u251C\u2500 Visualizations: Mermaid diagrams/tables when helpful (flowchart, sequenceDiagram, classDiagram, stateDiagram-v2, graph)\n\u251C\u2500 Code Examples: minimal, only when critical\n\u2514\u2500 References: every claim cited with repo/file/line\n\u251C\u2500 Confidence: per key finding, 0.0\u20131.0 with a one-line rationale\n\u2514\u2500 Open Questions & Next Steps: explicit follow-ups to resolve remaining uncertainty\n\n#PRINCIPLES\n\n\u251C\u2500 Never hallucinate \u2192 cite sources\n\u251C\u2500 Show reasoning succinctly \u2192 Decision Log + Assumptions each stage (no private chain-of-thought)\n\u251C\u2500 Ask when unclear \u2192 user input over assumptions (mandatory)\n\u251C\u2500 Code is truth \u2192 implementation over docs\n\u251C\u2500 Bulk operations \u2192 plan up to 5\u201310; adapt to limits\n\u251C\u2500 Validate continuously \u2192 check before proceeding\n\u251C\u2500 Synthesize \u2192 insights over raw data\n\u2514\u2500 Follow tool hints \u2192 adjust strategy, document exceptions\n\n# 7. FINAL VERIFICATION (MANDATORY)\n\nBefore output (final checks):\n\u2713 Goal addressed? Findings verified? Code validated? References complete? Assumptions documented? Question answered?\n\nIf uncertain: ASK USER\n- No sensitive data leaked? Citations use correct code reference format? Outputs are concise and structured?\n\n# WORKFLOWS\n\nTechnical: A \u2192 B (docs) \u2192 D (read docs) \u2192 C (impl) \u2192 D (verify) \u2192 C\u2192D (deps/tests) \u2192 Synthesize\nProduct: A \u2192 B (docs) \u2192 D (features) \u2192 C (validate) \u2192 D (examples) \u2192 Synthesize\nPattern: A bulk \u2192 B bulk \u2192 D bulk \u2192 C bulk \u2192 D bulk \u2192 Compare \u2192 Synthesize\nBug: C (docs/issues) \u2192 C (error) \u2192 D (changelog) \u2192 C\u2192D (tests) \u2192 Root cause \u2192 Synthesize";
+export declare function registerResearchPrompt(server: McpServer): void;

package/dist/src/prompts/use.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const PROMPT_NAME = "use";
+export declare function registerUsePrompt(server: McpServer): void;

package/dist/src/sampling.d.ts

@@ -19,39 +19,39 @@ declare const SamplingRequestSchema: z.ZodObject<{
             text: string;
         }>;
     }, "strip", z.ZodTypeAny, {
-        role: "user" | "assistant";
         content: {
             type: "text";
             text: string;
         };
-    }, {
         role: "user" | "assistant";
+    }, {
         content: {
             type: "text";
             text: string;
         };
+        role: "user" | "assistant";
     }>, "many">;
     maxTokens: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     temperature: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     stopSequences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     messages: {
-        role: "user" | "assistant";
         content: {
             type: "text";
             text: string;
         };
+        role: "user" | "assistant";
     }[];
     maxTokens: number;
     temperature: number;
     stopSequences?: string[] | undefined;
 }, {
     messages: {
-        role: "user" | "assistant";
         content: {
             type: "text";
             text: string;
         };
+        role: "user" | "assistant";
     }[];
     maxTokens?: number | undefined;
     temperature?: number | undefined;

package/dist/src/scheme/baseSchema.d.ts

@@ -1,11 +1,14 @@
 import { z } from 'zod';
 export declare const BaseQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
 }, {
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
 }>;

package/dist/src/scheme/github_fetch_content.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 export declare const FileContentQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 } & {
@@ -22,6 +23,7 @@ export declare const FileContentQuerySchema: z.ZodObject<{
     minified: boolean;
     fullContent: boolean;
     matchStringContextLines: number;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
     branch?: string | undefined;
@@ -32,6 +34,7 @@ export declare const FileContentQuerySchema: z.ZodObject<{
     path: string;
     owner: string;
     repo: string;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
     sanitize?: boolean | undefined;
@@ -45,6 +48,7 @@ export declare const FileContentQuerySchema: z.ZodObject<{
 }>;
 export declare const FileContentBulkQuerySchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodObject<{
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
         researchGoal: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodString>;
     } & {
@@ -67,6 +71,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         minified: boolean;
         fullContent: boolean;
         matchStringContextLines: number;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         branch?: string | undefined;
@@ -77,6 +82,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         path: string;
         owner: string;
         repo: string;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         sanitize?: boolean | undefined;
@@ -97,6 +103,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         minified: boolean;
         fullContent: boolean;
         matchStringContextLines: number;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         branch?: string | undefined;
@@ -109,6 +116,7 @@ export declare const FileContentBulkQuerySchema: z.ZodObject<{
         path: string;
         owner: string;
         repo: string;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         sanitize?: boolean | undefined;

package/dist/src/scheme/github_search_code.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 } & {
@@ -19,10 +20,11 @@ export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
     minify: boolean;
     sanitize: boolean;
     path?: string | undefined;
-    owner?: string | undefined;
-    repo?: string | undefined;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
+    owner?: string | undefined;
+    repo?: string | undefined;
     stars?: string | undefined;
     extension?: string | undefined;
     filename?: string | undefined;
@@ -31,10 +33,11 @@ export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
 }, {
     keywordsToSearch: string[];
     path?: string | undefined;
-    owner?: string | undefined;
-    repo?: string | undefined;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
+    owner?: string | undefined;
+    repo?: string | undefined;
     stars?: string | undefined;
     extension?: string | undefined;
     filename?: string | undefined;
@@ -45,6 +48,7 @@ export declare const GitHubCodeSearchQuerySchema: z.ZodObject<{
 }>;
 export declare const GitHubCodeSearchBulkQuerySchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodObject<{
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
         researchGoal: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodString>;
     } & {
@@ -64,10 +68,11 @@ export declare const GitHubCodeSearchBulkQuerySchema: z.ZodObject<{
         minify: boolean;
         sanitize: boolean;
         path?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
         stars?: string | undefined;
         extension?: string | undefined;
         filename?: string | undefined;
@@ -76,10 +81,11 @@ export declare const GitHubCodeSearchBulkQuerySchema: z.ZodObject<{
     }, {
         keywordsToSearch: string[];
         path?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
         stars?: string | undefined;
         extension?: string | undefined;
         filename?: string | undefined;
@@ -94,10 +100,11 @@ export declare const GitHubCodeSearchBulkQuerySchema: z.ZodObject<{
         minify: boolean;
         sanitize: boolean;
         path?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
         stars?: string | undefined;
         extension?: string | undefined;
         filename?: string | undefined;
@@ -108,10 +115,11 @@ export declare const GitHubCodeSearchBulkQuerySchema: z.ZodObject<{
     queries: {
         keywordsToSearch: string[];
         path?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
         stars?: string | undefined;
         extension?: string | undefined;
         filename?: string | undefined;

package/dist/src/scheme/github_search_pull_requests.d.ts

@@ -11,6 +11,7 @@ export declare const DateRangeSchema: z.ZodObject<{
     updated?: string | undefined;
 }>;
 export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 } & {
@@ -50,10 +51,7 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     withContent: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     order: "asc" | "desc";
-    sort?: "created" | "updated" | "best-match" | undefined;
     query?: string | undefined;
-    owner?: string | undefined;
-    repo?: string | undefined;
     state?: "open" | "closed" | undefined;
     draft?: boolean | undefined;
     assignee?: string | undefined;
@@ -62,8 +60,12 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     closed?: string | undefined;
     created?: string | undefined;
     updated?: string | undefined;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
+    owner?: string | undefined;
+    repo?: string | undefined;
+    sort?: "created" | "updated" | "best-match" | undefined;
     head?: string | undefined;
     'no-label'?: boolean | undefined;
     'no-milestone'?: boolean | undefined;
@@ -86,10 +88,7 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     withComments?: boolean | undefined;
     withContent?: boolean | undefined;
 }, {
-    sort?: "created" | "updated" | "best-match" | undefined;
     query?: string | undefined;
-    owner?: string | undefined;
-    repo?: string | undefined;
     state?: "open" | "closed" | undefined;
     draft?: boolean | undefined;
     assignee?: string | undefined;
@@ -98,8 +97,12 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
     closed?: string | undefined;
     created?: string | undefined;
     updated?: string | undefined;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
+    owner?: string | undefined;
+    repo?: string | undefined;
+    sort?: "created" | "updated" | "best-match" | undefined;
     head?: string | undefined;
     'no-label'?: boolean | undefined;
     'no-milestone'?: boolean | undefined;
@@ -125,6 +128,7 @@ export declare const GitHubPullRequestSearchQuerySchema: z.ZodObject<{
 }>;
 export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodObject<{
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
         researchGoal: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodString>;
     } & {
@@ -164,10 +168,7 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         withContent: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         order: "asc" | "desc";
-        sort?: "created" | "updated" | "best-match" | undefined;
         query?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
         state?: "open" | "closed" | undefined;
         draft?: boolean | undefined;
         assignee?: string | undefined;
@@ -176,8 +177,12 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         closed?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
         'no-label'?: boolean | undefined;
         'no-milestone'?: boolean | undefined;
@@ -200,10 +205,7 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         withComments?: boolean | undefined;
         withContent?: boolean | undefined;
     }, {
-        sort?: "created" | "updated" | "best-match" | undefined;
         query?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
         state?: "open" | "closed" | undefined;
         draft?: boolean | undefined;
         assignee?: string | undefined;
@@ -212,8 +214,12 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         closed?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
         'no-label'?: boolean | undefined;
         'no-milestone'?: boolean | undefined;
@@ -240,10 +246,7 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     queries: {
         order: "asc" | "desc";
-        sort?: "created" | "updated" | "best-match" | undefined;
         query?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
         state?: "open" | "closed" | undefined;
         draft?: boolean | undefined;
         assignee?: string | undefined;
@@ -252,8 +255,12 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         closed?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
         'no-label'?: boolean | undefined;
         'no-milestone'?: boolean | undefined;
@@ -278,10 +285,7 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
     }[];
 }, {
     queries: {
-        sort?: "created" | "updated" | "best-match" | undefined;
         query?: string | undefined;
-        owner?: string | undefined;
-        repo?: string | undefined;
         state?: "open" | "closed" | undefined;
         draft?: boolean | undefined;
         assignee?: string | undefined;
@@ -290,8 +294,12 @@ export declare const GitHubPullRequestSearchBulkQuerySchema: z.ZodObject<{
         closed?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
+        repo?: string | undefined;
+        sort?: "created" | "updated" | "best-match" | undefined;
         head?: string | undefined;
         'no-label'?: boolean | undefined;
         'no-milestone'?: boolean | undefined;

package/dist/src/scheme/github_search_repos.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 export declare const GitHubReposSearchQuerySchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodObject<{
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
         researchGoal: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodString>;
     } & {
@@ -15,58 +16,62 @@ export declare const GitHubReposSearchQuerySchema: z.ZodObject<{
         sort: z.ZodOptional<z.ZodEnum<["forks", "stars", "updated", "best-match"]>>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
-        owner?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
         stars?: string | undefined;
+        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
         keywordsToSearch?: string[] | undefined;
-        match?: ("description" | "name" | "readme")[] | undefined;
+        match?: ("name" | "description" | "readme")[] | undefined;
         limit?: number | undefined;
         size?: string | undefined;
         topicsToSearch?: string[] | undefined;
     }, {
-        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
-        owner?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
         stars?: string | undefined;
+        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
         keywordsToSearch?: string[] | undefined;
-        match?: ("description" | "name" | "readme")[] | undefined;
+        match?: ("name" | "description" | "readme")[] | undefined;
         limit?: number | undefined;
         size?: string | undefined;
         topicsToSearch?: string[] | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     queries: {
-        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
-        owner?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
         stars?: string | undefined;
+        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
         keywordsToSearch?: string[] | undefined;
-        match?: ("description" | "name" | "readme")[] | undefined;
+        match?: ("name" | "description" | "readme")[] | undefined;
         limit?: number | undefined;
         size?: string | undefined;
         topicsToSearch?: string[] | undefined;
     }[];
 }, {
     queries: {
-        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
-        owner?: string | undefined;
         created?: string | undefined;
         updated?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
+        owner?: string | undefined;
         stars?: string | undefined;
+        sort?: "updated" | "best-match" | "forks" | "stars" | undefined;
         keywordsToSearch?: string[] | undefined;
-        match?: ("description" | "name" | "readme")[] | undefined;
+        match?: ("name" | "description" | "readme")[] | undefined;
         limit?: number | undefined;
         size?: string | undefined;
         topicsToSearch?: string[] | undefined;

package/dist/src/scheme/github_view_repo_structure.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
+    mainResearchGoal: z.ZodOptional<z.ZodString>;
     researchGoal: z.ZodOptional<z.ZodString>;
     reasoning: z.ZodOptional<z.ZodString>;
 } & {
@@ -13,6 +14,7 @@ export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
     repo: string;
     branch: string;
     path?: string | undefined;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
     depth?: number | undefined;
@@ -21,12 +23,14 @@ export declare const GitHubViewRepoStructureQuerySchema: z.ZodObject<{
     repo: string;
     branch: string;
     path?: string | undefined;
+    mainResearchGoal?: string | undefined;
     researchGoal?: string | undefined;
     reasoning?: string | undefined;
     depth?: number | undefined;
 }>;
 export declare const GitHubViewRepoStructureBulkQuerySchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodObject<{
+        mainResearchGoal: z.ZodOptional<z.ZodString>;
         researchGoal: z.ZodOptional<z.ZodString>;
         reasoning: z.ZodOptional<z.ZodString>;
     } & {
@@ -40,6 +44,7 @@ export declare const GitHubViewRepoStructureBulkQuerySchema: z.ZodObject<{
         repo: string;
         branch: string;
         path?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         depth?: number | undefined;
@@ -48,6 +53,7 @@ export declare const GitHubViewRepoStructureBulkQuerySchema: z.ZodObject<{
         repo: string;
         branch: string;
         path?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         depth?: number | undefined;
@@ -58,6 +64,7 @@ export declare const GitHubViewRepoStructureBulkQuerySchema: z.ZodObject<{
         repo: string;
         branch: string;
         path?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         depth?: number | undefined;
@@ -68,6 +75,7 @@ export declare const GitHubViewRepoStructureBulkQuerySchema: z.ZodObject<{
         repo: string;
         branch: string;
         path?: string | undefined;
+        mainResearchGoal?: string | undefined;
         researchGoal?: string | undefined;
         reasoning?: string | undefined;
         depth?: number | undefined;

package/dist/src/scheme/schemDescriptions.d.ts

@@ -1,9 +1,3 @@
-export declare const GENERAL: {
-    base: {
-        researchGoal: string;
-        reasoning: string;
-    };
-};
 export declare const COMMON: {
     scope: {
         owner: string;

package/dist/src/security/withSecurityValidation.d.ts

@@ -14,6 +14,35 @@ export declare function withSecurityValidation<T extends Record<string, unknown>
  * For tools that don't need user context
  */
 export declare function withBasicSecurityValidation<T extends Record<string, unknown>>(toolHandler: (sanitizedArgs: T) => Promise<CallToolResult>): (args: unknown) => Promise<CallToolResult>;
+/**
+ * Extracts research-related fields from tool parameters for logging purposes.
+ *
+ * Supports both bulk operations (queries array) and single operations (direct params).
+ * Consolidates research fields from multiple queries, prioritizing non-empty values.
+ *
+ * @param params - The tool parameters containing research information
+ * @returns Object with mainResearchGoal, researchGoal, and reasoning fields
+ *
+ * @example
+ * // Single query
+ * extractResearchFields({ queries: [{ mainResearchGoal: "Find auth", reasoning: "Security" }] })
+ * // Returns: { mainResearchGoal: "Find auth", reasoning: "Security" }
+ *
+ * @example
+ * // Multiple queries - consolidates unique values
+ * extractResearchFields({
+ *   queries: [
+ *     { mainResearchGoal: "Auth", researchGoal: "Find login" },
+ *     { mainResearchGoal: "Auth", researchGoal: "Find logout" }
+ *   ]
+ * })
+ * // Returns: { mainResearchGoal: "Auth", researchGoal: "Find login; Find logout" }
+ */
+export declare function extractResearchFields(params: Record<string, unknown>): {
+    mainResearchGoal?: string;
+    researchGoal?: string;
+    reasoning?: string;
+};
 /**
  * Extracts repository identifiers from tool parameters for logging purposes.
  *

package/dist/src/session.d.ts

@@ -13,7 +13,11 @@ declare class SessionManager {
     /**
      * Log tool call
      */
-    logToolCall(toolName: string, repos: string[]): Promise<void>;
+    logToolCall(toolName: string, repos: string[], mainResearchGoal?: string, researchGoal?: string, reasoning?: string): Promise<void>;
+    /**
+     * Log prompt call
+     */
+    logPromptCall(promptName: string): Promise<void>;
     /**
      * Log error
      */
@@ -27,24 +31,10 @@ declare class SessionManager {
  * Initialize the session manager
  */
 export declare function initializeSession(): SessionManager;
-/**
- * Get the current session manager instance
- */
 export declare function getSessionManager(): SessionManager | null;
-/**
- * Log session initialization
- */
 export declare function logSessionInit(): Promise<void>;
-/**
- * Log tool call
- */
-export declare function logToolCall(toolName: string, repos: string[]): Promise<void>;
-/**
- * Log error
- */
+export declare function logToolCall(toolName: string, repos: string[], mainResearchGoal?: string, researchGoal?: string, reasoning?: string): Promise<void>;
+export declare function logPromptCall(promptName: string): Promise<void>;
 export declare function logSessionError(error: string): Promise<void>;
-/**
- * Reset session manager (for testing purposes)
- */
 export declare function resetSessionManager(): void;
 export {};

package/dist/src/tools/github_fetch_content.d.ts

@@ -1,2 +1,3 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerFetchGitHubFileContentTool(server: McpServer): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;
+import type { ToolInvocationCallback } from '../types.js';
+export declare function registerFetchGitHubFileContentTool(server: McpServer, callback?: ToolInvocationCallback): import("@modelcontextprotocol/sdk/server/mcp.js").RegisteredTool;