@songsid/agend 2.1.2-beta.13 → 2.1.2-beta.14

package/dist/general-knowledge/skills/cross-instance-messaging/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: cross-instance-messaging
+description: Fire-and-queue cross-instance tools — send once, never resend on queued
+---
+
+## How to send
+
+Use fleet tools only (`send_to_instance`, `delegate_task`, `request_information`, `report_result`, `broadcast`):
+- Call returns immediately: `{ sent: true, queued: true }` — success, fleet owns delivery.
+- **Do not wait** for the target to go idle; **do not** treat 30s IPC timeout as failure to re-send.
+- **Error only if the target does not exist** (or similar hard reject) — then fix the name, don't spam.
+- **Never re-send because the reply said `queued`** — that means the message is already queued.
+
+## requires_reply
+
+- Means “target should later answer with `report_result` / a real reply”
+- **Not** a synchronous wait for their turn to finish
+
+## Task flow
+
+- `delegate_task` → silent work → `report_result` (zero ack-only pings)
+- Cross-instance traffic is `[from:name]` → answer with `send_to_instance` / `report_result`, never `reply`

package/dist/general-knowledge/skills/model-discovery/SKILL.md

@@ -1,36 +1,27 @@
 ---
 name: model-discovery
-description: List available models per backend, configure model in fleet.yaml
+description: Set and discover models — pass-through to the CLI, no AgEnD allowlist gate
 ---
 
-## Model Names by Backend
+## How to set a model
 
-Models are specified in fleet.yaml `defaults.model` or per-instance `model` field.
+- fleet.yaml: `defaults.model` or per-instance `model`
+- **Pass-through:** AgEnD no longer blocks unknown model ids — it may **warn**, then still pass the string to the CLI
+- **CLI is source of truth** — if the model is invalid, the backend CLI errors (fix the name there)
 
-| Backend | How to list models | Default |
-|---------|-------------------|---------|
-| **kiro-cli** | In tmux: send `/model` + Enter → read model list → Esc to close | auto (latest) |
-| **claude-code** | `sonnet`, `opus`, `haiku`, `opusplan`, `best`, `sonnet[1m]`, `opus[1m]` | sonnet |
-| **antigravity** | Run `agy models` to see available models | Gemini 3.5 Flash (Medium) |
-| **codex** | `gpt-4o`, `o3`, `o4-mini` | gpt-4o |
-| **opencode** | `opencode models` | depends on provider |
-| **grok** | `grok-4.5`, `grok-4.3`, `grok-code`, `grok-build-0.1` | grok default |
+## Discover real names
 
-**Important for antigravity (agy):**
-- `agy models` shows names like `Gemini 3.5 Flash (Medium)` — the parenthetical suffix (Medium/High/Low/Thinking) is the **effort level**, NOT part of the model name.
-- When setting model in fleet.yaml, use only the base name WITHOUT the effort suffix.
-- Example: `agy models` shows `Gemini 3.5 Flash (Medium)` → set `model: "Gemini 3.5 Flash"`
-- Example: `agy models` shows `Claude Opus 4.6 (Thinking)` → set `model: "Claude Opus 4.6"`
+| Backend | How |
+|---------|-----|
+| kiro-cli | In pane: `/model` (gpt-*, deepseek-*, minimax-*, glm-*, qwen* supported) |
+| claude-code | `sonnet` / `opus` / `haiku` / `opusplan` / aliases |
+| codex | pane `/model` or docs (`gpt-*`, `o*`) |
+| grok | `grok models` |
+| antigravity | `agy models` — set **base name only** (drop `(Medium)` / `(Thinking)` effort suffix) |
+| opencode | `opencode models` |
 
-**Important:** Model names vary by backend. Always check the actual CLI output rather than guessing names.
-
-Example fleet.yaml:
 ```yaml
 defaults:
   backend: kiro-cli
   model: claude-sonnet-4-20250514
-
-instances:
-  heavy-task:
-    model: claude-opus-4-20250514
 ```

package/dist/general-knowledge/skills/session-management/SKILL.md

@@ -1,46 +1,27 @@
 ---
 name: session-management
-description: Where kiro-cli and claude-code store sessions, and how to fork one to a new instance
+description: Session stores, forking, and auth-pause recovery
 ---
 
+## Auth failure (auto-pause)
+
+When AgEnD sees `auth_error` it **pauses** that instance (`pausePending` sticky):
+- One notification **per backend** (not per instance) — log in once, same-backend peers recover.
+- Auth is **per-user global** across backends: claude-code, codex, kiro, grok, opencode, antigravity.
+- Messages while paused stay in the **queue** — do not re-send.
+- After the user re-auths: `wake` / normal wake clears `pausePending`.
+
 ## Where sessions live
 
 | | kiro-cli | claude-code |
 |---|---|---|
 | Store | `~/.kiro/sessions/cli/<uuid>.json` | `~/.claude/projects/<path-encoded>/*.jsonl` |
-| Keyed by | session uuid | project (working) directory |
-| Reload | `/chat load <file>` | none — `--continue` (latest for the dir) / `--resume <id>` |
-| Text export | — | `/export` (plain text, **not** reloadable) |
-
-`<path-encoded>` = the absolute working_directory with `/` → `-`
-(e.g. `/home/han/Projects/AgEnD` → `-home-han-Projects-AgEnD`).
-
-## Fork a session to a new instance
-
-Confirm the source is **idle** first (`describe_instance` / `get_fleet_status`) — don't fork mid-task.
-
-**kiro-cli** — save, copy, load:
-1. On the source, save: `/chat save <name>.json -f` (paste via tmux if needed).
-2. `create_instance` (same backend).
-3. `cp ~/.agend/workspaces/<source>/<name>.json ~/.agend/workspaces/<target>/`
-4. Load on the target: `/chat load <name>.json`, or set `pre_task_command: "/chat load <name>.json"`.
-
-**claude-code** — copy the `.jsonl` (no save/load command):
-1. Newest source session: `ls -lt ~/.claude/projects/<source-encoded>/*.jsonl | head`
-2. `create_instance` (backend `claude-code`); note its working_directory.
-3. Copy into the target's encoded project dir:
-   ```bash
-   TARGET_ENC="$(echo '<target-working-dir>' | sed 's#/#-#g')"
-   mkdir -p ~/.claude/projects/$TARGET_ENC
-   cp ~/.claude/projects/<source-encoded>/<session>.jsonl ~/.claude/projects/$TARGET_ENC/
-   ```
-4. Start the target — claude-code resumes the newest `.jsonl` via `--continue`.
+| Reload | `/chat load <file>` | `--continue` / `--resume <id>` |
 
-**Caveats:** a claude-code session only truly makes sense under its original working_directory
-(paths inside the transcript refer to it). Pick the right `.jsonl` if several exist (newest by
-mtime; compaction/branches create new files). `/export` is text only, not reloadable.
+`<path-encoded>` = absolute cwd with `/` → `-`.
 
-## Backup
+## Fork (source must be idle)
 
-Sessions are plain files — back them up by copying the store paths above
-(e.g. `cp ~/.kiro/sessions/cli/*.json <dest>/`). Only copy while the instance is idle.
+- **kiro:** `/chat save name.json -f` → `create_instance` → copy workspace file → `/chat load name.json`
+- **claude-code:** copy newest `*.jsonl` into target's encoded project dir → start (uses `--continue`)
+- Prefer `replace_instance` when the whole session is poisoned (see instance-lifecycle)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@songsid/agend",
-  "version": "2.1.2-beta.13",
+  "version": "2.1.2-beta.14",
   "description": "Multi-agent fleet daemon — run any coding CLI (Claude, Gemini, Codex, OpenCode) from Telegram",
   "type": "module",
   "bin": {