pdf.inspect.form | Runstamp Docs

Describe an AcroForm's fields and structure.

Use describe("pdf.inspect.form") when your code needs the complete live JSON Schemas.

At a glance

Property	Value
Package	`@runstamp/forms`
Domain / verb	`pdf` / `inspect`
Customer jobs	read, review
Deterministic	Yes
Side effects	none

Availability

Local	SDK	CLI	MCP	Managed API
public ga	public ga	public ga	public ga	public ga

Managed API route: POST /api/v2/operations/pdf/inspect/form. Managed execution requires a free-trial workspace or an active Platform or Enterprise workspace, and an environment-bound API key.

Input and result

Schema	Required fields	Optional fields
Input	`artifactId`, `bytesBase64`, `sha256`, `tenantId`, `version`	none
Options	none	`operation`, `deterministic`, `deterministicSeed`, `timeoutMs`, `limits`, `locale`, `lossPolicy`
Result value	`output`, `artifacts`	none

Every success also carries losses, diagnostics, and a hash-bound receipt.

Defaults, limits, and format constraints

Defaults

Path	Default
`$.deterministic`	`default=true`
`$.lossPolicy`	`default="collect"`

Formats and profiles

Path	Constraint
`$.version`	`minLength=1` `maxLength=16384`

Other limits

Path	Constraint
`$.artifactId`	`pattern="^[a-f0-9]{64}$"`
`$.bytesBase64`	`minLength=4` `maxLength=89478492` `pattern="^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`
`$.sha256`	`pattern="^[a-f0-9]{64}$"`
`$.tenantId`	`minLength=1` `maxLength=16384`
`$.deterministicSeed`	`minLength=1` `maxLength=1024`
`$.timeoutMs`	`minimum=1`
`$.limits.maxInputBytes`	`minimum=1`
`$.limits.maxOutputBytes`	`minimum=1`
`$.limits.maxPages`	`minimum=1`
`$.limits.maxElements`	`minimum=1`
`$.limits.maxArchiveEntries`	`minimum=1`
`$.limits.maxExpansionRatio`	`minimum=1`
`$.limits.maxDurationMs`	`exclusiveMinimum=0` `maximum=2147483647`
`$.locale`	`minLength=1` `maxLength=128`

Invoke

const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.inspect.form/input.json").then((response) => response.json());
const result = await runstamp.run("pdf.inspect.form", input);
if (!result.ok) throw new Error(`${result.error.code}: ${result.error.remediation}`);
console.log(result.value, result.losses, result.diagnostics, result.receipt);

curl -fsS https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.inspect.form/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke pdf.inspect.form --input input.json

{
  "tool": "runstamp_invoke_operation",
  "arguments": {
    "operation": "pdf.inspect.form",
    "input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.inspect.form/input.json>",
    "execution_mode": "local"
  }
}

Errors and losses

Declared errors (27)

pdf/A03_BINDING_MISMATCH
pdf/ABORTED
pdf/ACTIVE_ACTION
pdf/BINDING_MISMATCH
pdf/DUPLICATE_FIELD_NAME
pdf/FIELD_UNKNOWN
pdf/FIELD_UNSUPPORTED
pdf/FLATTEN_FAILED
pdf/FORM_INVALID
pdf/INVALID_INPUT
pdf/INVALID_VALUE
pdf/MALFORMED_APPEARANCE
pdf/MALFORMED_WIDGET
pdf/OUTPUT_HASH_MISMATCH
pdf/POST_MUTATION_CHECK_FAILED
pdf/PROTECTED_FORM
pdf/RESOURCE_LIMIT
pdf/SIGNED_INPUT
pdf/SIGNING_PROVIDER_REQUIRED
pdf/TIMEOUT
pdf/WIDGET_COUNT_MISMATCH
pdf/SCHEMA_REJECTED
common/SCHEMA_REJECTED
common/OPERATION_CANCELLED
common/OPERATION_TIMEOUT
common/CONTRACT_VIOLATION
pdf/LOSS_POLICY_VIOLATED

Declared losses (2)

pdf/FORM_INTERACTIVITY_REMOVED
pdf/FORM_APPEARANCE_DEFERRED

SDK AbortSignal, CLI exit 130, and MCP cancellation return the typed common/OPERATION_CANCELLED failure envelope.

Verified example and exact contract

Fixture: icp-workflow (Employee onboarding EMP-2027-00418).
Example input — SHA-256 84eb35381a2956daa37967acf24c0f8facbe3c25e52c4d68236ddab81760ae99.
Example result — SHA-256 e2ebe5e5a5df538aa497bcc684fbd5ea6c8cdaba711132a4c7e164efc1b8028e.
Verified result SHA-256: 0d9916d978116d1d0f49f0eec6486fbfcfacda07c368aca9607cdc07ab63b176.
Qualification lane: 12-approval-forms-review.

Contract fingerprints

Descriptor: e8bcb8abdbf48445e7a5067ae147ee6a1383becf3d6d6b6a979acb9b0e27c52e.
Input schema: 668d2f979605386f2ffd1fdc2f2e688b4833f9dcf1cb4d154fa7b2a4803804b3.
Options schema: 2cefa3b4c991adf4c32cc66c8e5ffd1322f92b755dcee2851067d87fc341bef6.
Result value schema: 1c35f7793a0b9141c1f1aedf70e448f26595eac812b7bc2b0fa5fd22c86f6fa2.

The machine-readable operation reference publishes the complete schemas, qualification results, and evidence bindings for every operation.

Describe an AcroForm's fields and structure.

Use describe("pdf.inspect.form") when your code needs the complete live JSON Schemas.

At a glance

Property	Value
Package	`@runstamp/forms`
Domain / verb	`pdf` / `inspect`
Customer jobs	read, review
Deterministic	Yes
Side effects	none

Availability

Local	SDK	CLI	MCP	Managed API
public ga	public ga	public ga	public ga	public ga

Managed API route: POST /api/v2/operations/pdf/inspect/form. Managed execution requires a free-trial workspace or an active Platform or Enterprise workspace, and an environment-bound API key.

Input and result

Schema	Required fields	Optional fields
Input	`artifactId`, `bytesBase64`, `sha256`, `tenantId`, `version`	none
Options	none	`operation`, `deterministic`, `deterministicSeed`, `timeoutMs`, `limits`, `locale`, `lossPolicy`
Result value	`output`, `artifacts`	none

Every success also carries losses, diagnostics, and a hash-bound receipt.

Defaults, limits, and format constraints

Defaults

Path	Default
`$.deterministic`	`default=true`
`$.lossPolicy`	`default="collect"`

Formats and profiles

Path	Constraint
`$.version`	`minLength=1` `maxLength=16384`

Other limits

Path	Constraint
`$.artifactId`	`pattern="^[a-f0-9]{64}$"`
`$.bytesBase64`	`minLength=4` `maxLength=89478492` `pattern="^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)?$"`
`$.sha256`	`pattern="^[a-f0-9]{64}$"`
`$.tenantId`	`minLength=1` `maxLength=16384`
`$.deterministicSeed`	`minLength=1` `maxLength=1024`
`$.timeoutMs`	`minimum=1`
`$.limits.maxInputBytes`	`minimum=1`
`$.limits.maxOutputBytes`	`minimum=1`
`$.limits.maxPages`	`minimum=1`
`$.limits.maxElements`	`minimum=1`
`$.limits.maxArchiveEntries`	`minimum=1`
`$.limits.maxExpansionRatio`	`minimum=1`
`$.limits.maxDurationMs`	`exclusiveMinimum=0` `maximum=2147483647`
`$.locale`	`minLength=1` `maxLength=128`

Invoke

const input = await fetch("https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.inspect.form/input.json").then((response) => response.json());
const result = await runstamp.run("pdf.inspect.form", input);
if (!result.ok) throw new Error(`${result.error.code}: ${result.error.remediation}`);
console.log(result.value, result.losses, result.diagnostics, result.receipt);

curl -fsS https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.inspect.form/input.json -o input.json
npx -p @runstamp/sdk runstamp ops invoke pdf.inspect.form --input input.json

{
  "tool": "runstamp_invoke_operation",
  "arguments": {
    "operation": "pdf.inspect.form",
    "input": "<JSON from https://runstamp.com/demo-evidence/operation-evidence/forms/pdf.inspect.form/input.json>",
    "execution_mode": "local"
  }
}

Errors and losses

Declared errors (27)

pdf/A03_BINDING_MISMATCH
pdf/ABORTED
pdf/ACTIVE_ACTION
pdf/BINDING_MISMATCH
pdf/DUPLICATE_FIELD_NAME
pdf/FIELD_UNKNOWN
pdf/FIELD_UNSUPPORTED
pdf/FLATTEN_FAILED
pdf/FORM_INVALID
pdf/INVALID_INPUT
pdf/INVALID_VALUE
pdf/MALFORMED_APPEARANCE
pdf/MALFORMED_WIDGET
pdf/OUTPUT_HASH_MISMATCH
pdf/POST_MUTATION_CHECK_FAILED
pdf/PROTECTED_FORM
pdf/RESOURCE_LIMIT
pdf/SIGNED_INPUT
pdf/SIGNING_PROVIDER_REQUIRED
pdf/TIMEOUT
pdf/WIDGET_COUNT_MISMATCH
pdf/SCHEMA_REJECTED
common/SCHEMA_REJECTED
common/OPERATION_CANCELLED
common/OPERATION_TIMEOUT
common/CONTRACT_VIOLATION
pdf/LOSS_POLICY_VIOLATED

Declared losses (2)

pdf/FORM_INTERACTIVITY_REMOVED
pdf/FORM_APPEARANCE_DEFERRED

SDK AbortSignal, CLI exit 130, and MCP cancellation return the typed common/OPERATION_CANCELLED failure envelope.

Verified example and exact contract

Fixture: icp-workflow (Employee onboarding EMP-2027-00418).
Example input — SHA-256 84eb35381a2956daa37967acf24c0f8facbe3c25e52c4d68236ddab81760ae99.
Example result — SHA-256 e2ebe5e5a5df538aa497bcc684fbd5ea6c8cdaba711132a4c7e164efc1b8028e.
Verified result SHA-256: 0d9916d978116d1d0f49f0eec6486fbfcfacda07c368aca9607cdc07ab63b176.
Qualification lane: 12-approval-forms-review.

Contract fingerprints

Descriptor: e8bcb8abdbf48445e7a5067ae147ee6a1383becf3d6d6b6a979acb9b0e27c52e.
Input schema: 668d2f979605386f2ffd1fdc2f2e688b4833f9dcf1cb4d154fa7b2a4803804b3.
Options schema: 2cefa3b4c991adf4c32cc66c8e5ffd1322f92b755dcee2851067d87fc341bef6.
Result value schema: 1c35f7793a0b9141c1f1aedf70e448f26595eac812b7bc2b0fa5fd22c86f6fa2.

The machine-readable operation reference publishes the complete schemas, qualification results, and evidence bindings for every operation.