Skip to content

Evaluate the bounded standalone agent runtime - #4

Merged
Deathcharge merged 8 commits into
mainfrom
agent/competitive-agent-runtime
Aug 13, 2026
Merged

Evaluate the bounded standalone agent runtime#4
Deathcharge merged 8 commits into
mainfrom
agent/competitive-agent-runtime

Conversation

@Deathcharge

@Deathcharge Deathcharge commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Purpose

Expose and review a bounded OpenAI-compatible session/provider client. This PR does not make Agent Engine the canonical Samsarix controlled runtime and does not authorize publication.

Supported boundary

  • Agent Framework remains the leading canonical controlled agent/tool/checkpoint runtime.
  • Agent Engine survives only as a narrower dependency-light client for named prompts, bounded in-memory sessions, streaming, strict JSON, local guardrails/events, portable snapshots, and approval-aware function tools over an OpenAI-compatible endpoint.
  • Billing, identity, durable workflows, broad provider routing, persistence, hosted services, and application features remain outside this package.

What changed

  • adds bounded streaming, strict structured output, local guardrails, content-free lifecycle events, and portable session snapshots
  • adds approval-aware sequential function tools with request/round/call/argument/result limits
  • expands tests, examples, security/product documentation, and distribution checks
  • removes 160 tracked agents/ and services/ application snapshots so this repository represents only the standalone package
  • adds an exact 160-path ledger and a retained/lost/replaced regression analysis
  • prevents provider-selected tool names and call IDs from entering audit events or surfaced unavailable-tool errors; events use local tool-N correlation IDs and registered local names or unavailable

Snapshot evidence and recovery

  • source head before deletion: c709e2b444a21fc7eaaa9ef8afaf5f1cea4b040a
  • deletion commit: 3b3961d4ec1416f19e5f102d865d5664f43e27a9
  • current exact head: 799c0f07862a4f0e922a9c67f3f3e6f697d2d5c0
  • remote recovery tag: archive/pre-agent-engine-snapshot-removal-20260810
  • exact ledger: docs/REMOVED_SNAPSHOT_FILES.md
  • analysis and recovery procedure: docs/SNAPSHOT_DISPOSITION.md

The removal is not an installable-package/API regression: packaging discovered only src/samsarix_agent_engine*, both pre-deletion wheel and sdist contained zero snapshot entries, and supported source/tests/examples did not import the top-level trees. It intentionally breaks an undocumented checkout-only import path whose modules resolve private apps.backend.* code from another checkout and rely on a large undeclared application stack.

Security review

The initial full PR diff scan found one low-severity audit-metadata issue: a malicious provider could place selected tool names/call IDs into otherwise content-free local events. Exact package-API probes reproduced success, denied, and unavailable-tool paths. The current head fixes the issue without changing provider correlation or approval binding.

A separate clean-room remediation scan reviewed every changed source file in full and found no remaining candidate. Focused reviewers confirmed sequential ordering and all request, round, call, argument, and result budgets remain intact.

Verification

Local exact-head verification:

  • 133 tests passed with 91.63% branch coverage
  • focused audit/tool-loop regressions passed
  • Ruff format/lint passed
  • strict mypy passed
  • Bandit and pip-audit passed
  • isolated wheel/sdist build and Twine checks passed
  • artifacts contain no agents/ or services/ snapshot entries

Hosted exact-head Python 3.11–3.14, dependency audit, package, and status checks are green. Merge remains distinct from release or adoption; a real consumer compatibility fixture is still required before publication.

@coderabbitai

coderabbitai Bot commented Aug 12, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 188 files, which is 88 over the limit of 100.

To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: f1202d79-875b-4693-9710-5f3a49bcdb1e

📥 Commits

Reviewing files that changed from the base of the PR and between 460cd68 and 799c0f0.

📒 Files selected for processing (188)
  • .github/workflows/ci.yml
  • .github/workflows/release.yml
  • CHANGELOG.md
  • CONTRIBUTING.md
  • README.md
  • ROADMAP.md
  • SECURITY.md
  • agents/__init__.py
  • agents/agent_access.py
  • agents/agent_embeds.py
  • agents/agent_emergence_simulator.py
  • agents/agent_management.py
  • agents/agent_orchestrator.py
  • agents/agent_personality_profiles.py
  • agents/agent_profiles.py
  • agents/agent_registry.py
  • agents/agents_base.py
  • agents/agents_loop.py
  • agents/agents_loop_system.py
  • agents/agents_service.py
  • agents/collective_loop.py
  • agents/data/agents.json
  • agents/data/personality_tiers.json
  • agents/enhanced_agents.py
  • agents/memory_root.py
  • agents/verify_blueprints.py
  • agents/visual_agent_builder.py
  • docs/COMPETITIVE_POSITION.md
  • docs/GETTING_STARTED.md
  • docs/LEGACY_CODE.md
  • docs/PRODUCTIZATION.md
  • docs/REMOVED_SNAPSHOT_FILES.md
  • docs/SNAPSHOT_DISPOSITION.md
  • docs/USE_CASES.md
  • examples/approved_support_action.py
  • examples/support_triage.py
  • pyproject.toml
  • services/__init__.py
  • services/admin_bypass.py
  • services/admin_dashboard.py
  • services/agent_communication_logger.py
  • services/agent_coordination.py
  • services/agent_coordinator.py
  • services/agent_llm_bridge.py
  • services/agent_manager.py
  • services/agent_performance_service.py
  • services/agent_protocol.py
  • services/agent_protocol_v2.py
  • services/agent_service.py
  • services/agent_team_templates.py
  • services/agentic_coder.py
  • services/agentic_loop.py
  • services/annotation_service.py
  • services/api_gateway.py
  • services/backblaze_client.py
  • services/background_tasks.py
  • services/backup_service.py
  • services/backup_system.py
  • services/billing_service.py
  • services/byot_service.py
  • services/cache_service.py
  • services/canvas_service.py
  • services/code_agent_service.py
  • services/code_completion_service.py
  • services/code_review_service.py
  • services/collaboration_thread_service.py
  • services/composio_provider.py
  • services/content_quality_scorer.py
  • services/context_augmentation_service.py
  • services/conversation_context_analyzer.py
  • services/coordination_service.py
  • services/coupon_service.py
  • services/credit_monitoring.py
  • services/credit_monitoring_tasks.py
  • services/credit_service.py
  • services/custom_agent_service.py
  • services/data_hygiene.py
  • services/database_integration.py
  • services/dead_letter_queue.py
  • services/delegation_tools.py
  • services/discovery_agent.py
  • services/durable_execution.py
  • services/email_automation.py
  • services/email_service.py
  • services/engagement_hooks.py
  • services/engagement_service.py
  • services/entanglement_service.py
  • services/evaluation_service.py
  • services/event_bus.py
  • services/execution_tracer.py
  • services/export_service.py
  • services/feedback_notification.py
  • services/feedback_service.py
  • services/file_storage.py
  • services/gdpr_service.py
  • services/git_service.py
  • services/github_user_service.py
  • services/helpdesk_agent.py
  • services/integration_hub.py
  • services/internal_client.py
  • services/kb_service.py
  • services/knowledge_extraction.py
  • services/living_document_service.py
  • services/llm_router.py
  • services/local_llm_provider.py
  • services/local_voice_service.py
  • services/memory_edges.py
  • services/memory_tools.py
  • services/metric_calculator.py
  • services/metrics_cache_service.py
  • services/mfa_service.py
  • services/monitoring_service.py
  • services/multi_ai_orchestrator.py
  • services/neural_mesh_network.py
  • services/nextcloud_client.py
  • services/notification_service.py
  • services/notion_client.py
  • services/notion_sync_daemon.py
  • services/oauth_service.py
  • services/onboarding_service.py
  • services/optimization_service.py
  • services/performance_analytics.py
  • services/performance_metrics.py
  • services/performance_monitor.py
  • services/platform_context_service.py
  • services/policy_defaults.py
  • services/policy_engine.py
  • services/policy_middleware.py
  • services/prediction_service.py
  • services/proprietary/__init__.py
  • services/proprietary/data/__init__.py
  • services/proprietary/data/coordination_migration.py
  • services/proprietary/data/coordination_schema.sql
  • services/proprietary/system_auth.py
  • services/proprietary/websocket_protocol.py
  • services/provider_rate_limiter.py
  • services/quality_gate_validator.py
  • services/rag_service.py
  • services/redis_state_manager.py
  • services/sentry_service.py
  • services/service_registry.py
  • services/slash_commands.py
  • services/smart_agent_selector.py
  • services/state_snapshot_service.py
  • services/storage_service.py
  • services/stripe_tax_service.py
  • services/subscription_emails.py
  • services/system_enhancement_utils.py
  • services/system_metrics_service.py
  • services/system_scan_service.py
  • services/team_email_service.py
  • services/template_marketplace.py
  • services/token_budget.py
  • services/tool_bridge.py
  • services/trial_monitoring.py
  • services/ucf_calculator.py
  • services/unified_agent_router.py
  • services/unified_llm.py
  • services/usage_service.py
  • services/vector_search.py
  • services/web_os_storage/README.md
  • services/web_os_storage/documents/notes.txt
  • services/web_os_storage/projects/__init__.py
  • services/web_os_storage/projects/sample.py
  • services/web_os_storage/scripts/backup.sh
  • services/web_search_service.py
  • services/webhook_formatter.py
  • services/webpage_service.py
  • services/websocket_agent_bridge.py
  • services/websocket_service.py
  • services/websocket_wrapper.py
  • services/worker_queue.py
  • services/workflow_connectors.py
  • services/workflow_engine.py
  • services/workflow_execution_engine.py
  • services/workflow_validator.py
  • services/zapier_client_master.py
  • src/samsarix_agent_engine/__init__.py
  • src/samsarix_agent_engine/cli.py
  • src/samsarix_agent_engine/engine.py
  • src/samsarix_agent_engine/errors.py
  • src/samsarix_agent_engine/models.py
  • src/samsarix_agent_engine/providers.py
  • tests/test_cli.py
  • tests/test_engine.py
  • tests/test_examples.py
  • tests/test_models.py
  • tests/test_providers.py

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@Deathcharge
Deathcharge marked this pull request as ready for review August 13, 2026 07:13
@Deathcharge
Deathcharge merged commit 38e8796 into main Aug 13, 2026
7 checks passed
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