Skip to content

feat(runtime): byo-cloud and ozwell backends (Phase 2 Slice 4) - #9

Merged
SarkarShubhdeep merged 6 commits into
developmentfrom
phase2/runtime-backends
Jul 21, 2026
Merged

feat(runtime): byo-cloud and ozwell backends (Phase 2 Slice 4)#9
SarkarShubhdeep merged 6 commits into
developmentfrom
phase2/runtime-backends

Conversation

@SarkarShubhdeep

@SarkarShubhdeep SarkarShubhdeep commented Jul 21, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Implements byo-cloud and ozwell AgentRuntime backends alongside local, wired through resolveRuntime and CLI env profile fields (JERRY_RUNTIME, JERRY_MODEL, API keys, endpoints).
  • Ozwell uses Manager host by default (https://ozwellapi.os.mieweb.org), prefers parent ozw_ keys for Jerry’s local tool loop, probes via chat completion, and falls back to local Ollama on auth/network failure.
  • Documents all three runtimes in root README and packages/agent-runtime/README.md; updates docs/plans/phase-2.md Slice 4 status.

Test plan

  • pnpm --filter @mieweb/jerry-agent-runtime test (mock suite)
  • Worker up (pnpm dev); local: JERRY_RUNTIME=local JERRY_MODEL=ollama:qwen2.5:3b jerry "summarize my last 2 hours"
  • Ozwell: unset OZWELL_AGENT_KEY; JERRY_RUNTIME=ozwell OZWELL_API_KEY=ozw_… jerry "summarize my work from July 13th" (tools + full summary)
  • Ozwell fallback: JERRY_RUNTIME=ozwell OZWELL_API_KEY=ozw_bad jerry "hello"[jerry] Ozwell unavailable… then Ollama
  • BYO-cloud: JERRY_RUNTIME=byo-cloud JERRY_MODEL='https://api.openai.com/v1#gpt-4o' OPENAI_API_KEY=… jerry "…"

SarkarShubhdeep and others added 6 commits July 20, 2026 22:06
Complete the three-way runtime split with API key support, Manager-host Ozwell defaults, and local Ollama fallback when Ozwell is unavailable.

Co-authored-by: Cursor <cursoragent@cursor.com>
Agent keys were overriding parent keys and binding Ozwell-side persona/tools, so Jerry skipped local summarize_activity. Prefer OZWELL_API_KEY, probe via chat (not unauthenticated /v1/models), and fall back on stream auth errors.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add Quick start runtime backends section and refresh agent-runtime README with env vars, ozw_ key guidance, and fallback notes.

Co-authored-by: Cursor <cursoragent@cursor.com>
resolveApiKey reads OZWELL_API_KEY from the environment, so a leaked key skipped the intended no-key fallback path.

Co-authored-by: Cursor <cursoragent@cursor.com>
ozwellai ships types from gitignored dist/, so CI failed to resolve the module; build it before tsc. Also remove unused mock import in byo-cloud tests.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@SarkarShubhdeep SarkarShubhdeep self-assigned this Jul 21, 2026
@SarkarShubhdeep
SarkarShubhdeep merged commit 9ce0b2e into development Jul 21, 2026
1 check passed
@github-project-automation github-project-automation Bot moved this from Review to Done in Scrum Team Jerry Jul 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant