@deliverd/sdk 0.30.0 → 0.32.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/src/types.ts CHANGED
@@ -370,6 +370,8 @@ export interface ApprovalData {
370
370
  questions: ApprovalQuestion[];
371
371
  /** Which agent asked, as the request declared it. Null when it said nothing. Not verified. */
372
372
  agent: DeclaredAgent | null;
373
+ /** What your model or decision engine recommended, as sent. Null when you sent none. */
374
+ recommendation: ApprovalRecommendation | null;
373
375
  /** The model the request said the agent was running on. Not verified. */
374
376
  model: string | null;
375
377
  createdAt: string;
@@ -436,6 +438,35 @@ export interface CreateApprovalInput {
436
438
  * numbers and true/false. Omitted, it is approve or reject only.
437
439
  */
438
440
  editableFields?: string[];
441
+ /**
442
+ * What your model or decision engine recommends, shown to the approver as
443
+ * context, never as the decision. Where the organisation has blind review
444
+ * on, a high or critical risk request's recommendation is shown only after
445
+ * the approver records their own view.
446
+ */
447
+ recommendation?: ApprovalRecommendationInput;
448
+ }
449
+
450
+ /** A recommendation as you send it: a verdict, and as much of the rest as you have. */
451
+ export interface ApprovalRecommendationInput {
452
+ verdict: "approve" | "reject";
453
+ /** The recommendation in a line. */
454
+ summary?: string;
455
+ /** How sure it is, from 0 to 1. */
456
+ confidence?: number;
457
+ /** Why, as your system explains it. */
458
+ rationale?: string;
459
+ /** Which model or engine made it. */
460
+ source?: string;
461
+ }
462
+
463
+ /** A recommendation as the API returns it. */
464
+ export interface ApprovalRecommendation {
465
+ verdict: "approve" | "reject";
466
+ summary: string | null;
467
+ confidence: number | null;
468
+ rationale: string | null;
469
+ source: string | null;
439
470
  }
440
471
 
441
472
  /**
@@ -829,7 +860,11 @@ export interface WebhookEvent {
829
860
  * webhook, or a Discord embed with a link button for a channel webhook. The
830
861
  * signature headers are sent with all four.
831
862
  */
832
- export type WebhookEndpointFormat = "json" | "slack" | "teams" | "discord";
863
+ /**
864
+ * `workspace_studio` fires a Google Workspace Studio starter. The Deliverd
865
+ * add-on makes those, with `runAs`; you will see them in a list.
866
+ */
867
+ export type WebhookEndpointFormat = "json" | "slack" | "teams" | "discord" | "workspace_studio";
833
868
 
834
869
  /** An organisation's webhook endpoint, as `deliverd.webhookEndpoints` reads it. Never its secret. */
835
870
  export interface WebhookEndpoint {
@@ -878,6 +913,8 @@ export interface CreateWebhookEndpointInput {
878
913
  description?: string | null;
879
914
  /** Default `"json"`. */
880
915
  format?: WebhookEndpointFormat;
916
+ /** `workspace_studio` only: the Google address of the person whose flow the starter belongs to. */
917
+ runAs?: string;
881
918
  }
882
919
 
883
920
  /** Only what you send changes; send at least one. The secret cannot be changed. */
@@ -1717,7 +1754,7 @@ export interface SubmitEvidenceInput {
1717
1754
  /**
1718
1755
  * Read the results from the organisation's connected Langfuse, LangSmith,
1719
1756
  * Braintrust or Weave, with its key, which you never hold. Instead of `results` or `report`.
1720
- * Connected by an owner or an administrator in Admin → Integrations.
1757
+ * Connected by an owner or an administrator in Organisation → Integrations & webhooks.
1721
1758
  */
1722
1759
  pull?: EvidencePull;
1723
1760
  /** The release the results tested, with results, a report or a pull. Results of another release than the system runs now do not count. */