Skip to main content

is_effects 0.7.0 copy "is_effects: ^0.7.0" to clipboard
is_effects: ^0.7.0 copied to clipboard

The shared vocabulary of intersyntactic's actions: what reading, writing, starting a program and reaching the world take and give back, and the drivers that carry them out.

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: FileText in, ReadResult (ReadText, ReadMissing) and Wrote out.
  • Starting a program: a ProgramName (made only by parse, no whitespace) and Args, giving an ExecResult, which is Exited(exitCode) or Killed(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), a WebPath (made only by parse: a leading /, no authority, no .. or @, so a path can never name somewhere other than where it was decided to go) and an optional SignIn by name, with a Request — the web driver's input: method, path, headers (validatedHeaders, which refuses a credential) and an optional body — giving WebRequestOutcome (status, and either created or, for a non-2xx reply, refusedBecause).
  • Calling the model: a ModelSignInName by name (never the secret) and a ModelName (a model id, such as claude-opus-5-5), with the exact system prompt and request the airlock approved, giving ModelReply — the model's final text, kept whole.
  • Outcome<O>: Ran(output), or Refused(why).
  • Progress: what a driver reports while it works, Printed for a program's output, ReplyArriving for a piece of the model's reply as it streams — never recorded; only the whole ModelReply is.

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.

0
likes
0
points
261
downloads

Publisher

verified publisherenspyr.co

Weekly Downloads

The shared vocabulary of intersyntactic's actions: what reading, writing, starting a program and reaching the world take and give back, and the drivers that carry them out.

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

is_path_confinement, path

More

Packages that depend on is_effects