# Naive

> The managed agent for long-horizon work. Runtime, harness, inference, and tools.

- [Naive docs](https://vetta.sh/docs/index.md): The most efficient managed agent for long-horizon work. The highest intelligence per dollar, by design.
- [Naive and Vetta](https://vetta.sh/docs/naive-and-vetta.md): Vetta is the autonomous-company infrastructure; Naive is the blueprints, templates and studio on top of it. Which surface you use for what.
- [Quickstart](https://vetta.sh/docs/quickstart.md): Create an agent, give it work, watch it, and read the meter.
- [How Vetta works](https://vetta.sh/docs/how-vetta-is-built.md): Three layers — harness, tools, runtime — optimised together for cost per finished task.
- [Examples](https://vetta.sh/docs/use-cases.md): Three end-to-end examples of long-horizon work on Vetta.
- [Agent](https://vetta.sh/docs/capabilities/agent.md): Vetta's core primitive — a versioned config of model, harness, prompt, tools, skills, and budget that runs as durable sessions.
- [Computer](https://vetta.sh/docs/capabilities/computer.md): Vetta's own managed sandbox — a disposable Linux micro-VM with a filesystem, a shell, and an optional browser, paused when the agent sleeps.
- [Identity](https://vetta.sh/docs/capabilities/identity.md): An addressable persona an agent acts as: email, phone, social accounts, web domains, third-party connections, and a credential vault.
- [Team](https://vetta.sh/docs/capabilities/team.md): A coordinator agent and a version-pinned roster of specialists, coordinating two ways: point-to-point delegation and a durable shared board.
- [Organizations & members](https://vetta.sh/docs/platform/organizations.md): The organization is the billing entity; users are members.
- [Credits & billing](https://vetta.sh/docs/platform/billing.md): A real US-dollar balance, topped up through the payments provider, metered against vendor cost.
- [Pricing](https://vetta.sh/docs/platform/pricing.md): What you pay, and how the completion window changes it.
- [Agents](https://vetta.sh/docs/concepts/agents.md): A reusable, versioned configuration that defines an agent's persona and capabilities.
- [Runtime & durability](https://vetta.sh/docs/concepts/runtime.md): The runtime is Vetta's infrastructure, not a setting: wake, take one turn, commit, sleep — and idle costs storage.
- [Harnesses](https://vetta.sh/docs/concepts/harnesses.md): The agent loop is one field. Which loop you pick changes how the work is done — and what an idle session costs.
- [Harness capabilities](https://vetta.sh/docs/concepts/harness-capabilities.md): Every harness, and exactly what it can be admitted for: approvals, typed results, streaming deltas, whether the platform's own tools reach the model, and what an idle session holds.
- [Model router & inference](https://vetta.sh/docs/concepts/model-router.md): How Vetta routes each model call to inference — an agent's turn or one you make yourself — what the completion window changes about it, and how model tokens are metered.
- [Model auto-selection](https://vetta.sh/docs/concepts/model-selection.md): Let an evaluation model choose which of your models answers a conversation.
- [Completion window](https://vetta.sh/docs/concepts/completion-window.md): Three prices for one model, chosen per request.
- [Budgets](https://vetta.sh/docs/concepts/budgets.md): Every call is priced before it is made and refused if it would breach the cap.
- [Policies](https://vetta.sh/docs/concepts/policies.md): Governance at the tool-call boundary: per-tool allow / ask / deny, plus connection and primitive scoping.
- [Templates](https://vetta.sh/docs/concepts/templates.md): A template is a crew with a first day and a memory of the business it runs — chosen from a blueprint, provisioned by an apply.
- [Sessions](https://vetta.sh/docs/concepts/sessions.md): A single, directly-controlled run of an agent.
- [Session operations](https://vetta.sh/docs/concepts/session-operations.md): Send input, retrieve, list, interrupt, archive, and delete sessions.
- [Events & streaming](https://vetta.sh/docs/concepts/events-and-streaming.md): The resumable, sequence-keyed event stream behind every session.
- [Skills](https://vetta.sh/docs/capabilities/skills.md): Persisted, versioned expertise loaded with progressive disclosure.
- [Tools, connections & context](https://vetta.sh/docs/capabilities/tools.md): Declare what the agent may use — built-ins, connection tools, and MCP servers — gate each one with a permission, and keep the context window small.
- [Files](https://vetta.sh/docs/capabilities/files.md): Durable, organization-scoped storage for the artifacts a session produces.
- [Structured outputs](https://vetta.sh/docs/capabilities/structured-outputs.md): Constrain a session's final result to a JSON Schema and read it back as typed data — no transcript scraping.
- [Deployments & cron](https://vetta.sh/docs/capabilities/deployments.md): Run an agent on a schedule, then collect the results of every fire.
- [Webhooks](https://vetta.sh/docs/capabilities/webhooks.md): Subscribe to session and message events; receive inbound email and SMS.
- [Observability](https://vetta.sh/docs/capabilities/observability.md): Per-session cost and token usage, a usage event before every idle, and a full trace of every turn, tool call, and model request.
- [Computer](https://vetta.sh/docs/computer/index.md): Vetta's own managed sandbox — a disposable Linux micro-VM with a filesystem, a shell, and an optional browser, paused when the agent sleeps.
- [Sandbox & lifecycle](https://vetta.sh/docs/computer/sandbox.md): Execution modes, provisioned resources, and the running → sleeping → parked → destroyed lifecycle of a computer.
- [Filesystem](https://vetta.sh/docs/computer/filesystem.md): Read, write, list, and manage files on the sandbox disk through five governed operations.
- [Shell](https://vetta.sh/docs/computer/shell.md): The bash tool runs a command in the sandbox and returns buffered stdout, stderr, and an exit code.
- [Browser](https://vetta.sh/docs/computer/browser.md): An optional managed browser attached to the computer — domain-scoped, write-guarded, and driven through high-level actions.
- [Snapshots & volumes](https://vetta.sh/docs/computer/snapshots-and-volumes.md): Checkpoint a running VM, fork new computers from it, and keep disk on a persistent volume across park and sleep.
- [Networking](https://vetta.sh/docs/computer/networking.md): Outbound access from the sandbox, and the coming egress pinning.
- [Limits & billing](https://vetta.sh/docs/computer/limits-and-billing.md): Concurrency caps, runtime ceilings, output limits, and the exact metering model for compute.
- [Identity](https://vetta.sh/docs/identity/overview.md): Named personas an agent acts as: web domains, email, phone, connections, and a credential vault.
- [Personas](https://vetta.sh/docs/identity/personas.md): The identity object: name, description, the endpoints it owns, and how it attaches to agents.
- [Credential vault](https://vetta.sh/docs/identity/vault.md): Secrets injected at the network boundary — the agent never sees raw values.
- [Identity policies](https://vetta.sh/docs/identity/policies.md): Scope which primitives, connections, and tools an identity's agents may use — enforced at the tool-call boundary.
- [Web domains](https://vetta.sh/docs/identity/domains.md): The dual-track domain system: independent email and app verification, three registrar kinds, and the readiness gates email sits on.
- [Email](https://vetta.sh/docs/identity/email.md): Provision inboxes on a verified domain; send credit-checked mail and wake the agent on inbound.
- [Phone](https://vetta.sh/docs/identity/phone.md): Provision numbers on carrier-registered messaging; send and receive SMS.
- [Connections](https://vetta.sh/docs/identity/connections.md): Let an agent act through third-party apps — OAuth or API key — without ever touching the token.
- [Social accounts](https://vetta.sh/docs/identity/social.md): Connect social accounts to a Vetta identity and let its agent publish under policy.
- [Legal](https://vetta.sh/docs/identity/legal.md): Verify the people behind an identity and form a company it can operate as, under policy.
- [Wallet](https://vetta.sh/docs/identity/wallet.md): A custodied, spend-limited wallet an identity carries so its agent can pay for things in the world.
- [Cards](https://vetta.sh/docs/identity/cards.md): Prepaid virtual cards an identity buys with organization credits, with a single audited credential reveal.
- [Inbound events](https://vetta.sh/docs/identity/inbound.md): How inbound email, SMS, and connection webhooks wake a sleeping agent through the durable runtime.
- [Team](https://vetta.sh/docs/team/overview.md): Multiagent orchestration on Vetta: a coordinator agent and a version-pinned roster, coordinating two ways — point-to-point delegation and a durable shared board.
- [Coordinator](https://vetta.sh/docs/team/coordinator.md): Declare a team by adding a multiagent coordinator object and a roster of members to an agent's configuration.
- [Delegation](https://vetta.sh/docs/team/delegation.md): The first of a team's two coordination mechanisms: a point-to-point hand-off through built-in tools, each member running in its own isolated session.
- [Company board](https://vetta.sh/docs/team/board.md): The durable half of a team: one board owned by the coordinator, shared by every agent on its roster, where a card is the hand-over and assigning a card starts the teammate on it.
- [Rosters & versioning](https://vetta.sh/docs/team/rosters-and-versioning.md): How a coordinator's roster is snapshotted and version-pinned, what is checked when you save it, how harnesses mix, and the commands that manage it.
- [Context & budgets](https://vetta.sh/docs/team/context-and-budgets.md): What sessions share, what stays isolated, what a member holds while it runs, how spend flows across a team, and the cross-thread events.
- [API overview](https://vetta.sh/docs/api/overview.md): The Vetta REST API — base URL, versioning, auth, and conventions.
- [Authentication](https://vetta.sh/docs/api/authentication.md): Organization-scoped API keys and the Bearer scheme.
- [Pagination](https://vetta.sh/docs/api/pagination.md): Cursor-based pagination for all list endpoints.
- [Errors](https://vetta.sh/docs/api/errors.md): The typed error envelope and every error code.
- [Agents](https://vetta.sh/docs/api/agents.md): Create, version, run, and inspect reusable agent configurations.
- [Company board](https://vetta.sh/docs/api/board.md): The durable coordination surface of a team: cards and comments on one board owned by the coordinator and shared by its roster.
- [Sessions](https://vetta.sh/docs/api/sessions.md): Directly-controlled runs of an agent.
- [Events](https://vetta.sh/docs/api/events.md): List and stream a session's events, resumable by sequence.
- [Computers](https://vetta.sh/docs/api/computers.md): Sandboxed compute environments with a browser and filesystem.
- [Browser](https://vetta.sh/docs/api/browser.md): Drive a computer's managed browser over REST — actions, session state, saved logins and who may reopen them.
- [Browser sessions](https://vetta.sh/docs/api/browser-sessions.md): The history of managed browsers driven beside a computer, and a view-only live view of one.
- [Skills](https://vetta.sh/docs/api/skills.md): Versioned, org-scoped skills attached to agents.
- [Files](https://vetta.sh/docs/api/files.md): Vetta object storage for uploads, imports and published artifacts — the asset library.
- [Deployments](https://vetta.sh/docs/api/deployments.md): Run an agent on a cron schedule.
- [Webhooks](https://vetta.sh/docs/api/webhooks.md): Outbound webhook endpoints with signed delivery.
- [Harnesses](https://vetta.sh/docs/api/harnesses.md): The agent loops an agent can run on — what each one can be admitted for, and what an idle session on it costs.
- [Models](https://vetta.sh/docs/api/models.md): The model catalogue an agent can run on — read live from the inference network, never a fixed list.
- [Model proxy](https://vetta.sh/docs/api/proxy.md): Point an Anthropic- or OpenAI-compatible SDK at Vetta: your API key, your organization's balance, one rate card.
- [Reviews](https://vetta.sh/docs/api/reviews.md): Record a person's approve, reject or edit of agent work given outside the approval box.
- [MCP server](https://vetta.sh/docs/api/mcp.md): The Vetta API published to a model as an MCP tool catalog, generated from the route table.
- [Organizations](https://vetta.sh/docs/api/organizations.md): The billing entity that owns members, keys, and resources.
- [Credits](https://vetta.sh/docs/api/credits.md): Real-USD balance, metered ledger, and top-ups.
- [Media](https://vetta.sh/docs/api/media.md): Images, video, clips, audio and stock photos — the media routes, the catalogue of models they accept, and the library every result lands in.
- [Images](https://vetta.sh/docs/api/images.md): Generate images over REST — one call, and it waits; every rendered image comes back as a file — and search a licensed stock photo library, free.
- [Video](https://vetta.sh/docs/api/video.md): Generate video over REST — a queued job you read back, with the finished file on it.
- [Clips](https://vetta.sh/docs/api/clips.md): Cut a long video into short, captioned, vertical clips — as a job you submit, poll and collect.
- [Audio](https://vetta.sh/docs/api/audio.md): Speech to text, text to speech and speech to speech — transcribe a recording into a timestamped transcript, turn text into a stored audio file, or answer one spoken turn with another.
- [Apps](https://vetta.sh/docs/api/apps.md): Hosted web applications: provisioning, deployments, secrets, custom domains, the app database, and the app's own MCP endpoint.
- [Storage](https://vetta.sh/docs/api/storage.md): Object storage on a fullstack app: buckets, objects, signed URLs.
- [Database](https://vetta.sh/docs/api/database.md): The managed database of a fullstack app as its own primitive: SQL, the table catalogue, a REST passthrough over every table, and a migration ledger.
- [Audit logs](https://vetta.sh/docs/api/audit-logs.md): A queryable, principal-attributed record of control-plane actions.
- [Identities](https://vetta.sh/docs/api/identities.md): Create and manage the personas an agent acts as — email, phone, web domains, and connections.
- [Domains](https://vetta.sh/docs/api/domains.md): Org-level sending and receiving domains, their DNS records, and the three readiness tracks.
- [Email & SMS](https://vetta.sh/docs/api/messaging.md): Inboxes and phone numbers on an identity, outbound send, and the unified inbound message feed.
- [Connections](https://vetta.sh/docs/api/connections.md): Connected third-party accounts for a persona — auth configs, the Connect Link, and revocation.
- [Social](https://vetta.sh/docs/api/social.md): Identity-scoped social account setup, media publishing, analytics, and comments.
- [Legal](https://vetta.sh/docs/api/legal.md): Identity-owned verification cases and company formations: hosted verification links, formation filing, and documents.
- [Wallet](https://vetta.sh/docs/api/wallet.md): A custodied, spend-limited USDC wallet per identity, and x402 payments for paywalled resources.
- [Cards](https://vetta.sh/docs/api/cards.md): Prepaid virtual cards an identity buys with organization credits, with a single audited credential reveal.
- [Vaults](https://vetta.sh/docs/api/vaults.md): Write-only credential storage, injected at the network boundary — values are never returned.
- [TypeScript SDK](https://vetta.sh/docs/sdk/typescript.md): @usenaive-sdk/vetta — the published typed client for the Vetta API, documented method by method from the source.
- [Errors](https://vetta.sh/docs/sdk/errors.md): ApiError — the one exception the client throws, read straight off the server's envelope.
- [Pagination](https://vetta.sh/docs/sdk/pagination.md): One page envelope on every list method, and no auto-paging iterator — deliberately.
- [Streaming](https://vetta.sh/docs/sdk/streaming.md): client.stream — a resumable async generator over a session's events.
- [agents](https://vetta.sh/docs/sdk/agents.md): Create, version, and retire agents — client.agents, one method per route.
- [harnesses](https://vetta.sh/docs/sdk/harnesses.md): The agent loops you can pick from — client.harnesses.
- [media](https://vetta.sh/docs/sdk/media.md): Image and video generation, the model catalogue, stock photo search, video clipping and the audio routes — client.media.
- [models](https://vetta.sh/docs/sdk/models.md): The model catalogue a caller picks from — client.models.
- [sessions](https://vetta.sh/docs/sdk/sessions.md): Run, steer, budget, and read back a task — client.sessions.
- [board](https://vetta.sh/docs/sdk/board.md): The team board — client.board and client.board.cards.
- [proxy](https://vetta.sh/docs/sdk/proxy.md): One org-level model call, in the Messages or the Chat Completions format — client.proxy.
- [computers](https://vetta.sh/docs/sdk/computers.md): Sandboxed machines — lifecycle, shell, filesystem, snapshots — client.computers.
- [browser](https://vetta.sh/docs/sdk/browser.md): The managed browser on a computer — client.computers.browser(id), client.browser.credentials and client.browser.contexts.
- [browserSessions](https://vetta.sh/docs/sdk/browser-sessions.md): The managed browsers driven beside a computer, and a live view of an active one — client.browserSessions.
- [skills](https://vetta.sh/docs/sdk/skills.md): Content-addressed, versioned instructions — client.skills, including the two distinct pushes.
- [files](https://vetta.sh/docs/sdk/files.md): Upload, import, find, describe and publish artifacts — client.files.
- [apps](https://vetta.sh/docs/sdk/apps.md): Hosted web applications — client.apps.
- [storage](https://vetta.sh/docs/sdk/storage.md): Object storage on a fullstack app — client.storage.
- [database](https://vetta.sh/docs/sdk/database.md): A fullstack app's managed database — client.database.
- [identities](https://vetta.sh/docs/sdk/identities.md): Personas, their endpoints, and the agent grant — client.identities.
- [connections](https://vetta.sh/docs/sdk/connections.md): Third-party account auth for a persona — client.connections.
- [vaults](https://vetta.sh/docs/sdk/vaults.md): Write-only credentials — client.vaults and client.vaults.credentials.
- [domains](https://vetta.sh/docs/sdk/domains.md): Sending and receiving domains — client.domains.
- [emails](https://vetta.sh/docs/sdk/emails.md): Inboxes and outbound mail for a persona — client.emails.
- [phones](https://vetta.sh/docs/sdk/phones.md): Numbers and outbound SMS for a persona — client.phones.
- [Social](https://vetta.sh/docs/sdk/social.md): Activate identity-owned social accounts and publish text posts with the TypeScript SDK.
- [Legal](https://vetta.sh/docs/sdk/legal.md): Verify a persona's people and form a company with the TypeScript SDK.
- [Wallet](https://vetta.sh/docs/sdk/wallet.md): Provision and cap a persona's wallet and pay for paywalled resources with the TypeScript SDK.
- [Cards](https://vetta.sh/docs/sdk/cards.md): Buy prepaid virtual cards for a persona and reveal their credentials with the TypeScript SDK.
- [deployments](https://vetta.sh/docs/sdk/deployments.md): An agent on a cron — client.deployments.
- [webhooks](https://vetta.sh/docs/sdk/webhooks.md): Outbound signed deliveries — client.webhooks, and the two replies that carry a secret once.
- [auth](https://vetta.sh/docs/sdk/auth.md): Who am I, person sign-in, registration, and recovery — client.auth.
- [orgs](https://vetta.sh/docs/sdk/orgs.md): Organizations and their members — client.orgs.
- [keys](https://vetta.sh/docs/sdk/keys.md): Scoped API keys — client.keys, and where the secret appears.
- [credits](https://vetta.sh/docs/sdk/credits.md): Balance, top-ups, ledger, and the plan — client.credits. Integer micro-USD, always.
- [auditLogs](https://vetta.sh/docs/sdk/audit-logs.md): The control-plane trail — client.auditLogs.
- [CLI overview](https://vetta.sh/docs/cli/overview.md): Install, authenticate, and learn the global conventions of the vetta CLI.
- [vetta auth](https://vetta.sh/docs/cli/auth.md): Sign in, inspect the active credential, and sign out.
- [vetta agent](https://vetta.sh/docs/cli/agents.md): Create, version, run, and inspect agents.
- [vetta team](https://vetta.sh/docs/cli/team.md): Compose a coordinator agent with a version-pinned roster.
- [vetta board](https://vetta.sh/docs/cli/board.md): Read and move cards on a team's shared board from a terminal.
- [vetta models](https://vetta.sh/docs/cli/models.md): List the models an agent can be created against.
- [vetta media](https://vetta.sh/docs/cli/media.md): Generate images and video from the terminal, search the generation models and the stock photo library, cut a long video into short clips, transcribe a recording, turn text into speech, and answer a spoken turn with one.
- [vetta session](https://vetta.sh/docs/cli/sessions.md): Create, send, stream, and manage sessions.
- [vetta computer](https://vetta.sh/docs/cli/computer.md): Provision and control sandboxes.
- [vetta browser](https://vetta.sh/docs/cli/browser.md): Drive a computer's browser from the terminal, and manage the saved logins that outlive a session.
- [vetta skill](https://vetta.sh/docs/cli/skills.md): Push and version skills.
- [vetta file](https://vetta.sh/docs/cli/files.md): Upload inputs for a session and download published outputs.
- [vetta deploy & webhook](https://vetta.sh/docs/cli/deployments.md): Schedule agents with cron and subscribe to events.
- [vetta webhook](https://vetta.sh/docs/cli/webhook.md): Subscribe endpoints to events, rotate signing secrets, and inspect deliveries.
- [naive](https://vetta.sh/docs/cli/naive.md): Claim a cloned blueprint repo, apply its naive.config, scaffold a new one.
- [vetta app](https://vetta.sh/docs/cli/apps.md): Create and deploy a hosted app by hand, read the ones a project declaration provisioned, and poll the build that finishes after the apply returns.
- [vetta storage](https://vetta.sh/docs/cli/storage.md): Buckets and objects on a fullstack app's object store, from the terminal.
- [vetta db](https://vetta.sh/docs/cli/database.md): Work with a fullstack app's managed database from the terminal: SQL, tables, migrations.
- [vetta org](https://vetta.sh/docs/cli/org.md): Organizations, the active-org profile setting, and members.
- [vetta keys](https://vetta.sh/docs/cli/keys.md): Create, list, rotate, and revoke scoped API keys.
- [vetta plan & vetta credits](https://vetta.sh/docs/cli/billing.md): The monthly plan, the prepaid balance, top-ups, and the usage ledger.
- [vetta audit](https://vetta.sh/docs/cli/audit.md): Query the principal-attributed control-plane audit trail.
- [vetta identity](https://vetta.sh/docs/cli/identity.md): Personas, the agents that hold them, and OAuth connections.
- [vetta identity domain & email](https://vetta.sh/docs/cli/comms.md): Connect sending domains and run a persona's inboxes.
- [vetta identity phone](https://vetta.sh/docs/cli/phone.md): Provision, list, release, and send from a persona's phone numbers.
- [vetta identity social](https://vetta.sh/docs/cli/social.md): Activate social publishing for a persona, connect accounts, and publish posts.
- [vetta identity legal](https://vetta.sh/docs/cli/legal.md): Verify a persona's people and form a company from the command line.
- [vetta identity wallet](https://vetta.sh/docs/cli/wallet.md): Provision, fund, cap and drain a persona's wallet, and pay for paywalled resources.
- [vetta identity card](https://vetta.sh/docs/cli/cards.md): Buy prepaid virtual cards for a persona, reveal their credentials, and log spend.
- [vetta vault](https://vetta.sh/docs/cli/vault.md): Store write-only credentials that agents use but never see.