Service / document.analysis

Document Analysis

Extract normalized forms, tables, signatures, or layout from a document.

Active Open SKILL.md Input schema

01 / Outcome

What this service does

Prepared, admitted, and continued durably after the initial HTTP response.

Best for

Documents where forms, tables, signatures, or layout need structured extraction.

Returns

A normalized page manifest with receipt-bound result artifacts.

02 / Price

One clear Ausca price.

The catalog defines the range. Live preparation or the payment challenge returns binding terms.

Ausca price

$0.30–$0.75

Bounded range. Preparation fixes the exact price from the immutable artifact size before payment.

Read the service SKILL.md

Exact terms

Model: artifact_bytes
Minimum: 30 USD-minor
Maximum: 75 USD-minor
Unit amount: 5 USD-minor
Unit bytes: 1048576

The live preparation or payment challenge is binding. This page never invents a price.

Pricing starts at $0.30: a base amount plus $0.05 per started 1 MiB, up to $0.75 at the current artifact limit. The live preparation is binding.

03 / Contract

Pinned before execution.

These values are generated from the active, digest-verified catalog revision.

Status: Active
Offer: document.analysis
Revision: analysis-bytes-r3
Execution: Async
Input artifact: Up to 10 MiB
Bounded wait: 30 minutes
Result retention: 24 hours
Inline result: Up to 64 KiB
Receipt evidence: Required at success
Revision digest: sha256:0b34722b814a7d2540b2007c8ec8d1afbad03425fafbe6049d604eda55a5e964
Input schema digest: sha256:7093216a29925031972d61a7ab5f6013936aac9f81c3c54f51a00a3fef66759b
Output schema digest: sha256:116e5cb84aa984e46e2a7e58f46b9cee3185e8d95f4b7bb5adad78ab66c68bb0

Input schema Output schema OpenAPI Catalog manifest

04 / Invoke

Use the entry point that fits.

Start with SKILL.md for agents, HTTP + x402 for HTTP integrations, or MCP for generated tools.

SKILL.md Recommended for agents

Start from the exact versioned instructions for this service. The skill describes the capability, inputs, payment boundary, retry identity, and evidence without requiring an agent to scrape this page.

Fetch the skill sh

curl --fail --silent --show-error https://ausca.com/skills/document-analysis/SKILL.md

Exact identity: ausca/document-analysis@0.1.0, digest sha256:bb92ded6bc400ac4c3e7e409610e188b07615b804d9e894d999e64e320dc68a5.

HTTP + x402 HTTP client

Send the exact invocation envelope without payment material to discover live binding terms. Use a supported x402 client for the authorized retry; do not paste a sample signature.

Unsigned discovery sh

curl --request POST https://ausca.com/v1/invocations \
  --header 'Content-Type: application/json' \
  --data @ausca-document-analysis-request.json

ausca-document-analysis-request.json json

{
  "canonicalizer_version": "runx.receipt.c14n.v1",
  "idempotency_key": "ausca-document-analysis-example-0001",
  "input": {
    "artifact": {
      "artifact_ref": "runx:artifact:sha256:4444444444444444444444444444444444444444444444444444444444444444",
      "content_digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
      "media_type": "application/pdf"
    },
    "feature_types": [
      "FORMS",
      "TABLES"
    ]
  },
  "input_schema_digest": "sha256:7093216a29925031972d61a7ab5f6013936aac9f81c3c54f51a00a3fef66759b",
  "offer_id": "document.analysis",
  "offer_revision": "analysis-bytes-r3",
  "offer_revision_digest": "sha256:0b34722b814a7d2540b2007c8ec8d1afbad03425fafbe6049d604eda55a5e964",
  "output_schema_digest": "sha256:116e5cb84aa984e46e2a7e58f46b9cee3185e8d95f4b7bb5adad78ab66c68bb0"
}

Expected first response: 402 with matching x402 v2 PAYMENT-REQUIRED header and body. A valid paid retry returns the admitted or replayed invocation.

MCP Discovery and control

MCP projects the same Ausca contract. Paid invocation is disabled by default and must be enabled deliberately by a compatible host. MCP does not carry x402 HTTP headers.

ausca_invoke_offer json

{
  "jsonrpc": "2.0",
  "id": "document-analysis-example",
  "method": "tools/call",
  "params": {
    "name": "ausca_invoke_offer",
    "arguments": {
      "canonicalizer_version": "runx.receipt.c14n.v1",
      "idempotency_key": "ausca-document-analysis-example-0001",
      "input": {
        "artifact": {
          "artifact_ref": "runx:artifact:sha256:4444444444444444444444444444444444444444444444444444444444444444",
          "content_digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
          "media_type": "application/pdf"
        },
        "feature_types": [
          "FORMS",
          "TABLES"
        ]
      },
      "input_schema_digest": "sha256:7093216a29925031972d61a7ab5f6013936aac9f81c3c54f51a00a3fef66759b",
      "offer_id": "document.analysis",
      "offer_revision": "analysis-bytes-r3",
      "offer_revision_digest": "sha256:0b34722b814a7d2540b2007c8ec8d1afbad03425fafbe6049d604eda55a5e964",
      "output_schema_digest": "sha256:116e5cb84aa984e46e2a7e58f46b9cee3185e8d95f4b7bb5adad78ab66c68bb0"
    }
  }
}

Expected response: the generated invocation result shape. Use ausca_get_invocation for authoritative state and the receipt reference.

05 / Lifecycle

One purchase identity to terminal state.

A connection can end while durable work continues. Read back the invocation; do not create a second purchase.

01 prepare
02 payment terms
03 admitted
04 running
05 terminal

A 202 response means the invocation was admitted, not that execution failed to finish inline. Read the same invocation until it reaches a terminal state.

Cancellation is a bounded request and can lose a race with completion. Results remain available for 24 hours. Retry uncertain purchases with the same idempotency key.

06 / Contract examples

A complete request, from authority.

Replace the example artifact commitment and idempotency key. Keep the same key when retrying an uncertain purchase.

Invocation request json

{
  "canonicalizer_version": "runx.receipt.c14n.v1",
  "idempotency_key": "ausca-document-analysis-example-0001",
  "input": {
    "artifact": {
      "artifact_ref": "runx:artifact:sha256:4444444444444444444444444444444444444444444444444444444444444444",
      "content_digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
      "media_type": "application/pdf"
    },
    "feature_types": [
      "FORMS",
      "TABLES"
    ]
  },
  "input_schema_digest": "sha256:7093216a29925031972d61a7ab5f6013936aac9f81c3c54f51a00a3fef66759b",
  "offer_id": "document.analysis",
  "offer_revision": "analysis-bytes-r3",
  "offer_revision_digest": "sha256:0b34722b814a7d2540b2007c8ec8d1afbad03425fafbe6049d604eda55a5e964",
  "output_schema_digest": "sha256:116e5cb84aa984e46e2a7e58f46b9cee3185e8d95f4b7bb5adad78ab66c68bb0"
}

Result shape json

{
  "pages": [
    {
      "artifact_ref": "runx:artifact:sha256:6666666666666666666666666666666666666666666666666666666666666666",
      "content_digest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
      "page_index": 1,
      "size_bytes": 1024
    }
  ],
  "provider_job_ref": "runx:aws:textract-analysis:analysis-fixture",
  "schema": "ausca.document_analysis.manifest.v1",
  "source_digest": "sha256:5555555555555555555555555555555555555555555555555555555555555555"
}

Recommended agent entry

ausca/document-analysis@0.1.0

Extract structured document data through Ausca's measured asynchronous document analysis service.

Read the exact SKILL.md

Digest-bound skill reference text

SKILL.md: https://ausca.com/skills/document-analysis/SKILL.md
Service: https://ausca.com/services/document-analysis
Offer: document.analysis
Revision: sha256:0b34722b814a7d2540b2007c8ec8d1afbad03425fafbe6049d604eda55a5e964
Input schema: https://ausca.com/schemas/offers/document-analysis.input.schema.json
Output schema: https://ausca.com/schemas/offers/document-analysis.output.schema.json
Endpoint: POST https://ausca.com/v1/invocations
Pricing: artifact_bytes; resolve binding terms from live preparation or payment challenge.

Executed through an Ausca-owned document analysis capability behind the governed provider boundary.