pulseed 0.4.18 → 0.4.19

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

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata, ToolDescriptionContext } from "../../types.js";
+import type { PluginLoader } from "../../../runtime/plugin-loader.js";
+export declare const PluginStateToolInputSchema: z.ZodObject<{
+    pluginId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pluginId?: string | undefined;
+}, {
+    pluginId?: string | undefined;
+}>;
+export type PluginStateToolInput = z.infer<typeof PluginStateToolInputSchema>;
+export declare class PluginStateTool implements ITool<PluginStateToolInput, unknown> {
+    private readonly pluginLoader;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        pluginId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        pluginId?: string | undefined;
+    }, {
+        pluginId?: string | undefined;
+    }>;
+    constructor(pluginLoader: PluginLoader);
+    description(_context?: ToolDescriptionContext): string;
+    call(input: PluginStateToolInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: PluginStateToolInput, _context?: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input?: PluginStateToolInput): boolean;
+}
+//# sourceMappingURL=PluginStateTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginStateTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/PluginStateTool/PluginStateTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGtI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE,eAAO,MAAM,0BAA0B;;;;;;EAErC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,qBAAa,eAAgB,YAAW,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAe9D,OAAO,CAAC,QAAQ,CAAC,YAAY;IAdzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IACF,QAAQ,CAAC,WAAW;;;;;;OAA8B;gBAErB,YAAY,EAAE,YAAY;IAEvD,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAIhD,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAyDjF,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIhH,iBAAiB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO;CAG1D"}

package/dist/tools/query/PluginStateTool/PluginStateTool.js

@@ -0,0 +1,91 @@
+import { z } from "zod";
+import { DESCRIPTION } from "./prompt.js";
+import { TAGS, PERMISSION_LEVEL, MAX_OUTPUT_CHARS } from "./constants.js";
+import { listBuiltinIntegrations } from "../../../runtime/builtin-integrations.js";
+export const PluginStateToolInputSchema = z.object({
+    pluginId: z.string().optional(),
+});
+export class PluginStateTool {
+    pluginLoader;
+    metadata = {
+        name: "get_plugins",
+        aliases: ["plugin_state", "list_plugins"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = PluginStateToolInputSchema;
+    constructor(pluginLoader) {
+        this.pluginLoader = pluginLoader;
+    }
+    description(_context) {
+        return DESCRIPTION;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            const allStates = await this.pluginLoader.loadAll();
+            const plugins = allStates.map((p) => ({
+                name: p.name,
+                type: p.manifest.type,
+                enabled: p.status === "loaded",
+                status: p.status,
+            }));
+            const builtinIntegrations = listBuiltinIntegrations();
+            if (input.pluginId) {
+                const match = plugins.find((p) => p.name === input.pluginId);
+                const builtinMatch = builtinIntegrations.find((integration) => integration.id === input.pluginId);
+                if (builtinMatch) {
+                    return {
+                        success: true,
+                        data: builtinMatch,
+                        summary: `Builtin integration ${builtinMatch.id}: kind=${builtinMatch.kind}, status=${builtinMatch.status}`,
+                        durationMs: Date.now() - startTime,
+                    };
+                }
+                if (!match) {
+                    return {
+                        success: false,
+                        data: null,
+                        summary: `Plugin not found: ${input.pluginId}`,
+                        error: `Plugin not found: ${input.pluginId}`,
+                        durationMs: Date.now() - startTime,
+                    };
+                }
+                return {
+                    success: true,
+                    data: match,
+                    summary: `Plugin ${match.name}: type=${match.type}, enabled=${String(match.enabled)}, status=${match.status}`,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            return {
+                success: true,
+                data: { plugins, builtin_integrations: builtinIntegrations },
+                summary: `Found ${plugins.length} plugin(s) and ${builtinIntegrations.length} builtin integration(s)`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: null,
+                summary: "PluginStateTool failed: " + err.message,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async checkPermissions(_input, _context) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=PluginStateTool.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/PluginStateTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,wCAAyC,CAAC;AAC3D,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/PluginStateTool/constants.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/query/PluginStateTool/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,gBAAgB,CAAU,CAAC;AAC3D,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/PluginStateTool/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION = "List loaded PulSeed plugins and their status (name, type, enabled). Optionally filter by pluginId.";
+//# sourceMappingURL=prompt.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const DESCRIPTION = "List loaded PulSeed plugins and their status (name, type, enabled). Optionally filter by pluginId.";
+//# sourceMappingURL=prompt.js.map

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

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

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

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata, ToolDescriptionContext } from "../../types.js";
+import type { StateManager } from "../../../base/state/state-manager.js";
+export declare const ProgressHistoryInputSchema: z.ZodObject<{
+    goalId: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    dimensionName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    goalId: string;
+    limit: number;
+    dimensionName?: string | undefined;
+}, {
+    goalId: string;
+    dimensionName?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type ProgressHistoryInput = z.infer<typeof ProgressHistoryInputSchema>;
+export type TrendLabel = "improving" | "stagnating" | "declining" | "insufficient_data";
+export interface HistoryDimensionSnapshot {
+    name: string;
+    value: number;
+    confidence: number;
+    gap: number;
+}
+export interface HistoryPoint {
+    iteration: number;
+    timestamp: string;
+    dimensions: HistoryDimensionSnapshot[];
+}
+export interface ProgressHistoryOutput {
+    goalId: string;
+    history: HistoryPoint[];
+    trend: TrendLabel;
+}
+export declare class ProgressHistoryTool implements ITool<ProgressHistoryInput, ProgressHistoryOutput> {
+    private readonly stateManager;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        goalId: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+        dimensionName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        goalId: string;
+        limit: number;
+        dimensionName?: string | undefined;
+    }, {
+        goalId: string;
+        dimensionName?: string | undefined;
+        limit?: number | undefined;
+    }>;
+    constructor(stateManager: StateManager);
+    description(_context?: ToolDescriptionContext): string;
+    call(input: ProgressHistoryInput, _context: ToolCallContext): Promise<ToolResult>;
+    checkPermissions(_input: ProgressHistoryInput, _context?: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input?: ProgressHistoryInput): boolean;
+}
+//# sourceMappingURL=ProgressHistoryTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressHistoryTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/ProgressHistoryTool/ProgressHistoryTool.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,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAGzE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,YAAY,GACZ,WAAW,GACX,mBAAmB,CAAC;AAExB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,wBAAwB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;CACnB;AAsGD,qBAAa,mBACX,YAAW,KAAK,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IAiBjD,OAAO,CAAC,QAAQ,CAAC,YAAY;IAfzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IAEF,QAAQ,CAAC,WAAW;;;;;;;;;;;;OAA8B;gBAErB,YAAY,EAAE,YAAY;IAEvD,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAIhD,IAAI,CACR,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,UAAU,CAAC;IAmChB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIhH,iBAAiB,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO;CAG1D"}

package/dist/tools/query/ProgressHistoryTool/ProgressHistoryTool.js

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import { DESCRIPTION } from "./prompt.js";
+import { TAGS, PERMISSION_LEVEL, MAX_OUTPUT_CHARS } from "./constants.js";
+export const ProgressHistoryInputSchema = z.object({
+    goalId: z.string().min(1),
+    limit: z.number().int().min(1).max(100).default(10),
+    dimensionName: z.string().optional(),
+});
+/**
+ * Compute trend from the last 3 gap values for the primary dimension.
+ * Lower gap = better. Improving = gap decreasing consistently.
+ */
+function computeTrend(history, dimensionName) {
+    if (history.length < 3)
+        return "insufficient_data";
+    const last3 = history.slice(-3);
+    const getGap = (point) => {
+        if (dimensionName) {
+            const dim = point.dimensions.find((d) => d.name === dimensionName);
+            return dim?.gap ?? null;
+        }
+        // Use average gap across all dimensions
+        if (point.dimensions.length === 0)
+            return null;
+        const sum = point.dimensions.reduce((acc, d) => acc + d.gap, 0);
+        return sum / point.dimensions.length;
+    };
+    const gaps = last3.map(getGap);
+    if (gaps.some((g) => g === null))
+        return "insufficient_data";
+    const [g0, g1, g2] = gaps;
+    const STAGNATE_THRESHOLD = 0.05;
+    const diff1 = g1 - g0; // negative = improving
+    const diff2 = g2 - g1; // negative = improving
+    // Improving: both diffs consistently negative (gap shrinking)
+    if (diff1 < -STAGNATE_THRESHOLD && diff2 < -STAGNATE_THRESHOLD) {
+        return "improving";
+    }
+    // Declining: both diffs consistently positive (gap growing)
+    if (diff1 > STAGNATE_THRESHOLD && diff2 > STAGNATE_THRESHOLD) {
+        return "declining";
+    }
+    // Stagnating: changes within threshold
+    if (Math.abs(diff1) <= STAGNATE_THRESHOLD &&
+        Math.abs(diff2) <= STAGNATE_THRESHOLD) {
+        return "stagnating";
+    }
+    return "stagnating";
+}
+function entryToHistoryPoint(entry, dimensionName) {
+    let dims;
+    if (dimensionName) {
+        const gapDim = entry.gap_vector.find((g) => g.dimension_name === dimensionName);
+        const confDim = entry.confidence_vector.find((c) => c.dimension_name === dimensionName);
+        if (gapDim) {
+            dims = [
+                {
+                    name: dimensionName,
+                    value: 1 - gapDim.normalized_weighted_gap, // approximate value as 1-gap
+                    confidence: confDim?.confidence ?? 0,
+                    gap: gapDim.normalized_weighted_gap,
+                },
+            ];
+        }
+        else {
+            dims = [];
+        }
+    }
+    else {
+        dims = entry.gap_vector.map((g) => {
+            const confDim = entry.confidence_vector.find((c) => c.dimension_name === g.dimension_name);
+            return {
+                name: g.dimension_name,
+                value: 1 - g.normalized_weighted_gap,
+                confidence: confDim?.confidence ?? 0,
+                gap: g.normalized_weighted_gap,
+            };
+        });
+    }
+    return {
+        iteration: entry.iteration,
+        timestamp: entry.timestamp,
+        dimensions: dims,
+    };
+}
+export class ProgressHistoryTool {
+    stateManager;
+    metadata = {
+        name: "progress_history",
+        aliases: ["get_progress", "observation_history"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: false,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = ProgressHistoryInputSchema;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    description(_context) {
+        return DESCRIPTION;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            const rawHistory = await this.stateManager.loadGapHistory(input.goalId);
+            const limited = rawHistory.slice(-input.limit);
+            const history = limited.map((entry) => entryToHistoryPoint(entry, input.dimensionName));
+            const trend = computeTrend(history, input.dimensionName);
+            const output = {
+                goalId: input.goalId,
+                history,
+                trend,
+            };
+            return {
+                success: true,
+                data: output,
+                summary: `Progress history for goal "${input.goalId}": ${history.length} iterations, trend=${trend}`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: { goalId: input.goalId, history: [], trend: "insufficient_data" },
+                summary: `Progress history failed: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async checkPermissions(_input, _context) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=ProgressHistoryTool.js.map

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

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

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

@@ -0,0 +1,6 @@
+export declare const TAGS: readonly ["observe", "progress", "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/ProgressHistoryTool/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/ProgressHistoryTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oDAAqD,CAAC;AACvE,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/ProgressHistoryTool/constants.js

@@ -0,0 +1,6 @@
+export const TAGS = ["observe", "progress", "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/ProgressHistoryTool/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/query/ProgressHistoryTool/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,gBAAgB,CAAU,CAAC;AACvE,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/ProgressHistoryTool/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION = "Retrieve time-series progress history for a goal's dimensions. Returns dimension gap values per iteration and a trend label (improving/stagnating/declining/insufficient_data).";
+//# sourceMappingURL=prompt.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const DESCRIPTION = "Retrieve time-series progress history for a goal's dimensions. Returns dimension gap values per iteration and a trend label (improving/stagnating/declining/insufficient_data).";
+//# sourceMappingURL=prompt.js.map

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

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

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

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import type { ITool, ToolResult, ToolCallContext, PermissionCheckResult, ToolMetadata, ToolDescriptionContext } from "../../types.js";
+import type { StateManager } from "../../../base/state/state-manager.js";
+export declare const SessionHistoryInputSchema: z.ZodObject<{
+    goalId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    includeObservations: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    includeObservations: boolean;
+    goalId?: string | undefined;
+}, {
+    goalId?: string | undefined;
+    limit?: number | undefined;
+    includeObservations?: boolean | undefined;
+}>;
+export type SessionHistoryInput = z.infer<typeof SessionHistoryInputSchema>;
+export declare class SessionHistoryTool implements ITool<SessionHistoryInput, unknown> {
+    private readonly stateManager;
+    readonly metadata: ToolMetadata;
+    readonly inputSchema: z.ZodObject<{
+        goalId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodDefault<z.ZodNumber>;
+        includeObservations: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        includeObservations: boolean;
+        goalId?: string | undefined;
+    }, {
+        goalId?: string | undefined;
+        limit?: number | undefined;
+        includeObservations?: boolean | undefined;
+    }>;
+    constructor(stateManager: StateManager);
+    description(_context?: ToolDescriptionContext): string;
+    call(input: SessionHistoryInput, _context: ToolCallContext): Promise<ToolResult>;
+    private _loadSessions;
+    private _toSummary;
+    checkPermissions(_input: SessionHistoryInput, _context?: ToolCallContext): Promise<PermissionCheckResult>;
+    isConcurrencySafe(_input?: SessionHistoryInput): boolean;
+}
+//# sourceMappingURL=SessionHistoryTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHistoryTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/SessionHistoryTool/SessionHistoryTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAGtI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAY5E,qBAAa,kBAAmB,YAAW,KAAK,CAAC,mBAAmB,EAAE,OAAO,CAAC;IAehE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAdzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAW7B;IACF,QAAQ,CAAC,WAAW;;;;;;;;;;;;OAA6B;gBAEpB,YAAY,EAAE,YAAY;IAEvD,WAAW,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM;IAIhD,IAAI,CAAC,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;YAqBxE,aAAa;IAiC3B,OAAO,CAAC,UAAU;IA8BZ,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/SessionHistoryTool/SessionHistoryTool.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { DESCRIPTION } from "./prompt.js";
+import { TAGS, PERMISSION_LEVEL, MAX_OUTPUT_CHARS } from "./constants.js";
+// NOTE: fs.readdirSync is used only for listing filenames (safe). All file READS go through stateManager.readRaw().
+export const SessionHistoryInputSchema = z.object({
+    goalId: z.string().optional(),
+    limit: z.number().int().positive().default(5),
+    includeObservations: z.boolean().default(true),
+});
+export class SessionHistoryTool {
+    stateManager;
+    metadata = {
+        name: "session_history",
+        aliases: ["get_session_history", "observe_sessions"],
+        permissionLevel: PERMISSION_LEVEL,
+        isReadOnly: true,
+        isDestructive: false,
+        shouldDefer: true,
+        alwaysLoad: false,
+        maxConcurrency: 0,
+        maxOutputChars: MAX_OUTPUT_CHARS,
+        tags: [...TAGS],
+    };
+    inputSchema = SessionHistoryInputSchema;
+    constructor(stateManager) {
+        this.stateManager = stateManager;
+    }
+    description(_context) {
+        return DESCRIPTION;
+    }
+    async call(input, _context) {
+        const startTime = Date.now();
+        try {
+            const sessions = await this._loadSessions(input);
+            return {
+                success: true,
+                data: { sessions },
+                summary: `Found ${sessions.length} session(s)`,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                data: null,
+                summary: `SessionHistoryTool failed: ${err.message}`,
+                error: err.message,
+                durationMs: Date.now() - startTime,
+            };
+        }
+    }
+    async _loadSessions(input) {
+        const baseDir = this.stateManager.getBaseDir();
+        const sessionsDir = path.join(baseDir, "sessions");
+        if (!fs.existsSync(sessionsDir)) {
+            return [];
+        }
+        // Listing filenames is safe; all file READS go through stateManager.readRaw() (path traversal protection).
+        const files = fs
+            .readdirSync(sessionsDir)
+            .filter((f) => f.endsWith(".json"));
+        // Filter by goalId if provided
+        const summaries = [];
+        for (const file of files) {
+            try {
+                const raw = await this.stateManager.readRaw(`sessions/${file}`);
+                if (raw == null)
+                    continue;
+                const session = this._toSummary(raw, input.includeObservations);
+                if (!session)
+                    continue;
+                if (input.goalId && session.goalId !== input.goalId)
+                    continue;
+                summaries.push(session);
+            }
+            catch {
+                // skip unparseable files
+            }
+        }
+        // Sort by actual timestamp descending (ISO 8601 strings sort lexicographically), then take limit
+        summaries.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+        return summaries.slice(0, input.limit);
+    }
+    _toSummary(raw, includeObservations) {
+        const id = typeof raw["id"] === "string" ? raw["id"] : undefined;
+        const goalId = typeof raw["goal_id"] === "string" ? raw["goal_id"] : undefined;
+        const startedAt = typeof raw["started_at"] === "string" ? raw["started_at"] : new Date(0).toISOString();
+        if (!id || !goalId)
+            return null;
+        const summary = {
+            sessionId: id,
+            goalId,
+            timestamp: startedAt,
+        };
+        if (typeof raw["result_summary"] === "string") {
+            summary.taskSummary = raw["result_summary"];
+        }
+        if (typeof raw["session_type"] === "string") {
+            summary.strategy = raw["session_type"];
+        }
+        if (raw["ended_at"] != null) {
+            summary.outcome = raw["ended_at"] ? "completed" : "in_progress";
+        }
+        if (includeObservations && raw["context_slots"] != null) {
+            summary.observations = raw["context_slots"];
+        }
+        return summary;
+    }
+    async checkPermissions(_input, _context) {
+        return { status: "allowed" };
+    }
+    isConcurrencySafe(_input) {
+        return true;
+    }
+}
+//# sourceMappingURL=SessionHistoryTool.js.map

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

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

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

@@ -0,0 +1,6 @@
+export declare const TAGS: readonly ["observe", "session", "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/SessionHistoryTool/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/query/SessionHistoryTool/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,mDAAoD,CAAC;AACtE,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/SessionHistoryTool/constants.js

@@ -0,0 +1,6 @@
+export const TAGS = ["observe", "session", "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/SessionHistoryTool/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/query/SessionHistoryTool/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAU,CAAC;AACtE,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/SessionHistoryTool/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const DESCRIPTION = "Observe recent PulSeed session history. Returns session summaries including task executed, strategy used, observations, and outcome.";
+//# sourceMappingURL=prompt.d.ts.map

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

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

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

@@ -0,0 +1,2 @@
+export const DESCRIPTION = "Observe recent PulSeed session history. Returns session summaries including task executed, strategy used, observations, and outcome.";
+//# sourceMappingURL=prompt.js.map