Skip to content

Conversation

@joshuaprismon
Copy link
Collaborator

No description provided.

joshuaprismon and others added 10 commits November 25, 2025 22:47
…alancer support

This commit adds a complete Go reference implementation of the IAB Tech Lab
Agentic RTB Framework (ARTF) v1.0 specification.

Features:
- gRPC RTBExtensionPoint service for native protobuf communication
- MCP (Model Context Protocol) interface for AI agent integration
- Web UI for browser-based testing and demonstration
- Health check endpoints for Kubernetes integration

Supported ARTF intents:
- ACTIVATE_SEGMENTS: Activate user segments by external segment IDs
- ACTIVATE_DEALS: Activate deals by external deal IDs
- SUPPRESS_DEALS: Suppress deals by external deal IDs
- ADJUST_DEAL_FLOOR: Adjust the bid floor of a specific deal
- ADJUST_DEAL_MARGIN: Adjust the deal margin
- BID_SHADE: Adjust the bid price
- ADD_METRICS: Add metrics to an impression

Configuration options:
- --listen: Bind address for all services
- --external-url: External base URL for load balancer support
- --enable-grpc/mcp/web: Enable specific interfaces
- --grpc-port/mcp-port/web-port/health-port: Port configuration

Load balancer support:
- When both Web and MCP are enabled, they share the same port
- External URL rewrites all service URLs for proper routing
- CORS headers enabled for cross-origin MCP requests

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Added collapsible documentation section with ARTF intents and descriptions
- Processing flow diagram showing the 5-step mutation lifecycle
- Auction lifecycle stages table (PRE_AUCTION, POST_BID, PRE_RENDER)
- Mutation operations reference (ADD, REMOVE, REPLACE)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Changed badge from "MCP Tool Tester" to "gRPC & MCP Tester"
- Updated page description to mention both interfaces
- Added gRPC endpoint display in info bar alongside MCP endpoint
- Updated processing flow to clarify gRPC (protobuf) vs MCP (JSON-RPC)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add styled /spec page serving the ARTF specification
- Match visual styling with main tester page (IAB Tech Lab branding)
- Include documentation for all intents, operations, lifecycle stages
- Add navigation link to specification from main page
- Update GitHub link to point to IABTechLab/agentic-rtb-framework

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Update base image from golang:1.22-alpine to golang:1.23-alpine
to match go.mod requirement (go >= 1.23.0).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Use golang:1.23 (Debian-based) for build stage
- Use ubuntu:24.04 for runtime stage to avoid Alpine DNS issues
- Create proper non-root user with useradd
- Remove GOARCH=amd64 hardcoding to support multi-arch builds

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Ubuntu 24.04 already has a nobody user with UID 65534, so we use that
instead of trying to create a new artf user with the same UID.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add new Container tab to Web UI with comprehensive build guide
- Include quick start instructions for building and running containers
- Document agent manifest structure and all fields per ARTF spec
- Add container customization guide for custom agents
- Include Kubernetes deployment example

Docker image updates:
- Add agent-manifest label per ARTF specification requirement
- Add OCI-compliant image metadata labels
- Support customizable agent name, vendor, owner via build args
- Update Makefile with docker-inspect-manifest target
- Enable all interfaces (gRPC, MCP, Web) by default in container

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add Claude Desktop and Claude Code MCP configuration instructions
- Document ChatGPT alternatives (Web UI, Custom GPT Actions)
- Add critical dependencies section with protoc tooling requirements
- Update Go version requirement to 1.23+

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
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.

2 participants