@manifesto-ai/sdk 3.3.1 → 3.4.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.
package/README.md CHANGED
@@ -21,6 +21,7 @@ Use the SDK when you want:
21
21
  - the shortest path to a running base world
22
22
  - typed intent creation through `MEL.actions.*`
23
23
  - `dispatchAsync`, subscriptions, availability queries, action metadata inspection, and snapshot reads in one package
24
+ - projected Snapshot reads by default, with canonical inspection available explicitly
24
25
  - a clear boundary between law composition and runtime execution
25
26
 
26
27
  ## Activation Lifecycle
@@ -37,6 +38,7 @@ await world.dispatchAsync(intent);
37
38
  world.isActionAvailable("increment");
38
39
  world.getAvailableActions();
39
40
  world.getSnapshot();
41
+ world.getCanonicalSnapshot();
40
42
  ```
41
43
 
42
44
  The canonical SDK lifecycle is:
@@ -47,6 +49,8 @@ The canonical SDK lifecycle is:
47
49
  4. execute with instance-owned `dispatchAsync()`
48
50
  5. observe through `subscribe()` / `on()` and read through `getSnapshot()`
49
51
 
52
+ `getSnapshot()` is the projected application-facing read surface. `getCanonicalSnapshot()` is the explicit escape hatch for full substrate inspection.
53
+
50
54
  ## Base Runtime Surface
51
55
 
52
56
  The activated base runtime exposes:
@@ -56,6 +60,7 @@ The activated base runtime exposes:
56
60
  - `subscribe`
57
61
  - `on`
58
62
  - `getSnapshot`
63
+ - `getCanonicalSnapshot`
59
64
  - `getAvailableActions`
60
65
  - `getActionMetadata`
61
66
  - `isActionAvailable`