mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-11-17 19:59:33 +01:00
A coordinator can leave text for a worker without typing into its pane. - Store (src/web/agent-inbox.ts): read until ack by id, seen only for the receiver, 16 KiB/message, 512 KiB + 200 messages per inbox, full = 409 CONFLICT (never drops the oldest), 12 h TTL from each message's createdAt. - Routes (routes/inbox-routes.ts): POST/GET /api/sessions/:id/inbox (?wait= parks while nothing is unseen), POST .../inbox/ack (receiver only, 403 otherwise), GET /api/agent-inbox/summary (owner-scoped counts, not in toState()). Caller = resolveParentSessionId(). - Inbox waiters are the wait registry's third kind: same caps, ended by cancelAll/cancelEverything. - Opt-in snapshot (agentInboxPersistEnabled, synced, default off): agent-inbox.json via dataPath(), 0600 tmp+rename, off deletes it, boot prune only after a successful restore. Dropped on delete, kept on detach. - CLI: codeman agent post | inbox [--wait] | ack, INBOX column in ls. - waitCapacityResponse/abortOnClientHangUp moved to route-helpers.ts unchanged. - Docs: api-reference, README, CLAUDE.md, architecture-invariants, skill + plugin mirror. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
81 lines
3.2 KiB
TypeScript
81 lines
3.2 KiB
TypeScript
/**
|
|
* @fileoverview How server.ts treats the agent inbox across a session's lifecycle.
|
|
*
|
|
* - Delete (`killMux=true`) drops the inbox; detach and shutdown (`killMux=false`)
|
|
* keep it, because a detached session comes back.
|
|
* - Boot pruning of orphaned inboxes runs only after a successful restore, and keeps
|
|
* every session state.json still holds. A failed restore leaves all mail alone.
|
|
*
|
|
* Uses a bare `WebServer.prototype` object with just the fields these paths touch,
|
|
* like tab-layout-restore-gate.test.ts.
|
|
*/
|
|
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
|
|
import { WebServer } from '../src/web/server.js';
|
|
import { agentInbox } from '../src/web/agent-inbox.js';
|
|
|
|
type CleanupServer = {
|
|
_doCleanupSession(sessionId: string, killMux: boolean, reason?: string): Promise<void>;
|
|
finalizeRestoredState(restored: boolean): Promise<void>;
|
|
[key: string]: unknown;
|
|
};
|
|
|
|
function bareServer(live: string[] = [], persisted: string[] = []): CleanupServer {
|
|
const server = Object.create(WebServer.prototype) as CleanupServer;
|
|
Object.assign(server, {
|
|
sessions: new Map(live.map((id) => [id, {}])),
|
|
keepWarmService: { remove: () => {} },
|
|
store: {
|
|
getSession: () => null,
|
|
getSessions: () => Object.fromEntries(persisted.map((id) => [id, {}])),
|
|
removeRalphState: () => {},
|
|
},
|
|
tabLayouts: {
|
|
markRestorationComplete: () => {},
|
|
markRestorationFailed: () => {},
|
|
reconcileAfterRestoration: async () => {},
|
|
},
|
|
cleanupStaleSessions: async () => 0,
|
|
_customModelDisplacedNotified: new Set(),
|
|
respawnControllers: new Map(),
|
|
respawnTimers: new Map(),
|
|
pendingRespawnStarts: new Map(),
|
|
runSummaryTrackers: new Map(),
|
|
stopTranscriptWatcher: () => {},
|
|
persistDeb: { cancelKey: () => {} },
|
|
sse: { cleanupSessionBatches: () => {} },
|
|
broadcast: () => {},
|
|
});
|
|
return server;
|
|
}
|
|
|
|
describe('agent inbox server wiring', () => {
|
|
beforeEach(() => agentInbox.resetForTests());
|
|
afterEach(() => agentInbox.resetForTests());
|
|
|
|
it('a delete drops the inbox; a detach (killMux=false) keeps it', async () => {
|
|
const server = bareServer();
|
|
agentInbox.post('detached', null, 'still here after detach');
|
|
agentInbox.post('deleted', null, 'gone with the session');
|
|
await server._doCleanupSession('detached', false, 'test');
|
|
await server._doCleanupSession('deleted', true, 'test');
|
|
expect(agentInbox.pendingCount('detached')).toBe(1);
|
|
expect(agentInbox.pendingCount('deleted')).toBe(0);
|
|
});
|
|
|
|
it('a failed restore prunes nothing', async () => {
|
|
const server = bareServer();
|
|
agentInbox.post('not-restored', null, 'm');
|
|
await server.finalizeRestoredState(false);
|
|
expect(agentInbox.pendingCount('not-restored')).toBe(1);
|
|
});
|
|
|
|
it('a successful restore prunes orphans and keeps live and persisted sessions', async () => {
|
|
const server = bareServer(['live'], ['kept-for-recovery']);
|
|
for (const id of ['live', 'kept-for-recovery', 'orphan']) agentInbox.post(id, null, 'm');
|
|
await server.finalizeRestoredState(true);
|
|
expect(agentInbox.pendingCount('live')).toBe(1);
|
|
expect(agentInbox.pendingCount('kept-for-recovery')).toBe(1);
|
|
expect(agentInbox.pendingCount('orphan')).toBe(0);
|
|
});
|
|
});
|