clawdbot-penfield 1.0.1

package/dist/src/store.d.ts

@@ -0,0 +1,49 @@
+/**
+ * File-based credential storage for Penfield plugin
+ *
+ * Credentials are stored at: ~/.clawdbot/extensions/penfield/credentials.json
+ * Directory permissions: 0o700 (only owner can access)
+ * File permissions: 0o600 (only owner can read/write)
+ */
+export declare const CRED_DIR = "~/.clawdbot/extensions/penfield";
+export declare const CRED_FILE = "~/.clawdbot/extensions/penfield/credentials.json";
+export declare const TOKEN_EXPIRY_BUFFER_MS: number;
+export interface CredentialFile {
+    version: number;
+    clientId: string;
+    access: string;
+    refresh?: string;
+    expires: number;
+    createdAt: number;
+}
+/**
+ * Save credentials to file with schema versioning
+ */
+export declare function saveCredential(api: {
+    resolvePath(path: string): string;
+    logger?: {
+        info(...args: unknown[]): void;
+        warn(...args: unknown[]): void;
+        error(...args: unknown[]): void;
+    };
+}, cred: Omit<CredentialFile, 'version' | 'createdAt'>): void;
+/**
+ * Load credentials from file
+ * Returns null if file doesn't exist or is corrupted
+ */
+export declare function loadCredential(api: {
+    resolvePath(path: string): string;
+}): CredentialFile | null;
+/**
+ * Check if we have valid (non-expired) credentials
+ */
+export declare function hasValidCredentials(api: {
+    resolvePath(path: string): string;
+}): boolean;
+/**
+ * Get refresh token if available
+ */
+export declare function getRefreshToken(api: {
+    resolvePath(path: string): string;
+}): string | null;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,QAAQ,oCAAoC,CAAC;AAC1D,eAAO,MAAM,SAAS,qDAAiC,CAAC;AAGxD,eAAO,MAAM,sBAAsB,QAAkB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,EACxJ,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC,GAClD,IAAI,CAiBN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzC,cAAc,GAAG,IAAI,CAevB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzC,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE;IAAE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzC,MAAM,GAAG,IAAI,CAGf"}

package/dist/src/store.js

@@ -0,0 +1,66 @@
+/**
+ * File-based credential storage for Penfield plugin
+ *
+ * Credentials are stored at: ~/.clawdbot/extensions/penfield/credentials.json
+ * Directory permissions: 0o700 (only owner can access)
+ * File permissions: 0o600 (only owner can read/write)
+ */
+import * as fs from 'fs';
+// Credential storage paths
+export const CRED_DIR = '~/.clawdbot/extensions/penfield';
+export const CRED_FILE = `${CRED_DIR}/credentials.json`;
+// Token buffer: refresh if token expires within 240 minutes (4 hours)
+export const TOKEN_EXPIRY_BUFFER_MS = 240 * 60 * 1000;
+/**
+ * Save credentials to file with schema versioning
+ */
+export function saveCredential(api, cred) {
+    const dirPath = api.resolvePath(CRED_DIR);
+    const filePath = api.resolvePath(CRED_FILE);
+    const content = {
+        version: 1,
+        ...cred,
+        createdAt: Date.now(),
+    };
+    // Create directory with restricted permissions (owner-only access)
+    fs.mkdirSync(dirPath, { recursive: true, mode: 0o700 });
+    // Atomic write: write to temp file, then rename (prevents corruption on crash)
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, JSON.stringify(content, null, 2), { mode: 0o600 });
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Load credentials from file
+ * Returns null if file doesn't exist or is corrupted
+ */
+export function loadCredential(api) {
+    const filePath = api.resolvePath(CRED_FILE);
+    try {
+        const raw = fs.readFileSync(filePath, 'utf8');
+        const content = JSON.parse(raw);
+        if (content.version < 1) {
+            throw new Error('Unsupported credential version');
+        }
+        return content;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if we have valid (non-expired) credentials
+ */
+export function hasValidCredentials(api) {
+    const cred = loadCredential(api);
+    if (!cred)
+        return false;
+    // Check if expired (with buffer)
+    return Date.now() < cred.expires - TOKEN_EXPIRY_BUFFER_MS;
+}
+/**
+ * Get refresh token if available
+ */
+export function getRefreshToken(api) {
+    const cred = loadCredential(api);
+    return cred?.refresh || null;
+}

package/dist/src/tools/awaken.d.ts

@@ -0,0 +1,4 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const AwakenToolSchema: import("@sinclair/typebox").TObject<{}>;
+export declare function executeAwakenTool(apiClient: PenfieldApiClient, _params: any): Promise<any>;
+//# sourceMappingURL=awaken.d.ts.map

package/dist/src/tools/awaken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaken.d.ts","sourceRoot":"","sources":["../../../src/tools/awaken.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,gBAAgB,yCAAmD,CAAC;AAEjF,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,GAAG,CAAC,CAed"}

package/dist/src/tools/awaken.js

@@ -0,0 +1,17 @@
+import { Type } from "../types/typebox.js";
+export const AwakenToolSchema = Type.Object({}, { additionalProperties: false });
+export async function executeAwakenTool(apiClient, _params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    // Awaken loads the user's personality briefing from the Penfield system
+    const response = await apiClient.get("/api/v2/personality/awakening");
+    const briefing = response.briefing || "";
+    return {
+        content: [
+            {
+                type: "text",
+                text: briefing,
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/connect.d.ts

@@ -0,0 +1,9 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const ConnectToolSchema: import("@sinclair/typebox").TObject<{
+    from_memory_id: import("@sinclair/typebox").TString;
+    to_memory_id: import("@sinclair/typebox").TString;
+    relationship_type: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supersedes">, import("@sinclair/typebox").TLiteral<"updates">, import("@sinclair/typebox").TLiteral<"evolution_of">, import("@sinclair/typebox").TLiteral<"supports">, import("@sinclair/typebox").TLiteral<"contradicts">, import("@sinclair/typebox").TLiteral<"disputes">, import("@sinclair/typebox").TLiteral<"parent_of">, import("@sinclair/typebox").TLiteral<"child_of">, import("@sinclair/typebox").TLiteral<"sibling_of">, import("@sinclair/typebox").TLiteral<"causes">, import("@sinclair/typebox").TLiteral<"influenced_by">, import("@sinclair/typebox").TLiteral<"prerequisite_for">, import("@sinclair/typebox").TLiteral<"implements">, import("@sinclair/typebox").TLiteral<"documents">, import("@sinclair/typebox").TLiteral<"example_of">, import("@sinclair/typebox").TLiteral<"tests">, import("@sinclair/typebox").TLiteral<"responds_to">, import("@sinclair/typebox").TLiteral<"references">, import("@sinclair/typebox").TLiteral<"inspired_by">, import("@sinclair/typebox").TLiteral<"follows">, import("@sinclair/typebox").TLiteral<"precedes">, import("@sinclair/typebox").TLiteral<"depends_on">, import("@sinclair/typebox").TLiteral<"composed_of">, import("@sinclair/typebox").TLiteral<"part_of">]>;
+    strength: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare function executeConnectTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/src/tools/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/tools/connect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB;;;;;EAkBK,CAAC;AAEpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAsBd"}

package/dist/src/tools/connect.js

@@ -0,0 +1,41 @@
+import { Type, RelationshipTypeSchema } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const ConnectToolSchema = Type.Object({
+    from_memory_id: Type.String({
+        description: "Source memory ID (UUID format)",
+        examples: ["22618318-8d82-49c9-8bb8-1cf3a61b3c75"],
+    }),
+    to_memory_id: Type.String({
+        description: "Target memory ID (UUID format)",
+        examples: ["20413926-2446-4f88-bfd6-749b37969f34"],
+    }),
+    relationship_type: RelationshipTypeSchema,
+    strength: Type.Optional(Type.Number({
+        description: "Relationship strength 0-1 (default: 0.8)",
+        minimum: 0,
+        maximum: 1,
+        default: 0.8,
+    })),
+}, { additionalProperties: false });
+export async function executeConnectTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    validateUuid(params.from_memory_id, 'from_memory_id');
+    validateUuid(params.to_memory_id, 'to_memory_id');
+    // Map user-friendly field names to API field names
+    const apiParams = {
+        from_id: params.from_memory_id,
+        to_id: params.to_memory_id,
+        relationship_type: params.relationship_type,
+        strength: params.strength,
+    };
+    const response = await apiClient.post("/api/v2/relationships", apiParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/delete-artifact.d.ts

@@ -0,0 +1,6 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const DeleteArtifactToolSchema: import("@sinclair/typebox").TObject<{
+    path: import("@sinclair/typebox").TString;
+}>;
+export declare function executeDeleteArtifactTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=delete-artifact.d.ts.map

package/dist/src/tools/delete-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-artifact.d.ts","sourceRoot":"","sources":["../../../src/tools/delete-artifact.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,wBAAwB;;EAIF,CAAC;AAEpC,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAgBd"}

package/dist/src/tools/delete-artifact.js

@@ -0,0 +1,24 @@
+import { Type } from "../types/typebox.js";
+import { validateArtifactPath } from "../validation.js";
+export const DeleteArtifactToolSchema = Type.Object({
+    path: Type.String({
+        description: "Artifact path to delete",
+    }),
+}, { additionalProperties: false });
+export async function executeDeleteArtifactTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    validateArtifactPath(params.path);
+    const queryParams = {
+        path: params.path,
+    };
+    const response = await apiClient.delete("/api/v2/artifacts", queryParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/explore.d.ts

@@ -0,0 +1,9 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const ExploreToolSchema: import("@sinclair/typebox").TObject<{
+    start_memory_id: import("@sinclair/typebox").TString;
+    max_depth: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    relationship_types: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"supersedes">, import("@sinclair/typebox").TLiteral<"updates">, import("@sinclair/typebox").TLiteral<"evolution_of">, import("@sinclair/typebox").TLiteral<"supports">, import("@sinclair/typebox").TLiteral<"contradicts">, import("@sinclair/typebox").TLiteral<"disputes">, import("@sinclair/typebox").TLiteral<"parent_of">, import("@sinclair/typebox").TLiteral<"child_of">, import("@sinclair/typebox").TLiteral<"sibling_of">, import("@sinclair/typebox").TLiteral<"causes">, import("@sinclair/typebox").TLiteral<"influenced_by">, import("@sinclair/typebox").TLiteral<"prerequisite_for">, import("@sinclair/typebox").TLiteral<"implements">, import("@sinclair/typebox").TLiteral<"documents">, import("@sinclair/typebox").TLiteral<"example_of">, import("@sinclair/typebox").TLiteral<"tests">, import("@sinclair/typebox").TLiteral<"responds_to">, import("@sinclair/typebox").TLiteral<"references">, import("@sinclair/typebox").TLiteral<"inspired_by">, import("@sinclair/typebox").TLiteral<"follows">, import("@sinclair/typebox").TLiteral<"precedes">, import("@sinclair/typebox").TLiteral<"depends_on">, import("@sinclair/typebox").TLiteral<"composed_of">, import("@sinclair/typebox").TLiteral<"part_of">]>>>;
+    min_strength: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare function executeExploreTool(apiClient: PenfieldApiClient, params: unknown): Promise<any>;
+//# sourceMappingURL=explore.d.ts.map

package/dist/src/tools/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/tools/explore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,iBAAiB;;;;;EAwBK,CAAC;AAEpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAcd"}

package/dist/src/tools/explore.js

@@ -0,0 +1,35 @@
+import { Type, RelationshipTypeSchema } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const ExploreToolSchema = Type.Object({
+    start_memory_id: Type.String({
+        description: "Starting memory ID for graph traversal",
+    }),
+    max_depth: Type.Optional(Type.Number({
+        description: "Maximum traversal depth (default: 3, max: 10)",
+        minimum: 1,
+        maximum: 10,
+        default: 3,
+    })),
+    relationship_types: Type.Optional(Type.Array(RelationshipTypeSchema, {
+        description: "Filter by relationship types",
+    })),
+    min_strength: Type.Optional(Type.Number({
+        description: "Minimum relationship strength (0-1)",
+        minimum: 0,
+        maximum: 1,
+    })),
+}, { additionalProperties: false });
+export async function executeExploreTool(apiClient, params) {
+    const { start_memory_id } = params;
+    validateUuid(start_memory_id, 'start_memory_id');
+    const response = await apiClient.post("/api/v2/relationships/traverse", params);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/fetch.d.ts

@@ -0,0 +1,6 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const FetchToolSchema: import("@sinclair/typebox").TObject<{
+    memory_id: import("@sinclair/typebox").TString;
+}>;
+export declare function executeFetchTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/src/tools/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/tools/fetch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,eAAe;;EAIO,CAAC;AAEpC,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAYd"}

package/dist/src/tools/fetch.js

@@ -0,0 +1,21 @@
+import { Type } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const FetchToolSchema = Type.Object({
+    memory_id: Type.String({
+        description: "Memory ID to fetch",
+    }),
+}, { additionalProperties: false });
+export async function executeFetchTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    validateUuid(params.memory_id, 'memory_id');
+    const response = await apiClient.get(`/api/v2/memories/${params.memory_id}`);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/index.d.ts

@@ -0,0 +1,4 @@
+import type { PenfieldRuntime } from "../runtime.js";
+import type { ClawdbotPluginApi } from "../types.js";
+export declare function registerPenfieldTools(api: ClawdbotPluginApi, ensureRuntime: () => Promise<PenfieldRuntime>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6BrD,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,iBAAiB,EACtB,aAAa,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,QAgK9C"}

package/dist/src/tools/index.js

@@ -0,0 +1,58 @@
+import { StoreToolSchema, executeStoreTool } from "./store.js";
+import { RecallToolSchema, executeRecallTool } from "./recall.js";
+import { SearchToolSchema, executeSearchTool } from "./search.js";
+import { FetchToolSchema, executeFetchTool } from "./fetch.js";
+import { UpdateMemoryToolSchema, executeUpdateMemoryTool } from "./update-memory.js";
+import { ConnectToolSchema, executeConnectTool } from "./connect.js";
+import { ExploreToolSchema, executeExploreTool } from "./explore.js";
+import { SaveContextToolSchema, executeSaveContextTool } from "./save-context.js";
+import { RestoreContextToolSchema, executeRestoreContextTool, } from "./restore-context.js";
+import { ListContextsToolSchema, executeListContextsTool } from "./list-contexts.js";
+import { ReflectToolSchema, executeReflectTool } from "./reflect.js";
+import { SaveArtifactToolSchema, executeSaveArtifactTool } from "./save-artifact.js";
+import { RetrieveArtifactToolSchema, executeRetrieveArtifactTool, } from "./retrieve-artifact.js";
+import { ListArtifactsToolSchema, executeListArtifactsTool } from "./list-artifacts.js";
+import { DeleteArtifactToolSchema, executeDeleteArtifactTool, } from "./delete-artifact.js";
+import { AwakenToolSchema, executeAwakenTool } from "./awaken.js";
+export function registerPenfieldTools(api, ensureRuntime) {
+    const json = (payload) => ({
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        details: payload,
+    });
+    const registerTool = (name, label, description, schema, execute) => {
+        api.registerTool({
+            name,
+            label,
+            description,
+            parameters: schema,
+            async execute(_toolCallId, params) {
+                try {
+                    const rt = await ensureRuntime();
+                    return await execute(rt.apiClient, params);
+                }
+                catch (err) {
+                    return json({
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            },
+        });
+    };
+    // Register all 16 tools
+    registerTool("penfield_store", "Store Memory", "Store a new memory in Penfield", StoreToolSchema, executeStoreTool);
+    registerTool("penfield_recall", "Recall Memories", "Search memories using hybrid BM25 + vector + graph search", RecallToolSchema, executeRecallTool);
+    registerTool("penfield_search", "Search Memories", "Semantic search for memories", SearchToolSchema, executeSearchTool);
+    registerTool("penfield_fetch", "Fetch Memory", "Get a specific memory by ID", FetchToolSchema, executeFetchTool);
+    registerTool("penfield_update_memory", "Update Memory", "Update an existing memory", UpdateMemoryToolSchema, executeUpdateMemoryTool);
+    registerTool("penfield_connect", "Connect Memories", "Create a relationship between two memories", ConnectToolSchema, executeConnectTool);
+    registerTool("penfield_explore", "Explore Graph", "Traverse the knowledge graph from a starting memory", ExploreToolSchema, executeExploreTool);
+    registerTool("penfield_save_context", "Save Context", "Save a checkpoint of current memory state", SaveContextToolSchema, executeSaveContextTool);
+    registerTool("penfield_restore_context", "Restore Context", "Restore a previously saved checkpoint", RestoreContextToolSchema, executeRestoreContextTool);
+    registerTool("penfield_list_contexts", "List Contexts", "List all saved checkpoints", ListContextsToolSchema, executeListContextsTool);
+    registerTool("penfield_reflect", "Reflect", "Analyze memory patterns and generate insights", ReflectToolSchema, executeReflectTool);
+    registerTool("penfield_save_artifact", "Save Artifact", "Save a file artifact to Penfield storage", SaveArtifactToolSchema, executeSaveArtifactTool);
+    registerTool("penfield_retrieve_artifact", "Retrieve Artifact", "Retrieve a file artifact from Penfield storage", RetrieveArtifactToolSchema, executeRetrieveArtifactTool);
+    registerTool("penfield_list_artifacts", "List Artifacts", "List artifacts in a directory", ListArtifactsToolSchema, executeListArtifactsTool);
+    registerTool("penfield_delete_artifact", "Delete Artifact", "Delete a file artifact from Penfield storage", DeleteArtifactToolSchema, executeDeleteArtifactTool);
+    registerTool("penfield_awaken", "Awaken", "Load personality configuration and identity core", AwakenToolSchema, executeAwakenTool);
+}

package/dist/src/tools/list-artifacts.d.ts

@@ -0,0 +1,7 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const ListArtifactsToolSchema: import("@sinclair/typebox").TObject<{
+    prefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare function executeListArtifactsTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=list-artifacts.d.ts.map

package/dist/src/tools/list-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-artifacts.d.ts","sourceRoot":"","sources":["../../../src/tools/list-artifacts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,uBAAuB;;;EAcD,CAAC;AAEpC,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAmBd"}

package/dist/src/tools/list-artifacts.js

@@ -0,0 +1,32 @@
+import { Type } from "../types/typebox.js";
+export const ListArtifactsToolSchema = Type.Object({
+    prefix: Type.Optional(Type.String({
+        description: "Directory prefix to list (e.g., /project/)",
+    })),
+    limit: Type.Optional(Type.Number({
+        description: "Max results (default: 100)",
+        minimum: 1,
+        maximum: 1000,
+        default: 100,
+    })),
+}, { additionalProperties: false });
+export async function executeListArtifactsTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    const queryParams = {};
+    if (params.prefix) {
+        queryParams.prefix = params.prefix;
+    }
+    if (params.limit) {
+        queryParams.limit = String(params.limit);
+    }
+    const response = await apiClient.get("/api/v2/artifacts/list", queryParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/list-contexts.d.ts

@@ -0,0 +1,7 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const ListContextsToolSchema: import("@sinclair/typebox").TObject<{
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare function executeListContextsTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=list-contexts.d.ts.map

package/dist/src/tools/list-contexts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-contexts.d.ts","sourceRoot":"","sources":["../../../src/tools/list-contexts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;EAcA,CAAC;AAEpC,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAmBd"}

package/dist/src/tools/list-contexts.js

@@ -0,0 +1,32 @@
+import { Type } from "../types/typebox.js";
+export const ListContextsToolSchema = Type.Object({
+    session_id: Type.Optional(Type.String({
+        description: "Filter by session ID",
+    })),
+    limit: Type.Optional(Type.Number({
+        description: "Max results (default: 20, max: 100)",
+        minimum: 1,
+        maximum: 100,
+        default: 20,
+    })),
+}, { additionalProperties: false });
+export async function executeListContextsTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    const queryParams = {};
+    if (params.session_id) {
+        queryParams.session_id = params.session_id;
+    }
+    if (params.limit) {
+        queryParams.limit = String(params.limit);
+    }
+    const response = await apiClient.get("/api/v2/checkpoint", queryParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/recall.d.ts

@@ -0,0 +1,13 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const RecallToolSchema: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    bm25_weight: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    vector_weight: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    graph_weight: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    memory_types: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"fact">, import("@sinclair/typebox").TLiteral<"insight">, import("@sinclair/typebox").TLiteral<"conversation">, import("@sinclair/typebox").TLiteral<"correction">, import("@sinclair/typebox").TLiteral<"reference">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"checkpoint">, import("@sinclair/typebox").TLiteral<"identity_core">, import("@sinclair/typebox").TLiteral<"personality_trait">, import("@sinclair/typebox").TLiteral<"relationship">, import("@sinclair/typebox").TLiteral<"strategy">]>>>;
+    importance_threshold: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    enable_graph_expansion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+}>;
+export declare function executeRecallTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=recall.d.ts.map

package/dist/src/tools/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/tools/recall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;EAuDM,CAAC;AAEpC,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAqBd"}

package/dist/src/tools/recall.js

@@ -0,0 +1,64 @@
+import { Type, MemoryTypeSchema, ImportanceScoreSchema } from "../types/typebox.js";
+export const RecallToolSchema = Type.Object({
+    query: Type.String({
+        description: "Search query (1-4,000 chars)",
+        minLength: 1,
+        maxLength: 4000,
+    }),
+    limit: Type.Optional(Type.Number({
+        description: "Max results (default: 20, max: 100)",
+        minimum: 1,
+        maximum: 100,
+        default: 20,
+    })),
+    bm25_weight: Type.Optional(Type.Number({
+        description: "BM25 keyword weight (default: 0.4)",
+        minimum: 0,
+        maximum: 1,
+        default: 0.4,
+    })),
+    vector_weight: Type.Optional(Type.Number({
+        description: "Vector semantic weight (default: 0.4)",
+        minimum: 0,
+        maximum: 1,
+        default: 0.4,
+    })),
+    graph_weight: Type.Optional(Type.Number({
+        description: "Graph relationship weight (default: 0.2)",
+        minimum: 0,
+        maximum: 1,
+        default: 0.2,
+    })),
+    memory_types: Type.Optional(Type.Array(MemoryTypeSchema, {
+        description: "Filter by memory types",
+    })),
+    importance_threshold: Type.Optional(Type.Number({
+        ...ImportanceScoreSchema,
+        description: "Minimum importance (0-1)",
+    })),
+    enable_graph_expansion: Type.Optional(Type.Boolean({
+        description: "Enable graph traversal (default: true)",
+        default: true,
+    })),
+}, { additionalProperties: false });
+export async function executeRecallTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    // Validate weights sum to 1.0
+    const bm25 = params.bm25_weight ?? 0.4;
+    const vector = params.vector_weight ?? 0.4;
+    const graph = params.graph_weight ?? 0.2;
+    const sum = bm25 + vector + graph;
+    if (Math.abs(sum - 1.0) > 0.01) {
+        throw new Error(`Weights must sum to 1.0 (got ${sum})`);
+    }
+    const response = await apiClient.post("/api/v2/search/hybrid", params);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/reflect.d.ts

@@ -0,0 +1,8 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const ReflectToolSchema: import("@sinclair/typebox").TObject<{
+    time_window: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"1d">, import("@sinclair/typebox").TLiteral<"7d">, import("@sinclair/typebox").TLiteral<"30d">, import("@sinclair/typebox").TLiteral<"90d">]>>;
+    focus_areas: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"memory_usage">, import("@sinclair/typebox").TLiteral<"relationships">, import("@sinclair/typebox").TLiteral<"importance">, import("@sinclair/typebox").TLiteral<"topics">, import("@sinclair/typebox").TLiteral<"patterns">]>>>;
+    memory_types: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"fact">, import("@sinclair/typebox").TLiteral<"insight">, import("@sinclair/typebox").TLiteral<"conversation">, import("@sinclair/typebox").TLiteral<"correction">, import("@sinclair/typebox").TLiteral<"reference">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"checkpoint">, import("@sinclair/typebox").TLiteral<"identity_core">, import("@sinclair/typebox").TLiteral<"personality_trait">, import("@sinclair/typebox").TLiteral<"relationship">, import("@sinclair/typebox").TLiteral<"strategy">]>>>;
+}>;
+export declare function executeReflectTool(apiClient: PenfieldApiClient, params: unknown): Promise<any>;
+//# sourceMappingURL=reflect.d.ts.map

package/dist/src/tools/reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../../src/tools/reflect.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;EAoCK,CAAC;AAEpC,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAWd"}

package/dist/src/tools/reflect.js

@@ -0,0 +1,38 @@
+import { Type, MemoryTypeSchema } from "../types/typebox.js";
+export const ReflectToolSchema = Type.Object({
+    time_window: Type.Optional(Type.Union([
+        Type.Literal("1d"),
+        Type.Literal("7d"),
+        Type.Literal("30d"),
+        Type.Literal("90d"),
+    ], {
+        description: "Time period to analyze. Defaults to last 7 days.",
+        examples: ["7d", "30d"],
+    })),
+    focus_areas: Type.Optional(Type.Array(Type.Union([
+        Type.Literal("memory_usage"),
+        Type.Literal("relationships"),
+        Type.Literal("importance"),
+        Type.Literal("topics"),
+        Type.Literal("patterns"),
+    ]), {
+        description: "Areas to focus analysis on. Omit for full analysis.",
+        examples: [["memory_usage", "relationships"], ["topics"]],
+    })),
+    memory_types: Type.Optional(Type.Array(MemoryTypeSchema, {
+        description: "Filter by memory types. Defaults to all types.",
+        examples: [["fact", "insight"], ["identity_core", "personality_trait"]],
+    })),
+}, { additionalProperties: false });
+export async function executeReflectTool(apiClient, params) {
+    const response = await apiClient.post("/api/v2/analysis/reflect", params);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}