spec-sync: track V2 spec drift

[yzld2002]

Automated V2 spec-sync PR (client.v2).

• Commit 1 (mechanical): normalized V2 spec snapshot + regenerated reference models.
• Commit 2 (AI, only if the spec diff needs SDK changes): client.v2 resources/methods/tests/docs wired from the diff, added after this PR opened. Workflow-only drift is excluded and an AI no-op is skipped, so some drifts produce a mechanical-only PR with no second commit.

Gates (surface-lock, V2 contract tests, lint/test/typecheck) must pass. When present, the AI commit is a draft a human finishes (the V2 ergonomic layer — unified Job, dual-host, schema coercion — is not in the spec). Human review required before merge.

What changed

AI-generated from the PR diff — verify against the actual changes.

Job (types/v2/job.py)

• New field Job.metadata: Optional[Dict[str, object]] — the result's metadata receipt (billing included), populated only for jobs completed via output_save_url (result delivered to output_url instead of inline). None for inline jobs, where metadata remains on result.metadata.
• Normalization (normalize_parse_job, normalize_extract_job) now extracts top-level metadata from the raw job envelope into Job.metadata.

Spec/doc notes (non-breaking, descriptive only)

• parse_jobs / extract_jobs poll responses gain an optional top-level metadata field (mirrors the above), documented in specs/v2-aide.json.
• progress field description clarified as an estimate (not a precise measurement); no schema/type change.

No endpoint, route, or method signature changes.

[Copilot]

Pull request overview

Updates the V2 OpenAPI snapshot and regenerated reference models to track current service behavior.

Changes:

• Adds delivered-result metadata to parse and extract job responses.
• Clarifies estimated progress semantics.
• Regenerates models, removing stale build-schema operation models and updating generated references.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
specs/v2-aide.json	Updates job metadata and progress contracts.
specs/_generated/v2_models.py	Regenerates models from the updated specification.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated no new comments.

Suppressed comments (1)

specs/_generated/v2_models.py:549

• The regeneration removes all V2ExtractBuildSchema* endpoint models (and the snapshot no longer contains /v2/extract/build-schema* paths), but the PR description characterizes this as metadata/progress-only drift and explicitly says there are no endpoint or route changes. That omission hides a material spec-surface deletion from reviewers. Please update the PR summary to call out the removed spec routes, or restore them if their removal was unintended.

class V2ExtractJobsGetParametersQuery(BaseModel):