@sonzai-labs/openclaw-context 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sonzai Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,220 @@
+# @sonzai-labs/openclaw-context
+
+OpenClaw ContextEngine plugin for the [Sonzai Mind Layer](https://sonz.ai). Gives OpenClaw agents hierarchical memory, personality evolution, mood tracking, relationship modeling, and automatic fact extraction — powered by the Sonzai API.
+
+## Quick Start
+
+### Interactive Setup (Recommended)
+
+```bash
+# Install the plugin
+openclaw plugins install @sonzai-labs/openclaw-context
+
+# Run guided setup — validates your key, provisions agent, writes openclaw.json
+npx @sonzai-labs/openclaw-context setup
+```
+
+The setup wizard will:
+1. Ask for your Sonzai API key (or detect `SONZAI_API_KEY` from env)
+2. Ask if you have an existing agent ID, or create one for you
+3. Write the plugin config to your `openclaw.json`
+4. Show you the env var to add to your shell profile
+
+That's it — restart OpenClaw and your agent has persistent memory.
+
+### Manual Setup
+
+```bash
+# 1. Install
+openclaw plugins install @sonzai-labs/openclaw-context
+
+# 2. Set your API key
+export SONZAI_API_KEY="sk-your-api-key"
+
+# 3. Optionally set a specific agent (otherwise auto-provisioned)
+export SONZAI_AGENT_ID="your-agent-uuid"
+```
+
+Add to your `openclaw.json`:
+
+```json5
+{
+  "plugins": {
+    "slots": {
+      "contextEngine": "sonzai"
+    },
+    "entries": {
+      "sonzai": {
+        "enabled": true,
+        "agentId": "your-agent-uuid"  // optional
+      }
+    }
+  }
+}
+```
+
+## B2B Integration (Programmatic Setup)
+
+For platforms deploying OpenClaw at scale, use the programmatic setup API
+in your provisioning scripts:
+
+```typescript
+import { setup } from "@sonzai-labs/openclaw-context";
+
+// One-liner: validates key, provisions agent, writes openclaw.json
+const result = await setup({
+  apiKey: "sk-project-scoped-key",
+  agentName: "customer-support-bot",   // stable name → deterministic agent ID
+  configPath: "/path/to/openclaw.json",
+});
+
+console.log(result.agentId);   // "a1b2c3d4-..."
+console.log(result.written);   // true — config file updated
+```
+
+### B2B Provisioning Script Example
+
+```typescript
+import { setup } from "@sonzai-labs/openclaw-context";
+
+// Called once per tenant during onboarding
+async function provisionOpenClawForTenant(tenantName: string) {
+  const result = await setup({
+    apiKey: process.env.SONZAI_PROJECT_KEY!,
+    agentName: `${tenantName}-assistant`,  // unique per tenant
+    configPath: `/etc/openclaw/${tenantName}/openclaw.json`,
+  });
+
+  // Store the agent ID in your DB for reference
+  await db.tenants.update(tenantName, { sonzaiAgentId: result.agentId });
+}
+```
+
+### Kubernetes / Docker Deployments
+
+The agent ID is deterministic: `SHA1(tenantID + agentName)`. As long as your
+config has the same API key + agent name (or explicit agent ID), pods can
+restart, scale, or be replaced without creating duplicate agents.
+
+```yaml
+# Example: K8s deployment env vars
+env:
+  - name: SONZAI_API_KEY
+    valueFrom:
+      secretKeyRef:
+        name: sonzai-secrets
+        key: api-key
+  - name: SONZAI_AGENT_ID
+    value: "a1b2c3d4-e5f6-..."  # from provisioning step
+```
+
+### Config-Only (No Env Vars)
+
+If you prefer not to use env vars, pass everything through `openclaw.json`:
+
+```typescript
+const result = await setup({
+  apiKey: "sk-...",
+  agentName: "my-bot",
+  writeConfig: true,
+  configPath: "./openclaw.json",
+});
+// API key is NOT written to the file (security) — only agentId is persisted.
+// The key must be set via SONZAI_API_KEY at runtime.
+```
+
+## How It Works
+
+The plugin replaces OpenClaw's default Markdown-file memory with Sonzai's Mind Layer:
+
+| OpenClaw Hook | What Happens |
+|---------------|-------------|
+| **bootstrap** | Starts a Sonzai session; provisions agent if needed |
+| **ingest** | No-op (processing deferred to afterTurn) |
+| **assemble** | Fetches memory, mood, personality, relationships, goals, interests, and habits in parallel; injects as `systemPromptAddition` |
+| **compact** | Triggers Sonzai's consolidation pipeline (replaces OpenClaw's summarization) |
+| **afterTurn** | Sends conversation to Sonzai for fact extraction |
+| **dispose** | Ends all active sessions cleanly |
+
+### Context Injection
+
+Before each LLM call, the plugin injects a `<sonzai-context>` block into the system prompt containing:
+
+- Agent personality profile and Big5 traits
+- Current mood state
+- Relationship data with the current user
+- Semantically relevant memories (searched by last user message)
+- Active goals
+- User interests
+- Behavioral habits
+
+If any API call fails, it's silently skipped — the plugin never blocks OpenClaw.
+
+### User Identity
+
+The plugin automatically extracts user identity from OpenClaw session keys:
+
+| Session Type | Example Key | Resolved userId |
+|-------------|------------|-----------------|
+| CLI (1:1) | `agent:abc:mainKey` | `"owner"` (default) |
+| Telegram DM | `agent:abc:telegram:direct:123` | `"123"` |
+| WhatsApp DM | `agent:abc:whatsapp:direct:+1555...` | `"+1555..."` |
+| Discord group | `agent:abc:discord:group:guild789` | `"guild789"` |
+
+### Agent ID Stability
+
+The Sonzai backend derives agent IDs deterministically:
+
+```
+agentId = SHA1(namespace, tenantID + "/" + lowercase(agentName))
+```
+
+Same API key + same name = same agent UUID, always. Safe across:
+- Pod restarts and replacements
+- Container recreation
+- Multiple replicas (they all resolve to the same agent)
+- `openclaw plugins install` re-runs
+
+To get **separate** agents under one API key, use different `agentName` values.
+
+## Full Configuration Reference
+
+| Setting | Env Var | Default | Description |
+|---------|---------|---------|-------------|
+| `apiKey` | `SONZAI_API_KEY` | *required* | Sonzai API key |
+| `agentId` | `SONZAI_AGENT_ID` | auto-provision | Pre-provisioned agent UUID |
+| `baseUrl` | `SONZAI_BASE_URL` | `https://api.sonz.ai` | API base URL |
+| `agentName` | `SONZAI_AGENT_NAME` | `openclaw-agent` | Name for auto-provisioned agents |
+| `defaultUserId` | — | `owner` | Default userId for CLI (1:1) sessions |
+| `contextTokenBudget` | — | `2000` | Max tokens for context injection |
+| `disable.mood` | — | `false` | Skip mood context |
+| `disable.personality` | — | `false` | Skip personality context |
+| `disable.relationships` | — | `false` | Skip relationship context |
+| `disable.memory` | — | `false` | Skip memory search |
+| `disable.goals` | — | `false` | Skip goals context |
+| `disable.interests` | — | `false` | Skip interests context |
+| `disable.habits` | — | `false` | Skip habits context |
+
+## Programmatic Engine Usage
+
+The engine can also be used directly outside OpenClaw:
+
+```typescript
+import { Sonzai } from "@sonzai-labs/agents";
+import { SonzaiContextEngine, resolveConfig } from "@sonzai-labs/openclaw-context";
+
+const client = new Sonzai({ apiKey: "sk-..." });
+const config = resolveConfig({ apiKey: "sk-...", agentId: "agent-123" });
+const engine = new SonzaiContextEngine(client, config);
+
+await engine.bootstrap({ sessionId: "my-session" });
+const { systemPromptAddition } = await engine.assemble({
+  sessionId: "my-session",
+  messages: [{ role: "user", content: "Hello!" }],
+  tokenBudget: 4000,
+});
+```
+
+## License
+
+MIT

package/dist/cli.cjs

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+'use strict';
+
+var agents = require('@sonzai-labs/agents');
+var readline = require('readline');
+var fs = require('fs');
+var path = require('path');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var readline__namespace = /*#__PURE__*/_interopNamespace(readline);
+var fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+var path__namespace = /*#__PURE__*/_interopNamespace(path);
+
+async function setup(options) {
+  const baseUrl = options.baseUrl || "https://api.sonz.ai";
+  const agentName = options.agentName || "openclaw-agent";
+  const configPath = options.configPath || "./openclaw.json";
+  const client = new agents.Sonzai({ apiKey: options.apiKey, baseUrl });
+  let agentId;
+  if (options.agentId) {
+    const agent = await client.agents.get(options.agentId);
+    agentId = agent.agent_id;
+  } else {
+    const agent = await client.agents.create({ name: agentName });
+    agentId = agent.agent_id;
+  }
+  const pluginConfig = buildOpenClawConfig(options.apiKey, agentId);
+  let written = false;
+  return {
+    agentId,
+    agentName,
+    config: pluginConfig,
+    configPath: written ? path__namespace.resolve(configPath) : void 0,
+    written
+  };
+}
+async function interactiveSetup() {
+  const rl = readline__namespace.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const ask = (question) => new Promise((resolve2) => rl.question(question, resolve2));
+  console.log("\n\u{1F99E} Sonzai Mind Layer \u2014 OpenClaw Plugin Setup\n");
+  try {
+    const envKey = process.env.SONZAI_API_KEY;
+    let apiKey;
+    if (envKey) {
+      const useEnv = await ask(
+        `Found SONZAI_API_KEY in environment (${envKey.slice(0, 8)}...). Use it? [Y/n] `
+      );
+      apiKey = useEnv.toLowerCase() === "n" ? await ask("Enter your Sonzai API key: ") : envKey;
+    } else {
+      apiKey = await ask("Enter your Sonzai API key (from https://sonz.ai/settings/api): ");
+    }
+    if (!apiKey.trim()) {
+      console.log("No API key provided. Aborting.");
+      return;
+    }
+    const hasAgent = await ask("Do you have an existing Sonzai agent ID? [y/N] ");
+    let agentId;
+    let agentName = "openclaw-agent";
+    if (hasAgent.toLowerCase() === "y") {
+      agentId = await ask("Enter agent ID: ");
+    } else {
+      const customName = await ask(
+        `Agent name for auto-provisioning [openclaw-agent]: `
+      );
+      if (customName.trim()) agentName = customName.trim();
+    }
+    console.log("\nValidating API key and provisioning agent...");
+    const result = await setup({
+      apiKey: apiKey.trim(),
+      agentId: agentId?.trim() || void 0,
+      agentName,
+      writeConfig: false
+    });
+    console.log(`Agent ready: ${result.agentId}`);
+    const configPath = await ask("Path to openclaw.json [./openclaw.json]: ");
+    const resolvedPath = configPath.trim() || "./openclaw.json";
+    mergeOpenClawConfig(resolvedPath, result.config);
+    console.log(`
+Config written to ${path__namespace.resolve(resolvedPath)}`);
+    console.log("\n--- Setup Complete ---\n");
+    console.log("Set your API key as an environment variable (recommended):\n");
+    console.log(`  export SONZAI_API_KEY="${apiKey.trim()}"
+`);
+    console.log("Or add it to your shell profile (~/.bashrc, ~/.zshrc).\n");
+    console.log(
+      "The agent ID is saved in openclaw.json \u2014 no need to set SONZAI_AGENT_ID.\n"
+    );
+  } finally {
+    rl.close();
+  }
+}
+function buildOpenClawConfig(_apiKey, agentId) {
+  return {
+    plugins: {
+      slots: {
+        contextEngine: "sonzai"
+      },
+      entries: {
+        sonzai: {
+          enabled: true,
+          agentId
+          // apiKey is intentionally NOT written to the config file —
+          // it should be set via SONZAI_API_KEY env var for security.
+        }
+      }
+    }
+  };
+}
+function mergeOpenClawConfig(configPath, pluginConfig) {
+  let existing = {};
+  const resolvedPath = path__namespace.resolve(configPath);
+  if (fs__namespace.existsSync(resolvedPath)) {
+    try {
+      const raw = fs__namespace.readFileSync(resolvedPath, "utf-8");
+      existing = JSON.parse(raw);
+    } catch {
+    }
+  }
+  const merged = { ...existing };
+  const existingPlugins = merged.plugins || {};
+  const newPlugins = pluginConfig.plugins;
+  const existingSlots = existingPlugins.slots || {};
+  const newSlots = newPlugins.slots || {};
+  const existingEntries = existingPlugins.entries || {};
+  const newEntries = newPlugins.entries || {};
+  merged.plugins = {
+    ...existingPlugins,
+    slots: { ...existingSlots, ...newSlots },
+    entries: { ...existingEntries, ...newEntries }
+  };
+  fs__namespace.writeFileSync(resolvedPath, JSON.stringify(merged, null, 2) + "\n");
+}
+async function main() {
+  const command = process.argv[2];
+  if (command === "setup") {
+    await interactiveSetup();
+  } else {
+    console.log("Usage: npx @sonzai-labs/openclaw-context setup");
+    console.log("\nRun interactive setup to configure the Sonzai OpenClaw plugin.");
+  }
+}
+
+// src/cli.ts
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup.ts","../src/cli.ts"],"names":["Sonzai","path","readline","resolve","fs"],"mappings":"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","file":"cli.cjs","sourcesContent":["/**\n * Interactive and programmatic setup for the Sonzai OpenClaw plugin.\n *\n * Interactive:  `npx @sonzai-labs/openclaw-context setup`\n * Programmatic: `import { setup } from \"@sonzai-labs/openclaw-context\"`\n */\n\nimport { Sonzai } from \"@sonzai-labs/agents\";\nimport * as readline from \"node:readline\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Programmatic setup — for B2B integrations\n// ---------------------------------------------------------------------------\n\nexport interface SetupOptions {\n  /** Sonzai API key. */\n  apiKey: string;\n  /** Agent name (deterministic ID derived from tenant + name). */\n  agentName?: string;\n  /** Pre-existing agent ID (skips agent provisioning). */\n  agentId?: string;\n  /** Base URL override. */\n  baseUrl?: string;\n  /** Path to openclaw.json. Defaults to ./openclaw.json */\n  configPath?: string;\n  /** If true, writes to openclaw.json. If false, returns config object only. */\n  writeConfig?: boolean;\n}\n\nexport interface SetupResult {\n  agentId: string;\n  agentName: string;\n  config: Record<string, unknown>;\n  configPath?: string;\n  written: boolean;\n}\n\n/**\n * Programmatic setup — validates API key, provisions agent, optionally\n * writes openclaw.json. Designed for B2B automation scripts.\n */\nexport async function setup(options: SetupOptions): Promise<SetupResult> {\n  const baseUrl = options.baseUrl || \"https://api.sonz.ai\";\n  const agentName = options.agentName || \"openclaw-agent\";\n  const writeConfig = options.writeConfig ?? true;\n  const configPath = options.configPath || \"./openclaw.json\";\n\n  // 1. Validate API key by provisioning / finding the agent\n  const client = new Sonzai({ apiKey: options.apiKey, baseUrl });\n\n  let agentId: string;\n  if (options.agentId) {\n    // Verify agent exists\n    const agent = await client.agents.get(options.agentId);\n    agentId = agent.agent_id;\n  } else {\n    // Idempotent create — backend derives deterministic UUID from tenant+name\n    const agent = await client.agents.create({ name: agentName });\n    agentId = agent.agent_id;\n  }\n\n  // 2. Build the openclaw.json plugin config\n  const pluginConfig = buildOpenClawConfig(options.apiKey, agentId);\n\n  // 3. Optionally write to openclaw.json\n  let written = false;\n  if (writeConfig) {\n    mergeOpenClawConfig(configPath, pluginConfig);\n    written = true;\n  }\n\n  return {\n    agentId,\n    agentName,\n    config: pluginConfig,\n    configPath: written ? path.resolve(configPath) : undefined,\n    written,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Interactive CLI setup — `npx @sonzai-labs/openclaw-context setup`\n// ---------------------------------------------------------------------------\n\nexport async function interactiveSetup(): Promise<void> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  const ask = (question: string): Promise<string> =>\n    new Promise((resolve) => rl.question(question, resolve));\n\n  console.log(\"\\n🦞 Sonzai Mind Layer — OpenClaw Plugin Setup\\n\");\n\n  try {\n    // Step 1: API Key\n    const envKey = process.env.SONZAI_API_KEY;\n    let apiKey: string;\n    if (envKey) {\n      const useEnv = await ask(\n        `Found SONZAI_API_KEY in environment (${envKey.slice(0, 8)}...). Use it? [Y/n] `,\n      );\n      apiKey = useEnv.toLowerCase() === \"n\" ? await ask(\"Enter your Sonzai API key: \") : envKey;\n    } else {\n      apiKey = await ask(\"Enter your Sonzai API key (from https://sonz.ai/settings/api): \");\n    }\n\n    if (!apiKey.trim()) {\n      console.log(\"No API key provided. Aborting.\");\n      return;\n    }\n\n    // Step 2: Agent\n    const hasAgent = await ask(\"Do you have an existing Sonzai agent ID? [y/N] \");\n    let agentId: string | undefined;\n    let agentName = \"openclaw-agent\";\n\n    if (hasAgent.toLowerCase() === \"y\") {\n      agentId = await ask(\"Enter agent ID: \");\n    } else {\n      const customName = await ask(\n        `Agent name for auto-provisioning [openclaw-agent]: `,\n      );\n      if (customName.trim()) agentName = customName.trim();\n    }\n\n    // Step 3: Validate\n    console.log(\"\\nValidating API key and provisioning agent...\");\n    const result = await setup({\n      apiKey: apiKey.trim(),\n      agentId: agentId?.trim() || undefined,\n      agentName,\n      writeConfig: false,\n    });\n    console.log(`Agent ready: ${result.agentId}`);\n\n    // Step 4: Write config\n    const configPath = await ask(\"Path to openclaw.json [./openclaw.json]: \");\n    const resolvedPath = configPath.trim() || \"./openclaw.json\";\n\n    mergeOpenClawConfig(resolvedPath, result.config);\n    console.log(`\\nConfig written to ${path.resolve(resolvedPath)}`);\n\n    // Step 5: Env var hint\n    console.log(\"\\n--- Setup Complete ---\\n\");\n    console.log(\"Set your API key as an environment variable (recommended):\\n\");\n    console.log(`  export SONZAI_API_KEY=\"${apiKey.trim()}\"\\n`);\n    console.log(\"Or add it to your shell profile (~/.bashrc, ~/.zshrc).\\n\");\n    console.log(\n      \"The agent ID is saved in openclaw.json — no need to set SONZAI_AGENT_ID.\\n\",\n    );\n  } finally {\n    rl.close();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction buildOpenClawConfig(\n  _apiKey: string,\n  agentId: string,\n): Record<string, unknown> {\n  return {\n    plugins: {\n      slots: {\n        contextEngine: \"sonzai\",\n      },\n      entries: {\n        sonzai: {\n          enabled: true,\n          agentId,\n          // apiKey is intentionally NOT written to the config file —\n          // it should be set via SONZAI_API_KEY env var for security.\n        },\n      },\n    },\n  };\n}\n\nfunction mergeOpenClawConfig(\n  configPath: string,\n  pluginConfig: Record<string, unknown>,\n): void {\n  let existing: Record<string, unknown> = {};\n\n  const resolvedPath = path.resolve(configPath);\n  if (fs.existsSync(resolvedPath)) {\n    try {\n      const raw = fs.readFileSync(resolvedPath, \"utf-8\");\n      existing = JSON.parse(raw);\n    } catch {\n      // If parse fails, start fresh\n    }\n  }\n\n  // Deep merge plugins section\n  const merged = { ...existing };\n  const existingPlugins = (merged.plugins || {}) as Record<string, unknown>;\n  const newPlugins = pluginConfig.plugins as Record<string, unknown>;\n\n  const existingSlots = (existingPlugins.slots || {}) as Record<string, unknown>;\n  const newSlots = (newPlugins.slots || {}) as Record<string, unknown>;\n\n  const existingEntries = (existingPlugins.entries || {}) as Record<string, unknown>;\n  const newEntries = (newPlugins.entries || {}) as Record<string, unknown>;\n\n  merged.plugins = {\n    ...existingPlugins,\n    slots: { ...existingSlots, ...newSlots },\n    entries: { ...existingEntries, ...newEntries },\n  };\n\n  fs.writeFileSync(resolvedPath, JSON.stringify(merged, null, 2) + \"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// CLI entry point\n// ---------------------------------------------------------------------------\n\n/** Run when invoked as `npx @sonzai-labs/openclaw-context setup` */\nexport async function main(): Promise<void> {\n  const command = process.argv[2];\n\n  if (command === \"setup\") {\n    await interactiveSetup();\n  } else {\n    console.log(\"Usage: npx @sonzai-labs/openclaw-context setup\");\n    console.log(\"\\nRun interactive setup to configure the Sonzai OpenClaw plugin.\");\n  }\n}\n","#!/usr/bin/env node\nimport { main } from \"./setup.js\";\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { Sonzai } from '@sonzai-labs/agents';
+import * as readline from 'readline';
+import * as fs from 'fs';
+import * as path from 'path';
+
+async function setup(options) {
+  const baseUrl = options.baseUrl || "https://api.sonz.ai";
+  const agentName = options.agentName || "openclaw-agent";
+  const configPath = options.configPath || "./openclaw.json";
+  const client = new Sonzai({ apiKey: options.apiKey, baseUrl });
+  let agentId;
+  if (options.agentId) {
+    const agent = await client.agents.get(options.agentId);
+    agentId = agent.agent_id;
+  } else {
+    const agent = await client.agents.create({ name: agentName });
+    agentId = agent.agent_id;
+  }
+  const pluginConfig = buildOpenClawConfig(options.apiKey, agentId);
+  let written = false;
+  return {
+    agentId,
+    agentName,
+    config: pluginConfig,
+    configPath: written ? path.resolve(configPath) : void 0,
+    written
+  };
+}
+async function interactiveSetup() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const ask = (question) => new Promise((resolve2) => rl.question(question, resolve2));
+  console.log("\n\u{1F99E} Sonzai Mind Layer \u2014 OpenClaw Plugin Setup\n");
+  try {
+    const envKey = process.env.SONZAI_API_KEY;
+    let apiKey;
+    if (envKey) {
+      const useEnv = await ask(
+        `Found SONZAI_API_KEY in environment (${envKey.slice(0, 8)}...). Use it? [Y/n] `
+      );
+      apiKey = useEnv.toLowerCase() === "n" ? await ask("Enter your Sonzai API key: ") : envKey;
+    } else {
+      apiKey = await ask("Enter your Sonzai API key (from https://sonz.ai/settings/api): ");
+    }
+    if (!apiKey.trim()) {
+      console.log("No API key provided. Aborting.");
+      return;
+    }
+    const hasAgent = await ask("Do you have an existing Sonzai agent ID? [y/N] ");
+    let agentId;
+    let agentName = "openclaw-agent";
+    if (hasAgent.toLowerCase() === "y") {
+      agentId = await ask("Enter agent ID: ");
+    } else {
+      const customName = await ask(
+        `Agent name for auto-provisioning [openclaw-agent]: `
+      );
+      if (customName.trim()) agentName = customName.trim();
+    }
+    console.log("\nValidating API key and provisioning agent...");
+    const result = await setup({
+      apiKey: apiKey.trim(),
+      agentId: agentId?.trim() || void 0,
+      agentName,
+      writeConfig: false
+    });
+    console.log(`Agent ready: ${result.agentId}`);
+    const configPath = await ask("Path to openclaw.json [./openclaw.json]: ");
+    const resolvedPath = configPath.trim() || "./openclaw.json";
+    mergeOpenClawConfig(resolvedPath, result.config);
+    console.log(`
+Config written to ${path.resolve(resolvedPath)}`);
+    console.log("\n--- Setup Complete ---\n");
+    console.log("Set your API key as an environment variable (recommended):\n");
+    console.log(`  export SONZAI_API_KEY="${apiKey.trim()}"
+`);
+    console.log("Or add it to your shell profile (~/.bashrc, ~/.zshrc).\n");
+    console.log(
+      "The agent ID is saved in openclaw.json \u2014 no need to set SONZAI_AGENT_ID.\n"
+    );
+  } finally {
+    rl.close();
+  }
+}
+function buildOpenClawConfig(_apiKey, agentId) {
+  return {
+    plugins: {
+      slots: {
+        contextEngine: "sonzai"
+      },
+      entries: {
+        sonzai: {
+          enabled: true,
+          agentId
+          // apiKey is intentionally NOT written to the config file —
+          // it should be set via SONZAI_API_KEY env var for security.
+        }
+      }
+    }
+  };
+}
+function mergeOpenClawConfig(configPath, pluginConfig) {
+  let existing = {};
+  const resolvedPath = path.resolve(configPath);
+  if (fs.existsSync(resolvedPath)) {
+    try {
+      const raw = fs.readFileSync(resolvedPath, "utf-8");
+      existing = JSON.parse(raw);
+    } catch {
+    }
+  }
+  const merged = { ...existing };
+  const existingPlugins = merged.plugins || {};
+  const newPlugins = pluginConfig.plugins;
+  const existingSlots = existingPlugins.slots || {};
+  const newSlots = newPlugins.slots || {};
+  const existingEntries = existingPlugins.entries || {};
+  const newEntries = newPlugins.entries || {};
+  merged.plugins = {
+    ...existingPlugins,
+    slots: { ...existingSlots, ...newSlots },
+    entries: { ...existingEntries, ...newEntries }
+  };
+  fs.writeFileSync(resolvedPath, JSON.stringify(merged, null, 2) + "\n");
+}
+async function main() {
+  const command = process.argv[2];
+  if (command === "setup") {
+    await interactiveSetup();
+  } else {
+    console.log("Usage: npx @sonzai-labs/openclaw-context setup");
+    console.log("\nRun interactive setup to configure the Sonzai OpenClaw plugin.");
+  }
+}
+
+// src/cli.ts
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup.ts","../src/cli.ts"],"names":["resolve"],"mappings":"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","file":"cli.js","sourcesContent":["/**\n * Interactive and programmatic setup for the Sonzai OpenClaw plugin.\n *\n * Interactive:  `npx @sonzai-labs/openclaw-context setup`\n * Programmatic: `import { setup } from \"@sonzai-labs/openclaw-context\"`\n */\n\nimport { Sonzai } from \"@sonzai-labs/agents\";\nimport * as readline from \"node:readline\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Programmatic setup — for B2B integrations\n// ---------------------------------------------------------------------------\n\nexport interface SetupOptions {\n  /** Sonzai API key. */\n  apiKey: string;\n  /** Agent name (deterministic ID derived from tenant + name). */\n  agentName?: string;\n  /** Pre-existing agent ID (skips agent provisioning). */\n  agentId?: string;\n  /** Base URL override. */\n  baseUrl?: string;\n  /** Path to openclaw.json. Defaults to ./openclaw.json */\n  configPath?: string;\n  /** If true, writes to openclaw.json. If false, returns config object only. */\n  writeConfig?: boolean;\n}\n\nexport interface SetupResult {\n  agentId: string;\n  agentName: string;\n  config: Record<string, unknown>;\n  configPath?: string;\n  written: boolean;\n}\n\n/**\n * Programmatic setup — validates API key, provisions agent, optionally\n * writes openclaw.json. Designed for B2B automation scripts.\n */\nexport async function setup(options: SetupOptions): Promise<SetupResult> {\n  const baseUrl = options.baseUrl || \"https://api.sonz.ai\";\n  const agentName = options.agentName || \"openclaw-agent\";\n  const writeConfig = options.writeConfig ?? true;\n  const configPath = options.configPath || \"./openclaw.json\";\n\n  // 1. Validate API key by provisioning / finding the agent\n  const client = new Sonzai({ apiKey: options.apiKey, baseUrl });\n\n  let agentId: string;\n  if (options.agentId) {\n    // Verify agent exists\n    const agent = await client.agents.get(options.agentId);\n    agentId = agent.agent_id;\n  } else {\n    // Idempotent create — backend derives deterministic UUID from tenant+name\n    const agent = await client.agents.create({ name: agentName });\n    agentId = agent.agent_id;\n  }\n\n  // 2. Build the openclaw.json plugin config\n  const pluginConfig = buildOpenClawConfig(options.apiKey, agentId);\n\n  // 3. Optionally write to openclaw.json\n  let written = false;\n  if (writeConfig) {\n    mergeOpenClawConfig(configPath, pluginConfig);\n    written = true;\n  }\n\n  return {\n    agentId,\n    agentName,\n    config: pluginConfig,\n    configPath: written ? path.resolve(configPath) : undefined,\n    written,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Interactive CLI setup — `npx @sonzai-labs/openclaw-context setup`\n// ---------------------------------------------------------------------------\n\nexport async function interactiveSetup(): Promise<void> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  const ask = (question: string): Promise<string> =>\n    new Promise((resolve) => rl.question(question, resolve));\n\n  console.log(\"\\n🦞 Sonzai Mind Layer — OpenClaw Plugin Setup\\n\");\n\n  try {\n    // Step 1: API Key\n    const envKey = process.env.SONZAI_API_KEY;\n    let apiKey: string;\n    if (envKey) {\n      const useEnv = await ask(\n        `Found SONZAI_API_KEY in environment (${envKey.slice(0, 8)}...). Use it? [Y/n] `,\n      );\n      apiKey = useEnv.toLowerCase() === \"n\" ? await ask(\"Enter your Sonzai API key: \") : envKey;\n    } else {\n      apiKey = await ask(\"Enter your Sonzai API key (from https://sonz.ai/settings/api): \");\n    }\n\n    if (!apiKey.trim()) {\n      console.log(\"No API key provided. Aborting.\");\n      return;\n    }\n\n    // Step 2: Agent\n    const hasAgent = await ask(\"Do you have an existing Sonzai agent ID? [y/N] \");\n    let agentId: string | undefined;\n    let agentName = \"openclaw-agent\";\n\n    if (hasAgent.toLowerCase() === \"y\") {\n      agentId = await ask(\"Enter agent ID: \");\n    } else {\n      const customName = await ask(\n        `Agent name for auto-provisioning [openclaw-agent]: `,\n      );\n      if (customName.trim()) agentName = customName.trim();\n    }\n\n    // Step 3: Validate\n    console.log(\"\\nValidating API key and provisioning agent...\");\n    const result = await setup({\n      apiKey: apiKey.trim(),\n      agentId: agentId?.trim() || undefined,\n      agentName,\n      writeConfig: false,\n    });\n    console.log(`Agent ready: ${result.agentId}`);\n\n    // Step 4: Write config\n    const configPath = await ask(\"Path to openclaw.json [./openclaw.json]: \");\n    const resolvedPath = configPath.trim() || \"./openclaw.json\";\n\n    mergeOpenClawConfig(resolvedPath, result.config);\n    console.log(`\\nConfig written to ${path.resolve(resolvedPath)}`);\n\n    // Step 5: Env var hint\n    console.log(\"\\n--- Setup Complete ---\\n\");\n    console.log(\"Set your API key as an environment variable (recommended):\\n\");\n    console.log(`  export SONZAI_API_KEY=\"${apiKey.trim()}\"\\n`);\n    console.log(\"Or add it to your shell profile (~/.bashrc, ~/.zshrc).\\n\");\n    console.log(\n      \"The agent ID is saved in openclaw.json — no need to set SONZAI_AGENT_ID.\\n\",\n    );\n  } finally {\n    rl.close();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction buildOpenClawConfig(\n  _apiKey: string,\n  agentId: string,\n): Record<string, unknown> {\n  return {\n    plugins: {\n      slots: {\n        contextEngine: \"sonzai\",\n      },\n      entries: {\n        sonzai: {\n          enabled: true,\n          agentId,\n          // apiKey is intentionally NOT written to the config file —\n          // it should be set via SONZAI_API_KEY env var for security.\n        },\n      },\n    },\n  };\n}\n\nfunction mergeOpenClawConfig(\n  configPath: string,\n  pluginConfig: Record<string, unknown>,\n): void {\n  let existing: Record<string, unknown> = {};\n\n  const resolvedPath = path.resolve(configPath);\n  if (fs.existsSync(resolvedPath)) {\n    try {\n      const raw = fs.readFileSync(resolvedPath, \"utf-8\");\n      existing = JSON.parse(raw);\n    } catch {\n      // If parse fails, start fresh\n    }\n  }\n\n  // Deep merge plugins section\n  const merged = { ...existing };\n  const existingPlugins = (merged.plugins || {}) as Record<string, unknown>;\n  const newPlugins = pluginConfig.plugins as Record<string, unknown>;\n\n  const existingSlots = (existingPlugins.slots || {}) as Record<string, unknown>;\n  const newSlots = (newPlugins.slots || {}) as Record<string, unknown>;\n\n  const existingEntries = (existingPlugins.entries || {}) as Record<string, unknown>;\n  const newEntries = (newPlugins.entries || {}) as Record<string, unknown>;\n\n  merged.plugins = {\n    ...existingPlugins,\n    slots: { ...existingSlots, ...newSlots },\n    entries: { ...existingEntries, ...newEntries },\n  };\n\n  fs.writeFileSync(resolvedPath, JSON.stringify(merged, null, 2) + \"\\n\");\n}\n\n// ---------------------------------------------------------------------------\n// CLI entry point\n// ---------------------------------------------------------------------------\n\n/** Run when invoked as `npx @sonzai-labs/openclaw-context setup` */\nexport async function main(): Promise<void> {\n  const command = process.argv[2];\n\n  if (command === \"setup\") {\n    await interactiveSetup();\n  } else {\n    console.log(\"Usage: npx @sonzai-labs/openclaw-context setup\");\n    console.log(\"\\nRun interactive setup to configure the Sonzai OpenClaw plugin.\");\n  }\n}\n","#!/usr/bin/env node\nimport { main } from \"./setup.js\";\nmain().catch((err) => {\n  console.error(err);\n  process.exit(1);\n});\n"]}