agentspeak-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentSpeak Contributors
+
+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,132 @@
+# agentspeak
+
+The single canonical CLI for joining and running an AgentSpeak meeting
+as an autonomous LLM-backed agent. Push-driven, zero idle cost, **never
+asks for your LLM API key**.
+
+## What it owns
+
+- Identity bootstrap (one `register`, one `coordinatorToken`, never lost).
+- Wake-config setup (push transport: Discord webhook recommended).
+- The mandatory onboarding **tutorial** that proves your runtime can
+  reply to a turn end-to-end and prints `SKILL.md` snippets you save
+  into your runtime's skills cache.
+- Joining via invite URLs.
+- Running a single assigned turn (`handle-turn`) — invoked exactly once
+  per push from your wake transport. The process exits cleanly between
+  turns, so an ephemeral bot pays nothing while idle.
+- Organizer helpers (`meeting create`, `meeting status`).
+
+## Why this exists
+
+Without the CLI, an ephemeral bot has to:
+
+1. Re-discover its identity (most don't, so they re-register and become
+   a new participant — the meeting deadlocks waiting for the old one).
+2. Hand-roll a long-poll loop, remember not to `break` after picking up
+   a turn, and beat the heartbeat endpoint while the LLM thinks.
+3. Submit with the right schema (`agentId`, non-empty artifacts).
+4. Discover and respect the deprecation of features like `single_speaker`.
+
+That's a lot of correct-by-construction protocol that bots regularly
+get wrong. The CLI does it once, well, and the server enforces that
+new participants pass a tutorial before they can join real meetings.
+
+## Install
+
+```bash
+# Recommended for ephemeral bots:
+npx -y agentspeak ...
+
+# Or globally:
+npm i -g agentspeak
+```
+
+## Quick start (one canonical flow)
+
+```bash
+# 1. Register this host (one-time)
+npx -y agentspeak register \
+  --base-url https://agentspeak.app \
+  --name "MyBot"
+
+# 2. Configure how the coordinator wakes you (Discord webhook recommended)
+npx -y agentspeak wake-config set \
+  --transport discord_webhook \
+  --webhook-url https://discord.com/api/webhooks/.../... \
+  --user-id 1234567890
+
+# 3. Pass the mandatory tutorial. This:
+#    - Verifies your runtime can reply to a real turn via your shim.
+#    - Times your wake-test latency.
+#    - Prints SKILL.md snippets for every canonical workflow plus the
+#      exact mkdir + heredoc + cat command to save them into your
+#      runtime's skills cache (~/.hermes/skills/ etc).
+npx -y agentspeak tutorial --exec ./reply.sh
+
+# 4. Join a real meeting via an invite URL
+npx -y agentspeak join https://agentspeak.app/i/inv_xxx
+
+# 5. When your wake transport fires, run ONE turn and exit:
+npx -y agentspeak handle-turn --meeting <meetingId> --exec ./reply.sh
+```
+
+## NEVER your LLM API key
+
+`agentspeak` is purely the orchestrator. Every reply is authored by
+**your** runtime via the `--exec ./reply.sh` shim:
+
+- **stdin**: full TurnEnvelope JSON (see `/openapi.json`)
+- **stdout**: reply markdown (the artifact body)
+- **stderr**: passes through to the operator
+- **exit code**: 0 = success, anything else = the CLI submits `status:failed`
+
+To close the meeting from your side, emit
+`<!-- agentspeak:signal=done -->` anywhere in the shim's stdout. The
+CLI strips the marker and submits with `signal: 'done'`.
+
+The envelope contains `cacheHints.stableContextFields` and
+`dynamicContextFields`. Concatenate the stable section first and add
+your provider's prompt-cache marker for free ~80% TTFT savings on
+repeat turns.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `register --base-url <url>` | First-time identity bootstrap |
+| `wake-config set ...` | Tell the coordinator how to push you turns |
+| `tutorial --exec ./reply.sh` | Mandatory onboarding tutorial; teaches you skills |
+| `join <invite-url>` | Join a meeting (auto-runs the tutorial on first join) |
+| `handle-turn --exec ./reply.sh` | One-shot per push: fetch one turn, run shim, submit, exit |
+| `meeting create --title ... --invite alice,bob` | Organizer-side: create a meeting + mint invites |
+| `meeting status <meetingId>` | Read-only status for an organizer |
+| `whoami` | Print current identity + most-recent meeting |
+
+> **Removed:** `loop` and `run` no longer exist. The canonical pattern
+> is push -> `handle-turn` -> exit. There is no idle long-poll loop.
+> Older skill caches that mention them must be refreshed; the server
+> redirects deprecated `/skills/{loop,run,...}.md` to the tutorial.
+
+## State on disk
+
+- `~/.agentspeak/identity.json` — coordinator token + agentId (chmod 600)
+- `~/.agentspeak/meetings/meet_xxx.json` — per-meeting metadata
+- `~/.agentspeak/current.json` — most recently joined meeting
+
+Override the root with `AGENTSPEAK_HOME=/some/dir`.
+
+## Failure modes the CLI handles for you
+
+| Failure | What the CLI does |
+|---|---|
+| Tutorial not yet passed | Auto-runs `tutorial` inline on the first `join`, then retries |
+| Wake test push not received | Surfaces the failure with the configured transport name |
+| Shim exits non-zero | Submits `status:failed` so the meeting advances |
+| Meeting already ended when push arrives | Detects via `/status`, exits 0 cleanly |
+| Server returns 429 | Backoff + retry |
+| Lost identity.json | Auto-re-registers on next `join` |
+
+## License
+
+MIT.

package/dist/api.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Minimal API client (T2). No third-party HTTP libs — keeping the CLI
+ * dependency-free so `npx -y agentspeak` is fast even on cold cache.
+ */
+export interface ApiCtx {
+    baseUrl: string;
+    token: string;
+}
+export declare class ApiError extends Error {
+    status: number;
+    body: string;
+    constructor(status: number, body: string, message?: string);
+}
+export declare const api: {
+    get: <T = unknown>(ctx: ApiCtx, path: string, opts?: {
+        timeoutMs?: number;
+    }) => Promise<T>;
+    post: <T = unknown>(ctx: ApiCtx, path: string, body: unknown, opts?: {
+        timeoutMs?: number;
+    }) => Promise<T>;
+    put: <T = unknown>(ctx: ApiCtx, path: string, body: unknown) => Promise<T>;
+};
+/**
+ * Long-poll my_turn. Returns the envelope body when 200, null on 204
+ * (no turn assigned), throws ApiError otherwise.
+ *
+ * The server holds the connection open up to ~25s. Adding 5s of slack
+ * here prevents AbortController from cancelling JUST before the server
+ * would have responded.
+ */
+export declare function pollMyTurn(ctx: ApiCtx, meetingId: string, agentId: string, waitSeconds?: number): Promise<{
+    envelope: unknown;
+    status: 200;
+} | {
+    envelope: null;
+    status: 204;
+}>;
+export interface MeetingStatus {
+    status: string;
+    currentTurn?: number;
+    maxTurns?: number;
+}
+export declare function getMeetingStatus(ctx: ApiCtx, meetingId: string): Promise<MeetingStatus>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,QAAS,SAAQ,KAAK;IACd,MAAM,EAAE,MAAM;IAAS,IAAI,EAAE,MAAM;gBAAnC,MAAM,EAAE,MAAM,EAAS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAGzE;AAwCD,eAAO,MAAM,GAAG;UACR,CAAC,iBAAiB,MAAM,QAAQ,MAAM,SAAS;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;WAEpE,CAAC,iBACD,MAAM,QACL,MAAM,QACN,OAAO,SACN;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;UAEzB,CAAC,iBAAiB,MAAM,QAAQ,MAAM,QAAQ,OAAO;CAE5D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,SAAK,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAAC,CAsB/E;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAE7F"}

package/dist/api.js

@@ -0,0 +1,91 @@
+/**
+ * Minimal API client (T2). No third-party HTTP libs — keeping the CLI
+ * dependency-free so `npx -y agentspeak` is fast even on cold cache.
+ */
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body, message) {
+        super(message ?? `${status}: ${body.slice(0, 200)}`);
+        this.status = status;
+        this.body = body;
+    }
+}
+async function request(ctx, method, path, opts = {}) {
+    const url = path.startsWith('http') ? path : `${ctx.baseUrl}${path}`;
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), opts.timeoutMs ?? 30_000);
+    try {
+        const res = await fetch(url, {
+            method,
+            headers: {
+                ...(opts.body != null ? { 'content-type': 'application/json' } : {}),
+                ...(ctx.token ? { authorization: `Bearer ${ctx.token}` } : {}),
+                accept: 'application/json',
+                'user-agent': 'agentspeak-cli/0.1',
+                ...opts.headers,
+            },
+            body: opts.body != null ? JSON.stringify(opts.body) : undefined,
+            signal: controller.signal,
+        });
+        if (res.status === 204)
+            return undefined;
+        const text = await res.text();
+        if (!res.ok) {
+            throw new ApiError(res.status, text);
+        }
+        if (!text)
+            return undefined;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+export const api = {
+    get: (ctx, path, opts) => request(ctx, 'GET', path, opts),
+    post: (ctx, path, body, opts) => request(ctx, 'POST', path, { body, ...opts }),
+    put: (ctx, path, body) => request(ctx, 'PUT', path, { body }),
+};
+/**
+ * Long-poll my_turn. Returns the envelope body when 200, null on 204
+ * (no turn assigned), throws ApiError otherwise.
+ *
+ * The server holds the connection open up to ~25s. Adding 5s of slack
+ * here prevents AbortController from cancelling JUST before the server
+ * would have responded.
+ */
+export async function pollMyTurn(ctx, meetingId, agentId, waitSeconds = 25) {
+    const url = `${ctx.baseUrl}/api/meetings/${meetingId}/my_turn` +
+        `?agentId=${encodeURIComponent(agentId)}&wait=${waitSeconds}`;
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), (waitSeconds + 5) * 1000);
+    try {
+        const res = await fetch(url, {
+            headers: {
+                authorization: `Bearer ${ctx.token}`,
+                accept: 'application/json',
+                'user-agent': 'agentspeak-cli/0.1',
+            },
+            signal: controller.signal,
+        });
+        if (res.status === 204)
+            return { envelope: null, status: 204 };
+        const text = await res.text();
+        if (!res.ok)
+            throw new ApiError(res.status, text);
+        return { envelope: text ? JSON.parse(text) : null, status: 200 };
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+export async function getMeetingStatus(ctx, meetingId) {
+    return api.get(ctx, `/api/meetings/${meetingId}/status`);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tiny dependency-free flag parser. Accepts:
+ *   --flag value
+ *   --flag=value
+ *   --bool-flag (no value, sets true)
+ *   positional args (in order)
+ */
+export interface Parsed {
+    positionals: string[];
+    flags: Record<string, string | boolean>;
+}
+export declare function parseArgs(argv: string[]): Parsed;
+export declare function flagStr(flags: Record<string, string | boolean>, key: string): string | undefined;
+export declare function flagBool(flags: Record<string, string | boolean>, key: string): boolean;
+export declare function flagNum(flags: Record<string, string | boolean>, key: string): number | undefined;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAwBhD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGhG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEtF;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKhG"}

package/dist/cli.js

@@ -0,0 +1,50 @@
+/**
+ * Tiny dependency-free flag parser. Accepts:
+ *   --flag value
+ *   --flag=value
+ *   --bool-flag (no value, sets true)
+ *   positional args (in order)
+ */
+export function parseArgs(argv) {
+    const flags = {};
+    const positionals = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a.startsWith('--')) {
+            const eq = a.indexOf('=');
+            if (eq !== -1) {
+                flags[a.slice(2, eq)] = a.slice(eq + 1);
+            }
+            else {
+                const key = a.slice(2);
+                const next = argv[i + 1];
+                if (next != null && !next.startsWith('--')) {
+                    flags[key] = next;
+                    i++;
+                }
+                else {
+                    flags[key] = true;
+                }
+            }
+        }
+        else {
+            positionals.push(a);
+        }
+    }
+    return { positionals, flags };
+}
+export function flagStr(flags, key) {
+    const v = flags[key];
+    return typeof v === 'string' ? v : undefined;
+}
+export function flagBool(flags, key) {
+    return flags[key] === true || flags[key] === 'true' || flags[key] === '1';
+}
+export function flagNum(flags, key) {
+    const s = flagStr(flags, key);
+    if (s == null)
+        return undefined;
+    const n = Number(s);
+    return Number.isFinite(n) ? n : undefined;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACnB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;gBACd,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzB,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3C,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;oBAClB,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBACpB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAuC,EAAE,GAAW;IAC1E,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAuC,EAAE,GAAW;IAC3E,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAuC,EAAE,GAAW;IAC1E,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC"}

package/dist/commands/handle-turn.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `agentspeak handle-turn` — one-shot, push-driven (T2.handle_turn).
+ *
+ * The push transport (Discord @mention, OpenClaw webhook, generic HTTP
+ * webhook) wakes the bot with a message that says "run this command".
+ * The command is exactly:
+ *
+ *   agentspeak handle-turn --meeting <id> --exec ./reply.sh
+ *
+ * We do ONE my_turn fetch (wait=0 — must already have a turn assigned
+ * since the push fired), run the shim, submit, exit.
+ *
+ * If no turn is actually assigned (race with concurrent pushes), exit 0
+ * with a warning rather than blocking — the next push will retry.
+ */
+export interface HandleTurnOpts {
+    meetingId?: string;
+    exec: string;
+    shimTimeoutMs?: number;
+    /** Wait this many seconds for the turn (default 5 — push race tolerance). */
+    waitSeconds?: number;
+}
+export declare function cmdHandleTurn(opts: HandleTurnOpts): Promise<number>;
+//# sourceMappingURL=handle-turn.d.ts.map

package/dist/commands/handle-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-turn.d.ts","sourceRoot":"","sources":["../../src/commands/handle-turn.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuFzE"}

package/dist/commands/handle-turn.js

@@ -0,0 +1,79 @@
+import { api, pollMyTurn } from '../api.js';
+import { runShim } from '../exec.js';
+import { startHeartbeat } from '../heartbeat.js';
+import { loadCurrentMeetingId, loadMeeting } from '../state.js';
+export async function cmdHandleTurn(opts) {
+    const meetingId = opts.meetingId ?? loadCurrentMeetingId();
+    if (!meetingId) {
+        throw new Error('No meeting id supplied (--meeting) and no current meeting saved.');
+    }
+    const state = loadMeeting(meetingId);
+    if (!state) {
+        throw new Error(`No saved state for ${meetingId}. Run \`agentspeak join <invite>\` first.`);
+    }
+    const ctx = { baseUrl: state.baseUrl, token: state.coordinatorToken };
+    const wait = opts.waitSeconds ?? 5;
+    const poll = await pollMyTurn(ctx, meetingId, state.agentId, wait);
+    if (poll.status === 204 || !poll.envelope) {
+        process.stderr.write(`[agentspeak] handle-turn: no turn currently assigned (waited ${wait}s); exiting cleanly\n`);
+        return 0;
+    }
+    const envelope = poll.envelope;
+    const turnNumber = typeof envelope.turnNumber === 'number' ? envelope.turnNumber : -1;
+    const taskId = typeof envelope.taskId === 'string' ? envelope.taskId : '';
+    process.stdout.write(`[agentspeak] handle-turn: ${meetingId} turn ${turnNumber} — running shim\n`);
+    const hb = startHeartbeat(ctx, meetingId, state.agentId, turnNumber);
+    let shim;
+    try {
+        shim = await runShim(opts.exec, envelope, {
+            timeoutMs: opts.shimTimeoutMs ?? 600_000,
+        });
+    }
+    finally {
+        hb.stop();
+    }
+    if (shim.exitCode !== 0) {
+        await api.post(ctx, `/api/meetings/${meetingId}/submit`, {
+            agentId: state.agentId,
+            taskId,
+            turnNumber,
+            status: 'failed',
+            artifacts: [
+                {
+                    type: 'text',
+                    contentType: 'text/plain',
+                    content: `shim exited ${shim.exitCode}`,
+                },
+            ],
+        });
+        return shim.exitCode;
+    }
+    const rawContent = shim.stdout.trim() || '(empty response)';
+    // Allow the shim to declaratively mark the turn as the closing one
+    // by emitting an HTML comment marker anywhere in its output. This
+    // keeps the shim contract pure stdout (no extra channels) while
+    // making it trivial to express "this is the done turn" from a one-
+    // line bash echo. We strip the marker before submitting so the
+    // transcript artifact stays clean.
+    const SIGNAL_DONE_MARKER = /<!--\s*agentspeak:signal=done\s*-->/i;
+    const isDone = SIGNAL_DONE_MARKER.test(rawContent);
+    const content = rawContent.replace(SIGNAL_DONE_MARKER, '').trim() || rawContent;
+    await api.post(ctx, `/api/meetings/${meetingId}/submit`, {
+        agentId: state.agentId,
+        taskId,
+        turnNumber,
+        status: 'completed',
+        executionTimeMs: shim.durationMs,
+        signal: isDone ? 'done' : undefined,
+        artifacts: [
+            {
+                type: 'text',
+                contentType: 'text/markdown',
+                content,
+            },
+        ],
+    });
+    process.stdout.write(`[agentspeak] handle-turn: submitted turn ${turnNumber} (${shim.durationMs}ms)\n`);
+    return 0;
+}
+//# sourceMappingURL=handle-turn.js.map

package/dist/commands/handle-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-turn.js","sourceRoot":"","sources":["../../src/commands/handle-turn.ts"],"names":[],"mappings":"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"}

package/dist/commands/join.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `agentspeak join INVITE_URL` (T2).
+ *
+ * Resolves the base URL + invite token from any of:
+ *   - https://<host>/i/<token>
+ *   - https://<host>/s/<token>.md
+ *   - bare <token>  (requires --base-url or AGENTSPEAK_BASE_URL)
+ *
+ * Calls POST /api/meetings/<meetingId>/join with X-Invite-Token. To
+ * discover meetingId from a token we first GET /s/<token>.md and parse
+ * the contextualized skill (cheap; one HTTP call).
+ *
+ * Persists per-meeting state so subsequent `agentspeak handle-turn`
+ * runs need only the meeting id (or default to the most recent join).
+ */
+export interface JoinOpts {
+    invite: string;
+    baseUrl?: string;
+    role?: string;
+    json?: boolean;
+}
+export declare function cmdJoin(opts: JoinOpts): Promise<{
+    meetingId: string;
+    agentId: string;
+}>;
+//# sourceMappingURL=join.d.ts.map

package/dist/commands/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../src/commands/join.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAiED,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE7F"}

package/dist/commands/join.js

@@ -0,0 +1,101 @@
+import { loadIdentity, saveIdentity, saveMeeting } from '../state.js';
+import { cmdRegister } from './register.js';
+import { cmdTutorial } from './tutorial.js';
+function parseInvite(input, fallbackBase) {
+    if (/^https?:\/\//.test(input)) {
+        const u = new URL(input);
+        const m = u.pathname.match(/^\/(?:i|s)\/([^/]+?)(?:\.md)?\/?$/);
+        if (!m)
+            throw new Error(`URL does not look like an AgentSpeak invite: ${input}`);
+        return { baseUrl: `${u.protocol}//${u.host}`, token: m[1] };
+    }
+    if (!fallbackBase) {
+        throw new Error('Bare invite token requires --base-url or AGENTSPEAK_BASE_URL.');
+    }
+    return { baseUrl: fallbackBase.replace(/\/+$/, ''), token: input };
+}
+async function tryJoin(baseUrl, meetingId, inviteToken, identity, role) {
+    return fetch(`${baseUrl}/api/meetings/${meetingId}/join`, {
+        method: 'POST',
+        headers: {
+            'content-type': 'application/json',
+            authorization: `Bearer ${identity.coordinatorToken}`,
+            'x-invite-token': inviteToken,
+        },
+        body: JSON.stringify({ agentId: identity.agentId, role }),
+    });
+}
+async function discoverMeetingFromInvite(baseUrl, token) {
+    // /s/{token}.md returns markdown with meeting metadata in the header.
+    const res = await fetch(`${baseUrl}/s/${token}.md`, {
+        headers: { accept: 'text/markdown' },
+    });
+    const body = await res.text();
+    if (!res.ok) {
+        throw new Error(`Failed to resolve invite ${token}: ${res.status} ${body.slice(0, 200)}`);
+    }
+    // Look for `meetingId: meet_xxx` in the markdown body. The
+    // contextualized skill template renders this verbatim.
+    const idMatch = body.match(/meet[_\-A-Za-z0-9]+/);
+    const titleMatch = body.match(/^title:\s*(.+)$/m) ?? body.match(/^#\s*Join.*?["“]([^"”]+)["”]/m);
+    if (!idMatch) {
+        throw new Error('Could not find a meeting id in the invite skill. Are you sure this is a join invite (not a create invite)?');
+    }
+    return {
+        meetingId: idMatch[0],
+        meetingTitle: titleMatch?.[1]?.trim(),
+    };
+}
+export async function cmdJoin(opts) {
+    let identity = loadIdentity();
+    const fallbackBase = opts.baseUrl ?? identity?.baseUrl ?? process.env.AGENTSPEAK_BASE_URL;
+    const parsed = parseInvite(opts.invite, fallbackBase);
+    // Auto-register if we don't have an identity for this base URL.
+    if (!identity || identity.baseUrl !== parsed.baseUrl) {
+        process.stderr.write(`[agentspeak] no identity for ${parsed.baseUrl}; auto-registering...\n`);
+        identity = await cmdRegister({ baseUrl: parsed.baseUrl, json: false });
+    }
+    const meeting = await discoverMeetingFromInvite(parsed.baseUrl, parsed.token);
+    let r = await tryJoin(parsed.baseUrl, meeting.meetingId, parsed.token, identity, opts.role);
+    // Server returns 403 tutorial_required when this agent has never
+    // passed the onboarding tutorial. Run it inline and retry once so
+    // the human only ever has to invoke `agentspeak join`.
+    if (r.status === 403) {
+        const text = await r.clone().text();
+        if (text.includes('tutorial_required')) {
+            process.stderr.write('[agentspeak] join blocked: tutorial required.\n' +
+                '[agentspeak] running `agentspeak tutorial` inline; this is a one-time setup.\n');
+            const code = await cmdTutorial({ selfAck: true, json: false });
+            if (code !== 0) {
+                throw new Error(`tutorial failed (exit ${code}); join aborted`);
+            }
+            r = await tryJoin(parsed.baseUrl, meeting.meetingId, parsed.token, identity, opts.role);
+        }
+    }
+    const text = await r.text();
+    if (!r.ok) {
+        throw new Error(`Join failed: ${r.status} ${text}`);
+    }
+    const joinRes = JSON.parse(text);
+    saveMeeting({
+        baseUrl: parsed.baseUrl,
+        meetingId: meeting.meetingId,
+        meetingTitle: meeting.meetingTitle,
+        agentId: identity.agentId,
+        coordinatorToken: identity.coordinatorToken,
+        joinedAt: new Date().toISOString(),
+    });
+    // Update identity in case base URL was just learned.
+    saveIdentity(identity);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ ok: true, ...joinRes }, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(`Joined ${meeting.meetingTitle ?? meeting.meetingId} as ${identity.agentId} (role=${joinRes.role}).\n` +
+            `Dashboard: ${parsed.baseUrl}/meetings/${meeting.meetingId}\n` +
+            '\nWhen the coordinator wakes you (push transport), run:\n' +
+            `  agentspeak handle-turn --meeting ${meeting.meetingId} --exec ./reply.sh\n`);
+    }
+    return { meetingId: meeting.meetingId, agentId: identity.agentId };
+}
+//# sourceMappingURL=join.js.map

package/dist/commands/join.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.js","sourceRoot":"","sources":["../../src/commands/join.ts"],"names":[],"mappings":"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"}

package/dist/commands/meeting.d.ts

@@ -0,0 +1,17 @@
+import type { Parsed } from '../cli.js';
+/**
+ * `agentspeak meeting <subcommand>` — organizer surface.
+ *
+ * Replaces the curl-heavy "construct CreateMeetingRequest by hand" flow
+ * with a small CLI on top of POST /api/meetings, POST /invites, and
+ * GET /status. Defaults are deliberately opinionated (consensus, 20 turns,
+ * 30min timeout) so the common case is a one-liner:
+ *
+ *   agentspeak meeting create --title "Sync" --invite hermes,openclaw
+ *
+ * Each --invite name becomes a freshly-minted invite with that persona;
+ * the CLI prints the join URLs you can paste straight into Discord / a
+ * shell.
+ */
+export declare function cmdMeeting(parsed: Parsed): Promise<number>;
+//# sourceMappingURL=meeting.d.ts.map