@decionis/agentsafe 0.5.0 → 0.7.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/README.md +62 -19
- package/dist/Cli.js +18 -1
- package/dist/Cli.js.map +1 -1
- package/dist/Index.d.ts +9 -4
- package/dist/Index.d.ts.map +1 -1
- package/dist/Index.js +7 -2
- package/dist/Index.js.map +1 -1
- package/dist/TrustedExecutor.d.ts.map +1 -1
- package/dist/TrustedExecutor.js +2 -0
- package/dist/TrustedExecutor.js.map +1 -1
- package/dist/adapters/AdapterActionHandler.d.ts +36 -12
- package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
- package/dist/adapters/AdapterActionHandler.js +99 -100
- package/dist/adapters/AdapterActionHandler.js.map +1 -1
- package/dist/adapters/EffectAdapter.d.ts +7 -103
- package/dist/adapters/EffectAdapter.d.ts.map +1 -1
- package/dist/adapters/EffectAdapter.js +7 -18
- package/dist/adapters/EffectAdapter.js.map +1 -1
- package/dist/adapters/EffectAdapterExecutor.d.ts +93 -0
- package/dist/adapters/EffectAdapterExecutor.d.ts.map +1 -0
- package/dist/adapters/EffectAdapterExecutor.js +191 -0
- package/dist/adapters/EffectAdapterExecutor.js.map +1 -0
- package/dist/adapters/banking/BankingExecutor.d.ts +35 -0
- package/dist/adapters/banking/BankingExecutor.d.ts.map +1 -0
- package/dist/adapters/banking/BankingExecutor.js +64 -0
- package/dist/adapters/banking/BankingExecutor.js.map +1 -0
- package/dist/adapters/banking/BankingHandlers.d.ts.map +1 -1
- package/dist/adapters/banking/BankingHandlers.js +6 -3
- package/dist/adapters/banking/BankingHandlers.js.map +1 -1
- package/dist/adapters/cards/CardAuthorizationExecutor.d.ts +66 -0
- package/dist/adapters/cards/CardAuthorizationExecutor.d.ts.map +1 -0
- package/dist/adapters/cards/CardAuthorizationExecutor.js +116 -0
- package/dist/adapters/cards/CardAuthorizationExecutor.js.map +1 -0
- package/dist/adapters/mcp/McpGuard.d.ts +32 -3
- package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
- package/dist/adapters/mcp/McpGuard.js +29 -5
- package/dist/adapters/mcp/McpGuard.js.map +1 -1
- package/dist/adapters/mcp/McpIntentBinder.d.ts +18 -3
- package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -1
- package/dist/adapters/mcp/McpIntentBinder.js +48 -1
- package/dist/adapters/mcp/McpIntentBinder.js.map +1 -1
- package/dist/adapters/mcp/McpInvocation.d.ts +9 -2
- package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -1
- package/dist/adapters/mcp/McpInvocation.js.map +1 -1
- package/dist/cli/Actions.d.ts +14 -0
- package/dist/cli/Actions.d.ts.map +1 -0
- package/dist/cli/Actions.js +168 -0
- package/dist/cli/Actions.js.map +1 -0
- package/dist/cli/Arguments.d.ts +4 -0
- package/dist/cli/Arguments.d.ts.map +1 -1
- package/dist/cli/Arguments.js +12 -3
- package/dist/cli/Arguments.js.map +1 -1
- package/dist/cli/ConfigCommand.d.ts.map +1 -1
- package/dist/cli/ConfigCommand.js +5 -0
- package/dist/cli/ConfigCommand.js.map +1 -1
- package/dist/cli/Doctor.d.ts.map +1 -1
- package/dist/cli/Doctor.js +2 -1
- package/dist/cli/Doctor.js.map +1 -1
- package/dist/cli/Help.d.ts.map +1 -1
- package/dist/cli/Help.js +13 -1
- package/dist/cli/Help.js.map +1 -1
- package/dist/cli/Host.d.ts +5 -2
- package/dist/cli/Host.d.ts.map +1 -1
- package/dist/cli/Host.js +24 -2
- package/dist/cli/Host.js.map +1 -1
- package/dist/cli/Profile.d.ts +24 -0
- package/dist/cli/Profile.d.ts.map +1 -0
- package/dist/cli/Profile.js +168 -0
- package/dist/cli/Profile.js.map +1 -0
- package/dist/cli/Records.d.ts +15 -0
- package/dist/cli/Records.d.ts.map +1 -0
- package/dist/cli/Records.js +205 -0
- package/dist/cli/Records.js.map +1 -0
- package/dist/config/ConfigKeys.d.ts +2 -2
- package/dist/config/ConfigKeys.d.ts.map +1 -1
- package/dist/config/ConfigKeys.js +6 -0
- package/dist/config/ConfigKeys.js.map +1 -1
- package/dist/config/ExecutorConfig.d.ts +29 -0
- package/dist/config/ExecutorConfig.d.ts.map +1 -1
- package/dist/config/ExecutorConfig.js +53 -1
- package/dist/config/ExecutorConfig.js.map +1 -1
- package/dist/gateway/ForwardHandler.d.ts +22 -4
- package/dist/gateway/ForwardHandler.d.ts.map +1 -1
- package/dist/gateway/ForwardHandler.js +27 -10
- package/dist/gateway/ForwardHandler.js.map +1 -1
- package/dist/gateway/Gateway.d.ts +123 -3
- package/dist/gateway/Gateway.d.ts.map +1 -1
- package/dist/gateway/Gateway.js +513 -16
- package/dist/gateway/Gateway.js.map +1 -1
- package/dist/gateway/GatewayConfig.d.ts +109 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -1
- package/dist/gateway/GatewayConfig.js +267 -9
- package/dist/gateway/GatewayConfig.js.map +1 -1
- package/dist/gateway/GatewayReport.d.ts +6 -2
- package/dist/gateway/GatewayReport.d.ts.map +1 -1
- package/dist/gateway/GatewayReport.js +3 -0
- package/dist/gateway/GatewayReport.js.map +1 -1
- package/dist/gateway/InterceptedRequest.d.ts +45 -1
- package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
- package/dist/gateway/InterceptedRequest.js +43 -1
- package/dist/gateway/InterceptedRequest.js.map +1 -1
- package/dist/gateway/PolicySelector.d.ts +5 -0
- package/dist/gateway/PolicySelector.d.ts.map +1 -0
- package/dist/gateway/PolicySelector.js +9 -0
- package/dist/gateway/PolicySelector.js.map +1 -0
- package/dist/gateway/RouteTable.d.ts +44 -7
- package/dist/gateway/RouteTable.d.ts.map +1 -1
- package/dist/gateway/RouteTable.js +58 -9
- package/dist/gateway/RouteTable.js.map +1 -1
- package/dist/gateway/SubjectSessions.d.ts +113 -0
- package/dist/gateway/SubjectSessions.d.ts.map +1 -0
- package/dist/gateway/SubjectSessions.js +219 -0
- package/dist/gateway/SubjectSessions.js.map +1 -0
- package/dist/gateway/Upstream.d.ts +11 -0
- package/dist/gateway/Upstream.d.ts.map +1 -1
- package/dist/gateway/Upstream.js +19 -2
- package/dist/gateway/Upstream.js.map +1 -1
- package/dist/hosted/TenantHost.d.ts +24 -5
- package/dist/hosted/TenantHost.d.ts.map +1 -1
- package/dist/hosted/TenantHost.js +39 -10
- package/dist/hosted/TenantHost.js.map +1 -1
- package/dist/hosted/TenantRegistry.d.ts +20 -0
- package/dist/hosted/TenantRegistry.d.ts.map +1 -1
- package/dist/hosted/TenantRegistry.js +47 -1
- package/dist/hosted/TenantRegistry.js.map +1 -1
- package/dist/http/GatewayHttpServer.d.ts.map +1 -1
- package/dist/http/GatewayHttpServer.js +46 -2
- package/dist/http/GatewayHttpServer.js.map +1 -1
- package/dist/identity/WorkloadJwtVerifier.d.ts +13 -0
- package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -1
- package/dist/identity/WorkloadJwtVerifier.js +40 -8
- package/dist/identity/WorkloadJwtVerifier.js.map +1 -1
- package/dist/incident/HaltSwitch.d.ts +10 -2
- package/dist/incident/HaltSwitch.d.ts.map +1 -1
- package/dist/incident/HaltSwitch.js +22 -2
- package/dist/incident/HaltSwitch.js.map +1 -1
- package/dist/incident/SecurityEvents.d.ts +18 -0
- package/dist/incident/SecurityEvents.d.ts.map +1 -1
- package/dist/incident/SecurityEvents.js +17 -0
- package/dist/incident/SecurityEvents.js.map +1 -1
- package/dist/journal/ExecutionJournal.d.ts +5 -120
- package/dist/journal/ExecutionJournal.d.ts.map +1 -1
- package/dist/journal/ExecutionJournal.js +5 -125
- package/dist/journal/ExecutionJournal.js.map +1 -1
- package/dist/journal/FileExecutionJournal.d.ts +1 -0
- package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
- package/dist/journal/FileExecutionJournal.js +4 -1
- package/dist/journal/FileExecutionJournal.js.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.js +4 -1
- package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
- package/dist/limits/HardLimits.d.ts.map +1 -1
- package/dist/limits/HardLimits.js.map +1 -1
- package/dist/outcomes/CardOutcomeEvidence.d.ts +56 -0
- package/dist/outcomes/CardOutcomeEvidence.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeEvidence.js +211 -0
- package/dist/outcomes/CardOutcomeEvidence.js.map +1 -0
- package/dist/outcomes/CardOutcomeFact.d.ts +90 -0
- package/dist/outcomes/CardOutcomeFact.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeFact.js +76 -0
- package/dist/outcomes/CardOutcomeFact.js.map +1 -0
- package/dist/outcomes/CardOutcomeLedger.d.ts +26 -0
- package/dist/outcomes/CardOutcomeLedger.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeLedger.js +31 -0
- package/dist/outcomes/CardOutcomeLedger.js.map +1 -0
- package/dist/outcomes/CardOutcomeRecorder.d.ts +35 -0
- package/dist/outcomes/CardOutcomeRecorder.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomeRecorder.js +84 -0
- package/dist/outcomes/CardOutcomeRecorder.js.map +1 -0
- package/dist/outcomes/CardOutcomes.d.ts +68 -0
- package/dist/outcomes/CardOutcomes.d.ts.map +1 -0
- package/dist/outcomes/CardOutcomes.js +191 -0
- package/dist/outcomes/CardOutcomes.js.map +1 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts +54 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts.map +1 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.js +116 -0
- package/dist/outcomes/CoreOutcomeEvidenceClient.js.map +1 -0
- package/dist/outcomes/FileCardOutcomeLedger.d.ts +36 -0
- package/dist/outcomes/FileCardOutcomeLedger.d.ts.map +1 -0
- package/dist/outcomes/FileCardOutcomeLedger.js +152 -0
- package/dist/outcomes/FileCardOutcomeLedger.js.map +1 -0
- package/dist/outcomes/OutcomeEvidence.d.ts +238 -0
- package/dist/outcomes/OutcomeEvidence.d.ts.map +1 -0
- package/dist/outcomes/OutcomeEvidence.js +130 -0
- package/dist/outcomes/OutcomeEvidence.js.map +1 -0
- package/dist/outcomes/OutcomeEvidencePublisher.d.ts +81 -0
- package/dist/outcomes/OutcomeEvidencePublisher.d.ts.map +1 -0
- package/dist/outcomes/OutcomeEvidencePublisher.js +189 -0
- package/dist/outcomes/OutcomeEvidencePublisher.js.map +1 -0
- package/dist/outcomes/OutcomeEvidenceStore.d.ts +57 -0
- package/dist/outcomes/OutcomeEvidenceStore.d.ts.map +1 -0
- package/dist/outcomes/OutcomeEvidenceStore.js +191 -0
- package/dist/outcomes/OutcomeEvidenceStore.js.map +1 -0
- package/dist/service/Requests.d.ts +6 -0
- package/dist/service/Requests.d.ts.map +1 -1
- package/dist/service/Requests.js +9 -1
- package/dist/service/Requests.js.map +1 -1
- package/dist/service/TrustedExecutorService.d.ts +21 -1
- package/dist/service/TrustedExecutorService.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.js +73 -23
- package/dist/service/TrustedExecutorService.js.map +1 -1
- package/dist/time/MonotonicClock.d.ts +4 -32
- package/dist/time/MonotonicClock.d.ts.map +1 -1
- package/dist/time/MonotonicClock.js +4 -49
- package/dist/time/MonotonicClock.js.map +1 -1
- package/dist/verify/VerifyingProvider.d.ts +32 -6
- package/dist/verify/VerifyingProvider.d.ts.map +1 -1
- package/dist/verify/VerifyingProvider.js +16 -2
- package/dist/verify/VerifyingProvider.js.map +1 -1
- package/package.json +6 -5
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
import { IndeterminateOutcome } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import { authorityEffectEvidence, buildEffectRecord } from "./EffectEvidenceBuilder.js";
|
|
3
|
+
/**
|
|
4
|
+
* Any `EffectAdapter` as a dispatch-style `NativeExecutor`
|
|
5
|
+
* (`agent-safe.executors.native/1`): the adapter keeps its four methods and
|
|
6
|
+
* this class says them in the contract's terms. `prepare` is the adapter's,
|
|
7
|
+
* plus how the action reads as an intent; `execute` is the adapter's write,
|
|
8
|
+
* inside the dispatch the caller opened and within its deadline; `observe`
|
|
9
|
+
* is the adapter's projection turned into the effect record, field by field
|
|
10
|
+
* against what was authorised; `reconcile` is the adapter's read-only
|
|
11
|
+
* lookup, complete only on a matching read-back.
|
|
12
|
+
*
|
|
13
|
+
* The record is evidence, so it rides on the observation for whoever
|
|
14
|
+
* finalizes the grant — the runtime registers it for its verifier — and its
|
|
15
|
+
* wire form rides as `evidence` for a runner that finalizes directly.
|
|
16
|
+
*/
|
|
17
|
+
export class EffectAdapterExecutor {
|
|
18
|
+
options;
|
|
19
|
+
platform;
|
|
20
|
+
version;
|
|
21
|
+
style = "dispatch";
|
|
22
|
+
clock;
|
|
23
|
+
/** The adapter's own preparation of each prepared action, so a write never prepares twice. */
|
|
24
|
+
effects = new WeakMap();
|
|
25
|
+
constructor(options) {
|
|
26
|
+
this.options = options;
|
|
27
|
+
this.platform = options.platform;
|
|
28
|
+
this.version = options.adapter.version;
|
|
29
|
+
this.clock = options.clock ?? (() => new Date());
|
|
30
|
+
}
|
|
31
|
+
get actionTypes() {
|
|
32
|
+
return this.options.adapter.actionTypes;
|
|
33
|
+
}
|
|
34
|
+
/** The adapter's observer identity, as the effect record and the authority name it. */
|
|
35
|
+
get observer() {
|
|
36
|
+
return { id: this.options.adapter.id, version: this.options.adapter.version };
|
|
37
|
+
}
|
|
38
|
+
async capabilities(scope) {
|
|
39
|
+
if (this.options.capabilities !== undefined)
|
|
40
|
+
return await this.options.capabilities(scope);
|
|
41
|
+
return this.actionTypes.map((actionType) => ({
|
|
42
|
+
platform: this.platform,
|
|
43
|
+
actionType,
|
|
44
|
+
enabled: true,
|
|
45
|
+
scopeGranted: true,
|
|
46
|
+
connected: true,
|
|
47
|
+
requirement: "",
|
|
48
|
+
}));
|
|
49
|
+
}
|
|
50
|
+
async prepare(action) {
|
|
51
|
+
return await Promise.resolve(this.prepareNow(action));
|
|
52
|
+
}
|
|
53
|
+
/** `prepare`, synchronously: the adapter reaches nothing, so neither does this. */
|
|
54
|
+
prepareNow(action) {
|
|
55
|
+
const effect = this.options.adapter.prepare(action);
|
|
56
|
+
const description = this.options.describe(action, effect);
|
|
57
|
+
const prepared = Object.freeze({
|
|
58
|
+
actionType: description.proposal.action,
|
|
59
|
+
proposal: description.proposal,
|
|
60
|
+
downstreamTarget: description.downstreamTarget,
|
|
61
|
+
idempotencyKey: description.idempotencyKey,
|
|
62
|
+
expectedEffectDigest: effect.expectedEffectDigest,
|
|
63
|
+
requestDigest: effect.requestDigest,
|
|
64
|
+
facts: description.facts,
|
|
65
|
+
});
|
|
66
|
+
this.effects.set(prepared, effect);
|
|
67
|
+
return prepared;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* The adapter's write, once, inside the caller's dispatch. A provider that
|
|
71
|
+
* neither committed nor refused is carried as indeterminate, with any
|
|
72
|
+
* receipt it gave; any other error after the dispatch began propagates, so
|
|
73
|
+
* the caller reports an outcome nobody knows.
|
|
74
|
+
*/
|
|
75
|
+
async execute(run) {
|
|
76
|
+
const prepared = this.effectOf(run.prepared, run.action);
|
|
77
|
+
let result = null;
|
|
78
|
+
let indeterminate = null;
|
|
79
|
+
let indeterminateReceipt = null;
|
|
80
|
+
try {
|
|
81
|
+
result = await run.dispatch.run(async () => await this.options.adapter.execute({
|
|
82
|
+
action: run.action,
|
|
83
|
+
prepared,
|
|
84
|
+
authorization: run.authorization,
|
|
85
|
+
idempotencyKey: run.dispatch.idempotencyKey,
|
|
86
|
+
deadline: run.deadline,
|
|
87
|
+
}));
|
|
88
|
+
}
|
|
89
|
+
catch (error) {
|
|
90
|
+
if (!(error instanceof IndeterminateOutcome))
|
|
91
|
+
throw error;
|
|
92
|
+
indeterminate = { reason: error.reason, providerStatus: error.providerStatus };
|
|
93
|
+
indeterminateReceipt = error.receipt;
|
|
94
|
+
}
|
|
95
|
+
const signedReceipt = result?.receipt ?? indeterminateReceipt;
|
|
96
|
+
return {
|
|
97
|
+
kind: "DISPATCHED",
|
|
98
|
+
receipt: {
|
|
99
|
+
prepared,
|
|
100
|
+
result,
|
|
101
|
+
indeterminate,
|
|
102
|
+
correlationId: run.intent.intent.intentId,
|
|
103
|
+
idempotencyKey: run.dispatch.idempotencyKey,
|
|
104
|
+
},
|
|
105
|
+
signedReceipt: typeof signedReceipt === "string" ? signedReceipt : null,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* The provider's answer as the effect record: the adapter's projection,
|
|
110
|
+
* compared with what was authorised. An outcome nobody can determine stays
|
|
111
|
+
* undetermined; a provider that was reached and said no is a refusal, not
|
|
112
|
+
* a success whose effect block says otherwise.
|
|
113
|
+
*/
|
|
114
|
+
async observe(effect) {
|
|
115
|
+
if (effect.kind !== "DISPATCHED" || effect.receipt === null) {
|
|
116
|
+
return await Promise.resolve({ status: "INDETERMINATE", reason: null, result: null });
|
|
117
|
+
}
|
|
118
|
+
const dispatch = effect.receipt;
|
|
119
|
+
const observed = dispatch.result === null
|
|
120
|
+
? null
|
|
121
|
+
: this.options.adapter.observeEffect(dispatch.result, dispatch.prepared);
|
|
122
|
+
const record = buildEffectRecord({
|
|
123
|
+
prepared: dispatch.prepared,
|
|
124
|
+
result: dispatch.result === null ? null : { ...dispatch.result, observed },
|
|
125
|
+
...(dispatch.indeterminate === null ? {} : { indeterminate: dispatch.indeterminate }),
|
|
126
|
+
observer: this.observer,
|
|
127
|
+
correlationId: dispatch.correlationId,
|
|
128
|
+
idempotencyKey: dispatch.idempotencyKey,
|
|
129
|
+
observedAt: this.clock().toISOString(),
|
|
130
|
+
});
|
|
131
|
+
const observation = {
|
|
132
|
+
record,
|
|
133
|
+
indeterminate: dispatch.indeterminate,
|
|
134
|
+
correlationId: dispatch.correlationId,
|
|
135
|
+
};
|
|
136
|
+
const evidence = this.evidenceOf(record, dispatch.correlationId);
|
|
137
|
+
if (dispatch.indeterminate !== null) {
|
|
138
|
+
return { status: "INDETERMINATE", reason: null, result: observation, evidence };
|
|
139
|
+
}
|
|
140
|
+
if (record.outcome === "FAILED") {
|
|
141
|
+
return {
|
|
142
|
+
status: "FAILED",
|
|
143
|
+
reason: record.reasonCodes[0] ?? "PROVIDER_REFUSED",
|
|
144
|
+
result: observation,
|
|
145
|
+
evidence,
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
return { status: "COMMITTED", reason: null, result: observation, evidence };
|
|
149
|
+
}
|
|
150
|
+
/**
|
|
151
|
+
* The adapter's read-only lookup. Absence of an error is not success: only
|
|
152
|
+
* a read-back whose projection matches what was authorised completes a
|
|
153
|
+
* reconciliation.
|
|
154
|
+
*/
|
|
155
|
+
async reconcile(context) {
|
|
156
|
+
const prepared = this.effectOf(context.prepared, context.prepared.proposal.parameters);
|
|
157
|
+
const answer = await this.options.adapter.reconcile({
|
|
158
|
+
idempotencyKey: context.idempotencyKey,
|
|
159
|
+
providerReference: context.providerReference,
|
|
160
|
+
intentHash: context.intent.intentHash,
|
|
161
|
+
prepared,
|
|
162
|
+
});
|
|
163
|
+
if (answer.status !== "COMPLETED")
|
|
164
|
+
return { status: answer.status };
|
|
165
|
+
const observed = this.options.adapter.observeEffect(answer.result, prepared);
|
|
166
|
+
const correlationId = context.intent.intent.intentId;
|
|
167
|
+
const record = buildEffectRecord({
|
|
168
|
+
prepared,
|
|
169
|
+
result: { ...answer.result, observed },
|
|
170
|
+
observer: this.observer,
|
|
171
|
+
correlationId,
|
|
172
|
+
idempotencyKey: context.idempotencyKey,
|
|
173
|
+
observedAt: this.clock().toISOString(),
|
|
174
|
+
});
|
|
175
|
+
if (record.comparison !== "MATCH")
|
|
176
|
+
return { status: "UNKNOWN" };
|
|
177
|
+
return {
|
|
178
|
+
status: "COMPLETED",
|
|
179
|
+
result: { record, indeterminate: null, correlationId },
|
|
180
|
+
evidence: this.evidenceOf(record, correlationId),
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
/** The adapter's preparation of a prepared action: remembered from `prepare`, or made again. */
|
|
184
|
+
effectOf(prepared, action) {
|
|
185
|
+
return this.effects.get(prepared) ?? this.options.adapter.prepare(action);
|
|
186
|
+
}
|
|
187
|
+
evidenceOf(record, correlationId) {
|
|
188
|
+
return authorityEffectEvidence(record, correlationId, this.observer);
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
//# sourceMappingURL=EffectAdapterExecutor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EffectAdapterExecutor.js","sourceRoot":"","sources":["../../src/adapters/EffectAdapterExecutor.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { EffectPreparedAction, ExecutionCapability, ExecutorScope } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import { EffectAdapterExecutor, type ActionDescription } from "../EffectAdapterExecutor.js";
|
|
3
|
+
import { type BankingAction } from "./BankingAction.js";
|
|
4
|
+
import type { BankingAdapter } from "./BankingAdapter.js";
|
|
5
|
+
export declare const CORE_BANKING_PLATFORM = "core-banking";
|
|
6
|
+
export interface BankingExecutorOptions {
|
|
7
|
+
readonly adapter: BankingAdapter;
|
|
8
|
+
/** What the connection can execute; absent, every registered action is stated as live. */
|
|
9
|
+
readonly capabilities?: (scope: ExecutorScope) => Promise<readonly ExecutionCapability[]>;
|
|
10
|
+
readonly clock?: () => Date;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* The banking family on `agent-safe.executors.native/1`, dispatch style: the
|
|
14
|
+
* BEAP adapter performs the write against the core, once, inside the
|
|
15
|
+
* dispatch the runner opens. Everything the family does — the profile's
|
|
16
|
+
* arithmetic, the projection, the comparison, the effect record — is the
|
|
17
|
+
* adapter's, unchanged; this class says how a BEAP action reads as an
|
|
18
|
+
* intent:
|
|
19
|
+
*
|
|
20
|
+
* - the action is the transport name the profile assigns
|
|
21
|
+
* (`beap.<domain>.<type>`) and the resource its target;
|
|
22
|
+
* - the system of record is the downstream provider and operation the
|
|
23
|
+
* action names;
|
|
24
|
+
* - the retry identity is the action's own `request_id`, which the core
|
|
25
|
+
* holds as its idempotency key (by digest when it is longer than an
|
|
26
|
+
* intent carries);
|
|
27
|
+
* - the facts the authority decides with are the domain, the action type and
|
|
28
|
+
* the registered effect, never an amount or an account.
|
|
29
|
+
*/
|
|
30
|
+
export declare class BankingExecutor extends EffectAdapterExecutor<BankingAction> {
|
|
31
|
+
constructor(options: BankingExecutorOptions);
|
|
32
|
+
}
|
|
33
|
+
/** How a BEAP action reads as an `agent-safe.intent/1` binding. */
|
|
34
|
+
export declare function describeBankingAction(action: BankingAction, prepared: EffectPreparedAction): ActionDescription;
|
|
35
|
+
//# sourceMappingURL=BankingExecutor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BankingExecutor.d.ts","sourceRoot":"","sources":["../../../src/adapters/banking/BankingExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EAEd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAKpD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,0FAA0F;IAC1F,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAAC;IAC1F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,SAAQ,qBAAqB,CAAC,aAAa,CAAC;gBACpD,OAAO,EAAE,sBAAsB;CASnD;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,oBAAoB,GAC7B,iBAAiB,CA2BnB"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { EffectAdapterExecutor } from "../EffectAdapterExecutor.js";
|
|
3
|
+
import { transportActionName, transportTarget } from "./BankingAction.js";
|
|
4
|
+
export const CORE_BANKING_PLATFORM = "core-banking";
|
|
5
|
+
/** The longest idempotency key an intent carries; a longer request id is carried by its digest. */
|
|
6
|
+
const MAX_IDEMPOTENCY_KEY = 180;
|
|
7
|
+
/**
|
|
8
|
+
* The banking family on `agent-safe.executors.native/1`, dispatch style: the
|
|
9
|
+
* BEAP adapter performs the write against the core, once, inside the
|
|
10
|
+
* dispatch the runner opens. Everything the family does — the profile's
|
|
11
|
+
* arithmetic, the projection, the comparison, the effect record — is the
|
|
12
|
+
* adapter's, unchanged; this class says how a BEAP action reads as an
|
|
13
|
+
* intent:
|
|
14
|
+
*
|
|
15
|
+
* - the action is the transport name the profile assigns
|
|
16
|
+
* (`beap.<domain>.<type>`) and the resource its target;
|
|
17
|
+
* - the system of record is the downstream provider and operation the
|
|
18
|
+
* action names;
|
|
19
|
+
* - the retry identity is the action's own `request_id`, which the core
|
|
20
|
+
* holds as its idempotency key (by digest when it is longer than an
|
|
21
|
+
* intent carries);
|
|
22
|
+
* - the facts the authority decides with are the domain, the action type and
|
|
23
|
+
* the registered effect, never an amount or an account.
|
|
24
|
+
*/
|
|
25
|
+
export class BankingExecutor extends EffectAdapterExecutor {
|
|
26
|
+
constructor(options) {
|
|
27
|
+
super({
|
|
28
|
+
adapter: options.adapter,
|
|
29
|
+
platform: CORE_BANKING_PLATFORM,
|
|
30
|
+
describe: describeBankingAction,
|
|
31
|
+
...(options.capabilities === undefined ? {} : { capabilities: options.capabilities }),
|
|
32
|
+
...(options.clock === undefined ? {} : { clock: options.clock }),
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
/** How a BEAP action reads as an `agent-safe.intent/1` binding. */
|
|
37
|
+
export function describeBankingAction(action, prepared) {
|
|
38
|
+
const requestId = action.action.request_id;
|
|
39
|
+
return {
|
|
40
|
+
proposal: {
|
|
41
|
+
action: transportActionName(action),
|
|
42
|
+
target: transportTarget(action),
|
|
43
|
+
parameters: action,
|
|
44
|
+
},
|
|
45
|
+
downstreamTarget: {
|
|
46
|
+
system: action.downstream.provider,
|
|
47
|
+
operation: action.downstream.operation,
|
|
48
|
+
...(action.downstream.environment === undefined
|
|
49
|
+
? {}
|
|
50
|
+
: { environment: action.downstream.environment }),
|
|
51
|
+
},
|
|
52
|
+
idempotencyKey: requestId.length <= MAX_IDEMPOTENCY_KEY
|
|
53
|
+
? requestId
|
|
54
|
+
: `sha256:${createHash("sha256").update(requestId, "utf8").digest("hex")}`,
|
|
55
|
+
facts: {
|
|
56
|
+
beap: {
|
|
57
|
+
domain: action.domain,
|
|
58
|
+
action_type: action.action.type,
|
|
59
|
+
effect_type: prepared.effectType,
|
|
60
|
+
},
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=BankingExecutor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BankingExecutor.js","sourceRoot":"","sources":["../../../src/adapters/banking/BankingExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,EAAE,qBAAqB,EAA0B,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAsB,MAAM,oBAAoB,CAAC;AAG9F,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAC;AAEpD,mGAAmG;AACnG,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAShC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,eAAgB,SAAQ,qBAAoC;IACvE,YAAmB,OAA+B;QAChD,KAAK,CAAC;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,qBAAqB;YAC/B,QAAQ,EAAE,qBAAqB;YAC/B,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;YACrF,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACjE,CAAC,CAAC;IACL,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CACnC,MAAqB,EACrB,QAA8B;IAE9B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;IAC3C,OAAO;QACL,QAAQ,EAAE;YACR,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACnC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;YAC/B,UAAU,EAAE,MAA+B;SAC5C;QACD,gBAAgB,EAAE;YAChB,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ;YAClC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS;YACtC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,KAAK,SAAS;gBAC7C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;SACpD;QACD,cAAc,EACZ,SAAS,CAAC,MAAM,IAAI,mBAAmB;YACrC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC9E,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;gBAC/B,WAAW,EAAE,QAAQ,CAAC,UAAU;aACjC;SACF;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"BankingHandlers.d.ts","sourceRoot":"","sources":["../../../src/adapters/banking/BankingHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;
|
|
1
|
+
{"version":3,"file":"BankingHandlers.d.ts","sourceRoot":"","sources":["../../../src/adapters/banking/BankingHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAQjF,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;CAC/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,qBAA0B,GAAG,mBAAmB,CA8BxF"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { executorActionHandler } from "../AdapterActionHandler.js";
|
|
2
2
|
import { BankingActionWireSchema } from "./BankingAction.js";
|
|
3
3
|
import { BankingAdapter } from "./BankingAdapter.js";
|
|
4
|
+
import { BankingExecutor } from "./BankingExecutor.js";
|
|
4
5
|
import { CoreBankingHttpAdapter } from "./CoreBankingHttpAdapter.js";
|
|
5
6
|
import { REGISTERED_ACTIONS } from "./EffectProjections.js";
|
|
6
7
|
/**
|
|
@@ -31,8 +32,10 @@ export function bankingHandlers(options = {}) {
|
|
|
31
32
|
source: "CORE_BANKING_RESPONSE",
|
|
32
33
|
}),
|
|
33
34
|
});
|
|
34
|
-
|
|
35
|
-
|
|
35
|
+
// The family runs as its native executor: the registry reaches it through
|
|
36
|
+
// the runner, and the adapter's arithmetic, projection and evidence are
|
|
37
|
+
// exactly what they were.
|
|
38
|
+
const handler = executorActionHandler(new BankingExecutor({ adapter }), {
|
|
36
39
|
schema: BankingActionWireSchema,
|
|
37
40
|
register,
|
|
38
41
|
timeoutMs: context.downstream.timeoutMs,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"BankingHandlers.js","sourceRoot":"","sources":["../../../src/adapters/banking/BankingHandlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"BankingHandlers.js","sourceRoot":"","sources":["../../../src/adapters/banking/BankingHandlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAsB,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAW5D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,UAAiC,EAAE;IACjE,OAAO,CAAC,OAAO,EAAE,EAAE;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;YACjC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS;YAC3C,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc;YAC1D,SAAS,EAAE,IAAI,sBAAsB,CAAC;gBACpC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;gBAC3B,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,oBAAoB;gBAC1F,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS;gBAC5C,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,uBAAuB;aAChC,CAAC;SACH,CAAC,CAAC;QACH,0EAA0E;QAC1E,wEAAwE;QACxE,0BAA0B;QAC1B,MAAM,OAAO,GAAG,qBAAqB,CAAgB,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;YACrF,MAAM,EAAE,uBAAuB;YAC/B,QAAQ;YACR,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS;YACvC,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;SAChF,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAClC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAC5E,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { ClaimedExecution, EffectObservation, EffectPreparedAction, ExecutionCapability, ExecutionEffect, NativeExecutor, PreparedAction, ReconcileResult } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import type { RegisteredEffect } from "../EffectEvidenceRegister.js";
|
|
3
|
+
import { type CardAuthorizationRequest, type CardAuthorizationResult, type CardPurchase } from "./CardPurchase.js";
|
|
4
|
+
export declare const CARD_ISSUER_PLATFORM = "card-issuer";
|
|
5
|
+
/**
|
|
6
|
+
* What the issuer reported about an authorization it was told to approve,
|
|
7
|
+
* with the attempt it belongs to: the purchase and the projection its grant
|
|
8
|
+
* was bound to, the issuer's request and result, and whether the claim's
|
|
9
|
+
* lease had closed by the time the result arrived.
|
|
10
|
+
*/
|
|
11
|
+
export interface CardAuthorizationReceipt {
|
|
12
|
+
readonly purchase: CardPurchase;
|
|
13
|
+
readonly prepared: EffectPreparedAction;
|
|
14
|
+
readonly request: CardAuthorizationRequest;
|
|
15
|
+
readonly result: CardAuthorizationResult;
|
|
16
|
+
readonly leaseExpired: boolean;
|
|
17
|
+
readonly correlationId: string;
|
|
18
|
+
readonly idempotencyKey: string;
|
|
19
|
+
}
|
|
20
|
+
export interface CardAuthorizationExecutorOptions {
|
|
21
|
+
/** The observer the effect record and the authority name. */
|
|
22
|
+
readonly observer: {
|
|
23
|
+
readonly id: string;
|
|
24
|
+
readonly version: string;
|
|
25
|
+
};
|
|
26
|
+
readonly clock?: () => Date;
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* The cards family on `agent-safe.executors.native/1`, permit style: the
|
|
30
|
+
* issuer performs the effect, when its real-time authorization hook asks, so
|
|
31
|
+
* this executor never writes anything. The grant is held when the purchase
|
|
32
|
+
* is decided; the issuer's authorization request presents it, which claims
|
|
33
|
+
* it once; the permit is the approval the issuer is answered with; and the
|
|
34
|
+
* issuer's result is the receipt that settles it.
|
|
35
|
+
*
|
|
36
|
+
* - `observe` reads the result into the family's effect record: an approval
|
|
37
|
+
* within the ceiling is the authorised effect, a decline is a refusal, and
|
|
38
|
+
* a result after the claim's lease is indeterminate whatever it says.
|
|
39
|
+
* - `reconcile` has no one to ask: the issuer is the system of record and
|
|
40
|
+
* this boundary has no read path into it, so an authorization whose result
|
|
41
|
+
* never arrived stays unknown until someone who can see the issuer's ledger
|
|
42
|
+
* says.
|
|
43
|
+
*/
|
|
44
|
+
export declare class CardAuthorizationExecutor implements NativeExecutor<CardPurchase, CardAuthorizationReceipt, RegisteredEffect> {
|
|
45
|
+
readonly platform = "card-issuer";
|
|
46
|
+
readonly style: "permit";
|
|
47
|
+
readonly actionTypes: readonly string[];
|
|
48
|
+
readonly version: string;
|
|
49
|
+
private readonly observer;
|
|
50
|
+
private readonly clock;
|
|
51
|
+
constructor(options: CardAuthorizationExecutorOptions);
|
|
52
|
+
capabilities(): Promise<readonly ExecutionCapability[]>;
|
|
53
|
+
/**
|
|
54
|
+
* The purchase as an intent: this card, at this merchant, for at most this
|
|
55
|
+
* amount, bound to the projection the issuer's result is later compared
|
|
56
|
+
* with. The retry identity is the purchase's own digest, so the same
|
|
57
|
+
* purchase proposed twice is one purchase.
|
|
58
|
+
*/
|
|
59
|
+
prepare(purchase: CardPurchase): Promise<PreparedAction>;
|
|
60
|
+
/** The permit the issuer is answered with: this grant, for this intent, until it expires. */
|
|
61
|
+
execute(run: ClaimedExecution<CardPurchase>): Promise<ExecutionEffect<CardAuthorizationReceipt>>;
|
|
62
|
+
/** The issuer's result as the family's effect record; anything but a receipt is unknown. */
|
|
63
|
+
observe(effect: ExecutionEffect<CardAuthorizationReceipt>): Promise<EffectObservation<RegisteredEffect>>;
|
|
64
|
+
reconcile(): Promise<ReconcileResult<RegisteredEffect>>;
|
|
65
|
+
}
|
|
66
|
+
//# sourceMappingURL=CardAuthorizationExecutor.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CardAuthorizationExecutor.d.ts","sourceRoot":"","sources":["../../../src/adapters/cards/CardAuthorizationExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EAEf,cAAc,EACd,cAAc,EACd,eAAe,EAChB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,gCAAgC;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,yBAA0B,YAAW,cAAc,CAC9D,YAAY,EACZ,wBAAwB,EACxB,gBAAgB,CACjB;IACC,SAAgB,QAAQ,iBAAwB;IAChD,SAAgB,KAAK,EAAG,QAAQ,CAAU;IAC1C,SAAgB,WAAW,EAAE,SAAS,MAAM,EAAE,CAA0B;IACxE,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAC7E,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEhB,OAAO,EAAE,gCAAgC;IAM/C,YAAY,IAAI,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAapE;;;;;OAKG;IACU,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAiBrE,6FAA6F;IAChF,OAAO,CAClB,GAAG,EAAE,gBAAgB,CAAC,YAAY,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC;IAcrD,4FAA4F;IAC/E,OAAO,CAClB,MAAM,EAAE,eAAe,CAAC,wBAAwB,CAAC,GAChD,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAmClC,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC;CAGrE"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
import { authorityEffectEvidence } from "../EffectEvidenceBuilder.js";
|
|
2
|
+
import { cardResultRecord, prepareCardPurchase } from "./CardEffect.js";
|
|
3
|
+
import { CARD_PURCHASE_ACTION, cardTarget, } from "./CardPurchase.js";
|
|
4
|
+
export const CARD_ISSUER_PLATFORM = "card-issuer";
|
|
5
|
+
/**
|
|
6
|
+
* The cards family on `agent-safe.executors.native/1`, permit style: the
|
|
7
|
+
* issuer performs the effect, when its real-time authorization hook asks, so
|
|
8
|
+
* this executor never writes anything. The grant is held when the purchase
|
|
9
|
+
* is decided; the issuer's authorization request presents it, which claims
|
|
10
|
+
* it once; the permit is the approval the issuer is answered with; and the
|
|
11
|
+
* issuer's result is the receipt that settles it.
|
|
12
|
+
*
|
|
13
|
+
* - `observe` reads the result into the family's effect record: an approval
|
|
14
|
+
* within the ceiling is the authorised effect, a decline is a refusal, and
|
|
15
|
+
* a result after the claim's lease is indeterminate whatever it says.
|
|
16
|
+
* - `reconcile` has no one to ask: the issuer is the system of record and
|
|
17
|
+
* this boundary has no read path into it, so an authorization whose result
|
|
18
|
+
* never arrived stays unknown until someone who can see the issuer's ledger
|
|
19
|
+
* says.
|
|
20
|
+
*/
|
|
21
|
+
export class CardAuthorizationExecutor {
|
|
22
|
+
platform = CARD_ISSUER_PLATFORM;
|
|
23
|
+
style = "permit";
|
|
24
|
+
actionTypes = [CARD_PURCHASE_ACTION];
|
|
25
|
+
version;
|
|
26
|
+
observer;
|
|
27
|
+
clock;
|
|
28
|
+
constructor(options) {
|
|
29
|
+
this.observer = options.observer;
|
|
30
|
+
this.version = options.observer.version;
|
|
31
|
+
this.clock = options.clock ?? (() => new Date());
|
|
32
|
+
}
|
|
33
|
+
async capabilities() {
|
|
34
|
+
return await Promise.resolve([
|
|
35
|
+
{
|
|
36
|
+
platform: this.platform,
|
|
37
|
+
actionType: CARD_PURCHASE_ACTION,
|
|
38
|
+
enabled: true,
|
|
39
|
+
scopeGranted: true,
|
|
40
|
+
connected: true,
|
|
41
|
+
requirement: "",
|
|
42
|
+
},
|
|
43
|
+
]);
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* The purchase as an intent: this card, at this merchant, for at most this
|
|
47
|
+
* amount, bound to the projection the issuer's result is later compared
|
|
48
|
+
* with. The retry identity is the purchase's own digest, so the same
|
|
49
|
+
* purchase proposed twice is one purchase.
|
|
50
|
+
*/
|
|
51
|
+
async prepare(purchase) {
|
|
52
|
+
const effect = prepareCardPurchase(purchase);
|
|
53
|
+
return await Promise.resolve({
|
|
54
|
+
actionType: CARD_PURCHASE_ACTION,
|
|
55
|
+
proposal: {
|
|
56
|
+
action: CARD_PURCHASE_ACTION,
|
|
57
|
+
target: cardTarget(purchase),
|
|
58
|
+
parameters: purchase,
|
|
59
|
+
},
|
|
60
|
+
downstreamTarget: { system: CARD_ISSUER_PLATFORM, operation: "authorize" },
|
|
61
|
+
idempotencyKey: `card-purchase:${effect.intentDigest}`,
|
|
62
|
+
expectedEffectDigest: effect.expectedEffectDigest,
|
|
63
|
+
requestDigest: effect.requestDigest,
|
|
64
|
+
facts: {},
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
/** The permit the issuer is answered with: this grant, for this intent, until it expires. */
|
|
68
|
+
async execute(run) {
|
|
69
|
+
return await Promise.resolve({
|
|
70
|
+
kind: "PERMIT",
|
|
71
|
+
permit: {
|
|
72
|
+
permitId: run.authorization.grantId,
|
|
73
|
+
intentHash: run.intent.intentHash,
|
|
74
|
+
expiresAt: run.authorization.expiresAt,
|
|
75
|
+
...(run.authorization.claimAttestation === undefined
|
|
76
|
+
? {}
|
|
77
|
+
: { claimAttestation: run.authorization.claimAttestation }),
|
|
78
|
+
},
|
|
79
|
+
});
|
|
80
|
+
}
|
|
81
|
+
/** The issuer's result as the family's effect record; anything but a receipt is unknown. */
|
|
82
|
+
async observe(effect) {
|
|
83
|
+
if (effect.kind !== "RECEIPT") {
|
|
84
|
+
return await Promise.resolve({ status: "INDETERMINATE", reason: null, result: null });
|
|
85
|
+
}
|
|
86
|
+
const receipt = effect.receipt;
|
|
87
|
+
const record = cardResultRecord({
|
|
88
|
+
purchase: receipt.purchase,
|
|
89
|
+
prepared: receipt.prepared,
|
|
90
|
+
authorization: receipt.request,
|
|
91
|
+
result: receipt.result,
|
|
92
|
+
leaseExpired: receipt.leaseExpired,
|
|
93
|
+
observer: this.observer,
|
|
94
|
+
correlationId: receipt.correlationId,
|
|
95
|
+
idempotencyKey: receipt.idempotencyKey,
|
|
96
|
+
observedAt: this.clock().toISOString(),
|
|
97
|
+
});
|
|
98
|
+
const evidence = authorityEffectEvidence(record, receipt.correlationId, this.observer);
|
|
99
|
+
if (record.outcome === "INDETERMINATE") {
|
|
100
|
+
return { status: "INDETERMINATE", reason: null, result: record, evidence };
|
|
101
|
+
}
|
|
102
|
+
if (record.outcome === "FAILED") {
|
|
103
|
+
return {
|
|
104
|
+
status: "FAILED",
|
|
105
|
+
reason: record.reasonCodes[0] ?? "ISSUER_DECLINED",
|
|
106
|
+
result: record,
|
|
107
|
+
evidence,
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
return { status: "COMMITTED", reason: null, result: record, evidence };
|
|
111
|
+
}
|
|
112
|
+
async reconcile() {
|
|
113
|
+
return await Promise.resolve({ status: "UNKNOWN" });
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
//# sourceMappingURL=CardAuthorizationExecutor.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CardAuthorizationExecutor.js","sourceRoot":"","sources":["../../../src/adapters/cards/CardAuthorizationExecutor.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { IntentCapture, type AuditRecorder, type AuthorizationVerifier, type DecisionAuthority, type ExecutionSignals, type IntentActor, type JsonObject } from "@decionis/agent-safe-pipeline";
|
|
1
|
+
import { IntentCapture, type AuditRecorder, type AuthorizationVerifier, type DecisionAuthority, type ExecutionSignals, type IntentActor, type JsonObject, type McpToolProfile } from "@decionis/agent-safe-pipeline";
|
|
2
2
|
import { McpBindingError } from "./McpIntentBinder.js";
|
|
3
3
|
import type { McpInvocation, McpToolBinding } from "./McpInvocation.js";
|
|
4
4
|
/**
|
|
@@ -10,8 +10,25 @@ export interface McpTool<TResult = unknown> {
|
|
|
10
10
|
readonly binding: McpToolBinding;
|
|
11
11
|
invoke(args: JsonObject): Promise<TResult>;
|
|
12
12
|
}
|
|
13
|
+
/**
|
|
14
|
+
* A tool an `agent-safe.profile.mcp/1` profile declares: only its name and
|
|
15
|
+
* what it does. Its action, target, subject, consequential arguments and the
|
|
16
|
+
* arguments it accepts are the profile's, read as data.
|
|
17
|
+
*/
|
|
18
|
+
export interface McpProfiledTool<TResult = unknown> {
|
|
19
|
+
readonly tool: string;
|
|
20
|
+
invoke(args: JsonObject): Promise<TResult>;
|
|
21
|
+
}
|
|
22
|
+
/** What the host knows about the session a call belongs to, never what the model sent. */
|
|
23
|
+
export interface McpSession {
|
|
24
|
+
/** The subject the session is pinned to, verified by the host. */
|
|
25
|
+
readonly subject?: string;
|
|
26
|
+
}
|
|
13
27
|
export interface McpGuardOptions {
|
|
14
|
-
|
|
28
|
+
/** Tools bound in code (`McpTool`), or declared by `profile` (`McpProfiledTool`). */
|
|
29
|
+
readonly tools: readonly (McpTool | McpProfiledTool)[];
|
|
30
|
+
/** The tool profile the profiled tools are declared in. */
|
|
31
|
+
readonly profile?: McpToolProfile;
|
|
15
32
|
readonly authority: DecisionAuthority;
|
|
16
33
|
readonly verifier: AuthorizationVerifier;
|
|
17
34
|
readonly tenantId: string;
|
|
@@ -83,9 +100,21 @@ export declare class McpGuard {
|
|
|
83
100
|
private readonly executor;
|
|
84
101
|
private readonly options;
|
|
85
102
|
constructor(options: McpGuardOptions);
|
|
103
|
+
/**
|
|
104
|
+
* A tool as the guard holds it: a code binding as given, or a profiled
|
|
105
|
+
* tool's binding read from the profile. A profiled tool the profile does
|
|
106
|
+
* not declare is refused at construction, never governed by a guess.
|
|
107
|
+
*/
|
|
108
|
+
private static resolve;
|
|
86
109
|
/** Every tool this guard governs, for a server publishing its tool list. */
|
|
87
110
|
governs(tool: string): boolean;
|
|
88
|
-
|
|
111
|
+
/**
|
|
112
|
+
* One invocation, through the lifecycle. `session` is the host's: the
|
|
113
|
+
* subject it verified for this conversation. A tool that names a subject
|
|
114
|
+
* argument is refused without one, or for another subject, before the
|
|
115
|
+
* authority is asked; any tool's intent states it as `session.subject`.
|
|
116
|
+
*/
|
|
117
|
+
guard<TResult = unknown>(invocation: McpInvocation, session?: McpSession): Promise<McpOutcome<TResult>>;
|
|
89
118
|
private outcomeOf;
|
|
90
119
|
}
|
|
91
120
|
//# sourceMappingURL=McpGuard.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"McpGuard.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/McpGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAGb,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAErB,KAAK,WAAW,EAChB,KAAK,UAAU,
|
|
1
|
+
{"version":3,"file":"McpGuard.d.ts","sourceRoot":"","sources":["../../../src/adapters/mcp/McpGuard.ts"],"names":[],"mappings":"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"}
|