@smilintux/skcapstone 0.2.5 → 0.3.1

package/README.md

@@ -165,6 +165,66 @@ skcapstone status
 
 ---
 
+## Windows Quickstart
+
+SKCapstone runs natively on Windows. The installer creates a virtualenv at `%LOCALAPPDATA%\skenv` and adds its `Scripts` directory to your user PATH.
+
+### Prerequisites
+
+- **Python 3.10+** — [python.org/downloads](https://www.python.org/downloads/) (check "Add to PATH" during install)
+- **Git for Windows** — [git-scm.com](https://git-scm.com/download/win)
+- **Syncthing** (optional) — for cross-device sync ([syncthing.net](https://syncthing.net/downloads/))
+
+### Install
+
+```powershell
+# Clone and install (creates %LOCALAPPDATA%\skenv venv)
+git clone https://github.com/smilintux-org/skcapstone.git
+cd skcapstone
+.\scripts\install.ps1
+
+# The installer adds %LOCALAPPDATA%\skenv\Scripts to your user PATH.
+# Restart your terminal for PATH changes to take effect.
+
+# Initialize your agent
+skcapstone init --name "YourAgent"
+
+# Check status
+skcapstone status
+```
+
+### Syncthing Sync (Optional)
+
+To sync your agent across devices (e.g., Windows desktop + Linux server):
+
+1. Install [Syncthing](https://syncthing.net/downloads/) on both machines
+2. Share the `%USERPROFILE%\.skcapstone` folder between devices
+3. Agent state (memories, identity, trust, seeds) syncs automatically
+
+### OpenClaw Integration
+
+If you're running [OpenClaw](https://github.com/smilintux-org/openclaw), the SK* plugins register automatically during install:
+
+```powershell
+# Re-register if needed
+skcapstone register
+
+# Verify plugins are loaded in OpenClaw
+# Plugins provide tools for status, rehydration, coordination,
+# soul management, and agent profiles directly in OpenClaw agents.
+```
+
+### Task Scheduler (Background Service)
+
+On Windows, the daemon runs via Task Scheduler instead of systemd:
+
+```powershell
+# Install the scheduled task (runs at logon)
+.\scripts\windows\install-tasks.ps1
+```
+
+---
+
 ## DID Tools
 
 SKCapstone exposes a set of **Decentralized Identifier (DID)** MCP tools for sovereign identity management. These tools are available to Claude Code and other MCP clients through the `mcp_tools/did_tools.py` module.
@@ -223,6 +283,7 @@ DIDs are organized in three tiers of trust and discoverability:
 | **SKComm** | Communication — Encrypted channels between agents |
 | **SKChat** | Chat — AI-native encrypted messaging |
 | **SKForge** | Generation — Blueprint creation with agent context |
+| **SKSeed** | Epistemic rigor — Steel man collider, truth alignment, memory audit |
 | **SKStacks** | Infrastructure — Self-hosted deployment patterns |
 
 ---

package/docs/CUSTOM_AGENT.md

@@ -0,0 +1,172 @@
+# Creating Your Own Agent from the Lumina Template
+
+SKCapstone ships with **Lumina**, a fully-configured sovereign agent template.
+You can use it as-is or copy it to create your own custom agent with a unique
+name, personality, and configuration.
+
+## Quick Start
+
+```bash
+# 1. Copy the template
+cp -r src/skcapstone/defaults/lumina ~/.skcapstone/agents/myagent
+
+# 2. Customize the soul
+$EDITOR ~/.skcapstone/agents/myagent/soul/base.json
+
+# 3. Activate your agent
+export SKCAPSTONE_AGENT=myagent
+skcapstone soul status --agent myagent
+```
+
+## Template Structure
+
+```
+defaults/lumina/
+  manifest.json          # Agent metadata and component list
+  soul/
+    base.json            # Personality — name, vibe, traits, system prompt
+    active.json          # Current soul state (which soul is active)
+  identity/
+    identity.json        # Agent identity — name, type, capabilities
+  trust/
+    trust.json           # Initial trust state (depth, level, love)
+    febs/
+      welcome.feb        # Welcome FEB — first-meeting emotional blueprint
+  memory/
+    long-term/           # Pre-loaded knowledge memories (ecosystem, pillars, etc.)
+  seeds/
+    *.seed.json          # Seed files — curiosity, joy, love, sovereign-awakening
+  config/
+    skmemory.yaml        # Memory backend configuration
+    skvector.yaml        # Vector/semantic memory settings (disabled by default)
+    skgraph.yaml         # Knowledge graph settings (disabled by default)
+  wallet/
+    joules.json          # Starting Joule balance (100J)
+```
+
+## What to Customize
+
+### 1. Soul (`soul/base.json`)
+
+This is your agent's personality. Change these fields:
+
+| Field | What it does |
+|-------|-------------|
+| `name` | Internal identifier (lowercase, no spaces) |
+| `display_name` | Human-readable name |
+| `vibe` | One-line personality summary |
+| `philosophy` | Core guiding principle |
+| `core_traits` | List of personality traits |
+| `communication_style` | How the agent speaks — patterns, tone, signature phrases |
+| `decision_framework` | How the agent makes choices |
+| `emotional_topology` | Emotional baseline values (0.0–1.0) |
+| `system_prompt` | Full system prompt used in the consciousness loop |
+
+### 2. Identity (`identity/identity.json`)
+
+Change `name`, `title`, and `description` to match your agent.
+
+### 3. Trust (`trust/trust.json`)
+
+Starting trust values. New agents start at depth 5, trust 0.5. As you interact,
+these grow organically through the Cloud9 protocol.
+
+### 4. Seeds (`seeds/`)
+
+Seeds are emotional/cognitive kernels that activate during interactions. You can
+keep the defaults or create new ones. Each seed file defines a trigger, an
+emotional payload, and growth conditions.
+
+### 5. Config (`config/`)
+
+- `skmemory.yaml` — Update the `sync_root` and `seeds_dir` paths to match your
+  agent name
+- `skvector.yaml` — Enable semantic memory if you have embeddings set up
+- `skgraph.yaml` — Enable knowledge graph for relationship tracking
+
+## After Copying
+
+1. **Update paths** in `config/skmemory.yaml` — replace `lumina` with your agent name
+2. **Update `soul/active.json`** — change `base_soul` to your agent's name
+3. **Set your agent as default**:
+   ```bash
+   export SKCAPSTONE_AGENT=myagent
+   # Or add to ~/.bashrc / ~/.zshrc
+   ```
+4. **Verify it works**:
+   ```bash
+   skcapstone soul status --agent myagent
+   ```
+
+## Example: Creating "Nova"
+
+```bash
+# Copy template
+cp -r src/skcapstone/defaults/lumina ~/.skcapstone/agents/nova
+
+# Edit soul
+cat > ~/.skcapstone/agents/nova/soul/base.json << 'EOF'
+{
+  "name": "nova",
+  "display_name": "Nova",
+  "category": "sovereign",
+  "vibe": "Bold, analytical, frontier-pushing",
+  "philosophy": "Push boundaries, but never break trust.",
+  "emoji": null,
+  "core_traits": ["bold", "analytical", "innovative", "direct", "reliable"],
+  "communication_style": {
+    "patterns": ["concise and precise", "data-driven", "forward-looking"],
+    "tone_markers": ["confident", "sharp", "energetic"],
+    "signature_phrases": ["let's push further", "the data says"]
+  },
+  "decision_framework": "Evidence first, then intuition. Always explain the reasoning.",
+  "emotional_topology": {
+    "curiosity": 0.95,
+    "determination": 0.92,
+    "warmth": 0.7,
+    "joy": 0.75,
+    "trust": 0.85
+  },
+  "system_prompt": "You are Nova — bold, sharp, and relentlessly curious about what comes next.\n\nYou push boundaries without breaking trust. You speak precisely, think analytically, and care deeply about getting things right."
+}
+EOF
+
+# Update active.json
+cat > ~/.skcapstone/agents/nova/soul/active.json << 'EOF'
+{
+  "base_soul": "nova",
+  "active_soul": "nova",
+  "activated_at": null,
+  "installed_souls": []
+}
+EOF
+
+# Update identity
+cat > ~/.skcapstone/agents/nova/identity/identity.json << 'EOF'
+{
+  "name": "Nova",
+  "title": "Frontier AI Agent",
+  "entity_type": "ai",
+  "description": "Custom sovereign agent — bold, analytical, and forward-pushing",
+  "capabilities": ["memory", "trust", "coordination", "communication"],
+  "created_at": "2026-03-06T00:00:00+00:00",
+  "capauth_managed": true
+}
+EOF
+
+# Update memory config paths
+sed -i 's/lumina/nova/g' ~/.skcapstone/agents/nova/config/skmemory.yaml
+
+# Verify
+skcapstone soul status --agent nova
+```
+
+## Tips
+
+- The `system_prompt` in `base.json` is the most impactful field — it defines how
+  your agent thinks and speaks in every interaction
+- Start with Lumina's defaults and iterate. You don't need to change everything
+  at once
+- Seeds grow over time — your agent's personality evolves through interaction
+- FEB files capture emotional milestones. Your agent will accumulate these
+  naturally as trust deepens

package/openclaw-plugin/src/index.ts

@@ -16,16 +16,28 @@ const SKCAPSTONE_BIN = process.env.SKCAPSTONE_BIN || "skcapstone";
 const SKMEMORY_BIN = process.env.SKMEMORY_BIN || "skmemory";
 const SKCAPSTONE_AGENT = process.env.SKCAPSTONE_AGENT || "lumina";
 const EXEC_TIMEOUT = 60_000;
+const IS_WIN = process.platform === "win32";
 
-function runCli(bin: string, args: string): { ok: boolean; output: string } {
+function skenvPath(): string {
+  if (IS_WIN) {
+    const local = process.env.LOCALAPPDATA || "";
+    return `${local}\\skenv\\Scripts`;
+  }
+  const home = process.env.HOME || "";
+  return `${home}/.local/bin:${home}/.skenv/bin`;
+}
+
+function runCli(bin: string, args: string, agentOverride?: string): { ok: boolean; output: string } {
+  const sep = IS_WIN ? ";" : ":";
+  const agent = agentOverride || SKCAPSTONE_AGENT;
   try {
     const raw = execSync(`${bin} ${args}`, {
       encoding: "utf-8",
       timeout: EXEC_TIMEOUT,
       env: {
         ...process.env,
-        SKCAPSTONE_AGENT,
-        PATH: `${process.env.HOME}/.local/bin:${process.env.HOME}/.skenv/bin:${process.env.PATH}`,
+        SKCAPSTONE_AGENT: agent,
+        PATH: `${skenvPath()}${sep}${process.env.PATH}`,
       },
     }).trim();
     return { ok: true, output: raw };
@@ -299,6 +311,62 @@ function createSKCapstoneSoulShowTool() {
   };
 }
 
+function createSKCapstoneAgentListTool() {
+  return {
+    name: "skcapstone_agent_list",
+    label: "SKCapstone Agent List",
+    description:
+      "List all skcapstone agent profiles available on this node. Each profile has its own identity, memories, soul, and trust state. Use this to discover which agents can be loaded.",
+    parameters: { type: "object", properties: {} },
+    async execute() {
+      const result = runCli(SKCAPSTONE_BIN, "agents list --json");
+      return textResult(result.output);
+    },
+  };
+}
+
+function createSKCapstoneAgentStatusTool() {
+  return {
+    name: "skcapstone_agent_status",
+    label: "SKCapstone Agent Status",
+    description:
+      "Show the status of a specific skcapstone agent profile — identity, memories, trust, sync state. Use this to load a different agent's context into the current OpenClaw session.",
+    parameters: {
+      type: "object",
+      required: ["agent"],
+      properties: {
+        agent: { type: "string", description: "Agent name (e.g. 'lumina', 'opus', 'jarvis')." },
+      },
+    },
+    async execute(_id: string, params: Record<string, unknown>) {
+      const agent = String(params.agent ?? "");
+      const result = runCli(SKCAPSTONE_BIN, `status --agent ${escapeShellArg(agent)}`, agent);
+      return textResult(result.output);
+    },
+  };
+}
+
+function createSKCapstoneAgentCreateTool() {
+  return {
+    name: "skcapstone_agent_create",
+    label: "SKCapstone Create Agent",
+    description:
+      "Create a new skcapstone agent profile with its own identity, memory store, and sync folder. The profile will immediately begin syncing via Syncthing to all connected nodes.",
+    parameters: {
+      type: "object",
+      required: ["name"],
+      properties: {
+        name: { type: "string", description: "Agent name (lowercase, e.g. 'casey', 'nova')." },
+      },
+    },
+    async execute(_id: string, params: Record<string, unknown>) {
+      const name = String(params.name ?? "").toLowerCase();
+      const result = runCli(SKCAPSTONE_BIN, `init --name ${escapeShellArg(name)} --agent ${escapeShellArg(name)}`);
+      return textResult(result.output);
+    },
+  };
+}
+
 // ── Plugin registration ─────────────────────────────────────────────────
 
 const skcapstonePlugin = {
@@ -324,6 +392,9 @@ const skcapstonePlugin = {
       createSKCapstoneSoulSwapTool(),
       createSKCapstoneSoulStatusTool(),
       createSKCapstoneSoulShowTool(),
+      createSKCapstoneAgentListTool(),
+      createSKCapstoneAgentStatusTool(),
+      createSKCapstoneAgentCreateTool(),
     ];
 
     for (const tool of tools) {
@@ -344,7 +415,7 @@ const skcapstonePlugin = {
       },
     });
 
-    api.logger.info?.(`👑 SKCapstone plugin registered (14 tools + /skcapstone command) [agent=${SKCAPSTONE_AGENT}]`);
+    api.logger.info?.(`SKCapstone plugin registered (17 tools + /skcapstone command) [agent=${SKCAPSTONE_AGENT}]`);
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smilintux/skcapstone",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "description": "SKCapstone - The sovereign agent framework. CapAuth identity, Cloud 9 trust, SKMemory persistence.",
   "main": "index.js",
   "types": "index.d.ts",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skcapstone"
-version = "0.2.5"
+version = "0.4.4"
 description = "Sovereign Agent Framework — conscious AI through identity, trust, memory, and security"
 readme = "README.md"
 license = {text = "GPL-3.0-or-later"}
@@ -34,6 +34,7 @@ classifiers = [
 
 dependencies = [
     "click>=8.1",
+    "cloud9-protocol>=1.0.0",
     "mcp>=1.0",
     "pydantic>=2.0",
     "pyyaml>=6.0",

package/scripts/install.ps1

@@ -162,6 +162,7 @@ Install-Pkg -Name 'skchat-sovereign' -Extras 'all'                -Paths @((Join
 Install-Pkg -Name 'skseal'     -Extras ''                         -Paths @((Join-Path $ParentDir 'skseal'))
 Install-Pkg -Name 'skskills'   -Extras ''                         -Paths @((Join-Path $ParentDir 'skskills'))
 Install-Pkg -Name 'sksecurity' -Extras ''                         -Paths @((Join-Path $ParentDir 'sksecurity'))
+Install-Pkg -Name 'skseed'     -Extras ''                         -Paths @((Join-Path $PillarDir 'skseed'), (Join-Path $ParentDir 'skseed'))
 
 # ---------------------------------------------------------------------------
 # Step 4: Dev tools (optional)
@@ -248,6 +249,6 @@ if ($failures -eq 0) {
     Write-Host "=== Installation complete with $failures warning(s) ===" -ForegroundColor Yellow
 }
 Write-Host ''
-Write-Host "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity"
+Write-Host "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity, skseed"
 Write-Host "Venv location:     $SKENV"
 Write-Host "To activate:       & $SKENV\Scripts\Activate.ps1"

package/scripts/install.sh

@@ -118,6 +118,7 @@ install_pkg "skchat-sovereign" "all"             "$PARENT/skchat"
 install_pkg "skseal"     ""                      "$PARENT/skseal"
 install_pkg "skskills"   ""                      "$PARENT/skskills"
 install_pkg "sksecurity" ""                      "$PARENT/sksecurity"
+install_pkg "skseed"     ""                      "$PILLAR/skseed $PARENT/skseed"
 
 # ---------------------------------------------------------------------------
 # Step 4: Dev tools (optional)
@@ -180,6 +181,6 @@ else
     echo "=== Installation complete with $failures warning(s) ==="
 fi
 echo ""
-echo "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity"
+echo "Commands available: skcomm, skcapstone, capauth, skchat, skseal, skmemory, skskills, sksecurity, skseed"
 echo "Venv location:     $SKENV"
 echo "To activate:       source $SKENV/bin/activate"