@terminal3/t3n-sdk 4.44.0 → 4.45.1

package/dist/index.d.ts

@@ -2848,8 +2848,17 @@ declare class T3nClient {
      *
      * The scope organisation is resolved node-side from the session DID, so
      * there is no scope parameter and a caller can only ever read their own org.
-     * The page carries **every member's** activity in that org, not just the
-     * caller's own.
+     * How much of that org comes back depends on the caller's admin standing:
+     * an **admin** of the organisation gets **every member's** activity, while
+     * anyone else gets only the rows they took part in — the calls they made, plus
+     * the calls their agents made in their name. The call succeeds either way, so
+     * a smaller page is a narrower scope, not an error; label the view accordingly
+     * rather than treating it as the whole organisation's log.
+     *
+     * A caller belonging to more than one organisation IS refused, since there is
+     * no single scope to read. That arrives as an {@link RpcError} whose
+     * `httpStatus` carries the JSON-RPC code `-32003` (Forbidden) — that field
+     * holds `error.code`, not an HTTP status — with the reason in `detail`.
      *
      * Like {@link getAuditEvents} / {@link getUsage}, this runs the session
      * payload encryption: entries carry principal DIDs, so params and response