@deliverd/sdk 0.25.1 → 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.
Files changed (47) hide show
  1. package/README.md +65 -0
  2. package/dist/adapters/index.d.ts +4 -0
  3. package/dist/adapters/index.d.ts.map +1 -1
  4. package/dist/adapters/index.js +2 -0
  5. package/dist/adapters/mastra.d.ts +81 -0
  6. package/dist/adapters/mastra.d.ts.map +1 -0
  7. package/dist/adapters/mastra.js +54 -0
  8. package/dist/adapters/muse-spark.d.ts +79 -0
  9. package/dist/adapters/muse-spark.d.ts.map +1 -0
  10. package/dist/adapters/muse-spark.js +59 -0
  11. package/dist/adapters/shared.d.ts +2 -1
  12. package/dist/adapters/shared.d.ts.map +1 -1
  13. package/dist/data-screen.d.ts +233 -0
  14. package/dist/data-screen.d.ts.map +1 -0
  15. package/dist/data-screen.js +389 -0
  16. package/dist/dev.d.ts.map +1 -1
  17. package/dist/dev.js +42 -2
  18. package/dist/governance.d.ts +94 -0
  19. package/dist/governance.d.ts.map +1 -0
  20. package/dist/governance.js +166 -0
  21. package/dist/index.d.ts +27 -0
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index.js +30 -0
  24. package/dist/released.d.ts +1 -1
  25. package/dist/released.d.ts.map +1 -1
  26. package/dist/released.js +1265 -0
  27. package/dist/screen.d.ts +85 -0
  28. package/dist/screen.d.ts.map +1 -0
  29. package/dist/screen.js +69 -0
  30. package/dist/tasks.d.ts +38 -1
  31. package/dist/tasks.d.ts.map +1 -1
  32. package/dist/tasks.js +67 -0
  33. package/dist/types.d.ts +589 -3
  34. package/dist/types.d.ts.map +1 -1
  35. package/package.json +2 -2
  36. package/src/adapters/index.ts +11 -0
  37. package/src/adapters/mastra.ts +118 -0
  38. package/src/adapters/muse-spark.ts +147 -0
  39. package/src/adapters/shared.ts +2 -1
  40. package/src/data-screen.ts +533 -0
  41. package/src/dev.ts +45 -2
  42. package/src/governance.ts +204 -0
  43. package/src/index.ts +43 -0
  44. package/src/released.ts +1265 -0
  45. package/src/screen.ts +144 -0
  46. package/src/tasks.ts +88 -0
  47. package/src/types.ts +577 -3
@@ -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
@@ -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
  }