@hyperspell/openclaw-hyperspell 0.4.2 → 0.7.1

package/config.ts

@@ -1,191 +1,273 @@
 export type HyperspellSource =
-  | "collections"
-  | "reddit"
-  | "notion"
-  | "slack"
-  | "google_calendar"
-  | "google_mail"
-  | "box"
-  | "google_drive"
-  | "vault"
-  | "web_crawler"
+	| "collections"
+	| "reddit"
+	| "notion"
+	| "slack"
+	| "google_calendar"
+	| "google_mail"
+	| "box"
+	| "google_drive"
+	| "vault"
+	| "web_crawler";
+
+export type KnowledgeGraphConfig = {
+	enabled: boolean;
+	scanIntervalMinutes: number;
+	batchSize: number;
+};
+
+export type AutoTraceConfig = {
+	enabled: boolean;
+	extract: Array<"procedure" | "memory" | "mood">;
+	metadata?: Record<string, string | number | boolean>;
+};
 
 export type HyperspellConfig = {
-  apiKey: string
-  userId?: string
-  autoContext: boolean
-  syncMemories: boolean
-  sources: HyperspellSource[]
-  maxResults: number
-  debug: boolean
-}
+	apiKey: string;
+	userId?: string;
+	autoContext: boolean;
+	autoTrace: AutoTraceConfig;
+	syncMemories: boolean;
+	sources: HyperspellSource[];
+	maxResults: number;
+	relevanceThreshold: number;
+	debug: boolean;
+	knowledgeGraph: KnowledgeGraphConfig;
+};
 
 const ALLOWED_KEYS = [
-  "apiKey",
-  "userId",
-  "autoContext",
-  "syncMemories",
-  "sources",
-  "maxResults",
-  "debug",
-]
+	"apiKey",
+	"userId",
+	"autoContext",
+	"autoTrace",
+	"syncMemories",
+	"sources",
+	"maxResults",
+	"relevanceThreshold",
+	"debug",
+	"knowledgeGraph",
+];
 
 const VALID_SOURCES: HyperspellSource[] = [
-  "collections",
-  "reddit",
-  "notion",
-  "slack",
-  "google_calendar",
-  "google_mail",
-  "box",
-  "google_drive",
-  "vault",
-  "web_crawler",
-]
+	"collections",
+	"reddit",
+	"notion",
+	"slack",
+	"google_calendar",
+	"google_mail",
+	"box",
+	"google_drive",
+	"vault",
+	"web_crawler",
+];
 
 function assertAllowedKeys(
-  value: Record<string, unknown>,
-  allowed: string[],
-  label: string,
+	value: Record<string, unknown>,
+	allowed: string[],
+	label: string,
 ): void {
-  const unknown = Object.keys(value).filter((k) => !allowed.includes(k))
-  if (unknown.length > 0) {
-    throw new Error(`${label} has unknown keys: ${unknown.join(", ")}`)
-  }
+	const unknown = Object.keys(value).filter((k) => !allowed.includes(k));
+	if (unknown.length > 0) {
+		throw new Error(`${label} has unknown keys: ${unknown.join(", ")}`);
+	}
 }
 
 function resolveEnvVars(value: string): string {
-  return value.replace(/\$\{([^}]+)\}/g, (_, envVar: string) => {
-    const envValue = process.env[envVar]
-    if (!envValue) {
-      throw new Error(`Environment variable ${envVar} is not set`)
-    }
-    return envValue
-  })
+	return value.replace(/\$\{([^}]+)\}/g, (_, envVar: string) => {
+		const envValue = process.env[envVar];
+		if (!envValue) {
+			throw new Error(`Environment variable ${envVar} is not set`);
+		}
+		return envValue;
+	});
 }
 
 function parseSources(raw: string | string[] | undefined): HyperspellSource[] {
-  if (!raw) {
-    return []
-  }
-
-  // Handle array input
-  if (Array.isArray(raw)) {
-    const sources = raw
-      .map((s) => String(s).trim().toLowerCase())
-      .filter((s) => s.length > 0) as HyperspellSource[]
-
-    for (const source of sources) {
-      if (!VALID_SOURCES.includes(source)) {
-        throw new Error(
-          `Invalid source "${source}". Valid sources: ${VALID_SOURCES.join(", ")}`,
-        )
-      }
-    }
-
-    return sources
-  }
-
-  // Handle string input (comma-separated)
-  if (typeof raw === "string" && raw.trim() === "") {
-    return []
-  }
-
-  const sources = raw
-    .split(",")
-    .map((s) => s.trim().toLowerCase())
-    .filter((s) => s.length > 0) as HyperspellSource[]
-
-  for (const source of sources) {
-    if (!VALID_SOURCES.includes(source)) {
-      throw new Error(
-        `Invalid source "${source}". Valid sources: ${VALID_SOURCES.join(", ")}`,
-      )
-    }
-  }
-
-  return sources
+	if (!raw) {
+		return [];
+	}
+
+	// Handle array input
+	if (Array.isArray(raw)) {
+		const sources = raw
+			.map((s) => String(s).trim().toLowerCase())
+			.filter((s) => s.length > 0) as HyperspellSource[];
+
+		for (const source of sources) {
+			if (!VALID_SOURCES.includes(source)) {
+				throw new Error(
+					`Invalid source "${source}". Valid sources: ${VALID_SOURCES.join(", ")}`,
+				);
+			}
+		}
+
+		return sources;
+	}
+
+	// Handle string input (comma-separated)
+	if (typeof raw === "string" && raw.trim() === "") {
+		return [];
+	}
+
+	const sources = raw
+		.split(",")
+		.map((s) => s.trim().toLowerCase())
+		.filter((s) => s.length > 0) as HyperspellSource[];
+
+	for (const source of sources) {
+		if (!VALID_SOURCES.includes(source)) {
+			throw new Error(
+				`Invalid source "${source}". Valid sources: ${VALID_SOURCES.join(", ")}`,
+			);
+		}
+	}
+
+	return sources;
 }
 
 export function parseConfig(raw: unknown): HyperspellConfig {
-  const cfg =
-    raw && typeof raw === "object" && !Array.isArray(raw)
-      ? (raw as Record<string, unknown>)
-      : {}
-
-  if (Object.keys(cfg).length > 0) {
-    assertAllowedKeys(cfg, ALLOWED_KEYS, "hyperspell config")
-  }
-
-  const apiKey =
-    typeof cfg.apiKey === "string" && cfg.apiKey.length > 0
-      ? resolveEnvVars(cfg.apiKey)
-      : process.env.HYPERSPELL_API_KEY
-
-  if (!apiKey) {
-    throw new Error(
-      "hyperspell: apiKey is required (set in plugin config or HYPERSPELL_API_KEY env var)",
-    )
-  }
-
-  return {
-    apiKey,
-    userId: cfg.userId as string | undefined,
-    autoContext: (cfg.autoContext as boolean) ?? true,
-    syncMemories: (cfg.syncMemories as boolean) ?? false,
-    sources: parseSources(cfg.sources as string | string[] | undefined),
-    maxResults: (cfg.maxResults as number) ?? 10,
-    debug: (cfg.debug as boolean) ?? false,
-  }
+	const cfg =
+		raw && typeof raw === "object" && !Array.isArray(raw)
+			? (raw as Record<string, unknown>)
+			: {};
+
+	if (Object.keys(cfg).length > 0) {
+		assertAllowedKeys(cfg, ALLOWED_KEYS, "hyperspell config");
+	}
+
+	const apiKey =
+		typeof cfg.apiKey === "string" && cfg.apiKey.length > 0
+			? resolveEnvVars(cfg.apiKey)
+			: process.env.HYPERSPELL_API_KEY;
+
+	if (!apiKey) {
+		throw new Error(
+			"hyperspell: apiKey is required (set in plugin config or HYPERSPELL_API_KEY env var)",
+		);
+	}
+
+	const kgRaw = (cfg.knowledgeGraph ?? {}) as Record<string, unknown>;
+	const atRaw = (cfg.autoTrace ?? {}) as Record<string, unknown>;
+
+	return {
+		apiKey,
+		userId: cfg.userId as string | undefined,
+		autoContext: (cfg.autoContext as boolean) ?? true,
+		autoTrace: {
+			enabled: (atRaw.enabled as boolean) ?? false,
+			extract: (atRaw.extract as Array<"procedure" | "memory" | "mood">) ?? [
+				"procedure",
+			],
+			metadata: atRaw.metadata as
+				| Record<string, string | number | boolean>
+				| undefined,
+		},
+		syncMemories: (cfg.syncMemories as boolean) ?? false,
+		sources: parseSources(cfg.sources as string | string[] | undefined),
+		maxResults: (cfg.maxResults as number) ?? 10,
+		relevanceThreshold: (cfg.relevanceThreshold as number) ?? 0.6,
+		debug: (cfg.debug as boolean) ?? false,
+		knowledgeGraph: {
+			enabled: (kgRaw.enabled as boolean) ?? false,
+			scanIntervalMinutes: (kgRaw.scanIntervalMinutes as number) ?? 60,
+			batchSize: (kgRaw.batchSize as number) ?? 20,
+		},
+	};
 }
 
 export const hyperspellConfigSchema = {
-  parse: parseConfig,
+	parse: parseConfig,
+};
+
+/**
+ * Resolve OpenClaw state directory (matches OpenClaw's own logic).
+ */
+export function resolveStateDir(): string {
+	const { homedir } = require("node:os");
+	const path = require("node:path");
+
+	const override =
+		process.env.OPENCLAW_STATE_DIR?.trim() ||
+		process.env.CLAWDBOT_STATE_DIR?.trim();
+	if (override) {
+		return override.startsWith("~")
+			? override.replace(/^~(?=$|[\\/])/, homedir())
+			: path.resolve(override);
+	}
+	return path.join(homedir(), ".openclaw");
+}
+
+/**
+ * Resolve OpenClaw config file path (matches OpenClaw's own logic).
+ */
+export function resolveConfigPath(): string {
+	const path = require("node:path");
+
+	const override =
+		process.env.OPENCLAW_CONFIG_PATH?.trim() ||
+		process.env.CLAWDBOT_CONFIG_PATH?.trim();
+	if (override) {
+		const { homedir } = require("node:os");
+		return override.startsWith("~")
+			? override.replace(/^~(?=$|[\\/])/, homedir())
+			: path.resolve(override);
+	}
+	return path.join(resolveStateDir(), "openclaw.json");
 }
 
 /**
  * Get the workspace directory from OpenClaw config
  */
 export function getWorkspaceDir(): string {
-  const { homedir } = require("node:os")
-  const fs = require("node:fs")
-  const path = require("node:path")
-
-  // Resolve config path
-  const override = process.env.OPENCLAW_CONFIG_PATH?.trim() || process.env.CLAWDBOT_CONFIG_PATH?.trim()
-  let configPath: string
-  if (override) {
-    configPath = override.startsWith("~")
-      ? override.replace(/^~(?=$|[\\/])/, homedir())
-      : path.resolve(override)
-  } else {
-    const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() || process.env.CLAWDBOT_STATE_DIR?.trim()
-    const resolvedStateDir = stateDir
-      ? (stateDir.startsWith("~") ? stateDir.replace(/^~(?=$|[\\/])/, homedir()) : path.resolve(stateDir))
-      : path.join(homedir(), ".openclaw")
-    configPath = path.join(resolvedStateDir, "openclaw.json")
-  }
-
-  // Read workspace from config
-  if (fs.existsSync(configPath)) {
-    try {
-      const content = fs.readFileSync(configPath, "utf-8")
-      const config = JSON.parse(content)
-      const workspace = config?.agents?.defaults?.workspace
-      if (workspace) {
-        return workspace.startsWith("~")
-          ? workspace.replace(/^~(?=$|[\\/])/, homedir())
-          : workspace
-      }
-    } catch (_e) {
-      // Fall back to default
-    }
-  }
-
-  // Default workspace
-  const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() || process.env.CLAWDBOT_STATE_DIR?.trim()
-  const resolvedStateDir = stateDir
-    ? (stateDir.startsWith("~") ? stateDir.replace(/^~(?=$|[\\/])/, homedir()) : path.resolve(stateDir))
-    : path.join(homedir(), ".openclaw")
-  return path.join(resolvedStateDir, "workspace")
+	const { homedir } = require("node:os");
+	const fs = require("node:fs");
+	const path = require("node:path");
+
+	// Resolve config path
+	const override =
+		process.env.OPENCLAW_CONFIG_PATH?.trim() ||
+		process.env.CLAWDBOT_CONFIG_PATH?.trim();
+	let configPath: string;
+	if (override) {
+		configPath = override.startsWith("~")
+			? override.replace(/^~(?=$|[\\/])/, homedir())
+			: path.resolve(override);
+	} else {
+		const stateDir =
+			process.env.OPENCLAW_STATE_DIR?.trim() ||
+			process.env.CLAWDBOT_STATE_DIR?.trim();
+		const resolvedStateDir = stateDir
+			? stateDir.startsWith("~")
+				? stateDir.replace(/^~(?=$|[\\/])/, homedir())
+				: path.resolve(stateDir)
+			: path.join(homedir(), ".openclaw");
+		configPath = path.join(resolvedStateDir, "openclaw.json");
+	}
+
+	// Read workspace from config
+	if (fs.existsSync(configPath)) {
+		try {
+			const content = fs.readFileSync(configPath, "utf-8");
+			const config = JSON.parse(content);
+			const workspace = config?.agents?.defaults?.workspace;
+			if (workspace) {
+				return workspace.startsWith("~")
+					? workspace.replace(/^~(?=$|[\\/])/, homedir())
+					: workspace;
+			}
+		} catch (_e) {
+			// Fall back to default
+		}
+	}
+
+	// Default workspace
+	const stateDir =
+		process.env.OPENCLAW_STATE_DIR?.trim() ||
+		process.env.CLAWDBOT_STATE_DIR?.trim();
+	const resolvedStateDir = stateDir
+		? stateDir.startsWith("~")
+			? stateDir.replace(/^~(?=$|[\\/])/, homedir())
+			: path.resolve(stateDir)
+		: path.join(homedir(), ".openclaw");
+	return path.join(resolvedStateDir, "workspace");
 }