@usecortex_ai/openclaw-cortex-ai 0.0.1 → 0.1.1

package/.github/workflows/publish.yaml

@@ -0,0 +1,40 @@
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    name: Publish package to npm
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build package
+        # If you have a build step, otherwise remove this
+        run: npm run build
+        continue-on-error: true
+
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          # Only publish if this is not a pre-release and version has changed
+          if [ "$(npm view . version)" != "$(node -p "require('./package.json').version")" ]; then
+            npm publish --access public
+          else
+            echo "Version already published, skipping."
+          fi

package/README.md

@@ -1,6 +1,6 @@
 # Cortex AI — OpenClaw Plugin
 
-Long-term memory for OpenClaw powered by [Cortex AI](https://usecortex.ai). Automatically captures conversations, recalls relevant context with knowledge-graph connections, and injects them before every AI turn.
+State-of-the-art agentic memory for OpenClaw powered by [Cortex AI](https://usecortex.ai). Automatically captures conversations, recalls relevant context with knowledge-graph connections, and injects them before every AI turn.
 
 ## Install
 
@@ -39,47 +39,67 @@ Or configure directly in `openclaw.json`:
 
 ### Options
 
-| Key                | Type      | Default            | Description                                                                |
-| ------------------ | --------- | ------------------ | -------------------------------------------------------------------------- |
-| `subTenantId`      | `string`  | `"cortex-openclaw"`| Sub-tenant for data partitioning within your tenant                        |
-| `autoRecall`       | `boolean` | `true`             | Inject relevant memories before every AI turn                              |
-| `autoCapture`      | `boolean` | `true`             | Store conversation exchanges after every AI turn                           |
-| `maxRecallResults` | `number`  | `10`               | Max memory chunks injected into context per turn                           |
-| `recallMode`       | `string`  | `"fast"`           | `"fast"` or `"thinking"` (deeper personalised recall with graph traversal) |
-| `graphContext`     | `boolean` | `true`             | Include knowledge graph relations in recalled context                      |
-| `debug`            | `boolean` | `false`            | Verbose debug logs                                                         |
+| Key                  | Type        | Default               | Description                                                                    |
+| -------------------- | ----------- | --------------------- | ------------------------------------------------------------------------------ |
+| `subTenantId`      | `string`  | `"cortex-openclaw"` | Sub-tenant for data partitioning within your tenant                            |
+| `autoRecall`       | `boolean` | `true`              | Inject relevant memories before every AI turn                                  |
+| `autoCapture`      | `boolean` | `true`              | Store conversation exchanges after every AI turn                               |
+| `maxRecallResults` | `number`  | `10`                | Max memory chunks injected into context per turn                               |
+| `recallMode`       | `string`  | `"fast"`            | `"fast"` or `"thinking"` (deeper personalised recall with graph traversal) |
+| `graphContext`     | `boolean` | `true`              | Include knowledge graph relations in recalled context                          |
+| `ignoreTerm`       | `string`  | `"cortex-ignore"`    | Messages containing this term are excluded from recall & capture              |
+| `debug`            | `boolean` | `false`             | Verbose debug logs                                                             |
 
 ## How It Works
 
 - **Auto-Recall** — Before every AI turn, queries Cortex (`/recall/recall_preferences`) for relevant memories and injects graph-enriched context (entity paths, chunk relations, extra context).
-
 - **Auto-Capture** — After every AI turn, the last user/assistant exchange is sent to Cortex (`/memories/add_memory`) as conversation pairs with `infer: true` and `upsert: true`. The session ID is used as `source_id` so Cortex groups exchanges per session and builds a knowledge graph automatically.
 
+## Interactive Onboarding
+
+Run the interactive CLI wizard to configure Cortex AI:
+
+```bash
+# Basic onboarding (API key, tenant ID, sub-tenant, ignore term)
+openclaw cortex onboard
+
+# Advanced onboarding (all options including recall mode, graph context, etc.)
+openclaw cortex onboard --advanced
+```
+
+The wizard guides you through configuration with colored prompts, validates inputs, and outputs:
+- `.env` file lines for credentials
+- Plugin config JSON for non-default settings
+- A summary table with masked sensitive values
+
 ## Slash Commands
 
-| Command                    | Description                                       |
-| -------------------------- | ------------------------------------------------- |
-| `/cortex-remember <text>`  | Save something to Cortex memory                   |
-| `/cortex-recall <query>`   | Search memories with relevance scores              |
-| `/cortex-list`             | List all stored user memories                      |
-| `/cortex-delete <id>`      | Delete a specific memory by its ID                 |
-| `/cortex-get <source_id>`  | Fetch the full content of a source                 |
+| Command                     | Description                           |
+| --------------------------- | ------------------------------------- |
+| `/cortex-onboard`          | Show current configuration status     |
+| `/cortex-remember <text>` | Save something to Cortex memory       |
+| `/cortex-recall <query>`  | Search memories with relevance scores |
+| `/cortex-list`            | List all stored user memories         |
+| `/cortex-delete <id>`     | Delete a specific memory by its ID    |
+| `/cortex-get <source_id>` | Fetch the full content of a source    |
 
 ## AI Tools
 
-| Tool             | Description                                               |
-| ---------------- | --------------------------------------------------------- |
-| `cortex_store`   | Save information to long-term memory                      |
-| `cortex_search`  | Search memories with graph-enriched results               |
+| Tool              | Description                                 |
+| ----------------- | ------------------------------------------- |
+| `cortex_store`  | Save information to memory                  |
+| `cortex_search` | Search memories with graph-enriched results |
 
 ## CLI
 
 ```bash
-openclaw cortex search <query>     # Search memories
-openclaw cortex list               # List all user memories
-openclaw cortex delete <id>        # Delete a memory
-openclaw cortex get <source_id>    # Fetch source content
-openclaw cortex status             # Show plugin configuration
+openclaw cortex onboard             # Interactive onboarding wizard
+openclaw cortex onboard --advanced  # Advanced onboarding wizard
+openclaw cortex search <query>      # Search memories
+openclaw cortex list                # List all user memories
+openclaw cortex delete <id>         # Delete a memory
+openclaw cortex get <source_id>     # Fetch source content
+openclaw cortex status              # Show plugin configuration
 ```
 
 ## Context Injection

package/client.ts

@@ -18,7 +18,9 @@ const API_BASE = "https://api.usecortex.ai"
 const INGEST_INSTRUCTIONS =
 	"Focus on extracting user preferences, habits, opinions, likes, dislikes, " +
 	"goals, and recurring themes. Capture any stated or implied personal context " +
-	"that would help personalise future interactions."
+	"that would help personalise future interactions. Capture important personal details like " +
+	"name, age, email ids, phone numbers, etc. along with the original name and context " +
+	"so that it can be used to personalise future interactions."
 
 export class CortexClient {
 	private apiKey: string
@@ -74,7 +76,10 @@ export class CortexClient {
 	async ingestConversation(
 		turns: ConversationTurn[],
 		sourceId: string,
-		userName?: string,
+		opts?: {
+			userName?: string
+			metadata?: Record<string, unknown>
+		},
 	): Promise<AddMemoryResponse> {
 		const payload: AddMemoryRequest = {
 			memories: [
@@ -82,8 +87,11 @@ export class CortexClient {
 					user_assistant_pairs: turns,
 					infer: true,
 					source_id: sourceId,
-					user_name: userName ?? "User",
+					user_name: opts?.userName ?? "User",
 					custom_instructions: INGEST_INSTRUCTIONS,
+					...(opts?.metadata && {
+						document_metadata: JSON.stringify(opts.metadata),
+					}),
 				},
 			],
 			tenant_id: this.tenantId,

package/commands/cli.ts

@@ -6,6 +6,7 @@ export function registerCliCommands(
 	api: OpenClawPluginApi,
 	client: CortexClient,
 	cfg: CortexPluginConfig,
+	onboardingRegistrar?: (root: any) => void,
 ): void {
 	api.registerCli(
 		({ program }: { program: any }) => {
@@ -86,7 +87,10 @@ export function registerCliCommands(
 					console.log(`Recall Mode:  ${cfg.recallMode}`)
 					console.log(`Graph:        ${cfg.graphContext}`)
 					console.log(`Max Results:  ${cfg.maxRecallResults}`)
+					console.log(`Ignore Term:  ${cfg.ignoreTerm}`)
 				})
+
+			if (onboardingRegistrar) onboardingRegistrar(root)
 		},
 		{ commands: ["cortex"] },
 	)

package/commands/onboarding.ts

@@ -0,0 +1,442 @@
+import * as readline from "node:readline"
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk"
+import type { CortexClient } from "../client.ts"
+import type { CortexPluginConfig } from "../config.ts"
+import { log } from "../log.ts"
+
+// ── ANSI helpers ──
+
+const c = {
+	reset: "\x1b[0m",
+	bold: "\x1b[1m",
+	dim: "\x1b[2m",
+	cyan: "\x1b[36m",
+	green: "\x1b[32m",
+	yellow: "\x1b[33m",
+	red: "\x1b[31m",
+	magenta: "\x1b[35m",
+	white: "\x1b[37m",
+	bgCyan: "\x1b[46m",
+	bgGreen: "\x1b[42m",
+	black: "\x1b[30m",
+}
+
+function mask(value: string, visible = 4): string {
+	if (value.length <= visible) return "****"
+	return `${"*".repeat(value.length - visible)}${value.slice(-visible)}`
+}
+
+// ── Prompt primitives ──
+
+function createRl(): readline.Interface {
+	return readline.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+	})
+}
+
+function ask(rl: readline.Interface, question: string): Promise<string> {
+	return new Promise((resolve) => rl.question(question, resolve))
+}
+
+async function promptText(
+	rl: readline.Interface,
+	label: string,
+	opts?: { default?: string; required?: boolean; secret?: boolean },
+): Promise<string> {
+	const def = opts?.default
+	const hint = def ? `${c.dim} (${def})${c.reset}` : opts?.required ? `${c.red} *${c.reset}` : ""
+	const prefix = `  ${c.cyan}?${c.reset} ${c.bold}${label}${c.reset}${hint}${c.dim} ›${c.reset} `
+
+	while (true) {
+		const raw = await ask(rl, prefix)
+		const value = raw.trim()
+		if (value) return value
+		if (def) return def
+		if (opts?.required) {
+			console.log(`    ${c.red}This field is required.${c.reset}`)
+			continue
+		}
+		return ""
+	}
+}
+
+async function promptChoice(
+	rl: readline.Interface,
+	label: string,
+	choices: string[],
+	defaultChoice: string,
+): Promise<string> {
+	const tags = choices
+		.map((ch) => (ch === defaultChoice ? `${c.green}${c.bold}${ch}${c.reset}` : `${c.dim}${ch}${c.reset}`))
+		.join(`${c.dim} / ${c.reset}`)
+
+	const prefix = `  ${c.cyan}?${c.reset} ${c.bold}${label}${c.reset} ${tags}${c.dim} ›${c.reset} `
+
+	while (true) {
+		const raw = await ask(rl, prefix)
+		const value = raw.trim().toLowerCase()
+		if (!value) return defaultChoice
+		const match = choices.find((ch) => ch.toLowerCase() === value)
+		if (match) return match
+		console.log(`    ${c.yellow}Choose one of: ${choices.join(", ")}${c.reset}`)
+	}
+}
+
+async function promptBool(
+	rl: readline.Interface,
+	label: string,
+	defaultVal: boolean,
+): Promise<boolean> {
+	const hint = defaultVal
+		? `${c.dim} (${c.green}Y${c.reset}${c.dim}/n)${c.reset}`
+		: `${c.dim} (y/${c.green}N${c.reset}${c.dim})${c.reset}`
+	const prefix = `  ${c.cyan}?${c.reset} ${c.bold}${label}${c.reset}${hint}${c.dim} ›${c.reset} `
+
+	const raw = await ask(rl, prefix)
+	const value = raw.trim().toLowerCase()
+	if (!value) return defaultVal
+	return value === "y" || value === "yes" || value === "true"
+}
+
+async function promptNumber(
+	rl: readline.Interface,
+	label: string,
+	defaultVal: number,
+	min: number,
+	max: number,
+): Promise<number> {
+	const prefix = `  ${c.cyan}?${c.reset} ${c.bold}${label}${c.reset}${c.dim} (${defaultVal}) [${min}–${max}] ›${c.reset} `
+
+	while (true) {
+		const raw = await ask(rl, prefix)
+		const value = raw.trim()
+		if (!value) return defaultVal
+		const n = Number.parseInt(value, 10)
+		if (!Number.isNaN(n) && n >= min && n <= max) return n
+		console.log(`    ${c.yellow}Enter a number between ${min} and ${max}.${c.reset}`)
+	}
+}
+
+// ── Banner ──
+
+function printBanner(): void {
+	console.log()
+	console.log(`  ${c.bgCyan}${c.black}${c.bold}                              ${c.reset}`)
+	console.log(`  ${c.bgCyan}${c.black}${c.bold}    ◆  Cortex AI — Onboard    ${c.reset}`)
+	console.log(`  ${c.bgCyan}${c.black}${c.bold}                              ${c.reset}`)
+	console.log()
+}
+
+function printSection(title: string): void {
+	console.log()
+	console.log(`  ${c.magenta}${c.bold}── ${title} ${"─".repeat(Math.max(0, 40 - title.length))}${c.reset}`)
+	console.log()
+}
+
+function printSummaryRow(label: string, value: string, sensitive = false): void {
+	const display = sensitive ? mask(value) : value
+	console.log(`  ${c.dim}│${c.reset}  ${c.bold}${label.padEnd(18)}${c.reset} ${c.cyan}${display}${c.reset}`)
+}
+
+function printSuccess(msg: string): void {
+	console.log()
+	console.log(`  ${c.bgGreen}${c.black}${c.bold} ✓ ${c.reset} ${c.green}${msg}${c.reset}`)
+	console.log()
+}
+
+// ── Config output ──
+
+type WizardResult = {
+	apiKey: string
+	tenantId: string
+	subTenantId: string
+	ignoreTerm: string
+	autoRecall?: boolean
+	autoCapture?: boolean
+	maxRecallResults?: number
+	recallMode?: "fast" | "thinking"
+	graphContext?: boolean
+	debug?: boolean
+}
+
+function buildConfigJson(result: WizardResult): string {
+	const obj: Record<string, unknown> = {}
+
+	if (result.apiKey && !result.apiKey.startsWith("$")) {
+		obj.apiKey = result.apiKey
+	}
+	if (result.tenantId && !result.tenantId.startsWith("$")) {
+		obj.tenantId = result.tenantId
+	}
+	if (result.subTenantId !== "cortex-openclaw-plugin") {
+		obj.subTenantId = result.subTenantId
+	}
+	if (result.ignoreTerm !== "cortex-ignore") {
+		obj.ignoreTerm = result.ignoreTerm
+	}
+	if (result.autoRecall !== undefined && result.autoRecall !== true) {
+		obj.autoRecall = result.autoRecall
+	}
+	if (result.autoCapture !== undefined && result.autoCapture !== true) {
+		obj.autoCapture = result.autoCapture
+	}
+	if (result.maxRecallResults !== undefined && result.maxRecallResults !== 10) {
+		obj.maxRecallResults = result.maxRecallResults
+	}
+	if (result.recallMode !== undefined && result.recallMode !== "fast") {
+		obj.recallMode = result.recallMode
+	}
+	if (result.graphContext !== undefined && result.graphContext !== true) {
+		obj.graphContext = result.graphContext
+	}
+	if (result.debug !== undefined && result.debug !== false) {
+		obj.debug = result.debug
+	}
+
+	return JSON.stringify(obj, null, 2)
+}
+
+function buildEnvLines(result: WizardResult): string[] {
+	const lines: string[] = []
+	if (result.apiKey && !result.apiKey.startsWith("$")) {
+		lines.push(`CORTEX_OPENCLAW_API_KEY=${result.apiKey}`)
+	}
+	if (result.tenantId && !result.tenantId.startsWith("$")) {
+		lines.push(`CORTEX_OPENCLAW_TENANT_ID=${result.tenantId}`)
+	}
+	return lines
+}
+
+// ── Wizards ──
+
+async function runBasicWizard(cfg: CortexPluginConfig): Promise<void> {
+	const rl = createRl()
+
+	try {
+		printBanner()
+		console.log(`  ${c.dim}Configure the essential settings for Cortex AI.${c.reset}`)
+		console.log(`  ${c.dim}Press Enter to accept defaults shown in parentheses.${c.reset}`)
+
+		printSection("Credentials")
+
+		const apiKey = await promptText(rl, "API Key", {
+			required: true,
+			secret: true,
+		})
+
+		const tenantId = await promptText(rl, "Tenant ID", {
+			required: true,
+		})
+
+		printSection("Customisation")
+
+		const subTenantId = await promptText(rl, "Sub-Tenant ID", {
+			default: cfg.subTenantId,
+		})
+
+		const ignoreTerm = await promptText(rl, "Ignore Term", {
+			default: cfg.ignoreTerm,
+		})
+
+		const result: WizardResult = { apiKey, tenantId, subTenantId, ignoreTerm }
+
+		// ── Summary ──
+
+		printSection("Summary")
+
+		console.log(`  ${c.dim}┌${"─".repeat(50)}${c.reset}`)
+		printSummaryRow("API Key", apiKey, true)
+		printSummaryRow("Tenant ID", tenantId)
+		printSummaryRow("Sub-Tenant ID", subTenantId)
+		printSummaryRow("Ignore Term", ignoreTerm)
+		console.log(`  ${c.dim}└${"─".repeat(50)}${c.reset}`)
+
+		// ── Output config ──
+
+		const envLines = buildEnvLines(result)
+		if (envLines.length > 0) {
+			console.log()
+			console.log(`  ${c.yellow}${c.bold}Add to your .env file:${c.reset}`)
+			console.log()
+			for (const line of envLines) {
+				console.log(`    ${c.green}${line}${c.reset}`)
+			}
+		}
+
+		const json = buildConfigJson(result)
+		if (json !== "{}") {
+			console.log()
+			console.log(`  ${c.yellow}${c.bold}Plugin config (openclaw.plugin.json / settings):${c.reset}`)
+			console.log()
+			for (const line of json.split("\n")) {
+				console.log(`    ${c.cyan}${line}${c.reset}`)
+			}
+		}
+
+		printSuccess("Onboarding complete! Run `cortex onboard --advanced` to fine-tune all options.")
+	} finally {
+		rl.close()
+	}
+}
+
+async function runAdvancedWizard(cfg: CortexPluginConfig): Promise<void> {
+	const rl = createRl()
+
+	try {
+		printBanner()
+		console.log(`  ${c.dim}Full configuration wizard — customise every option.${c.reset}`)
+		console.log(`  ${c.dim}Press Enter to accept defaults shown in parentheses.${c.reset}`)
+
+		printSection("Credentials")
+
+		const apiKey = await promptText(rl, "API Key", {
+			required: true,
+			secret: true,
+		})
+
+		const tenantId = await promptText(rl, "Tenant ID", {
+			required: true,
+		})
+
+		const subTenantId = await promptText(rl, "Sub-Tenant ID", {
+			default: cfg.subTenantId,
+		})
+
+		printSection("Behaviour")
+
+		const autoRecall = await promptBool(rl, "Enable Auto-Recall?", cfg.autoRecall)
+		const autoCapture = await promptBool(rl, "Enable Auto-Capture?", cfg.autoCapture)
+		const ignoreTerm = await promptText(rl, "Ignore Term", {
+			default: cfg.ignoreTerm,
+		})
+
+		printSection("Recall Settings")
+
+		const maxRecallResults = await promptNumber(
+			rl, "Max Recall Results", cfg.maxRecallResults, 1, 50,
+		)
+		const recallMode = await promptChoice(
+			rl, "Recall Mode", ["fast", "thinking"], cfg.recallMode,
+		) as "fast" | "thinking"
+		const graphContext = await promptBool(rl, "Enable Graph Context?", cfg.graphContext)
+
+		printSection("Debug")
+
+		const debug = await promptBool(rl, "Enable Debug Logging?", cfg.debug)
+
+		const result: WizardResult = {
+			apiKey,
+			tenantId,
+			subTenantId,
+			ignoreTerm,
+			autoRecall,
+			autoCapture,
+			maxRecallResults,
+			recallMode,
+			graphContext,
+			debug,
+		}
+
+		// ── Summary ──
+
+		printSection("Summary")
+
+		console.log(`  ${c.dim}┌${"─".repeat(50)}${c.reset}`)
+		printSummaryRow("API Key", apiKey, true)
+		printSummaryRow("Tenant ID", tenantId)
+		printSummaryRow("Sub-Tenant ID", subTenantId)
+		printSummaryRow("Auto-Recall", String(autoRecall))
+		printSummaryRow("Auto-Capture", String(autoCapture))
+		printSummaryRow("Ignore Term", ignoreTerm)
+		printSummaryRow("Max Results", String(maxRecallResults))
+		printSummaryRow("Recall Mode", recallMode)
+		printSummaryRow("Graph Context", String(graphContext))
+		printSummaryRow("Debug", String(debug))
+		console.log(`  ${c.dim}└${"─".repeat(50)}${c.reset}`)
+
+		// ── Output config ──
+
+		const envLines = buildEnvLines(result)
+		if (envLines.length > 0) {
+			console.log()
+			console.log(`  ${c.yellow}${c.bold}Add to your .env file:${c.reset}`)
+			console.log()
+			for (const line of envLines) {
+				console.log(`    ${c.green}${line}${c.reset}`)
+			}
+		}
+
+		const json = buildConfigJson(result)
+		if (json !== "{}") {
+			console.log()
+			console.log(`  ${c.yellow}${c.bold}Plugin config (openclaw.plugin.json / settings):${c.reset}`)
+			console.log()
+			for (const line of json.split("\n")) {
+				console.log(`    ${c.cyan}${line}${c.reset}`)
+			}
+		}
+
+		printSuccess("Onboarding complete! All options configured.")
+	} finally {
+		rl.close()
+	}
+}
+
+// ── Registration (CLI + Slash) ──
+
+export function registerOnboardingCli(
+	cfg: CortexPluginConfig,
+): (root: any) => void {
+	return (root: any) => {
+		root
+			.command("onboard")
+			.description("Interactive Cortex AI onboarding wizard")
+			.option("--advanced", "Configure all options (credentials, behaviour, recall, debug)")
+			.action(async (opts: { advanced?: boolean }) => {
+				if (opts.advanced) {
+					await runAdvancedWizard(cfg)
+				} else {
+					await runBasicWizard(cfg)
+				}
+			})
+	}
+}
+
+export function registerOnboardingSlashCommands(
+	api: OpenClawPluginApi,
+	client: CortexClient,
+	cfg: CortexPluginConfig,
+): void {
+	api.registerCommand({
+		name: "cortex-onboard",
+		description: "Show Cortex plugin config status (run `cortex onboard` in CLI for interactive wizard)",
+		acceptsArgs: false,
+		requireAuth: false,
+		handler: async () => {
+			try {
+				const lines: string[] = [
+					"=== Cortex AI — Current Config ===",
+					"",
+					`  API Key:       ${cfg.apiKey ? `${mask(cfg.apiKey)} ✓` : "NOT SET ✗"}`,
+					`  Tenant ID:     ${cfg.tenantId ? `${mask(cfg.tenantId, 8)} ✓` : "NOT SET ✗"}`,
+					`  Sub-Tenant:    ${client.getSubTenantId()}`,
+					`  Ignore Term:   ${cfg.ignoreTerm}`,
+					`  Auto-Recall:   ${cfg.autoRecall}`,
+					`  Auto-Capture:  ${cfg.autoCapture}`,
+					`  Recall Mode:   ${cfg.recallMode}`,
+					`  Graph Context: ${cfg.graphContext}`,
+					`  Max Results:   ${cfg.maxRecallResults}`,
+					`  Debug:         ${cfg.debug}`,
+					"",
+					"Tip: Run `cortex onboard` in the CLI for an interactive configuration wizard,",
+					"     or `cortex onboard --advanced` for all options.",
+				]
+				return { text: lines.join("\n") }
+			} catch (err) {
+				log.error("/cortex-onboard", err)
+				return { text: "Failed to show status. Check logs." }
+			}
+		},
+	})
+}

package/commands/slash.ts

@@ -2,7 +2,7 @@ import type { OpenClawPluginApi } from "openclaw/plugin-sdk"
 import type { CortexClient } from "../client.ts"
 import type { CortexPluginConfig } from "../config.ts"
 import { log } from "../log.ts"
-import { toSourceId } from "../session.ts"
+import { toToolSourceId } from "../session.ts"
 
 function preview(text: string, max = 80): string {
 	return text.length > max ? `${text.slice(0, max)}…` : text
@@ -12,7 +12,7 @@ export function registerSlashCommands(
 	api: OpenClawPluginApi,
 	client: CortexClient,
 	cfg: CortexPluginConfig,
-	getSessionKey: () => string | undefined,
+	getSessionId: () => string | undefined,
 ): void {
 	api.registerCommand({
 		name: "cortex-remember",
@@ -24,8 +24,8 @@ export function registerSlashCommands(
 			if (!text) return { text: "Usage: /cortex-remember <text to store>" }
 
 			try {
-				const sk = getSessionKey()
-				const sourceId = sk ? toSourceId(sk) : undefined
+				const sid = getSessionId()
+				const sourceId = sid ? toToolSourceId(sid) : undefined
 				await client.ingestText(text, { sourceId, title: "Manual Memory", infer: true })
 				return { text: `Saved: "${preview(text, 60)}"` }
 			} catch (err) {