@lunnoa/client 1.2.0 → 1.3.0

package/README.md

@@ -113,6 +113,8 @@ Most namespaces map to the Public API surface (`openapi.public.json`):
 
 `approvals` uses the authenticated **workspace** API (`/api/approvals/...`), not Public API v1. The inbox is filtered to requests where the current user is an eligible approver.
 
+`scorecards` also uses the workspace API (`/api/scorecards/...`): `list`, `get`, and `recordValue(measureId, { value, period?, note? })` to push a measure value from your own system (API key needs `scorecard:record`).
+
 Errors are `LunnoaApiError` with `status`, `body`, and convenience flags (`isUnauthorized`, `isForbidden`, `isRateLimited`). Paginated lists have async iteration (`entities.iterate(...)`, `queueItems.iterate(...)`).
 
 ## Worked examples

package/dist/cli.js

@@ -430,10 +430,7 @@ var AgentChatClient = class {
         raw: true,
         signal: options.signal,
         headers: { Accept: "text/event-stream" },
-        body: {
-          messages: [uiMessage],
-          ...options.chatMode ? { chatMode: options.chatMode } : {}
-        }
+        body: messageTaskBody(uiMessage, options)
       }
     );
     return new AgentChatStream(response, { signal: options.signal });
@@ -472,6 +469,14 @@ var AgentChatClient = class {
     );
   }
 };
+function messageTaskBody(message, options = {}) {
+  return {
+    messages: [message],
+    ...options.chatMode ? { chatMode: options.chatMode } : {},
+    ...options.data ? { data: options.data } : {},
+    ...options.piiResolution ? { piiResolution: options.piiResolution } : {}
+  };
+}
 function generateMessageId() {
   const cryptoObj = globalThis.crypto;
   if (cryptoObj?.randomUUID) {
@@ -1005,7 +1010,6 @@ var EntitiesResource = class {
       objectTypeSlug: options.objectTypeSlug,
       state: options.state,
       states: options.states?.join(","),
-      ownerId: options.ownerId,
       search: options.search,
       sortBy: options.sortBy,
       sortOrder: options.sortOrder,
@@ -1601,10 +1605,11 @@ var QueueItemsResource = class {
   listRetryable(queueId) {
     return this.http.get(`/api/queues/${queueId}/items/retry`);
   }
-  /** Returns items with the given status. */
-  listByStatus(queueId, status) {
+  /** Returns a page of items with the given status. */
+  listByStatus(queueId, status, options = {}) {
     return this.http.get(
-      `/api/queues/${queueId}/items/status/${status}`
+      `/api/queues/${queueId}/items/status/${status}`,
+      { query: { limit: options.limit, offset: options.offset } }
     );
   }
   /** Looks an item up by the external ID your system supplied. */
@@ -1613,11 +1618,22 @@ var QueueItemsResource = class {
       `/api/queues/${queueId}/items/external/${externalId}`
     );
   }
-  /** Searches items in the queue. */
-  search(queueId, query) {
-    return this.http.get(`/api/queues/${queueId}/items/search`, {
-      query: { q: query }
-    });
+  /**
+   * Searches items by external id, item data, and metadata.
+   * Returns one page, same shape as `list`.
+   */
+  search(queueId, query, options = {}) {
+    return this.http.get(
+      `/api/queues/${queueId}/items/search`,
+      {
+        query: {
+          limit: options.limit,
+          offset: options.offset,
+          expansion: serializeCsv(options.expansion),
+          filterBy: serializeFilterBy({ search: query })
+        }
+      }
+    );
   }
   /** Returns per-status and per-priority counts for the queue. */
   stats(queueId) {
@@ -1653,10 +1669,21 @@ var QueueItemsResource = class {
   addError(queueId, itemId, error) {
     return this.http.post(
       `/api/queues/${queueId}/items/${itemId}/error`,
-      { body: error }
+      {
+        body: {
+          error: error.error,
+          errorDetails: serializeErrorDetails(error.errorDetails)
+        }
+      }
     );
   }
 };
+function serializeErrorDetails(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
 
 // src/resources/queues.ts
 var QueuesResource = class {
@@ -1783,6 +1810,32 @@ var RunsResource = class {
   }
 };
 
+// src/resources/scorecards.ts
+var ScorecardsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Lists scorecards in the workspace. */
+  list() {
+    return this.http.get("/api/scorecards");
+  }
+  /** Returns a scorecard with objectives, measures, latest values and status. */
+  get(scorecardId) {
+    return this.http.get(`/api/scorecards/${scorecardId}`);
+  }
+  /**
+   * Records a measure value. A value for the same period replaces the current
+   * one; the old value is kept as superseded history.
+   */
+  recordValue(measureId, data) {
+    return this.http.post(
+      `/api/scorecards/measures/${measureId}/values`,
+      { body: data }
+    );
+  }
+};
+
 // src/resources/tasks.ts
 var TasksResource = class {
   constructor(http) {
@@ -1833,12 +1886,7 @@ var TasksResource = class {
     } : message;
     return this.http.post(
       `/api/agents/${agentId}/tasks/${taskId}/message`,
-      {
-        body: {
-          messages: [uiMessage],
-          ...options.chatMode ? { chatMode: options.chatMode } : {}
-        }
-      }
+      { body: messageTaskBody(uiMessage, options) }
     );
   }
 };
@@ -2021,6 +2069,7 @@ var LunnoaClient = class {
   queues;
   queueItems;
   variables;
+  scorecards;
   connections;
   projects;
   workflowApps;
@@ -2043,6 +2092,7 @@ var LunnoaClient = class {
     this.queues = new QueuesResource(this.http);
     this.queueItems = new QueueItemsResource(this.http);
     this.variables = new VariablesResource(this.http);
+    this.scorecards = new ScorecardsResource(this.http);
     this.connections = new ConnectionsResource(this.http);
     this.projects = new ProjectsResource(this.http);
     this.discovery = new DiscoveryResource(this.http);
@@ -2831,7 +2881,7 @@ function generateDeploymentModule(definitions) {
  *
  * Schema fingerprint: ${schemaFingerprint}
  */
-import type { LunnoaClient, Entity, Execution, ExecuteWorkflowResult, PaginatedEntities, Task, AgentChatStream, WaitUntilFinishedOptions, ListEntitiesOptions, UIMessage } from '@lunnoa/client';
+import type { LunnoaClient, Entity, Execution, ExecuteWorkflowResult, PaginatedEntities, Task, AgentChatStream, WaitUntilFinishedOptions, ListEntitiesOptions, StreamMessageOptions, UIMessage } from '@lunnoa/client';
 
 /** Fingerprint of entity-type schemas at codegen time (slug:revision:allowUnknown). */
 export const DEPLOYMENT_SCHEMA_FINGERPRINT = ${JSON.stringify(schemaFingerprint)};
@@ -3019,7 +3069,7 @@ function typedEntityAccessor<A, S extends string>(
       })) as Typed;
     },
     /** Creates an entity of this type with compile-time checked attributes. */
-    async create(data: { name: string; attributes?: A; state?: S; ownerId?: string }): Promise<Typed> {
+    async create(data: { name: string; attributes?: A; state?: S }): Promise<Typed> {
       return (await client.entities.create(
         { ...data, objectTypeId } as never,
         { expansion: ['attributes'] },
@@ -3028,7 +3078,7 @@ function typedEntityAccessor<A, S extends string>(
     /** Partially updates an entity of this type. */
     async update(
       entityId: string,
-      data: { name?: string; attributes?: Partial<A>; ownerId?: string },
+      data: { name?: string; attributes?: Partial<A> },
     ): Promise<Typed> {
       return (await client.entities.update(entityId, data as never, {
         expansion: ['attributes'],
@@ -3074,13 +3124,17 @@ function typedAgentAccessor(client: LunnoaClient, agentId: string) {
     streamMessage(
       taskId: string,
       message: string | UIMessage,
-      options?: { chatMode?: 'builder' | 'preview'; signal?: AbortSignal },
+      options?: StreamMessageOptions,
     ): Promise<AgentChatStream> {
       return client.agentChat.streamMessage(agentId, taskId, message, options);
     },
     /** Sends a message and waits for the full turn (non-streaming). */
-    message(taskId: string, message: string | UIMessage) {
-      return client.tasks.message(agentId, taskId, message);
+    message(
+      taskId: string,
+      message: string | UIMessage,
+      options?: Omit<StreamMessageOptions, 'signal'>,
+    ) {
+      return client.tasks.message(agentId, taskId, message, options);
     },
   };
 }

package/dist/index.cjs

@@ -426,10 +426,7 @@ var AgentChatClient = class {
         raw: true,
         signal: options.signal,
         headers: { Accept: "text/event-stream" },
-        body: {
-          messages: [uiMessage],
-          ...options.chatMode ? { chatMode: options.chatMode } : {}
-        }
+        body: messageTaskBody(uiMessage, options)
       }
     );
     return new AgentChatStream(response, { signal: options.signal });
@@ -468,6 +465,14 @@ var AgentChatClient = class {
     );
   }
 };
+function messageTaskBody(message, options = {}) {
+  return {
+    messages: [message],
+    ...options.chatMode ? { chatMode: options.chatMode } : {},
+    ...options.data ? { data: options.data } : {},
+    ...options.piiResolution ? { piiResolution: options.piiResolution } : {}
+  };
+}
 function generateMessageId() {
   const cryptoObj = globalThis.crypto;
   if (cryptoObj?.randomUUID) {
@@ -1047,7 +1052,6 @@ var EntitiesResource = class {
       objectTypeSlug: options.objectTypeSlug,
       state: options.state,
       states: options.states?.join(","),
-      ownerId: options.ownerId,
       search: options.search,
       sortBy: options.sortBy,
       sortOrder: options.sortOrder,
@@ -1643,10 +1647,11 @@ var QueueItemsResource = class {
   listRetryable(queueId) {
     return this.http.get(`/api/queues/${queueId}/items/retry`);
   }
-  /** Returns items with the given status. */
-  listByStatus(queueId, status) {
+  /** Returns a page of items with the given status. */
+  listByStatus(queueId, status, options = {}) {
     return this.http.get(
-      `/api/queues/${queueId}/items/status/${status}`
+      `/api/queues/${queueId}/items/status/${status}`,
+      { query: { limit: options.limit, offset: options.offset } }
     );
   }
   /** Looks an item up by the external ID your system supplied. */
@@ -1655,11 +1660,22 @@ var QueueItemsResource = class {
       `/api/queues/${queueId}/items/external/${externalId}`
     );
   }
-  /** Searches items in the queue. */
-  search(queueId, query) {
-    return this.http.get(`/api/queues/${queueId}/items/search`, {
-      query: { q: query }
-    });
+  /**
+   * Searches items by external id, item data, and metadata.
+   * Returns one page, same shape as `list`.
+   */
+  search(queueId, query, options = {}) {
+    return this.http.get(
+      `/api/queues/${queueId}/items/search`,
+      {
+        query: {
+          limit: options.limit,
+          offset: options.offset,
+          expansion: serializeCsv(options.expansion),
+          filterBy: serializeFilterBy({ search: query })
+        }
+      }
+    );
   }
   /** Returns per-status and per-priority counts for the queue. */
   stats(queueId) {
@@ -1695,10 +1711,21 @@ var QueueItemsResource = class {
   addError(queueId, itemId, error) {
     return this.http.post(
       `/api/queues/${queueId}/items/${itemId}/error`,
-      { body: error }
+      {
+        body: {
+          error: error.error,
+          errorDetails: serializeErrorDetails(error.errorDetails)
+        }
+      }
     );
   }
 };
+function serializeErrorDetails(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return typeof value === "string" ? value : JSON.stringify(value);
+}
 
 // src/resources/queues.ts
 var QueuesResource = class {
@@ -1825,6 +1852,32 @@ var RunsResource = class {
   }
 };
 
+// src/resources/scorecards.ts
+var ScorecardsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** Lists scorecards in the workspace. */
+  list() {
+    return this.http.get("/api/scorecards");
+  }
+  /** Returns a scorecard with objectives, measures, latest values and status. */
+  get(scorecardId) {
+    return this.http.get(`/api/scorecards/${scorecardId}`);
+  }
+  /**
+   * Records a measure value. A value for the same period replaces the current
+   * one; the old value is kept as superseded history.
+   */
+  recordValue(measureId, data) {
+    return this.http.post(
+      `/api/scorecards/measures/${measureId}/values`,
+      { body: data }
+    );
+  }
+};
+
 // src/resources/tasks.ts
 var TasksResource = class {
   constructor(http) {
@@ -1875,12 +1928,7 @@ var TasksResource = class {
     } : message;
     return this.http.post(
       `/api/agents/${agentId}/tasks/${taskId}/message`,
-      {
-        body: {
-          messages: [uiMessage],
-          ...options.chatMode ? { chatMode: options.chatMode } : {}
-        }
-      }
+      { body: messageTaskBody(uiMessage, options) }
     );
   }
 };
@@ -2063,6 +2111,7 @@ var LunnoaClient = class {
   queues;
   queueItems;
   variables;
+  scorecards;
   connections;
   projects;
   workflowApps;
@@ -2085,6 +2134,7 @@ var LunnoaClient = class {
     this.queues = new QueuesResource(this.http);
     this.queueItems = new QueueItemsResource(this.http);
     this.variables = new VariablesResource(this.http);
+    this.scorecards = new ScorecardsResource(this.http);
     this.connections = new ConnectionsResource(this.http);
     this.projects = new ProjectsResource(this.http);
     this.discovery = new DiscoveryResource(this.http);
@@ -2186,6 +2236,7 @@ exports.ProjectsResource = ProjectsResource;
 exports.QueueItemsResource = QueueItemsResource;
 exports.QueuesResource = QueuesResource;
 exports.RunsResource = RunsResource;
+exports.ScorecardsResource = ScorecardsResource;
 exports.SsoAuthResource = SsoAuthResource;
 exports.TasksResource = TasksResource;
 exports.VariablesResource = VariablesResource;