@parmanasystems/execution-runtime 1.70.0 → 1.71.5
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/README.md +105 -26
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,26 +1,105 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
1
|
+
# @parmanasystems/execution-runtime
|
|
2
|
+
|
|
3
|
+
High-level orchestration layer for Parmana Systems governed execution.
|
|
4
|
+
|
|
5
|
+
[](https://www.npmjs.com/package/@parmanasystems/execution-runtime)
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Overview
|
|
10
|
+
|
|
11
|
+
`@parmanasystems/execution-runtime` is the orchestration layer that sits above `@parmanasystems/execution`. It wires together policy evaluation, replay protection, signing, and verification into a single `executeFromSignals` call — the primary entry point for most Parmana Systems integrations.
|
|
12
|
+
|
|
13
|
+
Most applications should use `@parmanasystems/core`, which re-exports everything from this package. Use this package directly only if you need the runtime orchestration layer without the full SDK surface.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Install
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install @parmanasystems/execution-runtime
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Usage
|
|
26
|
+
|
|
27
|
+
```typescript
|
|
28
|
+
import {
|
|
29
|
+
executeFromSignals,
|
|
30
|
+
MemoryReplayStore,
|
|
31
|
+
} from "@parmanasystems/execution-runtime";
|
|
32
|
+
import { LocalSigner, LocalVerifier } from "@parmanasystems/execution";
|
|
33
|
+
import crypto from "crypto";
|
|
34
|
+
|
|
35
|
+
const { privateKey, publicKey } = crypto.generateKeyPairSync("ed25519", {
|
|
36
|
+
privateKeyEncoding: { type: "pkcs8", format: "pem" },
|
|
37
|
+
publicKeyEncoding: { type: "spki", format: "pem" },
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
const signer = new LocalSigner(privateKey);
|
|
41
|
+
const verifier = new LocalVerifier(publicKey);
|
|
42
|
+
const replayStore = new MemoryReplayStore();
|
|
43
|
+
|
|
44
|
+
const attestation = await executeFromSignals(
|
|
45
|
+
{
|
|
46
|
+
policyId: "loan-approval",
|
|
47
|
+
policyVersion: "1.0.0",
|
|
48
|
+
signals: {
|
|
49
|
+
credit_score: 712,
|
|
50
|
+
requested_usd: 50000,
|
|
51
|
+
},
|
|
52
|
+
},
|
|
53
|
+
signer,
|
|
54
|
+
verifier,
|
|
55
|
+
replayStore
|
|
56
|
+
);
|
|
57
|
+
|
|
58
|
+
console.log(attestation.execution_state); // "completed"
|
|
59
|
+
console.log(attestation.decision.action); // "approve"
|
|
60
|
+
console.log(attestation.signature); // Ed25519 over canonical attestation JSON
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
### Redis replay store (production)
|
|
64
|
+
|
|
65
|
+
```typescript
|
|
66
|
+
import { executeFromSignals, RedisReplayStore } from "@parmanasystems/execution-runtime";
|
|
67
|
+
import Redis from "ioredis";
|
|
68
|
+
|
|
69
|
+
const replayStore = new RedisReplayStore(new Redis(process.env.REDIS_URL));
|
|
70
|
+
|
|
71
|
+
const attestation = await executeFromSignals(context, signer, verifier, replayStore);
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
## Exports
|
|
77
|
+
|
|
78
|
+
| Export | Description |
|
|
79
|
+
|---|---|
|
|
80
|
+
| `executeFromSignals` | Primary execution entry point — evaluates a policy, signs the result, returns `ExecutionAttestation` |
|
|
81
|
+
| `MemoryReplayStore` | In-process replay store for development and testing |
|
|
82
|
+
| `RedisReplayStore` | Distributed replay store for production use |
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Relationship to other packages
|
|
87
|
+
|
|
88
|
+
| Package | Role |
|
|
89
|
+
|---|---|
|
|
90
|
+
| `@parmanasystems/execution` | Deterministic evaluation engine and attestation primitives |
|
|
91
|
+
| `@parmanasystems/execution-runtime` | Orchestration: wires evaluation, signing, verification, replay |
|
|
92
|
+
| `@parmanasystems/core` | Unified public SDK — re-exports both of the above |
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Documentation
|
|
97
|
+
|
|
98
|
+
Full docs: [parmanasystems.mintlify.app](https://parmanasystems.mintlify.app)
|
|
99
|
+
Package page: [parmanasystems.mintlify.app/packages/execution](https://parmanasystems.mintlify.app/packages/execution)
|
|
100
|
+
|
|
101
|
+
---
|
|
102
|
+
|
|
103
|
+
## License
|
|
104
|
+
|
|
105
|
+
Apache-2.0
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@parmanasystems/execution-runtime",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.71.5",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "Runtime orchestration layer for Parmana Systems.",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"build": "tsup"
|
|
21
21
|
},
|
|
22
22
|
"dependencies": {
|
|
23
|
-
"@parmanasystems/execution": "^1.
|
|
23
|
+
"@parmanasystems/execution": "^1.71.5",
|
|
24
24
|
"ioredis": "^5.4.1"
|
|
25
25
|
},
|
|
26
26
|
"devDependencies": {
|