@haneinfo/state-machine 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/LICENSE +14 -0
  2. package/agent-guide.md +113 -0
  3. package/dist/index.d.ts +11 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +35 -0
  6. package/dist/index.js.map +1 -0
  7. package/dist/kind.d.ts +12 -0
  8. package/dist/kind.d.ts.map +1 -0
  9. package/dist/kind.js +48 -0
  10. package/dist/kind.js.map +1 -0
  11. package/dist/mcp-tools.d.ts +58 -0
  12. package/dist/mcp-tools.d.ts.map +1 -0
  13. package/dist/mcp-tools.js +131 -0
  14. package/dist/mcp-tools.js.map +1 -0
  15. package/dist/plugin.d.ts +11 -0
  16. package/dist/plugin.d.ts.map +1 -0
  17. package/dist/plugin.js +72 -0
  18. package/dist/plugin.js.map +1 -0
  19. package/dist/prisma-store.d.ts +8 -0
  20. package/dist/prisma-store.d.ts.map +1 -0
  21. package/dist/prisma-store.js +76 -0
  22. package/dist/prisma-store.js.map +1 -0
  23. package/dist/runtime.service.d.ts +66 -0
  24. package/dist/runtime.service.d.ts.map +1 -0
  25. package/dist/runtime.service.js +292 -0
  26. package/dist/runtime.service.js.map +1 -0
  27. package/dist/semantics.d.ts +8 -0
  28. package/dist/semantics.d.ts.map +1 -0
  29. package/dist/semantics.js +83 -0
  30. package/dist/semantics.js.map +1 -0
  31. package/dist/simulate.d.ts +20 -0
  32. package/dist/simulate.d.ts.map +1 -0
  33. package/dist/simulate.js +46 -0
  34. package/dist/simulate.js.map +1 -0
  35. package/dist/state-machine.controller.d.ts +22 -0
  36. package/dist/state-machine.controller.d.ts.map +1 -0
  37. package/dist/state-machine.controller.js +143 -0
  38. package/dist/state-machine.controller.js.map +1 -0
  39. package/dist/state-machine.module.d.ts +11 -0
  40. package/dist/state-machine.module.d.ts.map +1 -0
  41. package/dist/state-machine.module.js +60 -0
  42. package/dist/state-machine.module.js.map +1 -0
  43. package/dist/store.d.ts +58 -0
  44. package/dist/store.d.ts.map +1 -0
  45. package/dist/store.js +73 -0
  46. package/dist/store.js.map +1 -0
  47. package/dist/testing.d.ts +19 -0
  48. package/dist/testing.d.ts.map +1 -0
  49. package/dist/testing.js +23 -0
  50. package/dist/testing.js.map +1 -0
  51. package/dist/types.d.ts +29 -0
  52. package/dist/types.d.ts.map +1 -0
  53. package/dist/types.js +8 -0
  54. package/dist/types.js.map +1 -0
  55. package/examples/definitions/equipment-loan/equipment-loan-flow.state-machine.json +43 -0
  56. package/haneinfo.plugin.json +56 -0
  57. package/package.json +79 -3
  58. package/plugin.d.ts +2 -0
  59. package/plugin.js +4 -0
  60. package/prisma/state-machine.prisma +40 -0
  61. package/schemas/state-machine.spec.json +66 -0
  62. package/testing.d.ts +2 -0
  63. package/testing.js +2 -0
  64. package/README.md +0 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"simulate.js","sourceRoot":"","sources":["../src/simulate.ts"],"names":[],"mappings":";AAAA,2FAA2F;;AA0B3F,oDAmDC;AA3ED,qDAI8B;AAC9B,mCAAgE;AAmBhE,SAAgB,oBAAoB,CAClC,IAAsB,EACtB,IAAuB;IAEvB,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE,CAClC,IAAI,CAAC,WAAW;SACb,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACvD,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,KAAK,CAAC,EAAE,IAAI,CAAC;IACjG,IAAI,KAAK,GAAG,IAAA,sBAAc,EAAC,IAAI,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,WAAW,CAAC,IAAI,CACd,IAAA,iCAAoB,EAAC,kBAAkB,EAAE,kCAAkC,EAAE,cAAc,CAAC,CAC7F,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;IAClF,CAAC;IACD,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;QAC/E,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,WAAW,CAAC,IAAI,CACd,IAAA,iCAAoB,EAClB,UAAU,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,oBAAoB,EAC9D,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,2BAA2B,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,uBAAuB,EACxF,IAAA,0BAAa,EAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAC9B;gBACE,UAAU,EAAE,SAAS,KAAK,mBAAmB,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,EAAE;aAC1F,CACF,CACF,CAAC;YACF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK;gBACL,KAAK;gBACL,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO;gBACnC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC;gBAC3B,WAAW;aACZ,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IACxB,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK;QACL,KAAK;QACL,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO;QACnC,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC;QAC3B,WAAW;KACZ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { type InteractivePrincipal } from '@haneinfo/plugin-api';
2
+ import { StateMachineRuntime } from './runtime.service';
3
+ export declare function runHttp<T>(work: () => Promise<T> | T): Promise<T>;
4
+ /** People start instances, edit their data and take transitions here; machines go through Assignment and Timer. */
5
+ export declare class StateMachineController {
6
+ private readonly runtime;
7
+ constructor(runtime: StateMachineRuntime);
8
+ start(user: InteractivePrincipal, machine: string, body: unknown): Promise<import("@haneinfo/plugin-api").StateMachineInstanceView>;
9
+ list(user: InteractivePrincipal, query: unknown): Promise<{
10
+ instances: import("@haneinfo/plugin-api").StateMachineInstanceView[];
11
+ }>;
12
+ get(user: InteractivePrincipal, id: string): Promise<{
13
+ instance: import("@haneinfo/plugin-api").StateMachineInstanceView;
14
+ history: import("./store").HistoryRecord[];
15
+ }>;
16
+ updateData(user: InteractivePrincipal, id: string, body: unknown): Promise<{
17
+ instance: import("@haneinfo/plugin-api").StateMachineInstanceView;
18
+ diagnostics: import("@haneinfo/plugin-api").DefinitionDiagnostic[];
19
+ }>;
20
+ transition(user: InteractivePrincipal, id: string, transition: string, body: unknown): Promise<import("@haneinfo/plugin-api").StateMachineInstanceView>;
21
+ }
22
+ //# sourceMappingURL=state-machine.controller.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-machine.controller.d.ts","sourceRoot":"","sources":["../src/state-machine.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,sBAAsB,CAAC;AAcjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAkBxD,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAavE;AAED,mHAAmH;AACnH,qBAEa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,mBAAmB;IAGzD,KAAK,CACY,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACtB,IAAI,EAAE,OAAO;IAYvB,IAAI,CAAgB,IAAI,EAAE,oBAAoB,EAAW,KAAK,EAAE,OAAO;;;IAUvE,GAAG,CAAgB,IAAI,EAAE,oBAAoB,EAAe,EAAE,EAAE,MAAM;;;;IAKtE,UAAU,CACO,IAAI,EAAE,oBAAoB,EAC5B,EAAE,EAAE,MAAM,EACf,IAAI,EAAE,OAAO;;;;IAcvB,UAAU,CACO,IAAI,EAAE,oBAAoB,EAC5B,EAAE,EAAE,MAAM,EACF,UAAU,EAAE,MAAM,EAC/B,IAAI,EAAE,OAAO;CAWxB"}
@@ -0,0 +1,143 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.StateMachineController = void 0;
16
+ exports.runHttp = runHttp;
17
+ const plugin_api_1 = require("@haneinfo/plugin-api");
18
+ const plugin_host_nest_1 = require("@haneinfo/plugin-host-nest");
19
+ const common_1 = require("@nestjs/common");
20
+ const zod_1 = require("zod");
21
+ const runtime_service_1 = require("./runtime.service");
22
+ const code = zod_1.z.string().regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/);
23
+ const startBody = zod_1.z.object({ data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}) });
24
+ const transitionBody = zod_1.z.object({ expectedRevision: zod_1.z.number().int().positive().optional() });
25
+ const dataBody = zod_1.z.object({
26
+ data: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
27
+ expectedRevision: zod_1.z.number().int().positive(),
28
+ });
29
+ const listQuery = zod_1.z.object({
30
+ machine: code.optional(),
31
+ state: zod_1.z.string().optional(),
32
+ mine: zod_1.z
33
+ .enum(['true', 'false'])
34
+ .optional()
35
+ .transform((value) => value === 'true'),
36
+ });
37
+ async function runHttp(work) {
38
+ try {
39
+ return await work();
40
+ }
41
+ catch (error) {
42
+ if (error instanceof plugin_api_1.MechanismError)
43
+ throw new common_1.HttpException(error.toJSON(), error.status);
44
+ if (error instanceof zod_1.z.ZodError) {
45
+ throw new common_1.HttpException({ code: 'INVALID_INPUT', message: 'Invalid request', issues: error.issues }, 400);
46
+ }
47
+ throw error;
48
+ }
49
+ }
50
+ /** People start instances, edit their data and take transitions here; machines go through Assignment and Timer. */
51
+ let StateMachineController = class StateMachineController {
52
+ constructor(runtime) {
53
+ this.runtime = runtime;
54
+ }
55
+ start(user, machine, body) {
56
+ return runHttp(() => this.runtime.start({
57
+ machine: code.parse(machine),
58
+ data: startBody.parse(body ?? {}).data,
59
+ submitterId: user.sub,
60
+ }));
61
+ }
62
+ list(user, query) {
63
+ return runHttp(async () => {
64
+ const { machine, state, mine } = listQuery.parse(query ?? {});
65
+ return {
66
+ instances: await this.runtime.listFor(user.sub, { machineCode: machine, state, mine }),
67
+ };
68
+ });
69
+ }
70
+ get(user, id) {
71
+ return runHttp(() => this.runtime.getFor(user.sub, id));
72
+ }
73
+ updateData(user, id, body) {
74
+ return runHttp(() => {
75
+ const parsed = dataBody.parse(body);
76
+ return this.runtime.updateData({
77
+ instanceId: id,
78
+ data: parsed.data,
79
+ userId: user.sub,
80
+ expectedRevision: parsed.expectedRevision,
81
+ });
82
+ });
83
+ }
84
+ transition(user, id, transition, body) {
85
+ return runHttp(() => this.runtime.transition({
86
+ instanceId: id,
87
+ transition,
88
+ trigger: { type: 'USER', userId: user.sub },
89
+ expectedRevision: transitionBody.parse(body ?? {}).expectedRevision,
90
+ }));
91
+ }
92
+ };
93
+ exports.StateMachineController = StateMachineController;
94
+ __decorate([
95
+ (0, common_1.Post)('state-machines/:code/instances'),
96
+ __param(0, (0, plugin_host_nest_1.CurrentUser)()),
97
+ __param(1, (0, common_1.Param)('code')),
98
+ __param(2, (0, common_1.Body)()),
99
+ __metadata("design:type", Function),
100
+ __metadata("design:paramtypes", [Object, String, Object]),
101
+ __metadata("design:returntype", void 0)
102
+ ], StateMachineController.prototype, "start", null);
103
+ __decorate([
104
+ (0, common_1.Get)('state-machine-instances'),
105
+ __param(0, (0, plugin_host_nest_1.CurrentUser)()),
106
+ __param(1, (0, common_1.Query)()),
107
+ __metadata("design:type", Function),
108
+ __metadata("design:paramtypes", [Object, Object]),
109
+ __metadata("design:returntype", void 0)
110
+ ], StateMachineController.prototype, "list", null);
111
+ __decorate([
112
+ (0, common_1.Get)('state-machine-instances/:id'),
113
+ __param(0, (0, plugin_host_nest_1.CurrentUser)()),
114
+ __param(1, (0, common_1.Param)('id')),
115
+ __metadata("design:type", Function),
116
+ __metadata("design:paramtypes", [Object, String]),
117
+ __metadata("design:returntype", void 0)
118
+ ], StateMachineController.prototype, "get", null);
119
+ __decorate([
120
+ (0, common_1.Patch)('state-machine-instances/:id/data'),
121
+ __param(0, (0, plugin_host_nest_1.CurrentUser)()),
122
+ __param(1, (0, common_1.Param)('id')),
123
+ __param(2, (0, common_1.Body)()),
124
+ __metadata("design:type", Function),
125
+ __metadata("design:paramtypes", [Object, String, Object]),
126
+ __metadata("design:returntype", void 0)
127
+ ], StateMachineController.prototype, "updateData", null);
128
+ __decorate([
129
+ (0, common_1.Post)('state-machine-instances/:id/transitions/:transition'),
130
+ __param(0, (0, plugin_host_nest_1.CurrentUser)()),
131
+ __param(1, (0, common_1.Param)('id')),
132
+ __param(2, (0, common_1.Param)('transition')),
133
+ __param(3, (0, common_1.Body)()),
134
+ __metadata("design:type", Function),
135
+ __metadata("design:paramtypes", [Object, String, String, Object]),
136
+ __metadata("design:returntype", void 0)
137
+ ], StateMachineController.prototype, "transition", null);
138
+ exports.StateMachineController = StateMachineController = __decorate([
139
+ (0, common_1.Controller)(),
140
+ (0, common_1.UseGuards)(plugin_host_nest_1.InteractiveAuthGuard),
141
+ __metadata("design:paramtypes", [runtime_service_1.StateMachineRuntime])
142
+ ], StateMachineController);
143
+ //# sourceMappingURL=state-machine.controller.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-machine.controller.js","sourceRoot":"","sources":["../src/state-machine.controller.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import { type DefinitionRegistryPort } from '@haneinfo/plugin-api';
2
+ import { type OnModuleInit } from '@nestjs/common';
3
+ /** Registers the StateMachine kind before repo definitions are synced on bootstrap. */
4
+ export declare class StateMachineKindRegistration implements OnModuleInit {
5
+ private readonly registry;
6
+ constructor(registry: DefinitionRegistryPort);
7
+ onModuleInit(): void;
8
+ }
9
+ export declare class StateMachineModule {
10
+ }
11
+ //# sourceMappingURL=state-machine.module.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-machine.module.d.ts","sourceRoot":"","sources":["../src/state-machine.module.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQ/E,uFAAuF;AACvF,qBACa,4BAA6B,YAAW,YAAY;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,sBAAsB;IAE1F,YAAY;CAGb;AAED,qBAea,kBAAkB;CAAG"}
@@ -0,0 +1,60 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ var __param = (this && this.__param) || function (paramIndex, decorator) {
12
+ return function (target, key) { decorator(target, key, paramIndex); }
13
+ };
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.StateMachineModule = exports.StateMachineKindRegistration = void 0;
16
+ const common_1 = require("@haneinfo/common");
17
+ const plugin_api_1 = require("@haneinfo/plugin-api");
18
+ const common_2 = require("@nestjs/common");
19
+ const kind_1 = require("./kind");
20
+ const mcp_tools_1 = require("./mcp-tools");
21
+ const prisma_store_1 = require("./prisma-store");
22
+ const runtime_service_1 = require("./runtime.service");
23
+ const state_machine_controller_1 = require("./state-machine.controller");
24
+ const store_1 = require("./store");
25
+ /** Registers the StateMachine kind before repo definitions are synced on bootstrap. */
26
+ let StateMachineKindRegistration = class StateMachineKindRegistration {
27
+ constructor(registry) {
28
+ this.registry = registry;
29
+ }
30
+ onModuleInit() {
31
+ this.registry.registerKind(kind_1.stateMachineDefinitionKind);
32
+ }
33
+ };
34
+ exports.StateMachineKindRegistration = StateMachineKindRegistration;
35
+ exports.StateMachineKindRegistration = StateMachineKindRegistration = __decorate([
36
+ (0, common_2.Injectable)(),
37
+ __param(0, (0, common_2.Inject)(plugin_api_1.DEFINITION_REGISTRY)),
38
+ __metadata("design:paramtypes", [Object])
39
+ ], StateMachineKindRegistration);
40
+ let StateMachineModule = class StateMachineModule {
41
+ };
42
+ exports.StateMachineModule = StateMachineModule;
43
+ exports.StateMachineModule = StateMachineModule = __decorate([
44
+ (0, common_2.Module)({
45
+ controllers: [state_machine_controller_1.StateMachineController],
46
+ providers: [
47
+ StateMachineKindRegistration,
48
+ {
49
+ provide: store_1.STATE_MACHINE_STORE,
50
+ useFactory: (prisma) => new prisma_store_1.PrismaStateMachineStore(prisma),
51
+ inject: [common_1.PrismaService],
52
+ },
53
+ runtime_service_1.StateMachineRuntime,
54
+ { provide: plugin_api_1.STATE_MACHINE_RUNTIME, useExisting: runtime_service_1.StateMachineRuntime },
55
+ mcp_tools_1.StateMachineMcpTools,
56
+ ],
57
+ exports: [runtime_service_1.StateMachineRuntime, plugin_api_1.STATE_MACHINE_RUNTIME, mcp_tools_1.StateMachineMcpTools],
58
+ })
59
+ ], StateMachineModule);
60
+ //# sourceMappingURL=state-machine.module.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-machine.module.js","sourceRoot":"","sources":["../src/state-machine.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,6CAAiD;AACjD,qDAI8B;AAC9B,2CAA+E;AAC/E,iCAAoD;AACpD,2CAAmD;AACnD,iDAAyD;AACzD,uDAAwD;AACxD,yEAAoE;AACpE,mCAA8C;AAE9C,uFAAuF;AAEhF,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IACvC,YAA0D,QAAgC;QAAhC,aAAQ,GAAR,QAAQ,CAAwB;IAAG,CAAC;IAE9F,YAAY;QACV,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,iCAA0B,CAAC,CAAC;IACzD,CAAC;CACF,CAAA;AANY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,mBAAU,GAAE;IAEE,WAAA,IAAA,eAAM,EAAC,gCAAmB,CAAC,CAAA;;GAD7B,4BAA4B,CAMxC;AAiBM,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IAf9B,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,iDAAsB,CAAC;QACrC,SAAS,EAAE;YACT,4BAA4B;YAC5B;gBACE,OAAO,EAAE,2BAAmB;gBAC5B,UAAU,EAAE,CAAC,MAAqB,EAAE,EAAE,CAAC,IAAI,sCAAuB,CAAC,MAAM,CAAC;gBAC1E,MAAM,EAAE,CAAC,sBAAa,CAAC;aACxB;YACD,qCAAmB;YACnB,EAAE,OAAO,EAAE,kCAAqB,EAAE,WAAW,EAAE,qCAAmB,EAAE;YACpE,gCAAoB;SACrB;QACD,OAAO,EAAE,CAAC,qCAAmB,EAAE,kCAAqB,EAAE,gCAAoB,CAAC;KAC5E,CAAC;GACW,kBAAkB,CAAG"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Persistence of instances. `run(tx, work)` joins the caller's transaction when it is given one
3
+ * (a listener calling back into the runtime) and opens its own otherwise, so a whole cascade —
4
+ * transition, assignment, timer — commits or rolls back together on Prisma.
5
+ */
6
+ import type { ResolvedDefinitionBundle } from '@haneinfo/plugin-api';
7
+ export declare const STATE_MACHINE_STORE: unique symbol;
8
+ export interface InstanceRecord {
9
+ id: string;
10
+ machineCode: string;
11
+ machineVersion: number;
12
+ bundle: ResolvedDefinitionBundle;
13
+ state: string;
14
+ data: Record<string, unknown>;
15
+ submitterId: string | null;
16
+ revision: number;
17
+ finished: boolean;
18
+ startedAt: Date;
19
+ stateEnteredAt: Date;
20
+ }
21
+ export interface HistoryRecord {
22
+ instanceId: string;
23
+ transition: string | null;
24
+ fromState: string | null;
25
+ toState: string;
26
+ triggerType: 'START' | 'USER' | 'ASSIGNMENT' | 'TIMER';
27
+ triggerUserId: string | null;
28
+ /** Assignment or Timer code for mechanism-driven transitions. */
29
+ triggerRef: string | null;
30
+ at: Date;
31
+ }
32
+ export interface InstanceFilter {
33
+ machineCode?: string;
34
+ submitterId?: string;
35
+ state?: string;
36
+ finished?: boolean;
37
+ }
38
+ export interface StateMachineStoreTx {
39
+ create(input: Omit<InstanceRecord, 'id' | 'revision' | 'startedAt'>): Promise<InstanceRecord>;
40
+ find(id: string, lock?: boolean): Promise<InstanceRecord | null>;
41
+ /** Compare-and-set on `revision`; returns null when it is stale. */
42
+ update(id: string, expectedRevision: number, patch: Partial<Pick<InstanceRecord, 'state' | 'data' | 'finished' | 'stateEnteredAt'>>): Promise<InstanceRecord | null>;
43
+ appendHistory(entry: HistoryRecord): Promise<void>;
44
+ history(instanceId: string): Promise<HistoryRecord[]>;
45
+ list(filter: InstanceFilter): Promise<InstanceRecord[]>;
46
+ }
47
+ export interface StateMachineStore {
48
+ run<T>(tx: unknown, work: (store: StateMachineStoreTx, tx: unknown) => Promise<T>): Promise<T>;
49
+ }
50
+ /**
51
+ * For tests and mechanism unit tests. A transaction it opens itself rolls back on error; a joined
52
+ * transaction (another store's token) is not rolled back here — that is the caller's store's job.
53
+ */
54
+ export declare class InMemoryStateMachineStore implements StateMachineStore {
55
+ private state;
56
+ run<T>(tx: unknown, work: (store: StateMachineStoreTx, tx: unknown) => Promise<T>): Promise<T>;
57
+ }
58
+ //# sourceMappingURL=store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,eAAO,MAAM,mBAAmB,eAA6C,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,wBAAwB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IACvD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iEAAiE;IACjE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,EAAE,EAAE,IAAI,CAAC;CACV;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9F,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACjE,oEAAoE;IACpE,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAAC,CAAC,GACrF,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClC,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChG;AA4DD;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,KAAK,CAAiE;IAExE,GAAG,CAAC,CAAC,EACT,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAC5D,OAAO,CAAC,CAAC,CAAC;CAUd"}
package/dist/store.js ADDED
@@ -0,0 +1,73 @@
1
+ "use strict";
2
+ /**
3
+ * Persistence of instances. `run(tx, work)` joins the caller's transaction when it is given one
4
+ * (a listener calling back into the runtime) and opens its own otherwise, so a whole cascade —
5
+ * transition, assignment, timer — commits or rolls back together on Prisma.
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.InMemoryStateMachineStore = exports.STATE_MACHINE_STORE = void 0;
9
+ exports.STATE_MACHINE_STORE = Symbol.for('haneinfo.state-machine.store');
10
+ const copy = (value) => structuredClone(value);
11
+ class MemoryTx {
12
+ constructor(state) {
13
+ this.state = state;
14
+ }
15
+ async create(input) {
16
+ const record = {
17
+ ...copy(input),
18
+ id: `smi_${this.state.nextId++}`,
19
+ revision: 1,
20
+ startedAt: input.stateEnteredAt,
21
+ };
22
+ this.state.instances.set(record.id, record);
23
+ return copy(record);
24
+ }
25
+ async find(id) {
26
+ const found = this.state.instances.get(id);
27
+ return found ? copy(found) : null;
28
+ }
29
+ async update(id, expectedRevision, patch) {
30
+ const found = this.state.instances.get(id);
31
+ if (!found || found.revision !== expectedRevision)
32
+ return null;
33
+ Object.assign(found, copy(patch), { revision: found.revision + 1 });
34
+ return copy(found);
35
+ }
36
+ async appendHistory(entry) {
37
+ this.state.history.push(copy(entry));
38
+ }
39
+ async history(instanceId) {
40
+ return this.state.history.filter((entry) => entry.instanceId === instanceId).map(copy);
41
+ }
42
+ async list(filter) {
43
+ return [...this.state.instances.values()]
44
+ .filter((i) => (filter.machineCode ? i.machineCode === filter.machineCode : true))
45
+ .filter((i) => (filter.submitterId ? i.submitterId === filter.submitterId : true))
46
+ .filter((i) => (filter.state ? i.state === filter.state : true))
47
+ .filter((i) => (filter.finished === undefined ? true : i.finished === filter.finished))
48
+ .map(copy);
49
+ }
50
+ }
51
+ /**
52
+ * For tests and mechanism unit tests. A transaction it opens itself rolls back on error; a joined
53
+ * transaction (another store's token) is not rolled back here — that is the caller's store's job.
54
+ */
55
+ class InMemoryStateMachineStore {
56
+ constructor() {
57
+ this.state = { instances: new Map(), history: [], nextId: 1 };
58
+ }
59
+ async run(tx, work) {
60
+ if (tx !== undefined)
61
+ return work(new MemoryTx(this.state), tx);
62
+ const snapshot = structuredClone(this.state);
63
+ try {
64
+ return await work(new MemoryTx(this.state), { inMemory: true });
65
+ }
66
+ catch (error) {
67
+ this.state = snapshot;
68
+ throw error;
69
+ }
70
+ }
71
+ }
72
+ exports.InMemoryStateMachineStore = InMemoryStateMachineStore;
73
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * `@haneinfo/state-machine/testing` — a real runtime on in-memory stores, for mechanism and App
3
+ * tests. Needs `@haneinfo/definition-registry` (its `/testing` registry) installed.
4
+ */
5
+ import type { DefinitionKindRegistration, RbacPolicyPort } from '@haneinfo/plugin-api';
6
+ import { type Clock, StateMachineRuntime } from './runtime.service';
7
+ import { InMemoryStateMachineStore } from './store';
8
+ export { InMemoryStateMachineStore } from './store';
9
+ export declare function createTestStateMachineRuntime(options?: {
10
+ kinds?: DefinitionKindRegistration[];
11
+ rbac?: RbacPolicyPort;
12
+ clock?: Clock;
13
+ }): {
14
+ runtime: StateMachineRuntime;
15
+ store: InMemoryStateMachineStore;
16
+ registry: import("@haneinfo/definition-registry/dist/definition-registry.service").DefinitionRegistryService;
17
+ audit: unknown[];
18
+ };
19
+ //# sourceMappingURL=testing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,EAAE,KAAK,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAO;;;;;EAQ7F"}
@@ -0,0 +1,23 @@
1
+ "use strict";
2
+ /**
3
+ * `@haneinfo/state-machine/testing` — a real runtime on in-memory stores, for mechanism and App
4
+ * tests. Needs `@haneinfo/definition-registry` (its `/testing` registry) installed.
5
+ */
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.InMemoryStateMachineStore = void 0;
8
+ exports.createTestStateMachineRuntime = createTestStateMachineRuntime;
9
+ const testing_1 = require("@haneinfo/definition-registry/testing");
10
+ const kind_1 = require("./kind");
11
+ const runtime_service_1 = require("./runtime.service");
12
+ const store_1 = require("./store");
13
+ var store_2 = require("./store");
14
+ Object.defineProperty(exports, "InMemoryStateMachineStore", { enumerable: true, get: function () { return store_2.InMemoryStateMachineStore; } });
15
+ function createTestStateMachineRuntime(options = {}) {
16
+ const definitions = (0, testing_1.createTestDefinitionRegistry)({
17
+ kinds: [kind_1.stateMachineDefinitionKind, ...(options.kinds ?? [])],
18
+ });
19
+ const store = new store_1.InMemoryStateMachineStore();
20
+ const runtime = new runtime_service_1.StateMachineRuntime(store, definitions.registry, options.rbac, options.clock);
21
+ return { ...definitions, runtime, store };
22
+ }
23
+ //# sourceMappingURL=testing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAUH,sEASC;AAjBD,mEAAqF;AAErF,iCAAoD;AACpD,uDAAoE;AACpE,mCAAoD;AAEpD,iCAAoD;AAA3C,kHAAA,yBAAyB,OAAA;AAElC,SAAgB,6BAA6B,CAC3C,UAA0F,EAAE;IAE5F,MAAM,WAAW,GAAG,IAAA,sCAA4B,EAAC;QAC/C,KAAK,EAAE,CAAC,iCAA0B,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;KAC9D,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,iCAAyB,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,qCAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAClG,OAAO,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC"}
@@ -0,0 +1,29 @@
1
+ /** Spec of a `StateMachine` definition. `schemas/state-machine.spec.json` is the structural source of truth. */
2
+ export type StateType = 'INITIAL' | 'NORMAL' | 'FINAL';
3
+ export interface StateDefinition {
4
+ key: string;
5
+ label: string;
6
+ description?: string;
7
+ type: StateType;
8
+ /** While the instance is in this state its data cannot be changed. */
9
+ frozen?: boolean;
10
+ }
11
+ export interface TransitionDefinition {
12
+ key: string;
13
+ label: string;
14
+ description?: string;
15
+ from: string[];
16
+ to: string;
17
+ /** RBAC permission a person needs to take it in the App; Assignment and Timer do not check it. */
18
+ permission?: string;
19
+ }
20
+ export interface StateMachineSpec {
21
+ subject?: {
22
+ kind: 'Form';
23
+ code: string;
24
+ };
25
+ states: StateDefinition[];
26
+ transitions: TransitionDefinition[];
27
+ }
28
+ export declare function initialStateOf(spec: StateMachineSpec): StateDefinition | undefined;
29
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAEhH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,CAAC;IAChB,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,kGAAkG;IAClG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAElF"}
package/dist/types.js ADDED
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ /** Spec of a `StateMachine` definition. `schemas/state-machine.spec.json` is the structural source of truth. */
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.initialStateOf = initialStateOf;
5
+ function initialStateOf(spec) {
6
+ return spec.states.find((state) => state.type === 'INITIAL');
7
+ }
8
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gHAAgH;;AA6BhH,wCAEC;AAFD,SAAgB,cAAc,CAAC,IAAsB;IACnD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC/D,CAAC"}
@@ -0,0 +1,43 @@
1
+ {
2
+ "kind": "StateMachine",
3
+ "schemaVersion": 1,
4
+ "metadata": {
5
+ "code": "equipment-loan-flow",
6
+ "name": "Equipment loan",
7
+ "description": "Request, manager approval, loan and return. The approval is an Assignment; the overdue reminder is a Timer."
8
+ },
9
+ "spec": {
10
+ "subject": { "kind": "Form", "code": "equipment-loan-request" },
11
+ "states": [
12
+ { "key": "DRAFT", "label": "Draft", "type": "INITIAL" },
13
+ { "key": "SUBMITTED", "label": "Waiting for approval", "type": "NORMAL", "frozen": true },
14
+ { "key": "APPROVED", "label": "On loan", "type": "NORMAL", "frozen": true },
15
+ { "key": "RETURNED", "label": "Returned", "type": "FINAL", "frozen": true },
16
+ { "key": "REJECTED", "label": "Rejected", "type": "FINAL", "frozen": true }
17
+ ],
18
+ "transitions": [
19
+ { "key": "submit", "label": "Submit", "from": ["DRAFT"], "to": "SUBMITTED" },
20
+ {
21
+ "key": "approve",
22
+ "label": "Approve",
23
+ "from": ["SUBMITTED"],
24
+ "to": "APPROVED",
25
+ "permission": "equipment-loan:loan:approve"
26
+ },
27
+ {
28
+ "key": "reject",
29
+ "label": "Reject",
30
+ "from": ["SUBMITTED"],
31
+ "to": "REJECTED",
32
+ "permission": "equipment-loan:loan:approve"
33
+ },
34
+ {
35
+ "key": "return",
36
+ "label": "Mark as returned",
37
+ "from": ["APPROVED"],
38
+ "to": "RETURNED",
39
+ "permission": "equipment-loan:loan:return"
40
+ }
41
+ ]
42
+ }
43
+ }
@@ -0,0 +1,56 @@
1
+ {
2
+ "schemaVersion": "haneinfo.plugin/v1",
3
+ "id": "state-machine",
4
+ "displayName": "State Machine",
5
+ "cardinality": "singleton",
6
+ "distribution": "official",
7
+ "engine": {
8
+ "haneinfoPluginApi": "^1.6.0",
9
+ "node": ">=22.0.0",
10
+ "frameworks": {
11
+ "@nestjs/common": "^11.0.5",
12
+ "@nestjs/core": "^11.0.5",
13
+ "@prisma/client": "^6.2.0"
14
+ }
15
+ },
16
+ "provides": ["haneinfo.state-machine-runtime"],
17
+ "requires": ["haneinfo.prisma", "haneinfo.principal-context", "haneinfo.definition-registry"],
18
+ "optionalRequires": ["haneinfo.rbac-policy"],
19
+ "facets": {
20
+ "backend": {
21
+ "modulePath": "./dist/state-machine.module.js",
22
+ "exportName": "StateMachineModule",
23
+ "controllerRoutes": ["state-machines", "state-machine-instances"],
24
+ "providerTokens": ["haneinfo.state-machine-runtime"],
25
+ "definitionKinds": [
26
+ {
27
+ "kind": "StateMachine",
28
+ "schemaVersion": 1,
29
+ "specSchema": "schemas/state-machine.spec.json",
30
+ "displayName": "State machine"
31
+ }
32
+ ],
33
+ "mcpTools": [
34
+ {
35
+ "name": "simulate_state_machine",
36
+ "requiredScopes": ["{namespace}:definition:read"]
37
+ }
38
+ ],
39
+ "agentGuide": "./agent-guide.md"
40
+ },
41
+ "prisma": {
42
+ "owns": ["StateMachineInstance", "StateMachineTransition"],
43
+ "schemaFragment": "prisma/state-machine.prisma",
44
+ "schemaDigest": "sha256:bee14c6370c9f8e8dde199a6f28030499106bddcb66903b173faf655a18997bc"
45
+ },
46
+ "permissions": {
47
+ "definitions": [
48
+ "state-machine:definition:read",
49
+ "state-machine:definition:write",
50
+ "state-machine:definition:publish",
51
+ "state-machine:instance:read",
52
+ "state-machine:instance:write"
53
+ ]
54
+ }
55
+ }
56
+ }