Osy#betaa language · its runtime Osyrin · a hosted platform
Why Osy#Built for agentsAgents as declarationsWorkflows that waitRuns exactly onceSecure by defaultNothing to mockThe editor is the compilerUI in the languageDocuments are dataOne program

Reference

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

15Agent

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…

15Class

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…

64Function

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…

25Local

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…

11Project

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…

17Security

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…

5Storage

Replacing a stored file's content while keeping what it said before. The FILE is the identity — a record pointing at it never…

14Testing

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…

75UI

Two controls over a stored PDF: a reader with fit, zoom and a real text layer, and a thumbnail that draws one page as a picture…

39Workflow

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