is_effects
The shared vocabulary of intersyntactic's actions: what a tool's action describes, the airlock decides on, and a driver carries out.
A driver is given only the action's program and input; the trajectory,
the decision and what follows stay with is_airlock_api.
What an action takes and gives back
RelativePath: a path relative to a driver's root, normalised by its constructor. Whether it may leave that root — by its text, or by a symlink only the disk can show — is the operator's choice, enforced by the driver.- Reading and writing:
FileTextin,ReadResult(ReadText,ReadMissing) andWroteout. - Starting a program: a
ProgramName(made only byparse, no whitespace) andArgs, giving anExecResult, which isExited(exitCode)orKilled(why), each with stdout and stderr. How long a program may run, and when it is killed, is the driver's. - Reaching the world: an
Origin(scheme, host and port only), aWebPath(made only byparse: a leading/, no authority, no..or@, so a path can never name somewhere other than where it was decided to go) and an optionalSignInby name, with aRequest— the web driver's input: method, path, headers (validatedHeaders, which refuses a credential) and an optional body — giving aWebResponse(status, and eithercreatedor, for a non-2xx reply,refusedBecause). - Calling the model: a
ModelSignInNameby name (never the secret) and aModelName(a model id, such asclaude-opus-5-5), with the exact system prompt and request the airlock approved, giving aModelReply:FinishedReply(the model's whole text) orCutOffReply(the call ran and spent tokens, but the reply ended before the model was done) — a closed set, so a caller can't treat a cut-off answer as the model's full word just because it forgot to check. Both carryusage(aModelUsage, null when the driver can't report one). Outcome<O>:Ran(output), orRefused(why).Progress: what a driver reports while it works,Printedfor a program's output,ReplyArrivingfor a piece of the model's reply as it streams — never recorded; only the wholeModelReplyis.
A trajectory's prompts are made by its own loop, which holds no model
sign-in and reaches the model only through AsksTheModel, never
directly — the model is outside the station.
Drivers
ReadsAndWritesFiles, RunsPrograms (reporting progress as it goes),
CarriesOutWebRequests and AsksTheModel. A machine loads the drivers
it can run: a phone's loads no RunsPrograms.
The library imports only path and is_path_confinement outside the SDK;
a test reads every directive's URI from Dart's parse tree and holds it to
that.
Libraries
- is_effects
- The shared vocabulary of actions: what reading, writing, starting a program, reaching the world and calling the model take and give back, and the drivers that carry them out.