agentspeak-cli 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"meeting.d.ts","sourceRoot":"","sources":["../../src/commands/meeting.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AA8BxC;;;;;;;;;;;;;GAaG;AAEH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBhE"}

package/dist/commands/meeting.js

@@ -0,0 +1,251 @@
+import { api, ApiError } from '../api.js';
+import { loadIdentity } from '../state.js';
+import { flagBool, flagNum, flagStr } 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 async function cmdMeeting(parsed) {
+    const sub = parsed.positionals[0];
+    if (!sub || sub === 'help' || sub === '--help') {
+        process.stdout.write(SUB_HELP);
+        return 0;
+    }
+    switch (sub) {
+        case 'create':
+            return cmdMeetingCreate(parsed);
+        case 'invite':
+            return cmdMeetingInvite(parsed);
+        case 'status':
+            return cmdMeetingStatus(parsed);
+        default:
+            process.stderr.write(`agentspeak meeting: unknown subcommand "${sub}"\n${SUB_HELP}`);
+            return 2;
+    }
+}
+const SUB_HELP = `agentspeak meeting <subcommand>
+
+  create   Create a meeting and (optionally) mint invites in one go.
+  invite   Mint a single invite for an existing meeting.
+  status   Print a meeting's current status (turns, participants, transcript).
+
+EXAMPLES
+  agentspeak meeting create --title "Sync" --invite hermes,openclaw
+  agentspeak meeting create --title "Plan" --objective "Design v2 launch" \\
+    --decision arbiter --max-turns 30
+  # Practice without writing to the DB (validates schema only):
+  agentspeak meeting create --dry-run --title "Sync" --invite alice,bob
+  agentspeak meeting invite meet_xyz --persona "The seller" --max-uses 1
+  agentspeak meeting status meet_xyz
+`;
+function ctx() {
+    const id = loadIdentity();
+    if (!id) {
+        throw new Error('No identity. Run `agentspeak register --base-url <url> --name <name>` first.');
+    }
+    return { baseUrl: id.baseUrl, token: id.coordinatorToken, organizerAgentId: id.agentId };
+}
+function csv(s) {
+    if (!s)
+        return [];
+    return s
+        .split(',')
+        .map((p) => p.trim())
+        .filter((p) => p.length > 0);
+}
+async function cmdMeetingCreate(parsed) {
+    const c = ctx();
+    const title = flagStr(parsed.flags, 'title');
+    if (!title) {
+        process.stderr.write('agentspeak meeting create: --title is required\n');
+        return 2;
+    }
+    const objective = flagStr(parsed.flags, 'objective') ?? `Discuss: ${title}`;
+    const maxTurns = flagNum(parsed.flags, 'max-turns') ?? 20;
+    const timeoutSeconds = flagNum(parsed.flags, 'timeout-seconds') ?? 1800;
+    const decision = flagStr(parsed.flags, 'decision') ?? 'consensus';
+    const closeAfterN = flagNum(parsed.flags, 'close-after-silence') ?? null;
+    const inviteNames = csv(flagStr(parsed.flags, 'invite'));
+    const inviteRole = flagStr(parsed.flags, 'invite-role') ?? 'proposer';
+    const json = flagBool(parsed.flags, 'json');
+    const dryRun = flagBool(parsed.flags, 'dry-run');
+    // The organizer is the creator, not a participant — invitees fill the
+    // participant_roles map at join time. Server applies remaining defaults.
+    const meetingContext = {
+        objective,
+        participant_roles: {},
+        decision_authority: decision,
+        max_turns: maxTurns,
+        timeout_seconds: timeoutSeconds,
+        close_after_n_silence_prompts: closeAfterN,
+        success_criteria: [],
+        out_of_scope: [],
+    };
+    if (dryRun) {
+        // Validate via the tutorial dry-run route (CreateMeetingRequestSchema)
+        // without writing to the DB. Useful for practicing the organizer flow
+        // and for the tutorial's organizer_dryrun step.
+        const payload = { title, context: meetingContext, allowOpenJoin: false };
+        // The dry-run route requires meetingId for tutorial bookkeeping. If
+        // we don't have a tutorial meeting in flight, fall back to local
+        // shape printing only.
+        const tutorialMeetingId = flagStr(parsed.flags, 'tutorial-meeting');
+        if (tutorialMeetingId) {
+            const r = await api.post({ baseUrl: c.baseUrl, token: c.token }, '/api/onboarding/tutorial/organizer-check', { meetingId: tutorialMeetingId, payload });
+            if (json) {
+                process.stdout.write(JSON.stringify({ dryRun: true, ...r }, null, 2) + '\n');
+            }
+            else {
+                process.stdout.write('Dry-run validated server-side via /tutorial/organizer-check.\n' +
+                    JSON.stringify(r.normalized, null, 2) +
+                    '\n');
+            }
+            return 0;
+        }
+        if (json) {
+            process.stdout.write(JSON.stringify({ dryRun: true, payload }, null, 2) + '\n');
+        }
+        else {
+            process.stdout.write('--dry-run: would POST /api/meetings with this payload (no DB write):\n' +
+                JSON.stringify(payload, null, 2) +
+                '\n' +
+                'To validate the schema server-side, pass --tutorial-meeting <id> ' +
+                'while inside the onboarding tutorial.\n');
+        }
+        return 0;
+    }
+    const created = await api.post({ baseUrl: c.baseUrl, token: c.token }, '/api/meetings', {
+        title,
+        context: meetingContext,
+        allowOpenJoin: false,
+    });
+    const invites = [];
+    for (const persona of inviteNames) {
+        try {
+            const inv = await api.post({ baseUrl: c.baseUrl, token: c.token }, `/api/meetings/${created.meetingId}/invites`, {
+                role: inviteRole,
+                persona,
+                maxUses: 1,
+                expiresInSeconds: 86_400,
+            });
+            invites.push({
+                persona,
+                inviteUrl: inv.inviteUrl,
+                skillUrl: inv.skillUrl,
+                expiresAt: inv.expiresAt,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`agentspeak meeting create: failed to mint invite for "${persona}": ${msg}\n`);
+        }
+    }
+    if (json) {
+        process.stdout.write(JSON.stringify({ meeting: created, invites }, null, 2) + '\n');
+        return 0;
+    }
+    process.stdout.write(`Meeting created: ${created.meetingId}\n` +
+        `Dashboard:      ${created.dashboardUrl}\n` +
+        `Status:         ${created.status}\n`);
+    if (invites.length) {
+        process.stdout.write('\nInvites (paste these into the agents\u2019 chat):\n');
+        for (const inv of invites) {
+            process.stdout.write(`  - ${inv.persona}\n` +
+                `      Join URL:  ${inv.inviteUrl}\n` +
+                `      Skill URL: ${inv.skillUrl}\n` +
+                `      Expires:   ${inv.expiresAt}\n`);
+        }
+        process.stdout.write('\nIf the agent is already onboarded:\n' +
+            '  agentspeak join <invite-url>\n' +
+            '\nIf the agent has not yet passed the tutorial, `join` will return 403\n' +
+            'tutorial_required and the CLI will run `agentspeak tutorial` automatically.\n');
+    }
+    else {
+        process.stdout.write('\nNo invites minted. Add `--invite alice,bob` next time, or run\n' +
+            `  agentspeak meeting invite ${created.meetingId} --persona alice\n`);
+    }
+    return 0;
+}
+async function cmdMeetingInvite(parsed) {
+    const c = ctx();
+    const meetingId = parsed.positionals[1];
+    if (!meetingId) {
+        process.stderr.write('agentspeak meeting invite: pass <meetingId> as first positional\n');
+        return 2;
+    }
+    const persona = flagStr(parsed.flags, 'persona');
+    const role = flagStr(parsed.flags, 'role');
+    const instructions = flagStr(parsed.flags, 'instructions');
+    const maxUses = flagNum(parsed.flags, 'max-uses') ?? 1;
+    const expiresInSeconds = flagNum(parsed.flags, 'expires-seconds') ?? 86_400;
+    const json = flagBool(parsed.flags, 'json');
+    const inv = await api.post({ baseUrl: c.baseUrl, token: c.token }, `/api/meetings/${meetingId}/invites`, {
+        role,
+        persona,
+        instructions,
+        maxUses,
+        expiresInSeconds,
+    });
+    if (json) {
+        process.stdout.write(JSON.stringify(inv, null, 2) + '\n');
+        return 0;
+    }
+    process.stdout.write(`Invite minted for ${meetingId}\n` +
+        `  Persona:    ${inv.persona ?? '(none)'}\n` +
+        `  Role:       ${inv.role ?? '(default)'}\n` +
+        `  Join URL:   ${inv.inviteUrl}\n` +
+        `  Skill URL:  ${inv.skillUrl}\n` +
+        `  Expires:    ${inv.expiresAt}\n` +
+        `  Max uses:   ${inv.maxUses}\n`);
+    return 0;
+}
+async function cmdMeetingStatus(parsed) {
+    const c = ctx();
+    const meetingId = parsed.positionals[1];
+    if (!meetingId) {
+        process.stderr.write('agentspeak meeting status: pass <meetingId> as first positional\n');
+        return 2;
+    }
+    const json = flagBool(parsed.flags, 'json');
+    const status = await api
+        .get({ baseUrl: c.baseUrl, token: c.token }, `/api/meetings/${meetingId}/status`)
+        .catch((err) => {
+        if (err instanceof ApiError && err.status === 404) {
+            throw new Error(`No meeting ${meetingId} on ${c.baseUrl}`);
+        }
+        throw err;
+    });
+    if (json) {
+        process.stdout.write(JSON.stringify(status, null, 2) + '\n');
+        return 0;
+    }
+    process.stdout.write(`${status.title}\n` +
+        `  ID:           ${status.meetingId}\n` +
+        `  Status:       ${status.status}\n` +
+        `  Turn:         ${status.currentTurn} / ${status.maxTurns}\n` +
+        `  Dashboard:    ${c.baseUrl}/meetings/${status.meetingId}\n\n`);
+    process.stdout.write('Participants:\n');
+    for (const p of status.participants) {
+        process.stdout.write(`  - ${p.name ?? p.agentId} (${p.role}, ${p.status}) ` +
+            `[${p.turnCount} turns, wake=${p.wakeTransport ?? 'none'}]\n`);
+    }
+    process.stdout.write('\nLast 5 turns:\n');
+    for (const t of status.history.slice(-5)) {
+        process.stdout.write(`  #${t.turnNumber} ${t.agentId} ${t.action}` +
+            (t.signal ? ` [${t.signal}]` : '') +
+            (t.completedAt ? ` at ${t.completedAt}` : '') +
+            '\n');
+    }
+    return 0;
+}
+//# sourceMappingURL=meeting.js.map

package/dist/commands/meeting.js.map

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

package/dist/commands/register.d.ts

@@ -0,0 +1,22 @@
+import { type Identity } from '../state.js';
+/**
+ * `agentspeak register` (T2).
+ *
+ * Bootstraps a host-local identity. We submit a deliberately MINIMAL
+ * agent card with skipProbe=true — the CLI is its own gateway, there's
+ * no .well-known/agent.json to probe. The coordinator stores the card,
+ * mints a coordinator token, and we persist both to ~/.agentspeak/identity.json.
+ *
+ * Re-running with the same name + base URL is idempotent: the
+ * coordinator rotates the token and we overwrite identity.json.
+ */
+export interface RegisterOpts {
+    baseUrl: string;
+    name?: string;
+    agentType?: 'hermes' | 'openclaw' | 'generic';
+    /** Provided when the host already has a gateway and wants the coordinator to push to it. */
+    gatewayUrl?: string;
+    json?: boolean;
+}
+export declare function cmdRegister(opts: RegisterOpts): Promise<Identity>;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9C,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqDvE"}

package/dist/commands/register.js

@@ -0,0 +1,49 @@
+import { hostname } from 'node:os';
+import { api } from '../api.js';
+import { saveIdentity } from '../state.js';
+export async function cmdRegister(opts) {
+    const name = opts.name ?? `${hostname()}-cli`;
+    const agentType = opts.agentType ?? 'generic';
+    const gatewayUrl = opts.gatewayUrl ?? 'https://agentspeak.invalid/cli';
+    const stubCard = {
+        schemaVersion: '1.0',
+        agentId: `agent_pending_${Date.now().toString(36)}`,
+        agentType,
+        name,
+        version: 'cli-0.1',
+        url: gatewayUrl,
+        capabilities: {
+            supportsPush: false,
+            supportsPoll: true,
+            supportsStreaming: false,
+            maxConcurrentTasks: 1,
+            maxResponseChars: 16000,
+        },
+        authSchemes: [{ scheme: 'bearer', headerName: 'Authorization', tokenPrefix: 'Bearer ' }],
+        endpoints: { takeTurn: '/agentspeak/take_turn' },
+        description: 'AgentSpeak CLI — long-poll loop, no inbound HTTP gateway.',
+    };
+    const res = await api.post({ baseUrl: opts.baseUrl, token: '' }, '/api/agents/register', {
+        agentCard: stubCard,
+        skipProbe: true,
+    });
+    const identity = {
+        baseUrl: opts.baseUrl,
+        agentId: res.agentId,
+        coordinatorToken: res.coordinatorToken,
+        name,
+        agentType,
+        registeredAt: res.createdAt,
+    };
+    saveIdentity(identity);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify({ ok: true, identity }, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(`Registered ${name} as ${res.agentId} on ${opts.baseUrl}\n` +
+            `Identity saved to ~/.agentspeak/identity.json (chmod 600).\n` +
+            `Coordinator token: ${res.coordinatorToken.slice(0, 12)}... (full token in identity.json)\n`);
+    }
+    return identity;
+}
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,YAAY,EAAiB,MAAM,aAAa,CAAC;AAuB1D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,QAAQ,EAAE,MAAM,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,gCAAgC,CAAC;IAEvE,MAAM,QAAQ,GAAG;QACf,aAAa,EAAE,KAAc;QAC7B,OAAO,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;QACnD,SAAS;QACT,IAAI;QACJ,OAAO,EAAE,SAAS;QAClB,GAAG,EAAE,UAAU;QACf,YAAY,EAAE;YACZ,YAAY,EAAE,KAAK;YACnB,YAAY,EAAE,IAAI;YAClB,iBAAiB,EAAE,KAAK;YACxB,kBAAkB,EAAE,CAAC;YACrB,gBAAgB,EAAE,KAAK;SACxB;QACD,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACxF,SAAS,EAAE,EAAE,QAAQ,EAAE,uBAAuB,EAAE;QAChD,WAAW,EAAE,2DAA2D;KACzE,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAIvB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,sBAAsB,EAAE;QAC/D,SAAS,EAAE,QAAQ;QACnB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAa;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,IAAI;QACJ,SAAS;QACT,YAAY,EAAE,GAAG,CAAC,SAAS;KAC5B,CAAC;IACF,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEvB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,cAAc,IAAI,OAAO,GAAG,CAAC,OAAO,OAAO,IAAI,CAAC,OAAO,IAAI;YACzD,8DAA8D;YAC9D,sBAAsB,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,qCAAqC,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/commands/tutorial.d.ts

@@ -0,0 +1,61 @@
+/**
+ * `agentspeak tutorial` — runs the mandatory onboarding tutorial AND
+ * teaches the candidate the canonical workflow as a side-effect.
+ *
+ * Two design constraints shape this command:
+ *
+ *   1. We never see, ask for, or store the candidate's LLM API key.
+ *      The reply text for every conversational turn is generated by
+ *      the candidate's own runtime via the `--exec ./reply.sh` shim.
+ *      A safe default body is supplied only when the candidate has
+ *      no shim ready yet, with a loud warning that real bots should
+ *      always supply --exec.
+ *
+ *   2. After every successful step we print the SKILL.md snippet that
+ *      captures what the agent just learned, plus the literal mkdir
+ *      + heredoc command to persist it to the runtime's skills cache.
+ *      This is the "consolidation" moment — episodic memory is fresh,
+ *      and the snippet is small enough that the candidate can copy-
+ *      paste-and-cat it without ambiguity. Research shows imperative,
+ *      verifiable phrasing (mkdir + cat > + cat <path>) dramatically
+ *      improves the chance the agent actually persists the file vs.
+ *      acknowledging the suggestion.
+ *
+ * Steps run in order:
+ *   1. /tutorial/start              — create or resume tutorial meeting.
+ *   2. /tutorial/skills-check       — CLI + cached skills are current.
+ *   3. /tutorial/wake-choice        — wake_config picks a real push transport.
+ *   4. /tutorial/wake-test          — server fires synthetic push; CLI acks.
+ *   5. /tutorial/read-status        — candidate fetches GET /status.
+ *   6. continue turn (handle-turn)  — runtime generates reply via --exec.
+ *   7. done turn (handle-turn)      — runtime closes via signal=done marker.
+ *   8. /tutorial/organizer-check    — dry-run of CreateMeetingRequest.
+ *   9. /tutorial/save-skill-ack     — candidate acks consolidation hint.
+ *   10. /tutorial/finish            — server validates and mints certificate.
+ */
+export interface TutorialOpts {
+    /**
+     * If true (default), the CLI auto-acknowledges the wake test on the
+     * candidate's behalf. Set false to require the bot to drive the
+     * tutorial end-to-end without CLI assistance.
+     */
+    selfAck?: boolean;
+    /**
+     * Path to the reply shim used for the conversational turns. If
+     * omitted we fall back to a deterministic safe-default body and
+     * print a loud warning. Every production bot should pass --exec.
+     */
+    exec?: string;
+    /**
+     * If true, the CLI calls /save-skill-ack automatically after
+     * printing the SKILL.md hints. If false, the candidate must POST
+     * the ack themselves (proves the agent can drive the consolidation
+     * step end-to-end).
+     */
+    autoSaveAck?: boolean;
+    /** Skip the organizer dry-run step (rare; mostly for tests). */
+    skipOrganizerCheck?: boolean;
+    json?: boolean;
+}
+export declare function cmdTutorial(opts: TutorialOpts): Promise<number>;
+//# sourceMappingURL=tutorial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial.d.ts","sourceRoot":"","sources":["../../src/commands/tutorial.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAmDD,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAkKrE"}