@haneinfo/state-machine 0.0.0-stage → 0.1.0
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.
- package/LICENSE +14 -0
- package/agent-guide.md +98 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +35 -0
- package/dist/index.js.map +1 -0
- package/dist/kind.d.ts +12 -0
- package/dist/kind.d.ts.map +1 -0
- package/dist/kind.js +48 -0
- package/dist/kind.js.map +1 -0
- package/dist/mcp-tools.d.ts +43 -0
- package/dist/mcp-tools.d.ts.map +1 -0
- package/dist/mcp-tools.js +120 -0
- package/dist/mcp-tools.js.map +1 -0
- package/dist/plugin.d.ts +11 -0
- package/dist/plugin.d.ts.map +1 -0
- package/dist/plugin.js +72 -0
- package/dist/plugin.js.map +1 -0
- package/dist/prisma-store.d.ts +8 -0
- package/dist/prisma-store.d.ts.map +1 -0
- package/dist/prisma-store.js +74 -0
- package/dist/prisma-store.js.map +1 -0
- package/dist/runtime.service.d.ts +62 -0
- package/dist/runtime.service.d.ts.map +1 -0
- package/dist/runtime.service.js +271 -0
- package/dist/runtime.service.js.map +1 -0
- package/dist/semantics.d.ts +8 -0
- package/dist/semantics.d.ts.map +1 -0
- package/dist/semantics.js +83 -0
- package/dist/semantics.js.map +1 -0
- package/dist/simulate.d.ts +20 -0
- package/dist/simulate.d.ts.map +1 -0
- package/dist/simulate.js +46 -0
- package/dist/simulate.js.map +1 -0
- package/dist/state-machine.controller.d.ts +22 -0
- package/dist/state-machine.controller.d.ts.map +1 -0
- package/dist/state-machine.controller.js +143 -0
- package/dist/state-machine.controller.js.map +1 -0
- package/dist/state-machine.module.d.ts +11 -0
- package/dist/state-machine.module.d.ts.map +1 -0
- package/dist/state-machine.module.js +60 -0
- package/dist/state-machine.module.js.map +1 -0
- package/dist/store.d.ts +58 -0
- package/dist/store.d.ts.map +1 -0
- package/dist/store.js +73 -0
- package/dist/store.js.map +1 -0
- package/dist/testing.d.ts +19 -0
- package/dist/testing.d.ts.map +1 -0
- package/dist/testing.js +23 -0
- package/dist/testing.js.map +1 -0
- package/dist/types.d.ts +29 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +8 -0
- package/dist/types.js.map +1 -0
- package/examples/definitions/equipment-loan/equipment-loan-flow.state-machine.json +43 -0
- package/haneinfo.plugin.json +56 -0
- package/package.json +79 -3
- package/plugin.d.ts +2 -0
- package/plugin.js +4 -0
- package/prisma/state-machine.prisma +40 -0
- package/schemas/state-machine.spec.json +66 -0
- package/testing.d.ts +2 -0
- package/testing.js +2 -0
- package/README.md +0 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
Copyright (c) 2026 Haneinfo. All Rights Reserved.
|
|
2
|
+
|
|
3
|
+
This software and associated documentation files (the "Software") are the proprietary and
|
|
4
|
+
confidential property of Haneinfo. No part of the Software may be copied, modified, merged,
|
|
5
|
+
published, distributed, sublicensed, or sold without the prior written permission of Haneinfo.
|
|
6
|
+
|
|
7
|
+
The Software is provided for internal use by Haneinfo and its authorized personnel only, and is
|
|
8
|
+
NOT licensed for external distribution or open-source use.
|
|
9
|
+
|
|
10
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
|
|
11
|
+
NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
12
|
+
NONINFRINGEMENT. IN NO EVENT SHALL HANEINFO BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|
13
|
+
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
|
|
14
|
+
THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
package/agent-guide.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# @haneinfo/state-machine — Agent Guide
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
The state-machine mechanism (decision `202610-00b3`, first batch; details in its own decision). A
|
|
6
|
+
`StateMachine` definition lists the states and transitions of a business object, and the runtime
|
|
7
|
+
keeps **instances** of published machines: their current state, their data and their history.
|
|
8
|
+
Transitions are taken by a person in the App, by an Assignment response, or by a Timer action.
|
|
9
|
+
|
|
10
|
+
```json
|
|
11
|
+
{
|
|
12
|
+
"kind": "StateMachine",
|
|
13
|
+
"schemaVersion": 1,
|
|
14
|
+
"metadata": { "code": "equipment-loan-flow", "name": "Equipment loan" },
|
|
15
|
+
"spec": {
|
|
16
|
+
"subject": { "kind": "Form", "code": "equipment-loan-request" },
|
|
17
|
+
"states": [{ "key": "DRAFT", "label": "Draft", "type": "INITIAL" }],
|
|
18
|
+
"transitions": [{ "key": "submit", "label": "Submit", "from": ["DRAFT"], "to": "SUBMITTED" }]
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## When to use it, and when not
|
|
24
|
+
|
|
25
|
+
Use it when a record moves through named states and who may move it, or what happens on entering
|
|
26
|
+
a state, matters. Combine it with a Form (`subject`) for the record's data, with Assignment for
|
|
27
|
+
"someone must respond" steps and with Timer for deadlines.
|
|
28
|
+
|
|
29
|
+
Do not encode branching business rules in it: conditions on transitions wait for the rules engine.
|
|
30
|
+
Do not model a single yes/no flag as a machine. Do not publish from an agent.
|
|
31
|
+
|
|
32
|
+
## Kind and example definition
|
|
33
|
+
|
|
34
|
+
- `states[]`: `key`, `label`, `type` (`INITIAL`, `NORMAL`, `FINAL`), optional `frozen` (data cannot
|
|
35
|
+
change in that state) and `description`. Exactly one `INITIAL`. `FINAL` states have no way out.
|
|
36
|
+
- `transitions[]`: `key`, `label`, `from[]`, `to`, optional `permission` (an RBAC permission a
|
|
37
|
+
person needs to take it in the App) and `description`. Assignment and Timer do not check
|
|
38
|
+
`permission`; set it on transitions people should not take by hand, such as `approve`.
|
|
39
|
+
- `subject` (optional): `{ "kind": "Form", "code" }`. Instance data is that Form's values; every
|
|
40
|
+
transition re-validates them, so an incomplete draft cannot be submitted.
|
|
41
|
+
- Permissions: `state-machine:definition:read|write|publish` for definitions;
|
|
42
|
+
`state-machine:instance:read` (see all instances) and `state-machine:instance:write` (edit
|
|
43
|
+
someone else's data) for instances. The submitter can always read and edit their own instance.
|
|
44
|
+
|
|
45
|
+
Example: `examples/definitions/equipment-loan/equipment-loan-flow.state-machine.json`
|
|
46
|
+
(DRAFT → SUBMITTED → APPROVED → RETURNED, or SUBMITTED → REJECTED).
|
|
47
|
+
|
|
48
|
+
An instance pins its machine and everything it references when it starts. Publishing a new version
|
|
49
|
+
changes new instances only.
|
|
50
|
+
|
|
51
|
+
## MCP tools
|
|
52
|
+
|
|
53
|
+
| Tool | Scope | Use |
|
|
54
|
+
| --- | --- | --- |
|
|
55
|
+
| `simulate_state_machine` | `<namespace>:definition:read` (read only) | Walk a path of transitions through a stored machine (`code`: its draft, or the published version) or an unsaved `definition`; returns the states reached, whether it finished, what can be taken next, and where it broke |
|
|
56
|
+
|
|
57
|
+
Register it from the App: `stateMachineMcpTools.registerInto(registry, { scopeNamespace })`. It
|
|
58
|
+
needs `state-machine:definition:read`. Design loop: `get_definition_schema` → `create_definition_draft`
|
|
59
|
+
/ `patch_definition_draft` until `validate_definition` is clean → `simulate_state_machine` with
|
|
60
|
+
`code` and the paths that matter (happy path, rejection) → tell the person to publish.
|
|
61
|
+
|
|
62
|
+
## HTTP API (people)
|
|
63
|
+
|
|
64
|
+
| Route | Purpose |
|
|
65
|
+
| --- | --- |
|
|
66
|
+
| `POST /state-machines/:code/instances` `{ data }` | Start an instance as the signed-in user |
|
|
67
|
+
| `GET /state-machine-instances?machine=&state=&mine=true` | Instances you started, or all with `state-machine:instance:read` |
|
|
68
|
+
| `GET /state-machine-instances/:id` | Instance and history |
|
|
69
|
+
| `PATCH /state-machine-instances/:id/data` `{ data, expectedRevision }` | Replace the data (not in a frozen state) |
|
|
70
|
+
| `POST /state-machine-instances/:id/transitions/:transition` `{ expectedRevision? }` | Take a transition |
|
|
71
|
+
|
|
72
|
+
## For other mechanisms
|
|
73
|
+
|
|
74
|
+
Inject `STATE_MACHINE_RUNTIME` (`StateMachineRuntimePort` from `@haneinfo/plugin-api`) and
|
|
75
|
+
`addListener()` in `onModuleInit`: `onStarted`, `onStateEntered` and `onEvent` run inside the same
|
|
76
|
+
transaction as the change; pass the `tx` you receive to your own store and back into the runtime.
|
|
77
|
+
`emit()` broadcasts a mechanism event (e.g. `assignment.opened`). Tests:
|
|
78
|
+
`createTestStateMachineRuntime()` from `./testing`.
|
|
79
|
+
|
|
80
|
+
## Adapters
|
|
81
|
+
|
|
82
|
+
None. RBAC comes through `haneinfo.rbac-policy` (optional; without it transitions with a
|
|
83
|
+
`permission` and other people's instances are refused).
|
|
84
|
+
|
|
85
|
+
## Common error codes and fixes
|
|
86
|
+
|
|
87
|
+
| Code | Fix |
|
|
88
|
+
| --- | --- |
|
|
89
|
+
| `NO_INITIAL_STATE` / `MULTIPLE_INITIAL_STATES` | Exactly one state has `type: "INITIAL"` |
|
|
90
|
+
| `DUPLICATE_STATE_KEY` / `DUPLICATE_TRANSITION_KEY` | Keys are unique |
|
|
91
|
+
| `UNKNOWN_STATE` | `from`/`to` must name a state |
|
|
92
|
+
| `FINAL_STATE_HAS_TRANSITION` | Nothing leaves a FINAL state |
|
|
93
|
+
| `UNREACHABLE_STATE` / `DEAD_END_STATE` (warnings) | Add the missing transition or remove the state |
|
|
94
|
+
| `TRANSITION_NOT_AVAILABLE` / `UNKNOWN_TRANSITION` | The suggestion lists what can be taken from the current state |
|
|
95
|
+
| `INVALID_DATA` | The subject Form's values are incomplete; diagnostics point at `/values/<field id>` |
|
|
96
|
+
| `STATE_FROZEN` | The data cannot change in this state |
|
|
97
|
+
| `VERSION_CONFLICT` | Read the instance again and retry against its `revision` |
|
|
98
|
+
| `FORBIDDEN` | The person needs the named permission |
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
export { STATE_MACHINE_KIND, STATE_MACHINE_SCHEMA_VERSION, stateMachineDefinitionKind, stateMachineExample, stateMachineSpecSchema, } from './kind';
|
|
2
|
+
export { SIMULATE_TOOL_NAME, StateMachineMcpTools, } from './mcp-tools';
|
|
3
|
+
export { PrismaStateMachineStore } from './prisma-store';
|
|
4
|
+
export { type Clock, INSTANCE_READ_PERMISSION, INSTANCE_WRITE_PERMISSION, STATE_MACHINE_CLOCK, StateMachineRuntime, } from './runtime.service';
|
|
5
|
+
export { validateStateMachineSpec } from './semantics';
|
|
6
|
+
export { type SimulationResult, type SimulationStep, simulateStateMachine } from './simulate';
|
|
7
|
+
export { runHttp, StateMachineController } from './state-machine.controller';
|
|
8
|
+
export { StateMachineKindRegistration, StateMachineModule } from './state-machine.module';
|
|
9
|
+
export { type HistoryRecord, InMemoryStateMachineStore, type InstanceFilter, type InstanceRecord, STATE_MACHINE_STORE, type StateMachineStore, type StateMachineStoreTx, } from './store';
|
|
10
|
+
export { initialStateOf, type StateDefinition, type StateMachineSpec, type StateType, type TransitionDefinition, } from './types';
|
|
11
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,KAAK,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EACL,KAAK,aAAa,EAClB,yBAAyB,EACzB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,oBAAoB,GAC1B,MAAM,SAAS,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.initialStateOf = exports.STATE_MACHINE_STORE = exports.InMemoryStateMachineStore = exports.StateMachineModule = exports.StateMachineKindRegistration = exports.StateMachineController = exports.runHttp = exports.simulateStateMachine = exports.validateStateMachineSpec = exports.StateMachineRuntime = exports.STATE_MACHINE_CLOCK = exports.INSTANCE_WRITE_PERMISSION = exports.INSTANCE_READ_PERMISSION = exports.PrismaStateMachineStore = exports.StateMachineMcpTools = exports.SIMULATE_TOOL_NAME = exports.stateMachineSpecSchema = exports.stateMachineExample = exports.stateMachineDefinitionKind = exports.STATE_MACHINE_SCHEMA_VERSION = exports.STATE_MACHINE_KIND = void 0;
|
|
4
|
+
var kind_1 = require("./kind");
|
|
5
|
+
Object.defineProperty(exports, "STATE_MACHINE_KIND", { enumerable: true, get: function () { return kind_1.STATE_MACHINE_KIND; } });
|
|
6
|
+
Object.defineProperty(exports, "STATE_MACHINE_SCHEMA_VERSION", { enumerable: true, get: function () { return kind_1.STATE_MACHINE_SCHEMA_VERSION; } });
|
|
7
|
+
Object.defineProperty(exports, "stateMachineDefinitionKind", { enumerable: true, get: function () { return kind_1.stateMachineDefinitionKind; } });
|
|
8
|
+
Object.defineProperty(exports, "stateMachineExample", { enumerable: true, get: function () { return kind_1.stateMachineExample; } });
|
|
9
|
+
Object.defineProperty(exports, "stateMachineSpecSchema", { enumerable: true, get: function () { return kind_1.stateMachineSpecSchema; } });
|
|
10
|
+
var mcp_tools_1 = require("./mcp-tools");
|
|
11
|
+
Object.defineProperty(exports, "SIMULATE_TOOL_NAME", { enumerable: true, get: function () { return mcp_tools_1.SIMULATE_TOOL_NAME; } });
|
|
12
|
+
Object.defineProperty(exports, "StateMachineMcpTools", { enumerable: true, get: function () { return mcp_tools_1.StateMachineMcpTools; } });
|
|
13
|
+
var prisma_store_1 = require("./prisma-store");
|
|
14
|
+
Object.defineProperty(exports, "PrismaStateMachineStore", { enumerable: true, get: function () { return prisma_store_1.PrismaStateMachineStore; } });
|
|
15
|
+
var runtime_service_1 = require("./runtime.service");
|
|
16
|
+
Object.defineProperty(exports, "INSTANCE_READ_PERMISSION", { enumerable: true, get: function () { return runtime_service_1.INSTANCE_READ_PERMISSION; } });
|
|
17
|
+
Object.defineProperty(exports, "INSTANCE_WRITE_PERMISSION", { enumerable: true, get: function () { return runtime_service_1.INSTANCE_WRITE_PERMISSION; } });
|
|
18
|
+
Object.defineProperty(exports, "STATE_MACHINE_CLOCK", { enumerable: true, get: function () { return runtime_service_1.STATE_MACHINE_CLOCK; } });
|
|
19
|
+
Object.defineProperty(exports, "StateMachineRuntime", { enumerable: true, get: function () { return runtime_service_1.StateMachineRuntime; } });
|
|
20
|
+
var semantics_1 = require("./semantics");
|
|
21
|
+
Object.defineProperty(exports, "validateStateMachineSpec", { enumerable: true, get: function () { return semantics_1.validateStateMachineSpec; } });
|
|
22
|
+
var simulate_1 = require("./simulate");
|
|
23
|
+
Object.defineProperty(exports, "simulateStateMachine", { enumerable: true, get: function () { return simulate_1.simulateStateMachine; } });
|
|
24
|
+
var state_machine_controller_1 = require("./state-machine.controller");
|
|
25
|
+
Object.defineProperty(exports, "runHttp", { enumerable: true, get: function () { return state_machine_controller_1.runHttp; } });
|
|
26
|
+
Object.defineProperty(exports, "StateMachineController", { enumerable: true, get: function () { return state_machine_controller_1.StateMachineController; } });
|
|
27
|
+
var state_machine_module_1 = require("./state-machine.module");
|
|
28
|
+
Object.defineProperty(exports, "StateMachineKindRegistration", { enumerable: true, get: function () { return state_machine_module_1.StateMachineKindRegistration; } });
|
|
29
|
+
Object.defineProperty(exports, "StateMachineModule", { enumerable: true, get: function () { return state_machine_module_1.StateMachineModule; } });
|
|
30
|
+
var store_1 = require("./store");
|
|
31
|
+
Object.defineProperty(exports, "InMemoryStateMachineStore", { enumerable: true, get: function () { return store_1.InMemoryStateMachineStore; } });
|
|
32
|
+
Object.defineProperty(exports, "STATE_MACHINE_STORE", { enumerable: true, get: function () { return store_1.STATE_MACHINE_STORE; } });
|
|
33
|
+
var types_1 = require("./types");
|
|
34
|
+
Object.defineProperty(exports, "initialStateOf", { enumerable: true, get: function () { return types_1.initialStateOf; } });
|
|
35
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAMgB;AALd,0GAAA,kBAAkB,OAAA;AAClB,oHAAA,4BAA4B,OAAA;AAC5B,kHAAA,0BAA0B,OAAA;AAC1B,2GAAA,mBAAmB,OAAA;AACnB,8GAAA,sBAAsB,OAAA;AAExB,yCAGqB;AAFnB,+GAAA,kBAAkB,OAAA;AAClB,iHAAA,oBAAoB,OAAA;AAEtB,+CAAyD;AAAhD,uHAAA,uBAAuB,OAAA;AAChC,qDAM2B;AAJzB,2HAAA,wBAAwB,OAAA;AACxB,4HAAA,yBAAyB,OAAA;AACzB,sHAAA,mBAAmB,OAAA;AACnB,sHAAA,mBAAmB,OAAA;AAErB,yCAAuD;AAA9C,qHAAA,wBAAwB,OAAA;AACjC,uCAA8F;AAAzC,gHAAA,oBAAoB,OAAA;AACzE,uEAA6E;AAApE,mHAAA,OAAO,OAAA;AAAE,kIAAA,sBAAsB,OAAA;AACxC,+DAA0F;AAAjF,oIAAA,4BAA4B,OAAA;AAAE,0HAAA,kBAAkB,OAAA;AACzD,iCAQiB;AANf,kHAAA,yBAAyB,OAAA;AAGzB,4GAAA,mBAAmB,OAAA;AAIrB,iCAMiB;AALf,uGAAA,cAAc,OAAA"}
|
package/dist/kind.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `StateMachine` definition kind. `specSchema` is read from the same file the manifest declares,
|
|
3
|
+
* so the registration and the build-time check cannot disagree.
|
|
4
|
+
*/
|
|
5
|
+
import type { DefinitionEnvelope, DefinitionKindRegistration } from '@haneinfo/plugin-api';
|
|
6
|
+
import type { StateMachineSpec } from './types';
|
|
7
|
+
export declare const STATE_MACHINE_KIND = "StateMachine";
|
|
8
|
+
export declare const STATE_MACHINE_SCHEMA_VERSION = 1;
|
|
9
|
+
export declare const stateMachineSpecSchema: Record<string, unknown>;
|
|
10
|
+
export declare const stateMachineExample: DefinitionEnvelope<StateMachineSpec>;
|
|
11
|
+
export declare const stateMachineDefinitionKind: DefinitionKindRegistration<StateMachineSpec>;
|
|
12
|
+
//# sourceMappingURL=kind.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kind.d.ts","sourceRoot":"","sources":["../src/kind.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,eAAO,MAAM,sBAAsB,EAE9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7B,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,CAAC,gBAAgB,CAepE,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,0BAA0B,CAAC,gBAAgB,CAenF,CAAC"}
|
package/dist/kind.js
ADDED
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* The `StateMachine` definition kind. `specSchema` is read from the same file the manifest declares,
|
|
4
|
+
* so the registration and the build-time check cannot disagree.
|
|
5
|
+
*/
|
|
6
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
7
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
8
|
+
};
|
|
9
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
exports.stateMachineDefinitionKind = exports.stateMachineExample = exports.stateMachineSpecSchema = exports.STATE_MACHINE_SCHEMA_VERSION = exports.STATE_MACHINE_KIND = void 0;
|
|
11
|
+
const node_fs_1 = require("node:fs");
|
|
12
|
+
const node_path_1 = __importDefault(require("node:path"));
|
|
13
|
+
const semantics_1 = require("./semantics");
|
|
14
|
+
exports.STATE_MACHINE_KIND = 'StateMachine';
|
|
15
|
+
exports.STATE_MACHINE_SCHEMA_VERSION = 1;
|
|
16
|
+
exports.stateMachineSpecSchema = JSON.parse((0, node_fs_1.readFileSync)(node_path_1.default.join(__dirname, '..', 'schemas', 'state-machine.spec.json'), 'utf8'));
|
|
17
|
+
exports.stateMachineExample = {
|
|
18
|
+
kind: exports.STATE_MACHINE_KIND,
|
|
19
|
+
schemaVersion: exports.STATE_MACHINE_SCHEMA_VERSION,
|
|
20
|
+
metadata: { code: 'example-flow', name: 'Example flow' },
|
|
21
|
+
spec: {
|
|
22
|
+
states: [
|
|
23
|
+
{ key: 'DRAFT', label: 'Draft', type: 'INITIAL' },
|
|
24
|
+
{ key: 'SUBMITTED', label: 'Submitted', type: 'NORMAL', frozen: true },
|
|
25
|
+
{ key: 'DONE', label: 'Done', type: 'FINAL', frozen: true },
|
|
26
|
+
],
|
|
27
|
+
transitions: [
|
|
28
|
+
{ key: 'submit', label: 'Submit', from: ['DRAFT'], to: 'SUBMITTED' },
|
|
29
|
+
{ key: 'finish', label: 'Finish', from: ['SUBMITTED'], to: 'DONE' },
|
|
30
|
+
],
|
|
31
|
+
},
|
|
32
|
+
};
|
|
33
|
+
exports.stateMachineDefinitionKind = {
|
|
34
|
+
kind: exports.STATE_MACHINE_KIND,
|
|
35
|
+
schemaVersion: exports.STATE_MACHINE_SCHEMA_VERSION,
|
|
36
|
+
displayName: 'State machine',
|
|
37
|
+
description: 'States and transitions of a business object, optionally carrying a Form as its data. Transitions are taken by a person, an Assignment response or a Timer action.',
|
|
38
|
+
specSchema: exports.stateMachineSpecSchema,
|
|
39
|
+
freeTextPaths: [
|
|
40
|
+
'/spec/states/*/label',
|
|
41
|
+
'/spec/states/*/description',
|
|
42
|
+
'/spec/transitions/*/label',
|
|
43
|
+
'/spec/transitions/*/description',
|
|
44
|
+
],
|
|
45
|
+
validate: (definition) => (0, semantics_1.validateStateMachineSpec)(definition.spec),
|
|
46
|
+
example: exports.stateMachineExample,
|
|
47
|
+
};
|
|
48
|
+
//# sourceMappingURL=kind.js.map
|
package/dist/kind.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kind.js","sourceRoot":"","sources":["../src/kind.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AAEH,qCAAuC;AACvC,0DAA6B;AAE7B,2CAAuD;AAG1C,QAAA,kBAAkB,GAAG,cAAc,CAAC;AACpC,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAEjC,QAAA,sBAAsB,GAAG,IAAI,CAAC,KAAK,CAC9C,IAAA,sBAAY,EAAC,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,yBAAyB,CAAC,EAAE,MAAM,CAAC,CAC5D,CAAC;AAEhB,QAAA,mBAAmB,GAAyC;IACvE,IAAI,EAAE,0BAAkB;IACxB,aAAa,EAAE,oCAA4B;IAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE;IACxD,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE;YACjD,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;YACtE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;SAC5D;QACD,WAAW,EAAE;YACX,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE;YACpE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE;SACpE;KACF;CACF,CAAC;AAEW,QAAA,0BAA0B,GAAiD;IACtF,IAAI,EAAE,0BAAkB;IACxB,aAAa,EAAE,oCAA4B;IAC3C,WAAW,EAAE,eAAe;IAC5B,WAAW,EACT,mKAAmK;IACrK,UAAU,EAAE,8BAAsB;IAClC,aAAa,EAAE;QACb,sBAAsB;QACtB,4BAA4B;QAC5B,2BAA2B;QAC3B,iCAAiC;KAClC;IACD,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,IAAA,oCAAwB,EAAC,UAAU,CAAC,IAAI,CAAC;IACnE,OAAO,EAAE,2BAAmB;CAC7B,CAAC"}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `simulate_state_machine` — the kind-specific design tool (decision 202610-00b3, point 15). It walks
|
|
3
|
+
* a path of transitions through a stored machine (its draft, or the published version) or an unsaved
|
|
4
|
+
* one, and stores nothing, so it is a read tool.
|
|
5
|
+
*/
|
|
6
|
+
import { type DefinitionRegistryPort, type McpToolsPort, type RbacPolicyPort } from '@haneinfo/plugin-api';
|
|
7
|
+
import { z } from 'zod';
|
|
8
|
+
export declare const SIMULATE_TOOL_NAME = "simulate_state_machine";
|
|
9
|
+
declare const inputSchema: z.ZodObject<{
|
|
10
|
+
code: z.ZodOptional<z.ZodString>;
|
|
11
|
+
definition: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
|
|
12
|
+
path: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
13
|
+
}, z.core.$strip>;
|
|
14
|
+
interface CallContext {
|
|
15
|
+
actingUserId: string | null;
|
|
16
|
+
}
|
|
17
|
+
export declare class StateMachineMcpTools {
|
|
18
|
+
private readonly registry?;
|
|
19
|
+
private readonly rbac?;
|
|
20
|
+
constructor(registry?: DefinitionRegistryPort | undefined, rbac?: RbacPolicyPort | undefined);
|
|
21
|
+
registerInto(target: McpToolsPort, options: {
|
|
22
|
+
scopeNamespace: string;
|
|
23
|
+
}): void;
|
|
24
|
+
run(args: z.infer<typeof inputSchema>, ctx: CallContext): Promise<{
|
|
25
|
+
ok: boolean;
|
|
26
|
+
error: {
|
|
27
|
+
code: string;
|
|
28
|
+
message: string;
|
|
29
|
+
suggestion: string;
|
|
30
|
+
};
|
|
31
|
+
} | {
|
|
32
|
+
steps: import("./simulate").SimulationStep[];
|
|
33
|
+
state: string | null;
|
|
34
|
+
finished: boolean;
|
|
35
|
+
available: string[];
|
|
36
|
+
diagnostics: import("@haneinfo/plugin-api").DefinitionDiagnostic[];
|
|
37
|
+
source?: Record<string, unknown> | undefined;
|
|
38
|
+
ok: boolean;
|
|
39
|
+
pathOk: boolean;
|
|
40
|
+
}>;
|
|
41
|
+
}
|
|
42
|
+
export {};
|
|
43
|
+
//# sourceMappingURL=mcp-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,KAAK,sBAAsB,EAI3B,KAAK,YAAY,EAEjB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAE3D,QAAA,MAAM,WAAW;;;;iBAiBf,CAAC;AAkBH,UAAU,WAAW;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,qBACa,oBAAoB;IAEY,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBADG,QAAQ,CAAC,EAAE,sBAAsB,YAAA,EACzC,IAAI,CAAC,EAAE,cAAc,YAAA;IAGzE,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAwBvE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,GAAG,EAAE,WAAW;;;;;;;;;;;;;;;;;CAwD9D"}
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* `simulate_state_machine` — the kind-specific design tool (decision 202610-00b3, point 15). It walks
|
|
4
|
+
* a path of transitions through a stored machine (its draft, or the published version) or an unsaved
|
|
5
|
+
* one, and stores nothing, so it is a read tool.
|
|
6
|
+
*/
|
|
7
|
+
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
|
|
8
|
+
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
|
|
9
|
+
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
|
|
10
|
+
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;
|
|
11
|
+
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
12
|
+
};
|
|
13
|
+
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
14
|
+
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
15
|
+
};
|
|
16
|
+
var __param = (this && this.__param) || function (paramIndex, decorator) {
|
|
17
|
+
return function (target, key) { decorator(target, key, paramIndex); }
|
|
18
|
+
};
|
|
19
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
20
|
+
exports.StateMachineMcpTools = exports.SIMULATE_TOOL_NAME = void 0;
|
|
21
|
+
const plugin_api_1 = require("@haneinfo/plugin-api");
|
|
22
|
+
const loader_1 = require("@haneinfo/plugin-api/loader");
|
|
23
|
+
const common_1 = require("@nestjs/common");
|
|
24
|
+
const zod_1 = require("zod");
|
|
25
|
+
const kind_1 = require("./kind");
|
|
26
|
+
const semantics_1 = require("./semantics");
|
|
27
|
+
const simulate_1 = require("./simulate");
|
|
28
|
+
exports.SIMULATE_TOOL_NAME = 'simulate_state_machine';
|
|
29
|
+
const inputSchema = zod_1.z.object({
|
|
30
|
+
code: zod_1.z
|
|
31
|
+
.string()
|
|
32
|
+
.regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/)
|
|
33
|
+
.optional()
|
|
34
|
+
.describe('metadata.code of a stored StateMachine: its draft, or the published version. Pass this or definition.'),
|
|
35
|
+
definition: zod_1.z
|
|
36
|
+
.record(zod_1.z.string(), zod_1.z.unknown())
|
|
37
|
+
.optional()
|
|
38
|
+
.describe('An unsaved StateMachine envelope. Pass this or code.'),
|
|
39
|
+
path: zod_1.z
|
|
40
|
+
.array(zod_1.z.string())
|
|
41
|
+
.max(100)
|
|
42
|
+
.default([])
|
|
43
|
+
.describe('Transition keys to take in order, starting from the INITIAL state.'),
|
|
44
|
+
});
|
|
45
|
+
const compiled = (0, loader_1.compileDefinitionKind)({
|
|
46
|
+
kind: kind_1.STATE_MACHINE_KIND,
|
|
47
|
+
schemaVersion: kind_1.STATE_MACHINE_SCHEMA_VERSION,
|
|
48
|
+
specSchema: kind_1.stateMachineSpecSchema,
|
|
49
|
+
});
|
|
50
|
+
const failure = (code, message, suggestion, extra = {}) => ({
|
|
51
|
+
ok: false,
|
|
52
|
+
error: { code, message, suggestion, ...extra },
|
|
53
|
+
});
|
|
54
|
+
let StateMachineMcpTools = class StateMachineMcpTools {
|
|
55
|
+
constructor(registry, rbac) {
|
|
56
|
+
this.registry = registry;
|
|
57
|
+
this.rbac = rbac;
|
|
58
|
+
}
|
|
59
|
+
registerInto(target, options) {
|
|
60
|
+
if (!options.scopeNamespace)
|
|
61
|
+
throw new Error('state-machine MCP tools need a scope namespace');
|
|
62
|
+
target.registerTool({
|
|
63
|
+
name: exports.SIMULATE_TOOL_NAME,
|
|
64
|
+
description: 'Walk a path of transitions through a StateMachine (a stored one by code — its draft, or the published version — or an unsaved definition) and see the states reached, whether it finished, what can be taken next, and where the path breaks. Stores nothing.',
|
|
65
|
+
inputSchema,
|
|
66
|
+
requiredScopes: [`${options.scopeNamespace}:definition:read`],
|
|
67
|
+
handler: async (raw, ctx) => {
|
|
68
|
+
const parsed = inputSchema.safeParse(raw);
|
|
69
|
+
if (!parsed.success) {
|
|
70
|
+
return failure('INVALID_INPUT', 'The tool input is invalid', parsed.error.issues
|
|
71
|
+
.map((i) => `${i.path.join('.') || '(input)'}: ${i.message}`)
|
|
72
|
+
.join('; '));
|
|
73
|
+
}
|
|
74
|
+
return this.run(parsed.data, ctx);
|
|
75
|
+
},
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
async run(args, ctx) {
|
|
79
|
+
if (!ctx.actingUserId)
|
|
80
|
+
return failure('FORBIDDEN', 'This credential is not bound to a user', 'Use an employee MCP connection, or an API key bound to a user');
|
|
81
|
+
const permission = (0, plugin_api_1.definitionPermission)(kind_1.STATE_MACHINE_KIND, 'read');
|
|
82
|
+
if (!(0, plugin_api_1.hasPermission)(await (0, plugin_api_1.authorizationOfUser)(this.rbac, ctx.actingUserId), permission)) {
|
|
83
|
+
return failure('FORBIDDEN', `Missing permission ${permission}`, `Ask an administrator for ${permission}`);
|
|
84
|
+
}
|
|
85
|
+
if ((args.code === undefined) === (args.definition === undefined)) {
|
|
86
|
+
return failure('INVALID_INPUT', 'Pass either code or definition', 'Use code for a stored StateMachine, or definition for unsaved content');
|
|
87
|
+
}
|
|
88
|
+
let candidate = args.definition;
|
|
89
|
+
let source;
|
|
90
|
+
if (args.code !== undefined) {
|
|
91
|
+
const current = this.registry
|
|
92
|
+
? await this.registry.getCurrent({ kind: kind_1.STATE_MACHINE_KIND, code: args.code })
|
|
93
|
+
: null;
|
|
94
|
+
if (!current)
|
|
95
|
+
return failure('DEFINITION_NOT_FOUND', `StateMachine/${args.code} does not exist`, 'Check the code with list_definitions');
|
|
96
|
+
candidate = current.definition;
|
|
97
|
+
source = { code: args.code, isDraft: current.isDraft, revision: current.revision };
|
|
98
|
+
}
|
|
99
|
+
const structural = (0, loader_1.validateDefinitionStructure)(candidate, new Map([[kind_1.STATE_MACHINE_KIND, compiled]]));
|
|
100
|
+
const spec = candidate.spec;
|
|
101
|
+
const diagnostics = (0, plugin_api_1.hasDefinitionErrors)(structural)
|
|
102
|
+
? structural
|
|
103
|
+
: (0, semantics_1.validateStateMachineSpec)(spec);
|
|
104
|
+
if ((0, plugin_api_1.hasDefinitionErrors)(diagnostics)) {
|
|
105
|
+
return failure('INVALID_DEFINITION', 'The definition is not valid; fix the diagnostics first', 'Use each diagnostic path as the JSON Patch path', { diagnostics });
|
|
106
|
+
}
|
|
107
|
+
const { ok: pathOk, ...simulation } = (0, simulate_1.simulateStateMachine)(spec, args.path);
|
|
108
|
+
return { ok: true, pathOk, ...(source ? { source } : {}), ...simulation };
|
|
109
|
+
}
|
|
110
|
+
};
|
|
111
|
+
exports.StateMachineMcpTools = StateMachineMcpTools;
|
|
112
|
+
exports.StateMachineMcpTools = StateMachineMcpTools = __decorate([
|
|
113
|
+
(0, common_1.Injectable)(),
|
|
114
|
+
__param(0, (0, common_1.Optional)()),
|
|
115
|
+
__param(0, (0, common_1.Inject)(plugin_api_1.DEFINITION_REGISTRY)),
|
|
116
|
+
__param(1, (0, common_1.Optional)()),
|
|
117
|
+
__param(1, (0, common_1.Inject)(plugin_api_1.RBAC_POLICY)),
|
|
118
|
+
__metadata("design:paramtypes", [Object, Object])
|
|
119
|
+
], StateMachineMcpTools);
|
|
120
|
+
//# sourceMappingURL=mcp-tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;AAEH,qDAW8B;AAC9B,wDAAiG;AACjG,2CAA8D;AAC9D,6BAAwB;AACxB,iCAAkG;AAClG,2CAAuD;AACvD,yCAAkD;AAGrC,QAAA,kBAAkB,GAAG,wBAAwB,CAAC;AAE3D,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,iCAAiC,CAAC;SACxC,QAAQ,EAAE;SACV,QAAQ,CACP,uGAAuG,CACxG;IACH,UAAU,EAAE,OAAC;SACV,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,sDAAsD,CAAC;IACnE,IAAI,EAAE,OAAC;SACJ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oEAAoE,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,IAAA,8BAAqB,EAAC;IACrC,IAAI,EAAE,yBAAkB;IACxB,aAAa,EAAE,mCAA4B;IAC3C,UAAU,EAAE,6BAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,CACd,IAAY,EACZ,OAAe,EACf,UAAkB,EAClB,QAAiC,EAAE,EACnC,EAAE,CAAC,CAAC;IACJ,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE;CAC/C,CAAC,CAAC;AAOI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAC4D,QAAiC,EACzC,IAAqB;QADb,aAAQ,GAAR,QAAQ,CAAyB;QACzC,SAAI,GAAJ,IAAI,CAAiB;IACtE,CAAC;IAEJ,YAAY,CAAC,MAAoB,EAAE,OAAmC;QACpE,IAAI,CAAC,OAAO,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC/F,MAAM,CAAC,YAAY,CAAC;YAClB,IAAI,EAAE,0BAAkB;YACxB,WAAW,EACT,+PAA+P;YACjQ,WAAW;YACX,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,cAAc,kBAAkB,CAAC;YAC7D,OAAO,EAAE,KAAK,EAAE,GAAY,EAAE,GAAY,EAAE,EAAE;gBAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO,OAAO,CACZ,eAAe,EACf,2BAA2B,EAC3B,MAAM,CAAC,KAAK,CAAC,MAAM;yBAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;yBAC5D,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAkB,CAAC,CAAC;YACnD,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAiC,EAAE,GAAgB;QAC3D,IAAI,CAAC,GAAG,CAAC,YAAY;YACnB,OAAO,OAAO,CACZ,WAAW,EACX,wCAAwC,EACxC,+DAA+D,CAChE,CAAC;QACJ,MAAM,UAAU,GAAG,IAAA,iCAAoB,EAAC,yBAAkB,EAAE,MAAM,CAAC,CAAC;QACpE,IAAI,CAAC,IAAA,0BAAa,EAAC,MAAM,IAAA,gCAAmB,EAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;YACvF,OAAO,OAAO,CACZ,WAAW,EACX,sBAAsB,UAAU,EAAE,EAClC,4BAA4B,UAAU,EAAE,CACzC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,EAAE,CAAC;YAClE,OAAO,OAAO,CACZ,eAAe,EACf,gCAAgC,EAChC,uEAAuE,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,GAAY,IAAI,CAAC,UAAU,CAAC;QACzC,IAAI,MAA2C,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ;gBAC3B,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,yBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/E,CAAC,CAAC,IAAI,CAAC;YACT,IAAI,CAAC,OAAO;gBACV,OAAO,OAAO,CACZ,sBAAsB,EACtB,gBAAgB,IAAI,CAAC,IAAI,iBAAiB,EAC1C,sCAAsC,CACvC,CAAC;YACJ,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;YAC/B,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrF,CAAC;QACD,MAAM,UAAU,GAAG,IAAA,oCAA2B,EAC5C,SAAS,EACT,IAAI,GAAG,CAAC,CAAC,CAAC,yBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,CAC1C,CAAC;QACF,MAAM,IAAI,GAAI,SAAkD,CAAC,IAAI,CAAC;QACtE,MAAM,WAAW,GAAG,IAAA,gCAAmB,EAAC,UAAU,CAAC;YACjD,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,IAAA,oCAAwB,EAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAA,gCAAmB,EAAC,WAAW,CAAC,EAAE,CAAC;YACrC,OAAO,OAAO,CACZ,oBAAoB,EACpB,wDAAwD,EACxD,iDAAiD,EACjD,EAAE,WAAW,EAAE,CAChB,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG,IAAA,+BAAoB,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IAC5E,CAAC;CACF,CAAA;AAtFY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,gCAAmB,CAAC,CAAA;IACvC,WAAA,IAAA,iBAAQ,GAAE,CAAA;IAAE,WAAA,IAAA,eAAM,EAAC,wBAAW,CAAC,CAAA;;GAHvB,oBAAoB,CAsFhC"}
|
package/dist/plugin.d.ts
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** `@haneinfo/state-machine/plugin` — manifest and plugin descriptor. */
|
|
2
|
+
import { type PluginManifestV1 } from '@haneinfo/plugin-api';
|
|
3
|
+
import { StateMachineModule } from './state-machine.module';
|
|
4
|
+
/** SHA-256 of `prisma/state-machine.prisma` with LF endings; `plugin.spec.ts` recomputes it. */
|
|
5
|
+
export declare const STATE_MACHINE_SCHEMA_DIGEST = "sha256:bee14c6370c9f8e8dde199a6f28030499106bddcb66903b173faf655a18997bc";
|
|
6
|
+
/** Mirrors `haneinfo.plugin.json`; `plugin.spec.ts` fails if the two drift apart. */
|
|
7
|
+
export declare const stateMachineManifest: PluginManifestV1;
|
|
8
|
+
export declare const stateMachinePlugin: import("@haneinfo/plugin-api").DefinedPlugin<unknown, typeof StateMachineModule>;
|
|
9
|
+
export declare function stateMachine(): import("@haneinfo/plugin-api").DefinedPlugin<unknown, typeof StateMachineModule>;
|
|
10
|
+
export { StateMachineModule } from './state-machine.module';
|
|
11
|
+
//# sourceMappingURL=plugin.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,gGAAgG;AAChG,eAAO,MAAM,2BAA2B,4EACmC,CAAC;AAE5E,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,EAAE,gBAkDlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,kFAG7B,CAAC;AAEH,wBAAgB,YAAY,qFAE3B;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}
|
package/dist/plugin.js
ADDED
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/** `@haneinfo/state-machine/plugin` — manifest and plugin descriptor. */
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.StateMachineModule = exports.stateMachinePlugin = exports.stateMachineManifest = exports.STATE_MACHINE_SCHEMA_DIGEST = void 0;
|
|
5
|
+
exports.stateMachine = stateMachine;
|
|
6
|
+
const plugin_api_1 = require("@haneinfo/plugin-api");
|
|
7
|
+
const mcp_tools_1 = require("./mcp-tools");
|
|
8
|
+
const state_machine_module_1 = require("./state-machine.module");
|
|
9
|
+
/** SHA-256 of `prisma/state-machine.prisma` with LF endings; `plugin.spec.ts` recomputes it. */
|
|
10
|
+
exports.STATE_MACHINE_SCHEMA_DIGEST = 'sha256:bee14c6370c9f8e8dde199a6f28030499106bddcb66903b173faf655a18997bc';
|
|
11
|
+
/** Mirrors `haneinfo.plugin.json`; `plugin.spec.ts` fails if the two drift apart. */
|
|
12
|
+
exports.stateMachineManifest = {
|
|
13
|
+
schemaVersion: 'haneinfo.plugin/v1',
|
|
14
|
+
id: 'state-machine',
|
|
15
|
+
displayName: 'State Machine',
|
|
16
|
+
cardinality: 'singleton',
|
|
17
|
+
distribution: 'official',
|
|
18
|
+
engine: {
|
|
19
|
+
haneinfoPluginApi: '^1.6.0',
|
|
20
|
+
node: '>=22.0.0',
|
|
21
|
+
frameworks: {
|
|
22
|
+
'@nestjs/common': '^11.0.5',
|
|
23
|
+
'@nestjs/core': '^11.0.5',
|
|
24
|
+
'@prisma/client': '^6.2.0',
|
|
25
|
+
},
|
|
26
|
+
},
|
|
27
|
+
provides: ['haneinfo.state-machine-runtime'],
|
|
28
|
+
requires: ['haneinfo.prisma', 'haneinfo.principal-context', 'haneinfo.definition-registry'],
|
|
29
|
+
optionalRequires: ['haneinfo.rbac-policy'],
|
|
30
|
+
facets: {
|
|
31
|
+
backend: {
|
|
32
|
+
modulePath: './dist/state-machine.module.js',
|
|
33
|
+
exportName: 'StateMachineModule',
|
|
34
|
+
controllerRoutes: ['state-machines', 'state-machine-instances'],
|
|
35
|
+
providerTokens: ['haneinfo.state-machine-runtime'],
|
|
36
|
+
definitionKinds: [
|
|
37
|
+
{
|
|
38
|
+
kind: 'StateMachine',
|
|
39
|
+
schemaVersion: 1,
|
|
40
|
+
specSchema: 'schemas/state-machine.spec.json',
|
|
41
|
+
displayName: 'State machine',
|
|
42
|
+
},
|
|
43
|
+
],
|
|
44
|
+
mcpTools: [{ name: mcp_tools_1.SIMULATE_TOOL_NAME, requiredScopes: ['{namespace}:definition:read'] }],
|
|
45
|
+
agentGuide: './agent-guide.md',
|
|
46
|
+
},
|
|
47
|
+
prisma: {
|
|
48
|
+
owns: ['StateMachineInstance', 'StateMachineTransition'],
|
|
49
|
+
schemaFragment: 'prisma/state-machine.prisma',
|
|
50
|
+
schemaDigest: exports.STATE_MACHINE_SCHEMA_DIGEST,
|
|
51
|
+
},
|
|
52
|
+
permissions: {
|
|
53
|
+
definitions: [
|
|
54
|
+
'state-machine:definition:read',
|
|
55
|
+
'state-machine:definition:write',
|
|
56
|
+
'state-machine:definition:publish',
|
|
57
|
+
'state-machine:instance:read',
|
|
58
|
+
'state-machine:instance:write',
|
|
59
|
+
],
|
|
60
|
+
},
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
exports.stateMachinePlugin = (0, plugin_api_1.definePlugin)({
|
|
64
|
+
manifest: exports.stateMachineManifest,
|
|
65
|
+
backend: () => state_machine_module_1.StateMachineModule,
|
|
66
|
+
});
|
|
67
|
+
function stateMachine() {
|
|
68
|
+
return exports.stateMachinePlugin;
|
|
69
|
+
}
|
|
70
|
+
var state_machine_module_2 = require("./state-machine.module");
|
|
71
|
+
Object.defineProperty(exports, "StateMachineModule", { enumerable: true, get: function () { return state_machine_module_2.StateMachineModule; } });
|
|
72
|
+
//# sourceMappingURL=plugin.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":";AAAA,yEAAyE;;;AAoEzE,oCAEC;AApED,qDAA2E;AAC3E,2CAAiD;AACjD,iEAA4D;AAE5D,gGAAgG;AACnF,QAAA,2BAA2B,GACtC,yEAAyE,CAAC;AAE5E,qFAAqF;AACxE,QAAA,oBAAoB,GAAqB;IACpD,aAAa,EAAE,oBAAoB;IACnC,EAAE,EAAE,eAAe;IACnB,WAAW,EAAE,eAAe;IAC5B,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,UAAU;IACxB,MAAM,EAAE;QACN,iBAAiB,EAAE,QAAQ;QAC3B,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE;YACV,gBAAgB,EAAE,SAAS;YAC3B,cAAc,EAAE,SAAS;YACzB,gBAAgB,EAAE,QAAQ;SAC3B;KACF;IACD,QAAQ,EAAE,CAAC,gCAAgC,CAAC;IAC5C,QAAQ,EAAE,CAAC,iBAAiB,EAAE,4BAA4B,EAAE,8BAA8B,CAAC;IAC3F,gBAAgB,EAAE,CAAC,sBAAsB,CAAC;IAC1C,MAAM,EAAE;QACN,OAAO,EAAE;YACP,UAAU,EAAE,gCAAgC;YAC5C,UAAU,EAAE,oBAAoB;YAChC,gBAAgB,EAAE,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;YAC/D,cAAc,EAAE,CAAC,gCAAgC,CAAC;YAClD,eAAe,EAAE;gBACf;oBACE,IAAI,EAAE,cAAc;oBACpB,aAAa,EAAE,CAAC;oBAChB,UAAU,EAAE,iCAAiC;oBAC7C,WAAW,EAAE,eAAe;iBAC7B;aACF;YACD,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,8BAAkB,EAAE,cAAc,EAAE,CAAC,6BAA6B,CAAC,EAAE,CAAC;YACzF,UAAU,EAAE,kBAAkB;SAC/B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,sBAAsB,EAAE,wBAAwB,CAAC;YACxD,cAAc,EAAE,6BAA6B;YAC7C,YAAY,EAAE,mCAA2B;SAC1C;QACD,WAAW,EAAE;YACX,WAAW,EAAE;gBACX,+BAA+B;gBAC/B,gCAAgC;gBAChC,kCAAkC;gBAClC,6BAA6B;gBAC7B,8BAA8B;aAC/B;SACF;KACF;CACF,CAAC;AAEW,QAAA,kBAAkB,GAAG,IAAA,yBAAY,EAAC;IAC7C,QAAQ,EAAE,4BAAoB;IAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,yCAAkB;CAClC,CAAC,CAAC;AAEH,SAAgB,YAAY;IAC1B,OAAO,0BAAkB,CAAC;AAC5B,CAAC;AAED,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/** Prisma-backed instance store. Delegates are typed structurally; the App's client owns the real types. */
|
|
2
|
+
import type { StateMachineStore, StateMachineStoreTx } from './store';
|
|
3
|
+
export declare class PrismaStateMachineStore implements StateMachineStore {
|
|
4
|
+
private readonly prisma;
|
|
5
|
+
constructor(prisma: unknown);
|
|
6
|
+
run<T>(tx: unknown, work: (store: StateMachineStoreTx, tx: unknown) => Promise<T>): Promise<T>;
|
|
7
|
+
}
|
|
8
|
+
//# sourceMappingURL=prisma-store.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prisma-store.d.ts","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAG5G,OAAO,KAAK,EAIV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AA8FjB,qBAAa,uBAAwB,YAAW,iBAAiB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,OAAO;IAE5C,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;CAM/F"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/** Prisma-backed instance store. Delegates are typed structurally; the App's client owns the real types. */
|
|
3
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
+
exports.PrismaStateMachineStore = void 0;
|
|
5
|
+
const toRecord = (row) => ({
|
|
6
|
+
...row,
|
|
7
|
+
bundle: row.bundle,
|
|
8
|
+
data: (row.data ?? {}),
|
|
9
|
+
});
|
|
10
|
+
class PrismaTx {
|
|
11
|
+
constructor(db) {
|
|
12
|
+
this.db = db;
|
|
13
|
+
}
|
|
14
|
+
async create(input) {
|
|
15
|
+
const row = await this.db.stateMachineInstance.create({
|
|
16
|
+
data: {
|
|
17
|
+
machineCode: input.machineCode,
|
|
18
|
+
machineVersion: input.machineVersion,
|
|
19
|
+
bundle: input.bundle,
|
|
20
|
+
state: input.state,
|
|
21
|
+
data: input.data,
|
|
22
|
+
submitterId: input.submitterId,
|
|
23
|
+
finished: input.finished,
|
|
24
|
+
stateEnteredAt: input.stateEnteredAt,
|
|
25
|
+
startedAt: input.stateEnteredAt,
|
|
26
|
+
},
|
|
27
|
+
});
|
|
28
|
+
return toRecord(row);
|
|
29
|
+
}
|
|
30
|
+
async find(id) {
|
|
31
|
+
const row = await this.db.stateMachineInstance.findUnique({ where: { id } });
|
|
32
|
+
return row ? toRecord(row) : null;
|
|
33
|
+
}
|
|
34
|
+
async update(id, expectedRevision, patch) {
|
|
35
|
+
const { count } = await this.db.stateMachineInstance.updateMany({
|
|
36
|
+
where: { id, revision: expectedRevision },
|
|
37
|
+
data: {
|
|
38
|
+
...patch,
|
|
39
|
+
...(patch.data ? { data: patch.data } : {}),
|
|
40
|
+
revision: { increment: 1 },
|
|
41
|
+
},
|
|
42
|
+
});
|
|
43
|
+
return count === 0 ? null : this.find(id);
|
|
44
|
+
}
|
|
45
|
+
async appendHistory(entry) {
|
|
46
|
+
await this.db.stateMachineTransition.create({ data: { ...entry } });
|
|
47
|
+
}
|
|
48
|
+
async history(instanceId) {
|
|
49
|
+
return this.db.stateMachineTransition.findMany({
|
|
50
|
+
where: { instanceId },
|
|
51
|
+
orderBy: [{ at: 'asc' }],
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
async list(filter) {
|
|
55
|
+
const rows = await this.db.stateMachineInstance.findMany({
|
|
56
|
+
where: { ...filter },
|
|
57
|
+
orderBy: [{ startedAt: 'desc' }],
|
|
58
|
+
take: 200,
|
|
59
|
+
});
|
|
60
|
+
return rows.map(toRecord);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
class PrismaStateMachineStore {
|
|
64
|
+
constructor(prisma) {
|
|
65
|
+
this.prisma = prisma;
|
|
66
|
+
}
|
|
67
|
+
run(tx, work) {
|
|
68
|
+
if (tx !== undefined)
|
|
69
|
+
return work(new PrismaTx(tx), tx);
|
|
70
|
+
return this.prisma.$transaction((client) => work(new PrismaTx(client), client));
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
exports.PrismaStateMachineStore = PrismaStateMachineStore;
|
|
74
|
+
//# sourceMappingURL=prisma-store.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"prisma-store.js","sourceRoot":"","sources":["../src/prisma-store.ts"],"names":[],"mappings":"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"}
|