clawvault 2.6.0 → 3.0.0

package/dist/plugin/templates.d.cts

@@ -0,0 +1,52 @@
+/**
+ * Template Registry for ClawVault
+ *
+ * Parses YAML frontmatter from template files and builds an in-memory
+ * registry of {primitiveType → schema}. Supports dynamic observation
+ * classification and template-aware file writing.
+ */
+interface TemplateFieldSchema {
+    type: string;
+    required?: boolean;
+    default?: string | number | boolean;
+    enum?: string[];
+    description?: string;
+}
+interface TemplateSchema {
+    primitive: string;
+    description?: string;
+    fields: Record<string, TemplateFieldSchema>;
+    bodyTemplate?: string;
+    keywords?: string[];
+}
+interface TemplateRegistry {
+    schemas: Map<string, TemplateSchema>;
+    keywordIndex: Map<string, string[]>;
+    initialized: boolean;
+}
+interface ClassificationResult {
+    primitiveType: string;
+    confidence: number;
+    matchedKeywords: string[];
+}
+declare function getTemplateRegistry(): TemplateRegistry;
+declare function initializeTemplateRegistry(templatesDir?: string): TemplateRegistry;
+declare function classifyText(text: string): ClassificationResult;
+declare function getSchema(primitiveType: string): TemplateSchema | undefined;
+declare function getAllSchemas(): TemplateSchema[];
+declare function getSchemaNames(): string[];
+interface FrontmatterOptions {
+    title?: string;
+    extraFields?: Record<string, unknown>;
+    source?: string;
+    sessionId?: string;
+}
+declare function generateFrontmatter(primitiveType: string, options?: FrontmatterOptions): Record<string, unknown>;
+declare function validateFrontmatter(primitiveType: string, frontmatter: Record<string, unknown>): {
+    valid: boolean;
+    errors: string[];
+};
+declare function serializeFrontmatter(frontmatter: Record<string, unknown>): string;
+declare function resetTemplateRegistry(): void;
+
+export { type ClassificationResult, type FrontmatterOptions, type TemplateFieldSchema, type TemplateRegistry, type TemplateSchema, classifyText, generateFrontmatter, getAllSchemas, getSchema, getSchemaNames, getTemplateRegistry, initializeTemplateRegistry, resetTemplateRegistry, serializeFrontmatter, validateFrontmatter };

package/dist/plugin/templates.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Template Registry for ClawVault
+ *
+ * Parses YAML frontmatter from template files and builds an in-memory
+ * registry of {primitiveType → schema}. Supports dynamic observation
+ * classification and template-aware file writing.
+ */
+interface TemplateFieldSchema {
+    type: string;
+    required?: boolean;
+    default?: string | number | boolean;
+    enum?: string[];
+    description?: string;
+}
+interface TemplateSchema {
+    primitive: string;
+    description?: string;
+    fields: Record<string, TemplateFieldSchema>;
+    bodyTemplate?: string;
+    keywords?: string[];
+}
+interface TemplateRegistry {
+    schemas: Map<string, TemplateSchema>;
+    keywordIndex: Map<string, string[]>;
+    initialized: boolean;
+}
+interface ClassificationResult {
+    primitiveType: string;
+    confidence: number;
+    matchedKeywords: string[];
+}
+declare function getTemplateRegistry(): TemplateRegistry;
+declare function initializeTemplateRegistry(templatesDir?: string): TemplateRegistry;
+declare function classifyText(text: string): ClassificationResult;
+declare function getSchema(primitiveType: string): TemplateSchema | undefined;
+declare function getAllSchemas(): TemplateSchema[];
+declare function getSchemaNames(): string[];
+interface FrontmatterOptions {
+    title?: string;
+    extraFields?: Record<string, unknown>;
+    source?: string;
+    sessionId?: string;
+}
+declare function generateFrontmatter(primitiveType: string, options?: FrontmatterOptions): Record<string, unknown>;
+declare function validateFrontmatter(primitiveType: string, frontmatter: Record<string, unknown>): {
+    valid: boolean;
+    errors: string[];
+};
+declare function serializeFrontmatter(frontmatter: Record<string, unknown>): string;
+declare function resetTemplateRegistry(): void;
+
+export { type ClassificationResult, type FrontmatterOptions, type TemplateFieldSchema, type TemplateRegistry, type TemplateSchema, classifyText, generateFrontmatter, getAllSchemas, getSchema, getSchemaNames, getTemplateRegistry, initializeTemplateRegistry, resetTemplateRegistry, serializeFrontmatter, validateFrontmatter };

package/dist/plugin/templates.js

@@ -0,0 +1,25 @@
+import {
+  classifyText,
+  generateFrontmatter,
+  getAllSchemas,
+  getSchema,
+  getSchemaNames,
+  getTemplateRegistry,
+  initializeTemplateRegistry,
+  resetTemplateRegistry,
+  serializeFrontmatter,
+  validateFrontmatter
+} from "../chunk-GQSLDZTS.js";
+import "../chunk-3RG5ZIWI.js";
+export {
+  classifyText,
+  generateFrontmatter,
+  getAllSchemas,
+  getSchema,
+  getSchemaNames,
+  getTemplateRegistry,
+  initializeTemplateRegistry,
+  resetTemplateRegistry,
+  serializeFrontmatter,
+  validateFrontmatter
+};

package/dist/plugin/types.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugin/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/plugin/types.d.cts

@@ -0,0 +1,209 @@
+/**
+ * Core types for ClawVault OpenClaw plugin
+ */
+interface TemplateFieldSchema {
+    type: string;
+    required?: boolean;
+    default?: string | number | boolean;
+    enum?: string[];
+    description?: string;
+}
+interface TemplateSchema {
+    primitive: string;
+    description?: string;
+    fields: Record<string, TemplateFieldSchema>;
+    bodyTemplate?: string;
+    keywords?: string[];
+}
+interface TemplateRegistry {
+    schemas: Map<string, TemplateSchema>;
+    keywordIndex: Map<string, string[]>;
+    initialized: boolean;
+}
+interface ClassificationResult {
+    primitiveType: string;
+    confidence: number;
+    matchedKeywords: string[];
+}
+interface Observation {
+    text: string;
+    primitiveType: string;
+    confidence: number;
+    matchedKeywords: string[];
+    category: string;
+    tags: string[];
+    extractedAt: Date;
+}
+interface ObservationResult {
+    observations: Observation[];
+    skipped: number;
+    reason?: string;
+}
+interface VaultFile {
+    path: string;
+    relativePath: string;
+    primitiveType: string;
+    frontmatter: Record<string, unknown>;
+    content: string;
+    modifiedAt: Date;
+    createdAt: Date;
+}
+interface WriteOptions {
+    primitiveType?: string;
+    title?: string;
+    content?: string;
+    extraFields?: Record<string, unknown>;
+    source?: string;
+    sessionId?: string;
+    directory?: string;
+    filename?: string;
+    overwrite?: boolean;
+}
+interface WriteResult {
+    success: boolean;
+    path: string;
+    primitiveType: string;
+    errors: string[];
+    created: boolean;
+    updated: boolean;
+}
+interface SessionRecap {
+    xml: string;
+    fileCount: number;
+    primitiveGroups: Record<string, number>;
+    timeRange: {
+        oldest: Date;
+        newest: Date;
+    } | null;
+}
+interface PreferenceContext {
+    xml: string;
+    preferenceCount: number;
+    categories: string[];
+}
+interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp?: string | Date;
+}
+interface SearchResult {
+    id: string;
+    title: string;
+    content: string;
+    snippet: string;
+    score: number;
+    category?: string;
+    path?: string;
+    modifiedAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+interface SearchOptions {
+    limit?: number;
+    category?: string;
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    threshold?: number;
+    queryType?: QueryType;
+}
+type QueryType = 'factual' | 'preference' | 'temporal' | 'semantic' | 'auto';
+interface Preference {
+    category: string;
+    item: string;
+    sentiment: 'positive' | 'negative' | 'neutral';
+    confidence: number;
+    source?: string;
+    extractedAt: Date;
+}
+interface DateIndex {
+    date: string;
+    documents: string[];
+    events: Array<{
+        title: string;
+        documentId: string;
+        type?: string;
+    }>;
+}
+interface IngestResult {
+    documentsCreated: number;
+    preferencesExtracted: number;
+    datesIndexed: number;
+    sessionId: string;
+}
+interface VaultStatus {
+    initialized: boolean;
+    documentCount: number;
+    categories: Record<string, number>;
+    lastActivity?: Date;
+    preferencesCount: number;
+    datesIndexedCount: number;
+}
+interface PluginConfig {
+    vaultPath?: string;
+    observer?: {
+        enabled?: boolean;
+        tokenThreshold?: number;
+        model?: string;
+    };
+    search?: {
+        defaultLimit?: number;
+        bm25PrefilterK?: number;
+        exhaustiveThreshold?: number;
+    };
+}
+interface OpenClawApi {
+    config?: unknown;
+    logger?: Logger;
+    registerTool?: (name: string, schema: ToolSchema, handler: ToolHandler) => void;
+    registerService?: (service: Service) => void;
+    registerCommand?: (command: SlashCommand) => void;
+    registerHook?: (hookName: string, handler: HookHandler) => void;
+    getPluginConfig?: (pluginId: string) => PluginConfig | undefined;
+}
+interface Logger {
+    debug?: (payload: unknown, message?: string) => void;
+    info?: (payload: unknown, message?: string) => void;
+    warn?: (payload: unknown, message?: string) => void;
+    error?: (payload: unknown, message?: string) => void;
+}
+interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description?: string;
+            enum?: string[];
+            default?: unknown;
+        }>;
+        required?: string[];
+    };
+}
+type ToolHandler = (input: Record<string, unknown>) => Promise<unknown> | unknown;
+interface Service {
+    id: string;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+}
+interface SlashCommand {
+    name: string;
+    description?: string;
+    handler: (input: {
+        args?: string;
+        context?: unknown;
+    }) => Promise<{
+        content: string;
+    }>;
+}
+type HookHandler = (event: HookEvent) => Promise<void> | void;
+interface HookEvent {
+    type: string;
+    sessionId?: string;
+    messages?: Message[];
+    timestamp?: Date;
+    metadata?: Record<string, unknown>;
+}
+
+export type { ClassificationResult, DateIndex, HookEvent, HookHandler, IngestResult, Logger, Message, Observation, ObservationResult, OpenClawApi, PluginConfig, Preference, PreferenceContext, QueryType, SearchOptions, SearchResult, Service, SessionRecap, SlashCommand, TemplateFieldSchema, TemplateRegistry, TemplateSchema, ToolHandler, ToolSchema, VaultFile, VaultStatus, WriteOptions, WriteResult };

package/dist/plugin/types.d.ts

@@ -0,0 +1,209 @@
+/**
+ * Core types for ClawVault OpenClaw plugin
+ */
+interface TemplateFieldSchema {
+    type: string;
+    required?: boolean;
+    default?: string | number | boolean;
+    enum?: string[];
+    description?: string;
+}
+interface TemplateSchema {
+    primitive: string;
+    description?: string;
+    fields: Record<string, TemplateFieldSchema>;
+    bodyTemplate?: string;
+    keywords?: string[];
+}
+interface TemplateRegistry {
+    schemas: Map<string, TemplateSchema>;
+    keywordIndex: Map<string, string[]>;
+    initialized: boolean;
+}
+interface ClassificationResult {
+    primitiveType: string;
+    confidence: number;
+    matchedKeywords: string[];
+}
+interface Observation {
+    text: string;
+    primitiveType: string;
+    confidence: number;
+    matchedKeywords: string[];
+    category: string;
+    tags: string[];
+    extractedAt: Date;
+}
+interface ObservationResult {
+    observations: Observation[];
+    skipped: number;
+    reason?: string;
+}
+interface VaultFile {
+    path: string;
+    relativePath: string;
+    primitiveType: string;
+    frontmatter: Record<string, unknown>;
+    content: string;
+    modifiedAt: Date;
+    createdAt: Date;
+}
+interface WriteOptions {
+    primitiveType?: string;
+    title?: string;
+    content?: string;
+    extraFields?: Record<string, unknown>;
+    source?: string;
+    sessionId?: string;
+    directory?: string;
+    filename?: string;
+    overwrite?: boolean;
+}
+interface WriteResult {
+    success: boolean;
+    path: string;
+    primitiveType: string;
+    errors: string[];
+    created: boolean;
+    updated: boolean;
+}
+interface SessionRecap {
+    xml: string;
+    fileCount: number;
+    primitiveGroups: Record<string, number>;
+    timeRange: {
+        oldest: Date;
+        newest: Date;
+    } | null;
+}
+interface PreferenceContext {
+    xml: string;
+    preferenceCount: number;
+    categories: string[];
+}
+interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp?: string | Date;
+}
+interface SearchResult {
+    id: string;
+    title: string;
+    content: string;
+    snippet: string;
+    score: number;
+    category?: string;
+    path?: string;
+    modifiedAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+interface SearchOptions {
+    limit?: number;
+    category?: string;
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    threshold?: number;
+    queryType?: QueryType;
+}
+type QueryType = 'factual' | 'preference' | 'temporal' | 'semantic' | 'auto';
+interface Preference {
+    category: string;
+    item: string;
+    sentiment: 'positive' | 'negative' | 'neutral';
+    confidence: number;
+    source?: string;
+    extractedAt: Date;
+}
+interface DateIndex {
+    date: string;
+    documents: string[];
+    events: Array<{
+        title: string;
+        documentId: string;
+        type?: string;
+    }>;
+}
+interface IngestResult {
+    documentsCreated: number;
+    preferencesExtracted: number;
+    datesIndexed: number;
+    sessionId: string;
+}
+interface VaultStatus {
+    initialized: boolean;
+    documentCount: number;
+    categories: Record<string, number>;
+    lastActivity?: Date;
+    preferencesCount: number;
+    datesIndexedCount: number;
+}
+interface PluginConfig {
+    vaultPath?: string;
+    observer?: {
+        enabled?: boolean;
+        tokenThreshold?: number;
+        model?: string;
+    };
+    search?: {
+        defaultLimit?: number;
+        bm25PrefilterK?: number;
+        exhaustiveThreshold?: number;
+    };
+}
+interface OpenClawApi {
+    config?: unknown;
+    logger?: Logger;
+    registerTool?: (name: string, schema: ToolSchema, handler: ToolHandler) => void;
+    registerService?: (service: Service) => void;
+    registerCommand?: (command: SlashCommand) => void;
+    registerHook?: (hookName: string, handler: HookHandler) => void;
+    getPluginConfig?: (pluginId: string) => PluginConfig | undefined;
+}
+interface Logger {
+    debug?: (payload: unknown, message?: string) => void;
+    info?: (payload: unknown, message?: string) => void;
+    warn?: (payload: unknown, message?: string) => void;
+    error?: (payload: unknown, message?: string) => void;
+}
+interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description?: string;
+            enum?: string[];
+            default?: unknown;
+        }>;
+        required?: string[];
+    };
+}
+type ToolHandler = (input: Record<string, unknown>) => Promise<unknown> | unknown;
+interface Service {
+    id: string;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+}
+interface SlashCommand {
+    name: string;
+    description?: string;
+    handler: (input: {
+        args?: string;
+        context?: unknown;
+    }) => Promise<{
+        content: string;
+    }>;
+}
+type HookHandler = (event: HookEvent) => Promise<void> | void;
+interface HookEvent {
+    type: string;
+    sessionId?: string;
+    messages?: Message[];
+    timestamp?: Date;
+    metadata?: Record<string, unknown>;
+}
+
+export type { ClassificationResult, DateIndex, HookEvent, HookHandler, IngestResult, Logger, Message, Observation, ObservationResult, OpenClawApi, PluginConfig, Preference, PreferenceContext, QueryType, SearchOptions, SearchResult, Service, SessionRecap, SlashCommand, TemplateFieldSchema, TemplateRegistry, TemplateSchema, ToolHandler, ToolSchema, VaultFile, VaultStatus, WriteOptions, WriteResult };