feat(integrations): discover native OMP model catalogs by bandzalkin · Pull Request #848 · band-ai/band-sdk-python

bandzalkin · 2026-10-18T17:56:34Z

Summary

This lets hosts discover OMP's configured models before opening a Band room or running inference. await adapter.probe_models(timeout_s=...) returns a canonical ModelCatalog from omp models --json, with temporary native RPC discovery when the CLI route is unavailable, invalid or ambiguous.

Preserve configured launcher prefixes, native options, overlays/extensions, working directory and provider environment. Rewrite an explicit native launch only at a known command boundary; otherwise use the original command for RPC rather than risk changing the inventory.
Keep provider-qualified IDs and advertised effort/default metadata. Missing metadata stays unknown, and only native state can establish the currently selected model. An advertised empty catalog succeeds; unavailable or malformed discovery raises an error.
Include the shared host probe contracts, provider/default model fields and retryable probe ownership. Discovery is an explicit host operation, separate from the startup list_models hook.
Own CLI descendants through a POSIX process group or Windows Job, even after their launcher exits. Retain concrete process identities or handles until physical exit is established; a successful signal or empty process census is not sufficient.
Keep failed cleanup owned for cleanup_all() retry. Whole-adapter cleanup waits for probe and room teardown before reporting failures, and retiring native sessions receive no new work.

Depends on #763. The shared host contracts are included here; #844 is not a prerequisite. Retain the adapter instance until cleanup settles. A catalog does not prove provider authentication or inference entitlement.

Validation

Regression coverage includes CLI/RPC fallback, launcher and native flag routing, metadata fidelity, installed-executable extension loading, cancellation, descendant custody and cleanup retry.

…porter

Give the repeated tool-completion and privacy checks one helper, and name the ACP call record so activity identity is not a bare tuple. Co-authored-by: Cursor <cursoragent@cursor.com>

Source-Base: 0d851ac Source-Head: fbcc89f Upstream-PR: band-ai#848

Source-Base: d87d7c5 Source-Head: 5d27cc3 Upstream-PR: band-ai#848

…t-activity-detail-to-the-platform-INT-1744 Keep main's BackendTurns ownership of OpenCode cancellation and register the watcher as a turn worker so activity reporting outlives the handler. Reporter unit tests move to tests/runtime/workingreporter; main's workingstate package keeps the execution-level tests. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AgnNR4uiqD787Bg3yKdZpL

…detail-to-the-platform-INT-1744' into feat/python-sdk-report-activity-detail-to-the-platform-delivery-INT-1744 Port the startup-backlog claim-failure test edit to the split tests/runtime/execution package. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AgnNR4uiqD787Bg3yKdZpL

…detail-to-the-platform-delivery-INT-1744' into feat/python-sdk-report-activity-detail-to-the-platform-producers-INT-1744 Adopt main's agno and tool test layouts and carry the producer edits into them; keep the split CrewAI/Parlant coverage guards with main's new paths. Letta streams provider events through main's BackendTurns run, and the CrewAI flow tool activity wraps main's turn-owned tool execution. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AgnNR4uiqD787Bg3yKdZpL

It runs three collect-only subprocesses, which exceeded the default per-test timeout on Windows runners. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AgnNR4uiqD787Bg3yKdZpL

The restack merge resolved src/band/runtime/tools/agent.py to this branch's older lineage and dropped the activity observation the producer stack added: the class decorator reporting method calls and the model-tool wrapper around execute_tool_call. Native OMP work does not touch that surface; restore it from the prerequisite.

…nch)

Select upstream band-ai#841 (activity producers, carrying band-ai#839/band-ai#840 via forward merges), band-ai#874 after 841 (tool-name emit gate with the I-08 name clamp), the host stack ahead of band-ai#763, band-ai#763 after 874 (native OMP with the tool/permission activity hooks and omp_acp retirement), and band-ai#854/band-ai#795/band-ai#848 after 763. Replayed from the branches' live heads.

Source-Base: 2dc539a Source-Head: deabb1e Upstream-PR: band-ai#848

Live capture on the platform showed the OMP hooks posting tool_call activity details even when Emit.TOOL_CALLS was off: the activity channel is separate from event narration, so the hook sites need the same gate the narration already had. I-01/I-02: with tool reporting off, no tool kind or name may reach the reporter. Tests now pin the gate directly (activity follows the switch) instead of the incorrect independence premise. Co-Authored-By: Claude <noreply@anthropic.com>

Select upstream band-ai#841 (activity producers, carrying band-ai#839/band-ai#840 via forward merges), band-ai#874 after 841 (tool-name emit gate with the I-08 name clamp), the host stack ahead of band-ai#763, band-ai#763 after 874 (native OMP with the tool/permission activity hooks and omp_acp retirement), and band-ai#854/band-ai#795/band-ai#848 after 763. Replayed from the branches' live heads.

Source-Base: 41fb96e Source-Head: ce5f0fa Upstream-PR: band-ai#848

The mask wrapper was attached only when the flag was already off, so an adapter that binds its observer before the emit sync (codex's item/started path) kept reporting named tool_calls after the choice was turned off. The observer now always wraps and reads the live flag on every report; the hook site gates on the OMP branch remain as the second guard. Red-first test: observer bound with names on, choice flipped off mid-turn, tool report must arrive nameless. Co-Authored-By: Claude <noreply@anthropic.com>

Select upstream band-ai#841 (activity producers, carrying band-ai#839/band-ai#840 via forward merges), band-ai#874 after 841 (tool-name emit gate with the I-08 name clamp), the host stack ahead of band-ai#763, band-ai#763 after 874 (native OMP with the tool/permission activity hooks and omp_acp retirement), and band-ai#854/band-ai#795/band-ai#848 after 763. Replayed from the branches' live heads.

Source-Base: 3098914 Source-Head: 26fd6bd Upstream-PR: band-ai#848

F-8 closure evidence: an observer bound at turn start now reads the gate flag at report time (d764959, covered by the flip-after-binding test), and a stale continuation report after the next turn takes activity ownership is fenced before it can name anything. The two guards seal R-02 for OMP background-yield continuations; no production change is required.

bandzalkin · 2026-10-21T15:37:26Z

Closing: band-agent does not consume this; may be re-proposed per feature.

Select upstream band-ai#841 (activity producers, carrying band-ai#839/band-ai#840 via forward merges), band-ai#874 after 841 (tool-name emit gate with the I-08 name clamp), the host stack ahead of band-ai#763, band-ai#763 after 874 (native OMP with the tool/permission activity hooks and omp_acp retirement), and band-ai#854/band-ai#795/band-ai#848 after 763. Replayed from the branches' live heads.

AlexanderZ-Band and others added 15 commits October 18, 2026 13:33

fix: Keep working-state reporting alive through provider turns

d1419b7

fix: Preserve standalone worker binding across tool wrappers

8ec26b3

test: Avoid the E2E peer fixture reservation in runtime tests

1476457

style: Format the renamed activity platform fixture

8bfeac0

test: Use real time for randomized scheduler grace controls

a397d8c

feat: Deliver compatible activity detail through the working-state re…

0342d96

…porter

style: Format detail ownership fixture parameters

d76f571

test: Avoid reserved peer fixtures in activity wire tests

1842638

test: Preserve backlog ordering across valid recovery retries

06d8124

feat: Map provider and Band tool progress to room activity

2d69703

test: Validate activity producers through real execution boundaries

64de362

refactor: Consolidate activity reset and streaming usage ownership

831b851

test: Register live activity cells and disambiguate runtime fixtures

9d7fc64

fix: Fence housekeeping activity and clean up cancelled tool starts

eb7326e

refactor: Share activity observation records and assertions

a674b67

Give the repeated tool-completion and privacy checks one helper, and name the ACP call record so activity identity is not a bare tuple. Co-authored-by: Cursor <cursoragent@cursor.com>

bandzalkin changed the title ~~feat(omp): discover native catalogs with retained process custody~~ feat(integrations): discover native OMP model catalogs Oct 18, 2026

This was referenced Oct 18, 2026

feat(integrations): list OMP models from omp models or a throwaway session #705

Closed

feat(integrations): add standalone Codex preflight #846

Closed

feat(integrations): add standalone ACP preflight #845

Closed

bandzalkin force-pushed the feat/host-list-models-omp-refresh branch from b55dd47 to fbcc89f Compare October 19, 2026 02:53

bandzalkin mentioned this pull request Oct 19, 2026

fix(integrations): preserve native OMP lifecycle and prompt authority #763

Closed

github-actions Bot pushed a commit to bandzalkin/band-sdk-python that referenced this pull request Oct 19, 2026

feat(integrations): discover native OMP model catalogs

eb78c8b

Source-Base: 0d851ac Source-Head: fbcc89f Upstream-PR: band-ai#848

bandzalkin force-pushed the feat/host-list-models-omp-refresh branch from fbcc89f to 5d27cc3 Compare October 20, 2026 06:36

bandzalkin requested review from AlexanderZ-Band and amit-gazal-band as code owners October 20, 2026 06:36

github-actions Bot pushed a commit to bandzalkin/band-sdk-python that referenced this pull request Oct 20, 2026

feat(integrations): discover native OMP model catalogs

ffb547f

Source-Base: d87d7c5 Source-Head: 5d27cc3 Upstream-PR: band-ai#848

AlexanderZ-Band and others added 4 commits October 20, 2026 13:08

bandzalkin added 5 commits October 21, 2026 02:30

Merge band-ai#841 fix: running-room event echo in the activity peer

0d8cbd0

Merge band-ai#874 (event-echo fix on the activity stack)

4f471d2

Merge band-ai#763 (event-echo fix through the stack)

306edf5

Merge band-ai#763 (tool activity reporting restored on the native bra…

97c902d

…nch)

bandzalkin added 4 commits October 21, 2026 02:50

style: drop merge-seam blank lines from the reporter files

d697f43

Merge band-ai#841 (format fix on the activity stack)

89dab59

Merge band-ai#874 (format fix through the activity stack)

2dc539a

Merge band-ai#763 (format fix through the stack)

deabb1e

github-actions Bot pushed a commit to bandzalkin/band-sdk-python that referenced this pull request Oct 21, 2026

feat(integrations): discover native OMP model catalogs

604e273

Source-Base: 2dc539a Source-Head: deabb1e Upstream-PR: band-ai#848

sim-artifacts and others added 2 commits October 21, 2026 05:42

Merge band-ai#763 (activity emit-gate fix) into band-ai#848

ce5f0fa

github-actions Bot pushed a commit to bandzalkin/band-sdk-python that referenced this pull request Oct 21, 2026

feat(integrations): discover native OMP model catalogs

c78f3c8

Source-Base: 41fb96e Source-Head: ce5f0fa Upstream-PR: band-ai#848

bandzalkin and others added 3 commits October 21, 2026 08:12

Merge band-ai#874 (live tool-name gate) into band-ai#763

3098914

Merge band-ai#763 (tool-activity gate cascade) into band-ai#848

26fd6bd

github-actions Bot pushed a commit to bandzalkin/band-sdk-python that referenced this pull request Oct 21, 2026

feat(integrations): discover native OMP model catalogs

48361ee

Source-Base: 3098914 Source-Head: 26fd6bd Upstream-PR: band-ai#848

bandzalkin added 2 commits October 21, 2026 10:27

Merge band-ai#763 (continuation gate guard) into band-ai#848

8edf911

bandzalkin closed this Oct 21, 2026

Navigation Menu

Repository navigation

feat(integrations): discover native OMP model catalogs - #848

feat(integrations): discover native OMP model catalogs#848
bandzalkin wants to merge 81 commits into
band-ai:mainfrom
bandzalkin:feat/host-list-models-omp-refresh

bandzalkin commented Oct 18, 2026 •

edited

Loading

Uh oh!

bandzalkin commented Oct 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

bandzalkin commented Oct 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Validation

Uh oh!

bandzalkin commented Oct 21, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

bandzalkin commented Oct 18, 2026 •

edited

Loading