Skip to content

feat: Custom Software/Agents docs + native options schema (zod) + sidecar logfmt observability#1518

Merged
NathanFlurry merged 3 commits into
mainfrom
nathan/agentos-combined
Jun 24, 2026
Merged

feat: Custom Software/Agents docs + native options schema (zod) + sidecar logfmt observability#1518
NathanFlurry merged 3 commits into
mainfrom
nathan/agentos-combined

Conversation

@NathanFlurry

Copy link
Copy Markdown
Member

Combined PR (supersedes #1516 and #1517). Three independent, disjoint pieces:

Docs — Custom Software & Custom Agents

  • New Reference → Custom Software: Software Definition (defineSoftware reference) + Building Binaries (Rust & C from the secure-exec registry).
  • New Custom Agents guide (ACP primer, embedded vs adapter shapes, OpenCode/Pi-CLI examples).
  • onAgentStderr (agent logs) in Sessions; Pi → Custom Agents link.

Native options schema (zod)

  • packages/core/src/options-schema.ts (+ test); packages/agentos/src/config.ts zod/v4 schema (NativeAgentOsOptions).
  • defineSoftware re-export from @rivet-dev/agentos.
  • Plumbed through crates/agentos-actor-plugin + crates/client config.

Zod v3 host-tools + sidecar observability

  • packages/core/src/host-tools-zod.ts (+ test): Zod v3 support via zod3 alias + zod-to-json-schema.
  • feat(sidecar): configurable logfmt logging + ext stall-watchdog tracing (crates/agentos-sidecar).

Dependency resolution: took the sidecar branch's package.json/lockfile (superset — zod ^4.3.6 + zod-to-json-schema + zod3).

🤖 Generated with Claude Code

- Native AgentOs options schema (NativeAgentOsOptions) across core/agentos + crates
- Re-export defineSoftware from @rivet-dev/agentos
- Docs: Reference > Custom Software (Definition, Building Binaries) + Custom Agents guide; onAgentStderr (agent logs) in Sessions
@railway-app

railway-app Bot commented Jun 24, 2026

Copy link
Copy Markdown

🚅 Deployed to the agentos-pr-1518 environment in agentos

Service Status Web Updated (UTC)
agentos ✅ Success (View Logs) Web Jun 24, 2026 at 7:20 am

🚅 Deployed to the agentos-pr-1518 environment in rivet-frontend

Service Status Web Updated (UTC)
agent-os ✅ Success (View Logs) Jun 24, 2026 at 7:03 am

@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from f188e6d to a41c293 Compare June 24, 2026 04:52
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 04:52 Destroyed
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 04:52 Destroyed
@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from a41c293 to e833bb7 Compare June 24, 2026 05:24
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 05:24 Destroyed
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 05:24 Destroyed
@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from e833bb7 to eaa42bc Compare June 24, 2026 06:55
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 06:55 Destroyed
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 06:55 Destroyed
@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from eaa42bc to 686eba4 Compare June 24, 2026 06:55
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 06:56 Destroyed
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 06:56 Destroyed
@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from 686eba4 to 36b1dcd Compare June 24, 2026 07:01
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 07:01 Destroyed
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 07:01 Destroyed
@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from 36b1dcd to 615b3c7 Compare June 24, 2026 07:02
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 07:02 Destroyed
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 07:02 Destroyed
NathanFlurry and others added 2 commits June 24, 2026 00:07
Replace the hardcoded ERROR-level tracing subscriber in agentos-sidecar with a
rivet-style init_tracing: EnvFilter-gated level (AGENTOS_LOG_LEVEL > LOG_LEVEL >
RUST_LOG > info), logfmt format (RUST_LOG_FORMAT=text to opt out), and an
optional file sink (AGENTOS_LOG_FILE). Output stays on stderr/file, never stdout
(the frame channel).

Add an ext.request span + entry/exit timing in acp_extension, plus a stall
watchdog that warns every 10s while a request is in flight, so a hung tool turn
surfaces as a breadcrumb long before the host's 120s frame timeout instead of
silently.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ecar logfmt observability

Combines:
- docs: Custom Software section + Custom Agents guide
- feat: native AgentOs options schema (zod/v4) + defineSoftware re-export
- feat(sidecar): configurable logfmt logging + ext stall-watchdog tracing
@NathanFlurry NathanFlurry force-pushed the nathan/agentos-combined branch from 615b3c7 to a97d5b1 Compare June 24, 2026 07:19
@railway-app railway-app Bot temporarily deployed to rivet-frontend / agentos-pr-1518 June 24, 2026 07:19 Destroyed
@railway-app railway-app Bot temporarily deployed to agentos / agentos-pr-1518 June 24, 2026 07:19 Destroyed
@NathanFlurry NathanFlurry merged commit 4c4c5ae into main Jun 24, 2026
3 of 4 checks passed
@NathanFlurry NathanFlurry deleted the nathan/agentos-combined branch June 24, 2026 07:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant