Skip to content

docs(runtime): define safe recovery for PDF rejections - #4818

Open
seekskyworld wants to merge 1 commit into
apache:mainfrom
seekskyworld:docs/3285-pdf-rejection-recovery
Open

docs(runtime): define safe recovery for PDF rejections#4818
seekskyworld wants to merge 1 commit into
apache:mainfrom
seekskyworld:docs/3285-pdf-rejection-recovery

Conversation

@seekskyworld

@seekskyworld seekskyworld commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Refs #3285

Records the current runtime decision for provider PDF rejections: Maka does not perform a PDF-free retry until a provider adapter supplies structured, request-level evidence that proves the rejection occurred before provider work or tool effects. The document now includes the exact parsed error shapes accepted by the current classifier and the source paths audited.

Verification

  • git diff --check
  • Source audit against packages/runtime/src/provider-error-classification.ts, packages/runtime/src/model-adapter.ts, and packages/core/src/attachments.ts
  • Documentation-only change; no runtime behavior or test suite is changed.

AI use

  • No generative tool made a substantive contribution
  • Generative tooling made a substantive contribution

Tool(s) and scope: OpenAI Codex authored the decision document and reviewed the linked runtime contracts.

Checklist

  • Tests cover the change and fail without it
  • Lint, format, typecheck and the affected suites pass locally

Does this PR entail a change in behavior?

  • Yes — described under Summary above
  • No

Generated-by: OpenAI Codex
Signed-off-by: seekskyworld <djh1813553759@gmail.com>
@seekskyworld
seekskyworld force-pushed the docs/3285-pdf-rejection-recovery branch from 6709337 to 08dd40d Compare September 5, 2026 02:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

effort/S Under 100 readable lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant