@hubblecommerce/overmind-core 0.1.7 → 0.1.9

package/dist/src/config/app.config.d.ts

@@ -49,5 +49,9 @@ export declare const config: {
         suggestionsSpaceId: string;
         suggestionsParentId: string;
     };
+    intake: {
+        url: string;
+        internalToken: string;
+    };
 };
 //# sourceMappingURL=app.config.d.ts.map

package/dist/src/config/app.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.config.d.ts","sourceRoot":"","sources":["../../../src/config/app.config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDlB,CAAC"}
+{"version":3,"file":"app.config.d.ts","sourceRoot":"","sources":["../../../src/config/app.config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDlB,CAAC"}

package/dist/src/config/app.config.js

@@ -49,4 +49,8 @@ export const config = {
         suggestionsSpaceId: process.env.CONFLUENCE_SUGGESTIONS_SPACE_ID || '',
         suggestionsParentId: process.env.CONFLUENCE_SUGGESTIONS_PARENT_ID || '',
     },
+    intake: {
+        url: process.env.INTAKE_URL || 'http://localhost:3002',
+        internalToken: process.env.INTAKE_INTERNAL_TOKEN || '',
+    },
 };

package/dist/src/tools/repository.tool.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export declare function createSearchRepositoryTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    projectId: z.ZodString;
+    pattern: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    pattern: string;
+}, {
+    projectId: string;
+    pattern: string;
+}>, {
+    projectId: string;
+    pattern: string;
+}, {
+    projectId: string;
+    pattern: string;
+}, string, unknown, "search_repository_code">;
+export declare function createGetRepositoryFileTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    projectId: z.ZodString;
+    filePath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    filePath: string;
+}, {
+    projectId: string;
+    filePath: string;
+}>, {
+    projectId: string;
+    filePath: string;
+}, {
+    projectId: string;
+    filePath: string;
+}, string, unknown, "get_repository_file">;
+export declare function createGetRepositoryStructureTool(): import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+    projectId: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    path?: string | undefined;
+    depth?: number | undefined;
+}, {
+    projectId: string;
+    path?: string | undefined;
+    depth?: number | undefined;
+}>, {
+    projectId: string;
+    path?: string | undefined;
+    depth?: number | undefined;
+}, {
+    projectId: string;
+    path?: string | undefined;
+    depth?: number | undefined;
+}, string, unknown, "get_repository_structure">;
+//# sourceMappingURL=repository.tool.d.ts.map

package/dist/src/tools/repository.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/repository.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,wBAAgB,0BAA0B;;;;;;;;;;;;;;;8CAyBzC;AAED,wBAAgB,2BAA2B;;;;;;;;;;;;;;;2CAyB1C;AAED,wBAAgB,gCAAgC;;;;;;;;;;;;;;;;;;;;gDA6B/C"}

package/dist/src/tools/repository.tool.js

@@ -0,0 +1,94 @@
+import { tool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { config } from '../config/app.config.js';
+async function intakeRequest(endpoint, body) {
+    const response = await fetch(`${config.intake.url}/repository${endpoint}`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${config.intake.internalToken}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`Intake API error: ${response.status} ${error}`);
+    }
+    return response.json();
+}
+export function createSearchRepositoryTool() {
+    return tool(async ({ projectId, pattern }) => {
+        try {
+            const result = await intakeRequest('/search', { projectId, pattern });
+            return JSON.stringify({
+                output: result.output,
+                totalMatches: result.totalMatches,
+                truncated: result.truncated,
+            });
+        }
+        catch (error) {
+            return JSON.stringify({ error: true, message: String(error) });
+        }
+    }, {
+        name: 'search_repository_code',
+        description: `Search a GitLab repository's code for a pattern. Returns matching lines grouped by file path with surrounding context.
+Use specific patterns to get focused results — broad patterns may be truncated.
+The 'truncated' flag indicates the query was too broad; narrow the pattern and retry.`,
+        schema: z.object({
+            projectId: z.string().describe('GitLab project path (e.g. "group/project")'),
+            pattern: z.string().describe('Search pattern (JavaScript regex syntax)'),
+        }),
+    });
+}
+export function createGetRepositoryFileTool() {
+    return tool(async ({ projectId, filePath }) => {
+        try {
+            const result = await intakeRequest('/file', { projectId, filePath });
+            return JSON.stringify({
+                content: result.content,
+                totalChars: result.totalChars,
+                truncated: result.truncated,
+            });
+        }
+        catch (error) {
+            return JSON.stringify({ error: true, message: String(error) });
+        }
+    }, {
+        name: 'get_repository_file',
+        description: `Get the full content of a specific file from a GitLab repository.
+Use after finding relevant files via search_repository_code or get_repository_structure.
+Large files may be truncated.`,
+        schema: z.object({
+            projectId: z.string().describe('GitLab project path (e.g. "group/project")'),
+            filePath: z.string().describe('Path to the file within the repository (e.g. "src/index.ts")'),
+        }),
+    });
+}
+export function createGetRepositoryStructureTool() {
+    return tool(async ({ projectId, path, depth }) => {
+        try {
+            const result = await intakeRequest('/structure', {
+                projectId,
+                path,
+                depth,
+            });
+            return JSON.stringify({
+                structure: result.structure,
+                truncated: result.truncated,
+            });
+        }
+        catch (error) {
+            return JSON.stringify({ error: true, message: String(error) });
+        }
+    }, {
+        name: 'get_repository_structure',
+        description: `Get the directory structure of a GitLab repository as an indented file tree.
+By default shows top-level only (depth 1). Use 'path' to drill into a subdirectory and 'depth' to control levels.
+Start with depth 1 to orient, then drill deeper into relevant directories.`,
+        schema: z.object({
+            projectId: z.string().describe('GitLab project path (e.g. "group/project")'),
+            path: z.string().optional().describe('Subdirectory to start from (e.g. "src/components")'),
+            depth: z.number().optional().describe('How many levels deep to show (default: 1)'),
+        }),
+    });
+}

package/dist/src/types/repository.types.d.ts

@@ -0,0 +1,22 @@
+export interface RepositorySearchResponse {
+    projectId: string;
+    pattern: string;
+    output: string;
+    totalMatches: number;
+    truncated: boolean;
+}
+export interface RepositoryFileResponse {
+    projectId: string;
+    filePath: string;
+    content: string;
+    totalChars: number;
+    truncated: boolean;
+}
+export interface RepositoryStructureResponse {
+    projectId: string;
+    path: string;
+    depth: number;
+    structure: string;
+    truncated: boolean;
+}
+//# sourceMappingURL=repository.types.d.ts.map

package/dist/src/types/repository.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.types.d.ts","sourceRoot":"","sources":["../../../src/types/repository.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACtB"}

package/dist/src/types/repository.types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/utils/repomix-search.d.ts

@@ -17,6 +17,12 @@ interface SearchOptions {
     ignoreCase?: boolean;
     contextLines?: number;
 }
+interface DirectoryStructureOptions {
+    /** Subtree root path to start from (e.g. "app/components"). Default: root */
+    path?: string;
+    /** How many levels deep to return. Default: 1 (top-level only) */
+    depth?: number;
+}
 /**
  * Search a repomix XML string for lines matching a pattern.
  * Returns matching lines with optional context.
@@ -28,5 +34,10 @@ export declare function searchRepomix(xml: string, pattern: string, options?: Se
  * Returns null if the file is not found.
  */
 export declare function getRepomixFile(xml: string, filePath: string): string | null;
+/**
+ * Extract the directory structure from repomix XML.
+ * Returns an indented tree filtered by optional path and depth.
+ */
+export declare function getRepomixDirectoryStructure(xml: string, options?: DirectoryStructureOptions): string | null;
 export {};
 //# sourceMappingURL=repomix-search.d.ts.map

package/dist/src/utils/repomix-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repomix-search.d.ts","sourceRoot":"","sources":["../../../src/utils/repomix-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,YAAY;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,aAAa;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAmGD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CASjG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E"}
+{"version":3,"file":"repomix-search.d.ts","sourceRoot":"","sources":["../../../src/utils/repomix-search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,YAAY;IAClB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,aAAa;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,yBAAyB;IAC/B,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAmGD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CASjG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,CA0D5G"}

package/dist/src/utils/repomix-search.js

@@ -105,3 +105,57 @@ export function getRepomixFile(xml, filePath) {
         return null;
     return match[1];
 }
+/**
+ * Extract the directory structure from repomix XML.
+ * Returns an indented tree filtered by optional path and depth.
+ */
+export function getRepomixDirectoryStructure(xml, options) {
+    const match = xml.match(/<directory_structure>\n?([\s\S]*?)\n?<\/directory_structure>/);
+    if (!match?.[1])
+        return null;
+    const fullTree = match[1];
+    const lines = fullTree.split('\n');
+    const targetPath = options?.path?.replace(/\/$/, '') ?? '';
+    const maxDepth = options?.depth ?? 1;
+    const getDepth = (line) => {
+        const leadingSpaces = line.match(/^( *)/)?.[1].length ?? 0;
+        return leadingSpaces / 2;
+    };
+    // Build full paths from indented tree using a stack
+    const pathStack = [];
+    if (!targetPath) {
+        return lines
+            .filter(line => line.trim() && getDepth(line) < maxDepth)
+            .join('\n');
+    }
+    // Find the subtree starting at targetPath
+    let inSubtree = false;
+    let subtreeBaseDepth = 0;
+    const result = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const depth = getDepth(line);
+        // Maintain path stack: trim to current depth, then push
+        pathStack.length = depth;
+        pathStack.push(trimmed.replace(/\/$/, ''));
+        const fullPath = pathStack.join('/');
+        if (!inSubtree) {
+            if (fullPath === targetPath) {
+                inSubtree = true;
+                subtreeBaseDepth = depth + 1;
+                result.push(trimmed);
+            }
+            continue;
+        }
+        if (depth < subtreeBaseDepth) {
+            break;
+        }
+        const relativeDepth = depth - subtreeBaseDepth;
+        if (relativeDepth < maxDepth) {
+            result.push('  '.repeat(relativeDepth) + trimmed);
+        }
+    }
+    return result.length > 0 ? result.join('\n') : null;
+}

package/dist/src/utils/repomix-search.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { searchRepomix, getRepomixFile } from './repomix-search.js';
+import { searchRepomix, getRepomixFile, getRepomixDirectoryStructure } from './repomix-search.js';
 const SAMPLE_XML = `<file path="src/index.ts">
 import { App } from './app';
 
@@ -25,6 +25,27 @@ export function login(username: string, password: string) {
     });
 }
 </file>`;
+const SAMPLE_XML_WITH_STRUCTURE = `<directory_structure>
+app/
+  components/
+    Header.vue
+    Footer.vue
+  pages/
+    index.vue
+    about.vue
+  middleware/
+    auth.ts
+config/
+  app.config.ts
+package.json
+README.md
+</directory_structure>
+
+<files>
+<file path="app/components/Header.vue">
+<template><header></header></template>
+</file>
+</files>`;
 describe('searchRepomix', () => {
     it('returns matching lines with file context', () => {
         const results = searchRepomix(SAMPLE_XML, 'auth');
@@ -86,3 +107,36 @@ describe('getRepomixFile', () => {
         expect(content).toContain("import { App }");
     });
 });
+describe('getRepomixDirectoryStructure', () => {
+    it('returns top-level entries by default (depth 1)', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE);
+        expect(result).toContain('app/');
+        expect(result).toContain('config/');
+        expect(result).toContain('package.json');
+        expect(result).not.toContain('Header.vue');
+        expect(result).not.toContain('pages/');
+    });
+    it('returns deeper entries when depth is increased', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE, { depth: 2 });
+        expect(result).toContain('app/');
+        expect(result).toContain('components/');
+        expect(result).toContain('pages/');
+        expect(result).not.toContain('Header.vue');
+    });
+    it('returns a subtree when path is specified', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE, { path: 'app/components', depth: 1 });
+        expect(result).toContain('components/');
+        expect(result).toContain('Header.vue');
+        expect(result).toContain('Footer.vue');
+        expect(result).not.toContain('pages/');
+        expect(result).not.toContain('config/');
+    });
+    it('returns null when directory_structure section is missing', () => {
+        const result = getRepomixDirectoryStructure('<file path="test.ts">code</file>');
+        expect(result).toBeNull();
+    });
+    it('returns null when path does not exist in tree', () => {
+        const result = getRepomixDirectoryStructure(SAMPLE_XML_WITH_STRUCTURE, { path: 'nonexistent' });
+        expect(result).toBeNull();
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubblecommerce/overmind-core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "description": "Shared infrastructure package for the Overmind AI agent system",
   "main": "./dist/src/index.js",
@@ -53,6 +53,14 @@
     "./utils/repomix-search": {
       "types": "./dist/src/utils/repomix-search.d.ts",
       "default": "./dist/src/utils/repomix-search.js"
+    },
+    "./tools/repository": {
+      "types": "./dist/src/tools/repository.tool.d.ts",
+      "default": "./dist/src/tools/repository.tool.js"
+    },
+    "./types/repository": {
+      "types": "./dist/src/types/repository.types.d.ts",
+      "default": "./dist/src/types/repository.types.js"
     }
   },
   "files": [