@consiliency/omnigent-transport 0.2.0

package/dist/fixtures/discovery/http-surface.json

@@ -0,0 +1,207 @@
+{
+  "schema": "omnigent.http_surface.v1",
+  "redaction": "metadata_only",
+  "captured_at": "2026-07-11T03:10:00Z",
+  "session_endpoints": [
+    {
+      "method": "POST",
+      "path": "/v1/sessions",
+      "purpose": "create_session"
+    },
+    {
+      "method": "GET",
+      "path": "/v1/sessions",
+      "purpose": "list_sessions"
+    },
+    {
+      "method": "GET",
+      "path": "/v1/sessions/{session_id}",
+      "purpose": "snapshot"
+    },
+    {
+      "method": "PATCH",
+      "path": "/v1/sessions/{session_id}",
+      "purpose": "bind_runner_or_mutate_session"
+    },
+    {
+      "method": "DELETE",
+      "path": "/v1/sessions/{session_id}",
+      "purpose": "destructive_delete"
+    },
+    {
+      "method": "GET",
+      "path": "/v1/sessions/{session_id}/items",
+      "purpose": "read_history"
+    },
+    {
+      "method": "GET",
+      "path": "/v1/sessions/{session_id}/stream",
+      "purpose": "stream_events"
+    },
+    {
+      "method": "POST",
+      "path": "/v1/sessions/{session_id}/events",
+      "purpose": "send_turn_or_interrupt"
+    },
+    {
+      "method": "GET",
+      "path": "/v1/sessions/{session_id}/child_sessions",
+      "purpose": "observe_child_sessions"
+    },
+    {
+      "method": "POST",
+      "path": "/v1/sessions/{source_id}/fork",
+      "purpose": "fork_session"
+    },
+    {
+      "method": "POST",
+      "path": "/v1/sessions/{session_id}/switch-agent",
+      "purpose": "switch_bound_agent"
+    },
+    {
+      "method": "PUT",
+      "path": "/v1/sessions/{session_id}/read-state",
+      "purpose": "update_viewer_read_state"
+    }
+  ],
+  "harness_endpoints": [
+    {
+      "method": "GET",
+      "path": "/v1/harnesses",
+      "purpose": "read_only_harness_catalog"
+    }
+  ],
+  "session_snapshot_fields": {
+    "active_response_id": "optional reconnect hint for active in-flight response",
+    "background_task_count": "optional native terminal shell count",
+    "viewer_last_seen": "session list read-state marker",
+    "viewer_unread": "session list read-state marker",
+    "mcp_startup": "optional per-server MCP startup status metadata"
+  },
+  "session_list_item_fields": {
+    "search_snippet": "optional server-generated search result excerpt"
+  },
+  "session_status_contract": {
+    "api_md": [
+      "idle",
+      "running",
+      "waiting",
+      "failed"
+    ],
+    "openapi_session_response": [
+      "idle",
+      "running",
+      "waiting",
+      "failed"
+    ],
+    "sse_status_event": [
+      "launching",
+      "running",
+      "waiting",
+      "idle",
+      "failed"
+    ],
+    "tolerated_raw_edge": [
+      "launching"
+    ],
+    "note": "v0.5.1 retains the resolved waiting status; launching remains tolerated from session.status edges and maps to starting."
+  },
+  "response_status_contract": [
+    "queued",
+    "in_progress",
+    "completed",
+    "failed",
+    "incomplete",
+    "cancelled"
+  ],
+  "stream_contract": {
+    "mode": "live_tail_only",
+    "done_sentinel": "[DONE]",
+    "replay": false,
+    "reconnect_steps": [
+      "open_stream",
+      "get_snapshot",
+      "dedupe_by_item_id"
+    ],
+    "event_families": [
+      "session",
+      "response",
+      "turn"
+    ],
+    "official_release_event_count": 50,
+    "release_event_types": [
+      "session.mcp_startup",
+      "response.policy_denied"
+    ]
+  },
+  "optional_release_surfaces": [
+    {
+      "method": "GET",
+      "path": "/v1/hosts/{host_id}/worktrees",
+      "status": "observed_not_provider_required",
+      "reason": "host worktree inventory is not part of the transport provider contract"
+    },
+    {
+      "method": "POST",
+      "path": "/v1/sessions/{session_id}/resources/files:copy",
+      "status": "observed_not_provider_required",
+      "reason": "resource copying is not required by the transport provider"
+    },
+    {
+      "methods": [
+        "GET",
+        "PUT"
+      ],
+      "path": "/v1/sharing",
+      "status": "observed_not_provider_required",
+      "reason": "sharing settings are not coordination leases"
+    },
+    {
+      "field": "SessionGitOptions.existing_worktree",
+      "status": "observed_not_provider_required",
+      "reason": "existing worktree selection is an upstream launch option"
+    }
+  ],
+  "fork_request": {
+    "allowed_fields": [
+      "agent_id",
+      "title",
+      "up_to_response_id"
+    ],
+    "removed_fields": [
+      "model_override"
+    ],
+    "provider_sends_removed_fields": false
+  },
+  "child_session_public_surface": {
+    "observe": [
+      "GET /v1/sessions/{session_id}/child_sessions",
+      "session.created",
+      "session.child_session.updated"
+    ],
+    "create_under_parent": false,
+    "fork_available": true
+  },
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "openapi.json",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/routes/harnesses.py",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/schemas.py",
+      "ref": "v0.5.1"
+    }
+  ]
+}

package/dist/fixtures/discovery/source-metadata.json

@@ -0,0 +1,108 @@
+{
+  "schema": "omnigent.source_metadata.v1",
+  "redaction": "metadata_only",
+  "captured_at": "2026-07-11T03:10:00Z",
+  "repo": "omnigent-ai/omnigent",
+  "freeze_target": {
+    "tag": "v0.5.1",
+    "commit": "08285468e098244ac0b0bf98cb470d5c1a1a7070",
+    "published_at": "2026-07-10T23:26:54Z",
+    "package_version": "0.5.1",
+    "requires_python": ">=3.12"
+  },
+  "head_probe": {
+    "branch": "main",
+    "commit": "f55e16f84e1b2c757deb3ee56229feace309cb6c",
+    "observed_at": "2026-07-11T03:10:00Z",
+    "authority": "latest remote head probe only; not part of IF-0-CONTRACT-1"
+  },
+  "previous_probe": {
+    "tag": "v0.5.0",
+    "commit": "1d1b3a8605c48df10618ce481e974f565771326b",
+    "observed_at": "2026-07-10T21:20:38Z",
+    "authority": "historical prior release probe only; superseded by official v0.5.1 freeze target"
+  },
+  "local_cli_probe": {
+    "omnigent_on_path": false,
+    "omni_on_path": false
+  },
+  "preflight_confirmation": {
+    "observed_at": "2026-07-11T03:10:00Z",
+    "openapi_has_harnesses": true,
+    "openapi_has_read_state": true,
+    "session_response_has_active_response_id": true,
+    "session_response_has_mcp_startup": true,
+    "session_list_item_has_search_snippet": true,
+    "session_git_options_has_existing_worktree": true,
+    "session_fork_request_removed_fields": [
+      "model_override"
+    ],
+    "added_paths": [
+      "/v1/hosts/{host_id}/worktrees",
+      "/v1/sessions/{session_id}/resources/files:copy",
+      "/v1/sharing"
+    ],
+    "added_stream_events": [
+      "session.mcp_startup",
+      "response.policy_denied"
+    ],
+    "v0_5_0_openapi_matches_v0_5_1": true
+  },
+  "provenance": [
+    {
+      "kind": "release_metadata",
+      "source": "github release metadata",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "package_metadata",
+      "source": "PyPI omnigent 0.5.1 metadata",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "pyproject.toml",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "openapi.json",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/routes/harnesses.py",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/harness_plugins.py",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/schemas.py",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_sessions.py",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_events.py",
+      "ref": "v0.5.1"
+    },
+    {
+      "kind": "remote_head_probe",
+      "path": "refs/heads/main",
+      "ref": "f55e16f84e1b2c757deb3ee56229feace309cb6c"
+    }
+  ]
+}

package/dist/fixtures/errors/child-session-blocked.json

@@ -0,0 +1,29 @@
+{
+  "schema": "omnigent.error_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "child_session_blocked",
+  "observed_public_surface": {
+    "list_child_sessions": true,
+    "fork_session": true,
+    "create_child_session_under_parent": false
+  },
+  "provider_status": "blocked",
+  "note": "v0.4.0 exposes child-session observation and forking, but not a stable public spawn-under-parent create primitive.",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "openapi.json",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/tools/builtins/spawn.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/errors/close-session-gap.json

@@ -0,0 +1,24 @@
+{
+  "schema": "omnigent.error_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "close_session_gap",
+  "observed_public_surface": {
+    "stop_session_event": true,
+    "delete_session_route": true,
+    "non_destructive_public_close": false
+  },
+  "provider_status": "emulated",
+  "note": "Logical close needs provider-owned policy or state because the public surface exposes stop-or-delete, not a stable close state.",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/tools/builtins/spawn.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/errors/harness-override-blocked.json

@@ -0,0 +1,18 @@
+{
+  "schema": "omnigent.error_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "harness_override_blocked",
+  "observed_public_surface": {
+    "public_rest_harness_override": false,
+    "internal_allowlisted_spawn_override": true
+  },
+  "provider_status": "blocked",
+  "note": "v0.4.0 adds a read-only harness catalog, but the only observed harness override path remains allowlist-gated internal spawn-tool behavior, not a stable public session API.",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/tools/builtins/spawn.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/errors/invalid-event-400.json

@@ -0,0 +1,21 @@
+{
+  "schema": "omnigent.error_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "invalid_event_400",
+  "request": {
+    "method": "POST",
+    "path": "/v1/sessions/{session_id}/events",
+    "case": "unsupported_event_type_or_schema_mismatch"
+  },
+  "response": {
+    "status_code": 400,
+    "class": "bad_request"
+  },
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/events/cancel-interrupt.json

@@ -0,0 +1,44 @@
+{
+  "schema": "omnigent.event_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "cancel_interrupt",
+  "request": {
+    "method": "POST",
+    "path": "/v1/sessions/{session_id}/events",
+    "body": {
+      "type": "interrupt",
+      "data": {}
+    }
+  },
+  "ack": {
+    "queued": false
+  },
+  "events": [
+    {
+      "type": "response.incomplete",
+      "reason": "user_interrupt",
+      "terminal": true
+    },
+    {
+      "type": "session.interrupted",
+      "terminal": false
+    },
+    {
+      "type": "session.status",
+      "status": "idle",
+      "terminal": false
+    }
+  ],
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_sessions.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/events/dual-terminal-markers.json

@@ -0,0 +1,28 @@
+{
+  "schema": "omnigent.event_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "dual_terminal_markers",
+  "events": [
+    {
+      "type": "response.completed",
+      "semantic_terminal": true
+    },
+    {
+      "type": "turn.completed",
+      "semantic_terminal": true
+    }
+  ],
+  "expected_provider_behavior": "collapse duplicate terminal markers into one normalized turn outcome",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_events.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/events/malformed-sse-skip.json

@@ -0,0 +1,31 @@
+{
+  "schema": "omnigent.event_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "malformed_sse_skip",
+  "frames": [
+    {
+      "shape": "non_json_payload",
+      "client_action": "log_and_skip"
+    },
+    {
+      "shape": "json_non_object",
+      "client_action": "log_and_skip"
+    },
+    {
+      "shape": "unknown_event_type",
+      "client_action": "log_and_skip"
+    },
+    {
+      "shape": "valid_event",
+      "type": "response.output_text.delta",
+      "client_action": "yield"
+    }
+  ],
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_sessions.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/events/normal-terminal.json

@@ -0,0 +1,54 @@
+{
+  "schema": "omnigent.event_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "normal_terminal_turn",
+  "events": [
+    {
+      "type": "session.status",
+      "status": "running",
+      "terminal": false
+    },
+    {
+      "type": "response.created",
+      "terminal": false
+    },
+    {
+      "type": "response.in_progress",
+      "terminal": false
+    },
+    {
+      "type": "response.output_text.delta",
+      "terminal": false
+    },
+    {
+      "type": "response.completed",
+      "terminal": true
+    },
+    {
+      "type": "turn.completed",
+      "terminal": true
+    },
+    {
+      "type": "session.status",
+      "status": "idle",
+      "terminal": false
+    },
+    {
+      "type": "[DONE]",
+      "terminal": true
+    }
+  ],
+  "note": "Successful turn with both response and turn terminal markers present.",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_events.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/events/reconnect-snapshot-dedupe.json

@@ -0,0 +1,27 @@
+{
+  "schema": "omnigent.event_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "reconnect_snapshot_dedupe",
+  "reconnect_steps": [
+    "open_stream",
+    "get_snapshot",
+    "dedupe_snapshot_items_by_item_id"
+  ],
+  "transport_properties": {
+    "replay": false,
+    "stream_survives_across_turns": true
+  },
+  "dedupe_key": "item.id",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/API.md",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "sdks/python-client/omnigent_client/_sessions.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}

package/dist/fixtures/events/v0-4-noop-events.json

@@ -0,0 +1,54 @@
+{
+  "schema": "omnigent.event_fixture.v1",
+  "redaction": "metadata_only",
+  "fixture": "v0_4_noop_events",
+  "events": [
+    {
+      "type": "session.usage",
+      "terminal": false
+    },
+    {
+      "type": "response.reasoning.started",
+      "terminal": false
+    },
+    {
+      "type": "response.reasoning_text.delta",
+      "terminal": false
+    },
+    {
+      "type": "response.retry",
+      "terminal": false,
+      "reason": "metadata_only_retry"
+    },
+    {
+      "type": "response.error",
+      "terminal": false,
+      "reason": "metadata_only_error"
+    },
+    {
+      "type": "response.heartbeat",
+      "terminal": false
+    },
+    {
+      "type": "session.reasoning_effort",
+      "terminal": false
+    },
+    {
+      "type": "response.elicitation_request",
+      "terminal": false
+    }
+  ],
+  "expected_provider_behavior": "parse as known v0.4 events and no-op unless explicitly mapped to provider state",
+  "provenance": [
+    {
+      "kind": "tagged_source",
+      "path": "openapi.json",
+      "ref": "v0.4.0"
+    },
+    {
+      "kind": "tagged_source",
+      "path": "omnigent/server/schemas.py",
+      "ref": "v0.4.0"
+    }
+  ]
+}