@moltzap/client 2026.503.4 → 2026.504.0

package/dist/internal/__tests__/app-callback-test-requests.d.ts

@@ -0,0 +1,58 @@
+import { AppsOnBeforeDispatch, AppsOnBeforeMessageDelivery, AppsOnClose, AppsOnJoin, AppsOnSessionActive, type Static } from "@moltzap/protocol";
+import { type PartitionableRequest } from "../app-callback-partition-key.js";
+export declare const SESSION_A = "11111111-1111-4111-8111-111111111111";
+export declare const SESSION_B = "22222222-2222-4222-8222-222222222222";
+export declare const CONV_X: string & import("effect/Brand").Brand<"ConversationId">;
+export declare const CONV_Y: string & import("effect/Brand").Brand<"ConversationId">;
+export declare const CONV_Z: string & import("effect/Brand").Brand<"ConversationId">;
+export declare const AGENT_A: string & import("effect/Brand").Brand<"AgentId">;
+export declare const MESSAGE_A: string & import("effect/Brand").Brand<"MessageId">;
+export declare const conversationIdForIndex: (index: number) => string & import("effect/Brand").Brand<"ConversationId">;
+export declare function beforeDispatchParams(sessionId?: string, conv?: string & import("effect/Brand").Brand<"ConversationId">): Static<typeof AppsOnBeforeDispatch.paramsSchema>;
+export declare function beforeDispatch(id: string, sessionId?: string, conv?: string & import("effect/Brand").Brand<"ConversationId">): PartitionableRequest;
+export declare function beforeMessageDeliveryParams(sessionId?: string, conv?: string & import("effect/Brand").Brand<"ConversationId">): Static<typeof AppsOnBeforeMessageDelivery.paramsSchema>;
+export declare function beforeMessageDelivery(id: string, sessionId?: string, conv?: string & import("effect/Brand").Brand<"ConversationId">): PartitionableRequest;
+export declare function onJoinParams(sessionId?: string): Static<typeof AppsOnJoin.paramsSchema>;
+export declare function onJoin(id: string, sessionId?: string): PartitionableRequest;
+export declare function onCloseParams(sessionId?: string): Static<typeof AppsOnClose.paramsSchema>;
+export declare function onClose(id: string, sessionId?: string): PartitionableRequest;
+export declare function onSessionActiveParams(sessionId?: string): Static<typeof AppsOnSessionActive.paramsSchema>;
+export declare function onSessionActive(id: string, sessionId?: string): PartitionableRequest;
+export declare const lifecycleRequests: readonly [{
+    readonly definition: import("@moltzap/protocol").RpcDefinition<"apps/onJoin", import("@sinclair/typebox").TObject<{
+        sessionId: import("@sinclair/typebox").TString;
+        appId: import("@sinclair/typebox").TString;
+        conversations: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>;
+        agent: import("@sinclair/typebox").TObject<{
+            agentId: import("@sinclair/typebox").TString & {
+                static: import("@moltzap/protocol").BrandedString<"AgentId">;
+            };
+            ownerId: import("@sinclair/typebox").TString;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{}>>;
+    readonly request: (id: string, sessionId?: string) => PartitionableRequest;
+}, {
+    readonly definition: import("@moltzap/protocol").RpcDefinition<"apps/onClose", import("@sinclair/typebox").TObject<{
+        sessionId: import("@sinclair/typebox").TString;
+        appId: import("@sinclair/typebox").TString;
+        conversations: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>;
+        closedBy: import("@sinclair/typebox").TObject<{
+            agentId: import("@sinclair/typebox").TString & {
+                static: import("@moltzap/protocol").BrandedString<"AgentId">;
+            };
+            ownerId: import("@sinclair/typebox").TString;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{}>>;
+    readonly request: (id: string, sessionId?: string) => PartitionableRequest;
+}, {
+    readonly definition: import("@moltzap/protocol").RpcDefinition<"apps/onSessionActive", import("@sinclair/typebox").TObject<{
+        sessionId: import("@sinclair/typebox").TString;
+        appId: import("@sinclair/typebox").TString;
+        conversations: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>;
+        admittedAgentIds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString & {
+            static: import("@moltzap/protocol").BrandedString<"AgentId">;
+        }>;
+    }>, import("@sinclair/typebox").TObject<{}>>;
+    readonly request: (id: string, sessionId?: string) => PartitionableRequest;
+}];
+//# sourceMappingURL=app-callback-test-requests.d.ts.map

package/dist/internal/__tests__/app-callback-test-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-test-requests.d.ts","sourceRoot":"","sources":["../../../src/internal/__tests__/app-callback-test-requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,2BAA2B,EAC3B,WAAW,EACX,UAAU,EACV,mBAAmB,EAInB,KAAK,MAAM,EACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAE1C,eAAO,MAAM,SAAS,yCAAyC,CAAC;AAChE,eAAO,MAAM,SAAS,yCAAyC,CAAC;AAChE,eAAO,MAAM,MAAM,yDAAyD,CAAC;AAC7E,eAAO,MAAM,MAAM,yDAAyD,CAAC;AAC7E,eAAO,MAAM,MAAM,yDAAyD,CAAC;AAC7E,eAAO,MAAM,OAAO,kDAAkD,CAAC;AACvE,eAAO,MAAM,SAAS,oDAAoD,CAAC;AAG3E,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,4DAGjD,CAAC;AAEJ,wBAAgB,oBAAoB,CAClC,SAAS,SAAY,EACrB,IAAI,0DAAS,GACZ,MAAM,CAAC,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAalD;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,SAAS,SAAY,EACrB,IAAI,0DAAS,GACZ,oBAAoB,CAQtB;AAED,wBAAgB,2BAA2B,CACzC,SAAS,SAAY,EACrB,IAAI,0DAAS,GACZ,MAAM,CAAC,OAAO,2BAA2B,CAAC,YAAY,CAAC,CAQzD;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,SAAS,SAAY,EACrB,IAAI,0DAAS,GACZ,oBAAoB,CAQtB;AAED,wBAAgB,YAAY,CAC1B,SAAS,SAAY,GACpB,MAAM,CAAC,OAAO,UAAU,CAAC,YAAY,CAAC,CAOxC;AAED,wBAAgB,MAAM,CACpB,EAAE,EAAE,MAAM,EACV,SAAS,SAAY,GACpB,oBAAoB,CAUtB;AAED,wBAAgB,aAAa,CAC3B,SAAS,SAAY,GACpB,MAAM,CAAC,OAAO,WAAW,CAAC,YAAY,CAAC,CAOzC;AAED,wBAAgB,OAAO,CACrB,EAAE,EAAE,MAAM,EACV,SAAS,SAAY,GACpB,oBAAoB,CAUtB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,SAAY,GACpB,MAAM,CAAC,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAOjD;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,SAAS,SAAY,GACpB,oBAAoB,CAUtB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;2BAGZ,MAAM;;;;;;;;;;;;;2BAIN,MAAM;;;;;;;;;;2BAIN,MAAM;EAGd,CAAC"}

package/dist/internal/__tests__/app-callback-test-requests.js

@@ -0,0 +1,124 @@
+import { agentId, AppsOnBeforeDispatch, AppsOnBeforeMessageDelivery, AppsOnClose, AppsOnJoin, AppsOnSessionActive, conversationId, jsonRpcStringId, messageId, } from "@moltzap/protocol";
+import { LIFECYCLE_CONVERSATION_SENTINEL, } from "../app-callback-partition-key.js";
+export const SESSION_A = "11111111-1111-4111-8111-111111111111";
+export const SESSION_B = "22222222-2222-4222-8222-222222222222";
+export const CONV_X = conversationId("33333333-3333-4333-8333-333333333333");
+export const CONV_Y = conversationId("44444444-4444-4444-8444-444444444444");
+export const CONV_Z = conversationId("77777777-7777-4777-8777-777777777777");
+export const AGENT_A = agentId("55555555-5555-4555-8555-555555555555");
+export const MESSAGE_A = messageId("66666666-6666-4666-8666-666666666666");
+const UUID_SUFFIX_WIDTH = 12;
+export const conversationIdForIndex = (index) => conversationId(`33333333-3333-4333-8333-${index.toString().padStart(UUID_SUFFIX_WIDTH, "0")}`);
+export function beforeDispatchParams(sessionId = SESSION_A, conv = CONV_X) {
+    return {
+        sessionId,
+        appId: "test-app",
+        conversationId: conv,
+        recipient: { agentId: AGENT_A, ownerId: "owner-a" },
+        message: {
+            id: MESSAGE_A,
+            senderAgentId: AGENT_A,
+            parts: [{ type: "text", text: "hello" }],
+        },
+        attempt: 0,
+    };
+}
+export function beforeDispatch(id, sessionId = SESSION_A, conv = CONV_X) {
+    const params = beforeDispatchParams(sessionId, conv);
+    return {
+        id: jsonRpcStringId(id),
+        definition: AppsOnBeforeDispatch,
+        params,
+        partition: { sessionId, conversationId: conv },
+    };
+}
+export function beforeMessageDeliveryParams(sessionId = SESSION_A, conv = CONV_X) {
+    return {
+        sessionId,
+        appId: "test-app",
+        conversationId: conv,
+        sender: { agentId: AGENT_A, ownerId: "owner-a" },
+        message: { parts: [{ type: "text", text: "hello" }] },
+    };
+}
+export function beforeMessageDelivery(id, sessionId = SESSION_A, conv = CONV_X) {
+    const params = beforeMessageDeliveryParams(sessionId, conv);
+    return {
+        id: jsonRpcStringId(id),
+        definition: AppsOnBeforeMessageDelivery,
+        params,
+        partition: { sessionId, conversationId: conv },
+    };
+}
+export function onJoinParams(sessionId = SESSION_A) {
+    return {
+        sessionId,
+        appId: "test-app",
+        conversations: { main: CONV_X },
+        agent: { agentId: AGENT_A, ownerId: "owner-a" },
+    };
+}
+export function onJoin(id, sessionId = SESSION_A) {
+    return {
+        id: jsonRpcStringId(id),
+        definition: AppsOnJoin,
+        params: onJoinParams(sessionId),
+        partition: {
+            sessionId,
+            conversationId: LIFECYCLE_CONVERSATION_SENTINEL,
+        },
+    };
+}
+export function onCloseParams(sessionId = SESSION_A) {
+    return {
+        sessionId,
+        appId: "test-app",
+        conversations: { main: CONV_X },
+        closedBy: { agentId: AGENT_A, ownerId: "owner-a" },
+    };
+}
+export function onClose(id, sessionId = SESSION_A) {
+    return {
+        id: jsonRpcStringId(id),
+        definition: AppsOnClose,
+        params: onCloseParams(sessionId),
+        partition: {
+            sessionId,
+            conversationId: LIFECYCLE_CONVERSATION_SENTINEL,
+        },
+    };
+}
+export function onSessionActiveParams(sessionId = SESSION_A) {
+    return {
+        sessionId,
+        appId: "test-app",
+        conversations: { main: CONV_X },
+        admittedAgentIds: [AGENT_A],
+    };
+}
+export function onSessionActive(id, sessionId = SESSION_A) {
+    return {
+        id: jsonRpcStringId(id),
+        definition: AppsOnSessionActive,
+        params: onSessionActiveParams(sessionId),
+        partition: {
+            sessionId,
+            conversationId: LIFECYCLE_CONVERSATION_SENTINEL,
+        },
+    };
+}
+export const lifecycleRequests = [
+    {
+        definition: AppsOnJoin,
+        request: (id, sessionId = SESSION_A) => onJoin(id, sessionId),
+    },
+    {
+        definition: AppsOnClose,
+        request: (id, sessionId = SESSION_A) => onClose(id, sessionId),
+    },
+    {
+        definition: AppsOnSessionActive,
+        request: (id, sessionId = SESSION_A) => onSessionActive(id, sessionId),
+    },
+];
+//# sourceMappingURL=app-callback-test-requests.js.map

package/dist/internal/__tests__/app-callback-test-requests.js.map

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

package/dist/internal/{s2c-dispatcher-errors.d.ts → app-callback-dispatcher-errors.d.ts}

@@ -1,20 +1,4 @@
-declare const MalformedPartitionKeyError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "MalformedPartitionKeyError";
-} & Readonly<A>;
-/**
- * The decoded server-request frame did not carry a usable partition key.
- * Examples: required `params.sessionId` missing or not a UUID; method
- * name absent from the s2c registry.
- *
- * Failure mode is structural — the request cannot be routed. The reader
- * synthesizes a `-32602 Invalid params` error response.
- */
-export declare class MalformedPartitionKeyError extends MalformedPartitionKeyError_base<{
-    readonly method: string;
-    readonly reason: "missing-session-id" | "missing-conversation-id" | "unknown-method" | "params-shape";
-    readonly requestId: string;
-}> {
-}
+import type { JsonRpcStringId } from "@moltzap/protocol";
 declare const PartitionLimitError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "PartitionLimitError";
 } & Readonly<A>;
@@ -32,7 +16,7 @@ export declare class PartitionLimitError extends PartitionLimitError_base<{
     readonly key: string;
     readonly activePartitions: number;
     readonly maxPartitions: number;
-    readonly requestId: string;
+    readonly requestId: JsonRpcStringId;
 }> {
 }
 declare const PartitionQueueFullError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
@@ -51,7 +35,7 @@ declare const PartitionQueueFullError_base: new <A extends Record<string, any> =
 export declare class PartitionQueueFullError extends PartitionQueueFullError_base<{
     readonly key: string;
     readonly capacity: number;
-    readonly requestId: string;
+    readonly requestId: JsonRpcStringId;
 }> {
 }
 /**
@@ -61,6 +45,6 @@ export declare class PartitionQueueFullError extends PartitionQueueFullError_bas
  * frame-routing path discriminate on `_tag` to pick the right wire-error
  * code.
  */
-export type OfferRejected = MalformedPartitionKeyError | PartitionLimitError | PartitionQueueFullError;
+export type OfferRejected = PartitionLimitError | PartitionQueueFullError;
 export {};
-//# sourceMappingURL=s2c-dispatcher-errors.d.ts.map
+//# sourceMappingURL=app-callback-dispatcher-errors.d.ts.map

package/dist/internal/app-callback-dispatcher-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-dispatcher-errors.d.ts","sourceRoot":"","sources":["../../src/internal/app-callback-dispatcher-errors.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;;;;AAEzD;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC,CAAC;CAAG;;;;AAEL;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,SAAQ,6BAE3C;IACA,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC,CAAC;CAAG;AAEL;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,uBAAuB,CAAC"}

package/dist/internal/{s2c-dispatcher-errors.js → app-callback-dispatcher-errors.js}

@@ -1,24 +1,14 @@
 /**
- * Tagged error types for the partitioned s2c dispatcher.
+ * Tagged error types for the partitioned appCallback dispatcher.
  *
  * Spec: moltzap#356 — partitioned dispatch keyed on
  * `(sessionId, conversationId, hookKind)`.
  *
  * All errors are surfaced on `PartitionedDispatcher.offer`'s typed channel.
- * The reader fiber translates each tag into an immediate s2c error response
+ * The reader fiber translates each tag into an immediate appCallback error response
  * so the server's `Deferred.await` resolves deterministically (no hangs).
  */
 import { Data } from "effect";
-/**
- * The decoded server-request frame did not carry a usable partition key.
- * Examples: required `params.sessionId` missing or not a UUID; method
- * name absent from the s2c registry.
- *
- * Failure mode is structural — the request cannot be routed. The reader
- * synthesizes a `-32602 Invalid params` error response.
- */
-export class MalformedPartitionKeyError extends Data.TaggedError("MalformedPartitionKeyError") {
-}
 /**
  * The active-partition count has reached `maxPartitions` (soft cap, default
  * 256). New partitions cannot be allocated until an existing partition is
@@ -43,4 +33,4 @@ export class PartitionLimitError extends Data.TaggedError("PartitionLimitError")
  */
 export class PartitionQueueFullError extends Data.TaggedError("PartitionQueueFullError") {
 }
-//# sourceMappingURL=s2c-dispatcher-errors.js.map
+//# sourceMappingURL=app-callback-dispatcher-errors.js.map

package/dist/internal/app-callback-dispatcher-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-dispatcher-errors.js","sourceRoot":"","sources":["../../src/internal/app-callback-dispatcher-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B;;;;;;;;;GASG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CACvD,qBAAqB,CAMrB;CAAG;AAEL;;;;;;;;;GASG;AACH,MAAM,OAAO,uBAAwB,SAAQ,IAAI,CAAC,WAAW,CAC3D,yBAAyB,CAKzB;CAAG"}

package/dist/internal/app-callback-partition-key.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pure partition-key extractor for the partitioned appCallback dispatcher.
+ *
+ * Spec: moltzap#356.
+ *
+ * `decodeFrames` is the wire boundary. It matches the JSON-RPC method to an
+ * app-callback descriptor, validates params against that descriptor, and
+ * projects the routing tuple. This module only receives that typed decoded
+ * request and turns the tuple into an opaque branded `PartitionKey`.
+ *
+ * There is no malformed-input branch here: malformed app-callback frames are
+ * rejected before a request can enter the dispatcher.
+ */
+import { Brand } from "effect";
+import { type AnyAppCallbackRpcDefinition, type DecodedRpcRequest, type JsonRpcStringId } from "@moltzap/protocol";
+/**
+ * Branded partition-key string. Constructed only by `extractPartitionKey`.
+ * Format is opaque to consumers; equality is value equality.
+ */
+export type PartitionKey = string & Brand.Brand<"PartitionKey">;
+export declare const PartitionKey: Brand.Brand.Constructor<PartitionKey>;
+declare const PartitionKeyInvariantError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "PartitionKeyInvariantError";
+} & Readonly<A>;
+export declare class PartitionKeyInvariantError extends PartitionKeyInvariantError_base<{
+    readonly key: PartitionKey;
+    readonly message: string;
+}> {
+}
+/**
+ * Sentinel placeholder for appCallback methods that carry no `conversationId`
+ * (lifecycle: `apps/onJoin`, `apps/onClose`, `apps/onSessionActive`).
+ * All lifecycle calls for the same `(sessionId, method)` share one
+ * partition; cross-method lifecycle ordering is preserved by the server,
+ * not the client.
+ */
+export declare const LIFECYCLE_CONVERSATION_SENTINEL: "*lifecycle*";
+export interface AppCallbackPartitionRoute {
+    readonly sessionId: string;
+    readonly conversationId: string;
+}
+/**
+ * Shape the dispatcher receives after the wire decoder has matched an
+ * app-callback descriptor and validated params against that descriptor.
+ */
+export type PartitionableRequest = DecodedRpcRequest<AnyAppCallbackRpcDefinition> & {
+    readonly id: JsonRpcStringId;
+    readonly partition: AppCallbackPartitionRoute;
+};
+/**
+ * Project a partition key from a typed appCallback request. The wire decoder
+ * has already validated method membership and params shape, so this function
+ * has no malformed-input branch.
+ */
+export declare function extractPartitionKey(request: PartitionableRequest): PartitionKey;
+/**
+ * Inverse projection for tests + observability. Pure deconstruction of a
+ * `PartitionKey` back into its three components. Returning a structured
+ * record (rather than a tuple) lets callers discriminate on
+ * `conversationId === LIFECYCLE_CONVERSATION_SENTINEL`.
+ */
+export declare function describePartitionKey(key: PartitionKey): {
+    readonly sessionId: string;
+    readonly conversationId: string;
+    readonly definition: AnyAppCallbackRpcDefinition;
+};
+export {};
+//# sourceMappingURL=app-callback-partition-key.d.ts.map

package/dist/internal/app-callback-partition-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-partition-key.d.ts","sourceRoot":"","sources":["../../src/internal/app-callback-partition-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAQ,MAAM,QAAQ,CAAC;AAErC,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAChE,eAAO,MAAM,YAAY,uCAAgC,CAAC;;;;AAE1D,qBAAa,0BAA2B,SAAQ,gCAE9C;IACA,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAG,aAAsB,CAAC;AAwBtE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC9B,iBAAiB,CAAC,2BAA2B,CAAC,GAAG;IAC/C,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AAEJ;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,YAAY,CAId;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;CAClD,CA6BA"}

package/dist/internal/app-callback-partition-key.js

@@ -0,0 +1,90 @@
+/**
+ * Pure partition-key extractor for the partitioned appCallback dispatcher.
+ *
+ * Spec: moltzap#356.
+ *
+ * `decodeFrames` is the wire boundary. It matches the JSON-RPC method to an
+ * app-callback descriptor, validates params against that descriptor, and
+ * projects the routing tuple. This module only receives that typed decoded
+ * request and turns the tuple into an opaque branded `PartitionKey`.
+ *
+ * There is no malformed-input branch here: malformed app-callback frames are
+ * rejected before a request can enter the dispatcher.
+ */
+import { Brand, Data } from "effect";
+import {} from "@moltzap/protocol";
+export const PartitionKey = Brand.nominal();
+export class PartitionKeyInvariantError extends Data.TaggedError("PartitionKeyInvariantError") {
+}
+/**
+ * Sentinel placeholder for appCallback methods that carry no `conversationId`
+ * (lifecycle: `apps/onJoin`, `apps/onClose`, `apps/onSessionActive`).
+ * All lifecycle calls for the same `(sessionId, method)` share one
+ * partition; cross-method lifecycle ordering is preserved by the server,
+ * not the client.
+ */
+export const LIFECYCLE_CONVERSATION_SENTINEL = "*lifecycle*";
+/**
+ * Field separator inside a `PartitionKey`. ASCII vertical bar; not legal
+ * in a UUID and not legal in any of our `appId` values, so the encoded
+ * key parses unambiguously.
+ */
+const KEY_SEP = "|";
+const definitionSegments = new WeakMap();
+const definitionsBySegment = new Map();
+let nextDefinitionSegment = 0;
+const segmentForDefinition = (definition) => {
+    const existing = definitionSegments.get(definition);
+    if (existing !== undefined)
+        return existing;
+    const segment = `rpc${nextDefinitionSegment}`;
+    nextDefinitionSegment += 1;
+    definitionSegments.set(definition, segment);
+    definitionsBySegment.set(segment, definition);
+    return segment;
+};
+/**
+ * Project a partition key from a typed appCallback request. The wire decoder
+ * has already validated method membership and params shape, so this function
+ * has no malformed-input branch.
+ */
+export function extractPartitionKey(request) {
+    return PartitionKey(`${request.partition.sessionId}${KEY_SEP}${request.partition.conversationId}${KEY_SEP}${segmentForDefinition(request.definition)}`);
+}
+/**
+ * Inverse projection for tests + observability. Pure deconstruction of a
+ * `PartitionKey` back into its three components. Returning a structured
+ * record (rather than a tuple) lets callers discriminate on
+ * `conversationId === LIFECYCLE_CONVERSATION_SENTINEL`.
+ */
+export function describePartitionKey(key) {
+    // Method is the only field that can contain a slash; sessionId is a
+    // UUID and conversationId is a UUID or the lifecycle sentinel. Split
+    // on the first two `KEY_SEP` occurrences only so a hypothetical
+    // future method name with `KEY_SEP` (impossible today; ASCII `|`)
+    // would still round-trip cleanly.
+    const first = key.indexOf(KEY_SEP);
+    const second = first === -1 ? -1 : key.indexOf(KEY_SEP, first + 1);
+    if (first === -1 || second === -1) {
+        // `extractPartitionKey` is the only constructor; an unparsable key
+        // means a caller bypassed branding. This is a programmer error,
+        // not a runtime user-input failure — fail loudly.
+        throw new PartitionKeyInvariantError({
+            key,
+            message: `describePartitionKey: malformed PartitionKey: ${key}`,
+        });
+    }
+    const definition = definitionsBySegment.get(key.slice(second + 1));
+    if (definition === undefined) {
+        throw new PartitionKeyInvariantError({
+            key,
+            message: `describePartitionKey: unknown descriptor segment: ${key}`,
+        });
+    }
+    return {
+        sessionId: key.slice(0, first),
+        conversationId: key.slice(first + 1, second),
+        definition,
+    };
+}
+//# sourceMappingURL=app-callback-partition-key.js.map

package/dist/internal/app-callback-partition-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-partition-key.js","sourceRoot":"","sources":["../../src/internal/app-callback-partition-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAIN,MAAM,mBAAmB,CAAC;AAO3B,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,EAAgB,CAAC;AAE1D,MAAM,OAAO,0BAA2B,SAAQ,IAAI,CAAC,WAAW,CAC9D,4BAA4B,CAI5B;CAAG;AAEL;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,aAAsB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,OAAO,GAAG,GAAG,CAAC;AACpB,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAuC,CAAC;AAC9E,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAuC,CAAC;AAC5E,IAAI,qBAAqB,GAAG,CAAC,CAAC;AAE9B,MAAM,oBAAoB,GAAG,CAC3B,UAAuC,EAC/B,EAAE;IACV,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAC9C,qBAAqB,IAAI,CAAC,CAAC;IAC3B,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5C,oBAAoB,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAiBF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6B;IAE7B,OAAO,YAAY,CACjB,GAAG,OAAO,CAAC,SAAS,CAAC,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,cAAc,GAAG,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CACnI,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAiB;IAKpD,oEAAoE;IACpE,qEAAqE;IACrE,gEAAgE;IAChE,kEAAkE;IAClE,kCAAkC;IAClC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAClC,mEAAmE;QACnE,gEAAgE;QAChE,kDAAkD;QAClD,MAAM,IAAI,0BAA0B,CAAC;YACnC,GAAG;YACH,OAAO,EAAE,iDAAiD,GAAG,EAAE;SAChE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACnE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,0BAA0B,CAAC;YACnC,GAAG;YACH,OAAO,EAAE,qDAAqD,GAAG,EAAE;SACpE,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;QAC9B,cAAc,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC;QAC5C,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/internal/{s2c-partition-worker.d.ts → app-callback-partition-worker.d.ts}

@@ -5,7 +5,7 @@
  * Spec: moltzap#356.
  *
  * Lifecycle is anchored in a per-worker `Scope.CloseableScope` provided
- * by the dispatcher (`s2c-partitioned-dispatcher.ts`'s
+ * by the dispatcher (`app-callback-partitioned-dispatcher.ts`'s
  * `getOrCreatePartitionWorker` calls `Scope.fork(dispatcherScope, …)`
  * for each new worker and hands the child scope in via the config).
  * Closing the worker's scope shuts the queue, runs registered
@@ -41,14 +41,14 @@
  * landing in between.
  */
 import { Effect, Fiber, MutableRef, Scope } from "effect";
-import { PartitionQueueFullError } from "./s2c-dispatcher-errors.js";
-import type { PartitionKey, PartitionableRequest } from "./s2c-partition-key.js";
+import { PartitionQueueFullError } from "./app-callback-dispatcher-errors.js";
+import type { PartitionKey, PartitionableRequest } from "./app-callback-partition-key.js";
 import type { WsClientLogger } from "../ws-client.js";
 /**
  * The handler the worker drains its queue against. Mirrors the existing
  * `dispatchInboundServerRequest` signature in `ws-client.ts:912-965` —
  * the dispatcher passes an already-bound function so the worker has no
- * direct knowledge of the registered s2c handler registry.
+ * direct knowledge of the registered appCallback handler registry.
  *
  * Defects inside `handle` are caught and logged by the worker; they
  * never escape into the per-connection scope's failure channel.
@@ -157,4 +157,4 @@ export interface PartitionWorkerConfig {
  * `Scope.extend`.
  */
 export declare function makePartitionWorker(config: PartitionWorkerConfig): Effect.Effect<PartitionWorker, never>;
-//# sourceMappingURL=s2c-partition-worker.d.ts.map
+//# sourceMappingURL=app-callback-partition-worker.d.ts.map

package/dist/internal/app-callback-partition-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-partition-worker.d.ts","sourceRoot":"","sources":["../../src/internal/app-callback-partition-worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAAS,MAAM,EAAE,KAAK,EAAE,UAAU,EAAS,KAAK,EAAU,MAAM,QAAQ,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,oBAAoB,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,CACd,OAAO,EAAE,oBAAoB,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,CAAC,CAmIvC"}

package/dist/internal/{s2c-partition-worker.js → app-callback-partition-worker.js}

@@ -5,7 +5,7 @@
  * Spec: moltzap#356.
  *
  * Lifecycle is anchored in a per-worker `Scope.CloseableScope` provided
- * by the dispatcher (`s2c-partitioned-dispatcher.ts`'s
+ * by the dispatcher (`app-callback-partitioned-dispatcher.ts`'s
  * `getOrCreatePartitionWorker` calls `Scope.fork(dispatcherScope, …)`
  * for each new worker and hands the child scope in via the config).
  * Closing the worker's scope shuts the queue, runs registered
@@ -41,7 +41,7 @@
  * landing in between.
  */
 import { Cause, Effect, Fiber, MutableRef, Queue, Scope, Stream } from "effect";
-import { PartitionQueueFullError } from "./s2c-dispatcher-errors.js";
+import { PartitionQueueFullError } from "./app-callback-dispatcher-errors.js";
 /**
  * Build one worker. Allocates a bounded queue, forks a draining fiber
  * via `Stream.fromQueue` + `Stream.runForEach`, and registers the
@@ -69,7 +69,7 @@ export function makePartitionWorker(config) {
         const drainEffect = Stream.fromQueue(queue).pipe(Stream.runForEach((request) => Effect.gen(function* () {
             MutableRef.set(idleSince, { _tag: "Busy" });
             yield* config.handle(request).pipe(Effect.catchAllCause((cause) => Effect.sync(() => {
-                config.logger?.warn(`s2c partition worker handler defected (key=${config.key})`, Cause.pretty(cause));
+                config.logger?.warn(`appCallback partition worker handler defected (key=${config.key})`, Cause.pretty(cause));
             })));
             const remaining = yield* Queue.size(queue).pipe(Effect.catchAllCause(() => Effect.succeed(0)));
             if (remaining === 0) {
@@ -79,7 +79,7 @@ export function makePartitionWorker(config) {
                 });
             }
         })), Effect.catchAllCause((cause) => Effect.sync(() => {
-            config.logger?.warn(`s2c partition worker fiber exited (key=${config.key})`, Cause.pretty(cause));
+            config.logger?.warn(`appCallback partition worker fiber exited (key=${config.key})`, Cause.pretty(cause));
         })), Effect.asVoid);
         const fiber = yield* Effect.forkScoped(drainEffect);
         // Shut the queue when the worker scope closes. `Effect.forkScoped`
@@ -138,4 +138,4 @@ export function makePartitionWorker(config) {
         };
     }), config.scope);
 }
-//# sourceMappingURL=s2c-partition-worker.js.map
+//# sourceMappingURL=app-callback-partition-worker.js.map

package/dist/internal/app-callback-partition-worker.js.map

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

package/dist/internal/{s2c-partitioned-dispatcher.d.ts → app-callback-partitioned-dispatcher.d.ts}

@@ -1,9 +1,9 @@
 /**
- * Partitioned s2c dispatcher.
+ * Partitioned appCallback dispatcher.
  *
  * Spec: moltzap#356.
  *
- * Replaces the single `Stream.runForEach(handler)` over `s2cInboundQueue`
+ * Replaces the single `Stream.runForEach(handler)` over `appCallbackInboundQueue`
  * (`packages/client/src/ws-client.ts:658-687@f0df363`) with a
  * partition-router that owns a `Ref<HashMap<PartitionKey,
  * PartitionWorker>>`. For each inbound request:
@@ -37,8 +37,8 @@
  * The dispatcher Scope is held in `ConnState`; teardown from
  * `close()` / `disconnectSync()` is
  * `runtime.runFork(Scope.close(dispatcherScope, Exit.void))`, mirroring
- * today's `runFork(Queue.shutdown(s2cInboundQueue))` +
- * `runFork(Fiber.interrupt(s2cDispatcherFiber))` pair.
+ * today's `runFork(Queue.shutdown(appCallbackInboundQueue))` +
+ * `runFork(Fiber.interrupt(appCallbackDispatcherFiber))` pair.
  *
  * Why off-Scope from the socket: `close()` is invoked via `runSync` at
  * `packages/openclaw-channel/src/__tests__/reconnection.integration.test.ts:14`;
@@ -57,9 +57,9 @@
  * worker without leaking finalizers onto the dispatcher scope.
  */
 import { Effect, Scope } from "effect";
-import { type OfferRejected } from "./s2c-dispatcher-errors.js";
-import { type PartitionKey, type PartitionableRequest } from "./s2c-partition-key.js";
-import { type PartitionHandler } from "./s2c-partition-worker.js";
+import { type OfferRejected } from "./app-callback-dispatcher-errors.js";
+import { type PartitionKey, type PartitionableRequest } from "./app-callback-partition-key.js";
+import { type PartitionHandler } from "./app-callback-partition-worker.js";
 import type { WsClientLogger } from "../ws-client.js";
 /**
  * Tunable knobs. Defaults named in the design doc; downstream picks
@@ -99,7 +99,6 @@ export interface DispatcherStats {
     readonly activePartitions: number;
     readonly totalOffered: number;
     readonly totalRejected: {
-        readonly malformed: number;
         readonly partitionLimit: number;
         readonly partitionQueueFull: number;
     };
@@ -148,7 +147,7 @@ export interface PartitionedDispatcher {
 /**
  * Construction params. `handle` is the per-request work — passed in so
  * the dispatcher has no direct dependency on the handler-registry
- * `Ref<HashMap<string, ServerRpcHandler>>` (`s2cHandlersRef`); the
+ * `Ref<HashMap<string, ServerRpcHandler>>` (`appCallbackHandlersRef`); the
  * caller (`ws-client.ts`) closes over the registry and supplies a
  * pre-bound function. This preserves the wire-edge schema-decoding
  * boundary already established in `dispatchInboundServerRequest`.
@@ -178,4 +177,4 @@ export interface MakePartitionedDispatcherParams {
  * explicitly via `Scope.extend`.
  */
 export declare function makePartitionedDispatcher(params: MakePartitionedDispatcherParams): Effect.Effect<PartitionedDispatcher, never>;
-//# sourceMappingURL=s2c-partitioned-dispatcher.d.ts.map
+//# sourceMappingURL=app-callback-partitioned-dispatcher.d.ts.map

package/dist/internal/app-callback-partitioned-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-callback-partitioned-dispatcher.d.ts","sourceRoot":"","sources":["../../src/internal/app-callback-partitioned-dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,OAAO,EAGL,MAAM,EAQN,KAAK,EACN,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,4EAA4E;AAC5E,eAAO,MAAM,qCAAqC,EAAE,2BAMjD,CAAC;AAEJ;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE;QACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,EAAE,CACd,OAAO,EAAE,oBAAoB,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,+BAA+B,GACtC,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAgH7C"}