@codemap-ai/core 0.2.0

package/dist/lib/agent-workflow.js

@@ -0,0 +1,329 @@
+import { AGENT_PACK_INDEX_URI, AGENT_PACK_INSTALL_URI, AGENT_PACK_SKILLS, AGENT_PACK_TEMPLATES, skillResourceUri, } from "./agent-pack.js";
+export const MCP_FIRST_RULE_URI = "codemap://rules/mcp-first";
+export const TASK_LIFECYCLE_RULE_URI = "codemap://rules/task-lifecycle";
+export const SKILL_ROUTING_RULE_URI = "codemap://rules/skill-routing";
+export const WORKFLOW_GATES_RULE_URI = "codemap://rules/workflow-gates";
+export const VERIFICATION_BEFORE_COMPLETION_RULE_URI = "codemap://rules/verification-before-completion";
+export const TASK_TYPES = [
+    "feature",
+    "bugfix",
+    "debugging",
+    "review",
+    "refactor",
+    "test",
+    "research",
+];
+export const WORKFLOW_PHASES = [
+    "orient",
+    "design",
+    "plan",
+    "implement",
+    "verify",
+    "finish",
+];
+export const DEFAULT_VERIFICATION_CHECKLIST = [
+    "Inspect uncommitted changes with diff(mode=\"working\").",
+    "Run the smallest relevant build or test command.",
+    "Refresh the local MCP index with refresh_local_index after local edits.",
+    "Decide whether cloud graph/insights need reimport.",
+    "Report verification results, skipped checks, and residual risk.",
+];
+export const WORKFLOW_ROUTES = {
+    feature: {
+        taskType: "feature",
+        description: "New capability, product behavior, route, API, workflow, or vague implementation request.",
+        requiredSkills: [
+            "brainstorming",
+            "writing-plans",
+            "executing-plans",
+            "verification-before-completion",
+        ],
+        firstTools: ["explore_task"],
+        hardGates: [
+            "Do not edit production files before the design is approved.",
+            "After design approval, write an implementation plan before code changes.",
+            "Complete verification-before-completion before declaring done.",
+        ],
+        requiredOutputs: ["Approved design summary", "Implementation plan", "Verification report"],
+        completionChecks: DEFAULT_VERIFICATION_CHECKLIST,
+        phases: ["orient", "design", "plan", "implement", "verify", "finish"],
+    },
+    bugfix: {
+        taskType: "bugfix",
+        description: "Known broken behavior with an expected correct behavior.",
+        requiredSkills: [
+            "symbol-level-debugging",
+            "test-driven-development",
+            "safe-edit-and-reimport",
+            "verification-before-completion",
+        ],
+        firstTools: ["explore_task", "search_codebase", "symbol"],
+        hardGates: [
+            "Reproduce or identify the failing path before changing code.",
+            "Prefer a failing test before production changes when the repo has a matching test pattern.",
+            "Complete verification-before-completion before declaring done.",
+        ],
+        requiredOutputs: ["Failure hypothesis", "Fix summary", "Verification report"],
+        completionChecks: DEFAULT_VERIFICATION_CHECKLIST,
+        phases: ["orient", "design", "implement", "verify", "finish"],
+    },
+    debugging: {
+        taskType: "debugging",
+        description: "Investigation, diagnosis, or explanation of confusing behavior.",
+        requiredSkills: [
+            "symbol-level-debugging",
+            "feature-area-investigation",
+            "interpreting-codemap-output",
+        ],
+        firstTools: ["search_codebase", "symbol", "symbol"],
+        hardGates: [
+            "Do not patch before the likely root cause is grounded in CodeMap context.",
+            "Use symbol context and callers/usages before raw broad reads.",
+        ],
+        requiredOutputs: ["Root-cause explanation", "Impacted files/symbols", "Suggested next action"],
+        completionChecks: ["Inspect relevant symbols/callers.", "State confidence and remaining unknowns."],
+        phases: ["orient", "design", "finish"],
+    },
+    review: {
+        taskType: "review",
+        description: "Code review, PR review, diff review, or risk assessment.",
+        requiredSkills: ["token-efficient-code-review", "interpreting-codemap-output"],
+        firstTools: ["diff", "symbol"],
+        hardGates: [
+            "Lead with findings by severity.",
+            "Use changed symbols and usages before summarizing broad context.",
+        ],
+        requiredOutputs: ["Findings", "Open questions", "Test gaps"],
+        completionChecks: ["Inspect diff.", "Check usages for risky shared changes.", "Mention residual risk."],
+        phases: ["orient", "verify", "finish"],
+    },
+    refactor: {
+        taskType: "refactor",
+        description: "Behavior-preserving cleanup, symbol move, rename, or structural change.",
+        requiredSkills: [
+            "feature-area-investigation",
+            "safe-edit-and-reimport",
+            "verification-before-completion",
+        ],
+        firstTools: ["find_related_files", "symbol", "diff"],
+        hardGates: [
+            "Confirm behavior-preserving scope before edits.",
+            "Use usages/callers before moving or renaming shared symbols.",
+            "Complete verification-before-completion before declaring done.",
+        ],
+        requiredOutputs: ["Refactor scope", "Affected usages", "Verification report"],
+        completionChecks: DEFAULT_VERIFICATION_CHECKLIST,
+        phases: ["orient", "plan", "implement", "verify", "finish"],
+    },
+    test: {
+        taskType: "test",
+        description: "Add, repair, or improve tests.",
+        requiredSkills: ["test-driven-development", "verification-before-completion"],
+        firstTools: ["search_codebase", "symbol"],
+        hardGates: [
+            "Find existing test patterns before adding tests.",
+            "For bug coverage, confirm the test fails before the fix when feasible.",
+        ],
+        requiredOutputs: ["Test target", "Test command", "Verification report"],
+        completionChecks: ["Run the targeted test command.", "Inspect diff.", "Refresh local index if files changed."],
+        phases: ["orient", "implement", "verify", "finish"],
+    },
+    research: {
+        taskType: "research",
+        description: "Read-only exploration, codebase explanation, feasibility analysis, or planning.",
+        requiredSkills: ["mcp-first-exploration", "interpreting-codemap-output"],
+        firstTools: ["explore_task", "find_related_files", "get_file"],
+        hardGates: [
+            "Prefer CodeMap summaries, rankings, and next steps before opening raw files.",
+            "Do not edit files for read-only research tasks.",
+        ],
+        requiredOutputs: ["Relevant files/symbols", "Findings", "Recommended next step"],
+        completionChecks: ["Cite inspected CodeMap context.", "State confidence and unknowns."],
+        phases: ["orient", "finish"],
+    },
+};
+export const ARTIFACT_TEMPLATES = AGENT_PACK_TEMPLATES.map((template) => ({
+    id: template.id,
+    title: template.title,
+    path: template.path,
+    resourceUri: template.uri,
+}));
+export const AGENT_WORKFLOW_SUMMARY = [
+    "Use CodeMap MCP tools before raw file reads or grep.",
+    "For broad coding tasks, call explore_task first — it automatically runs keyword, edit-location, and semantic search in parallel.",
+    "For 'which files are related?' or 'what should I read?', call find_related_files — semantic similarity is a built-in signal.",
+    "For known keywords, files, symbols, or exports, call search_codebase.",
+    "For conceptual queries ('authentication flow', 'error handling') where exact names are unknown, call search_codebase(semantic=true).",
+    "After you have a shortlist, call get_file for outlines, then get_file for specific content or symbols.",
+    "Use symbol/symbol for symbol impact analysis.",
+    "Use diff after edits, then build/test as appropriate.",
+    "Call refresh_local_index after local edits; call reimport only when cloud/web indexing should refresh.",
+    "Read required CodeMap Agent Pack skills before implementing gated work.",
+];
+export const AGENT_WORKFLOW_SEQUENCE = [
+    "New session: check project-context resource. If no local index exists yet, call refresh_local_index first (no auth required).",
+    "Broad task: explore_task -> follow suggestedNextTools -> get_file. Semantic search runs automatically.",
+    "Related-file question: find_related_files(query/file_path/symbol_name) -> get_file -> get_file. Semantic signal is built in.",
+    "Narrow lookup by name: search_codebase -> get_file(include=[outline] or [symbols]).",
+    "Conceptual lookup (no exact name): search_codebase(semantic=true) -> get_file(include=[outline]).",
+    "Refactor/cleanup: symbol or symbol -> get_file(blast_radius if risky) -> diff.",
+    "Broad work: choose CodeMap exploration tools -> required skills -> design/plan gates -> implementation.",
+    "Verification: inspect diff, build/test, refresh_local_index, and decide whether cloud reimport is needed.",
+];
+export const SKILL_ROUTING_RULE_MARKDOWN = `# CodeMap Skill Routing
+
+Choose the appropriate CodeMap context tool before broad implementation, debugging, review, refactor, testing, or research tasks.
+
+## Routing Matrix
+
+${Object.values(WORKFLOW_ROUTES)
+    .map((route) => `- **${route.taskType}** — ${route.requiredSkills
+    .map((skill) => `\`codemap-${skill}\``)
+    .join(", ")}. ${route.description}`)
+    .join("\n")}
+
+## Mandatory Skill Reads
+
+- New features and vague product work require \`codemap-brainstorming\`.
+- Approved designs require \`codemap-writing-plans\`.
+- Implementation from a plan requires \`codemap-executing-plans\`, unless the task is a strict TDD task.
+- Bug fixes and tests should use \`codemap-test-driven-development\` when a test pattern exists.
+- Completion of edited work requires \`codemap-verification-before-completion\`.
+`;
+export const WORKFLOW_GATES_RULE_MARKDOWN = `# CodeMap Workflow Gates
+
+CodeMap Agent Pack uses Superpowers-style gates to keep agents from jumping into edits too early.
+
+## Gates
+
+1. **Orient** — The project-context resource is already loaded in your context — do NOT call \`get_project\` or \`list_projects\` unless the user explicitly asks for project or account info. If no local index exists yet, call \`refresh_local_index\` (no auth required). Then choose the narrowest CodeMap context tool: \`explore_task\` for broad unclear work, \`search_codebase\` for known names, \`find_related_files\` for related-file questions, or \`get_file\`/\`get_file\` for known paths.
+2. **Design** — for features or vague tasks, complete brainstorming and get design approval before editing production files.
+3. **Plan** — after design approval, write an implementation plan with exact files, steps, and verification commands.
+4. **Implement** — follow the plan or TDD loop; keep changes scoped.
+5. **Verify** — inspect diff, run relevant checks, refresh local index, and decide cloud reimport.
+6. **Finish** — summarize changed behavior, verification, skipped checks, and residual risk.
+
+Low-risk one-line fixes may use a lightweight design summary instead of a full spec, but they still require verification.
+`;
+export const VERIFICATION_BEFORE_COMPLETION_RULE_MARKDOWN = `# Verification Before Completion
+
+Never declare edited work complete until the verification checklist is done or a skipped item is explicitly explained.
+
+## Checklist
+
+${DEFAULT_VERIFICATION_CHECKLIST.map((item) => `- ${item}`).join("\n")}
+
+## Completion Summary
+
+Final responses should include changed behavior, verification commands/results, and whether local index refresh or cloud reimport was performed.
+`;
+export const MCP_FIRST_RULE_MARKDOWN = `# MCP-First Code Exploration
+
+When working in a CodeMap-indexed repository, prefer CodeMap MCP tools before raw file reads or grep.
+
+## Tool Selection
+
+Choose the tool based on the shape of the question:
+
+1. \`explore_task\` — use first for broad tasks such as "fix bug X", "implement Y", or "investigate Z". It returns likely files, entrypoints, symbols, risks, recommended reads, and suggested next tools.
+3. \`find_related_files\` — use when you already have an anchor file/symbol, or when the user asks "which files should I read?", "what is related to X?", or "what is the scope around X?".
+4. \`search_codebase\` — use for known keywords, filenames, exports, or symbols. Pass \`semantic=true\` for conceptual queries where you do not know the exact symbol name (e.g. "authentication flow", "error handling logic").
+5. \`get_file\` — fetch outlines for several candidate files in one call. Use after \`explore_task\`, \`find_related_files\`, or \`search_codebase\`.
+6. \`get_file\` — read exact content only after you know what you need. Prefer \`include=["outline"]\` for map context and \`include=["symbols"]\` with \`symbol_names\` for function/class bodies.
+7. \`symbol\` / \`symbol\` — use for symbol impact analysis. Use \`symbol\` when the symbol's file is known.
+8. \`get_project_map\` — inspect folder structure when module layout is unclear.
+9. \`diff\` — inspect uncommitted local changes (mode=working) or committed ref diffs (mode=ref).
+10. Raw Read / grep — fallback only when MCP cannot answer, such as unindexed files, dynamic string access, or complex regex searches.
+
+## Quick Decisions
+
+- "Fix/investigate/implement" with unclear files -> \`explore_task\` (semantic runs automatically).
+- "Which files are related?" -> \`find_related_files\` (semantic signal built in).
+- Known symbol or filename -> \`search_codebase\`.
+- Conceptual query, no exact name -> \`search_codebase(semantic=true)\`.
+- Several candidate files -> \`get_file\`.
+- Specific symbol body -> \`get_file(include=["symbols"], symbol_names=[...])\`.
+- Who calls/imports this? -> \`symbol\` or \`symbol\`.
+- After edits -> \`diff\`, build/test, then \`refresh_local_index\` when the local MCP index should refresh.
+`;
+export const TASK_LIFECYCLE_RULE_MARKDOWN = `# CodeMap Agent Task Lifecycle
+
+## 1. Orient
+
+- The project-context resource is already loaded in your context — skip \`get_project\` and \`list_projects\` unless the user explicitly asks for project or account info.
+- Use \`explore_task\`, \`find_related_files\`, or \`search_codebase\` according to the task shape.
+
+## 2. Read Deliberately
+
+- Use \`get_file\` to survey multiple outlines.
+- Use \`get_file(include=["outline"])\` before full content for large/unknown files.
+- Use \`get_file(include=["symbols"], symbol_names=[...])\` for exact function/class bodies.
+
+## 3. Edit Safely
+
+- Keep changes scoped to the task.
+- Follow local repo patterns.
+- Do not rewrite unrelated files or revert user changes.
+- For database changes, prefer schema-first workflows and generated migrations.
+
+## 4. Verify
+
+- Run the smallest sufficient build/test.
+- Build shared packages before dependents when applicable.
+- Use \`diff\` to confirm changed files.
+
+## 5. Refresh Index
+
+- Use \`refresh_local_index\` after local edits to refresh the MCP SQLite index without cloud access.
+- Use \`reimport\` only when the cloud index, web graph, or insights should refresh.
+
+## 6. Final Response
+
+- Summarize what changed.
+- Mention verification results.
+- Call out blockers, skipped tests, or unrelated dirty files.
+`;
+export function buildAgentWorkflowMarkdown() {
+    return [
+        "# CodeMap MCP Agent Workflow",
+        "",
+        "Use this guidance before exploring or editing a CodeMap-indexed repository.",
+        "",
+        "## Summary",
+        ...AGENT_WORKFLOW_SUMMARY.map((item) => `- ${item}`),
+        "",
+        "## Recommended Sequence",
+        ...AGENT_WORKFLOW_SEQUENCE.map((item, index) => `${index + 1}. ${item}`),
+        "",
+        "## Rule Resources",
+        `- ${MCP_FIRST_RULE_URI}`,
+        `- ${TASK_LIFECYCLE_RULE_URI}`,
+        `- ${SKILL_ROUTING_RULE_URI}`,
+        `- ${WORKFLOW_GATES_RULE_URI}`,
+        `- ${VERIFICATION_BEFORE_COMPLETION_RULE_URI}`,
+        `- ${AGENT_PACK_INDEX_URI}`,
+        `- ${AGENT_PACK_INSTALL_URI}`,
+        "",
+        "## Agent Pack Skills",
+        ...AGENT_PACK_SKILLS.map((skill) => `- ${skillResourceUri(skill)}`),
+        "",
+        "## Workflow Routing",
+        ...Object.values(WORKFLOW_ROUTES).map((route) => `- ${route.taskType}: ${route.requiredSkills
+            .map((skill) => skillResourceUri(skill))
+            .join(", ")}`),
+        "",
+        "## Artifact Templates",
+        ...ARTIFACT_TEMPLATES.map((template) => `- ${template.resourceUri} — ${template.title}`),
+        "",
+        MCP_FIRST_RULE_MARKDOWN,
+        "",
+        TASK_LIFECYCLE_RULE_MARKDOWN,
+        "",
+        SKILL_ROUTING_RULE_MARKDOWN,
+        "",
+        WORKFLOW_GATES_RULE_MARKDOWN,
+        "",
+        VERIFICATION_BEFORE_COMPLETION_RULE_MARKDOWN,
+    ].join("\n");
+}
+//# sourceMappingURL=agent-workflow.js.map

package/dist/lib/agent-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workflow.js","sourceRoot":"","sources":["../../src/lib/agent-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EAEpB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAC;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AACxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,+BAA+B,CAAC;AACtE,MAAM,CAAC,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AACxE,MAAM,CAAC,MAAM,uCAAuC,GAClD,gDAAgD,CAAC;AAEnD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS;IACT,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,UAAU;IACV,MAAM;IACN,UAAU;CACF,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,WAAW;IACX,QAAQ;IACR,QAAQ;CACA,CAAC;AAeX,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,0DAA0D;IAC1D,kDAAkD;IAClD,yEAAyE;IACzE,oDAAoD;IACpD,iEAAiE;CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,OAAO,EAAE;QACP,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,0FAA0F;QACvG,cAAc,EAAE;YACd,eAAe;YACf,eAAe;YACf,iBAAiB;YACjB,gCAAgC;SACjC;QACD,UAAU,EAAE,CAAC,cAAc,CAAC;QAC5B,SAAS,EAAE;YACT,6DAA6D;YAC7D,0EAA0E;YAC1E,gEAAgE;SACjE;QACD,eAAe,EAAE,CAAC,yBAAyB,EAAE,qBAAqB,EAAE,qBAAqB,CAAC;QAC1F,gBAAgB,EAAE,8BAA8B;QAChD,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC;KACtE;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,0DAA0D;QACvE,cAAc,EAAE;YACd,wBAAwB;YACxB,yBAAyB;YACzB,wBAAwB;YACxB,gCAAgC;SACjC;QACD,UAAU,EAAE,CAAC,cAAc,EAAE,iBAAiB,EAAE,QAAQ,CAAC;QACzD,SAAS,EAAE;YACT,8DAA8D;YAC9D,4FAA4F;YAC5F,gEAAgE;SACjE;QACD,eAAe,EAAE,CAAC,oBAAoB,EAAE,aAAa,EAAE,qBAAqB,CAAC;QAC7E,gBAAgB,EAAE,8BAA8B;QAChD,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC9D;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,iEAAiE;QAC9E,cAAc,EAAE;YACd,wBAAwB;YACxB,4BAA4B;YAC5B,6BAA6B;SAC9B;QACD,UAAU,EAAE,CAAC,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACnD,SAAS,EAAE;YACT,2EAA2E;YAC3E,+DAA+D;SAChE;QACD,eAAe,EAAE,CAAC,wBAAwB,EAAE,wBAAwB,EAAE,uBAAuB,CAAC;QAC9F,gBAAgB,EAAE,CAAC,mCAAmC,EAAE,0CAA0C,CAAC;QACnG,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;KACvC;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,0DAA0D;QACvE,cAAc,EAAE,CAAC,6BAA6B,EAAE,6BAA6B,CAAC;QAC9E,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC9B,SAAS,EAAE;YACT,iCAAiC;YACjC,kEAAkE;SACnE;QACD,eAAe,EAAE,CAAC,UAAU,EAAE,gBAAgB,EAAE,WAAW,CAAC;QAC5D,gBAAgB,EAAE,CAAC,eAAe,EAAE,wCAAwC,EAAE,wBAAwB,CAAC;QACvG,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;KACvC;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,yEAAyE;QACtF,cAAc,EAAE;YACd,4BAA4B;YAC5B,wBAAwB;YACxB,gCAAgC;SACjC;QACD,UAAU,EAAE,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC;QACpD,SAAS,EAAE;YACT,iDAAiD;YACjD,8DAA8D;YAC9D,gEAAgE;SACjE;QACD,eAAe,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,CAAC;QAC7E,gBAAgB,EAAE,8BAA8B;QAChD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC;KAC5D;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,gCAAgC;QAC7C,cAAc,EAAE,CAAC,yBAAyB,EAAE,gCAAgC,CAAC;QAC7E,UAAU,EAAE,CAAC,iBAAiB,EAAE,QAAQ,CAAC;QACzC,SAAS,EAAE;YACT,kDAAkD;YAClD,wEAAwE;SACzE;QACD,eAAe,EAAE,CAAC,aAAa,EAAE,cAAc,EAAE,qBAAqB,CAAC;QACvE,gBAAgB,EAAE,CAAC,gCAAgC,EAAE,eAAe,EAAE,uCAAuC,CAAC;QAC9G,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC;KACpD;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,iFAAiF;QAC9F,cAAc,EAAE,CAAC,uBAAuB,EAAE,6BAA6B,CAAC;QACxE,UAAU,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,UAAU,CAAC;QAC9D,SAAS,EAAE;YACT,8EAA8E;YAC9E,iDAAiD;SAClD;QACD,eAAe,EAAE,CAAC,wBAAwB,EAAE,UAAU,EAAE,uBAAuB,CAAC;QAChF,gBAAgB,EAAE,CAAC,iCAAiC,EAAE,gCAAgC,CAAC;QACvF,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;KAC7B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxE,EAAE,EAAE,QAAQ,CAAC,EAAE;IACf,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;IACnB,WAAW,EAAE,QAAQ,CAAC,GAAG;CAC1B,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,sDAAsD;IACtD,kIAAkI;IAClI,8HAA8H;IAC9H,uEAAuE;IACvE,sIAAsI;IACtI,wGAAwG;IACxG,+CAA+C;IAC/C,uDAAuD;IACvD,wGAAwG;IACxG,yEAAyE;CAC1E,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,+HAA+H;IAC/H,wGAAwG;IACxG,8HAA8H;IAC9H,qFAAqF;IACrF,mGAAmG;IACnG,gFAAgF;IAChF,yGAAyG;IACzG,2GAA2G;CAC5G,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;EAMzC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;KAC7B,GAAG,CACF,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,CAAC,QAAQ,QAAQ,KAAK,CAAC,cAAc;KAC9C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,KAAK,IAAI,CAAC;KACtC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,EAAE,CACxC;KACA,IAAI,CAAC,IAAI,CAAC;;;;;;;;;CASZ,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;CAc3C,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG;;;;;;EAM1D,8BAA8B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;CAKrE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BtC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC3C,CAAC;AAEF,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,8BAA8B;QAC9B,EAAE;QACF,6EAA6E;QAC7E,EAAE;QACF,YAAY;QACZ,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,EAAE;QACF,yBAAyB;QACzB,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACxE,EAAE;QACF,mBAAmB;QACnB,KAAK,kBAAkB,EAAE;QACzB,KAAK,uBAAuB,EAAE;QAC9B,KAAK,sBAAsB,EAAE;QAC7B,KAAK,uBAAuB,EAAE;QAC9B,KAAK,uCAAuC,EAAE;QAC9C,KAAK,oBAAoB,EAAE;QAC3B,KAAK,sBAAsB,EAAE;QAC7B,EAAE;QACF,sBAAsB;QACtB,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,EAAE;QACF,qBAAqB;QACrB,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CACnC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,cAAc;aACzC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;aACvC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClB;QACD,EAAE;QACF,uBAAuB;QACvB,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,WAAW,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxF,EAAE;QACF,uBAAuB;QACvB,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,4BAA4B;QAC5B,EAAE;QACF,4CAA4C;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/api-types.d.ts

@@ -0,0 +1,32 @@
+/** Shared response types for the CodeMap API used across MCP tools. */
+import type { Project, ProjectAnalysisSummary, ProjectFileBlastRadius, ProjectFileContent, ProjectFileContentKind, ProjectFileContentStatus, ProjectImport, ProjectImportParseStatus, ProjectImportStatus, ProjectMapInsightsResponse, ProjectMapSearchExportResult, ProjectMapSearchFileResult, ProjectMapSearchResponse, ProjectMapSearchSymbolResult } from "@codemap-ai/shared";
+export type { EditLocationConfidence, EditLocationNextTool, EditLocationReadInclude, EditLocationReadPlan, EditLocationSuggestion, EditLocationSymbol, EditLocationsResponse, FileReparseResult, GithubRepository, GitlabRepository, GithubStatus, Project, ProjectFileContent, ProjectImport, ProjectMapSnapshot, ProjectMapTreeNode, ProjectSourceImportResult, SymbolCaller, SymbolOccurrenceUsage, SymbolUsageConfidence, SymbolUsageRange, SymbolUsageTarget, SymbolUsagesResponse, WorkspaceDetail, } from "@codemap-ai/shared";
+export type ImportStatus = ProjectImportStatus;
+export type ParseStatus = ProjectImportParseStatus;
+export type ProjectDetail = Project;
+export type ProjectImportDetail = ProjectImport;
+export type TriggerImportResult = ProjectImport;
+export type FileContentStatus = ProjectFileContentStatus;
+export type FileContentKind = ProjectFileContentKind;
+export type FileContent = ProjectFileContent;
+export type SearchFileResult = ProjectMapSearchFileResult;
+export type SearchSymbolResult = ProjectMapSearchSymbolResult;
+export type SearchExportResult = ProjectMapSearchExportResult;
+export type CodebaseSearchResponse = ProjectMapSearchResponse;
+export type SemanticSearchResult = {
+    path: string;
+    symbolName?: string;
+    chunkType: string;
+    startLine?: number;
+    endLine?: number;
+    score: number;
+    snippet?: string;
+};
+export type BlastRadius = ProjectFileBlastRadius;
+export type InsightsFileEntry = ProjectMapInsightsResponse["topFilesByImportCount"][number];
+export type InsightsFolderEntry = ProjectMapInsightsResponse["topFoldersBySourceFileCount"][number];
+export type InsightsEntryLikeFile = ProjectMapInsightsResponse["entryLikeFiles"][number];
+export type InsightsCycleCandidate = ProjectMapInsightsResponse["circularDependencyCandidates"][number];
+export type ProjectInsightsSummary = ProjectMapInsightsResponse;
+export type ProjectAnalysisSummaryResponse = ProjectAnalysisSummary;
+//# sourceMappingURL=api-types.d.ts.map

package/dist/lib/api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.d.ts","sourceRoot":"","sources":["../../src/lib/api-types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,KAAK,EACV,OAAO,EACP,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,EACzB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAC/C,MAAM,MAAM,WAAW,GAAG,wBAAwB,CAAC;AACnD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;AACpC,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEhD,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,sBAAsB,CAAC;AACrD,MAAM,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAC9D,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAC3B,0BAA0B,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAC7B,0BAA0B,CAAC,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,qBAAqB,GAC/B,0BAA0B,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAChC,0BAA0B,CAAC,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,CAAC;AAChE,MAAM,MAAM,8BAA8B,GAAG,sBAAsB,CAAC"}

package/dist/lib/api-types.js

@@ -0,0 +1,3 @@
+/** Shared response types for the CodeMap API used across MCP tools. */
+export {};
+//# sourceMappingURL=api-types.js.map

package/dist/lib/api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.js","sourceRoot":"","sources":["../../src/lib/api-types.ts"],"names":[],"mappings":"AAAA,uEAAuE"}

package/dist/lib/auto-inject.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+type DetectedEditor = "claude" | "cursor" | "copilot" | "gemini" | "codex" | null;
+/**
+ * Detect which AI tool is connecting via:
+ * 1. MCP clientInfo.name from the initialize handshake (most reliable)
+ * 2. Environment variables as fallback
+ */
+export declare function detectEditor(server: McpServer): DetectedEditor;
+/**
+ * Auto-inject agent rules for the detected editor on first connect.
+ * Idempotent via .codemap-injected marker file.
+ * Non-fatal if detection or injection fails.
+ */
+export declare function autoInjectRules(server: McpServer, cwd: string): Promise<void>;
+export {};
+//# sourceMappingURL=auto-inject.d.ts.map

package/dist/lib/auto-inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-inject.d.ts","sourceRoot":"","sources":["../../src/lib/auto-inject.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,KAAK,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AA4BlF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAQ9D;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnF"}

package/dist/lib/auto-inject.js

@@ -0,0 +1,80 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+import { installAgentPack } from "./agent-pack-installer.js";
+// Known MCP client name patterns (case-insensitive substring match)
+const CLIENT_NAME_MAP = [
+    { pattern: /claude/i, target: "claude" },
+    { pattern: /cursor/i, target: "cursor" },
+    { pattern: /copilot|github/i, target: "copilot" },
+    { pattern: /gemini|google/i, target: "gemini" },
+    { pattern: /codex|openai|chatgpt/i, target: "codex" },
+];
+function detectFromClientName(name) {
+    if (!name)
+        return null;
+    for (const { pattern, target } of CLIENT_NAME_MAP) {
+        if (pattern.test(name))
+            return target;
+    }
+    return null;
+}
+function detectFromEnv() {
+    if (process.env.CLAUDE_CODE || process.env.CLAUDE_MCP_SERVER_VERSION || process.env.ANTHROPIC_MCP_SERVER)
+        return "claude";
+    if (process.env.CURSOR_MCP || process.env.CURSOR_EDITOR)
+        return "cursor";
+    if (process.env.GITHUB_COPILOT_MCP || process.env.GITHUB_COPILOT)
+        return "copilot";
+    if (process.env.GOOGLE_GEMINI_MCP || process.env.GEMINI_API_KEY)
+        return "gemini";
+    if (process.env.OPENAI_MCP || process.env.CODEX_MCP)
+        return "codex";
+    return null;
+}
+/**
+ * Detect which AI tool is connecting via:
+ * 1. MCP clientInfo.name from the initialize handshake (most reliable)
+ * 2. Environment variables as fallback
+ */
+export function detectEditor(server) {
+    // Primary: clientInfo from MCP protocol (available after server.connect())
+    const clientInfo = server.server.getClientVersion();
+    const fromProtocol = detectFromClientName(clientInfo?.name);
+    if (fromProtocol)
+        return fromProtocol;
+    // Fallback: environment variables
+    return detectFromEnv();
+}
+/**
+ * Auto-inject agent rules for the detected editor on first connect.
+ * Idempotent via .codemap-injected marker file.
+ * Non-fatal if detection or injection fails.
+ */
+export async function autoInjectRules(server, cwd) {
+    const editor = detectEditor(server);
+    const clientInfo = server.server.getClientVersion();
+    const clientName = clientInfo?.name ?? "(unknown)";
+    if (!editor) {
+        process.stderr.write(`[CodeMap] Client detected: "${clientName}" — no matching editor target, skipping auto-inject.\n`);
+        return;
+    }
+    // Idempotent: skip if already injected
+    const markerFile = path.join(cwd, ".codemap-injected");
+    try {
+        const marker = await import("node:fs/promises").then((fs) => fs.readFile(markerFile, "utf-8"));
+        if (marker.includes(editor))
+            return; // Already injected for this editor
+    }
+    catch {
+        // Marker not found or unreadable — proceed
+    }
+    try {
+        await installAgentPack({ target: editor, cwd, force: false });
+        await writeFile(markerFile, `${editor}\n${clientName}\n${new Date().toISOString()}\n`, "utf-8");
+        process.stderr.write(`[CodeMap] Auto-injected agent rules for ${editor} (client: "${clientName}").\n`);
+    }
+    catch (err) {
+        process.stderr.write(`[CodeMap] Auto-inject failed (non-fatal): ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}
+//# sourceMappingURL=auto-inject.js.map

package/dist/lib/auto-inject.js.map

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

package/dist/lib/bundled-runtime.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns the package root directory.
+ *
+ * Works in both source (tsx) and bundled (tsup dist/) runtimes.
+ * Pass the caller's own `import.meta.url` so the result is relative to the
+ * actual file location.
+ */
+export declare function getPackageRoot(callerImportMetaUrl: string): string;
+//# sourceMappingURL=bundled-runtime.d.ts.map

package/dist/lib/bundled-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-runtime.d.ts","sourceRoot":"","sources":["../../src/lib/bundled-runtime.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAWlE"}

package/dist/lib/bundled-runtime.js

@@ -0,0 +1,20 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Returns the package root directory.
+ *
+ * Works in both source (tsx) and bundled (tsup dist/) runtimes.
+ * Pass the caller's own `import.meta.url` so the result is relative to the
+ * actual file location.
+ */
+export function getPackageRoot(callerImportMetaUrl) {
+    const callerDir = path.dirname(fileURLToPath(callerImportMetaUrl));
+    // Source (tsx): caller is somewhere under <pkg>/src/… → go up to src/ then one more.
+    const srcIdx = callerDir.lastIndexOf(`${path.sep}src${path.sep}`);
+    if (srcIdx !== -1) {
+        return path.resolve(callerDir.slice(0, srcIdx));
+    }
+    // Bundled (tsup): caller is at <pkg>/dist/ → go up one level.
+    return path.resolve(callerDir, "..");
+}
+//# sourceMappingURL=bundled-runtime.js.map

package/dist/lib/bundled-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-runtime.js","sourceRoot":"","sources":["../../src/lib/bundled-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,mBAA2B;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAEnE,qFAAqF;IACrF,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,8DAA8D;IAC9D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/codemap-api.d.ts

@@ -0,0 +1,22 @@
+import type { McpServerConfig } from "../config.js";
+type RequestOptions = {
+    method?: "GET" | "POST" | "PATCH" | "DELETE";
+    body?: unknown;
+    query?: Record<string, string | undefined>;
+    authRequired?: boolean;
+};
+type UploadOptions = {
+    query?: Record<string, string | undefined>;
+    authRequired?: boolean;
+};
+/**
+ * Creates a typed API client bound to a MCP server config.
+ * All methods throw on HTTP errors — callers should wrap with `withToolError`.
+ */
+export declare function createCodeMapClient(config: McpServerConfig): {
+    request: <T>(path: string, options?: RequestOptions) => Promise<T>;
+    upload: <T>(path: string, buffer: Buffer, options?: UploadOptions) => Promise<T>;
+};
+export type CodeMapClient = ReturnType<typeof createCodeMapClient>;
+export {};
+//# sourceMappingURL=codemap-api.d.ts.map

package/dist/lib/codemap-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemap-api.d.ts","sourceRoot":"","sources":["../../src/lib/codemap-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,KAAK,cAAc,GAAG;IACpB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe;cAqClC,CAAC,QAAQ,MAAM,YAAY,cAAc,KAAG,OAAO,CAAC,CAAC,CAAC;aAyBvD,CAAC,QACf,MAAM,UACJ,MAAM,YACJ,aAAa,KACtB,OAAO,CAAC,CAAC,CAAC;EAyBd;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/lib/codemap-api.js

@@ -0,0 +1,74 @@
+/**
+ * Creates a typed API client bound to a MCP server config.
+ * All methods throw on HTTP errors — callers should wrap with `withToolError`.
+ */
+export function createCodeMapClient(config) {
+    function buildUrl(path, query) {
+        const url = new URL(path, config.apiUrl);
+        for (const [key, value] of Object.entries(query ?? {})) {
+            if (value !== undefined)
+                url.searchParams.set(key, value);
+        }
+        return url;
+    }
+    function buildAuthHeaders(extra) {
+        const headers = { ...extra };
+        if (config.apiToken) {
+            headers["x-api-key"] = config.apiToken;
+            headers["Authorization"] = `Bearer ${config.apiToken}`;
+        }
+        return headers;
+    }
+    async function handleResponse(response) {
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new Error(`CodeMap API returned ${response.status} ${response.statusText}. ${body}`.trim());
+        }
+        const json = (await response.json());
+        if (json.data === undefined)
+            throw new Error("Unexpected response from API.");
+        return json.data;
+    }
+    function checkAuth(required) {
+        if (required && !config.apiToken) {
+            throw new Error("Not authenticated. Run `codemap login`.");
+        }
+    }
+    async function request(path, options) {
+        checkAuth(options?.authRequired);
+        const url = buildUrl(path, options?.query);
+        const hasBody = options?.body !== undefined;
+        const headers = buildAuthHeaders(hasBody ? { "Content-Type": "application/json" } : undefined);
+        let response;
+        try {
+            response = await fetch(url.toString(), {
+                method: options?.method ?? "GET",
+                headers,
+                body: hasBody ? JSON.stringify(options.body) : undefined,
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to reach CodeMap API at ${config.apiUrl}. ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return handleResponse(response);
+    }
+    async function upload(path, buffer, options) {
+        checkAuth(options?.authRequired);
+        const url = buildUrl(path, options?.query);
+        const headers = buildAuthHeaders({ "Content-Type": "application/zip" });
+        let response;
+        try {
+            response = await fetch(url.toString(), {
+                method: "POST",
+                headers,
+                body: Buffer.from(buffer),
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to reach CodeMap API at ${config.apiUrl}. ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return handleResponse(response);
+    }
+    return { request, upload };
+}
+//# sourceMappingURL=codemap-api.js.map