vpp-ai-platform/skills-py/vpp_contracts/potential_assessment_request.py
Thomas Bayes 23fdf49ff2
Some checks are pending
ci / typescript (push) Waiting to run
ci / python (push) Waiting to run
ci / evals (push) Blocked by required conditions
M4: resource agent, envelopes live, review loop, insight cards
- packages/domain: AwardNotice, DISPATCH_PLAN proposal payload, ExecutionReport,
  MeteringRecord, potential-assessment and dispatch-optimization contracts,
  ReviewFinding (+ typed writebacks), SemanticMemoryEntry,
  EnvelopeChangeRequest, InsightCard — exported with fixtures on both sides.
- skills-py: potential-assessment (certified × rolling fulfilment, evidence
  days) and dispatch-optimization (per-interval LP on HiGHS, shortfall
  reported) skills + routes + tests.
- packages/services: dispatch rules in the policy pack (over-allocation,
  award anchor, lineage integrity for allocations); PowerBalanceSimulator;
  SimulationGateway (permit-only, idempotent, seeded execute → ExecutionReports);
  envelope deviation-streak suspension + apply(); ReviewService (attribution,
  reliability EWMA writeback, semantic memory, envelope recommendations as
  change requests); dispatch assembler; skill client methods.
- packages/runtime: resource agent; award-decomposition, review and
  envelope-review workflows; lifecycle selects simulator/gateway by proposal
  type; trigger hooks for awards, execution reports, metering; decide()
  resumes either lifecycle or envelope-review runs; insight cards API.
- Tests: docs/07 D-1 16:00 and D+1 end to end; reliability score 0.9 → 0.880
  and the next assessment de-rates capacity; envelope suspension on a seeded
  3-day streak; WIDEN request applied only by a human. 184 TS + 80 Python.
- docs/open-questions: B10 (reliability/potential parameters). README and
  CLAUDE.md status → M4 done, M5 next.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UoYoGYzHkFyv3ALenkRPhA
2026-09-02 19:31:12 -04:00

69 lines
1.8 KiB
Python

# generated by datamodel-codegen:
# filename: potential_assessment_request.json
from __future__ import annotations
from enum import StrEnum
from pydantic import AwareDatetime, BaseModel, ConfigDict, Field, conint, constr
class Type(StrEnum):
STORAGE = 'STORAGE'
PV = 'PV'
EV_CHARGER = 'EV_CHARGER'
HVAC = 'HVAC'
INDUSTRIAL_LOAD = 'INDUSTRIAL_LOAD'
MICROGRID = 'MICROGRID'
BASE_STATION = 'BASE_STATION'
class Constraints(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
min_duration_min: conint(le=9007199254740991, gt=0) | None
recovery_rate_mw_per_min: constr(pattern=r'^-?\d+(\.\d+)?$') | None
class Profile(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
resource_id: constr(min_length=1)
name: constr(min_length=1)
type: Type
rated_power_mw: constr(pattern=r'^-?\d+(\.\d+)?$')
certified_adjustable_mw: constr(pattern=r'^-?\d+(\.\d+)?$')
confidence: constr(pattern=r'^-?\d+(\.\d+)?$')
reliability_score: constr(pattern=r'^-?\d+(\.\d+)?$')
constraints: Constraints
evidence_refs: list[constr(pattern=r'^[0-9a-f]{64}$')]
updated_at: AwareDatetime
class FulfillmentItem(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
market_date: constr(pattern=r'^\d{4}-\d{2}-\d{2}$')
planned_mwh: constr(pattern=r'^-?\d+(\.\d+)?$')
delivered_mwh: constr(pattern=r'^-?\d+(\.\d+)?$')
class Resource(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
profile: Profile
fulfillment: list[FulfillmentItem]
class PotentialAssessmentRequest(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
market_date: constr(pattern=r'^\d{4}-\d{2}-\d{2}$')
resources: list[Resource] = Field(..., min_length=1)
features_snapshot_ref: constr(pattern=r'^[0-9a-f]{64}$')