gloo_procedure_sdk is preinstalled in a Forge Python procedure sandbox. Networked helpers are
async. Importing the package installs its egress guard when GLOO_EGRESS_POLICY is present; the
guard is a no-op when that policy is absent.
Root exports
Call a capability
network, and dispatch must grant the session that domain and the fetch operation. Use an approved URL for the procedure’s task. The platform proxy resolves the network provider and records the call. Its normalized response has status, headers, and body; JSON content is decoded and other content is returned as text. The capability performs one request without retrying it. Vendor secrets must not be embedded in these arguments.
For direct Linear pagination, use the Vendor Connection procedure, not an invented linear capability domain.
Read knowledge
Knowledge helpers are async and return refusal/completeness states that author code must inspect. The manifest must declare theknowledge capability and required permission. Do not treat a
partial or stale list as complete.
Files, composition, and progress
put_file, get_file, and run_procedure are async. Use sandbox/file modes for large binary
inputs rather than loading them as text. Prefer a workflow edge over run_procedure when operators
need to see the composition. emit_progress is synchronous and best-effort.
Choice and selection helpers
choose_values evaluates a bounded caller-owned menu through the typed-judgment capability and
returns validated probability evidence under caller-supplied acceptance rules. It does not retry or
perform the resulting effect. select_candidate is local and deterministic over opaque ids; it
performs no provider I/O.
Session and errors
read_session() parses the injected signed session. Some dedicated registered procedures can use
its Freshservice reservation/terminal methods; those methods are not general ticket-send authority.
to_procedure_error_envelope produces a bounded safe error shape.
Branch on ProcedureApiError.code and the exported closed PROCEDURE_ERROR_CODES, not message text.
Some codes originate in platform preflight, polling, or enforcement outside the sandbox.
See Author a procedure and Node SDK.
