pulseed 0.2.0 → 0.4.0

package/dist/tools/query/GoalStateTool/GoalStateTool.js

@@ -0,0 +1,128 @@
+import { z } from "zod";
+import { DESCRIPTION } from "./prompt.js";
+import { TAGS, PERMISSION_LEVEL, MAX_OUTPUT_CHARS } from "./constants.js";
+export const GoalStateInputSchema = z.object({
+    goalId: z.string().optional(),
+    includeTree: z.boolean().default(false),
+});
+export class GoalStateTool {
+    stateManager;
+    metadata = {
+        name: "goal_state",
+        aliases: ["get_goal_state", "observe_goal"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = GoalStateInputSchema;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    description(_context) {
+        return DESCRIPTION;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            if (input.goalId) {
+                return await this._singleGoal(input.goalId, input.includeTree, startTime);
+            }
+            return await this._allGoals(startTime);
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: null,
+                summary: "GoalStateTool failed: " + err.message,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async _singleGoal(goalId, includeTree, startTime) {
+        const goal = await this.stateManager.loadGoal(goalId);
+        if (!goal) {
+            return {
+                success: false,
+                data: null,
+                summary: "Goal not found: " + goalId,
+                error: "Goal not found: " + goalId,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        const data = {
+            id: goal.id,
+            title: goal.title,
+            status: goal.status,
+            loop_status: goal.loop_status,
+            dimensions: goal.dimensions.map((d) => ({
+                name: d.name,
+                label: d.label,
+                current_value: d.current_value,
+                threshold: d.threshold,
+                confidence: d.confidence,
+                last_updated: d.last_updated,
+                weight: d.weight,
+            })),
+        };
+        if (includeTree && goal.children_ids.length > 0) {
+            const subtree = await this.stateManager.getSubtree(goalId);
+            data["subtree"] = subtree
+                .filter((g) => g.id !== goalId)
+                .map((g) => ({ id: g.id, title: g.title, status: g.status, parent_id: g.parent_id }));
+        }
+        return {
+            success: true,
+            data,
+            summary: "Goal " + goalId + ": status=" + goal.status + ", " + goal.dimensions.length + " dimensions",
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async _allGoals(startTime) {
+        const goalIds = await this.stateManager.listGoalIds();
+        if (goalIds.length === 0) {
+            return {
+                success: true,
+                data: { goals: [] },
+                summary: "No active goals found",
+                durationMs: Date.now() - startTime,
+            };
+        }
+        const goals = await Promise.all(goalIds.map(async (id) => {
+            const g = await this.stateManager.loadGoal(id);
+            if (!g)
+                return null;
+            return {
+                id: g.id,
+                title: g.title,
+                status: g.status,
+                loop_status: g.loop_status,
+                dimension_count: g.dimensions.length,
+                dimensions: g.dimensions.map((d) => ({
+                    name: d.name,
+                    current_value: d.current_value,
+                    confidence: d.confidence,
+                })),
+            };
+        }));
+        const filtered = goals.filter(Boolean);
+        return {
+            success: true,
+            data: { goals: filtered },
+            summary: "Found " + filtered.length + " active goal(s)",
+            durationMs: Date.now() - startTime,
+        };
+    }
+    async checkPermissions(_input, _context) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=GoalStateTool.js.map

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

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

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

@@ -0,0 +1,6 @@
+export declare const TAGS: readonly ["observe", "goal", "self-grounding"];
+export declare const CATEGORY = "query";
+export declare const MAX_OUTPUT_CHARS = 8000;
+export declare const READ_ONLY = true;
+export declare const PERMISSION_LEVEL: "read_only";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/GoalStateTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,gDAAiD,CAAC;AACnE,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC"}

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

@@ -0,0 +1,6 @@
+export const TAGS = ["observe", "goal", "self-grounding"];
+export const CATEGORY = "query";
+export const MAX_OUTPUT_CHARS = 8000;
+export const READ_ONLY = true;
+export const PERMISSION_LEVEL = "read_only";
+//# sourceMappingURL=constants.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION = "Observe PulSeed internal goal state. Returns dimensions, thresholds, current values, gap scores, and confidence for one or all active goals.";
+//# sourceMappingURL=prompt.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const DESCRIPTION = "Observe PulSeed internal goal state. Returns dimensions, thresholds, current values, gap scores, and confidence for one or all active goals.";
+//# sourceMappingURL=prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/tools/query/GoalStateTool/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,8IAA8I,CAAC"}

package/dist/tools/query/KnowledgeQueryTool/KnowledgeQueryTool.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata, ToolDescriptionContext } from "../../types.js";
+import type { KnowledgeManager } from "../../../platform/knowledge/knowledge-manager.js";
+export declare const KnowledgeQueryInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    goalId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    type: z.ZodDefault<z.ZodEnum<["semantic", "keyword"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "semantic" | "keyword";
+    query: string;
+    limit: number;
+    goalId?: string | undefined;
+}, {
+    query: string;
+    type?: "semantic" | "keyword" | undefined;
+    goalId?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type KnowledgeQueryInput = z.infer<typeof KnowledgeQueryInputSchema>;
+export interface KnowledgeQueryResultItem {
+    entryId: string;
+    content: string;
+    confidence: number;
+    source: string;
+    goalId: string | null;
+    relevance?: number;
+}
+export interface KnowledgeQueryOutput {
+    results: KnowledgeQueryResultItem[];
+    totalFound: number;
+}
+export declare class KnowledgeQueryTool implements ITool<KnowledgeQueryInput, KnowledgeQueryOutput> {
+    private readonly knowledgeManager;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        query: z.ZodString;
+        goalId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        type: z.ZodDefault<z.ZodEnum<["semantic", "keyword"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "semantic" | "keyword";
+        query: string;
+        limit: number;
+        goalId?: string | undefined;
+    }, {
+        query: string;
+        type?: "semantic" | "keyword" | undefined;
+        goalId?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    constructor(knowledgeManager: KnowledgeManager);
+    description(_context?: ToolDescriptionContext): string;
+    call(input: KnowledgeQueryInput, _context: ToolCallContext): Promise<ToolResult>;
+    private _search;
+    private _keywordSearch;
+    private _semanticSearch;
+    checkPermissions(_input: KnowledgeQueryInput, _context?: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input?: KnowledgeQueryInput): boolean;
+}
+//# sourceMappingURL=KnowledgeQueryTool.d.ts.map

package/dist/tools/query/KnowledgeQueryTool/KnowledgeQueryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeQueryTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/KnowledgeQueryTool/KnowledgeQueryTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAGzF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AA6BD,qBAAa,kBACX,YAAW,KAAK,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAiB/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAf7C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;OAA6B;gBAEpB,gBAAgB,EAAE,gBAAgB;IAE/D,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAIhD,IAAI,CACR,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC;YA4BR,OAAO;YASP,cAAc;YAsBd,eAAe;IA8BvB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI/G,iBAAiB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO;CAGzD"}

package/dist/tools/query/KnowledgeQueryTool/KnowledgeQueryTool.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { DESCRIPTION } from "./prompt.js";
+import { TAGS, PERMISSION_LEVEL, MAX_OUTPUT_CHARS } from "./constants.js";
+export const KnowledgeQueryInputSchema = z.object({
+    query: z.string().min(1),
+    goalId: z.string().optional(),
+    limit: z.number().int().min(1).max(50).default(5),
+    type: z.enum(["semantic", "keyword"]).default("keyword"),
+});
+function entryToItem(entry, goalId, relevance) {
+    return {
+        entryId: entry.entry_id,
+        content: `Q: ${entry.question}\nA: ${entry.answer}`,
+        confidence: entry.confidence,
+        source: entry.sources.length > 0
+            ? (entry.sources[0]?.reference ?? "unknown")
+            : "unknown",
+        goalId,
+        ...(relevance !== undefined ? { relevance } : {}),
+    };
+}
+function keywordMatch(entry, query) {
+    const lower = query.toLowerCase();
+    return (entry.question.toLowerCase().includes(lower) ||
+        entry.answer.toLowerCase().includes(lower) ||
+        entry.tags.some((t) => t.toLowerCase().includes(lower)));
+}
+export class KnowledgeQueryTool {
+    knowledgeManager;
+    metadata = {
+        name: "knowledge_query",
+        aliases: ["query_knowledge", "search_knowledge"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = KnowledgeQueryInputSchema;
+    constructor(knowledgeManager) {
+        this.knowledgeManager = knowledgeManager;
+    }
+    description(_context) {
+        return DESCRIPTION;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            const items = await this._search(input);
+            const limited = items.slice(0, input.limit);
+            const output = {
+                results: limited,
+                totalFound: items.length,
+            };
+            return {
+                success: true,
+                data: output,
+                summary: `Found ${items.length} knowledge entries for query "${input.query}"${items.length > input.limit ? ` (showing first ${input.limit})` : ""}`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: { results: [], totalFound: 0 },
+                summary: `Knowledge query failed: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async _search(input) {
+        if (input.type === "semantic") {
+            return this._semanticSearch(input);
+        }
+        return this._keywordSearch(input);
+    }
+    async _keywordSearch(input) {
+        if (input.goalId) {
+            const entries = await this.knowledgeManager.loadKnowledge(input.goalId);
+            return entries
+                .filter((e) => keywordMatch(e, input.query))
+                .map((e) => entryToItem(e, input.goalId ?? null));
+        }
+        // Cross-goal keyword search via shared KB
+        const shared = await this.knowledgeManager.querySharedKnowledge([]);
+        return shared
+            .filter((e) => keywordMatch(e, input.query))
+            .map((e) => entryToItem(e, e.source_goal_ids[0] ?? null));
+    }
+    async _semanticSearch(input) {
+        if (input.goalId) {
+            // Try semantic via searchKnowledge (VectorIndex), fall back to keyword
+            const entries = await this.knowledgeManager.searchKnowledge(input.query, input.limit);
+            if (entries.length > 0) {
+                return entries.map((e) => entryToItem(e, input.goalId ?? null));
+            }
+            return this._keywordSearch(input);
+        }
+        // Cross-goal semantic search
+        const results = await this.knowledgeManager.searchByEmbedding(input.query, input.limit);
+        if (results.length > 0) {
+            return results.map(({ entry, similarity }) => entryToItem(entry, entry.source_goal_ids[0] ?? null, similarity));
+        }
+        // Fall back to keyword
+        return this._keywordSearch(input);
+    }
+    async checkPermissions(_input, _context) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=KnowledgeQueryTool.js.map

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

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

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

@@ -0,0 +1,6 @@
+export declare const TAGS: readonly ["knowledge", "observe", "self-grounding"];
+export declare const CATEGORY = "query";
+export declare const MAX_OUTPUT_CHARS = 8000;
+export declare const READ_ONLY = true;
+export declare const PERMISSION_LEVEL: "read_only";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/KnowledgeQueryTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,qDAAsD,CAAC;AACxE,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC"}

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

@@ -0,0 +1,6 @@
+export const TAGS = ["knowledge", "observe", "self-grounding"];
+export const CATEGORY = "query";
+export const MAX_OUTPUT_CHARS = 8000;
+export const READ_ONLY = true;
+export const PERMISSION_LEVEL = "read_only";
+//# sourceMappingURL=constants.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION = "Query PulSeed's knowledge base. Supports keyword or semantic search across stored knowledge entries.";
+//# sourceMappingURL=prompt.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const DESCRIPTION = "Query PulSeed's knowledge base. Supports keyword or semantic search across stored knowledge entries.";
+//# sourceMappingURL=prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/tools/query/KnowledgeQueryTool/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,sGAAsG,CAAC"}

package/dist/tools/query/MemoryRecallTool/MemoryRecallTool.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata, ToolDescriptionContext } from "../../types.js";
+import type { KnowledgeManager } from "../../../platform/knowledge/knowledge-manager.js";
+import type { AgentMemoryEntry } from "../../../platform/knowledge/types/agent-memory.js";
+export declare const MemoryRecallInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    exact: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    category: z.ZodOptional<z.ZodString>;
+    memory_type: z.ZodOptional<z.ZodEnum<["fact", "procedure", "preference", "observation"]>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["keyword", "semantic"]>>>;
+}, "strip", z.ZodTypeAny, {
+    exact: boolean;
+    query: string;
+    mode: "semantic" | "keyword";
+    limit: number;
+    include_archived: boolean;
+    category?: string | undefined;
+    memory_type?: "observation" | "fact" | "procedure" | "preference" | undefined;
+}, {
+    query: string;
+    exact?: boolean | undefined;
+    category?: string | undefined;
+    mode?: "semantic" | "keyword" | undefined;
+    memory_type?: "observation" | "fact" | "procedure" | "preference" | undefined;
+    limit?: number | undefined;
+    include_archived?: boolean | undefined;
+}>;
+export type MemoryRecallInput = z.input<typeof MemoryRecallInputSchema>;
+export interface MemoryRecallOutput {
+    entries: AgentMemoryEntry[];
+    totalFound: number;
+}
+export declare class MemoryRecallTool implements ITool<MemoryRecallInput, MemoryRecallOutput> {
+    private readonly knowledgeManager;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        query: z.ZodString;
+        exact: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        category: z.ZodOptional<z.ZodString>;
+        memory_type: z.ZodOptional<z.ZodEnum<["fact", "procedure", "preference", "observation"]>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        include_archived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["keyword", "semantic"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        exact: boolean;
+        query: string;
+        mode: "semantic" | "keyword";
+        limit: number;
+        include_archived: boolean;
+        category?: string | undefined;
+        memory_type?: "observation" | "fact" | "procedure" | "preference" | undefined;
+    }, {
+        query: string;
+        exact?: boolean | undefined;
+        category?: string | undefined;
+        mode?: "semantic" | "keyword" | undefined;
+        memory_type?: "observation" | "fact" | "procedure" | "preference" | undefined;
+        limit?: number | undefined;
+        include_archived?: boolean | undefined;
+    }>;
+    constructor(knowledgeManager: KnowledgeManager);
+    description(_context?: ToolDescriptionContext): string;
+    call(input: MemoryRecallInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input?: MemoryRecallInput, _context?: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input?: MemoryRecallInput): boolean;
+}
+//# sourceMappingURL=MemoryRecallTool.d.ts.map

package/dist/tools/query/MemoryRecallTool/MemoryRecallTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryRecallTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/MemoryRecallTool/MemoryRecallTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAE1F,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EAoClC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBACX,YAAW,KAAK,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAiB3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAf7C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;OAA2B;gBAElB,gBAAgB,EAAE,gBAAgB;IAE/D,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAIhD,IAAI,CACR,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC;IAuChB,gBAAgB,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9G,iBAAiB,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,OAAO;CAGvD"}

package/dist/tools/query/MemoryRecallTool/MemoryRecallTool.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { DESCRIPTION } from "./prompt.js";
+import { TAGS, PERMISSION_LEVEL, MAX_OUTPUT_CHARS } from "./constants.js";
+export const MemoryRecallInputSchema = z.object({
+    query: z
+        .string()
+        .describe("Search query (key for exact match, or keywords for search)"),
+    exact: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("If true, match key exactly; if false, keyword search across key+value+tags"),
+    category: z.string().optional().describe("Filter by category"),
+    memory_type: z
+        .enum(["fact", "procedure", "preference", "observation"])
+        .optional()
+        .describe("Filter by memory type"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .default(10)
+        .describe("Maximum results to return"),
+    include_archived: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Include archived entries in results"),
+    mode: z
+        .enum(["keyword", "semantic"])
+        .optional()
+        .default("keyword")
+        .describe("Search mode: keyword (substring match) or semantic (embedding-based similarity)"),
+});
+export class MemoryRecallTool {
+    knowledgeManager;
+    metadata = {
+        name: "memory_recall",
+        aliases: ["recall_memory", "remember_query"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = MemoryRecallInputSchema;
+    constructor(knowledgeManager) {
+        this.knowledgeManager = knowledgeManager;
+    }
+    description(_context) {
+        return DESCRIPTION;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        const parsedInput = this.inputSchema.parse(input);
+        try {
+            const entries = await this.knowledgeManager.recallAgentMemory(parsedInput.query, {
+                exact: parsedInput.exact,
+                category: parsedInput.category,
+                memory_type: parsedInput.memory_type,
+                limit: parsedInput.limit,
+                include_archived: parsedInput.include_archived,
+                semantic: parsedInput.mode === "semantic",
+            });
+            const output = {
+                entries,
+                totalFound: entries.length,
+            };
+            return {
+                success: true,
+                data: output,
+                summary: `Found ${entries.length} memory entries for query "${parsedInput.query}"`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: { entries: [], totalFound: 0 },
+                summary: `Memory recall failed: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async checkPermissions(_input, _context) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=MemoryRecallTool.js.map

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

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

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

@@ -0,0 +1,6 @@
+export declare const TAGS: readonly ["memory", "recall", "knowledge"];
+export declare const CATEGORY = "query";
+export declare const MAX_OUTPUT_CHARS = 8000;
+export declare const READ_ONLY = true;
+export declare const PERMISSION_LEVEL: "read_only";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/MemoryRecallTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,4CAA6C,CAAC;AAC/D,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,SAAS,OAAO,CAAC;AAC9B,eAAO,MAAM,gBAAgB,EAAG,WAAoB,CAAC"}

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

@@ -0,0 +1,6 @@
+export const TAGS = ["memory", "recall", "knowledge"];
+export const CATEGORY = "query";
+export const MAX_OUTPUT_CHARS = 8000;
+export const READ_ONLY = true;
+export const PERMISSION_LEVEL = "read_only";
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/query/MemoryRecallTool/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AACrC,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAoB,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION = "Search goal-independent agent memory by keyword or exact key. Returns matching memory entries using tiered retrieval: compiled entries (with summaries) are returned first, followed by raw entries, both sorted by most recently updated. Archived entries are excluded by default (use include_archived=true to include them). Use this to recall previously saved facts, procedures, preferences, or observations.";
+//# sourceMappingURL=prompt.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const DESCRIPTION = "Search goal-independent agent memory by keyword or exact key. Returns matching memory entries using tiered retrieval: compiled entries (with summaries) are returned first, followed by raw entries, both sorted by most recently updated. Archived entries are excluded by default (use include_archived=true to include them). Use this to recall previously saved facts, procedures, preferences, or observations.";
+//# sourceMappingURL=prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/tools/query/MemoryRecallTool/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GACtB,uZAAuZ,CAAC"}