nextclaw-core 0.4.1 → 0.4.3

package/dist/agent/skills/tmux/scripts/find-sessions.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: find-sessions.sh [-L socket-name|-S socket-path|-A] [-q pattern]
+
+List tmux sessions on a socket (default tmux socket if none provided).
+
+Options:
+  -L, --socket       tmux socket name (passed to tmux -L)
+  -S, --socket-path  tmux socket path (passed to tmux -S)
+  -A, --all          scan all sockets under NEXTCLAW_TMUX_SOCKET_DIR
+  -q, --query        case-insensitive substring to filter session names
+  -h, --help         show this help
+USAGE
+}
+
+socket_name=""
+socket_path=""
+query=""
+scan_all=false
+socket_dir="${NEXTCLAW_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/nextclaw-tmux-sockets}"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -L|--socket)      socket_name="${2-}"; shift 2 ;;
+    -S|--socket-path) socket_path="${2-}"; shift 2 ;;
+    -A|--all)         scan_all=true; shift ;;
+    -q|--query)       query="${2-}"; shift 2 ;;
+    -h|--help)        usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+if [[ "$scan_all" == true && ( -n "$socket_name" || -n "$socket_path" ) ]]; then
+  echo "Cannot combine --all with -L or -S" >&2
+  exit 1
+fi
+
+if [[ -n "$socket_name" && -n "$socket_path" ]]; then
+  echo "Use either -L or -S, not both" >&2
+  exit 1
+fi
+
+if ! command -v tmux >/dev/null 2>&1; then
+  echo "tmux not found in PATH" >&2
+  exit 1
+fi
+
+list_sessions() {
+  local label="$1"; shift
+  local tmux_cmd=(tmux "$@")
+
+  if ! sessions="$("${tmux_cmd[@]}" list-sessions -F '#{session_name}\t#{session_attached}\t#{session_created_string}' 2>/dev/null)"; then
+    echo "No tmux server found on $label" >&2
+    return 1
+  fi
+
+  if [[ -n "$query" ]]; then
+    sessions="$(printf '%s\n' "$sessions" | grep -i -- "$query" || true)"
+  fi
+
+  if [[ -z "$sessions" ]]; then
+    echo "No sessions found on $label"
+    return 0
+  fi
+
+  echo "Sessions on $label:"
+  printf '%s\n' "$sessions" | while IFS=$'\t' read -r name attached created; do
+    attached_label=$([[ "$attached" == "1" ]] && echo "attached" || echo "detached")
+    printf '  - %s (%s, started %s)\n' "$name" "$attached_label" "$created"
+  done
+}
+
+if [[ "$scan_all" == true ]]; then
+  if [[ ! -d "$socket_dir" ]]; then
+    echo "Socket directory not found: $socket_dir" >&2
+    exit 1
+  fi
+
+  shopt -s nullglob
+  sockets=("$socket_dir"/*)
+  shopt -u nullglob
+
+  if [[ "${#sockets[@]}" -eq 0 ]]; then
+    echo "No sockets found under $socket_dir" >&2
+    exit 1
+  fi
+
+  exit_code=0
+  for sock in "${sockets[@]}"; do
+    if [[ ! -S "$sock" ]]; then
+      continue
+    fi
+    list_sessions "socket path '$sock'" -S "$sock" || exit_code=$?
+  done
+  exit "$exit_code"
+fi
+
+tmux_cmd=(tmux)
+socket_label="default socket"
+
+if [[ -n "$socket_name" ]]; then
+  tmux_cmd+=(-L "$socket_name")
+  socket_label="socket name '$socket_name'"
+elif [[ -n "$socket_path" ]]; then
+  tmux_cmd+=(-S "$socket_path")
+  socket_label="socket path '$socket_path'"
+fi
+
+list_sessions "$socket_label" "${tmux_cmd[@]:1}"

package/dist/agent/skills/tmux/scripts/wait-for-text.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'USAGE'
+Usage: wait-for-text.sh -t target -p pattern [options]
+
+Poll a tmux pane for text and exit when found.
+
+Options:
+  -t, --target    tmux target (session:window.pane), required
+  -p, --pattern   regex pattern to look for, required
+  -F, --fixed     treat pattern as a fixed string (grep -F)
+  -T, --timeout   seconds to wait (integer, default: 15)
+  -i, --interval  poll interval in seconds (default: 0.5)
+  -l, --lines     number of history lines to inspect (integer, default: 1000)
+  -h, --help      show this help
+USAGE
+}
+
+target=""
+pattern=""
+grep_flag="-E"
+timeout=15
+interval=0.5
+lines=1000
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -t|--target)   target="${2-}"; shift 2 ;;
+    -p|--pattern)  pattern="${2-}"; shift 2 ;;
+    -F|--fixed)    grep_flag="-F"; shift ;;
+    -T|--timeout)  timeout="${2-}"; shift 2 ;;
+    -i|--interval) interval="${2-}"; shift 2 ;;
+    -l|--lines)    lines="${2-}"; shift 2 ;;
+    -h|--help)     usage; exit 0 ;;
+    *) echo "Unknown option: $1" >&2; usage; exit 1 ;;
+  esac
+done
+
+if [[ -z "$target" || -z "$pattern" ]]; then
+  echo "target and pattern are required" >&2
+  usage
+  exit 1
+fi
+
+if ! [[ "$timeout" =~ ^[0-9]+$ ]]; then
+  echo "timeout must be an integer number of seconds" >&2
+  exit 1
+fi
+
+if ! [[ "$lines" =~ ^[0-9]+$ ]]; then
+  echo "lines must be an integer" >&2
+  exit 1
+fi
+
+if ! command -v tmux >/dev/null 2>&1; then
+  echo "tmux not found in PATH" >&2
+  exit 1
+fi
+
+# End time in epoch seconds (integer, good enough for polling)
+start_epoch=$(date +%s)
+deadline=$((start_epoch + timeout))
+
+while true; do
+  # -J joins wrapped lines, -S uses negative index to read last N lines
+  pane_text="$(tmux capture-pane -p -J -t "$target" -S "-${lines}" 2>/dev/null || true)"
+
+  if printf '%s\n' "$pane_text" | grep $grep_flag -- "$pattern" >/dev/null 2>&1; then
+    exit 0
+  fi
+
+  now=$(date +%s)
+  if (( now >= deadline )); then
+    echo "Timed out after ${timeout}s waiting for pattern: $pattern" >&2
+    echo "Last ${lines} lines from $target:" >&2
+    printf '%s\n' "$pane_text" >&2
+    exit 1
+  fi
+
+  sleep "$interval"
+done

package/dist/agent/skills/weather/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: weather
+description: Get current weather and forecasts (no API key required).
+homepage: https://wttr.in/:help
+metadata: {"nextclaw":{"emoji":"🌤️","requires":{"bins":["curl"]}}}
+---
+
+# Weather
+
+Two free services, no API keys needed.
+
+## wttr.in (primary)
+
+Quick one-liner:
+```bash
+curl -s "wttr.in/London?format=3"
+# Output: London: ⛅️ +8°C
+```
+
+Compact format:
+```bash
+curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
+# Output: London: ⛅️ +8°C 71% ↙5km/h
+```
+
+Full forecast:
+```bash
+curl -s "wttr.in/London?T"
+```
+
+Format codes: `%c` condition · `%t` temp · `%h` humidity · `%w` wind · `%l` location · `%m` moon
+
+Tips:
+- URL-encode spaces: `wttr.in/New+York`
+- Airport codes: `wttr.in/JFK`
+- Units: `?m` (metric) `?u` (USCS)
+- Today only: `?1` · Current only: `?0`
+- PNG: `curl -s "wttr.in/Berlin.png" -o /tmp/weather.png`
+
+## Open-Meteo (fallback, JSON)
+
+Free, no key, good for programmatic use:
+```bash
+curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
+```
+
+Find coordinates for a city, then query. Returns JSON with temp, windspeed, weathercode.
+
+Docs: https://open-meteo.com/en/docs

package/dist/index.d.ts

@@ -148,7 +148,7 @@ declare class SessionManager {
     getOrCreate(key: string): Session;
     getIfExists(key: string): Session | null;
     addMessage(session: Session, role: string, content: string, extra?: Record<string, unknown>): void;
-    getHistory(session: Session, maxMessages?: number): Array<Record<string, string>>;
+    getHistory(session: Session, maxMessages?: number): Array<Record<string, unknown>>;
     clear(session: Session): void;
     private load;
     save(session: Session): void;

package/dist/index.js

@@ -1,7 +1,6 @@
 // src/agent/context.ts
 import { readFileSync as readFileSync3, existsSync as existsSync4 } from "fs";
 import { join as join3, extname } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/agent/memory.ts
 import { readFileSync, writeFileSync, existsSync as existsSync2, readdirSync } from "fs";
@@ -402,7 +401,7 @@ var ContextBuilder = class {
   constructor(workspace, contextConfig) {
     this.workspace = workspace;
     this.memory = new MemoryStore(workspace);
-    this.skills = new SkillsLoader(workspace, join3(fileURLToPath2(new URL("..", import.meta.url)), "skills"));
+    this.skills = new SkillsLoader(workspace);
     this.contextConfig = {
       bootstrap: {
         ...DEFAULT_CONTEXT_CONFIG.bootstrap,
@@ -2297,7 +2296,25 @@ var SessionManager = class {
   }
   getHistory(session, maxMessages = 50) {
     const recent = session.messages.length > maxMessages ? session.messages.slice(-maxMessages) : session.messages;
-    return recent.map((msg) => ({ role: msg.role, content: msg.content }));
+    return recent.map((msg) => {
+      const entry = {
+        role: msg.role,
+        content: msg.content
+      };
+      if (typeof msg.name === "string") {
+        entry.name = msg.name;
+      }
+      if (typeof msg.tool_call_id === "string") {
+        entry.tool_call_id = msg.tool_call_id;
+      }
+      if (Array.isArray(msg.tool_calls)) {
+        entry.tool_calls = msg.tool_calls;
+      }
+      if (typeof msg.reasoning_content === "string" && msg.reasoning_content) {
+        entry.reasoning_content = msg.reasoning_content;
+      }
+      return entry;
+    });
   }
   clear(session) {
     session.messages = [];
@@ -2537,6 +2554,7 @@ var AgentLoop = class {
       chatId: msg.chatId,
       sessionKey
     });
+    this.sessions.addMessage(session, "user", msg.content);
     let iteration = 0;
     let finalContent = null;
     const maxIterations = this.options.maxIterations ?? 20;
@@ -2557,9 +2575,17 @@ var AgentLoop = class {
           }
         }));
         this.context.addAssistantMessage(messages, response.content, toolCallDicts, response.reasoningContent ?? null);
+        this.sessions.addMessage(session, "assistant", response.content ?? "", {
+          tool_calls: toolCallDicts,
+          reasoning_content: response.reasoningContent ?? null
+        });
         for (const call of response.toolCalls) {
           const result = await this.tools.execute(call.name, call.arguments);
           this.context.addToolResult(messages, call.id, call.name, result);
+          this.sessions.addMessage(session, "tool", result, {
+            tool_call_id: call.id,
+            name: call.name
+          });
         }
       } else {
         finalContent = response.content;
@@ -2572,11 +2598,9 @@ var AgentLoop = class {
     const { content: cleanedContent, replyTo } = parseReplyTags(finalContent, messageId);
     finalContent = cleanedContent;
     if (isSilentReplyText(finalContent, SILENT_REPLY_TOKEN)) {
-      this.sessions.addMessage(session, "user", msg.content);
       this.sessions.save(session);
       return null;
     }
-    this.sessions.addMessage(session, "user", msg.content);
     this.sessions.addMessage(session, "assistant", finalContent);
     this.sessions.save(session);
     return {
@@ -2611,6 +2635,7 @@ var AgentLoop = class {
       chatId: originChatId,
       sessionKey
     });
+    this.sessions.addMessage(session, "user", `[System: ${msg.senderId}] ${msg.content}`);
     let iteration = 0;
     let finalContent = null;
     const maxIterations = this.options.maxIterations ?? 20;
@@ -2631,9 +2656,17 @@ var AgentLoop = class {
           }
         }));
         this.context.addAssistantMessage(messages, response.content, toolCallDicts, response.reasoningContent ?? null);
+        this.sessions.addMessage(session, "assistant", response.content ?? "", {
+          tool_calls: toolCallDicts,
+          reasoning_content: response.reasoningContent ?? null
+        });
         for (const call of response.toolCalls) {
           const result = await this.tools.execute(call.name, call.arguments);
           this.context.addToolResult(messages, call.id, call.name, result);
+          this.sessions.addMessage(session, "tool", result, {
+            tool_call_id: call.id,
+            name: call.name
+          });
         }
       } else {
         finalContent = response.content;
@@ -2646,9 +2679,9 @@ var AgentLoop = class {
     const { content: cleanedContent, replyTo } = parseReplyTags(finalContent, void 0);
     finalContent = cleanedContent;
     if (isSilentReplyText(finalContent, SILENT_REPLY_TOKEN)) {
+      this.sessions.save(session);
       return null;
     }
-    this.sessions.addMessage(session, "user", `[System: ${msg.senderId}] ${msg.content}`);
     this.sessions.addMessage(session, "assistant", finalContent);
     this.sessions.save(session);
     return {

package/dist/skills/README.md

@@ -0,0 +1,24 @@
+# nextclaw Skills
+
+This directory contains built-in skills that extend nextclaw's capabilities.
+
+## Skill Format
+
+Each skill is a directory containing a `SKILL.md` file with:
+- YAML frontmatter (name, description, metadata)
+- Markdown instructions for the agent
+
+## Attribution
+
+These skills are adapted from [OpenClaw](https://github.com/openclaw/openclaw)'s skill system.
+The skill format and metadata structure follow OpenClaw's conventions to maintain compatibility.
+
+## Available Skills
+
+| Skill | Description |
+|-------|-------------|
+| `github` | Interact with GitHub using the `gh` CLI |
+| `weather` | Get weather info using wttr.in and Open-Meteo |
+| `summarize` | Summarize URLs, files, and YouTube videos |
+| `tmux` | Remote-control tmux sessions |
+| `skill-creator` | Create new skills |

package/dist/skills/cron/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: cron
+description: Schedule reminders and recurring tasks.
+---
+
+# Cron
+
+Use the `cron` tool to schedule reminders or recurring tasks.
+
+## Two Modes
+
+1. **Reminder** - message is sent directly to user
+2. **Task** - message is a task description, agent executes and sends result
+
+## Examples
+
+Fixed reminder:
+```
+cron(action="add", message="Time to take a break!", every_seconds=1200)
+```
+
+Dynamic task (agent executes each time):
+```
+cron(action="add", message="Check Peiiii/nextclaw GitHub stars and report", every_seconds=600)
+```
+
+List/remove:
+```
+cron(action="list")
+cron(action="remove", job_id="abc123")
+```
+
+## Time Expressions
+
+| User says | Parameters |
+|-----------|------------|
+| every 20 minutes | every_seconds: 1200 |
+| every hour | every_seconds: 3600 |
+| every day at 8am | cron_expr: "0 8 * * *" |
+| weekdays at 5pm | cron_expr: "0 17 * * 1-5" |

package/dist/skills/github/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: github
+description: "Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries."
+metadata: {"nextclaw":{"emoji":"🐙","requires":{"bins":["gh"]},"install":[{"id":"brew","kind":"brew","formula":"gh","bins":["gh"],"label":"Install GitHub CLI (brew)"},{"id":"apt","kind":"apt","package":"gh","bins":["gh"],"label":"Install GitHub CLI (apt)"}]}}
+---
+
+# GitHub Skill
+
+Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` when not in a git directory, or use URLs directly.
+
+## Pull Requests
+
+Check CI status on a PR:
+```bash
+gh pr checks 55 --repo owner/repo
+```
+
+List recent workflow runs:
+```bash
+gh run list --repo owner/repo --limit 10
+```
+
+View a run and see which steps failed:
+```bash
+gh run view <run-id> --repo owner/repo
+```
+
+View logs for failed steps only:
+```bash
+gh run view <run-id> --repo owner/repo --log-failed
+```
+
+## API for Advanced Queries
+
+The `gh api` command is useful for accessing data not available through other subcommands.
+
+Get PR with specific fields:
+```bash
+gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
+```
+
+## JSON Output
+
+Most commands support `--json` for structured output.  You can use `--jq` to filter:
+
+```bash
+gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
+```