@haneinfo/assignment 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,14 @@
+Copyright (c) 2026 Haneinfo. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the proprietary and
+confidential property of Haneinfo. No part of the Software may be copied, modified, merged,
+published, distributed, sublicensed, or sold without the prior written permission of Haneinfo.
+
+The Software is provided for internal use by Haneinfo and its authorized personnel only, and is
+NOT licensed for external distribution or open-source use.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL HANEINFO BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/agent-guide.md

@@ -0,0 +1,95 @@
+# @haneinfo/assignment — Agent Guide
+
+## Purpose
+
+The assignment mechanism (decision `202610-00b3`, first batch; details in its own decision). An
+`Assignment` definition says: when an instance of a StateMachine **enters a state**, these people
+get a task, and their **response takes a transition**. It covers approvals, read-and-acknowledge
+steps and task hand-offs.
+
+```json
+{
+  "kind": "Assignment",
+  "schemaVersion": 1,
+  "metadata": { "code": "equipment-manager-approval", "name": "Approve equipment loan" },
+  "spec": {
+    "stateMachine": { "kind": "StateMachine", "code": "equipment-loan-flow" },
+    "onEnter": "SUBMITTED",
+    "assignees": [{ "type": "ROLE", "role": "EQUIPMENT_MANAGER" }],
+    "policy": "ANY_ONE",
+    "responses": [
+      { "key": "approve", "label": "Approve", "transition": "approve" },
+      { "key": "reject", "label": "Reject", "transition": "reject" }
+    ],
+    "dueIn": "P2D"
+  }
+}
+```
+
+## When to use it, and when not
+
+Use it whenever a person must act before a business object moves on. Do not use it for plain
+notifications (that is a Timer `NOTIFY` action or the notification inbox) or for decisions a rule
+could make (rules engine, later).
+
+## Kind and example definition
+
+- `stateMachine`, `onEnter`: the machine and the state that opens the tasks. Not a FINAL state.
+- `assignees`: person resolvers — `SPECIFIC_USER` (`userIds`), `ROLE` (role machine name, resolved
+  through RBAC), `FORM_FIELD_USER` (a `user_select` field of the machine's subject Form, by id),
+  `SUBMITTER`. Resolving to nobody makes the transition into `onEnter` fail with
+  `ASSIGNEE_UNRESOLVED` — fix the role membership or the field.
+- `policy`: `ANY_ONE` (first response decides; use it for roles), `SINGLE` (same, but you expect
+  exactly one person — a warning if the resolvers can produce several), `JOINT` (everybody must give
+  the one non-`decisive` response; one `decisive` response — e.g. reject — decides at once).
+- `responses[]`: `key`, `label`, `transition` (must leave `onEnter`), `decisive` (JOINT only).
+- `dueIn`: ISO 8601 duration (`P2D`, `PT4H`); it only sets the task's due time. What happens when
+  it passes is a Timer with an `ASSIGNMENT_DUE` anchor.
+- `title`: shown to the assignees; defaults to `metadata.name`.
+- Permissions: `assignment:definition:read|write|publish`.
+
+Instances pin the published assignments of their machine when they start; re-entering the state
+opens a new round. Leaving the state any other way (a Timer, a person) cancels open tasks.
+
+Example: `examples/definitions/equipment-loan/equipment-manager-approval.assignment.json`.
+
+## MCP tools
+
+| Tool | Scope | Use |
+| --- | --- | --- |
+| `list_my_assignments` | `<namespace>:assignment:read` (read only) | Tasks of the person the connection acts for, with responses and instance data (as `$userContent`) |
+
+There is no tool to respond: a response takes a transition (approve, reject) and stays a human
+step in the App. Register from the App: `assignmentMcpTools.registerInto(registry, { scopeNamespace })`.
+
+## HTTP API (people)
+
+| Route | Purpose |
+| --- | --- |
+| `GET /assignments/mine?status=OPEN` | Your tasks |
+| `GET /assignments/:id` | One of your tasks with the instance |
+| `POST /assignments/:id/respond` `{ response, comment? }` | Respond; may take the transition |
+
+## Events
+
+`assignment.opened` (`assignmentCode`, `round`, `dueAt`, `assigneeIds`) and `assignment.closed`
+(`assignmentCode`, `round`, `outcome`: the response key or `CANCELLED`), on the state-machine
+runtime's event channel. Timer uses them for `ASSIGNMENT_DUE`.
+
+## Adapters
+
+None. Roles resolve through `haneinfo.rbac-policy` (`userIdsWithRole`); assignees are notified through
+`haneinfo.notification-inbox` when it is installed.
+
+## Common error codes and fixes
+
+| Code | Fix |
+| --- | --- |
+| `UNKNOWN_STATE` / `ASSIGNMENT_ON_FINAL_STATE` | `onEnter` must be a non-FINAL state of the machine |
+| `UNKNOWN_TRANSITION` / `TRANSITION_NOT_FROM_STATE` | A response's transition must leave `onEnter` |
+| `JOINT_NEEDS_ONE_AGREEMENT` | Mark all but one JOINT response as `decisive` |
+| `SINGLE_MAY_RESOLVE_MANY` (warning) | Use `ANY_ONE` for roles |
+| `NOT_A_USER_FIELD` / `NO_SUBJECT_FORM` | `FORM_FIELD_USER` needs a `user_select` field of the subject Form |
+| `INVALID_DURATION` | `dueIn` is a positive duration without months or years |
+| `ASSIGNEE_UNRESOLVED` (runtime) | The resolvers produced nobody; see `details.unresolved` |
+| `TASK_NOT_OPEN` (runtime) | Someone else already decided, or the instance moved on |

package/dist/assignment.controller.d.ts

@@ -0,0 +1,53 @@
+import { type InteractivePrincipal } from '@haneinfo/plugin-api';
+import { AssignmentService } from './assignment.service';
+/** A person's tasks. Responding — which takes a transition — is only possible here, never through MCP. */
+export declare class AssignmentController {
+    private readonly assignments;
+    constructor(assignments: AssignmentService);
+    mine(user: InteractivePrincipal, query: unknown): Promise<{
+        tasks: import("./assignment.service").AssignmentTaskView[];
+    }>;
+    get(user: InteractivePrincipal, id: string): Promise<import("./assignment.service").AssignmentTaskView>;
+    respond(user: InteractivePrincipal, id: string, body: unknown): Promise<{
+        completed: boolean;
+        task: {
+            status: "RESPONDED";
+            response: string;
+            id: string;
+            instanceId: string;
+            assignmentCode: string;
+            assignmentVersion: number;
+            round: number;
+            assigneeId: string;
+            title: string;
+            comment: string | null;
+            dueAt: Date | null;
+            respondedAt: Date | null;
+            createdAt: Date;
+        };
+        instance?: undefined;
+    } | {
+        completed: boolean;
+        task: {
+            status: "RESPONDED";
+            response: string;
+            id: string;
+            instanceId: string;
+            assignmentCode: string;
+            assignmentVersion: number;
+            round: number;
+            assigneeId: string;
+            title: string;
+            comment: string | null;
+            dueAt: Date | null;
+            respondedAt: Date | null;
+            createdAt: Date;
+        };
+        instance: {
+            id: string;
+            state: string;
+            revision: number;
+        };
+    }>;
+}
+//# sourceMappingURL=assignment.controller.d.ts.map

package/dist/assignment.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.controller.d.ts","sourceRoot":"","sources":["../src/assignment.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,sBAAsB,CAAC;AAajF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAwBzD,0GAA0G;AAC1G,qBAEa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,iBAAiB;IAG3D,IAAI,CAAgB,IAAI,EAAE,oBAAoB,EAAW,KAAK,EAAE,OAAO;;;IAUvE,GAAG,CAAgB,IAAI,EAAE,oBAAoB,EAAe,EAAE,EAAE,MAAM;IAKtE,OAAO,CACU,IAAI,EAAE,oBAAoB,EAC5B,EAAE,EAAE,MAAM,EACf,IAAI,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYxB"}

package/dist/assignment.controller.js

@@ -0,0 +1,96 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignmentController = void 0;
+const plugin_api_1 = require("@haneinfo/plugin-api");
+const plugin_host_nest_1 = require("@haneinfo/plugin-host-nest");
+const common_1 = require("@nestjs/common");
+const zod_1 = require("zod");
+const assignment_service_1 = require("./assignment.service");
+const respondBody = zod_1.z.object({
+    response: zod_1.z.string().min(1),
+    comment: zod_1.z.string().max(2000).optional(),
+});
+const listQuery = zod_1.z.object({
+    status: zod_1.z.enum(['OPEN', 'RESPONDED', 'CLOSED', 'CANCELLED']).optional(),
+});
+async function run(work) {
+    try {
+        return await work();
+    }
+    catch (error) {
+        if (error instanceof plugin_api_1.MechanismError)
+            throw new common_1.HttpException(error.toJSON(), error.status);
+        if (error instanceof zod_1.z.ZodError)
+            throw new common_1.HttpException({ code: 'INVALID_INPUT', message: 'Invalid request', issues: error.issues }, 400);
+        throw error;
+    }
+}
+/** A person's tasks. Responding — which takes a transition — is only possible here, never through MCP. */
+let AssignmentController = class AssignmentController {
+    constructor(assignments) {
+        this.assignments = assignments;
+    }
+    mine(user, query) {
+        return run(async () => ({
+            tasks: await this.assignments.listMine(user.sub, listQuery.parse(query ?? {}).status ?? 'OPEN'),
+        }));
+    }
+    get(user, id) {
+        return run(() => this.assignments.getMine(user.sub, id));
+    }
+    respond(user, id, body) {
+        return run(() => {
+            const parsed = respondBody.parse(body);
+            return this.assignments.respond({
+                taskId: id,
+                response: parsed.response,
+                comment: parsed.comment,
+                userId: user.sub,
+            });
+        });
+    }
+};
+exports.AssignmentController = AssignmentController;
+__decorate([
+    (0, common_1.Get)('mine'),
+    __param(0, (0, plugin_host_nest_1.CurrentUser)()),
+    __param(1, (0, common_1.Query)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", void 0)
+], AssignmentController.prototype, "mine", null);
+__decorate([
+    (0, common_1.Get)(':id'),
+    __param(0, (0, plugin_host_nest_1.CurrentUser)()),
+    __param(1, (0, common_1.Param)('id')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", void 0)
+], AssignmentController.prototype, "get", null);
+__decorate([
+    (0, common_1.Post)(':id/respond'),
+    __param(0, (0, plugin_host_nest_1.CurrentUser)()),
+    __param(1, (0, common_1.Param)('id')),
+    __param(2, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, Object]),
+    __metadata("design:returntype", void 0)
+], AssignmentController.prototype, "respond", null);
+exports.AssignmentController = AssignmentController = __decorate([
+    (0, common_1.Controller)('assignments'),
+    (0, common_1.UseGuards)(plugin_host_nest_1.InteractiveAuthGuard),
+    __metadata("design:paramtypes", [assignment_service_1.AssignmentService])
+], AssignmentController);
+//# sourceMappingURL=assignment.controller.js.map

package/dist/assignment.controller.js.map

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

package/dist/assignment.module.d.ts

@@ -0,0 +1,10 @@
+import { type DefinitionRegistryPort } from '@haneinfo/plugin-api';
+import { type OnModuleInit } from '@nestjs/common';
+export declare class AssignmentKindRegistration implements OnModuleInit {
+    private readonly registry;
+    constructor(registry: DefinitionRegistryPort);
+    onModuleInit(): void;
+}
+export declare class AssignmentModule {
+}
+//# sourceMappingURL=assignment.module.d.ts.map

package/dist/assignment.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.module.d.ts","sourceRoot":"","sources":["../src/assignment.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ/E,qBACa,0BAA2B,YAAW,YAAY;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,sBAAsB;IAE1F,YAAY;CAGb;AAED,qBAca,gBAAgB;CAAG"}

package/dist/assignment.module.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignmentModule = exports.AssignmentKindRegistration = void 0;
+const common_1 = require("@haneinfo/common");
+const plugin_api_1 = require("@haneinfo/plugin-api");
+const common_2 = require("@nestjs/common");
+const assignment_controller_1 = require("./assignment.controller");
+const assignment_service_1 = require("./assignment.service");
+const kind_1 = require("./kind");
+const mcp_tools_1 = require("./mcp-tools");
+const prisma_store_1 = require("./prisma-store");
+const store_1 = require("./store");
+let AssignmentKindRegistration = class AssignmentKindRegistration {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    onModuleInit() {
+        this.registry.registerKind(kind_1.assignmentDefinitionKind);
+    }
+};
+exports.AssignmentKindRegistration = AssignmentKindRegistration;
+exports.AssignmentKindRegistration = AssignmentKindRegistration = __decorate([
+    (0, common_2.Injectable)(),
+    __param(0, (0, common_2.Inject)(plugin_api_1.DEFINITION_REGISTRY)),
+    __metadata("design:paramtypes", [Object])
+], AssignmentKindRegistration);
+let AssignmentModule = class AssignmentModule {
+};
+exports.AssignmentModule = AssignmentModule;
+exports.AssignmentModule = AssignmentModule = __decorate([
+    (0, common_2.Module)({
+        controllers: [assignment_controller_1.AssignmentController],
+        providers: [
+            AssignmentKindRegistration,
+            {
+                provide: store_1.ASSIGNMENT_STORE,
+                useFactory: (prisma) => new prisma_store_1.PrismaAssignmentStore(prisma),
+                inject: [common_1.PrismaService],
+            },
+            assignment_service_1.AssignmentService,
+            mcp_tools_1.AssignmentMcpTools,
+        ],
+        exports: [assignment_service_1.AssignmentService, mcp_tools_1.AssignmentMcpTools],
+    })
+], AssignmentModule);
+//# sourceMappingURL=assignment.module.js.map

package/dist/assignment.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.module.js","sourceRoot":"","sources":["../src/assignment.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6CAAiD;AACjD,qDAAwF;AACxF,2CAA+E;AAC/E,mEAA+D;AAC/D,6DAAyD;AACzD,iCAAkD;AAClD,2CAAiD;AACjD,iDAAuD;AACvD,mCAA2C;AAGpC,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,YAA0D,QAAgC;QAAhC,aAAQ,GAAR,QAAQ,CAAwB;IAAG,CAAC;IAE9F,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,+BAAwB,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AANY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;IAEE,WAAA,IAAA,eAAM,EAAC,gCAAmB,CAAC,CAAA;;GAD7B,0BAA0B,CAMtC;AAgBM,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAAG,CAAA;AAAnB,4CAAgB;2BAAhB,gBAAgB;IAd5B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,4CAAoB,CAAC;QACnC,SAAS,EAAE;YACT,0BAA0B;YAC1B;gBACE,OAAO,EAAE,wBAAgB;gBACzB,UAAU,EAAE,CAAC,MAAqB,EAAE,EAAE,CAAC,IAAI,oCAAqB,CAAC,MAAM,CAAC;gBACxE,MAAM,EAAE,CAAC,sBAAa,CAAC;aACxB;YACD,sCAAiB;YACjB,8BAAkB;SACnB;QACD,OAAO,EAAE,CAAC,sCAAiB,EAAE,8BAAkB,CAAC;KACjD,CAAC;GACW,gBAAgB,CAAG"}

package/dist/assignment.service.d.ts

@@ -0,0 +1,92 @@
+/**
+ * The assignment runtime. It listens to the state-machine runtime:
+ *
+ * - `onStarted`: pin the published Assignment definitions that hang off this machine, so a later
+ *   publish never changes a running instance.
+ * - `onStateEntered`: cancel open tasks of assignments whose state was left, then open tasks for the
+ *   assignments whose `onEnter` is the new state.
+ *
+ * A response that completes the assignment takes its transition through the runtime, in the same
+ * transaction, with an ASSIGNMENT trigger (which skips the transition's person permission: the
+ * assignment itself is the authorization).
+ */
+import { type DefinitionRegistryPort, type NotificationInboxPort, type RbacPolicyPort, type StateMachineInstanceView, type StateMachineListener, type StateMachineRuntimePort } from '@haneinfo/plugin-api';
+import { type OnModuleInit } from '@nestjs/common';
+import { type AssignmentStore, type TaskRecord } from './store';
+import type { AssignmentResponse, AssignmentSpec } from './types';
+export declare const ASSIGNMENT_CLOCK: unique symbol;
+export declare const ASSIGNMENT_APP_NAME: unique symbol;
+export interface AssignmentTaskView extends TaskRecord {
+    responses: Pick<AssignmentResponse, 'key' | 'label'>[];
+    policy: AssignmentSpec['policy'];
+    instance: Pick<StateMachineInstanceView, 'id' | 'machine' | 'state' | 'data' | 'submitterId' | 'revision'> | null;
+}
+export declare class AssignmentService implements OnModuleInit {
+    private readonly store;
+    private readonly runtime;
+    private readonly registry;
+    private readonly rbac?;
+    private readonly notifications?;
+    private readonly appName;
+    private readonly now;
+    readonly listener: StateMachineListener;
+    constructor(store: AssignmentStore, runtime: StateMachineRuntimePort, registry: DefinitionRegistryPort, rbac?: RbacPolicyPort | undefined, notifications?: NotificationInboxPort | undefined, clock?: () => Date, appName?: string);
+    onModuleInit(): void;
+    private pin;
+    private onStateEntered;
+    private cancelOpen;
+    private open;
+    /** A person responds to their task. Human interface only (decision 202610-00b3, point 16 by analogy). */
+    respond(input: {
+        taskId: string;
+        response: string;
+        userId: string;
+        comment?: string;
+    }): Promise<{
+        completed: boolean;
+        task: {
+            status: "RESPONDED";
+            response: string;
+            id: string;
+            instanceId: string;
+            assignmentCode: string;
+            assignmentVersion: number;
+            round: number;
+            assigneeId: string;
+            title: string;
+            comment: string | null;
+            dueAt: Date | null;
+            respondedAt: Date | null;
+            createdAt: Date;
+        };
+        instance?: undefined;
+    } | {
+        completed: boolean;
+        task: {
+            status: "RESPONDED";
+            response: string;
+            id: string;
+            instanceId: string;
+            assignmentCode: string;
+            assignmentVersion: number;
+            round: number;
+            assigneeId: string;
+            title: string;
+            comment: string | null;
+            dueAt: Date | null;
+            respondedAt: Date | null;
+            createdAt: Date;
+        };
+        instance: {
+            id: string;
+            state: string;
+            revision: number;
+        };
+    }>;
+    listMine(userId: string, status?: TaskRecord['status'] | undefined): Promise<AssignmentTaskView[]>;
+    getMine(userId: string, taskId: string): Promise<AssignmentTaskView>;
+    /** Every task of an instance, for its history view. */
+    tasksOf(instanceId: string, tx?: unknown): Promise<TaskRecord[]>;
+    private view;
+}
+//# sourceMappingURL=assignment.service.d.ts.map

package/dist/assignment.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignment.service.d.ts","sourceRoot":"","sources":["../src/assignment.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,KAAK,sBAAsB,EAG3B,KAAK,qBAAqB,EAG1B,KAAK,cAAc,EAGnB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAsB,KAAK,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAEL,KAAK,eAAe,EAGpB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAElE,eAAO,MAAM,gBAAgB,eAA0C,CAAC;AACxE,eAAO,MAAM,mBAAmB,eAA6C,CAAC;AAE9E,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,SAAS,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;IACvD,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,QAAQ,EAAE,IAAI,CACZ,wBAAwB,EACxB,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CACjE,GAAG,IAAI,CAAC;CACV;AAED,qBACa,iBAAkB,YAAW,YAAY;IASxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACf,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAdnE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IAEjC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAGrC;gBAG2C,KAAK,EAAE,eAAe,EACjB,OAAO,EAAE,uBAAuB,EAClC,QAAQ,EAAE,sBAAsB,EAC5B,IAAI,CAAC,EAAE,cAAc,YAAA,EACd,aAAa,CAAC,EAAE,qBAAqB,YAAA,EACxD,KAAK,CAAC,EAAE,MAAM,IAAI,EACE,OAAO,GAAE,MAAc;IAKnF,YAAY;YAME,GAAG;YAaH,cAAc;YAcd,UAAU;YAmBV,IAAI;IA2ElB,yGAAyG;IACnG,OAAO,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8FrF,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,SAAkB,GAChD,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAO1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS1E,uDAAuD;IACjD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,OAAO;YAIhC,IAAI;CA4BnB"}