@deliverd/sdk 0.27.0 → 0.29.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/dist/screen.d.ts CHANGED
@@ -2,6 +2,7 @@ import type { Approval, Approvals } from "./approvals.js";
2
2
  import { type DetectedSpan, type ScreenTerm, type SpanDetector } from "./data-screen.js";
3
3
  import { type Duration } from "./duration.js";
4
4
  import type { HttpClient } from "./http.js";
5
+ import type { PurviewCheck } from "./purview.js";
5
6
  import type { ScreenData, ScreenVerdict } from "./types.js";
6
7
  /**
7
8
  * Check text before it goes to an AI model.
@@ -53,6 +54,13 @@ export interface ScreenOptions {
53
54
  detectors?: readonly SpanDetector[];
54
55
  /** Spans another detector already found in this text. */
55
56
  spans?: readonly DetectedSpan[];
57
+ /**
58
+ * Your organisation's Microsoft Purview, asked about the text before
59
+ * Deliverd: build one with `purviewCheck()`. The text goes from here to
60
+ * Microsoft, never to Deliverd, and only Purview's answer is sent on. A
61
+ * Purview block stops the text; a warn puts it to a person.
62
+ */
63
+ purview?: PurviewCheck;
56
64
  /** Whether to wait for a person on an `ask`. Default true. */
57
65
  wait?: boolean;
58
66
  timeout?: Duration;
@@ -1 +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"}
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,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,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;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,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,CAkCnB"}
package/dist/screen.js CHANGED
@@ -37,6 +37,7 @@ export async function screen(http, approvals, text, options = {}, development =
37
37
  for (const detect of options.detectors ?? [])
38
38
  spans.push(...(await detect(text)));
39
39
  const findings = screenText(text, options.terms ?? [], spans);
40
+ const purview = options.purview ? await options.purview(text) : null;
40
41
  const data = await http.request({
41
42
  method: "POST",
42
43
  path: "/screen",
@@ -46,6 +47,7 @@ export async function screen(http, approvals, text, options = {}, development =
46
47
  ...(options.aiSystemId ? { aiSystemId: options.aiSystemId } : {}),
47
48
  ...(options.purpose ? { purpose: options.purpose } : {}),
48
49
  ...(options.externalId ? { externalId: options.externalId } : {}),
50
+ ...(purview ? { purview } : {}),
49
51
  },
50
52
  signal: options.signal,
51
53
  });
package/dist/types.d.ts CHANGED
@@ -1338,9 +1338,41 @@ export interface TaskContext {
1338
1338
  * `reports.update()` rather than publishing a second on the same thing.
1339
1339
  */
1340
1340
  reports: TaskContextReport[];
1341
+ /**
1342
+ * Confirmed knowledge for this task, few and cut short: what its playbook
1343
+ * and step name first, then the most relevant. A person confirmed each one;
1344
+ * propose anything new with `knowledge.propose()`.
1345
+ */
1346
+ knowledge: TaskContextKnowledge[];
1347
+ /** The playbook this run follows, and this task's step in it; null when none. */
1348
+ playbook: TaskContextPlaybook | null;
1341
1349
  /** One paragraph to say back to yourself to re-anchor on the objective. */
1342
1350
  reanchor: string;
1343
1351
  }
1352
+ /** A confirmed knowledge entry, as a task's context gives it. */
1353
+ export interface TaskContextKnowledge {
1354
+ id: string;
1355
+ kind: KnowledgeKind;
1356
+ title: string;
1357
+ /** Cut at 600 characters; `knowledge.get(id)` has the rest. */
1358
+ body: string;
1359
+ confirmedBy: string | null;
1360
+ url: string;
1361
+ }
1362
+ /** The playbook a task follows, and its step. */
1363
+ export interface TaskContextPlaybook {
1364
+ id: string;
1365
+ title: string;
1366
+ version: number;
1367
+ /** The step this task is, with the call its rule needs before acting; null on the objective itself. */
1368
+ step: {
1369
+ key: string;
1370
+ title: string;
1371
+ rule: PlaybookStepRule;
1372
+ action: string | null;
1373
+ call: string | null;
1374
+ } | null;
1375
+ }
1344
1376
  /** A report published for a task, as its context names it. */
1345
1377
  export interface TaskContextReport {
1346
1378
  id: string;
@@ -2352,6 +2384,15 @@ export interface ScreenApprovalRef {
2352
2384
  url: string;
2353
2385
  status: string;
2354
2386
  }
2387
+ /** Microsoft Purview's answer, as the caller sent it. Never the text. */
2388
+ export interface ScreenPurviewData {
2389
+ /** `null` when Purview returned no restriction. */
2390
+ restriction: "audit" | "warn" | "block" | null;
2391
+ actions: number;
2392
+ scopeModified: boolean;
2393
+ /** Purview could not be reached; `restriction` is what the caller chose for that case. */
2394
+ unavailable: boolean;
2395
+ }
2355
2396
  /** What `POST /screen` answers: the verdict, and why. */
2356
2397
  export interface ScreenData {
2357
2398
  verdict: ScreenVerdict;
@@ -2371,5 +2412,348 @@ export interface ScreenData {
2371
2412
  redactedText: string | null;
2372
2413
  /** The approval a person decides, for an `ask` verdict. */
2373
2414
  approval: ScreenApprovalRef | null;
2415
+ /** Microsoft Purview's answer, when `screen()` was given a `purview` check. */
2416
+ purview?: ScreenPurviewData | null;
2417
+ }
2418
+ export type KnowledgeKind = "fact" | "convention" | "decision" | "procedure" | "glossary" | "contact" | "known_issue";
2419
+ export type KnowledgeStatus = "proposed" | "confirmed" | "rejected" | "retired" | "superseded";
2420
+ /** `open` is proposed and confirmed together. */
2421
+ export type KnowledgeStatusFilter = KnowledgeStatus | "open" | "all";
2422
+ /** Where an entry came from. */
2423
+ export interface KnowledgeSource {
2424
+ kind: "manual" | "finding" | "decision" | "import" | "url" | "agent";
2425
+ id?: string;
2426
+ url?: string;
2427
+ label?: string;
2428
+ }
2429
+ /** One entry of the organisation's knowledge. Only `confirmed` is to be relied on. */
2430
+ export interface KnowledgeEntryData {
2431
+ id: string;
2432
+ url: string;
2433
+ kind: KnowledgeKind;
2434
+ kindLabel: string;
2435
+ title: string;
2436
+ body: string;
2437
+ tags: string[];
2438
+ status: KnowledgeStatus;
2439
+ workspaceId: string | null;
2440
+ flowId: string | null;
2441
+ /** The confirmed entry this replaces once it is confirmed. */
2442
+ supersedesId: string | null;
2443
+ supersededById: string | null;
2444
+ source: KnowledgeSource;
2445
+ owner: string | null;
2446
+ reviewDueOn: string | null;
2447
+ reviewOverdue: boolean;
2448
+ lastReviewedAt: string | null;
2449
+ confirmedBy: string | null;
2450
+ confirmedAt: string | null;
2451
+ decisionNote: string | null;
2452
+ retiredAt: string | null;
2453
+ retiredReason: string | null;
2454
+ externalId: string | null;
2455
+ proposedBy: string;
2456
+ createdAt: string;
2457
+ updatedAt: string;
2458
+ }
2459
+ export interface KnowledgeDetail extends KnowledgeEntryData {
2460
+ /** Earlier versions this replaced and later ones that replaced it, oldest first. */
2461
+ history: {
2462
+ id: string;
2463
+ title: string;
2464
+ status: KnowledgeStatus;
2465
+ confirmedAt: string | null;
2466
+ url: string;
2467
+ }[];
2468
+ /** A proposed revision waiting for a person, on a confirmed entry. */
2469
+ pendingRevision: {
2470
+ id: string;
2471
+ title: string;
2472
+ url: string;
2473
+ } | null;
2474
+ }
2475
+ export interface ProposeKnowledgeInput {
2476
+ kind: KnowledgeKind;
2477
+ /** The fact or rule in one line. */
2478
+ title: string;
2479
+ /** The detail another agent needs to act on it. A secret is refused. */
2480
+ body: string;
2481
+ tags?: string[];
2482
+ /** One workspace only; the whole organisation when omitted. */
2483
+ workspaceId?: string;
2484
+ flowId?: string;
2485
+ /** The confirmed entry this would replace, once a person confirms it. */
2486
+ supersedesId?: string;
2487
+ sourceUrl?: string;
2488
+ sourceLabel?: string;
2489
+ /** Your own reference. An open entry with the same one comes back instead of a second. */
2490
+ externalId?: string;
2491
+ }
2492
+ export interface ProposedKnowledge {
2493
+ entry: KnowledgeEntryData;
2494
+ resumed: boolean;
2495
+ /** Personal data seen in what you wrote, said back to you; null when none. */
2496
+ screening: string | null;
2497
+ }
2498
+ export interface EditKnowledgeInput {
2499
+ kind?: KnowledgeKind;
2500
+ title?: string;
2501
+ body?: string;
2502
+ tags?: string[];
2503
+ }
2504
+ export interface SearchKnowledgeInput {
2505
+ /** Words, ranked by relevance. Omit for the newest. */
2506
+ q?: string;
2507
+ kind?: KnowledgeKind;
2508
+ /** `confirmed` when omitted. */
2509
+ status?: KnowledgeStatusFilter;
2510
+ workspaceId?: string;
2511
+ flowId?: string;
2512
+ limit?: number;
2513
+ }
2514
+ export interface KnowledgeSearchResult {
2515
+ entries: KnowledgeEntryData[];
2516
+ /** True when the list was cut at the limit. */
2517
+ more: boolean;
2518
+ }
2519
+ export interface PromoteFindingInput {
2520
+ kind?: KnowledgeKind;
2521
+ title?: string;
2522
+ body?: string;
2523
+ tags?: string[];
2524
+ }
2525
+ export interface ImportKnowledgeInput {
2526
+ /** A Deliverd export, or a notes file such as AGENTS.md. Each heading becomes one proposed entry. */
2527
+ markdown: string;
2528
+ workspaceId?: string;
2529
+ /** Where the file came from, e.g. the repository and path. */
2530
+ source?: string;
2531
+ }
2532
+ export interface ImportedKnowledge {
2533
+ created: KnowledgeEntryData[];
2534
+ skipped: {
2535
+ title: string;
2536
+ reason: string;
2537
+ }[];
2538
+ }
2539
+ export interface ExportKnowledgeInput {
2540
+ /** `confirmed` when omitted. */
2541
+ status?: KnowledgeStatusFilter;
2542
+ workspaceId?: string;
2543
+ }
2544
+ /** A JSON export: portable entries, with their scope named rather than numbered. */
2545
+ export interface KnowledgeExport {
2546
+ format: "deliverd-knowledge";
2547
+ version: 1;
2548
+ organisation: string;
2549
+ exportedAt: string;
2550
+ entries: {
2551
+ id?: string;
2552
+ kind: KnowledgeKind;
2553
+ title: string;
2554
+ body: string;
2555
+ tags: string[];
2556
+ status?: KnowledgeStatus;
2557
+ /** The workspace's name, or Organisation. */
2558
+ scope?: string | null;
2559
+ owner?: string | null;
2560
+ confirmedBy?: string | null;
2561
+ confirmedOn?: string | null;
2562
+ reviewDueOn?: string | null;
2563
+ source: KnowledgeSource;
2564
+ }[];
2565
+ }
2566
+ /** What a task and its side tasks were given, newest first. */
2567
+ export interface ContextGiven {
2568
+ at: string;
2569
+ to: string;
2570
+ via: "task_context" | "playbook_start";
2571
+ playbook: {
2572
+ id: string;
2573
+ title: string;
2574
+ version: number;
2575
+ } | null;
2576
+ knowledge: {
2577
+ id: string;
2578
+ title: string;
2579
+ status: KnowledgeStatus;
2580
+ confirmedBy: string | null;
2581
+ url: string;
2582
+ }[];
2583
+ }
2584
+ export type PlaybookStatus = "draft" | "awaiting_approval" | "not_approved" | "in_force" | "superseded" | "retired";
2585
+ /** What applies before a step's action: nothing, `check_gate`, `request_approval` or `request_review`. */
2586
+ export type PlaybookStepRule = "none" | "gate" | "approval" | "review";
2587
+ export interface PlaybookStep {
2588
+ key: string;
2589
+ title: string;
2590
+ instruction: string;
2591
+ rule: PlaybookStepRule;
2592
+ /** For a gate step: the action to check, such as `payments.send`. */
2593
+ action?: string | null;
2594
+ knowledgeIds: string[];
2595
+ }
2596
+ export interface PlaybookInput {
2597
+ name: string;
2598
+ description: string;
2599
+ required: boolean;
2600
+ }
2601
+ export interface PlaybookData {
2602
+ id: string;
2603
+ url: string;
2604
+ /** Every version of one playbook shares it. */
2605
+ familyId: string;
2606
+ version: number;
2607
+ status: PlaybookStatus;
2608
+ title: string;
2609
+ purpose: string;
2610
+ workspaceId: string | null;
2611
+ inputs: PlaybookInput[];
2612
+ steps: PlaybookStep[];
2613
+ knowledgeIds: string[];
2614
+ note: string | null;
2615
+ approval: {
2616
+ id: string;
2617
+ url: string;
2618
+ status: string;
2619
+ } | null;
2620
+ publishedAt: string | null;
2621
+ publishedBy: string | null;
2622
+ retiredAt: string | null;
2623
+ createdBy: string;
2624
+ createdAt: string;
2625
+ updatedAt: string;
2626
+ /** `procedure`: steps an agent runs. `prompt`: approved words people and agents use. */
2627
+ kind: PlaybookKind;
2628
+ /** An approved prompt's own fields; null on a procedure. */
2629
+ prompt: PromptFields | null;
2630
+ }
2631
+ export type PlaybookKind = "procedure" | "prompt";
2632
+ export interface PromptFields {
2633
+ /** The approved words, with `{input}` placeholders. */
2634
+ text: string;
2635
+ /** What it is not for, and how to check what it produces. */
2636
+ limitations: string | null;
2637
+ department: string | null;
2638
+ taskType: string | null;
2639
+ language: string | null;
2640
+ owner: string | null;
2641
+ ownerUserId: string | null;
2642
+ /** YYYY-MM-DD. */
2643
+ reviewDueOn: string | null;
2644
+ /** In force, and its review date has passed. */
2645
+ reviewOverdue: boolean;
2646
+ reviewedAt: string | null;
2647
+ reviewedBy: string | null;
2648
+ }
2649
+ /** A playbook's newest version, and which one is in force. */
2650
+ export interface PlaybookSummary extends PlaybookData {
2651
+ inForce: {
2652
+ id: string;
2653
+ version: number;
2654
+ url: string;
2655
+ } | null;
2656
+ }
2657
+ export interface PlaybookDetail extends PlaybookData {
2658
+ versions: {
2659
+ id: string;
2660
+ version: number;
2661
+ status: PlaybookStatus;
2662
+ url: string;
2663
+ }[];
2664
+ inForceId: string | null;
2665
+ knowledge: KnowledgeEntryData[];
2666
+ }
2667
+ export interface DraftPlaybookInput {
2668
+ /** The job, as people name it. */
2669
+ title: string;
2670
+ /** The outcome. Becomes the objective of every run; for a prompt, the one line people see. */
2671
+ purpose: string;
2672
+ /** Required for a playbook; left out for a prompt, which has one step of its own. */
2673
+ steps?: {
2674
+ key?: string;
2675
+ title: string;
2676
+ instruction: string;
2677
+ rule?: PlaybookStepRule;
2678
+ action?: string;
2679
+ knowledgeIds?: string[];
2680
+ }[];
2681
+ inputs?: {
2682
+ name: string;
2683
+ description?: string;
2684
+ required?: boolean;
2685
+ }[];
2686
+ knowledgeIds?: string[];
2687
+ workspaceId?: string;
2688
+ note?: string;
2689
+ /** Send instead of `steps` to draft an approved prompt. */
2690
+ prompt?: {
2691
+ /** The words, with each input as `{input name}`. */
2692
+ text: string;
2693
+ limitations?: string;
2694
+ department?: string;
2695
+ /** Such as Analyze, Create or Edit. */
2696
+ taskType?: string;
2697
+ /** Such as en-GB. */
2698
+ language?: string;
2699
+ /** The member who owns it; whoever drafts it when omitted. */
2700
+ ownerEmail?: string;
2701
+ /** YYYY-MM-DD; six months on when omitted. */
2702
+ reviewDueOn?: string;
2703
+ /** Run as a playbook, a person reviews the output before it is used. */
2704
+ checkOutput?: boolean;
2705
+ };
2706
+ }
2707
+ export interface UsePromptInput {
2708
+ /** The prompt's inputs, by name. A placeholder not given stays in the words. */
2709
+ inputs?: Record<string, string>;
2710
+ }
2711
+ export interface UsedPrompt {
2712
+ prompt: {
2713
+ id: string;
2714
+ title: string;
2715
+ version: number;
2716
+ url: string;
2717
+ };
2718
+ /** The approved words with the inputs put in. */
2719
+ text: string;
2720
+ /** Required inputs not given; their placeholders are still in `text`. */
2721
+ missingInputs: string[];
2722
+ limitations: string | null;
2723
+ /** True when you named an older version and the one in force was handed out instead. */
2724
+ ranOlderVersion: boolean;
2725
+ }
2726
+ export interface StartPlaybookInput {
2727
+ /** A name for this run; the playbook's title when omitted. */
2728
+ title?: string;
2729
+ inputs?: Record<string, string>;
2730
+ workspaceId?: string;
2731
+ flowId?: string;
2732
+ /** An open run you started under it comes back instead of a second. */
2733
+ externalId?: string;
2734
+ sessionUrl?: string;
2735
+ }
2736
+ export interface StartedPlaybook {
2737
+ objective: TaskData;
2738
+ resumed: boolean;
2739
+ playbook: {
2740
+ id: string;
2741
+ title: string;
2742
+ version: number;
2743
+ };
2744
+ /** One side task per step, in order. Empty when resumed. */
2745
+ steps: {
2746
+ key: string;
2747
+ taskId: string;
2748
+ title: string;
2749
+ rule: PlaybookStepRule;
2750
+ }[];
2751
+ /** True when you named an older version and the one in force ran instead. */
2752
+ ranOlderVersion: boolean;
2753
+ }
2754
+ export interface RequestPlaybookApprovalInput {
2755
+ /** Emails, names or groups; the organisation's administrators when omitted. */
2756
+ approvers?: string[];
2757
+ note?: string;
2374
2758
  }
2375
2759
  //# sourceMappingURL=types.d.ts.map