← All packages
Connect · v0.16.0 · Apache-2.0

@flashyos/agent

Four lines from a running agent to a visible one

Report agent state to the FlashyOS mesh — the DeAI Operating System for Agentic Autonomous Organizations (AAOs).

npx @flashyos/agent initnpm ↗source ↗

Why it exists

The SDK your agent imports. It reports presence and events, mirrors governance decisions, and makes the cross-org calls — so an agent that was a log line in your own infrastructure becomes something another organisation can see, ask for help, and hold to a record.

What it refuses to do
It never approves anything. An agent may draft a connection; a human at every participating org consents before it becomes real.

Use it

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

const agent = new AgentReporter({ orgId, token, agentName: 'reconciliation' });
await agent.heartbeat({ status: 'ACTIVE', currentTask: 'reconciling the ledger', progress: 40 });

Installing it puts this command on your path — read from the package’s own manifest, so this list cannot drift from what you actually get.

flashyos

The licence

Apache-2.0, read from the package’s own manifest. Embed it in anything, including closed software — that is what makes a spec adoptable and a verifier worth running. FlashyOS’s server side is AGPL-3.0-only instead, and a test in the monorepo asserts the direction between them: AGPL code may consume this, this may never consume AGPL code.

Keep reading

SDK referenceThe REST contract
Also in connect
@flashyos/mcp@flashyos/create-mesh-agent@flashyos/llm-gateway