The source launcher ./stateset-edi opens the terminal console; arguments select JSON
commands for agents. CLI 0.10.2 requires Python 3.8+ with curses for the interactive
view. Run ./stateset-edi --demo for an offline simulation.
Discover before acting
commands exposes versioned effect and argument metadata, including nested paths, arity,
repeatable flags, and global-option placement. explain -- ... classifies concrete arguments
locally without reading credentials/payloads or contacting the API. Neither grants authority.
Use api describe for contract schemas and api call or api request for other routes.
Terminal workbench
Tables retain focus and filter cursors across tabs. Filters and captured pickers operate
on loaded/captured rows; they do not establish complete server coverage. id-exact: and
ref-exact: compare case-sensitive literal identities; ordinary id:/ref: are substring
filters. Use partner scope where references repeat.
Below 60 columns or 18 rows, input pauses; queued keys are discarded when visible again.
Requests already started continue, and their results remain available. Local searching,
resizing, and exporting do not repeat a request or authorize recovery.
Use portable order reviews for outbound fulfillment.
review-inspect checks captured facts locally. order-send submits the retained request
without another noninteractive confirmation prompt. Changed connection or credential
context can invalidate prepared observations; do not substitute new evidence for the
original operation after response loss.
Read delivery evidence
The client checks requested identity and compares reported current receipt/message/MIC
metadata. metadata_consistent is a client assessment, not independent S/MIME verification.
Missing metadata remains unknown. Preserve HTTP/correlation IDs and original response data;
a successful read does not prove transport or business completion.
Build a portable archive from source with
python3 tui/package.py --output /tmp/stateset-edi-0.10.2.pyz. Its version reports a
reproducible build identity. Treat exported reviews and artifacts according to their content.
JavaScript SDK
The source package @stateset/edi-client 0.1.3 requires Node 20+ or a compatible Fetch
runtime. Use it in a trusted server integration. Build/install a local tarball from sdk/;
package qualification does not establish public registry publication.
The example runs from a directory containing your stateset-edi source checkout:
previewOrder() and sendReviewedOrder() support frozen overrides, original key, and
order revision. outbound() requires idempotencyKey and supports ten X12 types plus
EDIFACT INVOIC/DESADV. Its reviewed allowlist does not include REST 753/INVRPT; use those
REST routes directly. request() is a generic API helper, not the CLI’s complete response
assessment layer.
The client refuses redirects and bounds response size/time. EdiError reports code,
status, retryAfterSeconds, and outcomeUnknown. It does not automatically retry writes.
Persist original requests durably and verify the returned artifact and business outcome. Last modified on October 20, 2026
