ocuclaw 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# OcuClaw
+
+OcuClaw is an OpenClaw plugin for Even G2 smart glasses.
+
+## Install
+
+```bash
+openclaw plugins install ocuclaw
+openclaw plugins enable ocuclaw
+```
+
+## Configure
+
+Set the relay token before starting or restarting the OpenClaw gateway:
+
+```bash
+openclaw config set plugins.entries.ocuclaw.config.relayToken "<relay-token>"
+```
+
+Optional settings live under `plugins.entries.ocuclaw.config.*`.
+
+## Notes
+
+- Plugin id: `ocuclaw`
+- The WebUI is a separate artifact and is not bundled into this npm package.

package/dist/config/runtime-config.js

@@ -0,0 +1,165 @@
+import { normalizeEvenAiRoutingMode } from "../even-ai/even-ai-settings-store.js";
+
+function isObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value);
+}
+
+function parseBool(value, defaultValue) {
+  if (value === undefined || value === null || value === "") return defaultValue;
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number") return value !== 0;
+  return String(value).toLowerCase() !== "false";
+}
+
+function parseIntOrDefault(value, defaultValue) {
+  if (value === undefined || value === null || value === "") return defaultValue;
+  const parsed = parseInt(String(value), 10);
+  if (Number.isNaN(parsed)) return defaultValue;
+  return parsed;
+}
+
+function parseEvenAiRoutingMode(value) {
+  return normalizeEvenAiRoutingMode(value);
+}
+
+function parseEvenAiDedicatedSessionKey(value) {
+  const trimmed = pickString(value);
+  if (!trimmed) {
+    return "ocuclaw:even-ai";
+  }
+  return trimmed.toLowerCase().startsWith("ocuclaw:")
+    ? trimmed
+    : "ocuclaw:even-ai";
+}
+
+function parseJsonOrUndefined(value, envName) {
+  if (value === undefined || value === null || value === "") return undefined;
+  try {
+    return JSON.parse(String(value));
+  } catch (err) {
+    throw new Error(`${envName} must be valid JSON: ${err.message}`);
+  }
+}
+
+function pickString(...values) {
+  for (const value of values) {
+    if (typeof value !== "string") continue;
+    const trimmed = value.trim();
+    if (trimmed) return trimmed;
+  }
+  return "";
+}
+
+function pickValue(...values) {
+  for (const value of values) {
+    if (value !== undefined && value !== null && value !== "") {
+      return value;
+    }
+  }
+  return undefined;
+}
+
+function resolveGatewayUrlFromOpenClawConfig(openclawConfig) {
+  if (!isObject(openclawConfig) || !isObject(openclawConfig.gateway)) {
+    return "";
+  }
+  const gateway = openclawConfig.gateway;
+  const remoteMode = gateway.mode === "remote";
+  if (remoteMode && isObject(gateway.remote)) {
+    const remoteUrl = pickString(gateway.remote.url);
+    if (remoteUrl) {
+      return remoteUrl;
+    }
+  }
+  const scheme = gateway.tls && gateway.tls.enabled === true ? "wss" : "ws";
+  const port = parseIntOrDefault(gateway.port, 18789);
+  return `${scheme}://127.0.0.1:${port}`;
+}
+
+function resolveGatewayTokenFromOpenClawConfig(openclawConfig) {
+  if (!isObject(openclawConfig) || !isObject(openclawConfig.gateway)) {
+    return "";
+  }
+  const gateway = openclawConfig.gateway;
+  const remoteMode = gateway.mode === "remote";
+  if (remoteMode && isObject(gateway.remote)) {
+    return pickString(gateway.remote.token);
+  }
+  return pickString(
+    isObject(gateway.auth) ? gateway.auth.token : undefined,
+  );
+}
+
+function resolveDebugNoisyPolicies(pluginValue, envValue) {
+  if (pluginValue !== undefined && pluginValue !== null) {
+    return pluginValue;
+  }
+  return parseJsonOrUndefined(envValue, "debugNoisyPolicies");
+}
+
+export function createRuntimeConfig(opts = {}) {
+  const pluginConfig = isObject(opts.pluginConfig) ? opts.pluginConfig : {};
+  const openclawConfig = isObject(opts.openclawConfig) ? opts.openclawConfig : {};
+  const relayToken = pickString(pluginConfig.relayToken);
+  const gatewayUrl = pickString(resolveGatewayUrlFromOpenClawConfig(openclawConfig));
+  const gatewayToken = pickString(resolveGatewayTokenFromOpenClawConfig(openclawConfig));
+
+  if (!relayToken) {
+    throw new Error(
+      "OcuClaw relayToken is required. Set plugins.entries.ocuclaw.config.relayToken.",
+    );
+  }
+  if (!gatewayUrl) {
+    throw new Error(
+      "OcuClaw gatewayUrl is required from api.config.gateway. OpenClaw gateway config is missing or unusable.",
+    );
+  }
+  if (!gatewayToken) {
+    throw new Error(
+      "OcuClaw gatewayToken is required from api.config.gateway. OpenClaw gateway auth token is missing or unusable.",
+    );
+  }
+
+  return {
+    gatewayUrl,
+    gatewayToken,
+    relayToken,
+    wsBind: pickString(pluginConfig.wsBind, "127.0.0.1"),
+    wsPort: parseIntOrDefault(pickValue(pluginConfig.wsPort), 9000),
+    sessionLimit: parseIntOrDefault(pickValue(pluginConfig.sessionLimit), 10),
+    sonioxApiKey: pickString(pluginConfig.sonioxApiKey),
+    debugPayloadMaxBytes: parseIntOrDefault(
+      pickValue(pluginConfig.debugPayloadMaxBytes),
+      2048,
+    ),
+    debugNoisyPolicies: resolveDebugNoisyPolicies(
+      pluginConfig.debugNoisyPolicies,
+      undefined,
+    ),
+    externalDebugToolsEnabled: parseBool(
+      pluginConfig.externalDebugToolsEnabled,
+      false,
+    ),
+    evenAiEnabled: parseBool(pluginConfig.evenAiEnabled, false),
+    evenAiToken: pickString(pluginConfig.evenAiToken),
+    evenAiSystemPrompt: pickString(pluginConfig.evenAiSystemPrompt),
+    evenAiRequestTimeoutMs: parseIntOrDefault(
+      pluginConfig.evenAiRequestTimeoutMs,
+      60000,
+    ),
+    evenAiMaxBodyBytes: parseIntOrDefault(
+      pluginConfig.evenAiMaxBodyBytes,
+      65536,
+    ),
+    evenAiDedupWindowMs: parseIntOrDefault(
+      pluginConfig.evenAiDedupWindowMs,
+      500,
+    ),
+    evenAiRoutingMode: parseEvenAiRoutingMode(pluginConfig.evenAiRoutingMode),
+    evenAiDedicatedSessionKey: parseEvenAiDedicatedSessionKey(
+      pluginConfig.evenAiDedicatedSessionKey,
+    ),
+  };
+}
+
+export default createRuntimeConfig;