pyric 0.1.0-alpha.11 → 0.1.0-alpha.13

package/README.md.orig

@@ -17,7 +17,6 @@ Rules tooling and explicit sandbox controls.
 | `pyric/database` | Realtime Database modular mirror |
 | `pyric/storage` | Storage modular mirror and rules-aware sandbox tools |
 | `pyric/rules` | Firestore and RTDB rules lint, simulation, explanation, constraints, and standard library |
-| `pyric/firestore-values` | Firestore value helpers |
 | `pyric/sandbox` | Sandbox lifecycle, identity, events, persistence, and replay |
 
 The package manifest is the authority for public exports, including the

package/dist/{firestore-values/index.d.ts → firestore/internal/value-codec.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Firestore value codec — the marker-based serialize/rehydrate of
+ * Internal Firestore value codec — the marker-based serialize/rehydrate of
  * Firestore special scalar types (Timestamp, Bytes, LatLng/GeoPoint,
  * Duration, Reference, Path, Vector).
  *
@@ -60,4 +60,4 @@
  * MessagePort wire format are guaranteed identical.
  */
 export declare function rehydrateDocValue(value: unknown): unknown;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=value-codec.d.ts.map

package/dist/firestore/internal/value-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-codec.d.ts","sourceRoot":"","sources":["../../../src/firestore/internal/value-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AA6CH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEzD"}

package/dist/{firestore-values/index.js → firestore/internal/value-codec.js}

@@ -1,5 +1,5 @@
 /**
- * Firestore value codec — the marker-based serialize/rehydrate of
+ * Internal Firestore value codec — the marker-based serialize/rehydrate of
  * Firestore special scalar types (Timestamp, Bytes, LatLng/GeoPoint,
  * Duration, Reference, Path, Vector).
  *
@@ -52,18 +52,18 @@
  */
 // Direct leaf imports — NOT the `pyric/rules` barrel. Each of these modules
 // depends only on `./base.js` (no imports), so this stays engine-free.
-import { Bytes } from '../rules/simulator/wrappers/bytes.js';
-import { Duration } from '../rules/simulator/wrappers/duration.js';
-import { LatLng } from '../rules/simulator/wrappers/latlng.js';
-import { Path } from '../rules/simulator/wrappers/path.js';
-import { Reference } from '../rules/simulator/wrappers/reference.js';
-import { Timestamp } from '../rules/simulator/wrappers/timestamp.js';
-import { Vector } from '../rules/simulator/wrappers/vector.js';
+import { Bytes } from '../../rules/simulator/wrappers/bytes.js';
+import { Duration } from '../../rules/simulator/wrappers/duration.js';
+import { LatLng } from '../../rules/simulator/wrappers/latlng.js';
+import { Path } from '../../rules/simulator/wrappers/path.js';
+import { Reference } from '../../rules/simulator/wrappers/reference.js';
+import { Timestamp } from '../../rules/simulator/wrappers/timestamp.js';
+import { Vector } from '../../rules/simulator/wrappers/vector.js';
 // Sideways leaf import into the firestore surface (same character as the
 // wrapper imports above): the activity value registry is a zero-dependency
 // leaf owned by `firestore/sandbox/`, consumed here only to stamp trusted
 // wire identities on rehydrated values. It pulls no backend code.
-import { registerActivityValue, trustedWireActivityValue, } from '../firestore/sandbox/activity-value-registry.js';
+import { registerActivityValue, trustedWireActivityValue, } from '../sandbox/activity-value-registry.js';
 /**
  * Decode a base64url string (`-`/`_` alphabet, no padding) back into a
  * Uint8Array. Mirrors the encode path in `Bytes.toBase64` (RFC 4648 section 5).
@@ -164,4 +164,4 @@ function rehydrateValue(value, registerRootIdentity) {
         out[k] = rehydrateValue(v, false);
     return withActivityIdentity(out);
 }
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=value-codec.js.map

package/dist/firestore/internal/value-codec.js.map

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

package/dist/sandbox/admin-firestore/remote/value-codec.d.ts

@@ -10,7 +10,8 @@
  * the worker STORES real typed values (rules comparisons and `orderBy`
  * see a Timestamp, not a map). Read payloads arrive as the
  * `SerializedDocData` JSON envelope and are rehydrated with the ONE shared
- * codec (`pyric/firestore-values`' `rehydrateDocValue`) then translated to
+ * codec (`pyric/firestore/internal/value-codec`'s `rehydrateDocValue`) then
+ * translated to
  * the compat field shapes (`translateReadData`) — the same shapes the
  * local arm's read path yields.
  *

package/dist/sandbox/admin-firestore/remote/value-codec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-codec.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/admin-firestore/remote/value-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAsCnD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CA0B/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE3D;AAID;;iEAEiE;AACjE,wBAAgB,cAAc,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAEpE;AAED;;iEAEiE;AACjE,wBAAgB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAEnE"}
+{"version":3,"file":"value-codec.d.ts","sourceRoot":"","sources":["../../../../src/sandbox/admin-firestore/remote/value-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAEL,KAAK,YAAY,EAElB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAsCnD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CA0B/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE3D;AAID;;iEAEiE;AACjE,wBAAgB,cAAc,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAEpE;AAED;;iEAEiE;AACjE,wBAAgB,aAAa,CAAC,UAAU,EAAE,WAAW,GAAG,YAAY,CAEnE"}

package/dist/sandbox/admin-firestore/remote/value-codec.js

@@ -10,7 +10,8 @@
  * the worker STORES real typed values (rules comparisons and `orderBy`
  * see a Timestamp, not a map). Read payloads arrive as the
  * `SerializedDocData` JSON envelope and are rehydrated with the ONE shared
- * codec (`pyric/firestore-values`' `rehydrateDocValue`) then translated to
+ * codec (`pyric/firestore/internal/value-codec`'s `rehydrateDocValue`) then
+ * translated to
  * the compat field shapes (`translateReadData`) — the same shapes the
  * local arm's read path yields.
  *
@@ -26,7 +27,7 @@
  * the in-page live path — marker-shaped user data is already reserved
  * vocabulary in this system.
  */
-import { rehydrateDocValue } from 'pyric/firestore-values';
+import { rehydrateDocValue } from 'pyric/firestore/internal/value-codec';
 import { Timestamp as CompatTimestamp, } from 'pyric/sandbox/admin-compat';
 import { translateReadData } from '../../../firestore/sandbox/admin-compat/read-translation.js';
 import { invalidArgument } from './errors.js';

package/dist/sandbox/admin-firestore/remote/value-codec.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-codec.js","sourceRoot":"","sources":["../../../../src/sandbox/admin-firestore/remote/value-codec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"value-codec.js","sourceRoot":"","sources":["../../../../src/sandbox/admin-firestore/remote/value-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EACL,SAAS,IAAI,eAAe,GAG7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6DAA6D,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,6EAA6E;AAE7E,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IAClD,iBAAiB;IACjB,WAAW;IACX,YAAY;IACZ,aAAa;IACb,aAAa;CACd,CAAC,CAAC;AAEH,SAAS,oBAAoB,CAAC,CAAU;IACtC,OAAO,CACL,CAAC,KAAK,IAAI;QACV,OAAO,CAAC,KAAK,QAAQ;QACrB,OAAQ,CAA0B,CAAC,MAAM,KAAK,QAAQ;QACtD,cAAc,CAAC,GAAG,CAAE,CAAwB,CAAC,MAAM,CAAC,CACrD,CAAC;AACJ,CAAC;AAED;sEACsE;AACtE,SAAS,cAAc,CAAC,CAAqB;IAC3C,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;QACjB,KAAK,iBAAiB;YACpB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;QAC3C,KAAK,WAAW;YACd,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACjD,KAAK,YAAY;YACf,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACzE,KAAK,aAAa;YAChB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1E,KAAK,aAAa;YAChB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IAClD,IAAI,oBAAoB,CAAC,CAAC,CAAC;QAAE,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,YAAY,eAAe;QAAE,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IACpD,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjD,kEAAkE;QAClE,qEAAqE;QACrE,mEAAmE;QACnE,8DAA8D;QAC9D,MAAM,MAAM,GAAI,CAA0B,CAAC,MAAM,CAAC;QAClD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAQ,MAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,eAAe,CACnB,wCAAwC,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,OAAO,GAAG;YAC3E,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,8EAA8E;AAE9E;;iEAEiE;AACjE,MAAM,UAAU,cAAc,CAAC,UAAuB;IACpD,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAiB,CAAC;AACxE,CAAC;AAED;;iEAEiE;AACjE,MAAM,UAAU,aAAa,CAAC,UAAuB;IACnD,OAAO,iBAAiB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/sandbox/persistence/chunk-format.js

@@ -17,7 +17,7 @@
  * (Float32Array vector encoding is a later, backward-compatible refinement on the
  * per-bucket record shape.)
  */
-import { rehydrateDocValue } from '../../firestore-values/index.js';
+import { rehydrateDocValue } from '../../firestore/internal/value-codec.js';
 import { deserializeSnapshot } from './serialize.js';
 export const CHUNK_FORMAT_VERSION = 3;
 export const BUCKET_COUNT = 256;

package/dist/sandbox/persistence/chunk-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-format.js","sourceRoot":"","sources":["../../../src/sandbox/persistence/chunk-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,2DAA2D;QAC3D,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAiBD;;sBAEsB;AACtB,SAAS,SAAS,CAAC,IAA6B;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAA4B,CAAC;AACrE,CAAC;AAED,4EAA4E;AAC5E,SAAS,YAAY,CAAC,IAA6C;IACjE,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAkD,EAClD,QAAiC,EACjC,OAAe;IAEf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAA6B,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,8EAA8E;IAC9E,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,EAAE,KAAK,cAAc;YAAE,SAAS;QACnC,GAAoB,CAAC,QAAQ,GAAG,YAAY,CAAE,GAAoB,CAAC,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAqC;IACjE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,MAAwD,CAAC;IACrE,IACE,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,MAAM,KAAK,gBAAgB;QAC/B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,GAAG,CAAC,OAAO,KAAK,IAAI,EACpB,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAkC,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,8EAA8E;IAC9E,yEAAyE;IACzE,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY;IAEZ,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,sBAAsB,CACpC,OAAoC;IAEpC,MAAM,SAAS,GAA4C,EAAE,CAAC;IAC9D,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,EAAE,KAAK,cAAc,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAiC,CAAC;YAC/C,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACxE,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC3B,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,GAAmC,CAAC;QACnD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;YAAE,SAAS;QACjF,wEAAwE;QACxE,2EAA2E;QAC3E,8EAA8E;QAC9E,IACE,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;YACnC,YAAY,CAAC,MAAM,CAAC,IAA+C,CAAC,KAAK,MAAM,CAAC,QAAQ,EACxF,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,uDAAuD,EAAE,4BAA4B,CAAC,CAAC;YACpG,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAA4B,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"chunk-format.js","sourceRoot":"","sources":["../../../src/sandbox/persistence/chunk-format.ts"],"names":[],"mappings":"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"}

package/dist/sandbox/persistence/serialize.d.ts

@@ -18,7 +18,7 @@
  * Schema version is captured in the blob so future format changes can
  * be detected and reported (rather than corrupting silently).
  */
-import { rehydrateDocValue } from '../../firestore-values/index.js';
+import { rehydrateDocValue } from '../../firestore/internal/value-codec.js';
 export { rehydrateDocValue };
 export declare class PersistenceSchemaError extends Error {
     constructor(message: string);

package/dist/sandbox/persistence/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/sandbox/persistence/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKpE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAqB7B,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAClD,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAgCrE"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/sandbox/persistence/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAK5E,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAqB7B,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAClD,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAgCrE"}

package/dist/sandbox/persistence/serialize.js

@@ -18,12 +18,12 @@
  * Schema version is captured in the blob so future format changes can
  * be detected and reported (rather than corrupting silently).
  */
-// The marker-based value codec lives in a STANDALONE leaf module
-// (`firestore-values`) so the SharedWorker client can rehydrate doc values
-// WITHOUT pulling the rules engine. `serialize.ts` re-uses that same codec so
-// there is exactly one rehydrate implementation — the IDB persistence format
-// and the MessagePort wire format can't drift.
-import { rehydrateDocValue } from '../../firestore-values/index.js';
+// The marker-based value codec lives behind Firestore's leaf internal seam so
+// the SharedWorker client can rehydrate doc values WITHOUT pulling the rules
+// engine. `serialize.ts` re-uses that same codec so there is exactly one
+// rehydrate implementation — the IDB persistence format and the MessagePort
+// wire format can't drift.
+import { rehydrateDocValue } from '../../firestore/internal/value-codec.js';
 // Re-exported so existing consumers (`sandbox/persistence/index.ts` →
 // `pyric/sandbox`) keep their import path; the implementation now lives in the
 // leaf codec.

package/dist/sandbox/persistence/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/sandbox/persistence/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iEAAiE;AACjE,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,+CAA+C;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,sEAAsE;AACtE,+EAA+E;AAC/E,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,CAAU,CAAC;AAUlC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAC/B,SAAkD,EAClD,WAAoC,EAAE;IAEtC,MAAM,OAAO,GAAmB;QAC9B,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,SAAS;QACT,QAAQ;KACT,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAgBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,sBAAsB,CAC9B,qCAAsC,CAAW,CAAC,OAAO,EAAE,CAC5D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,sBAAsB,CAAC,iCAAiC,CAAC,CAAC;IACtE,CAAC;IACD,oEAAoE;IACpE,sEAAsE;IACtE,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,sBAAsB,CAC9B,8BAA8B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CACxE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACtE,MAAM,IAAI,sBAAsB,CAAC,uCAAuC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,SAAS,GAA4C,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAA4B,CAAC;IACvE,CAAC;IACD,+DAA+D;IAC/D,uEAAuE;IACvE,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC;QACjH,CAAC,CAAE,MAAM,CAAC,QAAoC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../../src/sandbox/persistence/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,2BAA2B;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,sEAAsE;AACtE,+EAA+E;AAC/E,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,cAAc,GAAG,CAAU,CAAC;AAUlC,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAC/B,SAAkD,EAClD,WAAoC,EAAE;IAEtC,MAAM,OAAO,GAAmB;QAC9B,OAAO,EAAE,cAAc;QACvB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,SAAS;QACT,QAAQ;KACT,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAgBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;IAC7C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,sBAAsB,CAC9B,qCAAsC,CAAW,CAAC,OAAO,EAAE,CAC5D,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,sBAAsB,CAAC,iCAAiC,CAAC,CAAC;IACtE,CAAC;IACD,oEAAoE;IACpE,sEAAsE;IACtE,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,sBAAsB,CAC9B,8BAA8B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CACxE,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACtE,MAAM,IAAI,sBAAsB,CAAC,uCAAuC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,SAAS,GAA4C,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAA4B,CAAC;IACvE,CAAC;IACD,+DAA+D;IAC/D,uEAAuE;IACvE,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC;QACjH,CAAC,CAAE,MAAM,CAAC,QAAoC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pyric",
-  "version": "0.1.0-alpha.11",
+  "version": "0.1.0-alpha.13",
   "license": "Apache-2.0",
   "homepage": "https://pyric.dev",
   "repository": {
@@ -34,6 +34,10 @@
       "types": "./dist/firestore/internal/index.d.ts",
       "import": "./dist/firestore/internal/index.js"
     },
+    "./firestore/internal/value-codec": {
+      "types": "./dist/firestore/internal/value-codec.d.ts",
+      "import": "./dist/firestore/internal/value-codec.js"
+    },
     "./auth": {
       "types": "./dist/auth/index.d.ts",
       "import": "./dist/auth/index.js"
@@ -78,10 +82,6 @@
       "types": "./dist/rules/index.d.ts",
       "import": "./dist/rules/index.js"
     },
-    "./firestore-values": {
-      "types": "./dist/firestore-values/index.d.ts",
-      "import": "./dist/firestore-values/index.js"
-    },
     "./rules/internal": {
       "types": "./dist/rules/internal/index.d.ts",
       "import": "./dist/rules/internal/index.js"
@@ -125,6 +125,7 @@
   },
   "files": [
     "dist",
+    "src",
     "README.md",
     "LICENSE"
   ],

package/src/ai/backend.ts

@@ -0,0 +1,49 @@
+/**
+ * Backend configuration classes for `pyric/ai`, mirroring the installed
+ * `@firebase/ai@2.12.0`: an abstract {@link Backend} carrying
+ * `backendType`, with {@link GoogleAIBackend} (the default) and
+ * {@link VertexAIBackend} (location defaults to `us-central1`).
+ *
+ * In the sandbox mirror the backend is a pure configuration marker; the
+ * broker answers in-process either way. Production imports load Firebase's
+ * own backend classes before this package enters the graph.
+ */
+
+const DEFAULT_LOCATION = 'us-central1';
+
+/** Identifies which backend service the SDK communicates with. */
+export const BackendType = {
+  VERTEX_AI: 'VERTEX_AI',
+  GOOGLE_AI: 'GOOGLE_AI',
+} as const;
+export type BackendType = (typeof BackendType)[keyof typeof BackendType];
+
+/**
+ * Abstract base class representing the configuration for an AI service
+ * backend. Do not instantiate directly — use {@link GoogleAIBackend} or
+ * {@link VertexAIBackend}.
+ */
+export abstract class Backend {
+  readonly backendType: BackendType;
+
+  protected constructor(type: BackendType) {
+    this.backendType = type;
+  }
+}
+
+/** Configuration class for the Gemini Developer API backend (the default). */
+export class GoogleAIBackend extends Backend {
+  constructor() {
+    super(BackendType.GOOGLE_AI);
+  }
+}
+
+/** Configuration class for the Vertex AI Gemini API backend. */
+export class VertexAIBackend extends Backend {
+  readonly location: string;
+
+  constructor(location: string = DEFAULT_LOCATION) {
+    super(BackendType.VERTEX_AI);
+    this.location = location || DEFAULT_LOCATION;
+  }
+}

package/src/ai/broker/broker.ts

@@ -0,0 +1,254 @@
+/**
+ * The sandbox AI broker — the ONE in-process Gemini-wire model every plane
+ * consumes (house pattern: the messaging broker):
+ *
+ *   - the client mirror (`pyric/ai`, next stage) calls generateContent /
+ *     streamGenerateContent / countTokens exactly like `rtdb.*` / `auth.*`
+ *     will over the worker protocol (cdd-deltas #98.3);
+ *   - Pyric Studio & tracing consume the typed `service_mutation` events the
+ *     broker emits onto the sandbox's unified `onEvent` stream;
+ *   - answering is delegated through ONE seam ({@link AnswerEngine},
+ *     cdd-deltas #97): `scripted` (default, zero-I/O) or `openai`.
+ *
+ * The broker validates requests LIKE PRODUCTION does — before any engine
+ * runs — throwing {@link AiBrokerError} carrying the exact captured error
+ * envelope:
+ *   - empty/missing `contents`            → `ai-error-empty-contents`
+ *   - a role outside the captured list    → `ai-error-bad-role`
+ *   - a model-turn functionCall part with no thoughtSignature
+ *                                         → `ai-error-fncall-missing-thought-signature`
+ *
+ * Event emission is best-effort behind one small choke-point ({@link emit}):
+ * a throw from the emit path (or any event consumer downstream) must never
+ * poison the AI operation the caller just completed — handler errors are the
+ * consumer's problem, never the broker's (the sandbox's emit fan-out already
+ * isolates listener throws; this guard covers the emit path itself).
+ */
+
+import type { Sandbox } from 'pyric/sandbox';
+import { emitSandboxEvent, makeServiceMutationEvent } from 'pyric/sandbox/internal';
+
+import { AiBrokerError, Synthesizer, badRole, emptyContents, missingThoughtSignature } from './synthesizer.js';
+import { ScriptedEngine } from './scripted-engine.js';
+import { OpenAiEngine } from './openai-engine.js';
+import type {
+  AnswerEngine,
+  CountTokensRequest,
+  CountTokensResponse,
+  EngineConfig,
+  GenerateContentRequest,
+  RawEnvelope,
+  WireChunk,
+  WireResponse,
+} from './types.js';
+
+/**
+ * Roles production accepts, from the captured rejection text
+ * (`ai-error-bad-role`): "Please use a valid role: SYSTEM, SYSTEM_1, USER,
+ * ASSISTANT, DEVELOPER, CONTEXT, USER_CONTEXT, MODEL, USER." — compared
+ * case-insensitively (the SDK sends lowercase `user`/`model`). `FUNCTION` is
+ * additionally accepted: the captured message omits it, yet production
+ * accepted the SDK's function-response turn (`ai-function-response-round`),
+ * and the installed SDK threads those turns with role `function`.
+ */
+const ACCEPTED_ROLES = new Set([
+  'SYSTEM',
+  'SYSTEM_1',
+  'USER',
+  'ASSISTANT',
+  'DEVELOPER',
+  'CONTEXT',
+  'USER_CONTEXT',
+  'MODEL',
+  'FUNCTION',
+]);
+
+export interface AiBrokerOptions {
+  /** Engine config, or a fully custom engine. Default: zero-config scripted. */
+  engine?: EngineConfig | AnswerEngine;
+  /** When present, ops land on the sandbox's unified event stream. */
+  sandbox?: Sandbox;
+}
+
+function isAnswerEngine(value: EngineConfig | AnswerEngine): value is AnswerEngine {
+  return typeof (value as AnswerEngine).generateContent === 'function';
+}
+
+/** What Studio's stream (and the construction log line) name the engine. */
+type EngineKind = 'scripted' | 'openai' | 'custom';
+
+export class AiBroker {
+  readonly engine: AnswerEngine;
+  private readonly sandbox: Sandbox | undefined;
+  private readonly engineKind: EngineKind;
+  private readonly engineModel: string | undefined;
+  private readonly engineBaseUrl: string | undefined;
+
+  constructor(options: AiBrokerOptions = {}) {
+    this.sandbox = options.sandbox;
+    const engine = options.engine ?? { kind: 'scripted' as const };
+    if (isAnswerEngine(engine)) {
+      this.engine = engine;
+      this.engineKind = 'custom';
+    } else if (engine.kind === 'scripted') {
+      this.engine = new ScriptedEngine(engine.script ?? [], new Synthesizer());
+      this.engineKind = 'scripted';
+    } else {
+      this.engine = new OpenAiEngine(engine);
+      this.engineKind = 'openai';
+      this.engineModel = engine.model;
+      this.engineBaseUrl = engine.baseUrl;
+    }
+    console.info(this.describeEngine());
+  }
+
+  /** One-line construction-time summary of what this broker resolved to. */
+  private describeEngine(): string {
+    if (this.engineKind === 'openai') {
+      return `[pyric/ai] engine resolved: openai (model=${this.engineModel ?? 'passthrough'}, upstream=${this.engineBaseUrl})`;
+    }
+    if (this.engineKind === 'custom') {
+      return '[pyric/ai] engine resolved: custom AnswerEngine';
+    }
+    return '[pyric/ai] engine resolved: scripted (zero-config unless a script is queued)';
+  }
+
+  /** Additive detail fields every emitted event carries so Studio can show the engine. */
+  private engineDetail(): Record<string, unknown> {
+    return {
+      engine: this.engineKind,
+      ...(this.engineKind === 'openai'
+        ? { model: this.engineModel, baseUrl: this.engineBaseUrl }
+        : {}),
+    };
+  }
+
+  async generateContent(req: GenerateContentRequest, model: string): Promise<WireResponse> {
+    this.validate(req, model);
+    const response = await this.engine.generateContent(req, model);
+    this.emit('generate_content', model, {
+      contentCount: req.contents.length,
+      finishReason: response.candidates?.[0]?.finishReason,
+      totalTokenCount: response.usageMetadata?.totalTokenCount,
+      responseId: response.responseId,
+    });
+    return response;
+  }
+
+  /**
+   * Chunk objects with the captured framing SEMANTICS (finishReason last
+   * chunk only, usageMetadata every chunk). Validation runs EAGERLY — a bad
+   * request throws here, before iteration, the way production answers with
+   * an HTTP error instead of a stream.
+   */
+  streamGenerateContent(req: GenerateContentRequest, model: string): AsyncIterable<WireChunk> {
+    this.validate(req, model);
+    const inner = this.engine.streamGenerateContent(req, model);
+    const emit = (chunkCount: number) =>
+      this.emit('stream_generate_content', model, {
+        contentCount: req.contents.length,
+        chunkCount,
+      });
+    return (async function* wrapped(): AsyncGenerator<WireChunk> {
+      let chunkCount = 0;
+      for await (const chunk of inner) {
+        chunkCount++;
+        yield chunk;
+      }
+      emit(chunkCount);
+    })();
+  }
+
+  async countTokens(req: CountTokensRequest, model: string): Promise<CountTokensResponse> {
+    this.validateContents(req, model);
+    const response = await this.engine.countTokens(req, model);
+    this.emit('count_tokens', model, { totalTokens: response.totalTokens });
+    return response;
+  }
+
+  // ── Production-shaped validation ──────────────────────────────────────────
+
+  private validate(req: GenerateContentRequest, model: string): void {
+    this.validateContents(req, model);
+    // Model turns threading a functionCall back in MUST carry the
+    // thoughtSignature production minted (`ai-error-fncall-missing-thought-signature`).
+    for (let i = 0; i < req.contents.length; i++) {
+      const content = req.contents[i]!;
+      if ((content.role ?? '').toUpperCase() !== 'MODEL') continue;
+      for (const part of content.parts ?? []) {
+        if (part.functionCall && part.thoughtSignature === undefined) {
+          // `position` is the 1-based index of the offending content turn.
+          this.reject(model, missingThoughtSignature(part.functionCall.name, i + 1));
+        }
+      }
+    }
+  }
+
+  private validateContents(req: { contents: unknown }, model: string): void {
+    const contents = req.contents;
+    if (!Array.isArray(contents) || contents.length === 0) {
+      this.reject(model, emptyContents());
+    }
+    for (const content of contents as GenerateContentRequest['contents']) {
+      const role = content.role ?? '';
+      if (!ACCEPTED_ROLES.has(role.toUpperCase())) {
+        this.reject(model, badRole(role));
+      }
+    }
+  }
+
+  /** Emit the rejection onto the event stream, then throw the wire envelope. */
+  private reject(model: string, envelope: AiBrokerError['envelope']): never {
+    this.emit('request_rejected', model, {
+      code: envelope.error.code,
+      status: envelope.error.status,
+      message: envelope.error.message,
+    });
+    throw new AiBrokerError(envelope);
+  }
+
+  // ── Event emission (Studio stream consumer seam) ──────────────────────────
+
+  /**
+   * Land a broker operation on the sandbox's unified event stream.
+   * Best-effort, storage-precedent: a throw from the emit path must never
+   * fail the AI operation the caller just completed.
+   */
+  private emit(op: string, model: string, detail: Record<string, unknown>): void {
+    if (this.sandbox === undefined) return;
+    try {
+      emitSandboxEvent(
+        this.sandbox,
+        makeServiceMutationEvent({
+          service: 'ai',
+          op,
+          path: model,
+          auth: null,
+          detail: { ...detail, ...this.engineDetail() },
+        }),
+        { service: 'ai' },
+      );
+    } catch {
+      // Observational — never let event emission break an AI op.
+    }
+  }
+}
+
+/**
+ * Fixture helper: extract `behavior.raw` from a parsed oracle observation
+ * JSON so a capture pastes straight into a script entry
+ * (`{ respond: loadObservationEnvelope(obs) }`). Captures are the corpus.
+ */
+export function loadObservationEnvelope(obsJson: unknown): RawEnvelope {
+  const raw = (obsJson as { behavior?: { raw?: unknown } })?.behavior?.raw;
+  if (
+    raw === null ||
+    typeof raw !== 'object' ||
+    !Array.isArray((raw as RawEnvelope).candidates)
+  ) {
+    throw new Error(
+      'loadObservationEnvelope: observation has no behavior.raw response envelope (expected a capture with candidates)',
+    );
+  }
+  return structuredClone(raw) as RawEnvelope;
+}

package/src/ai/broker/index.ts

@@ -0,0 +1,59 @@
+/**
+ * AI broker barrel — the in-process Gemini-wire model for the sandbox's ai
+ * surface (CDD map #92; rulings in packages/conformance/docs/ai/cdd-deltas.md).
+ * NOT wired into package exports yet: the `pyric/ai` mirror layer (next
+ * stage) owns the public surface.
+ */
+
+export { AiBroker, loadObservationEnvelope, type AiBrokerOptions } from './broker.js';
+export { ScriptedEngine, lastUserText, promptTextOf } from './scripted-engine.js';
+export {
+  OpenAiEngine,
+  ToolCallBuffer,
+  SseParser,
+  DONE_SENTINEL,
+  geminiToOpenAIRequest,
+  normalizeSchema,
+  mapFinishReason,
+  openAIToGeminiResponse,
+  openAIChunkToParts,
+  type OpenAiEngineOptions,
+  type OpenAIRequest,
+  type OpenAIResponse,
+  type OpenAIStreamChunk,
+  type OpenAIMessage,
+  type OpenAIToolCall,
+} from './openai-engine.js';
+export {
+  AiBrokerError,
+  Synthesizer,
+  errorEnvelope,
+  unknownModel,
+  badRole,
+  emptyContents,
+  missingThoughtSignature,
+  resolveModelVersion,
+  estimateTokens,
+  mintThoughtSignature,
+  mintFunctionCallId,
+  type SynthesizeOptions,
+} from './synthesizer.js';
+export type {
+  AnswerEngine,
+  CountTokensRequest,
+  CountTokensResponse,
+  EngineConfig,
+  GenerateContentRequest,
+  RawEnvelope,
+  ScriptEntry,
+  ScriptMatcher,
+  ScriptRespond,
+  ScriptShorthand,
+  WireCandidate,
+  WireChunk,
+  WireContent,
+  WireErrorEnvelope,
+  WirePart,
+  WireResponse,
+  WireUsageMetadata,
+} from './types.js';