Osy#the first language built for agents
Agents firstAgentic appsWorkflowsDurable Execution — built inSecurityTestingThe editorThe UI modelOne program

Reference

356 pages. Every fenced example is compiled through the real compiler in CI, so a page cannot describe a language this release does not have.

13Agent

An `agent` is a declaration — instructions, tools, model — and calling it is calling a name. The first-day mistake is treating…

1API

`app.Apis` publishes your app to a third party over HTTP. You never write a controller or an endpoint handler — you EXPOSE what…

14Class

A class is an in-memory shape — data plus the behaviour that belongs to it — and it never touches the database. That is the whole…

11Config

The cross-cutting settings an app declares in one place — the app config object. Two kinds live here: the external providers and…

1Counter

The PLATFORM assigns this number at create and you never set it — invoice codes, ticket numbers. NOT a manual order a person…

3Diagnostics

What your app says while it runs, and what the compiler says about it. The first-day mistake is reaching for a print statement —…

11Entity

An entity is a table — and the rules that are true about it. Not just its columns: what must hold for a row to exist, and who may…

3Enum

A fixed set of named values, used as a member type. By default an enum stores as a compact number; add [Type(string)] to store…

61Function

A function is where your app's logic lives — a top-level unit of work, written like a C# method, that runs on the server. It is…

4HTTP

Two ways to make an outbound HTTP call. A `client` block is a typed wrapper around a known API — name the base URL once, declare…

1JSON

Turn a value into a JSON string and a JSON string into a typed object — the C#-faithful System.Text.Json spelling…

23Local

The local develop-and-debug loop for an Osy# app — for the person in the editor and the coding agent at the CLI alike. Run your…

9Memory

How you make text findable in Osy#. You never touch a vector, an index, or an embedder — you mark a text field [Searchable] and…

9Project

A workflow run can outlive the deploy that started it. Deploying with --new-version freezes the code and data shape the running…

23Query

How you read data in Osy#. You write C# LINQ; it becomes one SQL statement. The rules that follow from that are the whole model:…

4Realtime

Realtime in Osy# is one construct: a topic. A topic is a declared, addressable destination — publishing to one delivers the value…

1Scheduling

A schedule produces work on a cadence. Each occurrence creates a row of the entity its Template names — carrying whatever context…

15Security

How authorization works in Osy#, end to end. Everything is denied until you grant it; a grant is compiled into every query rather…

10Stdlib

The pure standard library, and the one fact about it that changes how your app feels: 126 of its 155 methods run in the BROWSER…

3Storage

How a stored file becomes a URL a browser can fetch. The first-day mistake is picking the wrong one of the two — `File.Url` is…

13Testing

A `[Test]` reaches the network for real — `Http.*` and a typed `client { }` operation both run inside a test, against the live…

19Types

The complete vocabulary of built-in types — the scalars you can store, the collections, the two callable spellings (`Action` and…

66UI

Every screen in an Osy# app is a `component` — the one archetype. A page is a component with a route on it, a layout is a…

38Workflow

Any call that leaves the platform — an outbound client call, an external service — is made a durable step by the compiler. In a…