Shell
#!/usr/bin/env npx ts-node
/**
* Playwright Coordinator CLI
*
* Usage:
* npx ts-node cli.ts reserve <agent-id> <purpose>
* npx ts-node cli.ts release <agent-id>
* npx ts-node cli.ts share <owner-agent-id> <target-agent-id> [expires-ms]
* npx ts-node cli.ts check <agent-id>
* npx ts-node cli.ts status
* npx ts-node cli.ts heartbeat <agent-id>
* npx ts-node cli.ts cleanup <agent-id>
*/
import {
reserveContext,
releaseContext,
shareContext,
canUseContext,
getStatus,
heartbeat,
forceReleaseAll,
} from './coordinator';
async function main() {
const [, , command, ...args] = process.argv;
if (!command) {
printUsage();
process.exit(1);
}
try {
switch (command) {
case 'reserve': {
const [agentId, ...purposeParts] = args;
const purpose = purposeParts.join(' ') || 'general';
if (!agentId) {
console.error('Error: agent-id required');
process.exit(1);
}
const result = await reserveContext(agentId, purpose);
console.log(JSON.stringify(result, null, 2));
process.exit(result.success ? 0 : 1);
break;
}
case 'release': {
const [agentId] = args;
if (!agentId) {
console.error('Error: agent-id required');
process.exit(1);
}
const result = await releaseContext(agentId);
console.log(JSON.stringify(result, null, 2));
process.exit(result.success ? 0 : 1);
break;
}
case 'share': {
const [ownerAgentId, targetAgentId, expiresMs] = args;
if (!ownerAgentId || !targetAgentId) {
console.error('Error: owner-agent-id and target-agent-id required');
process.exit(1);
}
const result = await shareContext(
ownerAgentId,
targetAgentId,
expiresMs ? parseInt(expiresMs, 10) : undefined
);
console.log(JSON.stringify(result, null, 2));
process.exit(result.success ? 0 : 1);
break;
}
case 'check': {
const [agentId] = args;
if (!agentId) {
console.error('Error: agent-id required');
process.exit(1);
}
const result = await canUseContext(agentId);
console.log(JSON.stringify(result, null, 2));
process.exit(result.canUse ? 0 : 1);
break;
}
case 'status': {
const status = await getStatus();
console.log('\n=== Playwright Pool Status ===\n');
console.log(`Available: ${status.available}`);
console.log(`Reserved: ${status.reserved}`);
console.log(`Shared: ${status.shared}`);
console.log(`Waiting: ${status.waiting}`);
console.log('\n--- Contexts ---');
for (const ctx of status.contexts) {
const icon = ctx.status === 'available' ? 'π’' : ctx.status === 'reserved' ? 'π‘' : 'π΅';
console.log(`${icon} ${ctx.id}: ${ctx.status}${ctx.agentId ? ` (${ctx.agentId})` : ''}`);
if (ctx.purpose) {
console.log(` ββ ${ctx.purpose}`);
}
}
console.log('');
break;
}
case 'heartbeat': {
const [agentId] = args;
if (!agentId) {
console.error('Error: agent-id required');
process.exit(1);
}
const success = await heartbeat(agentId);
console.log(success ? 'OK' : 'No context found');
process.exit(success ? 0 : 1);
break;
}
case 'cleanup': {
const [agentId] = args;
if (!agentId) {
console.error('Error: agent-id required');
process.exit(1);
}
const released = await forceReleaseAll(agentId);
console.log(`Released ${released} context(s)`);
break;
}
default:
console.error(`Unknown command: ${command}`);
printUsage();
process.exit(1);
}
} catch (err) {
console.error('Error:', err instanceof Error ? err.message : err);
process.exit(1);
}
}
function printUsage() {
console.log(`
Playwright Coordinator CLI
Commands:
reserve <agent-id> <purpose> Reserve a browser context
release <agent-id> Release your context back to pool
share <owner> <target> [ms] Share context with another agent
check <agent-id> Check if you can use Playwright
status Show pool status
heartbeat <agent-id> Update activity timestamp
cleanup <agent-id> Force release all for an agent
Examples:
npx ts-node cli.ts reserve agent-123 "Testing checkout flow"
npx ts-node cli.ts status
npx ts-node cli.ts release agent-123
npx ts-node cli.ts share agent-123 agent-456 300000
`);
}
main();