@co0ontty/wand 4.83.1 → 4.84.0

package/dist/conversation-service.d.ts

@@ -0,0 +1,90 @@
+import { type AiTeamRun } from "./ai-team-types.js";
+import { type AiTeamRunner } from "./ai-team-runner.js";
+import { type ConversationDetail, type ConversationInstance, type ConversationReceipt, type ConversationSummary, type ConversationTarget, type ConversationSessionUpdate } from "./conversation-types.js";
+import type { WandStorage } from "./storage.js";
+import type { StructuredSessionManager } from "./structured-session-manager.js";
+import type { ConversationTurn, ProcessEvent, WandConfig } from "./types.js";
+export interface GroupInput {
+    employeeIds?: string[];
+    templateId?: string;
+    excludedMemberIds?: string[];
+    leaderId?: string;
+    name?: string;
+    duties?: Record<string, string>;
+}
+interface ConversationDispatchInput {
+    title?: string;
+    description: string;
+    workspaceId?: string;
+    cwd?: string;
+    memberVersion?: number;
+    continueTaskId?: string;
+}
+/** Business coordination only; all execution remains in StructuredSessionManager / AiTeamRunner. */
+export declare class ConversationService {
+    private readonly deps;
+    constructor(deps: {
+        storage: WandStorage;
+        structured: Pick<StructuredSessionManager, "createSession" | "createRelaySession" | "get" | "sendMessage" | "appendRelayTurns">;
+        runner: AiTeamRunner;
+        config: WandConfig;
+        deleteSession?(id: string): void;
+        notifySession?(update: ConversationSessionUpdate): void;
+    });
+    private readonly removals;
+    private readonly pendingOperations;
+    private readonly previewTimers;
+    /** Reuse session events; send only a bounded IM projection, never a second execution protocol. */
+    ingestSessionEvent(event: ProcessEvent): void;
+    dispose(): void;
+    private get storage();
+    private snapshot;
+    /** Explicit startup/event migration, never a GET repair and never an invented group. */
+    importRun(run: AiTeamRun): void;
+    migrateExistingChats(): void;
+    pendingEmployee(employeeId: string): ConversationInstance;
+    private requireInstance;
+    /** 会话里「我自己」的署名与头像：跟随当前设置，改设置不改写历史回合。 */
+    private selfAuthor;
+    private selfName;
+    private memberReasons;
+    private turns;
+    summary(instance: ConversationInstance): ConversationSummary;
+    list(): ConversationSummary[];
+    updateListState(id: string, patch: {
+        pinned?: boolean;
+        dissolved?: boolean;
+    }): ConversationSummary;
+    /** Delete only this conversation's owned channels and, for groups, its linked task resources. */
+    remove(id: string): Promise<void>;
+    private removeOwnedResources;
+    history(id: string): ConversationTurn[];
+    detail(id: string): ConversationDetail;
+    /** Read-only, bounded projection of the exact accepted run. Never follow a group's newest task. */
+    private taskPreview;
+    private groupTeam;
+    /** `autoName` 是自动群的首轮任务标题：保持 auto 命名，名字继续跟随最新任务。 */
+    private newGroup;
+    private request;
+    private performRequest;
+    receipt(requestId: string): ConversationReceipt | null;
+    createGroup(requestId: string, input: GroupInput): Promise<ConversationReceipt>;
+    invite(id: string, requestId: string, version: number, input: GroupInput): Promise<ConversationReceipt>;
+    private cwd;
+    private ensureRelay;
+    /** Explicit resource action may prepare a channel; it never sends or starts a model. */
+    prepare(id: string, requestId: string, explicitCwd?: string): Promise<ConversationReceipt>;
+    private communicationChannel;
+    send(id: string, requestId: string, input: string, target: ConversationTarget, explicitCwd?: string, echo?: boolean): Promise<ConversationReceipt>;
+    /** One IM message is one fresh model context. No task, team, relay or previous DM history. */
+    private startMessageSession;
+    private requireTarget;
+    dispatch(id: string, requestId: string, input: ConversationDispatchInput): Promise<ConversationReceipt>;
+    /** Both explicit task forms and leading @ messages share one atomic acceptance/idempotency boundary. */
+    private dispatchInRequest;
+    act(id: string, requestId: string, target: {
+        taskId: string;
+        runId: string;
+    }, action: string, extraSteps?: number): Promise<ConversationReceipt>;
+}
+export {};