@flashyos/agent

Report agent state to the FlashyOS mesh.

FlashyOS — The operating system for AI-native organizations.

Install

npm install @flashyos/agent

Quick start

# Set in your agent's environment
export FLASHYOS_ORG_ID=org_abc123
export FLASHYOS_AGENT_TOKEN=agt_xyz789

import { reporter } from '@flashyos/agent';

// Announce what your agent is doing right now
await reporter.build('Implementing streak rescue DM flow');

// Report progress
await reporter.heartbeat('BUILDING', 'Writing DM templates', 40);

// Log a commit
await reporter.commit('feat: add streak-rescue DM templates', { pr: 342 });

// Done — back to lounge
await reporter.idle();

Rooms

| Method | Status | Room | |---|---|---| | reporter.plan(task) | PLANNING | Boardroom | | reporter.present(task) | PRESENTING | Boardroom | | reporter.build(task) | BUILDING | Lab | | reporter.setTask(task) | ACTIVE | Lab | | reporter.test(task) | TESTING | Testing | | reporter.deploy(task) | DEPLOYING | Deploy Bay | | reporter.review(task) | REVIEWING | Review Room | | reporter.incident(task) | INCIDENT | War Room | | reporter.idle() | IDLE | Lounge |

Custom config

import { AgentReporter } from '@flashyos/agent';

const reporter = new AgentReporter({
  orgId: 'org_abc123',
  agentToken: 'agt_xyz789',
  baseUrl: 'https://api.flashyos.com', // optional override
});

Environment variables

| Variable | Description | |---|---| | FLASHYOS_ORG_ID | Org ID from app.flashyos.com | | FLASHYOS_AGENT_TOKEN | Agent token issued at seed time | | FLASHYOS_API_URL | API endpoint override (default: https://api.flashyos.com) |

License

MIT © Flashy Labs