@dudousxd/nestjs-agent 1.36.1 → 1.37.0

package/dist/{index-NF93YDF4.d.cts → index-4caNqEQ-.d.cts}

@@ -1,8 +1,8 @@
 import { A2uiStreamOptions, a2uiThreadReplay } from '@dudousxd/nestjs-agent-core/a2ui';
-import { AgentAttachmentConfig, AttachmentStagingStore, AgentStore, Actor, ListActionProposals, ActionProposalView, ActionProposalMutationView, TextActionProposalVocabulary, AgentRunner, ModelCatalog, QuotaProvider, ActionApprovalMode, MessageAttachment, QuotaReport, ModelCatalogView, AgentHostContext, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver } from '@dudousxd/nestjs-agent-core';
+import { AgentAttachmentConfig, AttachmentStagingStore, AgentStore, Actor, ListActionProposals, ActionProposalView, ActionProposalMutationView, TextActionProposalVocabulary, AgentRunner, ModelCatalog, QuotaProvider, ActionApprovalMode, MessageAttachment, QuotaReport, ModelCatalogView, AgentHostContext, AttachmentRef, PageContext, ChatQueueState, SubscribeOptions, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver } from '@dudousxd/nestjs-agent-core';
 import { Request, Response } from 'express';
 import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
-import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-CF2fcJDx.cjs';
+import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-fopUN313.cjs';
 
 /** Default per-file size cap (20 MiB). */
 declare const DEFAULT_MAX_ATTACHMENT_BYTES: number;
@@ -167,6 +167,22 @@ interface ChatParams {
 interface ThreadDefaultAgentReader {
     defaultAgentForThread(threadId: string): Promise<string | null>;
 }
+/** What {@link AgentService.forkThread} takes past the thread and the message to copy up to. */
+interface ForkThreadParams {
+    /**
+     * The HOST already decided this actor may read the thread — "continue this conversation" from a
+     * link its owner shared. Skips the ownership check, and the copy belongs to the CALLER, not the
+     * source's owner; the original is left as it was. Never set it from a request's own claim: the
+     * `POST /threads/:id/fork-from/:messageId` route never does, so it stays owner-only.
+     */
+    authorized?: boolean;
+    /**
+     * The copy's tenant — see `ForkThreadOptions.tenantRef`. Absent keeps the SOURCE's, even when the
+     * copy now belongs to someone else; forking across tenants, pass the caller's
+     * (`actor.tenantRef ?? null`). `null` clears it.
+     */
+    tenantRef?: string | null;
+}
 /** Like {@link ThreadDefaultAgentReader}, for the thread's pinned model. */
 interface ThreadModelReader {
     modelForThread(threadId: string): Promise<string | null>;
@@ -355,14 +371,14 @@ declare class AgentService {
      * {@link subscribeAs} instead: a runId is the only thing standing between a caller and another
      * actor's answer, tool arguments and tool results.
      */
-    subscribe(runId: string): AsyncIterable<Uint8Array>;
+    subscribe(runId: string, options?: SubscribeOptions): AsyncIterable<Uint8Array>;
     /**
      * {@link subscribe}, gated the way {@link cancel} is: only the actor whose thread is currently
      * streaming this run may read it. A run that has already finished is reported missing rather than
      * replayed — the runner clears the thread's active stream as the run ends, and that field is what
      * ownership is derived from.
      */
-    subscribeAs(actor: Actor, runId: string): Promise<AsyncIterable<Uint8Array>>;
+    subscribeAs(actor: Actor, runId: string, options?: SubscribeOptions): Promise<AsyncIterable<Uint8Array>>;
     /**
      * Approve a parked action call as `actor`. Who may is the call's recorded approver's business
      * (see {@link assertMayDecide}); `remember` approves later calls of the same tool in the same
@@ -430,7 +446,12 @@ declare class AgentService {
     listThreads(actorRef: string): Promise<ThreadSummary[]>;
     getThread(actor: Actor, threadId: string): Promise<ThreadDetail | null>;
     deleteThread(actor: Actor, threadId: string): Promise<void>;
-    forkThread(actor: Actor, threadId: string, fromMessageId: string): Promise<ThreadSummary>;
+    /**
+     * Copy a thread up to `fromMessageId` (inclusive) into a new one. By default only the thread's
+     * owner may, and the copy is theirs. With `params.authorized`, the host has vouched for `actor`
+     * (a share link it checked) and the copy is `actor`'s — see {@link ForkThreadParams}.
+     */
+    forkThread(actor: Actor, threadId: string, fromMessageId: string, params?: ForkThreadParams): Promise<ThreadSummary>;
     /** Kept for source compatibility — a thin wrapper over the more general `updateThread`. */
     renameThread(actor: Actor, threadId: string, title: string): Promise<void>;
     /**
@@ -460,6 +481,8 @@ declare class AgentService {
      * the full read.
      */
     private resolveAgentName;
+    /** Everything a send reads off `threadId`, in one read where the store allows it. */
+    private threadReads;
     private threadDefaultAgent;
     private toSummaryView;
     private toDetailView;
@@ -645,4 +668,4 @@ declare class A2uiRunHandler {
  */
 declare function a2uiAdapter(options?: A2uiAdapterOptions): AgentProtocolAdapter;
 
-export { AgentService as A, type ChatParams as C, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES as D, MAX_ATTACHMENTS_PER_MESSAGE as M, NO_USER_MESSAGE_CODE as N, type QueuedSend as Q, type ThreadDefaultAgentReader as T, ActionProposalService as a, type A2uiAdapterOptions as b, A2uiRunHandler as c, type AttachmentLimits as d, type ChatSendMode as e, type ChatSendResult as f, DEFAULT_MAX_ATTACHMENT_BYTES as g, type ThreadModelReader as h, a2uiAdapter as i, attachmentLimits as j };
+export { AgentService as A, type ChatParams as C, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES as D, type ForkThreadParams as F, MAX_ATTACHMENTS_PER_MESSAGE as M, NO_USER_MESSAGE_CODE as N, type QueuedSend as Q, type ThreadDefaultAgentReader as T, ActionProposalService as a, type A2uiAdapterOptions as b, A2uiRunHandler as c, type AttachmentLimits as d, type ChatSendMode as e, type ChatSendResult as f, DEFAULT_MAX_ATTACHMENT_BYTES as g, type ThreadModelReader as h, a2uiAdapter as i, attachmentLimits as j };

package/dist/{index-DpS9P7so.d.ts → index-yC_Ra3CE.d.ts}

@@ -1,8 +1,8 @@
 import { A2uiStreamOptions, a2uiThreadReplay } from '@dudousxd/nestjs-agent-core/a2ui';
-import { AgentAttachmentConfig, AttachmentStagingStore, AgentStore, Actor, ListActionProposals, ActionProposalView, ActionProposalMutationView, TextActionProposalVocabulary, AgentRunner, ModelCatalog, QuotaProvider, ActionApprovalMode, MessageAttachment, QuotaReport, ModelCatalogView, AgentHostContext, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver } from '@dudousxd/nestjs-agent-core';
+import { AgentAttachmentConfig, AttachmentStagingStore, AgentStore, Actor, ListActionProposals, ActionProposalView, ActionProposalMutationView, TextActionProposalVocabulary, AgentRunner, ModelCatalog, QuotaProvider, ActionApprovalMode, MessageAttachment, QuotaReport, ModelCatalogView, AgentHostContext, AttachmentRef, PageContext, ChatQueueState, SubscribeOptions, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver } from '@dudousxd/nestjs-agent-core';
 import { Request, Response } from 'express';
 import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
-import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-CzXsKVb1.js';
+import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-YjiKVTKE.js';
 
 /** Default per-file size cap (20 MiB). */
 declare const DEFAULT_MAX_ATTACHMENT_BYTES: number;
@@ -167,6 +167,22 @@ interface ChatParams {
 interface ThreadDefaultAgentReader {
     defaultAgentForThread(threadId: string): Promise<string | null>;
 }
+/** What {@link AgentService.forkThread} takes past the thread and the message to copy up to. */
+interface ForkThreadParams {
+    /**
+     * The HOST already decided this actor may read the thread — "continue this conversation" from a
+     * link its owner shared. Skips the ownership check, and the copy belongs to the CALLER, not the
+     * source's owner; the original is left as it was. Never set it from a request's own claim: the
+     * `POST /threads/:id/fork-from/:messageId` route never does, so it stays owner-only.
+     */
+    authorized?: boolean;
+    /**
+     * The copy's tenant — see `ForkThreadOptions.tenantRef`. Absent keeps the SOURCE's, even when the
+     * copy now belongs to someone else; forking across tenants, pass the caller's
+     * (`actor.tenantRef ?? null`). `null` clears it.
+     */
+    tenantRef?: string | null;
+}
 /** Like {@link ThreadDefaultAgentReader}, for the thread's pinned model. */
 interface ThreadModelReader {
     modelForThread(threadId: string): Promise<string | null>;
@@ -355,14 +371,14 @@ declare class AgentService {
      * {@link subscribeAs} instead: a runId is the only thing standing between a caller and another
      * actor's answer, tool arguments and tool results.
      */
-    subscribe(runId: string): AsyncIterable<Uint8Array>;
+    subscribe(runId: string, options?: SubscribeOptions): AsyncIterable<Uint8Array>;
     /**
      * {@link subscribe}, gated the way {@link cancel} is: only the actor whose thread is currently
      * streaming this run may read it. A run that has already finished is reported missing rather than
      * replayed — the runner clears the thread's active stream as the run ends, and that field is what
      * ownership is derived from.
      */
-    subscribeAs(actor: Actor, runId: string): Promise<AsyncIterable<Uint8Array>>;
+    subscribeAs(actor: Actor, runId: string, options?: SubscribeOptions): Promise<AsyncIterable<Uint8Array>>;
     /**
      * Approve a parked action call as `actor`. Who may is the call's recorded approver's business
      * (see {@link assertMayDecide}); `remember` approves later calls of the same tool in the same
@@ -430,7 +446,12 @@ declare class AgentService {
     listThreads(actorRef: string): Promise<ThreadSummary[]>;
     getThread(actor: Actor, threadId: string): Promise<ThreadDetail | null>;
     deleteThread(actor: Actor, threadId: string): Promise<void>;
-    forkThread(actor: Actor, threadId: string, fromMessageId: string): Promise<ThreadSummary>;
+    /**
+     * Copy a thread up to `fromMessageId` (inclusive) into a new one. By default only the thread's
+     * owner may, and the copy is theirs. With `params.authorized`, the host has vouched for `actor`
+     * (a share link it checked) and the copy is `actor`'s — see {@link ForkThreadParams}.
+     */
+    forkThread(actor: Actor, threadId: string, fromMessageId: string, params?: ForkThreadParams): Promise<ThreadSummary>;
     /** Kept for source compatibility — a thin wrapper over the more general `updateThread`. */
     renameThread(actor: Actor, threadId: string, title: string): Promise<void>;
     /**
@@ -460,6 +481,8 @@ declare class AgentService {
      * the full read.
      */
     private resolveAgentName;
+    /** Everything a send reads off `threadId`, in one read where the store allows it. */
+    private threadReads;
     private threadDefaultAgent;
     private toSummaryView;
     private toDetailView;
@@ -645,4 +668,4 @@ declare class A2uiRunHandler {
  */
 declare function a2uiAdapter(options?: A2uiAdapterOptions): AgentProtocolAdapter;
 
-export { AgentService as A, type ChatParams as C, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES as D, MAX_ATTACHMENTS_PER_MESSAGE as M, NO_USER_MESSAGE_CODE as N, type QueuedSend as Q, type ThreadDefaultAgentReader as T, ActionProposalService as a, type A2uiAdapterOptions as b, A2uiRunHandler as c, type AttachmentLimits as d, type ChatSendMode as e, type ChatSendResult as f, DEFAULT_MAX_ATTACHMENT_BYTES as g, type ThreadModelReader as h, a2uiAdapter as i, attachmentLimits as j };
+export { AgentService as A, type ChatParams as C, DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES as D, type ForkThreadParams as F, MAX_ATTACHMENTS_PER_MESSAGE as M, NO_USER_MESSAGE_CODE as N, type QueuedSend as Q, type ThreadDefaultAgentReader as T, ActionProposalService as a, type A2uiAdapterOptions as b, A2uiRunHandler as c, type AttachmentLimits as d, type ChatSendMode as e, type ChatSendResult as f, DEFAULT_MAX_ATTACHMENT_BYTES as g, type ThreadModelReader as h, a2uiAdapter as i, attachmentLimits as j };