@dudousxd/nestjs-agent-core 0.28.0 → 0.30.0

package/dist/{processors-Bhn6ehMM.d.ts → processors-8c9g9J6R.d.ts}

@@ -1,4 +1,4 @@
-import { M as ModelMessage, A as Actor, d as ToolCallRequest } from './tool-BJ5jVoH2.js';
+import { M as ModelMessage, A as Actor, d as ToolCallRequest } from './tool-CfnSyIQf.js';
 
 /**
  * The two seams that see a turn's traffic to and from the model: an {@link InputProcessor} rewrites

package/dist/{processors-nr6jwLAh.d.cts → processors-DdwZ0NFG.d.cts}

@@ -1,4 +1,4 @@
-import { M as ModelMessage, A as Actor, d as ToolCallRequest } from './tool-BJ5jVoH2.cjs';
+import { M as ModelMessage, A as Actor, d as ToolCallRequest } from './tool-CfnSyIQf.cjs';
 
 /**
  * The two seams that see a turn's traffic to and from the model: an {@link InputProcessor} rewrites

package/dist/{tool-BJ5jVoH2.d.cts → tool-CfnSyIQf.d.cts}

@@ -152,6 +152,11 @@ interface ElicitationReply {
     skipped?: boolean;
     /** Opaque ref of WHO answered, when it wasn't the run's own actor. */
     answeredByRef?: string;
+    /**
+     * The surface the answer came through — `'web'`, `'slack'`, `'console'`, … — the counterpart of
+     * an approval's `decidedVia`.
+     */
+    answeredVia?: string;
 }
 /** A settled elicitation: what the agent proceeds on, and how it got there. */
 interface ElicitationOutcome {
@@ -160,6 +165,13 @@ interface ElicitationOutcome {
     skipped: boolean;
     /** Question ids filled from the request's `defaults` rather than by the human. */
     defaulted: string[];
+    /**
+     * Who answered (or skipped) — the reply's `answeredByRef`, which a host may make a display name.
+     * The counterpart of an approval's `decidedBy`. Absent when the reply did not say.
+     */
+    answeredBy?: string;
+    /** The surface it came through (`'web'`, `'slack'`, …) — an approval's `decidedVia`. */
+    answeredVia?: string;
 }
 /**
  * Read whatever the human channel delivered as an {@link ElicitationReply}.
@@ -544,6 +556,17 @@ type AgentStreamEvent = {
     kind: 'title';
     title: string;
 }
+/**
+ * Host-defined facts about the message being streamed (the model that answered, how long it took,
+ * the error it ended with), merged into the client message's `metadata`. The persisted
+ * counterpart is `StoredMessage.metadata`, so a reload reads the same values. The library's own
+ * loop never writes it; a runner that is not this library's loop uses it for what its store keeps
+ * per message.
+ */
+ | {
+    kind: 'message-metadata';
+    metadata: Record<string, unknown>;
+}
 /**
  * Someone stopped this run. The stream's LAST frame, written by the runner that settled the
  * cancel, immediately before a normal `end()` — never a `fail()`, because a cancel is not an
@@ -853,6 +876,11 @@ interface ToolCallRequest {
      * (defensively treated as `read` wherever a definite value is required).
      */
     kind?: ToolKind;
+    /**
+     * The call this one ran inside (a code-mode `execute`, a delegated agent) — the same `parentId`
+     * the live `tool-input-*` frames carried, so a reloaded thread nests the call where the stream did.
+     */
+    parentId?: string;
 }
 /** Result of running a tool. */
 interface ToolResult {
@@ -1149,6 +1177,11 @@ interface AgentCatalogEntry {
     description: string;
     /** Whether this is the agent a turn uses when the caller names none. Omitted when not the default. */
     isDefault?: boolean;
+    /**
+     * The catalog model this agent always runs on, when it is locked to one — an agent picker can say
+     * so before a chat starts. `GET <base>/models?agent=` reports the same lock as `locked`.
+     */
+    lockedModel?: string;
 }
 interface ThreadSummary {
     id: string;
@@ -1215,6 +1248,13 @@ interface StoredMessage {
      * nobody rated it, or on a store that does not record feedback.
      */
     feedback?: MessageFeedback;
+    /**
+     * Host-defined facts about the message (which model answered, how long it took, the error a turn
+     * ended with, …) — what a runner that is not this library's loop streamed as a
+     * `message-metadata` frame. Replayed into the client message's `metadata`, under the library's
+     * own keys (`usage`, `feedback`, `createdAt` win on a clash). Never read by the library itself.
+     */
+    metadata?: Record<string, unknown>;
     createdAt: string;
 }
 /** A thumbs-up/down on one message, with an optional free-text comment. */

package/dist/{tool-BJ5jVoH2.d.ts → tool-CfnSyIQf.d.ts}

@@ -152,6 +152,11 @@ interface ElicitationReply {
     skipped?: boolean;
     /** Opaque ref of WHO answered, when it wasn't the run's own actor. */
     answeredByRef?: string;
+    /**
+     * The surface the answer came through — `'web'`, `'slack'`, `'console'`, … — the counterpart of
+     * an approval's `decidedVia`.
+     */
+    answeredVia?: string;
 }
 /** A settled elicitation: what the agent proceeds on, and how it got there. */
 interface ElicitationOutcome {
@@ -160,6 +165,13 @@ interface ElicitationOutcome {
     skipped: boolean;
     /** Question ids filled from the request's `defaults` rather than by the human. */
     defaulted: string[];
+    /**
+     * Who answered (or skipped) — the reply's `answeredByRef`, which a host may make a display name.
+     * The counterpart of an approval's `decidedBy`. Absent when the reply did not say.
+     */
+    answeredBy?: string;
+    /** The surface it came through (`'web'`, `'slack'`, …) — an approval's `decidedVia`. */
+    answeredVia?: string;
 }
 /**
  * Read whatever the human channel delivered as an {@link ElicitationReply}.
@@ -544,6 +556,17 @@ type AgentStreamEvent = {
     kind: 'title';
     title: string;
 }
+/**
+ * Host-defined facts about the message being streamed (the model that answered, how long it took,
+ * the error it ended with), merged into the client message's `metadata`. The persisted
+ * counterpart is `StoredMessage.metadata`, so a reload reads the same values. The library's own
+ * loop never writes it; a runner that is not this library's loop uses it for what its store keeps
+ * per message.
+ */
+ | {
+    kind: 'message-metadata';
+    metadata: Record<string, unknown>;
+}
 /**
  * Someone stopped this run. The stream's LAST frame, written by the runner that settled the
  * cancel, immediately before a normal `end()` — never a `fail()`, because a cancel is not an
@@ -853,6 +876,11 @@ interface ToolCallRequest {
      * (defensively treated as `read` wherever a definite value is required).
      */
     kind?: ToolKind;
+    /**
+     * The call this one ran inside (a code-mode `execute`, a delegated agent) — the same `parentId`
+     * the live `tool-input-*` frames carried, so a reloaded thread nests the call where the stream did.
+     */
+    parentId?: string;
 }
 /** Result of running a tool. */
 interface ToolResult {
@@ -1149,6 +1177,11 @@ interface AgentCatalogEntry {
     description: string;
     /** Whether this is the agent a turn uses when the caller names none. Omitted when not the default. */
     isDefault?: boolean;
+    /**
+     * The catalog model this agent always runs on, when it is locked to one — an agent picker can say
+     * so before a chat starts. `GET <base>/models?agent=` reports the same lock as `locked`.
+     */
+    lockedModel?: string;
 }
 interface ThreadSummary {
     id: string;
@@ -1215,6 +1248,13 @@ interface StoredMessage {
      * nobody rated it, or on a store that does not record feedback.
      */
     feedback?: MessageFeedback;
+    /**
+     * Host-defined facts about the message (which model answered, how long it took, the error a turn
+     * ended with, …) — what a runner that is not this library's loop streamed as a
+     * `message-metadata` frame. Replayed into the client message's `metadata`, under the library's
+     * own keys (`usage`, `feedback`, `createdAt` win on a clash). Never read by the library itself.
+     */
+    metadata?: Record<string, unknown>;
     createdAt: string;
 }
 /** A thumbs-up/down on one message, with an optional free-text comment. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-agent-core",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/DavideCarvalho/nestjs-agent.git",