@deliverd/sdk 0.25.0 → 0.26.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 +82 -3
- package/dist/adapters/index.d.ts +4 -0
- package/dist/adapters/index.d.ts.map +1 -1
- package/dist/adapters/index.js +2 -0
- package/dist/adapters/mastra.d.ts +81 -0
- package/dist/adapters/mastra.d.ts.map +1 -0
- package/dist/adapters/mastra.js +54 -0
- package/dist/adapters/muse-spark.d.ts +79 -0
- package/dist/adapters/muse-spark.d.ts.map +1 -0
- package/dist/adapters/muse-spark.js +59 -0
- package/dist/adapters/shared.d.ts +2 -1
- package/dist/adapters/shared.d.ts.map +1 -1
- package/dist/data-screen.d.ts +233 -0
- package/dist/data-screen.d.ts.map +1 -0
- package/dist/data-screen.js +389 -0
- package/dist/dev.d.ts.map +1 -1
- package/dist/dev.js +42 -2
- package/dist/governance.d.ts +94 -0
- package/dist/governance.d.ts.map +1 -0
- package/dist/governance.js +166 -0
- package/dist/index.d.ts +27 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +30 -0
- package/dist/messages.d.ts +2 -0
- package/dist/messages.d.ts.map +1 -1
- package/dist/messages.js +8 -1
- package/dist/released.d.ts +1 -1
- package/dist/released.d.ts.map +1 -1
- package/dist/released.js +2184 -0
- package/dist/screen.d.ts +85 -0
- package/dist/screen.d.ts.map +1 -0
- package/dist/screen.js +69 -0
- package/dist/tasks.d.ts +38 -1
- package/dist/tasks.d.ts.map +1 -1
- package/dist/tasks.js +67 -0
- package/dist/types.d.ts +589 -3
- package/dist/types.d.ts.map +1 -1
- package/package.json +5 -5
- package/src/adapters/index.ts +11 -0
- package/src/adapters/mastra.ts +118 -0
- package/src/adapters/muse-spark.ts +147 -0
- package/src/adapters/shared.ts +2 -1
- package/src/data-screen.ts +533 -0
- package/src/dev.ts +45 -2
- package/src/governance.ts +204 -0
- package/src/index.ts +43 -0
- package/src/messages.ts +10 -1
- package/src/released.ts +2184 -0
- package/src/screen.ts +144 -0
- package/src/tasks.ts +88 -0
- package/src/types.ts +577 -3
package/dist/screen.d.ts
ADDED
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
import type { Approval, Approvals } from "./approvals.js";
|
|
2
|
+
import { type DetectedSpan, type ScreenTerm, type SpanDetector } from "./data-screen.js";
|
|
3
|
+
import { type Duration } from "./duration.js";
|
|
4
|
+
import type { HttpClient } from "./http.js";
|
|
5
|
+
import type { ScreenData, ScreenVerdict } from "./types.js";
|
|
6
|
+
/**
|
|
7
|
+
* Check text before it goes to an AI model.
|
|
8
|
+
*
|
|
9
|
+
* ```ts
|
|
10
|
+
* const screened = await deliverd.screen(prompt, { aiSystemId: CLAIMS_MODEL });
|
|
11
|
+
* if (!screened.allowed) return screened.reasons;
|
|
12
|
+
* const answer = await model.generate(screened.text);
|
|
13
|
+
* return screened.restore(answer);
|
|
14
|
+
* ```
|
|
15
|
+
*
|
|
16
|
+
* **The text does not leave your machine.** The detectors run here — the same
|
|
17
|
+
* code the server runs — and Deliverd is sent only what was found, by kind:
|
|
18
|
+
* "two email addresses, one IBAN". It answers from what the organisation's AI
|
|
19
|
+
* register approves that model to receive, and from its policy:
|
|
20
|
+
*
|
|
21
|
+
* - `allow`: send it as it is.
|
|
22
|
+
* - `redact`: `screened.text` has the findings replaced by placeholders such
|
|
23
|
+
* as `[EMAIL_1]`; send that, and `restore()` puts the values back in the
|
|
24
|
+
* model's answer.
|
|
25
|
+
* - `ask`: a person decides, through an ordinary approval, and this waits for
|
|
26
|
+
* them. Approved, `screened.text` is the original.
|
|
27
|
+
* - `deny`: nothing may be sent. `screened.text` is null.
|
|
28
|
+
*
|
|
29
|
+
* **A net, not a guarantee.** Structured identifiers are found well; names
|
|
30
|
+
* are not found reliably. Never tell anyone a text is clean because this
|
|
31
|
+
* allowed it.
|
|
32
|
+
*/
|
|
33
|
+
export interface ScreenOptions {
|
|
34
|
+
/** The AI register's record for the model it is going to. Without one, it is held to internal data and no personal data. */
|
|
35
|
+
aiSystemId?: string;
|
|
36
|
+
/** What it is for, shown to a person if one is asked. */
|
|
37
|
+
purpose?: string;
|
|
38
|
+
/** Your own reference, kept on any approval. */
|
|
39
|
+
externalId?: string;
|
|
40
|
+
/**
|
|
41
|
+
* Words your organisation does not want sent — clients, code names — found
|
|
42
|
+
* here like any other kind. Terms an administrator set in Deliverd are
|
|
43
|
+
* applied only to text the server reads, so pass yours here.
|
|
44
|
+
*/
|
|
45
|
+
terms?: readonly ScreenTerm[];
|
|
46
|
+
/**
|
|
47
|
+
* Detectors to run here beside the patterns, such as a named-entity model
|
|
48
|
+
* for people's names, which patterns cannot find. Each gets the text and
|
|
49
|
+
* returns spans; `@deliverd/screen` has adapters for Hugging Face and
|
|
50
|
+
* Presidio. They run on your machine, like the patterns, and only their
|
|
51
|
+
* counts are sent.
|
|
52
|
+
*/
|
|
53
|
+
detectors?: readonly SpanDetector[];
|
|
54
|
+
/** Spans another detector already found in this text. */
|
|
55
|
+
spans?: readonly DetectedSpan[];
|
|
56
|
+
/** Whether to wait for a person on an `ask`. Default true. */
|
|
57
|
+
wait?: boolean;
|
|
58
|
+
timeout?: Duration;
|
|
59
|
+
signal?: AbortSignal;
|
|
60
|
+
}
|
|
61
|
+
export declare class Screened {
|
|
62
|
+
/** What the server answered. */
|
|
63
|
+
readonly data: ScreenData;
|
|
64
|
+
/** What may be sent: the original, the redacted text, or null when nothing may be. */
|
|
65
|
+
readonly text: string | null;
|
|
66
|
+
/** Whether to send `text`. False for a deny, and for an ask a person did not approve. */
|
|
67
|
+
readonly allowed: boolean;
|
|
68
|
+
private readonly replacements;
|
|
69
|
+
/** The approval a person decided, for an `ask`. */
|
|
70
|
+
readonly approval: Approval | null;
|
|
71
|
+
constructor(
|
|
72
|
+
/** What the server answered. */
|
|
73
|
+
data: ScreenData,
|
|
74
|
+
/** What may be sent: the original, the redacted text, or null when nothing may be. */
|
|
75
|
+
text: string | null,
|
|
76
|
+
/** Whether to send `text`. False for a deny, and for an ask a person did not approve. */
|
|
77
|
+
allowed: boolean, replacements: Readonly<Record<string, string>>, approval?: Approval | null);
|
|
78
|
+
get verdict(): ScreenVerdict;
|
|
79
|
+
/** One sentence each: why, for logging or for telling the person. */
|
|
80
|
+
get reasons(): string[];
|
|
81
|
+
/** Put the original values back into text a model wrote using the placeholders. */
|
|
82
|
+
restore(answer: string): string;
|
|
83
|
+
}
|
|
84
|
+
export declare function screen(http: HttpClient, approvals: Approvals, text: string, options?: ScreenOptions, development?: boolean): Promise<Screened>;
|
|
85
|
+
//# sourceMappingURL=screen.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAOL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,WAAW,aAAa;IAC5B,4HAA4H;IAC5H,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACpC,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,QAAQ;IAKjB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,UAAU;IACzB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,OAAO;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAV/B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;;IAGjC,gCAAgC;IACvB,IAAI,EAAE,UAAU;IACzB,sFAAsF;IAC7E,IAAI,EAAE,MAAM,GAAG,IAAI;IAC5B,yFAAyF;IAChF,OAAO,EAAE,OAAO,EACR,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAC/D,QAAQ,GAAE,QAAQ,GAAG,IAAW;IAKlC,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,qEAAqE;IACrE,IAAI,OAAO,IAAI,MAAM,EAAE,CAEtB;IAED,mFAAmF;IACnF,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGhC;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,aAAkB,EAC3B,WAAW,UAAQ,GAClB,OAAO,CAAC,QAAQ,CAAC,CAgCnB"}
|
package/dist/screen.js
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { redactFor, restore, screenText, summarise, termClassificationOf, } from "./data-screen.js";
|
|
2
|
+
import { durationMs } from "./duration.js";
|
|
3
|
+
export class Screened {
|
|
4
|
+
data;
|
|
5
|
+
text;
|
|
6
|
+
allowed;
|
|
7
|
+
replacements;
|
|
8
|
+
/** The approval a person decided, for an `ask`. */
|
|
9
|
+
approval;
|
|
10
|
+
constructor(
|
|
11
|
+
/** What the server answered. */
|
|
12
|
+
data,
|
|
13
|
+
/** What may be sent: the original, the redacted text, or null when nothing may be. */
|
|
14
|
+
text,
|
|
15
|
+
/** Whether to send `text`. False for a deny, and for an ask a person did not approve. */
|
|
16
|
+
allowed, replacements, approval = null) {
|
|
17
|
+
this.data = data;
|
|
18
|
+
this.text = text;
|
|
19
|
+
this.allowed = allowed;
|
|
20
|
+
this.replacements = replacements;
|
|
21
|
+
this.approval = approval;
|
|
22
|
+
}
|
|
23
|
+
get verdict() {
|
|
24
|
+
return this.data.verdict;
|
|
25
|
+
}
|
|
26
|
+
/** One sentence each: why, for logging or for telling the person. */
|
|
27
|
+
get reasons() {
|
|
28
|
+
return this.data.reasons;
|
|
29
|
+
}
|
|
30
|
+
/** Put the original values back into text a model wrote using the placeholders. */
|
|
31
|
+
restore(answer) {
|
|
32
|
+
return restore(answer, this.replacements);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
export async function screen(http, approvals, text, options = {}, development = false) {
|
|
36
|
+
const spans = [...(options.spans ?? [])];
|
|
37
|
+
for (const detect of options.detectors ?? [])
|
|
38
|
+
spans.push(...(await detect(text)));
|
|
39
|
+
const findings = screenText(text, options.terms ?? [], spans);
|
|
40
|
+
const data = await http.request({
|
|
41
|
+
method: "POST",
|
|
42
|
+
path: "/screen",
|
|
43
|
+
body: {
|
|
44
|
+
counts: summarise(findings),
|
|
45
|
+
termClassification: termClassificationOf(findings),
|
|
46
|
+
...(options.aiSystemId ? { aiSystemId: options.aiSystemId } : {}),
|
|
47
|
+
...(options.purpose ? { purpose: options.purpose } : {}),
|
|
48
|
+
...(options.externalId ? { externalId: options.externalId } : {}),
|
|
49
|
+
},
|
|
50
|
+
signal: options.signal,
|
|
51
|
+
});
|
|
52
|
+
if (data.verdict === "allow")
|
|
53
|
+
return new Screened(data, text, true, {});
|
|
54
|
+
if (data.verdict === "deny")
|
|
55
|
+
return new Screened(data, null, false, {});
|
|
56
|
+
if (data.verdict === "redact") {
|
|
57
|
+
const redacted = redactFor(text, findings, { verdict: data.verdict, offending: data.offending });
|
|
58
|
+
return new Screened(data, redacted?.text ?? null, true, redacted?.replacements ?? {});
|
|
59
|
+
}
|
|
60
|
+
// ask
|
|
61
|
+
if (!data.approval || options.wait === false)
|
|
62
|
+
return new Screened(data, null, false, {});
|
|
63
|
+
const approval = await approvals.get(data.approval.id, options.signal);
|
|
64
|
+
const settled = await approval.wait({
|
|
65
|
+
signal: options.signal,
|
|
66
|
+
timeout: options.timeout === undefined ? (development ? 2_000 : undefined) : durationMs(options.timeout),
|
|
67
|
+
});
|
|
68
|
+
return settled.approved ? new Screened(data, text, true, {}, settled) : new Screened(data, null, false, {}, settled);
|
|
69
|
+
}
|
package/dist/tasks.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { type PageOf } from "./paging.js";
|
|
2
2
|
import type { HttpClient } from "./http.js";
|
|
3
|
-
import type { AddFindingInput, AppliedSideTask, ApplySideTaskInput, CancelTaskInput, CompleteTaskInput, CreateSideTaskInput, CreateTaskInput, DecisionApproval, Governance, GovernanceGateCheck, LinkTasksInput, ListTasksInput, RequestDecisionApprovalInput, SubmitEvidenceInput, TaskContext, TaskData, TaskFinding, TaskGraph, TaskLinkResult, UpdateTaskInput } from "./types.js";
|
|
3
|
+
import type { AddFindingInput, AppliedSideTask, ApplySideTaskInput, CancelTaskInput, CompleteTaskInput, ControlApprovalInput, ControlApprovalResult, CreateSideTaskInput, CreateTaskInput, DecisionApproval, Governance, GovernanceGateCheck, GovernancePack, GovernanceProfileInput, LinkTasksInput, ListTasksInput, ReassessmentResult, RequestDecisionApprovalInput, SubmitEvidenceInput, TaskContext, TaskData, TaskFinding, TaskGraph, TaskLinkResult, UpdateGovernanceProfileInput, UpdateTaskInput } from "./types.js";
|
|
4
4
|
export declare class Task {
|
|
5
5
|
private readonly http;
|
|
6
6
|
private data;
|
|
@@ -66,6 +66,16 @@ export declare class Task {
|
|
|
66
66
|
checkGovernanceGate(options?: {
|
|
67
67
|
action?: string;
|
|
68
68
|
}, signal?: AbortSignal): Promise<GovernanceGateCheck>;
|
|
69
|
+
/** Govern it (Compliance Mode). Already governed, it answers with the governance it has. */
|
|
70
|
+
govern(profile?: GovernanceProfileInput, signal?: AbortSignal): Promise<Governance>;
|
|
71
|
+
/** Change its governance profile. An agent may raise risk or add facts; only a person lowers or clears them. */
|
|
72
|
+
updateGovernanceProfile(input: UpdateGovernanceProfileInput, signal?: AbortSignal): Promise<Governance>;
|
|
73
|
+
/** Put an approval control to a person through the organisation's approval process. */
|
|
74
|
+
requestControlApproval(control: string, input?: ControlApprovalInput, signal?: AbortSignal): Promise<ControlApprovalResult>;
|
|
75
|
+
/** Ask for it to be reassessed (Enterprise). The governance gate stays closed until a person completes it. */
|
|
76
|
+
triggerReassessment(reason: string, signal?: AbortSignal): Promise<ReassessmentResult>;
|
|
77
|
+
/** Its evidence pack, with a digest. It assists audit; it does not certify compliance. */
|
|
78
|
+
evidencePack(signal?: AbortSignal): Promise<GovernancePack>;
|
|
69
79
|
}
|
|
70
80
|
export declare class Tasks {
|
|
71
81
|
private readonly http;
|
|
@@ -117,5 +127,32 @@ export declare class Tasks {
|
|
|
117
127
|
checkGovernanceGate(id: string, options?: {
|
|
118
128
|
action?: string;
|
|
119
129
|
}, signal?: AbortSignal): Promise<GovernanceGateCheck>;
|
|
130
|
+
/**
|
|
131
|
+
* Govern an objective (Compliance Mode, Business and Enterprise): the AI
|
|
132
|
+
* system, purpose, owners, risk, data and oversight, as far as they are
|
|
133
|
+
* known. Idempotent: an objective already governed answers with its
|
|
134
|
+
* governance. A side task's id answers for its objective.
|
|
135
|
+
*/
|
|
136
|
+
govern(id: string, profile?: GovernanceProfileInput, signal?: AbortSignal): Promise<Governance>;
|
|
137
|
+
/**
|
|
138
|
+
* Change a governed task's profile. An agent may raise risk or add facts;
|
|
139
|
+
* only a person lowers or clears them. With `expectedVersion`, refused if
|
|
140
|
+
* somebody wrote in between.
|
|
141
|
+
*/
|
|
142
|
+
updateGovernanceProfile(id: string, input: UpdateGovernanceProfileInput, signal?: AbortSignal): Promise<Governance>;
|
|
143
|
+
/**
|
|
144
|
+
* Put an approval control (a compliance or deployment approval) to a person
|
|
145
|
+
* through the organisation's approval process. The control is satisfied
|
|
146
|
+
* when that approval is approved. Needs `approvals:write`.
|
|
147
|
+
*/
|
|
148
|
+
requestControlApproval(id: string, control: string, input?: ControlApprovalInput, signal?: AbortSignal): Promise<ControlApprovalResult>;
|
|
149
|
+
/** Ask for a governed task to be reassessed (Enterprise). Its governance gate stays closed until a person completes it. */
|
|
150
|
+
triggerReassessment(id: string, reason: string, signal?: AbortSignal): Promise<ReassessmentResult>;
|
|
151
|
+
/**
|
|
152
|
+
* A governed task's evidence pack: profile, controls, evidence, task graph,
|
|
153
|
+
* decisions, approvals and the audit timeline, with a digest. It assists
|
|
154
|
+
* audit; it does not certify compliance. Every export is audited.
|
|
155
|
+
*/
|
|
156
|
+
evidencePack(id: string, signal?: AbortSignal): Promise<GovernancePack>;
|
|
120
157
|
}
|
|
121
158
|
//# sourceMappingURL=tasks.d.ts.map
|
package/dist/tasks.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"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"}
|
package/dist/tasks.js
CHANGED
|
@@ -173,6 +173,26 @@ export class Task {
|
|
|
173
173
|
checkGovernanceGate(options = {}, signal) {
|
|
174
174
|
return new Tasks(this.http).checkGovernanceGate(this.data.id, options, signal);
|
|
175
175
|
}
|
|
176
|
+
/** Govern it (Compliance Mode). Already governed, it answers with the governance it has. */
|
|
177
|
+
govern(profile = {}, signal) {
|
|
178
|
+
return new Tasks(this.http).govern(this.data.id, profile, signal);
|
|
179
|
+
}
|
|
180
|
+
/** Change its governance profile. An agent may raise risk or add facts; only a person lowers or clears them. */
|
|
181
|
+
updateGovernanceProfile(input, signal) {
|
|
182
|
+
return new Tasks(this.http).updateGovernanceProfile(this.data.id, input, signal);
|
|
183
|
+
}
|
|
184
|
+
/** Put an approval control to a person through the organisation's approval process. */
|
|
185
|
+
requestControlApproval(control, input = {}, signal) {
|
|
186
|
+
return new Tasks(this.http).requestControlApproval(this.data.id, control, input, signal);
|
|
187
|
+
}
|
|
188
|
+
/** Ask for it to be reassessed (Enterprise). The governance gate stays closed until a person completes it. */
|
|
189
|
+
triggerReassessment(reason, signal) {
|
|
190
|
+
return new Tasks(this.http).triggerReassessment(this.data.id, reason, signal);
|
|
191
|
+
}
|
|
192
|
+
/** Its evidence pack, with a digest. It assists audit; it does not certify compliance. */
|
|
193
|
+
evidencePack(signal) {
|
|
194
|
+
return new Tasks(this.http).evidencePack(this.data.id, signal);
|
|
195
|
+
}
|
|
176
196
|
}
|
|
177
197
|
export class Tasks {
|
|
178
198
|
http;
|
|
@@ -297,4 +317,51 @@ export class Tasks {
|
|
|
297
317
|
signal,
|
|
298
318
|
});
|
|
299
319
|
}
|
|
320
|
+
/**
|
|
321
|
+
* Govern an objective (Compliance Mode, Business and Enterprise): the AI
|
|
322
|
+
* system, purpose, owners, risk, data and oversight, as far as they are
|
|
323
|
+
* known. Idempotent: an objective already governed answers with its
|
|
324
|
+
* governance. A side task's id answers for its objective.
|
|
325
|
+
*/
|
|
326
|
+
govern(id, profile = {}, signal) {
|
|
327
|
+
return this.http.request({ method: "POST", path: `/tasks/${enc(id)}/governance`, body: profile, signal });
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* Change a governed task's profile. An agent may raise risk or add facts;
|
|
331
|
+
* only a person lowers or clears them. With `expectedVersion`, refused if
|
|
332
|
+
* somebody wrote in between.
|
|
333
|
+
*/
|
|
334
|
+
updateGovernanceProfile(id, input, signal) {
|
|
335
|
+
return this.http.request({ method: "PATCH", path: `/tasks/${enc(id)}/governance`, body: input, signal });
|
|
336
|
+
}
|
|
337
|
+
/**
|
|
338
|
+
* Put an approval control (a compliance or deployment approval) to a person
|
|
339
|
+
* through the organisation's approval process. The control is satisfied
|
|
340
|
+
* when that approval is approved. Needs `approvals:write`.
|
|
341
|
+
*/
|
|
342
|
+
requestControlApproval(id, control, input = {}, signal) {
|
|
343
|
+
return this.http.request({
|
|
344
|
+
method: "POST",
|
|
345
|
+
path: `/tasks/${enc(id)}/governance/controls/${enc(control)}/approval`,
|
|
346
|
+
body: input,
|
|
347
|
+
signal,
|
|
348
|
+
});
|
|
349
|
+
}
|
|
350
|
+
/** Ask for a governed task to be reassessed (Enterprise). Its governance gate stays closed until a person completes it. */
|
|
351
|
+
triggerReassessment(id, reason, signal) {
|
|
352
|
+
return this.http.request({
|
|
353
|
+
method: "POST",
|
|
354
|
+
path: `/tasks/${enc(id)}/governance/reassessments`,
|
|
355
|
+
body: { reason },
|
|
356
|
+
signal,
|
|
357
|
+
});
|
|
358
|
+
}
|
|
359
|
+
/**
|
|
360
|
+
* A governed task's evidence pack: profile, controls, evidence, task graph,
|
|
361
|
+
* decisions, approvals and the audit timeline, with a digest. It assists
|
|
362
|
+
* audit; it does not certify compliance. Every export is audited.
|
|
363
|
+
*/
|
|
364
|
+
evidencePack(id, signal) {
|
|
365
|
+
return this.http.request({ method: "GET", path: `/tasks/${enc(id)}/governance/pack`, signal });
|
|
366
|
+
}
|
|
300
367
|
}
|