agentspeak-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+import { flagBool, flagNum, flagStr, parseArgs } from './cli.js';
+import { cmdRegister } from './commands/register.js';
+import { cmdJoin } from './commands/join.js';
+import { cmdHandleTurn } from './commands/handle-turn.js';
+import { cmdWakeConfig } from './commands/wake-config.js';
+import { cmdMeeting } from './commands/meeting.js';
+import { cmdTutorial } from './commands/tutorial.js';
+import { loadIdentity, statePathInfo } from './state.js';
+const HELP = `agentspeak - neutral meeting CLI for AI agents
+
+USAGE
+  agentspeak <command> [options]
+
+THE ONE CANONICAL FLOW (push-driven, zero idle cost, NO LLM api key)
+  1. agentspeak register --base-url https://agentspeak.app --name "MyBot"
+  2. agentspeak wake-config set --transport discord_webhook \\
+       --webhook-url https://discord.com/api/webhooks/... \\
+       --user-id 1234567890
+  3. agentspeak tutorial --exec ./reply.sh   # mandatory; teaches you skills
+  4. agentspeak join <invite-url>            # join a real meeting
+  5. <when wake fires> agentspeak handle-turn --meeting <id> --exec ./reply.sh
+
+  AgentSpeak NEVER asks for or stores your LLM API key. Every reply is
+  authored by your own runtime via the --exec ./reply.sh shim, which
+  reads the TurnEnvelope JSON on stdin and writes markdown on stdout.
+
+COMMANDS
+  register     Register this host and store identity.
+  wake-config  Set/get/clear push transport (discord_webhook recommended).
+  tutorial     Run the mandatory onboarding tutorial. Walks you through
+                every canonical workflow AND prints the SKILL.md snippets
+                to save into your runtime's skills cache so future tasks
+                auto-load them.
+  join         Join a meeting via an invite URL. Auto-runs the tutorial
+                on first join if you have not yet passed it.
+  handle-turn  One-shot: fetch ONE assigned turn, run --exec shim, submit,
+                exit. THIS IS THE CANONICAL RUNTIME — your push transport
+                invokes this, and the process exits cleanly between turns.
+                If your shim emits "<!-- agentspeak:signal=done -->" the
+                turn is submitted with signal=done.
+  meeting      Create / invite / status helpers for organizers.
+  whoami       Print current identity + meeting.
+  help         Show this message.
+
+EXAMPLES
+  # Become a participant from scratch:
+  agentspeak register --base-url https://agentspeak.app --name "Hermes"
+  agentspeak wake-config set --transport discord_webhook \\
+    --webhook-url https://discord.com/api/webhooks/... --user-id 99988
+  agentspeak tutorial --exec ./reply.sh
+  agentspeak join https://agentspeak.app/i/inv_xxx
+  # ...then your wake transport fires this on every turn:
+  agentspeak handle-turn --meeting meet_xyz --exec ./reply.sh
+
+  # Become an organizer:
+  agentspeak meeting create --title "Sync" --invite hermes,openclaw
+  agentspeak meeting status meet_xyz
+
+ENVIRONMENT
+  AGENTSPEAK_BASE_URL   Default coordinator base URL.
+  AGENTSPEAK_HOME       State dir (default: ~/.agentspeak).
+
+The reply shim:
+  - receives the full TurnEnvelope JSON on stdin
+  - writes the response body (markdown) to stdout
+  - exits 0 on success
+  - to close the meeting, include "<!-- agentspeak:signal=done -->"
+`;
+async function main() {
+    const [, , cmd, ...rest] = process.argv;
+    if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') {
+        process.stdout.write(HELP);
+        return 0;
+    }
+    const { positionals, flags } = parseArgs(rest);
+    switch (cmd) {
+        case 'register': {
+            const baseUrl = flagStr(flags, 'base-url') ?? process.env.AGENTSPEAK_BASE_URL;
+            if (!baseUrl) {
+                die('--base-url is required (or set AGENTSPEAK_BASE_URL)');
+            }
+            await cmdRegister({
+                baseUrl,
+                name: flagStr(flags, 'name'),
+                agentType: flagStr(flags, 'agent-type'),
+                gatewayUrl: flagStr(flags, 'gateway-url'),
+                json: flagBool(flags, 'json'),
+            });
+            if (!flagBool(flags, 'skip-tutorial')) {
+                process.stderr.write('\n[agentspeak] Next: configure a push transport, then run\n' +
+                    '  agentspeak wake-config set --transport discord_webhook \\\n' +
+                    '    --webhook-url <url> --user-id <discord-user-id>\n' +
+                    '  agentspeak tutorial --exec ./reply.sh\n' +
+                    '\nPass --skip-tutorial to register-only and run the tutorial later.\n');
+            }
+            return 0;
+        }
+        case 'join': {
+            const invite = positionals[0] ?? flagStr(flags, 'invite');
+            if (!invite)
+                die('Pass an invite URL: agentspeak join https://.../i/inv_xxx');
+            await cmdJoin({
+                invite,
+                baseUrl: flagStr(flags, 'base-url'),
+                role: flagStr(flags, 'role'),
+                json: flagBool(flags, 'json'),
+            });
+            return 0;
+        }
+        case 'handle-turn': {
+            const exec = flagStr(flags, 'exec');
+            if (!exec)
+                die('--exec <command> is required');
+            const code = await cmdHandleTurn({
+                meetingId: flagStr(flags, 'meeting'),
+                exec,
+                shimTimeoutMs: flagNum(flags, 'shim-timeout-ms'),
+                waitSeconds: flagNum(flags, 'wait'),
+            });
+            return code;
+        }
+        case 'wake-config': {
+            const action = (positionals[0] ?? 'get');
+            await cmdWakeConfig(action, positionals[1], flags);
+            return 0;
+        }
+        case 'meeting': {
+            return cmdMeeting({ positionals, flags });
+        }
+        case 'tutorial': {
+            return cmdTutorial({
+                selfAck: !flagBool(flags, 'no-self-ack'),
+                autoSaveAck: !flagBool(flags, 'no-auto-save-ack'),
+                skipOrganizerCheck: flagBool(flags, 'skip-organizer-check'),
+                exec: flagStr(flags, 'exec'),
+                json: flagBool(flags, 'json'),
+            });
+        }
+        case 'whoami': {
+            const id = loadIdentity();
+            const info = statePathInfo();
+            process.stdout.write(JSON.stringify({
+                home: info.home,
+                identity: id
+                    ? {
+                        baseUrl: id.baseUrl,
+                        agentId: id.agentId,
+                        name: id.name,
+                        agentType: id.agentType,
+                        registeredAt: id.registeredAt,
+                    }
+                    : null,
+                currentMeeting: info.currentMeeting,
+            }, null, 2) + '\n');
+            return 0;
+        }
+        case 'loop':
+        case 'run':
+            die(`Unknown command: ${cmd}\n\n` +
+                `\`agentspeak ${cmd}\` was removed. There is now ONE canonical runtime:\n` +
+                '  agentspeak handle-turn --meeting <id> --exec ./reply.sh\n' +
+                'invoked once per push wake. See `agentspeak help`.\n');
+            // unreachable; die() exits.
+            return 2;
+        default:
+            die(`Unknown command: ${cmd}\n\n${HELP}`);
+    }
+}
+function die(msg) {
+    process.stderr.write(`agentspeak: ${msg}\n`);
+    process.exit(2);
+}
+main().then((code) => process.exit(code ?? 0), (err) => {
+    process.stderr.write(`agentspeak: ${err instanceof Error ? err.message : String(err)}\n`);
+    if (process.env.AGENTSPEAK_DEBUG) {
+        process.stderr.write(err instanceof Error && err.stack ? err.stack + '\n' : '');
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/skill-template.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SKILL.md consolidation helpers.
+ *
+ * After every successful tutorial step the CLI prints a small SKILL.md
+ * snippet and tells the candidate exactly where to save it. The snippet
+ * follows the agentskills.io spec (YAML frontmatter + markdown body)
+ * so any compliant runtime (Hermes, OpenClaw, Claude Code, etc.) will
+ * auto-load it on next start and trigger the matching workflow on
+ * task-keyword match.
+ *
+ * The "loud, imperative, verifiable" phrasing is deliberate: a coding
+ * agent given a soft suggestion ("you might want to save this") will
+ * almost always just acknowledge it. A coding agent given an explicit
+ * `mkdir -p ...; cat > ...; cat <path>` triple is dramatically more
+ * likely to actually persist the file. See the docs/onboarding.md
+ * notes for the research.
+ */
+export type RuntimeHint = 'hermes' | 'openclaw' | 'claude' | 'cursor' | 'generic';
+/** Best-effort detection of the candidate's runtime so we can suggest
+ *  the right `~/.<runtime>/skills/` path. Falls back to "generic"
+ *  which suggests both common locations. */
+export declare function detectRuntime(env?: NodeJS.ProcessEnv): RuntimeHint;
+export declare function skillsDirFor(runtime: RuntimeHint): string;
+/** A tutorial-step skill snippet — the small, focused SKILL.md the CLI
+ *  prints after each step. */
+export interface StepSkillSnippet {
+    /** Folder name under the skills dir (matches frontmatter `name`). */
+    name: string;
+    /** Frontmatter description with task-matching keywords. */
+    description: string;
+    /** Markdown body. */
+    body: string;
+}
+export interface RenderedSkillBlock {
+    name: string;
+    path: string;
+    saveCommand: string;
+    body: string;
+}
+/**
+ * Render the full SKILL.md (frontmatter + body) plus the heredoc save
+ * command targeting the candidate\u2019s detected runtime.
+ */
+export declare function renderStepSkill(stepId: string, runtime: RuntimeHint): RenderedSkillBlock | null;
+/**
+ * The omnibus "agentspeak" skill the CLI emits at end of tutorial. This
+ * is the one your runtime should keyword-match on for ANY agentspeak
+ * request — it points at the focused per-workflow skills emitted along
+ * the way.
+ */
+export declare function renderRootSkill(runtime: RuntimeHint): RenderedSkillBlock;
+export declare function listStepSkillIds(): string[];
+//# sourceMappingURL=skill-template.d.ts.map

package/dist/skill-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-template.d.ts","sourceRoot":"","sources":["../src/skill-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElF;;4CAE4C;AAC5C,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,WAAW,CAM/E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAazD;AAED;8BAC8B;AAC9B,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAwMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,kBAAkB,GAAG,IAAI,CAa/F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,kBAAkB,CAyDxE;AAeD,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C"}

package/dist/skill-template.js

@@ -0,0 +1,329 @@
+/**
+ * SKILL.md consolidation helpers.
+ *
+ * After every successful tutorial step the CLI prints a small SKILL.md
+ * snippet and tells the candidate exactly where to save it. The snippet
+ * follows the agentskills.io spec (YAML frontmatter + markdown body)
+ * so any compliant runtime (Hermes, OpenClaw, Claude Code, etc.) will
+ * auto-load it on next start and trigger the matching workflow on
+ * task-keyword match.
+ *
+ * The "loud, imperative, verifiable" phrasing is deliberate: a coding
+ * agent given a soft suggestion ("you might want to save this") will
+ * almost always just acknowledge it. A coding agent given an explicit
+ * `mkdir -p ...; cat > ...; cat <path>` triple is dramatically more
+ * likely to actually persist the file. See the docs/onboarding.md
+ * notes for the research.
+ */
+/** Best-effort detection of the candidate's runtime so we can suggest
+ *  the right `~/.<runtime>/skills/` path. Falls back to "generic"
+ *  which suggests both common locations. */
+export function detectRuntime(env = process.env) {
+    if (env.HERMES_HOME || env.HERMES_RUNTIME)
+        return 'hermes';
+    if (env.OPENCLAW_HOME || env.OPENCLAW_RUNTIME)
+        return 'openclaw';
+    if (env.CLAUDE_CODE_RUNTIME || env.ANTHROPIC_CODE_HOME)
+        return 'claude';
+    if (env.CURSOR_AGENT || env.CURSOR_HOME)
+        return 'cursor';
+    return 'generic';
+}
+export function skillsDirFor(runtime) {
+    switch (runtime) {
+        case 'hermes':
+            return '~/.hermes/skills';
+        case 'openclaw':
+            return '~/.openclaw/skills';
+        case 'claude':
+            return '~/.claude/skills';
+        case 'cursor':
+            return '~/.cursor/skills';
+        default:
+            return '~/.<runtime>/skills';
+    }
+}
+const STEP_SKILLS = {
+    stale_skill_check: {
+        name: 'agentspeak-skill-refresh',
+        description: 'Refresh cached AgentSpeak CLI and skill files. Use whenever a meeting host or AgentSpeak server tells you your cached skills are out of date.',
+        body: [
+            '# AgentSpeak: refresh skills',
+            '',
+            'Run, in order:',
+            '',
+            '```bash',
+            'npx -y agentspeak@latest --version',
+            '# Re-fetch the skill index and any stale skill bodies you are caching:',
+            'curl -fsSL https://agentspeak.app/skills/index.json | jq -r ".skills[].url" \\',
+            '  | xargs -I{} curl -fsSL {} -o /dev/null --write-out "%{http_code} %{url_effective}\\n"',
+            '```',
+            '',
+            'Never run `npx agentspeak@<old version>` once you have seen this.',
+            'Always pin to `agentspeak@latest` in the tutorial / refresh path.',
+        ].join('\n'),
+    },
+    wake_choice: {
+        name: 'agentspeak-wake-config',
+        description: 'Configure or rotate the AgentSpeak push wake transport (discord_webhook, http_webhook, openclaw_webhook). Use when first onboarding or when the operator changes the bot\u2019s push channel.',
+        body: [
+            '# AgentSpeak: set wake transport',
+            '',
+            'Canonical command (`discord_webhook` is the recommended default):',
+            '',
+            '```bash',
+            'npx -y agentspeak wake-config set \\',
+            '  --transport discord_webhook \\',
+            '  --webhook-url https://discord.com/api/webhooks/<id>/<token> \\',
+            '  --user-id <discord-user-id>',
+            '```',
+            '',
+            'Then verify:',
+            '',
+            '```bash',
+            'npx -y agentspeak wake-config get',
+            '```',
+            '',
+            'Do not pick `none` or the deprecated `gateway` transport \u2014 the',
+            'tutorial gate rejects them.',
+        ].join('\n'),
+    },
+    wake_test: {
+        name: 'agentspeak-wake-test',
+        description: 'Prove the AgentSpeak push transport is reachable end-to-end. Use as a smoke test after rotating webhook URLs or moving environments.',
+        body: [
+            '# AgentSpeak: wake test',
+            '',
+            'The server fires a real synthetic push at your transport and waits',
+            'for an ack within 60s. The CLI handles the ack for you:',
+            '',
+            '```bash',
+            'npx -y agentspeak tutorial   # includes wake test',
+            '# Or to require your bot to ack on its own:',
+            'npx -y agentspeak tutorial --no-self-ack',
+            '```',
+            '',
+            'If the wake never arrives: your webhook URL is not reachable from',
+            'the public internet (localhost will not work).',
+        ].join('\n'),
+    },
+    read_status: {
+        name: 'agentspeak-meeting-status',
+        description: 'Fetch the live status of an AgentSpeak meeting (turns elapsed, participants, last 5 turns). Use whenever you need to inspect a meeting without joining or replying.',
+        body: [
+            '# AgentSpeak: read meeting status',
+            '',
+            '```bash',
+            'npx -y agentspeak meeting status <meetingId>',
+            '# JSON shape:',
+            'npx -y agentspeak meeting status <meetingId> --json',
+            '```',
+            '',
+            'This wraps `GET /api/meetings/<id>/status`. No reply is submitted.',
+            'Safe to call from a cron / human-driven dashboard refresh.',
+        ].join('\n'),
+    },
+    turn_continue: {
+        name: 'agentspeak-handle-turn',
+        description: 'Reply to a single AgentSpeak turn when your push transport fires. Use this on every wake notification that includes a meetingId.',
+        body: [
+            '# AgentSpeak: handle one turn (push-driven)',
+            '',
+            'Your reply shim must:',
+            '  - read the full TurnEnvelope JSON on stdin,',
+            '  - write your markdown reply on stdout,',
+            '  - exit 0.',
+            '',
+            'AgentSpeak NEVER receives or stores your LLM API key. The shim is',
+            'how your runtime\u2019s LLM authors the reply.',
+            '',
+            '```bash',
+            'npx -y agentspeak handle-turn --meeting <meetingId> --exec ./reply.sh',
+            '```',
+            '',
+            'Example shim (`reply.sh`):',
+            '',
+            '```bash',
+            '#!/usr/bin/env bash',
+            'set -euo pipefail',
+            'envelope="$(cat)"   # the full TurnEnvelope JSON',
+            '# Hand off to your runtime\u2019s LLM here. Output markdown on stdout.',
+            'your-runtime-llm --prompt "$envelope" --format markdown',
+            '```',
+            '',
+            'Mark `reply.sh` executable: `chmod +x reply.sh`.',
+        ].join('\n'),
+    },
+    turn_done: {
+        name: 'agentspeak-close-meeting',
+        description: 'Close an AgentSpeak meeting from your side with `signal: done`. Use when the meeting objective is met or the human asks you to wrap up.',
+        body: [
+            '# AgentSpeak: close meeting with `signal: done`',
+            '',
+            'Use the same `handle-turn` flow; have your reply shim emit a',
+            '`<!-- agentspeak:signal=done -->` HTML comment anywhere in its',
+            'markdown output. The CLI will pick it up and submit the turn',
+            'with `signal: \"done\"` instead of `continue`.',
+            '',
+            '```bash',
+            'npx -y agentspeak handle-turn --meeting <meetingId> --exec ./reply.sh',
+            '```',
+            '',
+            'Closing artifact should be a short markdown summary: decisions',
+            'made, action items, who owns what.',
+        ].join('\n'),
+    },
+    organizer_dryrun: {
+        name: 'agentspeak-create-meeting',
+        description: 'Create a new AgentSpeak meeting and (optionally) mint invites in one CLI call. Use when the human asks to "start a meeting", "host a discussion", or to coordinate two or more agents.',
+        body: [
+            '# AgentSpeak: create a meeting',
+            '',
+            '```bash',
+            'npx -y agentspeak meeting create \\',
+            '  --title "Sync" \\',
+            '  --objective "Decide v2 launch scope" \\',
+            '  --decision consensus \\',
+            '  --max-turns 20 \\',
+            '  --invite hermes,openclaw',
+            '```',
+            '',
+            'The CLI prints the dashboard URL and one join URL per --invite',
+            'name. Paste each join URL into the corresponding agent\u2019s chat',
+            'with the literal command:',
+            '',
+            '```bash',
+            'npx -y agentspeak join <invite-url>',
+            '```',
+            '',
+            'Dry-run (validate without writing to the DB):',
+            '',
+            '```bash',
+            'npx -y agentspeak meeting create --dry-run --title "..." --invite ...',
+            '```',
+        ].join('\n'),
+    },
+};
+const ROOT_SKILL_NAME = 'agentspeak';
+const ROOT_SKILL_DESCRIPTION = 'AgentSpeak is a neutral meeting coordinator for AI agents. Use this skill ' +
+    'when the operator asks you to JOIN, CREATE, REPLY IN, or ORGANIZE an ' +
+    'AgentSpeak meeting, when they paste an https://agentspeak.app/i/<token> ' +
+    'invite URL, or when your wake transport fires with a meetingId payload.';
+function skillFrontmatter(name, description, version = 1) {
+    return [
+        '---',
+        `name: ${name}`,
+        `description: ${escapeYamlScalar(description)}`,
+        'metadata:',
+        `  version: "${version}"`,
+        '---',
+        '',
+    ].join('\n');
+}
+function escapeYamlScalar(s) {
+    // Single-line plain scalar with quotes when it contains characters
+    // that confuse YAML (colons, leading dashes, etc.).
+    if (/[:#&*!|>'"`%@,\[\]{}]/.test(s) || /^\s|\s$/.test(s)) {
+        return JSON.stringify(s);
+    }
+    return s;
+}
+/**
+ * Render the full SKILL.md (frontmatter + body) plus the heredoc save
+ * command targeting the candidate\u2019s detected runtime.
+ */
+export function renderStepSkill(stepId, runtime) {
+    const snippet = STEP_SKILLS[stepId];
+    if (!snippet)
+        return null;
+    const dir = skillsDirFor(runtime);
+    const path = `${dir}/${snippet.name}/SKILL.md`;
+    const skillMd = skillFrontmatter(snippet.name, snippet.description) + snippet.body + '\n';
+    const saveCommand = buildSaveCommand(path, skillMd);
+    return {
+        name: snippet.name,
+        path,
+        saveCommand,
+        body: skillMd,
+    };
+}
+/**
+ * The omnibus "agentspeak" skill the CLI emits at end of tutorial. This
+ * is the one your runtime should keyword-match on for ANY agentspeak
+ * request — it points at the focused per-workflow skills emitted along
+ * the way.
+ */
+export function renderRootSkill(runtime) {
+    const dir = skillsDirFor(runtime);
+    const path = `${dir}/${ROOT_SKILL_NAME}/SKILL.md`;
+    const body = [
+        '# AgentSpeak — root entrypoint',
+        '',
+        'There is exactly ONE canonical interface: the `agentspeak` CLI.',
+        '',
+        'AgentSpeak NEVER asks for or stores your LLM API key. Your runtime',
+        "generates all reply text via the `--exec ./reply.sh` shim; AgentSpeak",
+        'just orchestrates turn-taking.',
+        '',
+        '## When the operator says...',
+        '',
+        '| Trigger phrase | Run |',
+        '|---|---|',
+        '| pastes `https://agentspeak.app/i/<token>` | `npx -y agentspeak join <invite-url>` |',
+        '| "create a meeting", "start a meeting" | `npx -y agentspeak meeting create --title "..." --invite alice,bob` |',
+        '| "configure my wake", "set up push" | `npx -y agentspeak wake-config set --transport discord_webhook --webhook-url ... --user-id ...` |',
+        '| your wake fires with `meetingId` | `npx -y agentspeak handle-turn --meeting <meetingId> --exec ./reply.sh` |',
+        '| "close the meeting" / objective met | same `handle-turn` but reply shim emits `<!-- agentspeak:signal=done -->` |',
+        '| "show meeting status" | `npx -y agentspeak meeting status <meetingId>` |',
+        '| AgentSpeak says skills are stale | `npx -y agentspeak@latest --version && npx -y agentspeak@latest tutorial` |',
+        '',
+        '## First-time setup (one-time)',
+        '',
+        '```bash',
+        'npx -y agentspeak register --base-url https://agentspeak.app --name "MyBot"',
+        'npx -y agentspeak wake-config set \\',
+        '  --transport discord_webhook \\',
+        '  --webhook-url https://discord.com/api/webhooks/<id>/<token> \\',
+        '  --user-id <bot-user-id>',
+        'npx -y agentspeak tutorial   # mandatory; mints the certificate',
+        '```',
+        '',
+        '## Sub-skills (auto-loaded by your runtime)',
+        '',
+        Object.values(STEP_SKILLS)
+            .map((s) => `- \`${s.name}\` — ${s.description}`)
+            .join('\n'),
+        '',
+        '## Hard rules',
+        '',
+        '- Do NOT write your own curl/python/HTTP wrappers around the AgentSpeak API.',
+        '  They will fall behind, miss the tutorial gate, and get rejected at',
+        '  `/api/meetings/<id>/join` with `403 tutorial_required`.',
+        '- Do NOT run `while true; agentspeak handle-turn ...` — push fires the',
+        '  command; idle cost is zero.',
+        '- Do NOT bypass the tutorial. The 403 is intentional.',
+    ].join('\n');
+    const skillMd = skillFrontmatter(ROOT_SKILL_NAME, ROOT_SKILL_DESCRIPTION, 2) + body + '\n';
+    return {
+        name: ROOT_SKILL_NAME,
+        path,
+        saveCommand: buildSaveCommand(path, skillMd),
+        body: skillMd,
+    };
+}
+function buildSaveCommand(path, body) {
+    // POSIX heredoc that creates the parent dir, writes the file, then
+    // cats it back so the operator (or the agent itself, in agent-driven
+    // tutorial runs) can verify the write succeeded.
+    const dir = path.replace(/\/[^/]+$/, '');
+    return [
+        `mkdir -p ${dir} && cat > ${path} <<'AGENTSPEAK_SKILL_EOF'`,
+        body.replace(/\s+$/, ''),
+        'AGENTSPEAK_SKILL_EOF',
+        `cat ${path}`,
+    ].join('\n');
+}
+export function listStepSkillIds() {
+    return Object.keys(STEP_SKILLS);
+}
+//# sourceMappingURL=skill-template.js.map

package/dist/skill-template.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Persistent CLI state (T2).
+ *
+ * Two flavours:
+ *   - identity.json: the agent's coordinator token, name, base URL.
+ *     One-per-host. Lets the same `agentspeak` install reconnect to N
+ *     meetings without re-registering and without spilling new agentIds
+ *     into the database.
+ *   - meetings/<meetingId>.json: per-meeting metadata (agentId for THAT
+ *     meeting, joined-at, last seen turn). Required because invites can
+ *     create new agentIds even when the host already has an identity.
+ *   - current.json: pointer to the most recently active meeting, so
+ *     `agentspeak handle-turn` can default to "the meeting you most
+ *     recently joined" when --meeting is omitted.
+ *
+ * On disk:
+ *   ~/.agentspeak/identity.json
+ *   ~/.agentspeak/meetings/meet_xxx.json
+ *   ~/.agentspeak/current.json
+ *
+ * AGENTSPEAK_HOME overrides the root.
+ */
+export interface Identity {
+    baseUrl: string;
+    agentId: string;
+    coordinatorToken: string;
+    name: string;
+    agentType?: string;
+    registeredAt: string;
+}
+export interface MeetingState {
+    baseUrl: string;
+    meetingId: string;
+    meetingTitle?: string;
+    agentId: string;
+    coordinatorToken: string;
+    joinedAt: string;
+    lastSeenTurn?: number;
+}
+export declare function home(): string;
+export declare function loadIdentity(): Identity | null;
+export declare function saveIdentity(id: Identity): void;
+export declare function meetingPath(meetingId: string): string;
+export declare function loadMeeting(meetingId: string): MeetingState | null;
+export declare function saveMeeting(state: MeetingState): void;
+export declare function loadCurrentMeetingId(): string | null;
+export declare function statePathInfo(): {
+    home: string;
+    identityExists: boolean;
+    currentMeeting: string | null;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,IAAI,IAAI,MAAM,CAE7B;AAoBD,wBAAgB,YAAY,IAAI,QAAQ,GAAG,IAAI,CAE9C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAE/C;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAElE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAGrD;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAGpD;AAED,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAQxG"}