Skip to main content

alter-sdk-mercury

Install pip install alter-sdk-mercury. Core alter-sdk is installed as a dependency.

Import MercuryIntegration from alter_sdk_mercury and construct it with an Alter App and {"grant_id": grant_id}. All 90 operations use immutable contract 2026-11-10. Await call.wait() for immediate or approved execution, then decode with result.body_json(). OAuth and managed-secret/API-key grants use the same binding and controls.

Public API reference includes every operation's input/output fields and both SDK examples.

Resume after a process restart

Persist the pending call's approvalId (TypeScript) or approval_id (Python) in your durable job record. After restarting, construct a fresh provider client:

const resumed = await provider.resume(savedApprovalId);
const result = await resumed.wait();
const body = result.bodyJson();
resumed = await provider.resume(saved_approval_id)
result = await resumed.wait()
body = result.body_json()

The backend supplies the stored provider, operation and immutable contract version. The provider package verifies provider/version and applies that operation's validator and fault handling. Mismatches raise ManagedOperationError with managed_approval_contract_mismatch or managed_approval_operation_mismatch. The ID yields a union of operation outputs; TypeScript callers can narrow the call by resumed.operation. No operation or version is accepted from the caller.

Generic app.integrations.resume(id) preserves raw response access and exact-number decoding; use the provider package for its response validator. Both use the existing approval poll's proxy:execute or approvals:read permissions and app/agent isolation. Resume also works after execution while the result is retained. Denial, expiry, execution failure and result purging retain the existing approval errors. Resume never resubmits the request. Raw approvals or missing stored identities fail with managed_approval_identity_unavailable.

Metadata

Release files for alter-sdk-mercury 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for alter-sdk-mercury 0.1.0
File Size Uploaded Provenance Actions
alter_sdk_mercury-0.1.0.tar.gz 123.9 kB With provenance Details for alter_sdk_mercury-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for alter-sdk-mercury 0.1.0
File Interpreter ABI Platform Actions
alter_sdk_mercury-0.1.0-py3-none-any.whl Python 3 none any Details for alter_sdk_mercury-0.1.0-py3-none-any.whl

Total release size: 254.9 kB

Release files / alter_sdk_mercury-0.1.0.tar.gz

Download URL alter_sdk_mercury-0.1.0.tar.gz
Size 123.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0fa7dd6cd80ea9ace21bf77094456d470e92f3bcb4f339f3c8c9015eca557cc8
BLAKE2b-256 checksum
How to use checksums
600af4a6fa9fa3319c19249088b4e07bc69d9742daaed68df67be9fe10830533
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / alter_sdk_mercury-0.1.0-py3-none-any.whl

Download URL alter_sdk_mercury-0.1.0-py3-none-any.whl
Size 131.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c6b5dacb37413d98fb37d64fba4019e76b4d5859adb405ded2af3fe44b973e30
BLAKE2b-256 checksum
How to use checksums
0a707f7714b4f996e4404ddc8d87e793ec597ebdadc1942ffe87da762ae4f716
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for alter-sdk-mercury 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for alter_sdk_mercury-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page