pi-harness-runtime 0.10.13 → 0.10.15

package/IMPLEMENTATION/RFC-0018/AI_BRIEF.md

@@ -1,2 +0,0 @@
-# AI Brief
-Implement RFC-0018.

package/IMPLEMENTATION/RFC-0018/FILES.md

@@ -1,2 +0,0 @@
-# Files
-packages/

package/IMPLEMENTATION/RFC-0018/TASKS.md

@@ -1,4 +0,0 @@
-# Repair Engine
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0018/TESTS.md

@@ -1,3 +0,0 @@
-# Tests
-Happy path
-Failure path

package/IMPLEMENTATION/RFC-0019/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Sensitive data is not logged.
-- Failure produces explicit recovery record.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0019/AI_BRIEF.md

@@ -1,18 +0,0 @@
-# AI Brief — Prompt Versioning (RFC-0019)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/prompt-versioning/`
-- `PromptVersioning` class from versioning
-
-## Features
-
-- Prompt version control with rollback
-- Version history management
-- Prompt diff and comparison
-
-## Tests
-
-- Subagent-implemented; versioning tests pass

package/IMPLEMENTATION/RFC-0019/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0019 - Auto Compact and Continue
-
-- [ ] Read RFC and confirm scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schema if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add runtime event emission.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Add usage example.

package/IMPLEMENTATION/RFC-0020/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Sensitive data is not logged.
-- Failure produces explicit recovery record.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0020/AI_BRIEF.md

@@ -1,18 +0,0 @@
-# AI Brief — Evaluation Runner (RFC-0020)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/evaluation-runner/`
-- `EvaluationRunner`, `exactMatchEvaluator`, `substringMatchEvaluator`, `lengthEvaluator` from runner
-
-## Features
-
-- Framework-agnostic AI evaluation
-- Multiple evaluator strategies (exact match, substring, length)
-- Configurable scoring thresholds
-
-## Tests
-
-- Subagent-implemented; runner tests pass

package/IMPLEMENTATION/RFC-0020/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0020 - Output Token Limit Handler
-
-- [ ] Read RFC and confirm scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schema if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add runtime event emission.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Add usage example.

package/IMPLEMENTATION/RFC-0021/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Sensitive data is not logged.
-- Failure produces explicit recovery record.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0021/AI_BRIEF.md

@@ -1,18 +0,0 @@
-# AI Brief — Feedback Collector (RFC-0021)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/feedback-collector/`
-- `FeedbackCollector` class from collector
-
-## Features
-
-- Human/automated feedback aggregation
-- Feedback storage and retrieval
-- Rating and comment collection
-
-## Tests
-
-- Subagent-implemented; collector tests pass

package/IMPLEMENTATION/RFC-0021/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0021 - Partial Response Recovery
-
-- [ ] Read RFC and confirm scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schema if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add runtime event emission.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Add usage example.

package/IMPLEMENTATION/RFC-0022/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Sensitive data is not logged.
-- Failure produces explicit recovery record.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0022/AI_BRIEF.md

@@ -1,18 +0,0 @@
-# AI Brief — Cache Strategy (RFC-0022)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/cache-strategy/`
-- `CacheStrategy` class from cache
-
-## Features
-
-- Smart caching with TTL/invalidation
-- Cache key generation and lookup
-- Invalidation strategies
-
-## Tests
-
-- Subagent-implemented; cache tests pass

package/IMPLEMENTATION/RFC-0022/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0022 - Notification Center
-
-- [ ] Read RFC and confirm scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schema if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add runtime event emission.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Add usage example.

package/IMPLEMENTATION/RFC-0023/ACCEPTANCE_CRITERIA.md

@@ -1,7 +0,0 @@
-# Acceptance Criteria
-
-- Implementation follows the RFC.
-- State is durable and runtime-owned.
-- Sensitive data is not logged.
-- Failure produces explicit recovery record.
-- Tests cover happy path and failure path.

package/IMPLEMENTATION/RFC-0023/AI_BRIEF.md

@@ -1,18 +0,0 @@
-# AI Brief — Rate Limiter (RFC-0023)
-
-**Status:** ✅ Done
-
-## Implemented
-
-- `packages/rate-limiter/`
-- `RateLimiter` class from limiter
-
-## Features
-
-- Token bucket rate limiting
-- Configurable rates and burst limits
-- Per-key limiting
-
-## Tests
-
-- Subagent-implemented; limiter tests pass

package/IMPLEMENTATION/RFC-0023/TASKS.md

@@ -1,10 +0,0 @@
-# Tasks - RFC 0023 - Local Browser Agent
-
-- [ ] Read RFC and confirm scope.
-- [ ] Define TypeScript interfaces.
-- [ ] Define JSON schema if needed.
-- [ ] Implement local-file prototype.
-- [ ] Add runtime event emission.
-- [ ] Add happy-path tests.
-- [ ] Add failure-path tests.
-- [ ] Add usage example.

package/IMPLEMENTATION/RFC-0024/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0024

package/IMPLEMENTATION/RFC-0024/TASKS.md

@@ -1,3 +0,0 @@
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0025/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0025

package/IMPLEMENTATION/RFC-0025/TASKS.md

@@ -1,3 +0,0 @@
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0026/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0026

package/IMPLEMENTATION/RFC-0026/TASKS.md

@@ -1,3 +0,0 @@
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0027/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0027

package/IMPLEMENTATION/RFC-0027/TASKS.md

@@ -1,3 +0,0 @@
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0028/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0028

package/IMPLEMENTATION/RFC-0028/TASKS.md

@@ -1,3 +0,0 @@
-- Read RFC
-- Implement
-- Test

package/IMPLEMENTATION/RFC-0029/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0029. Runtime remains orchestrator.

package/IMPLEMENTATION/RFC-0029/TASKS.md

@@ -1,4 +0,0 @@
-- [x] Read RFC
-- [x] Implement - AgentWorker interface (RFC-0030)
-- [x] Implement - DeepAgentsAdapter (packages/providers/deepagents-adapter.ts)
-- [x] Test - Types compile cleanly

package/IMPLEMENTATION/RFC-0030/AI_BRIEF.md

@@ -1 +0,0 @@
-Implement RFC-0030. Runtime remains orchestrator.

package/IMPLEMENTATION/RFC-0030/TASKS.md

@@ -1,3 +0,0 @@
-- [x] Read RFC
-- [x] Implement - AgentWorker interface (packages/types/src/agent-worker-types.ts)
-- [x] Test - Types compile cleanly

package/IMPLEMENTATION/RFC-0031/AI_BRIEF.md

@@ -1,45 +0,0 @@
-# RFC-0031 AI Brief: Provider Adapter SDK
-
-## Summary
-
-A comprehensive SDK for building, testing, and registering provider adapters that normalize AI provider behavior for MiniMax, OpenAI, Claude, and custom providers.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **AdapterBuilder** (`builder.ts`)
-   - Fluent API for creating adapters
-   - Configurable capabilities, models, rate limits
-   - Invoke and parseError function registration
-
-2. **AdapterRegistry** (`registry.ts`)
-   - Lifecycle hooks (init, healthCheck, teardown)
-   - Adapter versioning and compatibility
-   - Factory pattern support
-
-3. **AdapterTester** (`tester.ts`)
-   - Test basic invocation
-   - Test quota detection
-   - Test error parsing
-   - Generate mock responses
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- `packages/providers` - existing adapters to migrate
-
-### Files to Create
-
-- `packages/provider-adapter-sdk/src/builder.ts`
-- `packages/provider-adapter-sdk/src/registry.ts`
-- `packages/provider-adapter-sdk/src/tester.ts`
-- `packages/provider-adapter-sdk/src/types.ts`
-- `packages/provider-adapter-sdk/src/compatibility.ts`
-- `packages/provider-adapter-sdk/src/errors.ts`
-- `packages/provider-adapter-sdk/src/index.ts`
-
-### Integration Points
-
-- Migrate existing adapters from `packages/providers/adapters.ts`
-- Register with RuntimeApi for provider management

package/IMPLEMENTATION/RFC-0031/TASKS.md

@@ -1,48 +0,0 @@
-# RFC-0031 Implementation Tasks
-
-## Phase 1: SDK Foundation
-
-- [ ] Create `packages/provider-adapter-sdk/` directory
-- [ ] Set up package.json with dependencies
-- [ ] Create `src/types.ts` with SDK types
-- [ ] Create `src/errors.ts` with custom errors
-- [ ] Create `src/index.ts` public exports
-
-## Phase 2: Core Classes
-
-- [ ] Implement `AdapterBuilder` class
-  - [ ] Constructor with name parameter
-  - [ ] `config()` method
-  - [ ] `capabilities()` method
-  - [ ] `models()` method
-  - [ ] `rateLimits()` method
-  - [ ] `invoke()` method
-  - [ ] `parseError()` method
-  - [ ] `build()` method
-- [ ] Implement `AdapterRegistry` class
-  - [ ] `register()` with lifecycle hooks
-  - [ ] `unregister()` method
-  - [ ] `getAdapter()` method
-  - [ ] `listAdapters()` method
-  - [ ] `healthCheckAll()` method
-- [ ] Implement `AdapterTester` class
-  - [ ] `testBasicInvocation()`
-  - [ ] `testQuotaDetection()`
-  - [ ] `testErrorParsing()`
-  - [ ] `runAllTests()`
-
-## Phase 3: Compatibility & Migration
-
-- [ ] Implement version compatibility checks
-- [ ] Migrate MiniMax adapter to SDK
-- [ ] Migrate OpenAI adapter to SDK
-- [ ] Migrate Claude adapter to SDK
-- [ ] Add examples in `examples/` directory
-- [ ] Write unit tests
-
-## Phase 4: Documentation
-
-- [ ] Write README.md
-- [ ] Document all public APIs
-- [ ] Add JSDoc comments
-- [ ] Create migration guide

package/IMPLEMENTATION/RFC-0032/AI_BRIEF.md

@@ -1,45 +0,0 @@
-# RFC-0032 AI Brief: Checkpoint Engine
-
-## Summary
-
-An enhanced checkpoint system with incremental snapshots, diff-based storage, compression, and intelligent recovery strategies.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **CheckpointEngine** (`engine.ts`)
-   - Incremental vs full snapshot handling
-   - Recovery strategies (latest, fullest, specific, timestamp)
-   - Auto-pruning logic
-   - Checksum verification
-
-2. **StorageManager** (`storage.ts`)
-   - Parallel I/O for faster saves
-   - Gzip compression
-   - File rotation and management
-
-3. **DiffCalculator** (`differ.ts`)
-   - Calculate state diffs
-   - Apply incremental changes
-   - Merge delta changes
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- Existing `packages/checkpoint/checkpoint-manager.ts` (enhance, don't replace)
-
-### Files to Create/Modify
-
-- `packages/checkpoint/src/engine.ts` - main engine
-- `packages/checkpoint/src/storage.ts` - enhanced storage
-- `packages/checkpoint/src/differ.ts` - diff calculations
-- `packages/checkpoint/src/recovery.ts` - recovery strategies
-- `packages/checkpoint/src/indexer.ts` - metadata index
-- `packages/checkpoint/src/types.ts` - extended types
-
-### Backward Compatibility
-
-- Maintain JSON format compatibility
-- Detect and load legacy checkpoints
-- Export to legacy format if needed

package/IMPLEMENTATION/RFC-0032/TASKS.md

@@ -1,44 +0,0 @@
-# RFC-0032 Implementation Tasks
-
-## Phase 1: Engine Core
-
-- [ ] Create `packages/checkpoint/src/engine.ts`
-- [ ] Define `CheckpointEngineConfig` interface
-- [ ] Implement `save()` method with compression
-- [ ] Implement `load()` method
-- [ ] Add checksum generation and verification
-
-## Phase 2: Incremental Storage
-
-- [ ] Implement `saveIncremental()` method
-- [ ] Implement `loadIncremental()` method
-- [ ] Create `DiffCalculator` class
-- [ ] Define `StateDelta` interface
-- [ ] Implement delta application logic
-
-## Phase 3: Recovery System
-
-- [ ] Implement `recover()` method
-- [ ] Create recovery strategies:
-  - [ ] `latest` strategy
-  - [ ] `fullest` strategy
-  - [ ] `specific:version` strategy
-  - [ ] `timestamp:ISO` strategy
-  - [ ] `interactive` strategy
-- [ ] Implement `getMetadata()` for checkpoint listing
-
-## Phase 4: Storage & Performance
-
-- [ ] Implement parallel file I/O
-- [ ] Add gzip compression
-- [ ] Implement `prune()` method
-- [ ] Implement `verify()` for checksum validation
-- [ ] Add caching layer for frequent loads
-
-## Phase 5: Testing & Migration
-
-- [ ] Write migration tests from legacy format
-- [ ] Benchmark incremental vs full saves
-- [ ] Test recovery with various strategies
-- [ ] Verify backward compatibility
-- [ ] Performance testing with large jobs

package/IMPLEMENTATION/RFC-0033/AI_BRIEF.md

@@ -1,46 +0,0 @@
-# RFC-0033 AI Brief: Session Manager
-
-## Summary
-
-A comprehensive session management system for tracking user sessions, maintaining conversation history, and providing session persistence.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **SessionManager** (`manager.ts`)
-   - Session lifecycle (create, get, close, suspend, resume)
-   - Message history management
-   - Token accounting
-   - Metrics collection
-
-2. **SessionStore** (`store.ts`)
-   - Session persistence to disk
-   - Session indexing and retrieval
-   - Auto-cleanup of expired sessions
-
-3. **SessionPolicyEngine** (`policy.ts`)
-   - Evaluate session limits
-   - Token budget enforcement
-   - Cost tracking
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- `packages/checkpoint` - for session persistence
-- `packages/quota-manager` - for cost tracking
-
-### Files to Create
-
-- `packages/session/src/manager.ts`
-- `packages/session/src/store.ts`
-- `packages/session/src/history.ts`
-- `packages/session/src/policy.ts`
-- `packages/session/src/metrics.ts`
-- `packages/session/src/types.ts`
-- `packages/session/src/index.ts`
-
-### Integration Points
-
-- Integrate with RuntimeApi for session CRUD endpoints
-- Integrate with ContextWindowManager for token tracking

package/IMPLEMENTATION/RFC-0033/TASKS.md

@@ -1,49 +0,0 @@
-# RFC-0033 Implementation Tasks
-
-## Phase 1: Session Core
-
-- [ ] Create `packages/session/` directory
-- [ ] Define `Session`, `SessionMetadata`, `SessionContext` types
-- [ ] Create `SessionManager` class
-- [ ] Implement `createSession()`
-- [ ] Implement `getSession()`
-- [ ] Implement `closeSession()`
-
-## Phase 2: Lifecycle & State
-
-- [ ] Implement `suspendSession()`
-- [ ] Implement `resumeSession()`
-- [ ] Implement `listSessions()`
-- [ ] Add session timeout handling
-- [ ] Implement auto-suspend for idle sessions
-
-## Phase 3: Message History
-
-- [ ] Create `Message` types
-- [ ] Implement `addMessage()`
-- [ ] Implement `getHistory()` with pagination
-- [ ] Add full-text search support
-- [ ] Implement history pruning
-
-## Phase 4: Policy & Metrics
-
-- [ ] Create `SessionPolicyEngine`
-- [ ] Implement token budget evaluation
-- [ ] Implement cost tracking
-- [ ] Create `getMetrics()` method
-- [ ] Implement `getAllMetrics()`
-
-## Phase 5: Persistence
-
-- [ ] Create `SessionStore` class
-- [ ] Implement session serialization
-- [ ] Implement session restoration
-- [ ] Implement `pruneSessions()`
-- [ ] Implement `cleanupExpired()`
-
-## Phase 6: Integration
-
-- [ ] Integrate with RuntimeApi
-- [ ] Integrate with ContextWindowManager
-- [ ] Write integration tests
-- [ ] Performance benchmarks

package/IMPLEMENTATION/RFC-0034/AI_BRIEF.md

@@ -1,54 +0,0 @@
-# RFC-0034 AI Brief: Observability
-
-## Summary
-
-A comprehensive observability system with structured logging, distributed tracing, metrics collection, health monitoring, and alerting.
-
-## Implementation Overview
-
-### Key Classes to Implement
-
-1. **Logger** (`logger.ts`)
-   - Structured JSON logging
-   - Correlation ID tracking
-   - Log levels and formatting
-   - Child loggers with defaults
-
-2. **Tracer** (`tracer.ts`)
-   - OpenTelemetry compatible
-   - Span management
-   - Distributed tracing
-   - Async wrapper utilities
-
-3. **Metrics** (`metrics.ts`)
-   - Counters, Gauges, Histograms
-   - Prometheus export format
-   - Built-in runtime metrics
-
-4. **HealthMonitor** (`health.ts`)
-   - Health check registration
-   - Liveness/readiness probes
-   - Component health tracking
-
-5. **AlertEngine** (`alerts.ts`)
-   - Alert rule evaluation
-   - Alert actions (log, notify, webhook)
-   - Alert history
-
-### Dependencies
-
-- `packages/types` - for runtime-types
-- Optional: `@opentelemetry/sdk-node` - OTLP export
-- Optional: `prom-client` - Prometheus format
-
-### Files to Create
-
-- `packages/observability/src/logger.ts`
-- `packages/observability/src/tracer.ts`
-- `packages/observability/src/metrics.ts`
-- `packages/observability/src/health.ts`
-- `packages/observability/src/alerts.ts`
-- `packages/observability/src/exporters/prometheus.ts`
-- `packages/observability/src/exporters/otlp.ts`
-- `packages/observability/src/middleware.ts`
-- `packages/observability/src/index.ts`

package/IMPLEMENTATION/RFC-0034/TASKS.md

@@ -1,57 +0,0 @@
-# RFC-0034 Implementation Tasks
-
-## Phase 1: Logger
-
-- [ ] Create `packages/observability/` directory
-- [ ] Define `LoggerConfig` and `LogEntry` types
-- [ ] Implement `Logger` class
-- [ ] Implement correlation ID tracking
-- [ ] Add child logger support
-- [ ] Add file rotation support
-
-## Phase 2: Tracer
-
-- [ ] Define span types
-- [ ] Implement `Tracer` class
-- [ ] Implement `startSpan()` and `endSpan()`
-- [ ] Add OpenTelemetry compatible output
-- [ ] Implement `trace()` async wrapper
-- [ ] Add span attributes and events
-
-## Phase 3: Metrics
-
-- [ ] Implement `Metrics` class
-- [ ] Add counter, gauge, histogram support
-- [ ] Add built-in runtime metrics
-- [ ] Implement Prometheus export
-- [ ] Create `asyncTimer()` helper
-
-## Phase 4: Health Monitor
-
-- [ ] Implement `HealthMonitor` class
-- [ ] Add health check registration
-- [ ] Implement `checkHealth()`
-- [ ] Add liveness probe endpoint
-- [ ] Add readiness probe endpoint
-
-## Phase 5: Alerting
-
-- [ ] Define `AlertRule` and `AlertCondition` types
-- [ ] Implement `AlertEngine` class
-- [ ] Implement rule evaluation
-- [ ] Add alert actions (log, notify, webhook)
-- [ ] Implement alert history
-
-## Phase 6: Exporters & Middleware
-
-- [ ] Create Prometheus exporter
-- [ ] Create OTLP exporter
-- [ ] Create Express/HTTP middleware
-- [ ] Add metrics endpoint
-
-## Phase 7: Integration
-
-- [ ] Integrate with RuntimeApi
-- [ ] Add correlation IDs to all components
-- [ ] Export default metrics
-- [ ] Performance testing