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 type (landingai_ade.types.v2.job): added new field metadata: Optional[object] — the result's metadata receipt (V2ParseMetadata for parse jobs, V2ExtractMetadata for extract jobs), surfaced when a job created with output_save_url completes (delivery goes to output_url, but the metadata receipt stays on Job.metadata). Inline jobs leave Job.metadata as None, carrying it inside result.metadata instead.
• Job normalization (normalize_parse_job, normalize_extract_job): now parse the envelope's top-level metadata field and populate Job.metadata accordingly.
• Spec/doc updates: parse_jobs/extract_jobs status responses (v2-aide.json) gained a metadata field alongside output_url; progress field description clarified as an estimate (no schema/type change). No new endpoints, routes, or request parameters were added.
• Workflow-related spec entries (/v2/workflow*) are out of scope for this SDK and unchanged in terms of client surface — not summarized here per SDK scope.

[Copilot]

Pull request overview

Updates the V2 OpenAPI snapshot and regenerated reference models to reflect job metadata and progress semantics.

Changes:

• Adds metadata to completed extract and parse delivery jobs.
• Clarifies estimated progress behavior.
• Regenerates models and removes stale build-schema operation models.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
specs/v2-aide.json	Updates V2 job response contracts.
specs/_generated/v2_models.py	Regenerates reference models from the snapshot.

[Copilot]

Pull request overview

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