suemo 0.1.8 → 0.1.9

package/README.md

@@ -544,7 +544,7 @@ These scenarios intentionally exercise all memory kinds and all relation kinds,
 - **Runtime** — [Bun](https://bun.sh)
 - **Language** — TypeScript (strict, `exactOptionalPropertyTypes`)
 - **Database** — [SurrealDB](https://surrealdb.com) v3.0+ (SurrealKV)
-- **SDK** — [surrealdb.js](https://github.com/surrealdb/surrealdb.js) v2 + `@surrealdb/node`
+- **SDK** — [surrealdb.js](https://github.com/surrealdb/surrealdb.js) v2 + `@mdrv/surreal-node` (fork of `@surrealdb/node`)
 - **CLI** — [crust](https://github.com/chenxin-yan/crust) (`@crustjs/core`)
 - **HTTP / MCP** — [Elysia](https://elysiajs.com) v1.4
 - **Validation** — [Zod](https://zod.dev) v4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "suemo",
-	"version": "0.1.8",
+	"version": "0.1.9",
 	"description": "Persistent semantic memory for AI agents — backed by SurrealDB.",
 	"author": {
 		"name": "Umar Alfarouk",
@@ -51,7 +51,7 @@
 		"@crustjs/style": "^0.0.6",
 		"@logtape/file": "^2.0.4",
 		"@logtape/logtape": "^2.0.4",
-		"@surrealdb/node": "^3.0.3",
+		"@mdrv/surreal-node": "latest",
 		"elysia": "^1.4.28",
 		"surrealdb": "^2.0.3",
 		"zod": "^4.3.6"

package/skills/suemo/SKILL.md

@@ -3,7 +3,7 @@ name: suemo
 description: OpenCode-focused persistent memory workflow for suemo with CLI/MCP parity and versioned references.
 license: GPL-3.0-only
 compatibility: opencode
-version: 0.1.8
+version: 0.1.9
 ---
 
 # suemo skill

package/skills/suemo/references/agents-snippet.md

@@ -1,7 +1,7 @@
 ---
 name: agents-snippet
 description: AGENTS.md snippet optimized for suemo skill discovery and usage.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # AGENTS.md snippet

package/skills/suemo/references/cli-reference.md

@@ -1,7 +1,7 @@
 ---
 name: cli-reference
 description: CLI command reference for suemo v0.0.6 including skill access.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # CLI reference

package/skills/suemo/references/core-workflow.md

@@ -1,7 +1,7 @@
 ---
 name: core-workflow
 description: Canonical suemo operating loop for OpenCode agents.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # Core workflow

package/skills/suemo/references/manual-test-plan.md

@@ -1,7 +1,7 @@
 ---
 name: manual-test-plan
 description: Comprehensive manual test matrix for suemo features and commands.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # Manual test plan

package/skills/suemo/references/mcp-reference.md

@@ -1,7 +1,7 @@
 ---
 name: mcp-reference
 description: MCP tool reference for suemo v0.0.6.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # MCP tools

package/skills/suemo/references/schema-retention-longevity.md

@@ -1,7 +1,7 @@
 ---
 name: schema-retention-longevity
 description: Long-term schema and retention design expectations for suemo.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # Schema + retention longevity

package/skills/suemo/references/sync-local-vps.md

@@ -1,7 +1,7 @@
 ---
 name: sync-local-vps
 description: Two-way sync manual scenario for local and VPS SurrealDB.
-version: 0.1.8
+version: 0.1.9
 ---
 
 # Local ↔ VPS sync scenario

package/src/AGENTS.md

@@ -127,4 +127,4 @@ Load docs once per session unless requirements changed.
 
 ---
 
-_Version: 0.1.8 | Updated: 2026-03-24 | Summary: stricter schema + explicit completion contract_
+_Version: 0.1.9 | Updated: 2026-03-24 | Summary: stricter schema + explicit completion contract_

package/src/db/client.ts

@@ -2,9 +2,9 @@
 // createRemoteEngines() handles ws://, wss://, http://, https:// connections.
 // createNodeEngines() patches in the Node.js WebSocket implementation.
 import type { SurrealTarget } from '@/src/config.ts'
-import { createSurrealEngines, toSurrealConnectionError } from '@/src/db/engines.ts'
 import { getLogger } from '@/src/logger.ts'
-import { Surreal } from 'surrealdb'
+import { createNodeEngines } from '@mdrv/surreal-node'
+import { createRemoteEngines, Surreal } from 'surrealdb'
 
 const log = getLogger(['suemo', 'db', 'client'])
 
@@ -19,33 +19,30 @@ export async function connect(target: SurrealTarget): Promise<Surreal> {
 		db: target.database,
 	})
 
-	try {
-		const engines = await createSurrealEngines({
-			url: target.url,
-			context: 'db:connect',
-		})
-
-		// v2 SDK: engines are registered at construction time, not at connect.
-		const db = new Surreal({ engines })
-
-		// v2 SDK: namespace, database, and authentication can all be passed inline
-		// to connect(). The `authentication` callback is invoked on connect and on
-		// any automatic reconnection/token-refresh cycle.
-		await db.connect(target.url, {
-			namespace: target.namespace,
-			database: target.database,
-			authentication: () => ({
-				username: target.auth.user,
-				password: target.auth.pass,
-			}),
-		})
-
-		_db = db
-		log.debug('Connected')
-		return db
-	} catch (error) {
-		throw toSurrealConnectionError(error, 'db:connect', target.url)
-	}
+	// v2 SDK: engines are registered at construction time, not at connect.
+	// Both remote (ws/wss/http) and Node.js engines are needed for Bun.
+	const db = new Surreal({
+		engines: {
+			...createRemoteEngines(),
+			...createNodeEngines(),
+		},
+	})
+
+	// v2 SDK: namespace, database, and authentication can all be passed inline
+	// to connect(). The `authentication` callback is invoked on connect and on
+	// any automatic reconnection/token-refresh cycle.
+	await db.connect(target.url, {
+		namespace: target.namespace,
+		database: target.database,
+		authentication: () => ({
+			username: target.auth.user,
+			password: target.auth.pass,
+		}),
+	})
+
+	_db = db
+	log.debug('Connected')
+	return db
 }
 
 export function getDb(): Surreal {

package/src/opencode/plugin.ts

@@ -1,5 +1,5 @@
 /**
- * suemo OpenCode plugin (v0.1.8)
+ * suemo OpenCode plugin (v0.1.9)
  *
  * Purpose:
  * - Inject strict, always-on suemo memory workflow instructions.
@@ -12,7 +12,7 @@
 import type { Plugin } from '@opencode-ai/plugin'
 
 const SERVICE = 'suemo-plugin'
-const PLUGIN_VERSION = '0.1.8'
+const PLUGIN_VERSION = '0.1.9'
 const PROTOCOL_MARKER = 'Suemo Persistent Memory — Protocol'
 
 interface SystemTransformOutput {
@@ -38,7 +38,7 @@ interface PluginLogExtra {
 	[key: string]: unknown
 }
 
-const MEMORY_INSTRUCTIONS = `## Suemo Persistent Memory — Protocol (v0.1.8)
+const MEMORY_INSTRUCTIONS = `## Suemo Persistent Memory — Protocol (v0.1.9)
 
 You have access to suemo persistent memory tools (commonly prefixed as \`suemo_*\`).
 

package/src/sync.ts

@@ -1,9 +1,9 @@
 import type { SurrealTarget } from '@/src/config.ts'
-import { createSurrealEngines, toSurrealConnectionError } from '@/src/db/engines.ts'
 import { getLogger } from '@/src/logger.ts'
 import type { SyncResult } from '@/src/types.ts'
+import { createNodeEngines } from '@surrealdb/node'
 import { createHash } from 'node:crypto'
-import { Surreal } from 'surrealdb'
+import { createRemoteEngines, Surreal } from 'surrealdb'
 
 const log = getLogger(['suemo', 'sync'])
 
@@ -32,24 +32,21 @@ function remoteKey(target: SurrealTarget): string {
 }
 
 async function makeRemoteDb(target: SurrealTarget): Promise<Surreal> {
-	try {
-		const engines = await createSurrealEngines({
-			url: target.url,
-			context: 'sync:remote-connect',
-		})
-		const db = new Surreal({ engines })
-		await db.connect(target.url, {
-			namespace: target.namespace,
-			database: target.database,
-			authentication: () => ({
-				username: target.auth.user,
-				password: target.auth.pass,
-			}),
-		})
-		return db
-	} catch (error) {
-		throw toSurrealConnectionError(error, 'sync:remote-connect', target.url)
-	}
+	const db = new Surreal({
+		engines: {
+			...createRemoteEngines(),
+			...createNodeEngines(),
+		},
+	})
+	await db.connect(target.url, {
+		namespace: target.namespace,
+		database: target.database,
+		authentication: () => ({
+			username: target.auth.user,
+			password: target.auth.pass,
+		}),
+	})
+	return db
 }
 
 async function pushMemoryBatch(

package/tsconfig.json

@@ -24,5 +24,5 @@
 			"@/*": ["./*"]
 		}
 	},
-	"include": ["src/**/*", "suemo.config.ts"]
+	"include": ["src/**/*"]
 }

package/src/db/engines.ts

@@ -1,113 +0,0 @@
-import { getLogger } from '@/src/logger.ts'
-import { createRemoteEngines } from 'surrealdb'
-
-type SurrealEngines = ReturnType<typeof createRemoteEngines>
-
-const log = getLogger(['suemo', 'db', 'engines'])
-
-export interface CreateSurrealEnginesOptions {
-	url: string
-	context: string
-	loadNodeEngines?: () => Promise<SurrealEngines>
-}
-
-const REMOTE_SCHEME_RE = /^(https?|wss?):\/\//i
-
-export function isRemoteSurrealUrl(url: string): boolean {
-	return REMOTE_SCHEME_RE.test(url)
-}
-
-function isLikelyArm64NativeIssue(message: string): boolean {
-	return message.includes('_ZTVSt12bad_weak_ptr')
-		|| message.includes('surrealdb-node.linux-arm64-gnu.node')
-		|| message.includes('surrealdb-node.linux-arm64-musl.node')
-		|| message.includes('Cannot find native binding')
-		|| message.includes('@surrealdb/node')
-}
-
-function buildArm64NativeBuildGuidance(): string {
-	return [
-		'@surrealdb/node native binding failed on linux arm64.',
-		'Automatic install of @surrealdb/node-linux-* is not attempted by suemo because npm package availability/versioning is inconsistent across arm64 variants.',
-		'Recommended workaround: build native binding locally and replace the bundled binary:',
-		'  git clone https://github.com/surrealdb/surrealdb.js',
-		'  cd surrealdb.js/packages/node',
-		'  bun add -g @napi-rs/cli',
-		'  bunx napi build --platform --release',
-		'  cp surrealdb-node.linux-arm64-gnu.node ~/.bun/install/global/node_modules/@surrealdb/node/dist/',
-		'If your environment is musl-based, replace the destination file accordingly.',
-		'Also consider filing/upvoting an upstream issue for arm64 portability.',
-	].join('\n')
-}
-
-function wrapArm64NativeError(error: unknown, context: string, url: string): Error {
-	const base = error instanceof Error ? error.message : String(error)
-	const details = [
-		`SurrealDB native engine initialization failed (${context}) for target: ${url}`,
-		base,
-	]
-
-	if (process.platform === 'linux' && process.arch === 'arm64') {
-		details.push('', buildArm64NativeBuildGuidance())
-	}
-
-	return new Error(details.join('\n'))
-}
-
-async function defaultLoadNodeEngines(): Promise<SurrealEngines> {
-	const mod = await import('@surrealdb/node')
-	if (typeof mod.createNodeEngines !== 'function') {
-		throw new Error('@surrealdb/node loaded without createNodeEngines export')
-	}
-	const engines = mod.createNodeEngines()
-	if (!engines || typeof engines !== 'object') {
-		throw new Error('@surrealdb/node createNodeEngines() returned invalid value')
-	}
-	return engines as SurrealEngines
-}
-
-export async function createSurrealEngines(options: CreateSurrealEnginesOptions): Promise<SurrealEngines> {
-	const remoteEngines = createRemoteEngines() as SurrealEngines
-	const loadNodeEngines = options.loadNodeEngines ?? defaultLoadNodeEngines
-
-	try {
-		const nodeEngines = await loadNodeEngines()
-		log.debug('Loaded @surrealdb/node engines', {
-			context: options.context,
-			url: options.url,
-			nodeEngineCount: Object.keys(nodeEngines).length,
-		})
-		return { ...remoteEngines, ...nodeEngines }
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error)
-		const remoteUrl = isRemoteSurrealUrl(options.url)
-
-		log.warning('Unable to initialize @surrealdb/node engines', {
-			context: options.context,
-			url: options.url,
-			platform: process.platform,
-			arch: process.arch,
-			remoteUrl,
-			error: message,
-		})
-
-		if (!remoteUrl || isLikelyArm64NativeIssue(message)) {
-			throw wrapArm64NativeError(error, options.context, options.url)
-		}
-
-		log.info('Falling back to remote-only engines', {
-			context: options.context,
-			url: options.url,
-		})
-		return remoteEngines
-	}
-}
-
-export function toSurrealConnectionError(error: unknown, context: string, url: string): Error {
-	const message = error instanceof Error ? error.message : String(error)
-	if (isLikelyArm64NativeIssue(message)) {
-		return wrapArm64NativeError(error, context, url)
-	}
-	if (error instanceof Error) return error
-	return new Error(String(error))
-}