@rei-standard/amsg-shared 0.4.0-next.0 → 0.4.0-next.1

package/dist/index.cjs

@@ -345,7 +345,8 @@ function buildSessionContext({
   contactName,
   avatarUrl,
   charId,
-  metadata
+  metadata,
+  scratch
 }) {
   const llmOutputText = readLlmOutputText(llmResponse);
   const ctx = {
@@ -359,6 +360,7 @@ function buildSessionContext({
     contactName,
     avatarUrl: avatarUrl || void 0
   };
+  if (scratch !== void 0) ctx.scratch = scratch;
   return Object.freeze(ctx);
 }
 function readLlmOutputText(llmResponse) {

package/dist/index.d.cts

@@ -316,6 +316,7 @@ export function stripReasoningTags(content: string): string;
  * @property {Record<string, unknown>}  metadata
  * @property {string}                   contactName
  * @property {string}                   [avatarUrl]
+ * @property {Record<string, unknown>}  [scratch]      - Per-fire host scratch object. Producers that run several hooks within one fire (amsg-server's fire-time loop) pass the same mutable object to every hook of that fire, so hooks can hand context to each other without a module-level Map. The library never reads, writes, logs, or persists it, and never shares it across fires. Absent when the producer does not supply one (amsg-instant).
  */
 /**
  * Build the frozen SessionContext handed to an onLLMOutput hook.
@@ -335,9 +336,10 @@ export function stripReasoningTags(content: string): string;
  * @param {string} [args.avatarUrl]
  * @param {string} [args.charId]
  * @param {Record<string, unknown>} [args.metadata]
+ * @param {Record<string, unknown>} [args.scratch]
  * @returns {SessionContext}
  */
-export function buildSessionContext({ sessionId, messages, llmResponse, iteration, contactName, avatarUrl, charId, metadata, }: {
+export function buildSessionContext({ sessionId, messages, llmResponse, iteration, contactName, avatarUrl, charId, metadata, scratch, }: {
     sessionId: string;
     messages: ChatMessage[];
     llmResponse: unknown;
@@ -346,6 +348,7 @@ export function buildSessionContext({ sessionId, messages, llmResponse, iteratio
     avatarUrl?: string;
     charId?: string;
     metadata?: Record<string, unknown>;
+    scratch?: Record<string, unknown>;
 }): SessionContext;
 /**
  * Extract the `choices[0].message` whole object — preserving `tool_calls`
@@ -687,6 +690,10 @@ export type SessionContext = {
     metadata: Record<string, unknown>;
     contactName: string;
     avatarUrl?: string;
+    /**
+     * - Per-fire host scratch object. Producers that run several hooks within one fire (amsg-server's fire-time loop) pass the same mutable object to every hook of that fire, so hooks can hand context to each other without a module-level Map. The library never reads, writes, logs, or persists it, and never shares it across fires. Absent when the producer does not supply one (amsg-instant).
+     */
+    scratch?: Record<string, unknown>;
 };
 /**
  * What the push carries. Fixed enum — packages must not add values.

package/dist/index.d.ts

@@ -316,6 +316,7 @@ export function stripReasoningTags(content: string): string;
  * @property {Record<string, unknown>}  metadata
  * @property {string}                   contactName
  * @property {string}                   [avatarUrl]
+ * @property {Record<string, unknown>}  [scratch]      - Per-fire host scratch object. Producers that run several hooks within one fire (amsg-server's fire-time loop) pass the same mutable object to every hook of that fire, so hooks can hand context to each other without a module-level Map. The library never reads, writes, logs, or persists it, and never shares it across fires. Absent when the producer does not supply one (amsg-instant).
  */
 /**
  * Build the frozen SessionContext handed to an onLLMOutput hook.
@@ -335,9 +336,10 @@ export function stripReasoningTags(content: string): string;
  * @param {string} [args.avatarUrl]
  * @param {string} [args.charId]
  * @param {Record<string, unknown>} [args.metadata]
+ * @param {Record<string, unknown>} [args.scratch]
  * @returns {SessionContext}
  */
-export function buildSessionContext({ sessionId, messages, llmResponse, iteration, contactName, avatarUrl, charId, metadata, }: {
+export function buildSessionContext({ sessionId, messages, llmResponse, iteration, contactName, avatarUrl, charId, metadata, scratch, }: {
     sessionId: string;
     messages: ChatMessage[];
     llmResponse: unknown;
@@ -346,6 +348,7 @@ export function buildSessionContext({ sessionId, messages, llmResponse, iteratio
     avatarUrl?: string;
     charId?: string;
     metadata?: Record<string, unknown>;
+    scratch?: Record<string, unknown>;
 }): SessionContext;
 /**
  * Extract the `choices[0].message` whole object — preserving `tool_calls`
@@ -687,6 +690,10 @@ export type SessionContext = {
     metadata: Record<string, unknown>;
     contactName: string;
     avatarUrl?: string;
+    /**
+     * - Per-fire host scratch object. Producers that run several hooks within one fire (amsg-server's fire-time loop) pass the same mutable object to every hook of that fire, so hooks can hand context to each other without a module-level Map. The library never reads, writes, logs, or persists it, and never shares it across fires. Absent when the producer does not supply one (amsg-instant).
+     */
+    scratch?: Record<string, unknown>;
 };
 /**
  * What the push carries. Fixed enum — packages must not add values.

package/dist/index.mjs

@@ -298,7 +298,8 @@ function buildSessionContext({
   contactName,
   avatarUrl,
   charId,
-  metadata
+  metadata,
+  scratch
 }) {
   const llmOutputText = readLlmOutputText(llmResponse);
   const ctx = {
@@ -312,6 +313,7 @@ function buildSessionContext({
     contactName,
     avatarUrl: avatarUrl || void 0
   };
+  if (scratch !== void 0) ctx.scratch = scratch;
   return Object.freeze(ctx);
 }
 function readLlmOutputText(llmResponse) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rei-standard/amsg-shared",
-  "version": "0.4.0-next.0",
+  "version": "0.4.0-next.1",
   "description": "ReiStandard Active Messaging shared types and push builders — the lowest layer (no deps on other amsg packages)",
   "repository": {
     "type": "git",