@lunnoa/client 1.1.0 → 1.3.0

package/dist/react.d.cts

@@ -109,6 +109,15 @@ type ChatMode = 'builder' | 'preview';
 interface StreamMessageOptions {
     /** Agent chat mode; defaults to the server default (`builder`). */
     chatMode?: ChatMode;
+    /** Optional image attachment forwarded with this turn. */
+    data?: {
+        imageUrl?: string;
+    };
+    /**
+     * Answer to an ask-before-sending personal-data prompt.
+     * Applies to this message only.
+     */
+    piiResolution?: 'anonymize' | 'fallback';
     /** Abort the stream (closes the HTTP connection; the run keeps going server-side — call `stop` to cancel it). */
     signal?: AbortSignal;
 }
@@ -227,8 +236,6 @@ interface components {
             SKILLS: boolean;
             /** @description Whether the hexagonal agent builder canvas UI is enabled. */
             AGENT_BUILDER_CANVAS: boolean;
-            /** @description Whether the Solution Designer UI is enabled. */
-            SOLUTION_DESIGNER: boolean;
             /** @description Whether isolated code execution for agents is enabled. */
             CODE_EXECUTION: boolean;
             /** @description Whether SSO (OIDC) login is enabled. Requires at least one enabled SSO provider. */
@@ -849,9 +856,7 @@ interface components {
             /** @description Error message to record against the queue item. */
             error: string;
             /** @description Additional structured error details, supplied as a JSON string. */
-            errorDetails?: {
-                [key: string]: unknown;
-            };
+            errorDetails?: string;
         };
         BulkDeleteItemsDto: {
             /** @description IDs of the queue items to delete. */
@@ -1086,11 +1091,6 @@ interface components {
             attributes?: {
                 [key: string]: unknown;
             };
-            /**
-             * Format: uuid
-             * @description Workspace user ID of the entity owner.
-             */
-            ownerId?: string;
         };
         ObjectTypeSummaryDto: {
             /** @description Entity type ID. */
@@ -1206,8 +1206,6 @@ interface components {
             attributes?: {
                 [key: string]: unknown;
             };
-            /** @description Workspace user ID of the new entity owner. */
-            ownerId?: string;
         };
         ChangeObjectStateDto: {
             /** @description ID of the target state. Must be a valid transition from the current state when the entity type defines transitions. */
@@ -1991,7 +1989,7 @@ interface components {
             approvalStatus?: "pending" | "partially_approved" | "approved" | "rejected" | "expired";
             /** @description Number of approve decisions received so far */
             approvalsReceived?: number;
-            /** @description Number of approvals required for quorum / current stage */
+            /** @description How many approvals are required before the workflow continues */
             approvalsRequired?: number;
         };
         PendingInputFieldDto: {
@@ -2369,11 +2367,15 @@ interface components {
              *       "imageUrl": "https://example.com/image.png"
              *     }
              */
-            data?: Record<string, never>;
-            /** @description Solution Designer handoff */
-            solutionId?: string;
-            planStepId?: string;
-            delegationId?: string;
+            data?: {
+                /** @description URL of an image attached to the message. */
+                imageUrl?: string;
+            };
+            /**
+             * @description Answer to an ask-before-sending personal-data prompt. Applies to this message only.
+             * @enum {string}
+             */
+            piiResolution?: "anonymize" | "fallback";
         };
         StreamMessageStopDto: {
             /** @description Partial assistant message to persist when stopping a stream */
@@ -2969,8 +2971,6 @@ interface ListEntitiesOptions {
     state?: string;
     /** Filter by several states (comma-separated server-side). */
     states?: string[];
-    /** Filter by owner workspace-user ID. */
-    ownerId?: string;
     /** Free-text search over entity names. */
     search?: string;
     sortBy?: string;
@@ -3002,7 +3002,6 @@ interface ExportEntitiesInput {
         value: unknown;
     }>;
     format?: 'csv' | 'xlsx';
-    includeRelatedEntityNames?: boolean;
 }
 /**
  * Entities (the platform calls them Objects internally): the structured data
@@ -3108,7 +3107,6 @@ type ApprovalInboxItem = {
     status: string;
     requiredCount: number;
     receivedApprovals: number;
-    currentStageIndex?: number;
     expiresAt?: string;
     createdAt?: string;
     updatedAt?: string;
@@ -3127,7 +3125,7 @@ type ApprovalInboxItem = {
         comment?: string;
         decidedAt?: string;
     };
-    /** People who can still decide (current stage; emails resolved). */
+    /** People who can still decide. */
     eligibleApprovers?: EligibleApprover[];
     approval?: Record<string, unknown>;
 };
@@ -3196,6 +3194,16 @@ declare class ProjectsResource {
     create(data: CreateProjectInput): Promise<Project>;
 }
 
+type QueueItemStatus = 'PENDING' | 'PROCESSING' | 'SUCCESS' | 'FAILED' | 'RETRYING';
+interface AddQueueItemErrorInput {
+    /** Error message recorded on the item. */
+    error: string;
+    /**
+     * Extra details. An object is sent as a JSON string, which is what the
+     * server validates.
+     */
+    errorDetails?: string | Record<string, unknown>;
+}
 interface ListQueueItemsOptions {
     limit?: number;
     offset?: number;
@@ -3241,12 +3249,18 @@ declare class QueueItemsResource {
     }): Promise<QueueItem[]>;
     /** Returns items eligible for retry. */
     listRetryable(queueId: string): Promise<QueueItem[]>;
-    /** Returns items with the given status. */
-    listByStatus(queueId: string, status: string): Promise<QueueItem[]>;
+    /** Returns a page of items with the given status. */
+    listByStatus(queueId: string, status: QueueItemStatus, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<QueueItemList>;
     /** Looks an item up by the external ID your system supplied. */
     getByExternalId(queueId: string, externalId: string): Promise<QueueItemFull>;
-    /** Searches items in the queue. */
-    search(queueId: string, query: string): Promise<QueueItem[]>;
+    /**
+     * Searches items by external id, item data, and metadata.
+     * Returns one page, same shape as `list`.
+     */
+    search(queueId: string, query: string, options?: Omit<ListQueueItemsOptions, 'filterBy'>): Promise<QueueItemList>;
     /** Returns per-status and per-priority counts for the queue. */
     stats(queueId: string): Promise<QueueItemStats>;
     /** Returns the recorded processing errors of an item. */
@@ -3258,10 +3272,7 @@ declare class QueueItemsResource {
     /** Queues the item for another processing attempt. */
     retry(queueId: string, itemId: string): Promise<QueueItem>;
     /** Records a processing error on the item. */
-    addError(queueId: string, itemId: string, error: {
-        message: string;
-        [key: string]: unknown;
-    }): Promise<QueueItem>;
+    addError(queueId: string, itemId: string, error: AddQueueItemErrorInput): Promise<QueueItem>;
 }
 
 declare class QueuesResource {
@@ -3318,6 +3329,91 @@ declare class RunsResource {
     startAndWait(input: StartRunInput, waitOptions?: WaitUntilFinishedOptions): Promise<Execution>;
 }
 
+type ScorecardMeasureStatus = 'ON_TRACK' | 'AT_RISK' | 'OFF_TRACK' | 'NO_DATA';
+type ScorecardSummary = {
+    id: string;
+    name: string;
+    periodLabel: string | null;
+    description: string | null;
+    FK_ownerId: string | null;
+    createdAt: string;
+    _count: {
+        objectives: number;
+    };
+};
+type ScorecardMeasure = {
+    id: string;
+    name: string;
+    unit: string;
+    currency: string | null;
+    direction: 'HIGHER_IS_BETTER' | 'LOWER_IS_BETTER';
+    kind: 'LEADING' | 'LAGGING';
+    cadence: 'DAILY' | 'WEEKLY' | 'MONTHLY';
+    sourceType: 'MANUAL' | 'API' | 'WORKFLOW' | 'BUILT_IN';
+    builtInKey: string | null;
+    target: number;
+    atRiskThreshold: number | null;
+    latest: {
+        value: number;
+        periodStart: string;
+        createdAt: string;
+    } | null;
+    previousValue: number | null;
+    series: {
+        periodStart: string;
+        value: number;
+    }[];
+    status: ScorecardMeasureStatus;
+    stale: boolean;
+};
+type ScorecardObjective = {
+    id: string;
+    perspective: 'FINANCIAL' | 'CUSTOMER' | 'PROCESS' | 'LEARNING';
+    name: string;
+    description: string | null;
+    ownerLabel: string | null;
+    drivesIds: string[];
+    position: number;
+    status: ScorecardMeasureStatus;
+    measures: ScorecardMeasure[];
+};
+type Scorecard = Omit<ScorecardSummary, '_count'> & {
+    aiSpendUsdThisMonth: number;
+    objectives: ScorecardObjective[];
+};
+type ScorecardMeasureValue = {
+    id: string;
+    FK_measureId: string;
+    periodStart: string;
+    value: number;
+    note: string | null;
+    sourceType: ScorecardMeasure['sourceType'];
+    supersededAt: string | null;
+    createdAt: string;
+};
+type RecordMeasureValueInput = {
+    value: number;
+    /** Any ISO date inside the target period; defaults to the current period. */
+    period?: string;
+    note?: string;
+};
+/**
+ * Balanced Scorecard (workspace API). Pushing values needs `scorecard:record`.
+ */
+declare class ScorecardsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Lists scorecards in the workspace. */
+    list(): Promise<ScorecardSummary[]>;
+    /** Returns a scorecard with objectives, measures, latest values and status. */
+    get(scorecardId: string): Promise<Scorecard>;
+    /**
+     * Records a measure value. A value for the same period replaces the current
+     * one; the old value is kept as superseded history.
+     */
+    recordValue(measureId: string, data: RecordMeasureValueInput): Promise<ScorecardMeasureValue>;
+}
+
 declare class TasksResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3337,9 +3433,7 @@ declare class TasksResource {
      * messages in AI SDK UIMessage format. For token-by-token output use
      * `client.agentChat.streamMessage` instead.
      */
-    message(agentId: string, taskId: string, message: string | UIMessage, options?: {
-        chatMode?: ChatMode;
-    }): Promise<string | UIMessage[]>;
+    message(agentId: string, taskId: string, message: string | UIMessage, options?: Omit<StreamMessageOptions, 'signal'>): Promise<string | UIMessage[]>;
 }
 
 declare class VariablesResource {
@@ -3455,6 +3549,7 @@ declare class LunnoaClient {
     readonly queues: QueuesResource;
     readonly queueItems: QueueItemsResource;
     readonly variables: VariablesResource;
+    readonly scorecards: ScorecardsResource;
     readonly connections: ConnectionsResource;
     readonly projects: ProjectsResource;
     readonly workflowApps: WorkflowAppsResource;

package/dist/react.d.ts

@@ -109,6 +109,15 @@ type ChatMode = 'builder' | 'preview';
 interface StreamMessageOptions {
     /** Agent chat mode; defaults to the server default (`builder`). */
     chatMode?: ChatMode;
+    /** Optional image attachment forwarded with this turn. */
+    data?: {
+        imageUrl?: string;
+    };
+    /**
+     * Answer to an ask-before-sending personal-data prompt.
+     * Applies to this message only.
+     */
+    piiResolution?: 'anonymize' | 'fallback';
     /** Abort the stream (closes the HTTP connection; the run keeps going server-side — call `stop` to cancel it). */
     signal?: AbortSignal;
 }
@@ -227,8 +236,6 @@ interface components {
             SKILLS: boolean;
             /** @description Whether the hexagonal agent builder canvas UI is enabled. */
             AGENT_BUILDER_CANVAS: boolean;
-            /** @description Whether the Solution Designer UI is enabled. */
-            SOLUTION_DESIGNER: boolean;
             /** @description Whether isolated code execution for agents is enabled. */
             CODE_EXECUTION: boolean;
             /** @description Whether SSO (OIDC) login is enabled. Requires at least one enabled SSO provider. */
@@ -849,9 +856,7 @@ interface components {
             /** @description Error message to record against the queue item. */
             error: string;
             /** @description Additional structured error details, supplied as a JSON string. */
-            errorDetails?: {
-                [key: string]: unknown;
-            };
+            errorDetails?: string;
         };
         BulkDeleteItemsDto: {
             /** @description IDs of the queue items to delete. */
@@ -1086,11 +1091,6 @@ interface components {
             attributes?: {
                 [key: string]: unknown;
             };
-            /**
-             * Format: uuid
-             * @description Workspace user ID of the entity owner.
-             */
-            ownerId?: string;
         };
         ObjectTypeSummaryDto: {
             /** @description Entity type ID. */
@@ -1206,8 +1206,6 @@ interface components {
             attributes?: {
                 [key: string]: unknown;
             };
-            /** @description Workspace user ID of the new entity owner. */
-            ownerId?: string;
         };
         ChangeObjectStateDto: {
             /** @description ID of the target state. Must be a valid transition from the current state when the entity type defines transitions. */
@@ -1991,7 +1989,7 @@ interface components {
             approvalStatus?: "pending" | "partially_approved" | "approved" | "rejected" | "expired";
             /** @description Number of approve decisions received so far */
             approvalsReceived?: number;
-            /** @description Number of approvals required for quorum / current stage */
+            /** @description How many approvals are required before the workflow continues */
             approvalsRequired?: number;
         };
         PendingInputFieldDto: {
@@ -2369,11 +2367,15 @@ interface components {
              *       "imageUrl": "https://example.com/image.png"
              *     }
              */
-            data?: Record<string, never>;
-            /** @description Solution Designer handoff */
-            solutionId?: string;
-            planStepId?: string;
-            delegationId?: string;
+            data?: {
+                /** @description URL of an image attached to the message. */
+                imageUrl?: string;
+            };
+            /**
+             * @description Answer to an ask-before-sending personal-data prompt. Applies to this message only.
+             * @enum {string}
+             */
+            piiResolution?: "anonymize" | "fallback";
         };
         StreamMessageStopDto: {
             /** @description Partial assistant message to persist when stopping a stream */
@@ -2969,8 +2971,6 @@ interface ListEntitiesOptions {
     state?: string;
     /** Filter by several states (comma-separated server-side). */
     states?: string[];
-    /** Filter by owner workspace-user ID. */
-    ownerId?: string;
     /** Free-text search over entity names. */
     search?: string;
     sortBy?: string;
@@ -3002,7 +3002,6 @@ interface ExportEntitiesInput {
         value: unknown;
     }>;
     format?: 'csv' | 'xlsx';
-    includeRelatedEntityNames?: boolean;
 }
 /**
  * Entities (the platform calls them Objects internally): the structured data
@@ -3108,7 +3107,6 @@ type ApprovalInboxItem = {
     status: string;
     requiredCount: number;
     receivedApprovals: number;
-    currentStageIndex?: number;
     expiresAt?: string;
     createdAt?: string;
     updatedAt?: string;
@@ -3127,7 +3125,7 @@ type ApprovalInboxItem = {
         comment?: string;
         decidedAt?: string;
     };
-    /** People who can still decide (current stage; emails resolved). */
+    /** People who can still decide. */
     eligibleApprovers?: EligibleApprover[];
     approval?: Record<string, unknown>;
 };
@@ -3196,6 +3194,16 @@ declare class ProjectsResource {
     create(data: CreateProjectInput): Promise<Project>;
 }
 
+type QueueItemStatus = 'PENDING' | 'PROCESSING' | 'SUCCESS' | 'FAILED' | 'RETRYING';
+interface AddQueueItemErrorInput {
+    /** Error message recorded on the item. */
+    error: string;
+    /**
+     * Extra details. An object is sent as a JSON string, which is what the
+     * server validates.
+     */
+    errorDetails?: string | Record<string, unknown>;
+}
 interface ListQueueItemsOptions {
     limit?: number;
     offset?: number;
@@ -3241,12 +3249,18 @@ declare class QueueItemsResource {
     }): Promise<QueueItem[]>;
     /** Returns items eligible for retry. */
     listRetryable(queueId: string): Promise<QueueItem[]>;
-    /** Returns items with the given status. */
-    listByStatus(queueId: string, status: string): Promise<QueueItem[]>;
+    /** Returns a page of items with the given status. */
+    listByStatus(queueId: string, status: QueueItemStatus, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<QueueItemList>;
     /** Looks an item up by the external ID your system supplied. */
     getByExternalId(queueId: string, externalId: string): Promise<QueueItemFull>;
-    /** Searches items in the queue. */
-    search(queueId: string, query: string): Promise<QueueItem[]>;
+    /**
+     * Searches items by external id, item data, and metadata.
+     * Returns one page, same shape as `list`.
+     */
+    search(queueId: string, query: string, options?: Omit<ListQueueItemsOptions, 'filterBy'>): Promise<QueueItemList>;
     /** Returns per-status and per-priority counts for the queue. */
     stats(queueId: string): Promise<QueueItemStats>;
     /** Returns the recorded processing errors of an item. */
@@ -3258,10 +3272,7 @@ declare class QueueItemsResource {
     /** Queues the item for another processing attempt. */
     retry(queueId: string, itemId: string): Promise<QueueItem>;
     /** Records a processing error on the item. */
-    addError(queueId: string, itemId: string, error: {
-        message: string;
-        [key: string]: unknown;
-    }): Promise<QueueItem>;
+    addError(queueId: string, itemId: string, error: AddQueueItemErrorInput): Promise<QueueItem>;
 }
 
 declare class QueuesResource {
@@ -3318,6 +3329,91 @@ declare class RunsResource {
     startAndWait(input: StartRunInput, waitOptions?: WaitUntilFinishedOptions): Promise<Execution>;
 }
 
+type ScorecardMeasureStatus = 'ON_TRACK' | 'AT_RISK' | 'OFF_TRACK' | 'NO_DATA';
+type ScorecardSummary = {
+    id: string;
+    name: string;
+    periodLabel: string | null;
+    description: string | null;
+    FK_ownerId: string | null;
+    createdAt: string;
+    _count: {
+        objectives: number;
+    };
+};
+type ScorecardMeasure = {
+    id: string;
+    name: string;
+    unit: string;
+    currency: string | null;
+    direction: 'HIGHER_IS_BETTER' | 'LOWER_IS_BETTER';
+    kind: 'LEADING' | 'LAGGING';
+    cadence: 'DAILY' | 'WEEKLY' | 'MONTHLY';
+    sourceType: 'MANUAL' | 'API' | 'WORKFLOW' | 'BUILT_IN';
+    builtInKey: string | null;
+    target: number;
+    atRiskThreshold: number | null;
+    latest: {
+        value: number;
+        periodStart: string;
+        createdAt: string;
+    } | null;
+    previousValue: number | null;
+    series: {
+        periodStart: string;
+        value: number;
+    }[];
+    status: ScorecardMeasureStatus;
+    stale: boolean;
+};
+type ScorecardObjective = {
+    id: string;
+    perspective: 'FINANCIAL' | 'CUSTOMER' | 'PROCESS' | 'LEARNING';
+    name: string;
+    description: string | null;
+    ownerLabel: string | null;
+    drivesIds: string[];
+    position: number;
+    status: ScorecardMeasureStatus;
+    measures: ScorecardMeasure[];
+};
+type Scorecard = Omit<ScorecardSummary, '_count'> & {
+    aiSpendUsdThisMonth: number;
+    objectives: ScorecardObjective[];
+};
+type ScorecardMeasureValue = {
+    id: string;
+    FK_measureId: string;
+    periodStart: string;
+    value: number;
+    note: string | null;
+    sourceType: ScorecardMeasure['sourceType'];
+    supersededAt: string | null;
+    createdAt: string;
+};
+type RecordMeasureValueInput = {
+    value: number;
+    /** Any ISO date inside the target period; defaults to the current period. */
+    period?: string;
+    note?: string;
+};
+/**
+ * Balanced Scorecard (workspace API). Pushing values needs `scorecard:record`.
+ */
+declare class ScorecardsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Lists scorecards in the workspace. */
+    list(): Promise<ScorecardSummary[]>;
+    /** Returns a scorecard with objectives, measures, latest values and status. */
+    get(scorecardId: string): Promise<Scorecard>;
+    /**
+     * Records a measure value. A value for the same period replaces the current
+     * one; the old value is kept as superseded history.
+     */
+    recordValue(measureId: string, data: RecordMeasureValueInput): Promise<ScorecardMeasureValue>;
+}
+
 declare class TasksResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -3337,9 +3433,7 @@ declare class TasksResource {
      * messages in AI SDK UIMessage format. For token-by-token output use
      * `client.agentChat.streamMessage` instead.
      */
-    message(agentId: string, taskId: string, message: string | UIMessage, options?: {
-        chatMode?: ChatMode;
-    }): Promise<string | UIMessage[]>;
+    message(agentId: string, taskId: string, message: string | UIMessage, options?: Omit<StreamMessageOptions, 'signal'>): Promise<string | UIMessage[]>;
 }
 
 declare class VariablesResource {
@@ -3455,6 +3549,7 @@ declare class LunnoaClient {
     readonly queues: QueuesResource;
     readonly queueItems: QueueItemsResource;
     readonly variables: VariablesResource;
+    readonly scorecards: ScorecardsResource;
     readonly connections: ConnectionsResource;
     readonly projects: ProjectsResource;
     readonly workflowApps: WorkflowAppsResource;