> ## Documentation Index
> Fetch the complete documentation index at: https://oxy.tech/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Airhouse Connections That Scale, the New Home by Organization, Oxygen on a Phone, and Agent Answers in One Call

> Airhouse connections that scale with your team, the new home by organization, and Oxygen on phones.

&#x20;**November 11, 2026** · v0.5.160

### New Features

#### Airhouse Connections That Scale With Your Team

Airhouse now holds connections for the queries that are running, not for every person who has signed in:

* **Connections follow queries, not headcount** - Airhouse reads share one connection pool per workspace and role instead of opening one per person, so an organization's open connections grow with the queries actually running rather than with the number of people using it.
* **Same data, same permissions** - Airhouse already grants access by role, and people with the same role already shared cached results, so sharing their connections changes nothing about what anyone can read.
* **Isolated shared connections** - Pooled connections refuse statements whose effect would outlast them, such as `SET`, `USE`, `ATTACH`, an open transaction or a temporary table, and shared credentials are now marked as shared so Airhouse can enforce the same rule itself.
* **Parquet uploads work** - Uploading a `.parquet` file into Airhouse no longer fails with "could not read the file". The Parquet reader is now built in instead of being downloaded when first used.

#### The New Home, Turned On by Organization

The redesigned home from the previous release now has its own switch, so it can reach organizations one at a time:

* **Its own setting** - The new home (the ask box first, big app icons, **Today** folded to one line, and the **Simple** and **Full** views) is turned on per organization in the admin console.
* **The previous home until then** - Organizations without it keep the previous home: the greeting, a side column with **Today**, recent questions and the world model, and the standard app tiles.
* **Gradual rollouts** - Features can now be switched on for single organizations or people, or split between groups for an A/B test, with each organization keeping its assignment, so a change like the new home can roll out organization by organization.
* **Fewer home page errors** - The home page no longer reports errors when the browser skips an animation, such as in a hidden tab.

#### Oxygen and Custom Apps on a Phone

Oxygen's own pages now work well on a phone, and custom apps get a shared phone kit in the SDK (SDK 2.27) so they can be built for small screens:

* **No more zoom on tap** - On iOS, the chat box, follow-up box and thread search no longer zoom the page when you tap into them.
* **A phone kit for custom apps** - Rows, cards, filter chips, segmented controls and a tab bar designed for a phone, with every control at least 44px tall so it is easy to tap.
* **Back stays inside the app** - On a phone, Back closes an open sheet, the **Today** panel or Ask Oxygen, and steps between tab bar sections, instead of leaving the app.
* **Ask Oxygen fills the screen** - On a phone, the Ask panel covers the screen instead of squeezing the app into a narrow column beside it.

#### Ask an Agent in One Call

Scripts, server-side code and custom apps can now ask an agent a question and get the answer back in a single call, instead of reading a stream:

* **Wait for the answer** - An ask can wait up to 45 seconds for its answer. A finished run returns the answer, a run that needs clarification returns the agent's question and suggestions, and a run still going at the deadline keeps running and can be followed as before.
* **`useAskAgent` in the SDK** - SDK 2.28 adds `useAskAgent()` and `askAgent()`, which return the answer, status and thread link in one call.
* **`oxyc ask`** - `oxyc ask <workspace> <agent> "<question>"` prints the answer on the command line, with `--thread` to continue a conversation and `--json` for scripts.

#### Classic Agents: Migration and Retirement

Classic `.agent.yml` agents no longer have a runtime. This release makes that visible and gives you a tool to convert them:

* **`oxy migrate-agents`** - Translates classic agents into `.agentic.yml` Agentic Agents, carrying over the model, instructions, databases, context, semantic topics and more. It never overwrites a file, and `--dry-run --json` reports what it would change.
* **Compile-time checks** - Compile now flags each classic `.agent.yml` file and any automation step whose `agent_ref` points at one, instead of failing only when the automation runs.

> [!WARNING]
>
> A workspace that still contains a classic `.agent.yml` agent, or an automation that references one, is now refused at compile. Run `oxy migrate-agents` and commit the converted `.agentic.yml` files before your next change.

#### Edit Your Workspace in Your Own Editor

Authoring is moving to your workspace's repository: clone it, edit it in VS Code, Cursor or with an AI agent, and push. A push to the default branch compiles and deploys.

* **`oxyc workspace clone <workspace>`** - Clones the workspace's repository at its default branch with your own git credentials, opens the workspace's subfolder when it lives inside a larger repository, and can launch your editor with `--open code` or `--open cursor`.
* **Modeling and tests leave the IDE** - The dbt/Airform modeling pages and the test (`.test.yml`) pages have been removed from the Developer Portal. Run tests and evals with `oxy test` or in CI, and run dbt in your own repository's CI.

#### Smoother `oxyc` in Remote and Headless Sessions

* **Login without a local browser** - In SSH, Codespaces, remote AI agent sessions or a Linux machine with no display, `oxyc login` prints a URL and a code to open on any device, like `gh auth login`. `--no-wait` prints the URL and returns immediately, and the next `oxyc login` finishes signing in.
* **`-q` works without jq installed** - `oxyc api … -q '<filter>'` now uses a built-in jq when no `jq` binary is installed or it cannot be run.
* **Invocations and logs by app name** - `oxyc invocations` and `oxyc logs` accept `<org>/<app>` and work for organization admins, per-app admins and App Operators, as well as staff in an assume-role session.

#### NetSuite Custom Transaction Fields

NetSuite Airway pipelines accept a `transaction_custom_fields` list, so custom fields on transactions such as purchase orders land in Airhouse alongside the standard columns.

#### Coming Soon: Policies

A policy engine is in the works: business rules written as code that read their settings from your apps' own data, decide in real time and record every decision. It will run on the same runtime as Oxy Functions. More in an upcoming release.

***

### Platform Improvements

#### Custom Apps

* **Data loads again for apps querying a branch** - Custom apps whose data calls use `?branch=` no longer load empty with `405` or `404` errors.
* **Members see live feeds and weather** - Plain organization members can again read a custom app's live event feed and current weather, which were previously limited to staff, owners and admins.
* **No false timeouts when you leave a page** - A function call whose caller navigates away is recorded as cancelled, instead of turning into a timeout alert 15 minutes later.
* **Safer function runtime** - A runaway loop in one app's function can now always be stopped, so it can no longer take down the server for other apps.
* **Clearer publish and rollback** - Failed publishes no longer leave empty builds in the builds list, and rolling back an unknown app or build says which one was not found.
* **Faster agent answers in apps** - An app's agent-run stream now updates the moment a new event arrives, instead of checking four times a second.

#### Agents and Runs

* **Agents in subfolders are found** - Agents stored in subfolders, or without a `name:`, are now found reliably instead of answering "agent not found", and a temporary read failure can be retried.
* **Run history no longer shows false failures** - Runs that had already finished are no longer relabelled as failed after a deploy.
* **Live run updates across servers** - A run's live stream updates immediately even when the run is processed by another server.
* **Chats run on the worker fleet** - Chat questions are now queued and processed by background workers by default, so a server restart no longer interrupts them.
* **Run history retention** - Finished runs older than 90 days are now deleted automatically. A chat thread is kept as long as any part of it has been active in the last 90 days.

#### Workspace Health

* **Agent check works on every server** - The agent smoke check now reads the compiled agent, so it no longer fails with "agent config not found", and an agent definition that does not parse is reported as broken.
* **"Run now" runs in the background** - Running a health check on demand is now queued like a scheduled run and still appears in the schedule's run history.

#### Security and Organizations

* **Credentials kept out of errors** - Connection errors no longer include passwords or connection strings in error messages, Workspace Health results, chat tool errors or logs.
* **One workspace per organization** - An organization now has a single workspace, and importing from GitHub connects the organization's existing workspace instead of creating a second one.
* **Rate limits hold across servers** - Rate limits, including the frontline PIN guess limit, now apply across all servers instead of per server.
* **OLTP permission audit** - Database privileges granted outside an app's own schema are now detected and reported.

#### Fixes

* **Ask Oxygen ready to type** - Opening Ask Oxygen with ⌘K or the top-bar button always puts the cursor in the message box.
* **Retired `.workflow.yml` files no longer listed** - Automations lists no longer count a `.workflow.yml` file that could never run.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.