@aexhq/sdk 0.77.0 → 0.78.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +12 -3
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -21,8 +21,8 @@ console.log(await aex.account.get());
21
21
  ```
22
22
 
23
23
  `Aex` extends the pinned Brain client. Its sessions, registration, Events, Components and
24
- extension builders are Brain's implementations. SDK 0.77 uses Brain SDK 0.27 and Pi/Codex
25
- 6.2. Images and PDFs use HTTPS URLs; Aex owns attachment publication and expiry. Deploy the matching
24
+ extension builders are Brain's implementations. SDK 0.78 uses Brain SDK 0.28 and Pi/Codex
25
+ 7.0. Images and PDFs use HTTPS URLs; Aex owns attachment publication and expiry. Deploy the matching
26
26
  runtime and extensions together. Retained sessions require a compatibility check before upgrading.
27
27
  See https://aex.dev/docs
28
28
  for a complete session example.
@@ -39,7 +39,16 @@ and transforms before the handler. Ordinary objects strip extra properties and s
39
39
  reject them. Pi dispatches in parallel; coordinate shared resources in their owning Tool or
40
40
  Environment. The official loops explain unanswered calls after interruption without replaying them.
41
41
 
42
- Host Tools return ordinary successful output or a Brain `Outcome` directly. Structured errors retain
42
+ Tool return and completion are separate. `return ctx.finish(value)` emits an optional result
43
+ and finishes an ordinary Tool. Returning a value alone emits it and releases the synchronous
44
+ caller; the Tool remains open for `ctx.emitResult(value)` and `ctx.finish()` afterward.
45
+ Background observations wake the Agentloop, which chooses whether to call the model and what
46
+ to put in its transcript. Results and finish always enter the journal. Keep the host client
47
+ connected until all its Tools finish. Interrupt cancels unfinished Tools even while idle.
48
+ A forgotten finish stays open until the original deadline, cancellation or Environment loss;
49
+ without a deadline it can remain open indefinitely.
50
+
51
+ Host Tools accept ordinary successful output or a Brain `Outcome` directly. Structured errors retain
43
52
  code, message, retryable and details. The top-level statuses `ok`, `error`, `timeout`, `cancelled`
44
53
  and `unknown` declare outcomes; malformed envelopes fail validation, and only successful values
45
54
  pass through the output schema. Tool deadlines produce `timeout`, explicit cancellation produces
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aexhq/sdk",
3
- "version": "0.77.0",
3
+ "version": "0.78.0",
4
4
  "description": "Aex accounts and hosted sessions using the Brain SDK",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -28,7 +28,7 @@
28
28
  "tag": "next"
29
29
  },
30
30
  "dependencies": {
31
- "@aexhq/brain": "0.27.0"
31
+ "@aexhq/brain": "0.28.0"
32
32
  },
33
33
  "scripts": {
34
34
  "gen": "node ../../tools/sdk-contracts.mjs",