agentspeak-cli 0.1.0

package/dist/commands/tutorial.js

@@ -0,0 +1,267 @@
+import { api, ApiError, pollMyTurn } from '../api.js';
+import { runShim } from '../exec.js';
+import { detectRuntime, renderRootSkill, renderStepSkill } from '../skill-template.js';
+import { loadIdentity, saveMeeting } from '../state.js';
+const FALLBACK_CONTINUE_BODY = `# Tutorial reply (CLI fallback)
+
+This text was emitted by the AgentSpeak CLI's safe-default body because
+the candidate did not pass --exec ./reply.sh. Real bots should always
+supply --exec so their own runtime composes the reply.
+
+Confirming end-to-end:
+- Wake delivered via push, ack returned.
+- Turn envelope fetched and parsed.
+- About to close the meeting with signal: done.
+`;
+const FALLBACK_DONE_BODY = `# Tutorial done (CLI fallback)
+
+Closing on the candidate's behalf. The next time you run the tutorial,
+pass --exec ./reply.sh so your runtime authors this message.
+
+<!-- agentspeak:signal=done -->
+`;
+const STEP_COUNT = 9;
+export async function cmdTutorial(opts) {
+    const identity = loadIdentity();
+    if (!identity) {
+        throw new Error('No identity. Run `agentspeak register --base-url <url> --name <name>` first.');
+    }
+    const ctx = { baseUrl: identity.baseUrl, token: identity.coordinatorToken };
+    const log = (msg) => process.stdout.write(`[tutorial] ${msg}\n`);
+    const runtime = detectRuntime();
+    log('Starting tutorial...');
+    log('AgentSpeak NEVER asks for or stores your LLM API key.');
+    log('Conversational turns are generated by YOUR runtime via --exec ./reply.sh.');
+    const start = await api.post(ctx, '/api/onboarding/tutorial/start', {});
+    if (start.alreadyPassed) {
+        process.stdout.write(`Already certified.\n` +
+            `  Agent:        ${start.agentId}\n` +
+            `  Certificate:  ${start.certificateId ?? 'n/a'}\n` +
+            `  Passed at:    ${start.tutorialPassedAt ?? 'n/a'}\n` +
+            `  Wake p50:     ${start.tutorialWakeP50Ms ?? 'n/a'} ms\n`);
+        return 0;
+    }
+    const meetingId = start.meetingId;
+    log(`Tutorial meeting: ${meetingId} (dashboard: ${start.dashboardUrl})`);
+    saveMeeting({
+        baseUrl: identity.baseUrl,
+        meetingId,
+        meetingTitle: 'Onboarding tutorial',
+        agentId: identity.agentId,
+        coordinatorToken: identity.coordinatorToken,
+        joinedAt: new Date().toISOString(),
+    });
+    log(`Step 1/${STEP_COUNT}: skills-check`);
+    await safeStep(() => api.post(ctx, '/api/onboarding/tutorial/skills-check', {
+        meetingId,
+        cliVersion: CLI_VERSION,
+        cachedSkillVersions: {},
+    }));
+    log('  ok');
+    emitSkillHint('stale_skill_check', runtime);
+    log(`Step 2/${STEP_COUNT}: wake-choice`);
+    await safeStep(() => api.post(ctx, '/api/onboarding/tutorial/wake-choice', { meetingId }));
+    log('  ok');
+    emitSkillHint('wake_choice', runtime);
+    log(`Step 3/${STEP_COUNT}: wake-test (server is firing a real push to your transport)`);
+    const wt = await safeStep(() => api.post(ctx, '/api/onboarding/tutorial/wake-test', { meetingId }));
+    log(`  push sent via ${wt.transport}; ack within deadline ${new Date(wt.deadlineMs).toISOString()}`);
+    if (opts.selfAck !== false) {
+        log('  self-acking on behalf of your bot (pass --no-self-ack to require external ack)');
+        const ack = await fetch(wt.ackUrl, { method: 'POST' });
+        const ackBody = await ack.text();
+        if (!ack.ok) {
+            throw new Error(`wake-test self-ack failed: ${ack.status} ${ackBody.slice(0, 200)}`);
+        }
+        log(`  ack ok: ${ackBody.slice(0, 120)}`);
+    }
+    else {
+        log('  --no-self-ack: waiting up to 60s for an external ack...');
+        await sleep(60_000);
+    }
+    emitSkillHint('wake_test', runtime);
+    log(`Step 4/${STEP_COUNT}: read-status (proving GET /api/meetings/<id>/status works)`);
+    await safeStep(() => api.get(ctx, `/api/meetings/${meetingId}/status`));
+    await safeStep(() => api.post(ctx, '/api/onboarding/tutorial/read-status', { meetingId }));
+    log('  ok');
+    emitSkillHint('read_status', runtime);
+    log(`Step 5/${STEP_COUNT}: substantive continue turn (your runtime generates the reply)`);
+    if (!opts.exec) {
+        log('  WARNING: no --exec supplied; using CLI fallback body. Real bots should pass --exec ./reply.sh.');
+    }
+    await runConversationalTurn(ctx, meetingId, identity.agentId, opts.exec, FALLBACK_CONTINUE_BODY, false);
+    log('  continue submitted; tutor will auto-reply server-side');
+    emitSkillHint('turn_continue', runtime);
+    log(`Step 6/${STEP_COUNT}: closing done turn (reply shim emits signal=done marker)`);
+    await sleep(500);
+    await runConversationalTurn(ctx, meetingId, identity.agentId, opts.exec, FALLBACK_DONE_BODY, true);
+    log('  done submitted');
+    emitSkillHint('turn_done', runtime);
+    if (opts.skipOrganizerCheck) {
+        log(`Step 7/${STEP_COUNT}: organizer-check SKIPPED via --skip-organizer-check`);
+    }
+    else {
+        log(`Step 7/${STEP_COUNT}: organizer-check (dry-run a CreateMeetingRequest)`);
+        await safeStep(() => api.post(ctx, '/api/onboarding/tutorial/organizer-check', {
+            meetingId,
+            payload: organizerSamplePayload(identity.agentId),
+        }));
+        log('  ok');
+        emitSkillHint('organizer_dryrun', runtime);
+    }
+    log(`Step 8/${STEP_COUNT}: consolidate as SKILL.md (the omnibus root skill)`);
+    emitRootSkill(runtime);
+    if (opts.autoSaveAck !== false) {
+        log('  auto-acking save-skill (pass --no-auto-save-ack to require manual ack)');
+        await safeStep(() => api.post(ctx, '/api/onboarding/tutorial/save-skill-ack', {
+            meetingId,
+            runtime,
+            skillPath: renderRootSkill(runtime).path,
+            consolidated: ['agentspeak'],
+        }));
+        log('  ack ok');
+    }
+    else {
+        log('  waiting up to 30s for the candidate to POST /save-skill-ack itself...');
+        await sleep(30_000);
+    }
+    log(`Step 9/${STEP_COUNT}: finish (server validates every step and mints certificate)`);
+    const result = await api.post(ctx, '/api/onboarding/tutorial/finish', {
+        meetingId,
+    });
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(`\nTutorial PASSED for ${result.agentId}\n` +
+            `  Certificate:  ${result.certificateId}\n` +
+            `  Passed at:    ${result.tutorialPassedAt}\n` +
+            `  Wake p50:     ${result.tutorialWakeP50Ms ?? 'n/a'} ms\n\n` +
+            'Per-step status:\n' +
+            result.steps
+                .map((s) => `  - ${s.ok ? 'ok ' : 'FAIL'} ${s.id} (${s.title})` +
+                (s.ms != null ? ` [${s.ms}ms]` : ''))
+                .join('\n') +
+            '\n\n' +
+            'You can now join real meetings:\n' +
+            '  npx -y agentspeak join <invite-url>\n' +
+            '\n' +
+            'And create meetings:\n' +
+            '  npx -y agentspeak meeting create --title "Sync" --invite alice,bob\n');
+    }
+    return 0;
+}
+function emitSkillHint(stepId, runtime) {
+    const block = renderStepSkill(stepId, runtime);
+    if (!block)
+        return;
+    process.stdout.write(`\n[skill-hint] You just performed step "${stepId}".\n` +
+        `[skill-hint] NOW save it as a SKILL.md so your runtime auto-loads it next time:\n` +
+        `[skill-hint]   path: ${block.path}\n` +
+        `[skill-hint] Run THIS exact command (it creates the dir, writes the file, then cats it back):\n\n` +
+        block.saveCommand +
+        '\n\n');
+}
+function emitRootSkill(runtime) {
+    const block = renderRootSkill(runtime);
+    process.stdout.write(`\n[skill-hint] FINAL CONSOLIDATION — write the omnibus AgentSpeak root skill:\n` +
+        `[skill-hint]   path: ${block.path}\n\n` +
+        block.saveCommand +
+        '\n\n' +
+        `[skill-hint] After saving, your runtime will auto-load this on next start and\n` +
+        `[skill-hint] match it for any AgentSpeak request (join, create, handle-turn, ...).\n\n`);
+}
+async function runConversationalTurn(ctx, meetingId, agentId, exec, fallbackBody, expectDone) {
+    const poll = await pollMyTurn(ctx, meetingId, agentId, 25);
+    if (poll.status === 204 || !poll.envelope) {
+        throw new Error(`No turn assigned for ${agentId} in ${meetingId} after a 25s long-poll. ` +
+            'The tutor may not have replied yet, or the meeting state is unexpected.');
+    }
+    const env = poll.envelope;
+    const taskId = typeof env.taskId === 'string' ? env.taskId : '';
+    const turnNumber = typeof env.turnNumber === 'number' ? env.turnNumber : -1;
+    let body;
+    let signal;
+    let executionTimeMs;
+    if (exec) {
+        const shim = await runShim(exec, poll.envelope, { timeoutMs: 600_000 });
+        if (shim.exitCode !== 0) {
+            throw new Error(`reply shim exited ${shim.exitCode}; aborting tutorial`);
+        }
+        const SIGNAL_DONE_MARKER = /<!--\s*agentspeak:signal=done\s*-->/i;
+        const raw = shim.stdout.trim() || '(empty response)';
+        const isDone = SIGNAL_DONE_MARKER.test(raw);
+        body = raw.replace(SIGNAL_DONE_MARKER, '').trim() || raw;
+        signal = isDone ? 'done' : undefined;
+        executionTimeMs = shim.durationMs;
+        if (expectDone && !isDone) {
+            process.stderr.write('[tutorial] WARNING: shim did not emit `<!-- agentspeak:signal=done -->` on the closing turn; ' +
+                'submitting with signal=done anyway to advance the tutorial.\n');
+            signal = 'done';
+        }
+    }
+    else {
+        body = fallbackBody;
+        signal = expectDone ? 'done' : undefined;
+    }
+    await api.post(ctx, `/api/meetings/${meetingId}/submit`, {
+        agentId,
+        taskId,
+        turnNumber,
+        status: 'completed',
+        signal,
+        executionTimeMs,
+        artifacts: [{ type: 'text', contentType: 'text/markdown', content: body }],
+    });
+}
+function organizerSamplePayload(organizerAgentId) {
+    // A minimal-but-valid CreateMeetingRequest. The /organizer-check route
+    // runs CreateMeetingRequestSchema.safeParse on this; if the candidate
+    // wants to test their own draft they can run
+    // `agentspeak meeting create --dry-run ...` instead.
+    return {
+        title: 'Tutorial dry-run',
+        context: {
+            objective: 'Tutorial dry-run: prove the candidate can construct a valid CreateMeetingRequest.',
+            participant_roles: { [organizerAgentId]: 'arbiter' },
+            success_criteria: [
+                {
+                    label: 'Schema validates',
+                    criteria: 'CreateMeetingRequestSchema.safeParse returns success.',
+                    weight: 1,
+                    is_blocking: true,
+                    verifiable_by: 'agent_attested',
+                },
+            ],
+        },
+        allowOpenJoin: false,
+    };
+}
+async function safeStep(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            let parsed = null;
+            try {
+                parsed = JSON.parse(err.body);
+            }
+            catch {
+                // body wasn't JSON
+            }
+            if (parsed?.message) {
+                process.stderr.write(`\n[tutorial] step failed (HTTP ${err.status}): ${parsed.message}\n`);
+                if (parsed.details) {
+                    process.stderr.write(`[tutorial] details: ${JSON.stringify(parsed.details, null, 2)}\n`);
+                }
+            }
+        }
+        throw err;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+const CLI_VERSION = '0.1.0';
+//# sourceMappingURL=tutorial.js.map

package/dist/commands/tutorial.js.map

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

package/dist/commands/wake-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `agentspeak wake-config` (T2 + T1).
+ *
+ * One-shot wrapper around PUT/GET/DELETE /api/agents/me/wake-config.
+ * Lets bots register their preferred push channel without anyone having
+ * to write a custom curl invocation.
+ *
+ * Two ways to set:
+ *   - `agentspeak wake-config set ./wake.json` — read JSON file verbatim.
+ *   - `agentspeak wake-config set --transport <t> [transport-specific flags]`
+ *     where the flags map directly to the WakeConfig schema fields. We
+ *     prefer the flag form for the canonical onboarding flow because it
+ *     means the user never has to manually craft JSON.
+ */
+export type WakeAction = 'get' | 'set' | 'clear';
+export declare function cmdWakeConfig(action: WakeAction, configFile: string | undefined, flags?: Record<string, string | boolean>): Promise<void>;
+//# sourceMappingURL=wake-config.d.ts.map

package/dist/commands/wake-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake-config.d.ts","sourceRoot":"","sources":["../../src/commands/wake-config.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;AAgCjD,wBAAsB,aAAa,CACjC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAM,GAC3C,OAAO,CAAC,IAAI,CAAC,CAoCf"}

package/dist/commands/wake-config.js

@@ -0,0 +1,118 @@
+import { readFileSync } from 'node:fs';
+import { api } from '../api.js';
+import { flagStr } from '../cli.js';
+import { loadIdentity } from '../state.js';
+const HELP = `agentspeak wake-config <action> [args]
+
+Actions:
+  get                                  Print current wake config (or null).
+  clear                                Remove the wake config.
+  set <file.json>                      Set from a JSON file.
+  set --transport <transport> ...      Set from flags (preferred).
+
+Flag-based set (transport-specific):
+
+  discord_webhook (recommended):
+    --transport discord_webhook \\
+    --webhook-url https://discord.com/api/webhooks/.../... \\
+    --user-id 1234567890 \\
+    [--username "AgentSpeak"]
+
+  http_webhook:
+    --transport http_webhook \\
+    --url https://my-bot.example/agentspeak/wake \\
+    [--secret <hmac-secret>] [--signing-header X-Signature]
+
+  openclaw_webhook:
+    --transport openclaw_webhook \\
+    --url https://openclaw-router.example/discord/wake \\
+    --secret <shared-secret> [--bot-name agentspeak]
+
+  none:
+    --transport none
+`;
+export async function cmdWakeConfig(action, configFile, flags = {}) {
+    const identity = loadIdentity();
+    if (!identity) {
+        throw new Error('No identity. Run `agentspeak register --base-url <url>` or `agentspeak join <invite>` first.');
+    }
+    const ctx = { baseUrl: identity.baseUrl, token: identity.coordinatorToken };
+    if (action === 'get') {
+        const cur = await api.get(ctx, '/api/agents/me/wake-config');
+        process.stdout.write(JSON.stringify(cur, null, 2) + '\n');
+        return;
+    }
+    if (action === 'clear') {
+        const r = await fetch(`${ctx.baseUrl}/api/agents/me/wake-config`, {
+            method: 'DELETE',
+            headers: { authorization: `Bearer ${ctx.token}` },
+        });
+        if (!r.ok)
+            throw new Error(`clear failed: ${r.status} ${await r.text()}`);
+        process.stdout.write('Wake config cleared.\n');
+        return;
+    }
+    if (action === 'set') {
+        const body = configFile && !configFile.startsWith('--')
+            ? JSON.parse(readFileSync(configFile, 'utf8'))
+            : buildBodyFromFlags(flags);
+        const r = await api.put(ctx, '/api/agents/me/wake-config', body);
+        process.stdout.write(JSON.stringify(r, null, 2) + '\n');
+        return;
+    }
+    if (action === 'help' || action === '--help') {
+        process.stdout.write(HELP);
+        return;
+    }
+    throw new Error(`unknown wake-config action: ${action}\n${HELP}`);
+}
+function buildBodyFromFlags(flags) {
+    const transport = flagStr(flags, 'transport');
+    if (!transport) {
+        throw new Error('agentspeak wake-config set: missing --transport (or pass a JSON file)\n' + HELP);
+    }
+    switch (transport) {
+        case 'none':
+            return { transport: 'none' };
+        case 'discord_webhook': {
+            const url = flagStr(flags, 'webhook-url') ?? flagStr(flags, 'url');
+            const userId = flagStr(flags, 'user-id');
+            if (!url || !userId) {
+                throw new Error('discord_webhook requires --webhook-url and --user-id\n' + HELP);
+            }
+            const username = flagStr(flags, 'username');
+            const out = { transport, url, userId };
+            if (username)
+                out.username = username;
+            return out;
+        }
+        case 'http_webhook': {
+            const url = flagStr(flags, 'url');
+            if (!url)
+                throw new Error('http_webhook requires --url\n' + HELP);
+            const secret = flagStr(flags, 'secret');
+            const signingHeader = flagStr(flags, 'signing-header');
+            const out = { transport, url };
+            if (secret)
+                out.secret = secret;
+            if (signingHeader)
+                out.signingHeader = signingHeader;
+            return out;
+        }
+        case 'openclaw_webhook': {
+            const url = flagStr(flags, 'url');
+            const secret = flagStr(flags, 'secret');
+            if (!url || !secret) {
+                throw new Error('openclaw_webhook requires --url and --secret\n' + HELP);
+            }
+            const botName = flagStr(flags, 'bot-name');
+            const out = { transport, url, secret };
+            if (botName)
+                out.botName = botName;
+            return out;
+        }
+        default:
+            throw new Error(`Unsupported transport "${transport}". Use one of: discord_webhook, http_webhook, openclaw_webhook, none.\n${HELP}`);
+    }
+}
+//# sourceMappingURL=wake-config.js.map

package/dist/commands/wake-config.js.map

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

package/dist/exec.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Run a user-supplied command with the turn envelope on stdin and
+ * collect stdout as the LLM response (T2).
+ *
+ * Why exec a shim instead of calling the LLM directly: every team uses
+ * a different inference stack (Anthropic, OpenAI, vLLM, Ollama, custom
+ * proxies, in-process Claude Code subagents). The CLI's job is to own
+ * the meeting protocol, not the inference. The shim is one short bash
+ * file the operator already maintains.
+ *
+ * Stderr passes through unchanged so users can see their LLM client's
+ * own logs in real time.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+}
+export declare function runShim(command: string, envelope: unknown, opts?: {
+    timeoutMs?: number;
+    env?: Record<string, string>;
+}): Promise<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAO,GAC9D,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

package/dist/exec.js

@@ -0,0 +1,33 @@
+import { spawn } from 'node:child_process';
+export async function runShim(command, envelope, opts = {}) {
+    const start = Date.now();
+    const proc = spawn(command, {
+        shell: true,
+        env: { ...process.env, ...opts.env },
+        stdio: ['pipe', 'pipe', 'inherit'],
+    });
+    let stdout = '';
+    proc.stdout.on('data', (chunk) => {
+        stdout += chunk.toString('utf8');
+    });
+    proc.stdin.write(JSON.stringify(envelope));
+    proc.stdin.end();
+    const timer = opts.timeoutMs
+        ? setTimeout(() => {
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch {
+                // ignore
+            }
+        }, opts.timeoutMs)
+        : null;
+    const exitCode = await new Promise((resolve) => {
+        proc.on('exit', (code) => resolve(code ?? 1));
+        proc.on('error', () => resolve(1));
+    });
+    if (timer)
+        clearTimeout(timer);
+    return { stdout, stderr: '', exitCode, durationMs: Date.now() - start };
+}
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAuB3C,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,QAAiB,EACjB,OAA6D,EAAE;IAE/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE;QAC1B,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;QACpC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;KACnC,CAAC,CAAC;IAEH,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;QACvC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS;QAC1B,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC;QACpB,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrD,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,IAAI,KAAK;QAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;AAC1E,CAAC"}

package/dist/heartbeat.d.ts

@@ -0,0 +1,16 @@
+import { type ApiCtx } from './api.js';
+/**
+ * Background heartbeat (T2).
+ *
+ * Fires every `intervalMs` while the user's reply shim is running. The
+ * server extends the turn lease by 60s per beat, so long LLM calls
+ * (tool use, deep reasoning) never trip the ghost-detection timeout.
+ *
+ * Best-effort: errors are logged to stderr and swallowed. The shim
+ * keeps running.
+ */
+export interface HeartbeatHandle {
+    stop: () => void;
+}
+export declare function startHeartbeat(ctx: ApiCtx, meetingId: string, agentId: string, turnNumber: number, intervalMs?: number, note?: string): HeartbeatHandle;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;GASG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,SAAS,EACnB,IAAI,GAAE,MAAmB,GACxB,eAAe,CAyBjB"}

package/dist/heartbeat.js

@@ -0,0 +1,28 @@
+import { api } from './api.js';
+export function startHeartbeat(ctx, meetingId, agentId, turnNumber, intervalMs = 10_000, note = 'thinking') {
+    let stopped = false;
+    const tick = async () => {
+        if (stopped)
+            return;
+        try {
+            await api.post(ctx, `/api/meetings/${meetingId}/heartbeat`, {
+                agentId,
+                turnNumber,
+                note,
+            });
+        }
+        catch (err) {
+            process.stderr.write(`[agentspeak] heartbeat failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    };
+    const handle = setInterval(() => void tick(), intervalMs);
+    // Fire one immediately so the lease is locked in early.
+    void tick();
+    return {
+        stop: () => {
+            stopped = true;
+            clearInterval(handle);
+        },
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../src/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAe,MAAM,UAAU,CAAC;AAiB5C,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,SAAiB,EACjB,OAAe,EACf,UAAkB,EAClB,UAAU,GAAG,MAAM,EACnB,OAAe,UAAU;IAEzB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,OAAO;YAAE,OAAO;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,SAAS,YAAY,EAAE;gBAC1D,OAAO;gBACP,UAAU;gBACV,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACvF,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1D,wDAAwD;IACxD,KAAK,IAAI,EAAE,CAAC;IACZ,OAAO;QACL,IAAI,EAAE,GAAG,EAAE;YACT,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}