@happyrobot-ai/sdk 0.1.34 → 0.1.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyrobot-ai/sdk",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "TypeScript SDK for the HappyRobot Public API",
   "main": "./index.js",
   "module": "./index.mjs",

package/resources/audit-remarks.d.ts

@@ -2,15 +2,24 @@
  * Audit remark resource — client.auditRemarks.*
  *
  * Maps to:
+ *   GET    /audit-remarks/:audit_remark_id
+ *   GET    /workflows/:workflow_id/audits/remarks
  *   GET    /audit-remarks/:audit_remark_id/feedback
  *   POST   /audit-remarks/:audit_remark_id/feedback
  *   DELETE /audit-remarks/:audit_remark_id/feedback
  */
 import type { HttpClient } from "../core/http";
-import type { AuditRemarkFeedback, SubmitAuditRemarkFeedbackBody } from "../types/audit-remarks.types";
+import type { AuditRemarkDetail, AuditRemarkFeedback, ListWorkflowAuditRemarksQuery, ListWorkflowAuditRemarksResponse, SubmitAuditRemarkFeedbackBody } from "../types/audit-remarks.types";
 export declare class AuditRemarksResource {
     private readonly http;
     constructor(http: HttpClient);
+    /** Get a single behavioral audit remark by ID. */
+    get(auditRemarkId: string): Promise<AuditRemarkDetail>;
+    /**
+     * List audit remarks across all northstar criteria for a workflow.
+     * Cursor-paginated; optionally filter by northstar, grade, or status.
+     */
+    listByWorkflow(workflowId: string, query?: ListWorkflowAuditRemarksQuery): Promise<ListWorkflowAuditRemarksResponse>;
     /** Get the current user's feedback for an audit remark, or null if none exists. */
     getFeedback(auditRemarkId: string): Promise<AuditRemarkFeedback | null>;
     /** Submit a thumbs up/down for an audit remark. */

package/resources/audit-remarks.js

@@ -3,6 +3,8 @@
  * Audit remark resource — client.auditRemarks.*
  *
  * Maps to:
+ *   GET    /audit-remarks/:audit_remark_id
+ *   GET    /workflows/:workflow_id/audits/remarks
  *   GET    /audit-remarks/:audit_remark_id/feedback
  *   POST   /audit-remarks/:audit_remark_id/feedback
  *   DELETE /audit-remarks/:audit_remark_id/feedback
@@ -14,6 +16,24 @@ class AuditRemarksResource {
     constructor(http) {
         this.http = http;
     }
+    /** Get a single behavioral audit remark by ID. */
+    async get(auditRemarkId) {
+        return this.http.request({
+            method: "GET",
+            path: `/audit-remarks/${enc(auditRemarkId)}`,
+        });
+    }
+    /**
+     * List audit remarks across all northstar criteria for a workflow.
+     * Cursor-paginated; optionally filter by northstar, grade, or status.
+     */
+    async listByWorkflow(workflowId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/workflows/${enc(workflowId)}/audits/remarks`,
+            query: query,
+        });
+    }
     /** Get the current user's feedback for an audit remark, or null if none exists. */
     async getFeedback(auditRemarkId) {
         return this.http.request({

package/types/audit-remarks.types.d.ts

@@ -1,6 +1,69 @@
 /**
  * Audit remark types.
  */
+export type AuditRemarkGrade = "passed" | "failed" | "not_applicable";
+export type AuditRemarkStatus = "open" | "resolved" | "dismissed";
+export interface AuditRemarkMessage {
+    role: string;
+    content: string;
+}
+export interface AuditRemarkUserFeedback {
+    polarity: boolean;
+    issue_attribution: string | null;
+}
+/** A single behavioral audit remark with full detail. */
+export interface AuditRemarkDetail {
+    id: string;
+    run_id: string;
+    run_url: string;
+    timestamp: string;
+    updated_at: string;
+    grade: AuditRemarkGrade;
+    passed?: boolean | null;
+    status: AuditRemarkStatus;
+    category: string;
+    northstar_id: string;
+    northstar_name: string;
+    use_case_id: string;
+    node_id: string | null;
+    message_ids: string[];
+    messages: AuditRemarkMessage[];
+    correction: string | null;
+    correction_reason: string | null;
+    org_id: string;
+    user_feedback?: AuditRemarkUserFeedback | null;
+}
+/** A remark as returned by the workflow-wide listing (no use_case/node/category). */
+export interface WorkflowAuditRemark {
+    id: string;
+    run_id: string;
+    run_url: string;
+    timestamp: string;
+    grade: AuditRemarkGrade;
+    passed?: boolean | null;
+    status: AuditRemarkStatus;
+    northstar_id: string;
+    northstar_name: string;
+    message_ids: string[];
+    messages: AuditRemarkMessage[];
+    correction: string | null;
+    correction_reason: string | null;
+    org_id: string;
+    user_feedback?: AuditRemarkUserFeedback | null;
+}
+export interface ListWorkflowAuditRemarksQuery {
+    northstar_id?: string;
+    grade?: AuditRemarkGrade;
+    status?: AuditRemarkStatus;
+    cursor?: string;
+    /** 1–100, default 25. */
+    limit?: number;
+}
+export interface ListWorkflowAuditRemarksResponse {
+    data: WorkflowAuditRemark[];
+    next_cursor: string | null;
+    total: number;
+}
 export interface AuditRemarkFeedback {
     id: string;
     polarity: boolean;