Skip to content

Conversation

@ramizpolic
Copy link
Member

@ramizpolic ramizpolic commented Jan 13, 2026

Summary

This PR introduces an MVP runtime service that enables process discovery and lifecycle management for OASF agent processes.

Key Changes

New gRPC API (agntcy.dir.runtime.v1)

  • RuntimeService.CreateProcess — Creates and starts a process from an OASF record data (for now, only container image is supported)
  • RuntimeService.ListProcesses — Streams all running DIR-managed processes with filtering support

Proto Definitions

  • Process message with record metadata, PID, runtime type, creation timestamp, and annotations
  • CreateProcessRequest (takes record_cid) and ListProcessesRequest (takes filters)

Docker Runtime Implementation

  • Uses agntcy.dir.record/cid container label to identify DIR-managed containers
  • Automatically extracts docker_image locator from OASF records to run containers
  • Lists only running containers with the DIR selector label

Server Integration

  • New RuntimeAPI interface for pluggable runtime backends
  • Runtime controller wired into the gRPC server
  • Disables OASF API validation in dev task for easier testing

Open Questions

  • How to discover processes not explicitly labeled at creation time (e.g., docker run or kubectl without DIR involvement)
  • Proposed solution: .well-known/oasf endpoint convention where OASF-compliant agents self-report

@ramizpolic ramizpolic requested a review from a team as a code owner January 13, 2026 09:21
@github-actions
Copy link
Contributor

The latest Buf updates on your PR. Results from workflow Buf CI / verify-proto (pull_request).

BuildFormatLintBreakingUpdated (UTC)
✅ passed⏩ skipped⏩ skipped✅ passedJan 13, 2026, 9:21 AM

@github-actions github-actions bot added the size/M Denotes a PR that changes 200-999 lines label Jan 13, 2026
@ramizpolic ramizpolic marked this pull request as draft January 13, 2026 09:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/M Denotes a PR that changes 200-999 lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants