abmind 0.2.6 → 0.2.7-alpha.0

package/dist/src/pi-plugin/index.js

@@ -0,0 +1,139 @@
+import { logInfo, logWarn } from "../mem-logger.js";
+import { extractEnglishTokens } from "../query-tokenizer.js";
+import { createPiRuntime, hasDegraded } from "./runtime.js";
+import { buildIdentity } from "./identity.js";
+import { extractAssistantText, composeAbmindContext } from "./messages.js";
+import { createRecallTool, createStoreTool } from "./tools.js";
+import { createAbtarsStatusTool, createAbtarsNotifyTool, createAbtarsTaskQueueTool, createAbtarsTaskStatusTool, createAbtarsPeerListTool, createAbtarsPeerDelegateTool, } from "./abtars-tools.js";
+const TAG = "pi-plugin";
+const RECALL_POLICY = { limit: 5, maxChars: 8_000, minScore: 0.25, maxClassification: 2 };
+export default async function abmindPiPlugin(pi) {
+    const runtime = await createPiRuntime();
+    if (hasDegraded(runtime)) {
+        logWarn(TAG, "Running in degraded mode — memory unavailable");
+    }
+    pi.on("session_start", async (event, ctx) => {
+        logInfo(TAG, `session_start: ${event.reason}`);
+        const { identity } = buildIdentity(event, ctx);
+        runtime.state.identity = identity;
+        runtime.state.runGeneration = 0;
+        runtime.state.lastCapturedGeneration = -1;
+        runtime.state.pendingUserPrompt = null;
+        if (!runtime.state.lifecycle) {
+            runtime.state.pendingWakeUp = "";
+            return;
+        }
+        try {
+            const result = await runtime.state.lifecycle.startSession({
+                identity,
+                maxChars: 12_000,
+            });
+            if (result.ok) {
+                runtime.state.pendingWakeUp = result.context;
+            }
+            else {
+                runtime.state.pendingWakeUp = "";
+            }
+        }
+        catch {
+            runtime.state.pendingWakeUp = "";
+        }
+    });
+    pi.on("before_agent_start", async (event, _ctx) => {
+        runtime.state.runGeneration++;
+        runtime.state.pendingUserPrompt = event.prompt;
+        if (!event.prompt.trim())
+            return;
+        const identity = runtime.state.identity;
+        if (!identity || !runtime.state.lifecycle)
+            return;
+        let recall = "";
+        try {
+            const tokens = extractEnglishTokens(event.prompt);
+            const result = await runtime.state.lifecycle.prepareTurn({
+                identity,
+                prompt: event.prompt,
+                query: { translated: tokens.length > 0 ? tokens : [event.prompt], original: event.prompt },
+                policy: RECALL_POLICY,
+            });
+            recall = result.context;
+        }
+        catch {
+            recall = "";
+        }
+        const wakeUp = runtime.state.pendingWakeUp;
+        if (wakeUp) {
+            runtime.state.pendingWakeUp = "";
+        }
+        const composed = composeAbmindContext(wakeUp, recall);
+        if (!composed)
+            return;
+        pi.sendMessage({
+            customType: "abmind-context",
+            content: composed,
+            display: false,
+            details: {
+                executionId: identity.executionId,
+                wakeUp: !!wakeUp,
+                recallHits: recall ? recall.split("\n").filter(l => l.startsWith("- (")).length : 0,
+            },
+        });
+    });
+    pi.on("agent_end", async (event, _ctx) => {
+        const identity = runtime.state.identity;
+        if (!identity || !runtime.state.lifecycle)
+            return;
+        const currentGeneration = runtime.state.runGeneration;
+        const userPrompt = runtime.state.pendingUserPrompt;
+        runtime.state.pendingUserPrompt = null;
+        if (currentGeneration <= runtime.state.lastCapturedGeneration)
+            return;
+        if (!userPrompt)
+            return;
+        const assistantText = extractAssistantText(event.messages);
+        if (!assistantText)
+            return;
+        try {
+            const result = runtime.state.lifecycle.completeTurn({
+                identity,
+                user: { content: userPrompt },
+                assistant: { content: assistantText },
+            });
+            if (result.status === "recorded") {
+                runtime.state.lastCapturedGeneration = currentGeneration;
+            }
+        }
+        catch {
+            // fail-open
+        }
+    });
+    pi.on("session_compact", async (_event, _ctx) => {
+        // No lifecycle operation — Pi owns compaction.
+    });
+    pi.on("session_shutdown", async (_event, _ctx) => {
+        runtime.state.pendingUserPrompt = null;
+        runtime.state.identity = null;
+        runtime.state.pendingWakeUp = "";
+        runtime.state.runGeneration = 0;
+        runtime.state.lastCapturedGeneration = -1;
+        runtime.close();
+    });
+    if (runtime.state.lifecycle) {
+        const getIdentity = () => {
+            if (!runtime.state.identity) {
+                throw new Error("No active identity — session_start not yet called");
+            }
+            return runtime.state.identity;
+        };
+        pi.registerTool(createRecallTool({ lifecycle: runtime.state.lifecycle, getIdentity }));
+        pi.registerTool(createStoreTool({ lifecycle: runtime.state.lifecycle, getIdentity }));
+    }
+    // #1313 — Pi-to-abtars capability bridge tools (always registered, report unavailable if no credential)
+    pi.registerTool(createAbtarsStatusTool());
+    pi.registerTool(createAbtarsNotifyTool());
+    pi.registerTool(createAbtarsTaskQueueTool());
+    pi.registerTool(createAbtarsTaskStatusTool());
+    pi.registerTool(createAbtarsPeerListTool());
+    pi.registerTool(createAbtarsPeerDelegateTool());
+}
+//# sourceMappingURL=index.js.map

package/dist/src/pi-plugin/index.js.map

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

package/dist/src/pi-plugin/messages.d.ts

@@ -0,0 +1,4 @@
+import type { AgentMessage } from "./pi-types.js";
+export declare function extractAssistantText(messages: AgentMessage[]): string | undefined;
+export declare function composeAbmindContext(wakeUp: string, recall: string): string | undefined;
+//# sourceMappingURL=messages.d.ts.map

package/dist/src/pi-plugin/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/pi-plugin/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,eAAe,CAAC;AAIjF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,SAAS,CAejF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBvF"}

package/dist/src/pi-plugin/messages.js

@@ -0,0 +1,36 @@
+const COMPOSITION_MAX_CHARS = 16_000;
+export function extractAssistantText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role !== "assistant")
+            continue;
+        const asst = msg;
+        if (asst.stopReason !== "stop")
+            continue;
+        const textParts = [];
+        for (const block of asst.content) {
+            if (block.type === "text") {
+                textParts.push(block.text);
+            }
+        }
+        if (textParts.length > 0)
+            return textParts.join("\n");
+    }
+    return undefined;
+}
+export function composeAbmindContext(wakeUp, recall) {
+    const sections = [];
+    if (wakeUp.trim()) {
+        sections.push(`[Wake-up context]\n${wakeUp.trim()}`);
+    }
+    if (recall.trim()) {
+        sections.push(`[Memory recall]\n${recall.trim()}`);
+    }
+    if (sections.length === 0)
+        return undefined;
+    const joined = sections.join("\n\n");
+    if (joined.length <= COMPOSITION_MAX_CHARS)
+        return joined;
+    return joined.slice(0, COMPOSITION_MAX_CHARS);
+}
+//# sourceMappingURL=messages.js.map

package/dist/src/pi-plugin/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/pi-plugin/messages.ts"],"names":[],"mappings":"AAEA,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC,MAAM,UAAU,oBAAoB,CAAC,QAAwB;IAC3D,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QACzB,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QACvC,MAAM,IAAI,GAAG,GAAuB,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM;YAAE,SAAS;QACzC,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC1B,SAAS,CAAC,IAAI,CAAE,KAAqB,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,MAAc;IACjE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,IAAI,qBAAqB;QAAE,OAAO,MAAM,CAAC;IAE1D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAChD,CAAC"}

package/dist/src/pi-plugin/pi-types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Ambient type declarations for Pi extension API types.
+ *
+ * These types are provided by the Pi host at runtime via
+ * `@earendil-works/pi-coding-agent`, `@earendil-works/pi-agent-core`,
+ * and `@earendil-works/pi-ai`. We declare them here so the pi-plugin
+ * module compiles without those packages installed.
+ *
+ * At runtime inside Pi, the actual packages supply the real types and
+ * values. Standalone abmind must not import this file at the root level.
+ */
+import type { TSchema } from "@sinclair/typebox";
+export interface ExtensionAPI {
+    on<E = unknown, R = void>(event: string, handler: (event: E, ctx: ExtensionContext) => R | Promise<R>): void;
+    registerTool<TParams extends TSchema = TSchema, TDetails = unknown>(tool: ToolDefinition<TParams, TDetails>): void;
+    sendMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details">, options?: {
+        triggerTurn?: boolean;
+        deliverAs?: "steer" | "followUp" | "nextTurn";
+    }): void;
+    events: EventBus;
+}
+export interface ExtensionContext {
+    sessionManager: ReadonlySessionManager;
+    signal: AbortSignal | undefined;
+    cwd: string;
+}
+export interface ReadonlySessionManager {
+    getSessionId(): string;
+}
+export interface EventBus {
+    emit(event: string, data: unknown): void;
+}
+export interface SessionStartEvent {
+    type: "session_start";
+    reason: "startup" | "reload" | "new" | "resume" | "fork";
+    previousSessionFile?: string;
+}
+export interface BeforeAgentStartEvent {
+    type: "before_agent_start";
+    prompt: string;
+    systemPrompt: string;
+}
+export interface AgentEndEvent {
+    type: "agent_end";
+    messages: AgentMessage[];
+}
+export interface SessionShutdownEvent {
+    type: "session_shutdown";
+    reason: "quit" | "reload" | "new" | "resume" | "fork";
+    targetSessionFile?: string;
+}
+export interface SessionCompactEvent {
+    type: "session_compact";
+    reason: "manual" | "threshold" | "overflow";
+    fromExtension: boolean;
+}
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+export interface ThinkingContent {
+    type: "thinking";
+    thinking: string;
+}
+export interface ToolCallContent {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface AssistantMessage {
+    role: "assistant";
+    content: (TextContent | ThinkingContent | ToolCallContent)[];
+    stopReason: StopReason;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    model: string;
+    timestamp?: number;
+}
+export type StopReason = "stop" | "length" | "toolUse" | "error" | "aborted";
+export interface UserMessage {
+    role: "user";
+    content: string | (TextContent | ImageContent)[];
+    timestamp: number;
+}
+export interface ToolResultMessage {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: (TextContent | ImageContent)[];
+    isError: boolean;
+    timestamp: number;
+}
+export interface CustomMessage<T = unknown> {
+    role: "custom";
+    customType: string;
+    content: string | (TextContent | ImageContent | ThinkingContent)[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+export type AgentMessage = AssistantMessage | UserMessage | ToolResultMessage | CustomMessage;
+export type ImageContent = {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
+export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = unknown> {
+    name: string;
+    label: string;
+    description: string;
+    parameters: TParams;
+    promptSnippet?: string;
+    promptGuidelines?: string[];
+    execute(toolCallId: string, params: Record<string, unknown>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionContext): Promise<AgentToolResult<TDetails>>;
+}
+export type AgentToolUpdateCallback<T> = (partialResult: AgentToolResult<T>) => void;
+export interface AgentToolResult<T> {
+    content: (TextContent | ImageContent)[];
+    details: T;
+    terminate?: boolean;
+}
+export declare function defineTool<TParams extends TSchema, TDetails = unknown>(tool: ToolDefinition<TParams, TDetails>): ToolDefinition<TParams, TDetails>;
+//# sourceMappingURL=pi-types.d.ts.map

package/dist/src/pi-plugin/pi-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-types.d.ts","sourceRoot":"","sources":["../../../src/pi-plugin/pi-types.ts"],"names":[],"mappings":"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"}

package/dist/src/pi-plugin/pi-types.js

@@ -0,0 +1,15 @@
+/**
+ * Ambient type declarations for Pi extension API types.
+ *
+ * These types are provided by the Pi host at runtime via
+ * `@earendil-works/pi-coding-agent`, `@earendil-works/pi-agent-core`,
+ * and `@earendil-works/pi-ai`. We declare them here so the pi-plugin
+ * module compiles without those packages installed.
+ *
+ * At runtime inside Pi, the actual packages supply the real types and
+ * values. Standalone abmind must not import this file at the root level.
+ */
+export function defineTool(tool) {
+    return tool;
+}
+//# sourceMappingURL=pi-types.js.map

package/dist/src/pi-plugin/pi-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-types.js","sourceRoot":"","sources":["../../../src/pi-plugin/pi-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAsJH,MAAM,UAAU,UAAU,CACxB,IAAuC;IAEvC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/pi-plugin/runtime.d.ts

@@ -0,0 +1,21 @@
+import type { MemoryConfig } from "../memory-config.js";
+import { MemoryManager } from "../memory-manager.js";
+import { HostMemoryLifecycle } from "../host-integration/lifecycle.js";
+import type { ExecutionIdentity } from "../host-integration/types.js";
+export interface PiRuntimeState {
+    memory: MemoryManager | null;
+    lifecycle: HostMemoryLifecycle | null;
+    identity: ExecutionIdentity | null;
+    pendingWakeUp: string;
+    pendingUserPrompt: string | null;
+    runGeneration: number;
+    lastCapturedGeneration: number;
+    closed: boolean;
+}
+export interface PiRuntime {
+    state: PiRuntimeState;
+    close(): void;
+}
+export declare function createPiRuntime(memoryConfig?: Partial<MemoryConfig>): Promise<PiRuntime>;
+export declare function hasDegraded(runtime: PiRuntime): boolean;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/pi-plugin/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/pi-plugin/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAItE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAsB,eAAe,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAqC9F;AAmBD,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAEvD"}

package/dist/src/pi-plugin/runtime.js

@@ -0,0 +1,60 @@
+import { loadMemoryConfig } from "../memory-config.js";
+import { MemoryManager } from "../memory-manager.js";
+import { logError, logInfo } from "../mem-logger.js";
+import { HostMemoryLifecycle } from "../host-integration/lifecycle.js";
+const TAG = "pi-plugin";
+export async function createPiRuntime(memoryConfig) {
+    const config = memoryConfig
+        ? { ...loadMemoryConfig(), ...memoryConfig }
+        : loadMemoryConfig();
+    let memory = null;
+    let lifecycle = null;
+    try {
+        memory = new MemoryManager(config);
+        await memory.initialize();
+        lifecycle = new HostMemoryLifecycle(memory, {
+            writerId: "abmind-pi-plugin",
+            failOpen: true,
+        });
+        logInfo(TAG, "Memory initialized for Pi plugin");
+    }
+    catch (err) {
+        logError(TAG, "Memory initialization failed (degraded mode)", err);
+        memory = null;
+        lifecycle = null;
+    }
+    const state = {
+        memory,
+        lifecycle: lifecycle ?? null,
+        identity: null,
+        pendingWakeUp: "",
+        pendingUserPrompt: null,
+        runGeneration: 0,
+        lastCapturedGeneration: -1,
+        closed: false,
+    };
+    return {
+        state,
+        close: () => closeRuntime(state),
+    };
+}
+function closeRuntime(state) {
+    if (state.closed)
+        return;
+    state.closed = true;
+    state.pendingWakeUp = "";
+    state.pendingUserPrompt = null;
+    state.identity = null;
+    state.runGeneration = 0;
+    state.lastCapturedGeneration = -1;
+    if (state.memory) {
+        state.memory.close();
+        state.memory = null;
+    }
+    state.lifecycle = null;
+    logInfo(TAG, "Pi plugin runtime closed");
+}
+export function hasDegraded(runtime) {
+    return runtime.state.lifecycle === null;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/pi-plugin/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/pi-plugin/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAW,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGvE,MAAM,GAAG,GAAG,WAAW,CAAC;AAkBxB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,YAAoC;IACxE,MAAM,MAAM,GAAG,YAAY;QACzB,CAAC,CAAC,EAAE,GAAG,gBAAgB,EAAE,EAAE,GAAG,YAAY,EAAE;QAC5C,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEvB,IAAI,MAAM,GAAyB,IAAI,CAAC;IACxC,IAAI,SAAS,GAA+B,IAAI,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,SAAS,GAAG,IAAI,mBAAmB,CAAC,MAAM,EAAE;YAC1C,QAAQ,EAAE,kBAAkB;YAC5B,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,GAAG,EAAE,8CAA8C,EAAE,GAAG,CAAC,CAAC;QACnE,MAAM,GAAG,IAAI,CAAC;QACd,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAmB;QAC5B,MAAM;QACN,SAAS,EAAE,SAAS,IAAI,IAAI;QAC5B,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,EAAE;QACjB,iBAAiB,EAAE,IAAI;QACvB,aAAa,EAAE,CAAC;QAChB,sBAAsB,EAAE,CAAC,CAAC;QAC1B,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,OAAO;QACL,KAAK;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAqB;IACzC,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO;IACzB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC;IACzB,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;IACxB,KAAK,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC;IAElC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC;IACD,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,GAAG,EAAE,0BAA0B,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAkB;IAC5C,OAAO,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;AAC1C,CAAC"}

package/dist/src/pi-plugin/tools.d.ts

@@ -0,0 +1,11 @@
+import type { HostMemoryLifecycle } from "../host-integration/lifecycle.js";
+import type { ExecutionIdentity } from "../host-integration/types.js";
+import { type ToolDefinition } from "./pi-types.js";
+interface ToolDeps {
+    lifecycle: HostMemoryLifecycle;
+    getIdentity(): ExecutionIdentity;
+}
+export declare function createRecallTool(deps: ToolDeps): ToolDefinition;
+export declare function createStoreTool(deps: ToolDeps): ToolDefinition;
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/src/pi-plugin/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/pi-plugin/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,OAAO,EAAc,KAAK,cAAc,EAA+C,MAAM,eAAe,CAAC;AAsC7G,UAAU,QAAQ;IAChB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,WAAW,IAAI,iBAAiB,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CA8D/D;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAuE9D"}

package/dist/src/pi-plugin/tools.js

@@ -0,0 +1,136 @@
+import { Type } from "@sinclair/typebox";
+import { extractEnglishTokens } from "../query-tokenizer.js";
+import { defineTool } from "./pi-types.js";
+const MemoryTypeEnum = Type.Union([
+    Type.Literal("fact"),
+    Type.Literal("decision"),
+    Type.Literal("preference"),
+    Type.Literal("event"),
+    Type.Literal("lesson"),
+    Type.Literal("feedback"),
+    Type.Literal("story"),
+    Type.Literal("secret"),
+]);
+const VALID_MEMORY_TYPES = ["fact", "decision", "preference", "event", "lesson", "feedback", "story", "secret"];
+function toMemoryType(raw) {
+    if (raw && VALID_MEMORY_TYPES.includes(raw))
+        return raw;
+    return "fact";
+}
+export function createRecallTool(deps) {
+    return defineTool({
+        name: "abmind_recall",
+        label: "Abmind Recall",
+        description: "Search past memories, decisions, and facts stored by abmind. Returns relevant memory hits with scores.",
+        promptSnippet: "When the user asks about past decisions, preferences, or information that might have been stored in memory, use abmind_recall.",
+        promptGuidelines: [
+            "Use this tool when you need to remember information from past conversations",
+            "Formulate queries using key English terms the memory might be indexed under",
+            "Results include a relevance score — higher is better",
+        ],
+        parameters: Type.Object({
+            query: Type.String({ minLength: 1, description: "Search query — English terms likely to appear in stored memory" }),
+            limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 50, default: 10, description: "Maximum number of results" })),
+            minScore: Type.Optional(Type.Number({ minimum: 0, maximum: 1, description: "Minimum relevance score threshold" })),
+            maxClassification: Type.Optional(Type.Integer({ minimum: 0, maximum: 3, default: 2, description: "Maximum classification level (0=general, 3=personal)" })),
+        }),
+        async execute(_toolCallId, rawParams, signal, _onUpdate, _ctx) {
+            if (signal?.aborted) {
+                return { content: [{ type: "text", text: "Recall cancelled." }], details: { cancelled: true } };
+            }
+            const params = rawParams;
+            const identity = deps.getIdentity();
+            const tokens = extractEnglishTokens(params.query ?? "");
+            const limit = params.limit ?? 10;
+            const maxClassification = params.maxClassification ?? 2;
+            try {
+                const result = await deps.lifecycle.recall({
+                    identity,
+                    query: { translated: tokens.length > 0 ? tokens : [params.query], original: params.query },
+                    limit,
+                    minScore: params.minScore,
+                    maxClassification,
+                });
+                const lines = result.hits.map(h => `- [${h.date}] (score: ${h.score.toFixed(3)}) ${h.content.slice(0, 200)}`);
+                const text = lines.length > 0
+                    ? `Found ${result.hits.length} memory hit(s):\n${lines.join("\n")}`
+                    : "No matching memories found.";
+                return {
+                    content: [{ type: "text", text }],
+                    details: { hits: result.hits, diagnostics: result.diagnostics },
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Recall failed: ${err instanceof Error ? err.message : String(err)}` }],
+                    details: { error: String(err) },
+                };
+            }
+        },
+    });
+}
+export function createStoreTool(deps) {
+    return defineTool({
+        name: "abmind_store",
+        label: "Abmind Store",
+        description: "Store a fact, decision, preference, event, lesson, or feedback in abmind for long-term memory. Content should be in canonical English.",
+        promptSnippet: "When the user states a new preference, makes a decision, shares personal information, or expresses something worth remembering, use abmind_store.",
+        promptGuidelines: [
+            "Store factual information, user preferences, and decisions explicitly",
+            "Write content in clear, canonical English for best retrieval later",
+            "Use the memory type that best fits: fact, decision, preference, event, lesson, feedback, story, or secret",
+        ],
+        parameters: Type.Object({
+            content: Type.String({ minLength: 1, description: "Memory content in canonical English" }),
+            original: Type.Optional(Type.String({ description: "Original-language text (if translated)" })),
+            type: Type.Optional(MemoryTypeEnum),
+            topic: Type.Optional(Type.String({ description: "Topic label for categorization" })),
+            classification: Type.Optional(Type.Integer({ minimum: 0, maximum: 3, description: "Classification level (0=general, 3=highly personal)" })),
+            emotion: Type.Optional(Type.Integer({ minimum: -5, maximum: 5, description: "Emotional valence (-5=negative, 0=neutral, 5=positive)" })),
+            confidence: Type.Optional(Type.Number({ minimum: 0, maximum: 1, description: "Confidence in the memory accuracy" })),
+        }),
+        async execute(_toolCallId, rawParams, signal, _onUpdate, _ctx) {
+            if (signal?.aborted) {
+                return { content: [{ type: "text", text: "Store cancelled." }], details: { cancelled: true } };
+            }
+            const params = rawParams;
+            const identity = deps.getIdentity();
+            try {
+                const result = await deps.lifecycle.store({
+                    identity,
+                    contentEn: params.content ?? "",
+                    contentOriginal: params.original ?? params.content ?? "",
+                    memoryType: toMemoryType(params.type),
+                    emotionScore: params.emotion ?? 0,
+                    topic: params.topic ?? "general",
+                    classification: params.classification ?? 1,
+                    confidence: params.confidence,
+                    emotionTags: undefined,
+                    emotionContext: undefined,
+                    keyword: undefined,
+                    sourceMessageIds: undefined,
+                    trust: undefined,
+                    integrity: undefined,
+                    credibility: undefined,
+                });
+                if (result.stored) {
+                    return {
+                        content: [{ type: "text", text: `Memory stored successfully (${result.memoriesCount} memory record(s)).` }],
+                        details: result,
+                    };
+                }
+                return {
+                    content: [{ type: "text", text: `Store failed: ${result.error ?? "unknown error"}` }],
+                    details: result,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: `Store failed: ${err instanceof Error ? err.message : String(err)}` }],
+                    details: { error: String(err) },
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/src/pi-plugin/tools.js.map

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

package/dist/src/reconcile.d.ts

@@ -2,6 +2,8 @@
  * reconcile.ts — ensure ~/.abmind/ runtime tree matches source templates.
  * OVERWRITE: source-controlled dirs (prompts/sleep) — always fresh.
  * SEED: user-owned dirs (memory/core, config) — only if file missing.
+ * EXCEPTIONS: personalized files (memory/core/SOUL.md) — handled by
+ *   `src/soul-seeder.ts`, not by this module. See #1323, #1324.
  */
 export declare function reconcile(templatesSrc: string, home: string): void;
 //# sourceMappingURL=reconcile.d.ts.map

package/dist/src/reconcile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/reconcile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAoBlE"}
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAsBlE"}