solid-objects 0.16.1 → 0.17.1

package/dist/telemetry.js

@@ -0,0 +1,126 @@
+import { readonlyCopy } from "./serialization.js";
+export const portableAttributes = new Set([
+    "failureCount",
+    "phase",
+    "activationOwnerId",
+    "activationGeneration",
+    "pollingIntervalMilliseconds",
+    "idlePollingIntervalMilliseconds",
+    "currentIntervalMilliseconds",
+    "component",
+    "workers",
+    "effectWorkers",
+    "broadcastWorkers",
+    "reminderSchedulers",
+    "actorType",
+    "actorId",
+    "instanceId",
+    "incarnation",
+    "revision",
+    "messageId",
+    "requestId",
+    "attempt",
+    "sequence",
+    "operation",
+    "deliveryMode",
+    "generation",
+    "durationMilliseconds",
+    "latenessMilliseconds",
+    "ageMilliseconds",
+    "depth",
+    "count",
+    "errorName",
+    "outcome",
+    "retryable",
+    "status",
+    "effectId",
+    "effectName",
+    "reminderId",
+    "occurrence",
+    "broadcastId",
+    "code",
+    "role",
+    "reason",
+    "processId",
+    "processKind",
+    "ownerId",
+    "componentCount",
+    "byteCount",
+    "thresholdBytes",
+    "previousRunAt",
+    "nextRunAt",
+    "name",
+    "commitAction",
+    "outboxKind",
+    "truncated",
+    "payload",
+    "waitingOn",
+    "timeoutMilliseconds",
+    "intervalMilliseconds",
+    "previousIntervalMilliseconds",
+]);
+export function telemetryEvent(options) {
+    const attributes = {};
+    for (const [key, value] of Object.entries(options.attributes)) {
+        if (portableAttributes.has(key) &&
+            (value === null || ["string", "number", "boolean"].includes(typeof value))) {
+            attributes[key] = value;
+        }
+    }
+    const name = `solid_objects.${options.name}`;
+    const labels = Object.freeze({
+        event: name,
+        adapter: options.adapter,
+        actorType: String(attributes.actorType ?? ""),
+    });
+    const metrics = [
+        { name: "solid_objects.events", kind: "counter", unit: "1", value: 1, labels },
+    ];
+    for (const [field, metric, kind, unit] of [
+        ["durationMilliseconds", "solid_objects.duration", "histogram", "ms"],
+        ["latenessMilliseconds", "solid_objects.reminder.lateness", "histogram", "ms"],
+        ["ageMilliseconds", "solid_objects.outbox.age", "histogram", "ms"],
+        ["depth", "solid_objects.mailbox.depth", "gauge", "1"],
+    ]) {
+        const value = attributes[field];
+        if (typeof value === "number" && Number.isFinite(value))
+            metrics.push({ name: metric, kind, unit, value: Math.max(0, value), labels });
+    }
+    return Object.freeze({
+        schemaVersion: 1,
+        name,
+        occurredAt: new Date().toISOString(),
+        adapter: options.adapter,
+        actorType: identifier(attributes.actorType),
+        actorId: identifier(attributes.actorId),
+        incarnation: identifier(attributes.incarnation ?? attributes.instanceId),
+        revision: identifier(attributes.revision),
+        messageId: identifier(attributes.messageId),
+        attempt: typeof attributes.attempt === "number" ? attributes.attempt : 0,
+        attributes: readonlyCopy(attributes),
+        metrics: Object.freeze(metrics.map((sample) => Object.freeze(sample))),
+    });
+}
+export function deliverTelemetry(options) {
+    const failed = (error) => {
+        try {
+            const result = options.logger.error({
+                event: "solid_objects.instrumentation.failed",
+                instrumentationEvent: options.event.name,
+                errorName: error instanceof Error ? error.name : "Error",
+            });
+            void Promise.resolve(result).catch(() => { });
+        }
+        catch { }
+    };
+    try {
+        void Promise.resolve(options.observer(options.event)).catch(failed);
+    }
+    catch (error) {
+        failed(error);
+    }
+}
+function identifier(value) {
+    return typeof value === "string" || typeof value === "number" ? String(value) : null;
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/transmit.js

@@ -28,7 +28,7 @@ export async function receiveTransmitEnvelope(options) {
             throw new InvalidPayload(`transmit envelope requires a non-empty ${field}`);
         }
     }
-    const argumentsValue = envelope.arguments ?? {};
+    const argumentsValue = envelope.arguments === undefined ? {} : envelope.arguments;
     if (!isJsonObject(argumentsValue)) {
         throw new InvalidPayload("transmit envelope arguments must be a JSON object");
     }
@@ -80,7 +80,7 @@ async function undeliveredEnvelopesThrough(input) {
          AND messages.actor_type = ?
          AND messages.actor_id = ?
          AND messages.sequence <= (SELECT sequence FROM ${messages} WHERE id = ?)
-       ORDER BY messages.sequence, effects.id`, [effectName, context.actorType, context.actorId, context.sourceMessageId]));
+       ORDER BY messages.sequence, effects.position, effects.id`, [effectName, context.actorType, context.actorId, context.sourceMessageId]));
     const envelopes = [];
     for (const row of rows) {
         const argumentsValue = JSON.parse(row.arguments);

package/dist/transmit.js.map

@@ -1 +1 @@
-{"version":3,"file":"transmit.js","sourceRoot":"","sources":["../src/transmit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transmit.js","sourceRoot":"","sources":["../src/transmit.ts"],"names":[],"mappings":"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"}

package/dist/turn.js

@@ -5,10 +5,10 @@ import { jsonObject, normalizeJson, stableJson } from "./serialization.js";
 export function readActorObservables(options) {
     const { actor, definition, runtime } = options;
     const before = options.stateJson ?? stableJson(actorState(actor, definition.stateKeys));
-    const intentCount = actor.intentCount();
+    const intentsBefore = actor.intentSnapshot();
     const projection = withActorProjection({ actor, runtime }, () => actor.observableValues());
     if (stableJson(actorState(actor, definition.stateKeys)) !== before ||
-        actor.intentCount() !== intentCount) {
+        actor.intentSnapshot() !== intentsBefore) {
         throw new QueryMutatedState("observables must not mutate actor state or stage durable work");
     }
     return projection;

package/dist/turn.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn.js","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turn.js","sourceRoot":"","sources":["../src/turn.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.16.1";
+export declare const VERSION = "0.17.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.16.1";
+export const VERSION = "0.17.1";
 //# sourceMappingURL=version.js.map

package/dist/wake-up-notification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wake-up-notification.d.ts","sourceRoot":"","sources":["../src/wake-up-notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE7D,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,UAAU,CAAA;CACjB,GAAG,IAAI,CAWP"}
+{"version":3,"file":"wake-up-notification.d.ts","sourceRoot":"","sources":["../src/wake-up-notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE7D,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,OAAO,EAAE,aAAa,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,UAAU,CAAA;CACjB,GAAG,IAAI,CAkBP"}

package/dist/wake-up-notification.js

@@ -1,6 +1,14 @@
 export function notifyWakeUp(options) {
     const logFailure = (errorName) => {
-        options.logger.error({ event: "solid_objects.wake_up.failed", role: options.role, errorName });
+        try {
+            const result = options.logger.error({
+                event: "solid_objects.wake_up.failed",
+                role: options.role,
+                errorName,
+            });
+            void Promise.resolve(result).catch(() => { });
+        }
+        catch { }
     };
     try {
         Promise.resolve(options.adapter.notify(options.role)).catch((error) => logFailure(error instanceof Error ? error.name : "Error"));

package/dist/wake-up-notification.js.map

@@ -1 +1 @@
-{"version":3,"file":"wake-up-notification.js","sourceRoot":"","sources":["../src/wake-up-notification.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,OAI5B;IACC,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAQ,EAAE;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAChG,CAAC,CAAA;IACD,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACpE,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAC1D,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}
+{"version":3,"file":"wake-up-notification.js","sourceRoot":"","sources":["../src/wake-up-notification.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,OAI5B;IACC,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAQ,EAAE;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;gBAClC,KAAK,EAAE,8BAA8B;gBACrC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS;aACV,CAAC,CAAA;YACF,KAAK,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC9C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC,CAAA;IACD,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACpE,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAC1D,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}

package/docs/agents.md

@@ -0,0 +1,300 @@
+# Solid Objects for coding agents (TypeScript and Node.js)
+
+This guide is for a coding agent that evaluates or adds Solid Objects in a
+TypeScript or Node.js application. It gives the facts and steps in a fixed
+order. Each step links to the maintained documentation for more detail.
+
+## 1. Check the fit first
+
+Use Solid Objects only if you can answer yes to most of these questions:
+
+1. Does one identity, such as a room, cart, account, device, or document, own
+   the state?
+2. Must writes for that identity happen one at a time across requests and
+   processes?
+3. Must some work happen later or continue after a process exits?
+4. Is the state a bounded JSON document, not a large relational dataset?
+5. Can the application run `runtime.run(signal)` in at least one process for
+   reminders, effects, and realtime delivery?
+
+Select a simpler tool in these cases:
+
+| Requirement                                    | Use instead                                                                                                 |
+| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| The invariant fits in one request              | A transaction, a constraint, or `SELECT ... FOR UPDATE`                                                     |
+| CPU-intensive or parallel work                 | `worker_threads` or a worker pool. An actor serializes work                                                 |
+| Thousands of writes for each second to one key | A counter column or a cache. Solid Objects Pro covers this case for Rails; its Node build is in development |
+| One atomic change across two actor identities  | One SQL transaction on normal tables                                                                        |
+| Exactly-once calls to an external API          | Not available from any actor library. Use provider idempotency keys                                         |
+| Replay of named workflow steps from a step log | A durable execution engine, such as DBOS or Temporal                                                        |
+
+The full list is in [Choosing Solid Objects](fit.md). The category guide is
+[Virtual actors in TypeScript and Node.js](virtual-actors.md).
+
+## 2. Package identity
+
+| Item               | Value                                                                                                 |
+| ------------------ | ----------------------------------------------------------------------------------------------------- |
+| npm package        | `solid-objects`                                                                                       |
+| Repository         | <https://github.com/cardmagic/solid-objects-js>                                                       |
+| Website            | <https://solidobjects.dev/js>                                                                         |
+| Ruby on Rails gem  | `solid_objects`, a separate implementation of the same model                                          |
+| Commercial package | `@solidobjects/pro`, a separate paid package in development. The open-source package does not need it |
+
+Solid Objects is not SolidJS and has no relation to it. It is not affiliated
+with Cloudflare.
+
+## 3. Requirements
+
+- Node.js 24.4 or newer. Prefer 24.15 or newer, where `node:sqlite` is no
+  longer experimental.
+- The package is ESM only. TypeScript applications need TypeScript 5.9 or
+  newer.
+- SQLite through the `node:sqlite` module, PostgreSQL 14 or newer with the
+  `pg` package, or MySQL 8.0 or newer with InnoDB and the `mysql2` package.
+- Redis is optional. It only shortens wake-up latency and holds no durable
+  state.
+
+[Supported versions](support.md) lists the CI matrix.
+
+## 4. Install
+
+```bash
+npm install solid-objects
+npx solid-objects quickstart --yes
+```
+
+The quickstart runs 25 concurrent calls against one identity on a temporary
+SQLite database. It proves that no update is lost. Add `pg` or `mysql2` when
+you use PostgreSQL or MySQL.
+
+Create the runtime and its tables at startup:
+
+```typescript
+import { configure } from "solid-objects"
+import { sqlite } from "solid-objects/database/sqlite"
+
+const runtime = configure({
+  database: sqlite({ path: "app.sqlite3" }),
+})
+
+await runtime.install()
+```
+
+[Configuration](configuration.md) lists each option and database adapter.
+
+## 5. Authorize
+
+All authorization callbacks deny by default. A new runtime answers no actor
+call until you write a policy. Do not remove this behavior.
+
+For a local demonstration only, grant messages and queries:
+
+```typescript
+const runtime = configure({
+  database: sqlite({ path: "app.sqlite3" }),
+  authorizeMessage: () => true,
+  authorizeQuery: () => true,
+})
+```
+
+Keep `authorizeDestroy`, `authorizeSubscription`, and
+`authorizeAdministration` denied in a demonstration.
+
+A production policy must bind the actor type and ID to the authenticated user
+or tenant. An actor ID is not a permission:
+
+```typescript
+const ownsCart = ({
+  actorType,
+  actorId,
+  authorizationContext,
+}: {
+  actorType: string
+  actorId: string
+  authorizationContext: unknown
+}) => {
+  if (actorType !== "ShoppingCart") return false
+  if (typeof authorizationContext !== "object" || authorizationContext === null) return false
+  if (!("userId" in authorizationContext)) return false
+  return typeof authorizationContext.userId === "string" && actorId === authorizationContext.userId
+}
+
+const runtime = configure({
+  database: sqlite({ path: "app.sqlite3" }),
+  authorizeMessage: ownsCart,
+  authorizeQuery: ownsCart,
+})
+```
+
+Pass the context on each call:
+
+```typescript
+await ShoppingCart.ref(subject.userId)
+  .with({ authorizationContext: subject })
+  .addItem({ productId: "shirt-123" })
+```
+
+[Authorization](authorization.md) covers each entry point.
+
+## 6. Define an actor
+
+This actor is the example from the [virtual actor guide](virtual-actors.md):
+
+```typescript
+import { Actor } from "solid-objects"
+
+const HOLD_MILLISECONDS = 10 * 60 * 1000
+
+export class TicketSale extends Actor {
+  static override readonly actorType = "TicketSale"
+
+  available = 1
+  holds: Record<string, number> = {}
+
+  hold({ buyer }: { buyer: string }): { held: boolean; available: number } {
+    if (this.available === 0 || Object.hasOwn(this.holds, buyer)) {
+      return { held: false, available: this.available }
+    }
+
+    this.available -= 1
+    this.holds = { ...this.holds, [buyer]: Date.now() }
+    this.schedule({ at: new Date(Date.now() + HOLD_MILLISECONDS), key: buyer }).expire({ buyer })
+    return { held: true, available: this.available }
+  }
+
+  expire({ buyer }: { buyer: string }): number {
+    if (!Object.hasOwn(this.holds, buyer)) return this.available
+
+    const remainingHolds = { ...this.holds }
+    delete remainingHolds[buyer]
+    this.holds = remainingHolds
+    this.available += 1
+    return this.available
+  }
+}
+```
+
+Obey these rules in actor code:
+
+- Give each actor class a stable `static actorType`. The database stores it.
+- Enumerable public fields are the durable state. They must be
+  JSON-compatible.
+- Public methods are ordered operations. Each one takes no argument or one
+  object argument.
+- Use `this.schedule({ at, key })` for delayed work. A new `schedule` with the
+  same key moves the alarm.
+- Use `this.reject(code, message)` for a business rule failure that must not
+  retry.
+- Do not write application tables directly from an operation. Use
+  `this.commitAction()` for a short write in the same database.
+- Do not call an external API in an operation. Use `this.emit()` and an effect
+  handler.
+- Write each operation so that it can run again. Delivery is at least once.
+
+[State and lifecycle](state-and-lifecycle.md) and the
+[public API](api.md) give the full rules.
+
+## 7. Run the background roles
+
+A direct call, such as `TicketSale.ref("event-42").hold({ buyer: "ada" })`,
+runs in the caller. These features need a process that calls
+`runtime.run(signal)`:
+
+- Reminders from `schedule()`.
+- Effects from `emit()` and their callbacks.
+- Messages to other actors.
+- Realtime broadcasts.
+
+```typescript
+const controller = new AbortController()
+process.once("SIGTERM", () => controller.abort())
+await runtime.run(controller.signal)
+await runtime.close()
+```
+
+The packaged `solid-objects start` command does the same for a runtime that
+`solid-objects.config.js` exports. When no process runs, committed work waits
+in SQL and runs later. [Operations](operations.md) covers roles and shutdown.
+
+## 8. Make external effects idempotent
+
+Register an effect handler at startup. Use `context.id` as the provider
+idempotency key:
+
+```typescript
+runtime.registerEffect("charge_payment", async (argumentsValue, context) => {
+  return payments.charge({
+    idempotencyKey: context.id,
+    paymentId: argumentsValue.paymentId,
+  })
+})
+```
+
+Stage it from an operation:
+
+```typescript
+this.emit("charge_payment", {
+  arguments: { paymentId: this.paymentId },
+  onSuccess: "charged",
+})
+```
+
+The effect can run more than once after a crash. The `context.id` value is the
+same each time. [Effect recovery](effect-recovery.md) explains how to retire
+abandoned work.
+
+## 9. Verify the implementation
+
+Do these checks before you report that the work is complete:
+
+1. Call `await runtime.doctor.run()`. The report must contain no failed check.
+2. Send concurrent calls to one identity with `Promise.all`, and from two
+   processes if the application runs more than one. Assert the final state.
+3. Test delayed work without sleeps. `runDueReminders({ now })` enqueues the
+   reminders that are due at the `Date` you pass. `drain()` then runs the
+   enqueued actor work:
+
+   ```typescript
+   await runtime.testing.runDueReminders({ now: new Date(Date.now() + HOLD_MILLISECONDS) })
+   await runtime.testing.drain({ roles: ["actors"] })
+   ```
+
+4. Start a process that calls `runtime.run(signal)`, schedule a short
+   reminder, and stop the process. Start it again after the deadline and
+   confirm that the reminder ran.
+5. Confirm that each effect handler deduplicates with `context.id`.
+6. Confirm that production policies do not grant access to every caller.
+
+The repository runs the same proofs. `pnpm run test:recovery` stops a worker
+process and recovers its work. `pnpm run test:at-least-once` shows a repeated
+effect and its deduplication.
+
+## 10. Troubleshooting
+
+| Symptom                                 | Cause and fix                                                                        |
+| --------------------------------------- | ------------------------------------------------------------------------------------ |
+| `Unauthorized`                          | A policy denied the call. Write the policy, and pass `authorizationContext`          |
+| A reminder or effect does not run       | No process calls `runtime.run(signal)`. Start one                                    |
+| `SyncInsideTransaction`                 | The call ran inside an open transaction. Call the actor outside the transaction      |
+| `SyncTimeout`                           | The call did not finish in time. The message is still durable. Wait on its reference |
+| `ApplicationWriteForbidden`             | An operation wrote an application table. Use `commitAction()` or `emit()`            |
+| `Rejected`                              | The actor called `reject()`. This is a business result, not a retry                  |
+| Wrong integer values or SQLite warnings | Node.js is older than 24.4, or older than 24.15 for the warning. Upgrade Node.js     |
+| `ERR_REQUIRE_ESM` or import errors      | The package is ESM only. Use `import` and an ES module file                          |
+
+## 11. Guarantees to state correctly
+
+When you explain Solid Objects to a user, state these limits:
+
+- Delivery is at least once, not exactly once.
+- Calls for one identity are ordered. Different identities run concurrently.
+- There are no transactions across actor identities.
+- Fencing stops a stale activation from a commit, but its code can continue to
+  run.
+- The package is pre-1.0. It has no measured scale and no known third-party
+  production use.
+- The browser client is not the SQL runtime. The Cloudflare backend is
+  experimental.
+
+The [correctness contract](correctness.md) is the source for each guarantee.

package/docs/api.md

@@ -105,7 +105,7 @@ envelope. The envelope carries its name in `invalidations`. A component registry
 can then refresh a reauthorized endpoint, and the value stays private.
 
 `MessageReference` does not retain an invocation's authorization context.
-Supply `authorizationContext` to each `status()`, `result()`, and `wait()` call;
+Supply `authorizationContext` to each `status()`, `result()`, `outcome()`, and `wait()` call;
 the runtime reauthorizes the persisted operation every time. Durable results
 are JSON, so an operation that returns `undefined` or is declared `void`
 resolves as `null`.
@@ -130,6 +130,10 @@ function playerForSession<PlayerType extends { sessionId: string }>(options: {
 
 ### Reminders
 
+Keyed reminder names combine the operation, a colon, and the key. JavaScript
+limits the combined name to 255 UTF-16 code units; Ruby limits it to 191
+characters. Use at most 191 ASCII characters for names shared across runtimes.
+
 A reminder is one alarm per actor and name. If you schedule a name that is
 already armed, the runtime **moves the existing alarm**. It does not add a
 second one. A reminder is therefore safe to re-arm from a handler that can run
@@ -904,6 +908,11 @@ open SAH pool otherwise blocks the next candidate until the worker dies.
 
 ## `solid-objects/transmit`
 
+Schema migration 14 persists an effect's staging position within its source message.
+Run `runtime.install()` before upgraded workers start. New effects preserve staging
+order even when two transmits originate in one turn. Legacy rows use position zero
+and their existing ID tie-break; their original order cannot be recovered.
+
 The transactional outbox bridge between a local runtime and a server
 runtime. An actor stages a transmit intent with `this.transmit()`
 in the same transaction as its state change. The effect worker drains the
@@ -923,10 +932,10 @@ outbox with at-least-once delivery, per-actor order, and retry backoff.
   `deliver` while offline and the effect retries with backoff. Give a
   browser runtime a generous `maxAttempts`; an effect that exhausts its
   attempts during a long offline period lands in dead letters, and
-  `runtime.deadLetters.retry` re-queues it.
+  `runtime.deadLetters.effects.retry(id)` re-queues it.
 - `receiveTransmitEnvelope(options)`: idempotent server ingest. `arguments`
   is optional in the envelope and defaults to an empty object, matching the
-  staging side and the Ruby ingest. It enqueues an
+  staging side and the Ruby ingest. Explicit `null` and arrays are invalid. It enqueues an
   internal message with `transmit:<effectId>` as the idempotency key, so a
   replayed envelope applies once. The host must authenticate the sender
   before this call; internal delivery skips `authorizeMessage`. The call
@@ -1057,3 +1066,16 @@ Behavior:
 
 Mounting, authorization actions, CSRF behavior, pages, and extensions are in
 [Operator dashboard](dashboard.md).
+
+### Portable telemetry and diagnostics
+
+`InstrumentationEvent` includes the versioned envelope and immutable `MetricSample`
+values. `EventObserver` is a provider-free event callback. An actor reference offers
+`observe({ onEvent, authorizationContext })`, `on(name, { onEvent, authorizationContext })`,
+and `diagnostics(options)`. Both observer methods resolve to an unsubscribe function.
+They reject a missing `onEvent` with `TypeError` before authorization. A runtime
+accepts at most 1,000 local observers; the next one rejects with `RangeError`.
+`close()` removes every local observer.
+`DiagnosticOptions` accepts `authorizationContext` and a `limit` from 1 to 100.
+`ActorDiagnostics` holds five bounded `DiagnosticSummary` values, with `sampled`,
+`truncated`, and `oldestAgeMilliseconds`. See [observability](observability.md).

package/docs/authorization.md

@@ -10,6 +10,12 @@ resource, optional resource ID, and the caller's authorization context. Retry
 authorization happens before lookup so a denied caller cannot use record IDs as
 an existence oracle.
 
+Actor diagnostics and actor observers call `authorizeAdministration` with the
+resource `actor_diagnostics` and the resource ID
+`JSON.stringify([actorType, actorId])`. `diagnostics()` uses the action
+`inspect`. `observe()` and `on()` use the action `observe`. The check runs before
+any queue read or observer registration.
+
 `runtime.realtime` is transport-neutral. The host application authenticates its
 WebSocket or stream connection, passes that fresh server-side subject as the
 session's `authorizationContext`, and forwards incoming protocol messages to