@hera-al/server 1.6.1

package/bundled/ssh/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: ssh
+description: Manage SSH connections, run remote commands, transfer files, and manage keys. Use when working with remote servers.
+---
+
+# SSH Manager
+
+Manage SSH connections, execute remote commands, transfer files, and handle SSH keys.
+
+## When to Use
+- Running commands on remote servers
+- Transferring files to/from remote machines
+- Managing SSH keys and config
+- Setting up tunnels and port forwarding
+- Debugging connection issues
+
+## Remote Commands
+
+```bash
+ssh user@host "command"                          # Run single command
+ssh user@host "cd /app && git pull && pm2 restart all"  # Chained commands
+ssh -p 2222 user@host "command"                  # Custom port
+ssh -i ~/.ssh/mykey user@host "command"          # Specific key
+```
+
+## File Transfer (SCP)
+
+```bash
+scp file.txt user@host:/remote/path/             # Upload file
+scp user@host:/remote/path/file.txt ./           # Download file
+scp -r ./folder user@host:/remote/path/          # Upload directory
+scp -P 2222 file.txt user@host:/path/            # Custom port
+```
+
+## File Transfer (rsync - preferred for large transfers)
+
+```bash
+rsync -avz ./local/ user@host:/remote/           # Sync local to remote
+rsync -avz user@host:/remote/ ./local/           # Sync remote to local
+rsync -avz --delete ./local/ user@host:/remote/  # Mirror (delete extra files)
+rsync -avz --progress ./large-file user@host:/path/  # With progress
+rsync -avz -e "ssh -p 2222" ./local/ user@host:/remote/  # Custom port
+```
+
+## SSH Config (~/.ssh/config)
+
+```
+Host myserver
+    HostName 192.168.1.100
+    User admin
+    Port 22
+    IdentityFile ~/.ssh/mykey
+
+Host jump
+    HostName bastion.example.com
+    User jumpuser
+
+Host internal
+    HostName 10.0.0.5
+    User admin
+    ProxyJump jump
+```
+
+After config, simply: `ssh myserver`
+
+## Key Management
+
+```bash
+ssh-keygen -t ed25519 -C "comment"               # Generate key (preferred)
+ssh-keygen -t rsa -b 4096 -C "comment"           # Generate RSA key
+ssh-copy-id user@host                             # Copy public key to server
+ssh-add ~/.ssh/mykey                              # Add key to agent
+ssh-add -l                                        # List keys in agent
+```
+
+## Tunnels & Port Forwarding
+
+```bash
+# Local forward: access remote service on local port
+ssh -L 8080:localhost:3000 user@host              # local:8080 -> remote:3000
+
+# Remote forward: expose local service on remote port
+ssh -R 9090:localhost:3000 user@host              # remote:9090 -> local:3000
+
+# SOCKS proxy
+ssh -D 1080 user@host                            # SOCKS proxy on local:1080
+
+# Background tunnel (no shell)
+ssh -fN -L 8080:localhost:3000 user@host
+```
+
+## Troubleshooting
+
+```bash
+ssh -v user@host                                  # Verbose (debug level 1)
+ssh -vv user@host                                 # More verbose
+ssh -vvv user@host                                # Maximum verbosity
+ssh -o ConnectTimeout=5 user@host                 # Set timeout
+ssh -o StrictHostKeyChecking=no user@host         # Skip host key check (use carefully!)
+```
+
+## Server Health Checks
+
+```bash
+ssh user@host "uptime"                            # Load average
+ssh user@host "df -h"                             # Disk usage
+ssh user@host "free -h"                           # Memory usage
+ssh user@host "top -bn1 | head -20"              # Process list
+ssh user@host "systemctl status nginx"            # Service status
+ssh user@host "tail -n 50 /var/log/syslog"       # Recent logs
+ssh user@host "docker ps"                         # Running containers
+```
+
+## Notes
+- Always prefer ed25519 keys over RSA for new setups
+- Use SSH config file to avoid typing long commands
+- Use `rsync` over `scp` for large or repeated transfers
+- Never disable StrictHostKeyChecking in production
+- Use ProxyJump for bastion/jump host setups

package/bundled/summarize/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: summarize
+description: Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
+homepage: https://summarize.sh
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🧾",
+        "requires": { "bins": ["summarize"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/summarize",
+              "bins": ["summarize"],
+              "label": "Install summarize (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Summarize
+
+Fast CLI to summarize URLs, local files, and YouTube links.
+
+## When to use (trigger phrases)
+
+Use this skill immediately when the user asks any of:
+
+- “use summarize.sh”
+- “what’s this link/video about?”
+- “summarize this URL/article”
+- “transcribe this YouTube/video” (best-effort transcript extraction; no `yt-dlp` needed)
+
+## Quick start
+
+```bash
+summarize "https://example.com" --model google/gemini-3-flash-preview
+summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto
+```
+
+## YouTube: summary vs transcript
+
+Best-effort transcript (URLs only):
+
+```bash
+summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only
+```
+
+If the user asked for a transcript but it’s huge, return a tight summary first, then ask which section/time range to expand.
+
+## Model + keys
+
+Set the API key for your chosen provider:
+
+- OpenAI: `OPENAI_API_KEY`
+- Anthropic: `ANTHROPIC_API_KEY`
+- xAI: `XAI_API_KEY`
+- Google: `GEMINI_API_KEY` (aliases: `GOOGLE_GENERATIVE_AI_API_KEY`, `GOOGLE_API_KEY`)
+
+Default model is `google/gemini-3-flash-preview` if none is set.
+
+## Useful flags
+
+- `--length short|medium|long|xl|xxl|<chars>`
+- `--max-output-tokens <count>`
+- `--extract-only` (URLs only)
+- `--json` (machine readable)
+- `--firecrawl auto|off|always` (fallback extraction)
+- `--youtube auto` (Apify fallback if `APIFY_API_TOKEN` set)
+
+## Config
+
+Optional config file: `~/.summarize/config.json`
+
+```json
+{ "model": "openai/gpt-5.2" }
+```
+
+Optional services:
+
+- `FIRECRAWL_API_KEY` for blocked sites
+- `APIFY_API_TOKEN` for YouTube fallback

package/bundled/video-frames/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: video-frames
+description: Extract frames or short clips from videos using ffmpeg.
+homepage: https://ffmpeg.org
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎞️",
+        "requires": { "bins": ["ffmpeg"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "ffmpeg",
+              "bins": ["ffmpeg"],
+              "label": "Install ffmpeg (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Video Frames (ffmpeg)
+
+Extract a single frame from a video, or create quick thumbnails for inspection.
+
+## Quick start
+
+First frame:
+
+```bash
+{baseDir}/scripts/frame.sh /path/to/video.mp4 --out /tmp/frame.jpg
+```
+
+At a timestamp:
+
+```bash
+{baseDir}/scripts/frame.sh /path/to/video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
+```
+
+## Notes
+
+- Prefer `--time` for “what is happening around here?”.
+- Use a `.jpg` for quick share; use `.png` for crisp UI frames.

package/bundled/video-frames/scripts/frame.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat >&2 <<'EOF'
+Usage:
+  frame.sh <video-file> [--time HH:MM:SS] [--index N] --out /path/to/frame.jpg
+
+Examples:
+  frame.sh video.mp4 --out /tmp/frame.jpg
+  frame.sh video.mp4 --time 00:00:10 --out /tmp/frame-10s.jpg
+  frame.sh video.mp4 --index 0 --out /tmp/frame0.png
+EOF
+  exit 2
+}
+
+if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+fi
+
+in="${1:-}"
+shift || true
+
+time=""
+index=""
+out=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --time)
+      time="${2:-}"
+      shift 2
+      ;;
+    --index)
+      index="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out="${2:-}"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1" >&2
+      usage
+      ;;
+  esac
+done
+
+if [[ ! -f "$in" ]]; then
+  echo "File not found: $in" >&2
+  exit 1
+fi
+
+if [[ "$out" == "" ]]; then
+  echo "Missing --out" >&2
+  usage
+fi
+
+mkdir -p "$(dirname "$out")"
+
+if [[ "$index" != "" ]]; then
+  ffmpeg -hide_banner -loglevel error -y \
+    -i "$in" \
+    -vf "select=eq(n\\,${index})" \
+    -vframes 1 \
+    "$out"
+elif [[ "$time" != "" ]]; then
+  ffmpeg -hide_banner -loglevel error -y \
+    -ss "$time" \
+    -i "$in" \
+    -frames:v 1 \
+    "$out"
+else
+  ffmpeg -hide_banner -loglevel error -y \
+    -i "$in" \
+    -vf "select=eq(n\\,0)" \
+    -vframes 1 \
+    "$out"
+fi
+
+echo "$out"

package/bundled/voice-call/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: voice-call
+description: Start voice calls via the OpenClaw voice-call plugin.
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📞",
+        "skillKey": "voice-call",
+        "requires": { "config": ["plugins.entries.voice-call.enabled"] },
+      },
+  }
+---
+
+# Voice Call
+
+Use the voice-call plugin to start or inspect calls (Twilio, Telnyx, Plivo, or mock).
+
+## CLI
+
+```bash
+openclaw voicecall call --to "+15555550123" --message "Hello from OpenClaw"
+openclaw voicecall status --call-id <id>
+```
+
+## Tool
+
+Use `voice_call` for agent-initiated calls.
+
+Actions:
+
+- `initiate_call` (message, to?, mode?)
+- `continue_call` (callId, message)
+- `speak_to_user` (callId, message)
+- `end_call` (callId)
+- `get_status` (callId)
+
+Notes:
+
+- Requires the voice-call plugin to be enabled.
+- Plugin config lives under `plugins.entries.voice-call.config`.
+- Twilio config: `provider: "twilio"` + `twilio.accountSid/authToken` + `fromNumber`.
+- Telnyx config: `provider: "telnyx"` + `telnyx.apiKey/connectionId` + `fromNumber`.
+- Plivo config: `provider: "plivo"` + `plivo.authId/authToken` + `fromNumber`.
+- Dev fallback: `provider: "mock"` (no network).

package/bundled/wacli/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: wacli
+description: Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
+homepage: https://wacli.sh
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📱",
+        "requires": { "bins": ["wacli"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/wacli",
+              "bins": ["wacli"],
+              "label": "Install wacli (brew)",
+            },
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/wacli/cmd/wacli@latest",
+              "bins": ["wacli"],
+              "label": "Install wacli (go)",
+            },
+          ],
+      },
+  }
+---
+
+# wacli
+
+Use `wacli` only when the user explicitly asks you to message someone else on WhatsApp or when they ask to sync/search WhatsApp history.
+Do NOT use `wacli` for normal user chats; OpenClaw routes WhatsApp conversations automatically.
+If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.
+
+Safety
+
+- Require explicit recipient + message text.
+- Confirm recipient + message before sending.
+- If anything is ambiguous, ask a clarifying question.
+
+Auth + sync
+
+- `wacli auth` (QR login + initial sync)
+- `wacli sync --follow` (continuous sync)
+- `wacli doctor`
+
+Find chats + messages
+
+- `wacli chats list --limit 20 --query "name or number"`
+- `wacli messages search "query" --limit 20 --chat <jid>`
+- `wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31`
+
+History backfill
+
+- `wacli history backfill --chat <jid> --requests 2 --count 50`
+
+Send
+
+- Text: `wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"`
+- Group: `wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."`
+- File: `wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"`
+
+Notes
+
+- Store dir: `~/.wacli` (override with `--store`).
+- Use `--json` for machine-readable output when parsing.
+- Backfill requires your phone online; results are best-effort.
+- WhatsApp CLI is not needed for routine user chats; it’s for messaging other people.
+- JIDs: direct chats look like `<number>@s.whatsapp.net`; groups look like `<id>@g.us` (use `wacli chats list` to find).

package/bundled/weather/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: weather
+description: Get current weather and forecasts (no API key required).
+homepage: https://wttr.in/:help
+metadata: { "openclaw": { "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/agent/agent-service.d.ts

@@ -0,0 +1,88 @@
+import type { AppConfig } from "../config.js";
+import type { BuiltPrompt } from "./prompt-builder.js";
+import type { NodeRegistry } from "../gateway/node-registry.js";
+import type { ChannelManager } from "../gateway/channel-manager.js";
+import { type AgentResult } from "./session-agent.js";
+import type { UsageData } from "../commands/usage.js";
+import { createServerToolsServer } from "../tools/server-tools.js";
+import { createTTSToolsServer } from "../tools/tts-tools.js";
+export type QueryResult = AgentResult;
+export declare class AgentService {
+    private config;
+    private agents;
+    private usageBySession;
+    private nodeToolsServer;
+    private messageToolsServer;
+    private serverToolsServer;
+    private cronToolsServer;
+    private ttsToolsServer;
+    private memoryToolsServer;
+    private browserToolsServer;
+    private channelManager;
+    private showToolUseGetter;
+    constructor(config: AppConfig, nodeRegistry?: NodeRegistry, channelManager?: ChannelManager, serverToolsServer?: ReturnType<typeof createServerToolsServer>, cronToolsServer?: unknown, sessionDb?: import("./session-db.js").SessionDB, ttsToolsServer?: ReturnType<typeof createTTSToolsServer>, memoryToolsServer?: unknown, showToolUseGetter?: (sessionKey: string) => boolean, browserToolsServer?: unknown);
+    /**
+     * Send a message to the agent for a given session.
+     * Creates a long-lived SessionAgent on first call; subsequent messages for
+     * the same session key are queued and processed sequentially by the SDK.
+     */
+    sendMessage(sessionKey: string, prompt: BuiltPrompt, sessionId: string | undefined, systemPrompt: string, subagentSystemPrompt: string, modelOverride?: string, coderSkill?: boolean, subagentsEnabled?: boolean, customSubAgentsEnabled?: boolean, sandboxEnabled?: boolean): Promise<QueryResult>;
+    hasNodeTools(): boolean;
+    hasMessageTools(): boolean;
+    /** Return all active MCP tool server instances for introspection. */
+    getToolServers(): Array<{
+        name: string;
+        instance: unknown;
+    }>;
+    private getOrCreateAgent;
+    interrupt(sessionKey: string): Promise<boolean>;
+    /**
+     * Check if the agent for a session is currently processing a request.
+     */
+    isBusy(sessionKey: string): boolean;
+    /**
+     * Check if a session has a pending interactive permission request.
+     */
+    hasPendingPermission(sessionKey: string): boolean;
+    /**
+     * Resolve a pending interactive permission request for a session.
+     */
+    resolvePermission(sessionKey: string, approved: boolean): void;
+    /**
+     * Check if a session has a pending AskUserQuestion waiting for user input.
+     */
+    hasPendingQuestion(sessionKey: string): boolean;
+    /**
+     * Resolve a pending AskUserQuestion for a session.
+     */
+    resolveQuestion(sessionKey: string, answer: string): void;
+    /**
+     * Destroy a session's agent (e.g. on /new command).
+     * The next sendMessage call will create a fresh agent.
+     */
+    destroySession(sessionKey: string): void;
+    /**
+     * Close all active session agents (e.g. during server reconfiguration).
+     * Pending responses will be rejected with a "SessionAgent closed" error.
+     */
+    destroyAll(): void;
+    /**
+     * Get list of active session keys
+     */
+    getActiveSessions(): string[];
+    /**
+     * Get count of active sessions
+     */
+    getActiveSessionCount(): number;
+    /**
+     * Get SDK slash commands discovered from any active agent's init message.
+     * Returns the first non-empty list found (commands are the same across agents).
+     */
+    getUsage(sessionKey: string): UsageData | undefined;
+    getSdkSlashCommands(): string[];
+    listModels(): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+}
+//# sourceMappingURL=agent-service.d.ts.map

package/dist/agent/agent-service.js

@@ -0,0 +1 @@
+import{query as e}from"@anthropic-ai/claude-agent-sdk";import{SessionAgent as s}from"./session-agent.js";import{createNodeToolsServer as t}from"../tools/node-tools.js";import{createMessageToolsServer as o}from"../tools/message-tools.js";import{createLogger as r}from"../utils/logger.js";const n=r("AgentService");export class AgentService{config;agents=new Map;usageBySession=new Map;nodeToolsServer=null;messageToolsServer=null;serverToolsServer=null;cronToolsServer=null;ttsToolsServer=null;memoryToolsServer=null;browserToolsServer=null;channelManager=null;showToolUseGetter=null;constructor(e,s,r,n,i,a,l,g,h,c){this.config=e,r&&(this.channelManager=r),s&&(this.nodeToolsServer=t(s)),r&&a&&(this.messageToolsServer=o(r,()=>this.config,a)),n&&(this.serverToolsServer=n),i&&(this.cronToolsServer=i),l&&(this.ttsToolsServer=l),g&&(this.memoryToolsServer=g),c&&(this.browserToolsServer=c),h&&(this.showToolUseGetter=h)}async sendMessage(e,s,t,o,r,i,a,l,g,h){const c=this.getOrCreateAgent(e,t,o,r,i,a,l,g,h);if(i&&i!==c.getModel()){const t=e=>{const s=this.config.models.find(s=>s.id===e);return!(!s?.proxy||"not-used"===s.proxy)},d=t(c.getModel()),u=t(i);if(d||u){n.info(`[${e}] Proxy config change detected (old=${d}, new=${u}), restarting session`),this.destroySession(e);const t=this.getOrCreateAgent(e,void 0,o,r,i,a,l,g,h);return await t.send(s)}await c.setModel(i)}try{return await c.send(s)}catch(d){const u=d instanceof Error?d.message:String(d);if(u.includes("INVALID_ARGUMENT")||/API Error: 400/.test(u)){n.warn(`[${e}] Transient API 400 error, retrying once: ${u.slice(0,120)}`),this.agents.delete(e),c.close();const d=this.getOrCreateAgent(e,t,o,r,i,a,l,g,h);try{return await d.send(s)}catch(s){n.error(`[${e}] Retry also failed: ${s}`),this.agents.delete(e),d.close();const o=s instanceof Error?s.message:String(s);if(t)return{response:o.includes("SessionAgent closed")?"[AGENT_CLOSED]":"",sessionId:"",sessionReset:!0};throw s}}if(this.agents.delete(e),c.close(),t)return n.warn(`Session agent failed for ${e}: ${d}`),{response:u.includes("SessionAgent closed")?"[AGENT_CLOSED]":"",sessionId:"",sessionReset:!0};throw d}}hasNodeTools(){return null!==this.nodeToolsServer}hasMessageTools(){return null!==this.messageToolsServer}getToolServers(){const e=[];return this.nodeToolsServer&&e.push(this.nodeToolsServer),this.messageToolsServer&&e.push(this.messageToolsServer),this.serverToolsServer&&e.push(this.serverToolsServer),this.cronToolsServer&&e.push(this.cronToolsServer),this.ttsToolsServer&&e.push(this.ttsToolsServer),this.memoryToolsServer&&e.push(this.memoryToolsServer),this.browserToolsServer&&e.push(this.browserToolsServer),e}getOrCreateAgent(e,t,o,r,n,i,a,l,g){const h=this.agents.get(e);if(h&&h.isActive())return h;h&&(h.close(),this.agents.delete(e));const c=new s(e,this.config,o,r,t,n,this.nodeToolsServer??void 0,this.messageToolsServer??void 0,this.serverToolsServer??void 0,this.cronToolsServer??void 0,i,a,l,this.ttsToolsServer??void 0,this.memoryToolsServer??void 0,this.browserToolsServer??void 0,g);if(this.channelManager){const e=this.channelManager;if(c.setChannelSender(async(s,t,o,r)=>{r&&r.length>0?await e.sendButtons(s,t,o,r):await e.sendToChannel(s,t,o)}),this.showToolUseGetter){const s=this.showToolUseGetter;c.setToolUseNotifier(async(t,o,r)=>{if(!s(`${t}:${o}`))return;const n=`⚙️ Using ${r.replace(/^mcp__[^_]+__/,"")}`;await e.sendToChannel(t,o,n),await e.setTyping(t,o)})}c.setTypingSetter(async(s,t)=>{await e.setTyping(s,t)}),c.setTypingClearer(async(s,t)=>{await e.clearTyping(s,t)}),c.setTextBlockStreamer(async(s,t,o)=>{await e.sendResponse(s,t,o)})}return c.setUsageRecorder((e,s,t,o,r)=>{this.usageBySession.set(e,{totalCostUsd:s,durationMs:t,numTurns:o,modelUsage:r,recordedAt:Date.now()})}),this.agents.set(e,c),c}async interrupt(e){const s=this.agents.get(e);return!!s&&s.interrupt()}isBusy(e){const s=this.agents.get(e);return!!s&&s.isBusy()}hasPendingPermission(e){const s=this.agents.get(e);return!!s&&s.hasPendingPermission()}resolvePermission(e,s){const t=this.agents.get(e);t&&t.resolvePermission(s)}hasPendingQuestion(e){const s=this.agents.get(e);return!!s&&s.hasPendingQuestion()}resolveQuestion(e,s){const t=this.agents.get(e);t&&t.resolveQuestion(s)}destroySession(e){const s=this.agents.get(e);s&&(s.close(),this.agents.delete(e),n.info(`Session agent destroyed: ${e}`))}destroyAll(){for(const[e,s]of this.agents)s.close(),n.info(`Session agent destroyed (reconfigure): ${e}`);this.agents.clear()}getActiveSessions(){return Array.from(this.agents.keys()).filter(e=>{const s=this.agents.get(e);return s&&s.isActive()})}getActiveSessionCount(){return this.getActiveSessions().length}getUsage(e){return this.usageBySession.get(e)}getSdkSlashCommands(){for(const e of this.agents.values()){const s=e.getSdkSlashCommands();if(s.length>0)return s}return[]}async listModels(){try{const s=e({prompt:"list models",options:{maxTurns:0}}),t=await s.supportedModels();for await(const e of s)break;return t.map(e=>({id:e.id??e.name??String(e),name:e.name??e.id??String(e)}))}catch(e){return n.error(`Failed to list models: ${e}`),[{id:"claude-sonnet-4-6",name:"Claude Sonnet 4.6"},{id:"claude-opus-4-6",name:"Claude Opus 4.6"},{id:"claude-haiku-3-5-20241022",name:"Claude Haiku 3.5"}]}}}

package/dist/agent/message-queue.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Async iterable message queue for the Claude Agent SDK.
+ *
+ * Messages are pushed via push() and consumed sequentially via async iteration.
+ * Used as the `prompt` input to the SDK's query() function, enabling a single
+ * long-lived query per session with multiple user messages over time.
+ */
+export interface QueueMessage {
+    type: "user";
+    message: {
+        role: "user";
+        content: string | Array<Record<string, unknown>>;
+    };
+}
+export declare class MessageQueue {
+    private messages;
+    private waitingResolve;
+    private closed;
+    push(msg: QueueMessage): void;
+    close(): void;
+    get pending(): number;
+    [Symbol.asyncIterator](): AsyncIterableIterator<QueueMessage>;
+}
+//# sourceMappingURL=message-queue.d.ts.map

package/dist/agent/message-queue.js

@@ -0,0 +1 @@
+export class MessageQueue{messages=[];waitingResolve=null;closed=!1;push(s){if(!this.closed)if(this.waitingResolve){const e=this.waitingResolve;this.waitingResolve=null,e(s)}else this.messages.push(s)}close(){if(this.closed=!0,this.waitingResolve){const s=this.waitingResolve;this.waitingResolve=null,s(null)}}get pending(){return this.messages.length}async*[Symbol.asyncIterator](){for(;!this.closed;)if(this.messages.length>0)yield this.messages.shift();else{const s=await new Promise(s=>{this.waitingResolve=s});if(null===s)break;yield s}}}