pulseed 0.5.2 → 0.5.3

package/dist/tools/query/CodeSearchTool/CodeSearchTool.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { SearchOrchestrator } from "../../../platform/code-search/orchestrator.js";
+import { saveCodeSearchSession } from "../../../platform/code-search/session-store.js";
+import { validateFilePath } from "../../fs/FileValidationTool/FileValidationTool.js";
+import { MAX_OUTPUT_CHARS, PERMISSION_LEVEL, READ_ONLY, TAGS } from "./constants.js";
+import { DESCRIPTION } from "./prompt.js";
+export const CodeSearchInputSchema = z.object({
+    task: z.string().min(1),
+    intent: z.enum(["bugfix", "test_failure", "feature_addition", "refactor", "explain", "api_change", "config_fix", "security_review", "unknown"]).optional(),
+    queryTerms: z.array(z.string()).optional(),
+    stacktrace: z.string().optional(),
+    fileGlobs: z.array(z.string()).optional(),
+    packageScope: z.string().optional(),
+    path: z.string().optional(),
+    budget: z.object({
+        maxFiles: z.number().int().positive().optional(),
+        maxCandidatesPerRetriever: z.number().int().positive().optional(),
+        maxFusionCandidates: z.number().int().positive().optional(),
+        maxRerankCandidates: z.number().int().positive().optional(),
+    }).optional(),
+    outputLimit: z.number().int().positive().max(40).optional(),
+});
+function compactCandidate(candidate) {
+    return {
+        id: candidate.id,
+        file: candidate.file,
+        range: candidate.range,
+        symbol: candidate.symbol ? {
+            name: candidate.symbol.name,
+            kind: candidate.symbol.kind,
+            stableKey: candidate.symbol.stableKey,
+        } : undefined,
+        confidence: candidate.confidence,
+        readRecommendation: candidate.readRecommendation,
+        rerankScore: Number(candidate.rerankScore.toFixed(3)),
+        retrievers: candidate.sourceRetrievers.slice(0, 3),
+        reason: candidate.reasons[0],
+    };
+}
+export class CodeSearchTool {
+    metadata = {
+        name: "code_search",
+        aliases: ["code-search", "structured_code_search"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: READ_ONLY,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: true,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = CodeSearchInputSchema;
+    description() {
+        return DESCRIPTION;
+    }
+    async call(input, context) {
+        const startTime = Date.now();
+        const cwd = input.path ? validateFilePath(input.path, context.cwd).resolved : context.cwd;
+        const orchestrator = new SearchOrchestrator(cwd);
+        const session = await orchestrator.searchWithState({ ...input, cwd });
+        saveCodeSearchSession(session, cwd);
+        const visibleCandidates = session.candidates.slice(0, input.outputLimit ?? 20);
+        return {
+            success: true,
+            data: {
+                queryId: session.queryId,
+                candidates: visibleCandidates.map(compactCandidate),
+                candidateIds: visibleCandidates.map((candidate) => candidate.id),
+                totalCandidates: session.candidates.length,
+                trace: {
+                    queryId: session.trace.queryId,
+                    retrieversUsed: session.trace.retrieversUsed,
+                },
+                warnings: session.trace.warnings.slice(0, 5),
+            },
+            summary: `Code search returned ${session.candidates.length} ranked candidates for ${input.intent ?? "inferred"} intent`,
+            durationMs: Date.now() - startTime,
+            artifacts: visibleCandidates.map((candidate) => candidate.file),
+        };
+    }
+    async checkPermissions(input, context) {
+        if (!context || !input.path)
+            return { status: "allowed" };
+        const validation = validateFilePath(input.path, context.cwd, context.executionPolicy?.protectedPaths);
+        if (!validation.valid) {
+            return { status: "needs_approval", reason: `Searching outside the working directory: ${validation.resolved}` };
+        }
+        return { status: "allowed" };
+    }
+    isConcurrencySafe() {
+        return true;
+    }
+}
+//# sourceMappingURL=CodeSearchTool.js.map

package/dist/tools/query/CodeSearchTool/CodeSearchTool.js.map

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

package/dist/tools/query/CodeSearchTool/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const PERMISSION_LEVEL: "read_only";
+export declare const READ_ONLY = true;
+export declare const MAX_OUTPUT_CHARS = 24000;
+export declare const TAGS: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/tools/query/CodeSearchTool/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/CodeSearchTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC;AACrD,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,eAAO,MAAM,IAAI,UAA4C,CAAC"}

package/dist/tools/query/CodeSearchTool/constants.js

@@ -0,0 +1,5 @@
+export const PERMISSION_LEVEL = "read_only";
+export const READ_ONLY = true;
+export const MAX_OUTPUT_CHARS = 24_000;
+export const TAGS = ["filesystem", "search", "code", "query"];
+//# sourceMappingURL=constants.js.map

package/dist/tools/query/CodeSearchTool/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/query/CodeSearchTool/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAoB,CAAC;AACrD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/tools/query/CodeSearchTool/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION: string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/tools/query/CodeSearchTool/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/CodeSearchTool/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,QAIb,CAAC"}

package/dist/tools/query/CodeSearchTool/prompt.js

@@ -0,0 +1,6 @@
+export const DESCRIPTION = [
+    "Search repository code with PulSeed's structured code-search orchestrator.",
+    "Returns compact candidate handles plus a queryId; pass queryId and candidateIds to code_read_context to read full stored candidates.",
+    "Prefer this over raw grep/read for coding, repo inspection, bugfix, test failure, and refactor tasks.",
+].join(" ");
+//# sourceMappingURL=prompt.js.map

package/dist/tools/query/CodeSearchTool/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/tools/query/CodeSearchTool/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,4EAA4E;IAC5E,sIAAsI;IACtI,uGAAuG;CACxG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulseed",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "AI agent orchestrator that gives existing agents the drive to persist — set a goal, and PulSeed observes, delegates, verifies, and loops until done.",
   "type": "module",
   "main": "dist/index.js",
@@ -63,6 +63,7 @@
     "test:all": "npm run test:unit && npm run test:smoke && npm run test:integration",
     "test:e2e": "vitest run tests/e2e",
     "test:dogfood": "vitest run src/orchestrator/execution/agent-loop/__tests__/agent-loop-dogfood-benchmark.test.ts",
+    "test:kaggle-training": "vitest run src/orchestrator/execution/agent-loop/__tests__/kaggle-training-benchmark.test.ts",
     "dogfood:agentloop:real": "npm run build && node dist/orchestrator/execution/agent-loop/agent-loop-real-dogfood.js",
     "test:changed": "node scripts/test-changed.mjs",
     "test:watch": "vitest --config vitest.unit.config.ts",