@dudousxd/nestjs-agent 1.36.2 → 1.37.0

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

@@ -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>;
@@ -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>;
     /**
@@ -647,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-D1xRrnCq.d.ts → index-yC_Ra3CE.d.ts}

@@ -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>;
@@ -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>;
     /**
@@ -647,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.cjs

@@ -2550,9 +2550,28 @@ var AgentService2 = class {
     await this.assertOwnsThread(actor, threadId);
     return this.store.softDeleteThread(threadId);
   }
-  async forkThread(actor, threadId, fromMessageId) {
-    await this.assertOwnsThread(actor, threadId);
-    return this.store.forkThread(threadId, fromMessageId);
+  /**
+  * 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}.
+  */
+  async forkThread(actor, threadId, fromMessageId, params = {}) {
+    if (params.authorized === true) {
+      if (await this.store.ownerOfThread(threadId) === null) {
+        throw new import_common6.NotFoundException(`thread ${threadId} not found`);
+      }
+    } else {
+      await this.assertOwnsThread(actor, threadId);
+    }
+    const options = {
+      ...params.authorized === true ? {
+        actorRef: actor.id
+      } : {},
+      ...params.tenantRef !== void 0 ? {
+        tenantRef: params.tenantRef
+      } : {}
+    };
+    return this.store.forkThread(threadId, fromMessageId, options);
   }
   /** Kept for source compatibility — a thin wrapper over the more general `updateThread`. */
   async renameThread(actor, threadId, title) {