@dudousxd/nestjs-agent-core 0.27.0 → 0.29.0

package/dist/{processors-Bf1fYLbY.d.cts → processors-3FixaBnr.d.cts}

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

package/dist/{processors-CK1RWv0D.d.ts → processors-BrGKQgLf.d.ts}

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

package/dist/{tool-BXKG2xSm.d.cts → tool-CON4ZOrD.d.cts}

@@ -544,6 +544,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 +864,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 {
@@ -1215,6 +1231,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. */
@@ -1250,7 +1273,6 @@ interface ToolCallApproval {
 }
 interface ThreadDetail extends ThreadSummary {
     messages: StoredMessage[];
-    activeStreamId?: string;
 }
 type ToolCallStatus = 'auto_executed' | 'pending_approval' | 'executed' | 'rejected' | 'failed'
 /** An approval request lapsed before anyone decided; the tool never ran. */
@@ -1316,6 +1338,36 @@ interface ToolStepEnvelope {
      */
     collectUi?: boolean;
 }
+/**
+ * What `GET <base>/config` answers — server-side facts a client would otherwise repeat in its own
+ * configuration (and let drift).
+ */
+interface AgentClientConfig {
+    attachments: AgentAttachmentConfig;
+    /** A model catalog is bound, so `GET <base>/models` lists something to pick. */
+    models: {
+        enabled: boolean;
+    };
+    /** Sends are refused with `429` once `GET <base>/quota` reports `blocked`. */
+    quota: {
+        enforced: boolean;
+    };
+    /** No `actorResolver`: every browser is its own anonymous actor. */
+    identity: {
+        anonymous: boolean;
+    };
+}
+/** The attachment rules in force — what the upload route enforces. */
+interface AgentAttachmentConfig {
+    /** A staging store is bound, so uploads work at all. */
+    enabled: boolean;
+    /** How a client uploads (`null` when `enabled` is false). */
+    upload: 'multipart' | 'resumable' | null;
+    maxBytes: number;
+    allowedContentTypes: readonly string[];
+    /** How many attachments one message may name. */
+    maxPerMessage: number;
+}
 
 /**
  * Per-invocation context handed to a tool handler. Host-supplied bits are optional. Identity lives
@@ -1411,4 +1463,4 @@ interface ToolDescription {
     inputSchema?: StandardSchemaV1;
 }
 
-export { type ElicitationQuestion as $, type Actor as A, type ToolStepEnvelope as B, ASK_TOOL_DESCRIPTION as C, type DetachedDelivery as D, type ElicitationRequest as E, ASK_TOOL_NAME as F, type AgentApprovalRequest as G, type HumanReply as H, type AgentApprovalSettlement as I, type AgentCatalogEntry as J, type AgentHistoryWindow as K, type LlmStepEnvelope as L, type ModelMessage as M, type AskToolInput as N, DEFAULT_INTAKE_PREAMBLE as O, type PageContext as P, type QuotaState as Q, DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS as R, type StoredMessage as S, type ToolSpec as T, type UsagePurpose as U, DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS as V, ELICITATION_INPUT_TYPES as W, type ElicitationInput as X, type ElicitationInputType as Y, type ElicitationOption as Z, type ElicitationOutcome as _, type ToolHandler as a, type ElicitationReply as a0, type ElicitationResult as a1, type HistoryPolicyContext as a2, type HistorySelection as a3, type HistorySummary as a4, type InvokeWithTransientRetryOptions as a5, MAX_ASK_QUESTIONS as a6, type MessageFeedbackValue as a7, type MessageRole as a8, type PromptContext as a9, validateElicitationAnswer as aA, validateElicitationValue as aB, type QuotaView as aa, type ToolCallApprovalStatus as ab, type ToolCatalogEntry as ac, type ToolConfirmation as ad, type ToolDescription as ae, type ToolPresentationTone as af, type ToolResultField as ag, type ToolResultView as ah, type ToolStepCtx as ai, type ToolTransientRetryNumbers as aj, type ToolTransientRetryOptions as ak, askInputSchema as al, askToolDefinition as am, decodeStreamEvent as an, encodeStreamEvent as ao, invokeWithTransientRetry as ap, isTransientToolError as aq, isTypedQuestion as ar, normalizeElicitationReply as as, questionOptions as at, readElicitationInput as au, readElicitationQuestions as av, renderElicitationAnswers as aw, resolveElicitation as ax, resolveToolTransientRetryNumbers as ay, settleElicitation as az, type ToolPresentation as b, type ToolDefinition as c, type ToolCallRequest as d, type MessageUsage as e, type AgentUiComponent as f, type AiToolCtx as g, type AgentStreamEvent as h, type ThreadSummary as i, type ThreadDetail as j, type ToolResult as k, type MessageAttachment as l, type MessageFeedback as m, type ToolCallStatus as n, type AgentRunInput as o, type ToolKind as p, type ToolCallApproval as q, type HistoryPolicy as r, type AgentDefinition as s, type AgentDelegation as t, type ToolDescribeScope as u, type PromptBuilder as v, type PromptContributor as w, type ToolTransientRetrySetting as x, type AgentIntake as y, type Decision as z };
+export { type ElicitationOption as $, type Actor as A, type ToolStepEnvelope as B, ASK_TOOL_DESCRIPTION as C, type DetachedDelivery as D, type ElicitationRequest as E, ASK_TOOL_NAME as F, type AgentApprovalRequest as G, type HumanReply as H, type AgentApprovalSettlement as I, type AgentAttachmentConfig as J, type AgentCatalogEntry as K, type LlmStepEnvelope as L, type ModelMessage as M, type AgentClientConfig as N, type AgentHistoryWindow as O, type PageContext as P, type QuotaState as Q, type AskToolInput as R, type StoredMessage as S, type ToolSpec as T, type UsagePurpose as U, DEFAULT_INTAKE_PREAMBLE as V, DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS as W, DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS as X, ELICITATION_INPUT_TYPES as Y, type ElicitationInput as Z, type ElicitationInputType as _, type ToolHandler as a, type ElicitationOutcome as a0, type ElicitationQuestion as a1, type ElicitationReply as a2, type ElicitationResult as a3, type HistoryPolicyContext as a4, type HistorySelection as a5, type HistorySummary as a6, type InvokeWithTransientRetryOptions as a7, MAX_ASK_QUESTIONS as a8, type MessageFeedbackValue as a9, resolveToolTransientRetryNumbers as aA, settleElicitation as aB, validateElicitationAnswer as aC, validateElicitationValue as aD, type MessageRole as aa, type PromptContext as ab, type QuotaView as ac, type ToolCallApprovalStatus as ad, type ToolCatalogEntry as ae, type ToolConfirmation as af, type ToolDescription as ag, type ToolPresentationTone as ah, type ToolResultField as ai, type ToolResultView as aj, type ToolStepCtx as ak, type ToolTransientRetryNumbers as al, type ToolTransientRetryOptions as am, askInputSchema as an, askToolDefinition as ao, decodeStreamEvent as ap, encodeStreamEvent as aq, invokeWithTransientRetry as ar, isTransientToolError as as, isTypedQuestion as at, normalizeElicitationReply as au, questionOptions as av, readElicitationInput as aw, readElicitationQuestions as ax, renderElicitationAnswers as ay, resolveElicitation as az, type ToolPresentation as b, type ToolDefinition as c, type ToolCallRequest as d, type MessageUsage as e, type AgentUiComponent as f, type AiToolCtx as g, type AgentStreamEvent as h, type ThreadSummary as i, type ThreadDetail as j, type ToolResult as k, type MessageAttachment as l, type MessageFeedback as m, type ToolCallStatus as n, type AgentRunInput as o, type ToolKind as p, type ToolCallApproval as q, type HistoryPolicy as r, type AgentDefinition as s, type AgentDelegation as t, type ToolDescribeScope as u, type PromptBuilder as v, type PromptContributor as w, type ToolTransientRetrySetting as x, type AgentIntake as y, type Decision as z };

package/dist/{tool-BXKG2xSm.d.ts → tool-CON4ZOrD.d.ts}

@@ -544,6 +544,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 +864,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 {
@@ -1215,6 +1231,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. */
@@ -1250,7 +1273,6 @@ interface ToolCallApproval {
 }
 interface ThreadDetail extends ThreadSummary {
     messages: StoredMessage[];
-    activeStreamId?: string;
 }
 type ToolCallStatus = 'auto_executed' | 'pending_approval' | 'executed' | 'rejected' | 'failed'
 /** An approval request lapsed before anyone decided; the tool never ran. */
@@ -1316,6 +1338,36 @@ interface ToolStepEnvelope {
      */
     collectUi?: boolean;
 }
+/**
+ * What `GET <base>/config` answers — server-side facts a client would otherwise repeat in its own
+ * configuration (and let drift).
+ */
+interface AgentClientConfig {
+    attachments: AgentAttachmentConfig;
+    /** A model catalog is bound, so `GET <base>/models` lists something to pick. */
+    models: {
+        enabled: boolean;
+    };
+    /** Sends are refused with `429` once `GET <base>/quota` reports `blocked`. */
+    quota: {
+        enforced: boolean;
+    };
+    /** No `actorResolver`: every browser is its own anonymous actor. */
+    identity: {
+        anonymous: boolean;
+    };
+}
+/** The attachment rules in force — what the upload route enforces. */
+interface AgentAttachmentConfig {
+    /** A staging store is bound, so uploads work at all. */
+    enabled: boolean;
+    /** How a client uploads (`null` when `enabled` is false). */
+    upload: 'multipart' | 'resumable' | null;
+    maxBytes: number;
+    allowedContentTypes: readonly string[];
+    /** How many attachments one message may name. */
+    maxPerMessage: number;
+}
 
 /**
  * Per-invocation context handed to a tool handler. Host-supplied bits are optional. Identity lives
@@ -1411,4 +1463,4 @@ interface ToolDescription {
     inputSchema?: StandardSchemaV1;
 }
 
-export { type ElicitationQuestion as $, type Actor as A, type ToolStepEnvelope as B, ASK_TOOL_DESCRIPTION as C, type DetachedDelivery as D, type ElicitationRequest as E, ASK_TOOL_NAME as F, type AgentApprovalRequest as G, type HumanReply as H, type AgentApprovalSettlement as I, type AgentCatalogEntry as J, type AgentHistoryWindow as K, type LlmStepEnvelope as L, type ModelMessage as M, type AskToolInput as N, DEFAULT_INTAKE_PREAMBLE as O, type PageContext as P, type QuotaState as Q, DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS as R, type StoredMessage as S, type ToolSpec as T, type UsagePurpose as U, DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS as V, ELICITATION_INPUT_TYPES as W, type ElicitationInput as X, type ElicitationInputType as Y, type ElicitationOption as Z, type ElicitationOutcome as _, type ToolHandler as a, type ElicitationReply as a0, type ElicitationResult as a1, type HistoryPolicyContext as a2, type HistorySelection as a3, type HistorySummary as a4, type InvokeWithTransientRetryOptions as a5, MAX_ASK_QUESTIONS as a6, type MessageFeedbackValue as a7, type MessageRole as a8, type PromptContext as a9, validateElicitationAnswer as aA, validateElicitationValue as aB, type QuotaView as aa, type ToolCallApprovalStatus as ab, type ToolCatalogEntry as ac, type ToolConfirmation as ad, type ToolDescription as ae, type ToolPresentationTone as af, type ToolResultField as ag, type ToolResultView as ah, type ToolStepCtx as ai, type ToolTransientRetryNumbers as aj, type ToolTransientRetryOptions as ak, askInputSchema as al, askToolDefinition as am, decodeStreamEvent as an, encodeStreamEvent as ao, invokeWithTransientRetry as ap, isTransientToolError as aq, isTypedQuestion as ar, normalizeElicitationReply as as, questionOptions as at, readElicitationInput as au, readElicitationQuestions as av, renderElicitationAnswers as aw, resolveElicitation as ax, resolveToolTransientRetryNumbers as ay, settleElicitation as az, type ToolPresentation as b, type ToolDefinition as c, type ToolCallRequest as d, type MessageUsage as e, type AgentUiComponent as f, type AiToolCtx as g, type AgentStreamEvent as h, type ThreadSummary as i, type ThreadDetail as j, type ToolResult as k, type MessageAttachment as l, type MessageFeedback as m, type ToolCallStatus as n, type AgentRunInput as o, type ToolKind as p, type ToolCallApproval as q, type HistoryPolicy as r, type AgentDefinition as s, type AgentDelegation as t, type ToolDescribeScope as u, type PromptBuilder as v, type PromptContributor as w, type ToolTransientRetrySetting as x, type AgentIntake as y, type Decision as z };
+export { type ElicitationOption as $, type Actor as A, type ToolStepEnvelope as B, ASK_TOOL_DESCRIPTION as C, type DetachedDelivery as D, type ElicitationRequest as E, ASK_TOOL_NAME as F, type AgentApprovalRequest as G, type HumanReply as H, type AgentApprovalSettlement as I, type AgentAttachmentConfig as J, type AgentCatalogEntry as K, type LlmStepEnvelope as L, type ModelMessage as M, type AgentClientConfig as N, type AgentHistoryWindow as O, type PageContext as P, type QuotaState as Q, type AskToolInput as R, type StoredMessage as S, type ToolSpec as T, type UsagePurpose as U, DEFAULT_INTAKE_PREAMBLE as V, DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS as W, DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS as X, ELICITATION_INPUT_TYPES as Y, type ElicitationInput as Z, type ElicitationInputType as _, type ToolHandler as a, type ElicitationOutcome as a0, type ElicitationQuestion as a1, type ElicitationReply as a2, type ElicitationResult as a3, type HistoryPolicyContext as a4, type HistorySelection as a5, type HistorySummary as a6, type InvokeWithTransientRetryOptions as a7, MAX_ASK_QUESTIONS as a8, type MessageFeedbackValue as a9, resolveToolTransientRetryNumbers as aA, settleElicitation as aB, validateElicitationAnswer as aC, validateElicitationValue as aD, type MessageRole as aa, type PromptContext as ab, type QuotaView as ac, type ToolCallApprovalStatus as ad, type ToolCatalogEntry as ae, type ToolConfirmation as af, type ToolDescription as ag, type ToolPresentationTone as ah, type ToolResultField as ai, type ToolResultView as aj, type ToolStepCtx as ak, type ToolTransientRetryNumbers as al, type ToolTransientRetryOptions as am, askInputSchema as an, askToolDefinition as ao, decodeStreamEvent as ap, encodeStreamEvent as aq, invokeWithTransientRetry as ar, isTransientToolError as as, isTypedQuestion as at, normalizeElicitationReply as au, questionOptions as av, readElicitationInput as aw, readElicitationQuestions as ax, renderElicitationAnswers as ay, resolveElicitation as az, type ToolPresentation as b, type ToolDefinition as c, type ToolCallRequest as d, type MessageUsage as e, type AgentUiComponent as f, type AiToolCtx as g, type AgentStreamEvent as h, type ThreadSummary as i, type ThreadDetail as j, type ToolResult as k, type MessageAttachment as l, type MessageFeedback as m, type ToolCallStatus as n, type AgentRunInput as o, type ToolKind as p, type ToolCallApproval as q, type HistoryPolicy as r, type AgentDefinition as s, type AgentDelegation as t, type ToolDescribeScope as u, type PromptBuilder as v, type PromptContributor as w, type ToolTransientRetrySetting as x, type AgentIntake as y, type Decision as z };

package/package.json

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