clawdbot-penfield 1.0.1

package/dist/src/tools/restore-context.d.ts

@@ -0,0 +1,8 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const RestoreContextToolSchema: import("@sinclair/typebox").TObject<{
+    checkpoint_id: import("@sinclair/typebox").TString;
+    full_restore: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    merge_mode: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"append">, import("@sinclair/typebox").TLiteral<"replace">, import("@sinclair/typebox").TLiteral<"smart_merge">]>>;
+}>;
+export declare function executeRestoreContextTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=restore-context.d.ts.map

package/dist/src/tools/restore-context.d.ts.map

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

package/dist/src/tools/restore-context.js

@@ -0,0 +1,34 @@
+import { Type } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const RestoreContextToolSchema = Type.Object({
+    checkpoint_id: Type.String({
+        description: "Checkpoint ID to restore (e.g., cp-550e8400-e29b-41d4-a716-446655440000)",
+    }),
+    full_restore: Type.Optional(Type.Boolean({
+        description: "Create new copies of memories instead of referencing existing (default: false)",
+        default: false,
+    })),
+    merge_mode: Type.Optional(Type.Union([
+        Type.Literal("append"),
+        Type.Literal("replace"),
+        Type.Literal("smart_merge"),
+    ], {
+        description: "How to handle conflicts: append (add to existing), replace (use only checkpoint), smart_merge (newer versions preferred)",
+        default: "append",
+    })),
+}, { additionalProperties: false });
+export async function executeRestoreContextTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    const { checkpoint_id, ...restoreParams } = params;
+    validateUuid(checkpoint_id, 'checkpoint_id');
+    const response = await apiClient.post(`/api/v2/checkpoint/${checkpoint_id}/recall`, restoreParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-artifact.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-artifact.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,0BAA0B;;EAIJ,CAAC;AAEpC,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAgBd"}

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

@@ -0,0 +1,24 @@
+import { Type } from "../types/typebox.js";
+import { validateArtifactPath } from "../validation.js";
+export const RetrieveArtifactToolSchema = Type.Object({
+    path: Type.String({
+        description: "Artifact path to retrieve",
+    }),
+}, { additionalProperties: false });
+export async function executeRetrieveArtifactTool(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.get("/api/v2/artifacts", queryParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

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

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

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

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

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

@@ -0,0 +1,27 @@
+import { Type } from "../types/typebox.js";
+import { validateArtifactPath } from "../validation.js";
+export const SaveArtifactToolSchema = Type.Object({
+    path: Type.String({
+        description: "Artifact path (e.g., /project/file.txt)",
+    }),
+    content: Type.String({
+        description: "Artifact content",
+    }),
+    content_type: Type.Optional(Type.String({
+        description: "MIME type (default: text/plain)",
+    })),
+}, { additionalProperties: false });
+export async function executeSaveArtifactTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    validateArtifactPath(params.path);
+    const response = await apiClient.post("/api/v2/artifacts", params);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/save-context.d.ts

@@ -0,0 +1,7 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const SaveContextToolSchema: import("@sinclair/typebox").TObject<{
+    memory_ids: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    session_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function executeSaveContextTool(apiClient: PenfieldApiClient, params: unknown): Promise<any>;
+//# sourceMappingURL=save-context.d.ts.map

package/dist/src/tools/save-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-context.d.ts","sourceRoot":"","sources":["../../../src/tools/save-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,qBAAqB;;;EAUC,CAAC;AAEpC,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,GAAG,CAAC,CAgBd"}

package/dist/src/tools/save-context.js

@@ -0,0 +1,27 @@
+import { Type } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const SaveContextToolSchema = Type.Object({
+    memory_ids: Type.Array(Type.String(), {
+        description: "Array of memory IDs to save in checkpoint",
+        minItems: 1,
+    }),
+    session_id: Type.Optional(Type.String({
+        description: "Optional session identifier",
+    })),
+}, { additionalProperties: false });
+export async function executeSaveContextTool(apiClient, params) {
+    const { memory_ids, session_id } = params;
+    memory_ids.forEach((id, index) => {
+        validateUuid(id, `memory_ids[${index}]`);
+    });
+    const response = await apiClient.post("/api/v2/checkpoint/create", { memory_ids, session_id });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

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

@@ -0,0 +1,9 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const SearchToolSchema: import("@sinclair/typebox").TObject<{
+    query: import("@sinclair/typebox").TString;
+    limit: 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>;
+}>;
+export declare function executeSearchTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=search.d.ts.map

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

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

package/dist/src/tools/search.js

@@ -0,0 +1,41 @@
+import { Type, MemoryTypeSchema, ImportanceScoreSchema } from "../types/typebox.js";
+export const SearchToolSchema = 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,
+    })),
+    memory_types: Type.Optional(Type.Array(MemoryTypeSchema, {
+        description: "Filter by memory types",
+    })),
+    importance_threshold: Type.Optional(Type.Number({
+        ...ImportanceScoreSchema,
+        description: "Minimum importance (0-1)",
+    })),
+}, { additionalProperties: false });
+export async function executeSearchTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    // Search is a variant of hybrid search with higher vector weight
+    const searchParams = {
+        ...params,
+        vector_weight: 0.6,
+        bm25_weight: 0.3,
+        graph_weight: 0.1,
+    };
+    const response = await apiClient.post("/api/v2/search/hybrid", searchParams);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

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

@@ -0,0 +1,11 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const StoreToolSchema: import("@sinclair/typebox").TObject<{
+    content: import("@sinclair/typebox").TString;
+    memory_type: import("@sinclair/typebox").TOptional<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: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    confidence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    source_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+export declare function executeStoreTool(apiClient: PenfieldApiClient, params: unknown): Promise<any>;
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/src/tools/store.js

@@ -0,0 +1,36 @@
+import { Type, MemoryTypeSchema, ImportanceScoreSchema, ConfidenceScoreSchema, TagsSchema, } from "../types/typebox.js";
+export const StoreToolSchema = Type.Object({
+    content: Type.String({
+        description: "Memory content to store (max 10,000 chars)",
+        minLength: 1,
+        maxLength: 10000,
+    }),
+    memory_type: Type.Optional(MemoryTypeSchema),
+    importance: Type.Optional(Type.Number({
+        ...ImportanceScoreSchema,
+        description: "Importance score 0-1 (default: 0.5)",
+    })),
+    confidence: Type.Optional(Type.Number({
+        ...ConfidenceScoreSchema,
+        description: "Confidence score 0-1 (default: 0.8)",
+    })),
+    source_type: Type.Optional(Type.String({
+        description: "Source type (e.g., direct_input, conversation)",
+    })),
+    tags: Type.Optional(Type.Array(Type.String(), {
+        ...TagsSchema,
+        description: "Tags (max 10)",
+    })),
+}, { additionalProperties: false });
+export async function executeStoreTool(apiClient, params) {
+    const response = await apiClient.post("/api/v2/memories", params);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/tools/update-memory.d.ts

@@ -0,0 +1,11 @@
+import type { PenfieldApiClient } from "../api-client.js";
+export declare const UpdateMemoryToolSchema: import("@sinclair/typebox").TObject<{
+    memory_id: import("@sinclair/typebox").TString;
+    content: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    memory_type: import("@sinclair/typebox").TOptional<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: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    confidence: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+export declare function executeUpdateMemoryTool(apiClient: PenfieldApiClient, params: any): Promise<any>;
+//# sourceMappingURL=update-memory.d.ts.map

package/dist/src/tools/update-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-memory.d.ts","sourceRoot":"","sources":["../../../src/tools/update-memory.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,eAAO,MAAM,sBAAsB;;;;;;;EAoBA,CAAC;AAEpC,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,GAAG,CAAC,CAad"}

package/dist/src/tools/update-memory.js

@@ -0,0 +1,34 @@
+import { Type, MemoryTypeSchema, ImportanceScoreSchema, ConfidenceScoreSchema, TagsSchema, } from "../types/typebox.js";
+import { validateUuid } from "../validation.js";
+export const UpdateMemoryToolSchema = Type.Object({
+    memory_id: Type.String({
+        description: "Memory ID to update",
+    }),
+    content: Type.Optional(Type.String({
+        description: "Updated memory content (max 10,000 chars)",
+        minLength: 1,
+        maxLength: 10000,
+    })),
+    memory_type: Type.Optional(MemoryTypeSchema),
+    importance: Type.Optional(ImportanceScoreSchema),
+    confidence: Type.Optional(ConfidenceScoreSchema),
+    tags: Type.Optional(Type.Array(Type.String(), {
+        ...TagsSchema,
+        description: "Tags (max 10)",
+    })),
+}, { additionalProperties: false });
+export async function executeUpdateMemoryTool(apiClient, params // eslint-disable-line @typescript-eslint/no-explicit-any -- validated by TypeBox schema
+) {
+    const { memory_id, ...updateData } = params;
+    validateUuid(memory_id, 'memory_id');
+    const response = await apiClient.put(`/api/v2/memories/${memory_id}`, updateData);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        details: response,
+    };
+}

package/dist/src/types/typebox.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Centralized TypeBox exports and common schemas
+ *
+ * All tool schemas should import Type from here:
+ *   import { Type } from "../types/typebox.js";
+ */
+import { Type, type TSchema } from "@sinclair/typebox";
+export { Type, type TSchema };
+export declare const UUIDSchema: import("@sinclair/typebox").TString;
+export declare const PaginationSchema: import("@sinclair/typebox").TObject<{
+    page: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export declare const ImportanceScoreSchema: import("@sinclair/typebox").TNumber;
+export declare const ConfidenceScoreSchema: import("@sinclair/typebox").TNumber;
+export declare const TagsSchema: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+export declare const MemoryTypeSchema: 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 const RelationshipTypeSchema: 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">]>;
+//# sourceMappingURL=typebox.d.ts.map

package/dist/src/types/typebox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typebox.d.ts","sourceRoot":"","sources":["../../../src/types/typebox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;AAG9B,eAAO,MAAM,UAAU,qCAGrB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;EAY3B,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAIhC,CAAC;AAEH,eAAO,MAAM,qBAAqB,qCAIhC,CAAC;AAEH,eAAO,MAAM,UAAU,yEAGrB,CAAC;AAEH,eAAO,MAAM,gBAAgB,8lBAYQ,CAAC;AAEtC,eAAO,MAAM,sBAAsB,yvCAoCjC,CAAC"}

package/dist/src/types/typebox.js

@@ -0,0 +1,91 @@
+/**
+ * Centralized TypeBox exports and common schemas
+ *
+ * All tool schemas should import Type from here:
+ *   import { Type } from "../types/typebox.js";
+ */
+import { Type } from "@sinclair/typebox";
+// Re-export Type for schema definitions
+export { Type };
+// Common schemas
+export const UUIDSchema = Type.String({
+    description: "UUID format identifier",
+    format: "uuid",
+});
+export const PaginationSchema = Type.Object({
+    page: Type.Optional(Type.Number({
+        description: "Page number (1-indexed)",
+        minimum: 1,
+        default: 1,
+    })),
+    limit: Type.Optional(Type.Number({
+        description: "Items per page",
+        minimum: 1,
+        maximum: 100,
+        default: 20,
+    })),
+});
+export const ImportanceScoreSchema = Type.Number({
+    description: "Importance score 0-1",
+    minimum: 0,
+    maximum: 1,
+});
+export const ConfidenceScoreSchema = Type.Number({
+    description: "Confidence score 0-1",
+    minimum: 0,
+    maximum: 1,
+});
+export const TagsSchema = Type.Array(Type.String(), {
+    description: "Tags for categorization",
+    maxItems: 10,
+});
+export const MemoryTypeSchema = Type.Union([
+    Type.Literal("fact"),
+    Type.Literal("insight"),
+    Type.Literal("conversation"),
+    Type.Literal("correction"),
+    Type.Literal("reference"),
+    Type.Literal("task"),
+    Type.Literal("checkpoint"),
+    Type.Literal("identity_core"),
+    Type.Literal("personality_trait"),
+    Type.Literal("relationship"),
+    Type.Literal("strategy"),
+], { description: "Type of memory" });
+export const RelationshipTypeSchema = Type.Union([
+    // Knowledge Evolution
+    Type.Literal("supersedes"),
+    Type.Literal("updates"),
+    Type.Literal("evolution_of"),
+    // Evidence & Support
+    Type.Literal("supports"),
+    Type.Literal("contradicts"),
+    Type.Literal("disputes"),
+    // Hierarchy & Structure
+    Type.Literal("parent_of"),
+    Type.Literal("child_of"),
+    Type.Literal("sibling_of"),
+    // Cause & Prerequisites
+    Type.Literal("causes"),
+    Type.Literal("influenced_by"),
+    Type.Literal("prerequisite_for"),
+    // Implementation & Examples
+    Type.Literal("implements"),
+    Type.Literal("documents"),
+    Type.Literal("example_of"),
+    Type.Literal("tests"),
+    // Conversation & Reference
+    Type.Literal("responds_to"),
+    Type.Literal("references"),
+    Type.Literal("inspired_by"),
+    // Sequence & Flow
+    Type.Literal("follows"),
+    Type.Literal("precedes"),
+    // Dependencies & Composition
+    Type.Literal("depends_on"),
+    Type.Literal("composed_of"),
+    Type.Literal("part_of"),
+], {
+    description: "Semantic relationship type connecting two memories",
+    examples: ["supports", "parent_of", "evolution_of", "example_of", "depends_on"],
+});

package/dist/src/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Clawdbot Plugin API types for Penfield plugin
+ *
+ * Single source of truth for plugin interfaces.
+ * These types are adapted from @clawdbot/types for plugin use.
+ */
+export interface Logger {
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+}
+export interface ClawdbotPluginApi {
+    /** Plugin identifier */
+    id: string;
+    /** Plugin name */
+    name: string;
+    /** Plugin version */
+    version?: string;
+    /** Plugin description */
+    description?: string;
+    /** Plugin source module */
+    source: string;
+    /** Raw config object */
+    config: Record<string, unknown>;
+    /** Parsed plugin configuration */
+    pluginConfig: Record<string, unknown>;
+    /** Get plugin config by ID */
+    getPluginConfig(id: string): Record<string, unknown> | undefined;
+    /** Resolve ~ paths to absolute paths */
+    resolvePath(input: string): string;
+    /** Logger instance */
+    logger: Logger;
+    /** Register CLI commands */
+    registerCli(fn: (ctx: ClawdbotCliContext) => void, opts?: {
+        commands?: string[];
+    }): void;
+    /** Register a tool with single-object parameter pattern */
+    registerTool(tool: {
+        name: string;
+        label: string;
+        description: string;
+        parameters: unknown;
+        execute: (toolCallId: string, input: unknown) => Promise<unknown>;
+    }): void;
+    /** Register service lifecycle */
+    registerService(service: {
+        id: string;
+        start?: () => Promise<void>;
+        stop?: () => Promise<void>;
+    }): void;
+    /** Runtime context (available in agent mode, not CLI) */
+    runtime?: {
+        prompter: {
+            info(msg: string): void;
+            warn(msg: string): void;
+            error(msg: string): void;
+        };
+        openUrl?: (url: string) => Promise<void>;
+    };
+}
+export interface ClawdbotCliContext {
+    program: {
+        command(name: string): ClawdbotCliCommand;
+    };
+    logger: Logger;
+}
+export interface ClawdbotCliCommand {
+    command(name: string): ClawdbotCliCommand;
+    description(msg: string): ClawdbotCliCommand;
+    action(fn: () => Promise<void>): ClawdbotCliCommand;
+    addHelpText(position: 'before' | 'after' | 'beforeAll' | 'afterAll', text: string | ((cmd: this) => string)): ClawdbotCliCommand;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,7 @@
+/**
+ * Clawdbot Plugin API types for Penfield plugin
+ *
+ * Single source of truth for plugin interfaces.
+ * These types are adapted from @clawdbot/types for plugin use.
+ */
+export {};

package/dist/src/validation.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Input validation utilities for Penfield tools
+ *
+ * Defense-in-depth: Server validates too, but client-side validation
+ * provides better UX (fail fast) and prevents malformed requests.
+ */
+/**
+ * Validate that a string is a valid UUID format.
+ * Prevents path traversal attacks in URL interpolation.
+ *
+ * @throws Error if not a valid UUID
+ */
+export declare function validateUuid(value: string, fieldName: string): void;
+/**
+ * Validate artifact path for safety.
+ * Prevents path traversal and ensures proper format.
+ *
+ * @throws Error if path is invalid
+ */
+export declare function validateArtifactPath(path: string): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAInE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAoBvD"}

package/dist/src/validation.js

@@ -0,0 +1,43 @@
+/**
+ * Input validation utilities for Penfield tools
+ *
+ * Defense-in-depth: Server validates too, but client-side validation
+ * provides better UX (fail fast) and prevents malformed requests.
+ */
+// UUID v4 format: 8-4-4-4-12 hex digits
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Validate that a string is a valid UUID format.
+ * Prevents path traversal attacks in URL interpolation.
+ *
+ * @throws Error if not a valid UUID
+ */
+export function validateUuid(value, fieldName) {
+    if (!UUID_REGEX.test(value)) {
+        throw new Error(`Invalid ${fieldName}: must be a valid UUID format`);
+    }
+}
+/**
+ * Validate artifact path for safety.
+ * Prevents path traversal and ensures proper format.
+ *
+ * @throws Error if path is invalid
+ */
+export function validateArtifactPath(path) {
+    if (!path || typeof path !== 'string') {
+        throw new Error('Artifact path is required');
+    }
+    if (path.includes('..')) {
+        throw new Error('Artifact path cannot contain ".." (path traversal not allowed)');
+    }
+    if (!path.startsWith('/')) {
+        throw new Error('Artifact path must be absolute (start with "/")');
+    }
+    // Prevent null bytes and other control characters
+    for (let i = 0; i < path.length; i++) {
+        const code = path.charCodeAt(i);
+        if (code < 32) {
+            throw new Error('Artifact path contains invalid characters');
+        }
+    }
+}