@webiny/app-admin 6.6.0-alpha.0 → 6.6.0-alpha.10

package/features/adminAssistant/AdminAssistantPresenter.js

@@ -0,0 +1,377 @@
+import { makeAutoObservable } from "mobx";
+import { AdminAssistantGateway, AdminAssistantPresenter } from "./abstractions.js";
+import { AiChatsRepository } from "../aiChats/abstractions.js";
+import { AiChatSaveError } from "../aiChats/AiChatSaveError.js";
+import { messageOf } from "../aiChats/messageOf.js";
+import { turnsFromMessages } from "./turnsFromMessages.js";
+const NOT_CONFIGURED = "AI_CAPABILITY_NOT_CONFIGURED";
+const saveFailureOf = (error)=>error instanceof AiChatSaveError ? error.failure : "unreachable";
+const emptyTurn = (question)=>({
+        question,
+        text: "",
+        answerStart: 0,
+        tools: [],
+        completed: [],
+        failed: [],
+        running: false,
+        pendingApprovals: [],
+        followUps: [],
+        messages: [],
+        settled: false
+    });
+class AdminAssistantPresenterImpl {
+    constructor(gateway, chats){
+        this.gateway = gateway;
+        this.chats = chats;
+        this.turns = [];
+        this.busy = false;
+        this.model = void 0;
+        this.chatId = null;
+        this.opening = false;
+        this.storageError = null;
+        this.saveFailure = null;
+        this.controller = null;
+        this.saving = Promise.resolve();
+        this.generation = 0;
+        makeAutoObservable(this, {
+            controller: false,
+            saving: false,
+            generation: false,
+            chats: false
+        });
+    }
+    get vm() {
+        const vm = {
+            busy: this.busy,
+            chatId: this.chatId,
+            opening: this.opening,
+            storageError: this.storageError,
+            saveFailure: this.saveFailure,
+            savePaused: this.savePaused,
+            setupRequired: this.setupRequired,
+            turns: this.turns.map((turn)=>{
+                const view = {
+                    question: turn.question,
+                    text: turn.text,
+                    answerStart: turn.answerStart,
+                    tools: turn.tools,
+                    completed: turn.completed,
+                    failed: turn.failed,
+                    running: turn.running,
+                    pendingApprovals: turn.pendingApprovals,
+                    followUps: turn.followUps,
+                    settled: turn.settled,
+                    needsSetup: turn.errorCode === NOT_CONFIGURED
+                };
+                if (void 0 !== turn.error) view.error = turn.error;
+                return view;
+            })
+        };
+        if (void 0 !== this.model) vm.model = this.model;
+        return vm;
+    }
+    ask(question) {
+        const trimmed = question.trim();
+        if (!trimmed || this.busy || this.opening || this.setupRequired) return;
+        const index = this.turns.length;
+        this.addTurn(trimmed);
+        this.run(index, {
+            messages: [
+                ...this.historyBefore(index),
+                {
+                    role: "user",
+                    content: trimmed
+                }
+            ]
+        });
+    }
+    decide(turnIndex, approved) {
+        const turn = this.turns[turnIndex];
+        if (!turn?.pendingApprovals.length || this.busy || this.opening) return;
+        const approvals = turn.pendingApprovals.map((approval)=>({
+                approvalId: approval.approvalId,
+                approved
+            }));
+        const messages = [
+            ...this.historyBefore(turnIndex),
+            {
+                role: "user",
+                content: turn.question
+            },
+            ...turn.messages
+        ];
+        this.patch(turnIndex, {
+            pendingApprovals: [],
+            followUps: [],
+            settled: false,
+            running: true
+        });
+        this.run(turnIndex, {
+            messages,
+            approvals
+        }, true);
+    }
+    retry() {
+        const index = this.turns.length - 1;
+        const turn = this.turns[index];
+        if (!turn?.error || this.busy || this.opening) return;
+        const fresh = emptyTurn(turn.question);
+        this.replaceTurn(index, {
+            ...fresh,
+            running: true
+        });
+        const history = this.historyBefore(index);
+        this.run(index, {
+            messages: [
+                ...history,
+                {
+                    role: "user",
+                    content: turn.question
+                }
+            ]
+        });
+    }
+    retrySave() {
+        if (!this.saveFailure || this.savePaused) return;
+        this.clearStorageError();
+        this.queueSave();
+    }
+    get savePaused() {
+        return this.turns.some((turn)=>turn.pendingApprovals.length > 0);
+    }
+    get setupRequired() {
+        const newest = this.turns[this.turns.length - 1];
+        return newest?.errorCode === NOT_CONFIGURED;
+    }
+    reset() {
+        this.controller?.abort();
+        this.controller = null;
+        this.generation++;
+        this.clear();
+    }
+    async open(chatId) {
+        this.reset();
+        const generation = this.generation;
+        this.setOpening(true);
+        try {
+            const chat = await this.chats.get(chatId);
+            if (generation !== this.generation) return;
+            const turns = turnsFromMessages(chat.messages);
+            this.setConversation(chat.id, turns);
+        } catch (error) {
+            if (generation === this.generation) {
+                const message = messageOf(error);
+                this.setStorageError(message);
+            }
+        } finally{
+            if (generation === this.generation) this.setOpening(false);
+        }
+    }
+    queueSave() {
+        const messages = this.historyBefore(this.turns.length);
+        if (this.savePaused || 0 === messages.length) return;
+        const generation = this.generation;
+        this.saving = this.saving.then(()=>this.save(generation, messages));
+    }
+    async save(generation, messages) {
+        if (generation !== this.generation) return;
+        try {
+            const input = {
+                messages
+            };
+            if (this.chatId) input.id = this.chatId;
+            const summary = await this.chats.save(input);
+            if (generation === this.generation) this.setSaved(summary.id);
+        } catch (error) {
+            if (generation === this.generation) {
+                const message = messageOf(error);
+                const failure = saveFailureOf(error);
+                this.setSaveFailed(message, failure);
+            }
+        }
+    }
+    historyBefore(upTo) {
+        const history = [];
+        for (const turn of this.turns.slice(0, upTo))if (turn.settled && !turn.error) {
+            history.push({
+                role: "user",
+                content: turn.question
+            });
+            history.push(...turn.messages);
+        }
+        return history;
+    }
+    async run(index, request, resuming = false) {
+        this.controller?.abort();
+        const controller = new AbortController();
+        this.controller = controller;
+        this.setBusy(true);
+        try {
+            const existing = resuming ? this.turns[index] : void 0;
+            let text = existing?.text ?? "";
+            const tools = existing ? [
+                ...existing.tools
+            ] : [];
+            const completed = existing ? [
+                ...existing.completed
+            ] : [];
+            const failed = existing ? [
+                ...existing.failed
+            ] : [];
+            const priorMessages = existing ? [
+                ...existing.messages
+            ] : [];
+            let separateFromExisting = text.length > 0;
+            for await (const event of this.gateway.stream(request, controller.signal)){
+                if ("start" === event.type) {
+                    this.setModel(event.model);
+                    continue;
+                }
+                if ("text" === event.type) {
+                    text += separateFromExisting ? `\n\n${event.text}` : event.text;
+                    separateFromExisting = false;
+                    this.patch(index, {
+                        text,
+                        running: false
+                    });
+                    continue;
+                }
+                if ("tool-call" === event.type) {
+                    tools.push(event.name);
+                    this.patch(index, {
+                        tools: [
+                            ...tools
+                        ],
+                        running: true,
+                        answerStart: text.length
+                    });
+                    continue;
+                }
+                if ("tool-result" === event.type) {
+                    completed.push(event.name);
+                    this.patch(index, {
+                        completed: [
+                            ...completed
+                        ]
+                    });
+                    continue;
+                }
+                if ("tool-error" === event.type) {
+                    failed.push(event.name);
+                    this.patch(index, {
+                        failed: [
+                            ...failed
+                        ]
+                    });
+                    continue;
+                }
+                if ("follow-ups" === event.type) {
+                    this.patch(index, {
+                        followUps: event.questions
+                    });
+                    continue;
+                }
+                if ("approval" === event.type) {
+                    this.patch(index, {
+                        pendingApprovals: event.approvals,
+                        running: false
+                    });
+                    continue;
+                }
+                if ("done" === event.type) {
+                    this.patch(index, {
+                        messages: [
+                            ...priorMessages,
+                            ...event.messages
+                        ],
+                        settled: true,
+                        running: false
+                    });
+                    continue;
+                }
+                if ("error" === event.type) return void this.patch(index, {
+                    error: event.message,
+                    errorCode: event.code,
+                    settled: true,
+                    running: false
+                });
+            }
+        } catch (error) {
+            if (!controller.signal.aborted) this.patch(index, {
+                error: error instanceof Error ? error.message : String(error),
+                settled: true,
+                running: false
+            });
+        } finally{
+            this.setBusy(false);
+        }
+        const turn = this.turns[index];
+        if (!controller.signal.aborted && turn?.settled && !turn.error) this.queueSave();
+    }
+    addTurn(question) {
+        this.turns = [
+            ...this.turns,
+            {
+                ...emptyTurn(question),
+                running: true
+            }
+        ];
+    }
+    replaceTurn(index, turn) {
+        this.turns = this.turns.map((existing, i)=>i === index ? turn : existing);
+    }
+    patch(index, change) {
+        this.turns = this.turns.map((turn, i)=>i === index ? {
+                ...turn,
+                ...change
+            } : turn);
+    }
+    setBusy(busy) {
+        this.busy = busy;
+    }
+    setModel(model) {
+        this.model = model;
+    }
+    setOpening(opening) {
+        this.opening = opening;
+    }
+    setConversation(chatId, turns) {
+        this.chatId = chatId;
+        this.turns = turns;
+    }
+    setSaved(chatId) {
+        this.chatId = chatId;
+        this.storageError = null;
+        this.saveFailure = null;
+    }
+    setStorageError(message) {
+        this.storageError = message;
+        this.saveFailure = null;
+    }
+    setSaveFailed(message, failure) {
+        this.storageError = message;
+        this.saveFailure = failure;
+    }
+    clearStorageError() {
+        this.storageError = null;
+        this.saveFailure = null;
+    }
+    clear() {
+        this.turns = [];
+        this.busy = false;
+        this.chatId = null;
+        this.opening = false;
+        this.storageError = null;
+        this.saveFailure = null;
+    }
+}
+const AdminAssistantPresenter_AdminAssistantPresenter = AdminAssistantPresenter.createImplementation({
+    implementation: AdminAssistantPresenterImpl,
+    dependencies: [
+        AdminAssistantGateway,
+        AiChatsRepository
+    ]
+});
+export { AdminAssistantPresenter_AdminAssistantPresenter as AdminAssistantPresenter };
+
+//# sourceMappingURL=AdminAssistantPresenter.js.map

package/features/adminAssistant/AdminAssistantPresenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/adminAssistant/AdminAssistantPresenter.js","sources":["../../../src/features/adminAssistant/AdminAssistantPresenter.ts"],"sourcesContent":["import { makeAutoObservable } from \"mobx\";\nimport { AdminAssistantGateway } from \"./abstractions.js\";\nimport type { AdminAssistantMessage, AdminAssistantRequest } from \"./abstractions.js\";\nimport {\n    AdminAssistantPresenter as Abstraction,\n    type AiTurnViewModel,\n    type IAdminAssistantViewModel\n} from \"./abstractions.js\";\nimport { AiChatsRepository } from \"~/features/aiChats/abstractions.js\";\nimport type { AiChatSaveFailure } from \"~/features/aiChats/abstractions.js\";\nimport { AiChatSaveError } from \"~/features/aiChats/AiChatSaveError.js\";\nimport { messageOf } from \"~/features/aiChats/messageOf.js\";\nimport { turnsFromMessages } from \"./turnsFromMessages.js\";\n\n/** A turn plus the conversation state the view never sees. `needsSetup` is derived from `errorCode`. */\ninterface Turn extends Omit<AiTurnViewModel, \"needsSetup\"> {\n    /** Server messages replayed to continue this conversation or resume its approval. */\n    messages: AdminAssistantMessage[];\n    /** The server's code for the failure, when it sent one. */\n    errorCode?: string;\n}\n\n/** The code a run fails with when the project's AI settings give the assistant no model. */\nconst NOT_CONFIGURED = \"AI_CAPABILITY_NOT_CONFIGURED\";\n\n/** The repository says why a save failed; anything else it threw never reached the server. */\nconst saveFailureOf = (error: unknown): AiChatSaveFailure => {\n    return error instanceof AiChatSaveError ? error.failure : \"unreachable\";\n};\n\nconst emptyTurn = (question: string): Turn => ({\n    question,\n    text: \"\",\n    answerStart: 0,\n    tools: [],\n    completed: [],\n    failed: [],\n    running: false,\n    pendingApprovals: [],\n    followUps: [],\n    messages: [],\n    settled: false\n});\n\n/**\n * Owns the palette's AI conversation.\n *\n * A presenter rather than component state: several pieces change together, a network stream drives\n * them, and an abort has to outlive any one render.\n *\n * Registered as a singleton, so `reset` genuinely clears rather than relying on unmount.\n *\n * The conversation is saved after every run that ends, so it is never more than one turn behind\n * what is on screen. The client saves rather than the stream route, which keeps the route\n * sessionless.\n */\nclass AdminAssistantPresenterImpl implements Abstraction.Interface {\n    private turns: Turn[] = [];\n    private busy = false;\n    private model: string | undefined = undefined;\n    private chatId: string | null = null;\n    private opening = false;\n    private storageError: string | null = null;\n    private saveFailure: AiChatSaveFailure | null = null;\n    private controller: AbortController | null = null;\n    /*\n     * Saves run one after another, so the second save of a new chat already has the id the first\n     * one got back, rather than creating a second chat.\n     */\n    private saving: Promise<void> = Promise.resolve();\n    /*\n     * Bumped whenever the conversation is replaced. A save or an open that finishes after that\n     * belongs to a conversation that is gone, and must not write its id onto the new one.\n     */\n    private generation = 0;\n\n    constructor(\n        private gateway: AdminAssistantGateway.Interface,\n        private chats: AiChatsRepository.Interface\n    ) {\n        // Machinery, not state anything renders, so keep them out of the map.\n        makeAutoObservable<\n            AdminAssistantPresenterImpl,\n            \"controller\" | \"saving\" | \"generation\" | \"chats\"\n        >(this, { controller: false, saving: false, generation: false, chats: false });\n    }\n\n    get vm(): IAdminAssistantViewModel {\n        const vm: IAdminAssistantViewModel = {\n            busy: this.busy,\n            chatId: this.chatId,\n            opening: this.opening,\n            storageError: this.storageError,\n            saveFailure: this.saveFailure,\n            savePaused: this.savePaused,\n            setupRequired: this.setupRequired,\n            turns: this.turns.map(turn => {\n                const view: AiTurnViewModel = {\n                    question: turn.question,\n                    text: turn.text,\n                    answerStart: turn.answerStart,\n                    tools: turn.tools,\n                    completed: turn.completed,\n                    failed: turn.failed,\n                    running: turn.running,\n                    pendingApprovals: turn.pendingApprovals,\n                    followUps: turn.followUps,\n                    settled: turn.settled,\n                    needsSetup: turn.errorCode === NOT_CONFIGURED\n                };\n\n                if (turn.error !== undefined) {\n                    view.error = turn.error;\n                }\n\n                return view;\n            })\n        };\n\n        if (this.model !== undefined) {\n            vm.model = this.model;\n        }\n\n        return vm;\n    }\n\n    ask(question: string): void {\n        const trimmed = question.trim();\n\n        /*\n         * While a saved chat loads, a question would land in a conversation about to be replaced.\n         * With no model set up it would fail the same way, so only \"Try again\" asks.\n         */\n        if (!trimmed || this.busy || this.opening || this.setupRequired) {\n            return;\n        }\n\n        const index = this.turns.length;\n        this.addTurn(trimmed);\n\n        void this.run(index, {\n            messages: [...this.historyBefore(index), { role: \"user\", content: trimmed }]\n        });\n    }\n\n    decide(turnIndex: number, approved: boolean): void {\n        const turn = this.turns[turnIndex];\n\n        if (!turn?.pendingApprovals.length || this.busy || this.opening) {\n            return;\n        }\n\n        const approvals = turn.pendingApprovals.map(approval => ({\n            approvalId: approval.approvalId,\n            approved\n        }));\n\n        /*\n         * The paused assistant message must be replayed unchanged: the approval request lives only in\n         * the server's messages, so resuming means sending the same history back plus the decision.\n         */\n        const messages: AdminAssistantMessage[] = [\n            ...this.historyBefore(turnIndex),\n            { role: \"user\", content: turn.question },\n            ...turn.messages\n        ];\n\n        // Clear the block immediately so the plan cannot be submitted twice.\n        this.patch(turnIndex, {\n            pendingApprovals: [],\n            followUps: [],\n            settled: false,\n            running: true\n        });\n\n        void this.run(turnIndex, { messages, approvals }, true);\n    }\n\n    /*\n     * The failed turn is run again in place, from an empty answer. Its history is everything\n     * before it, which a failed turn never joins, so the retry asks with the same context.\n     */\n    retry(): void {\n        const index = this.turns.length - 1;\n        const turn = this.turns[index];\n\n        if (!turn?.error || this.busy || this.opening) {\n            return;\n        }\n\n        const fresh = emptyTurn(turn.question);\n        this.replaceTurn(index, { ...fresh, running: true });\n\n        const history = this.historyBefore(index);\n        void this.run(index, {\n            messages: [...history, { role: \"user\", content: turn.question }]\n        });\n    }\n\n    /*\n     * While a turn waits on an approval no save can run, so the warning stays until the save after\n     * the decision clears it. The view shows `savePaused` instead of a Retry that would do nothing.\n     */\n    retrySave(): void {\n        if (!this.saveFailure || this.savePaused) {\n            return;\n        }\n        this.clearStorageError();\n        this.queueSave();\n    }\n\n    /*\n     * A turn waiting on an approval is not saved yet: its paused request has no answer, and\n     * replaying it unanswered later would not resume it. The save after the decision covers it.\n     */\n    private get savePaused(): boolean {\n        return this.turns.some(turn => turn.pendingApprovals.length > 0);\n    }\n\n    private get setupRequired(): boolean {\n        const newest = this.turns[this.turns.length - 1];\n        return newest?.errorCode === NOT_CONFIGURED;\n    }\n\n    reset(): void {\n        this.controller?.abort();\n        this.controller = null;\n        this.generation++;\n        this.clear();\n    }\n\n    async open(chatId: string): Promise<void> {\n        this.reset();\n        const generation = this.generation;\n        this.setOpening(true);\n\n        try {\n            const chat = await this.chats.get(chatId);\n            if (generation !== this.generation) {\n                return;\n            }\n            const turns = turnsFromMessages(chat.messages);\n            this.setConversation(chat.id, turns);\n        } catch (error) {\n            if (generation === this.generation) {\n                const message = messageOf(error);\n                this.setStorageError(message);\n            }\n        } finally {\n            if (generation === this.generation) {\n                this.setOpening(false);\n            }\n        }\n    }\n\n    // Queued behind any save still in flight. Nothing is saved while `savePaused`.\n    private queueSave(): void {\n        const messages = this.historyBefore(this.turns.length);\n\n        if (this.savePaused || messages.length === 0) {\n            return;\n        }\n\n        const generation = this.generation;\n        this.saving = this.saving.then(() => this.save(generation, messages));\n    }\n\n    private async save(generation: number, messages: AdminAssistantMessage[]): Promise<void> {\n        if (generation !== this.generation) {\n            return;\n        }\n\n        try {\n            const input: AiChatsRepository.SaveInput = { messages };\n            if (this.chatId) {\n                input.id = this.chatId;\n            }\n\n            const summary = await this.chats.save(input);\n            if (generation === this.generation) {\n                this.setSaved(summary.id);\n            }\n        } catch (error) {\n            if (generation === this.generation) {\n                const message = messageOf(error);\n                const failure = saveFailureOf(error);\n                this.setSaveFailed(message, failure);\n            }\n        }\n    }\n\n    /** Replays settled turns so a follow-up (\"and which of those is cheapest?\") has context. */\n    private historyBefore(upTo: number): AdminAssistantMessage[] {\n        const history: AdminAssistantMessage[] = [];\n\n        for (const turn of this.turns.slice(0, upTo)) {\n            if (!turn.settled || turn.error) {\n                continue;\n            }\n            history.push({ role: \"user\", content: turn.question });\n            history.push(...turn.messages);\n        }\n\n        return history;\n    }\n\n    private async run(\n        index: number,\n        request: AdminAssistantRequest,\n        resuming = false\n    ): Promise<void> {\n        this.controller?.abort();\n        const controller = new AbortController();\n        this.controller = controller;\n\n        this.setBusy(true);\n\n        try {\n            /*\n             * Resuming continues the same turn: the tools already called, the text already shown and\n             * the messages already collected all still belong to it. Starting from empty would strand\n             * earlier chips as running and, worse, drop the assistant message carrying the `tool_use`\n             * that the replayed `tool_result` refers to.\n             */\n            const existing = resuming ? this.turns[index] : undefined;\n            let text = existing?.text ?? \"\";\n            const tools: string[] = existing ? [...existing.tools] : [];\n            const completed: string[] = existing ? [...existing.completed] : [];\n            const failed: string[] = existing ? [...existing.failed] : [];\n            const priorMessages: AdminAssistantMessage[] = existing ? [...existing.messages] : [];\n            /*\n             * A resumed run writes on after the text shown before the approval pause. Without a\n             * break, the two ran together (\"...a new folder:Understood, no folder was created.\").\n             */\n            let separateFromExisting = text.length > 0;\n\n            for await (const event of this.gateway.stream(request, controller.signal)) {\n                if (event.type === \"start\") {\n                    this.setModel(event.model);\n                    continue;\n                }\n\n                if (event.type === \"text\") {\n                    text += separateFromExisting ? `\\n\\n${event.text}` : event.text;\n                    separateFromExisting = false;\n                    this.patch(index, { text, running: false });\n                    continue;\n                }\n\n                if (event.type === \"tool-call\") {\n                    tools.push(event.name);\n                    this.patch(index, {\n                        tools: [...tools],\n                        running: true,\n                        answerStart: text.length\n                    });\n                    continue;\n                }\n\n                if (event.type === \"tool-result\") {\n                    completed.push(event.name);\n                    this.patch(index, { completed: [...completed] });\n                    continue;\n                }\n\n                if (event.type === \"tool-error\") {\n                    failed.push(event.name);\n                    this.patch(index, { failed: [...failed] });\n                    continue;\n                }\n\n                if (event.type === \"follow-ups\") {\n                    this.patch(index, { followUps: event.questions });\n                    continue;\n                }\n\n                if (event.type === \"approval\") {\n                    this.patch(index, { pendingApprovals: event.approvals, running: false });\n                    continue;\n                }\n\n                if (event.type === \"done\") {\n                    this.patch(index, {\n                        messages: [...priorMessages, ...event.messages],\n                        settled: true,\n                        running: false\n                    });\n                    continue;\n                }\n\n                if (event.type === \"error\") {\n                    this.patch(index, {\n                        error: event.message,\n                        errorCode: event.code,\n                        settled: true,\n                        running: false\n                    });\n                    return;\n                }\n            }\n        } catch (error) {\n            // An abort is the palette closing, not a failure worth showing.\n            if (!controller.signal.aborted) {\n                this.patch(index, {\n                    error: error instanceof Error ? error.message : String(error),\n                    settled: true,\n                    running: false\n                });\n            }\n        } finally {\n            this.setBusy(false);\n        }\n\n        // A failed turn is left out of the history, so saving after it would change nothing.\n        const turn = this.turns[index];\n        if (!controller.signal.aborted && turn?.settled && !turn.error) {\n            this.queueSave();\n        }\n    }\n\n    /*\n     * Every mutation below is its own method on purpose. `run` awaits, and a mutation after an await\n     * has escaped the action it started in; `makeAutoObservable` makes these methods actions, so\n     * calling them from there is correct.\n     */\n    private addTurn(question: string): void {\n        this.turns = [...this.turns, { ...emptyTurn(question), running: true }];\n    }\n\n    private replaceTurn(index: number, turn: Turn): void {\n        this.turns = this.turns.map((existing, i) => (i === index ? turn : existing));\n    }\n\n    private patch(index: number, change: Partial<Turn>): void {\n        this.turns = this.turns.map((turn, i) => (i === index ? { ...turn, ...change } : turn));\n    }\n\n    private setBusy(busy: boolean): void {\n        this.busy = busy;\n    }\n\n    private setModel(model: string): void {\n        this.model = model;\n    }\n\n    private setOpening(opening: boolean): void {\n        this.opening = opening;\n    }\n\n    private setConversation(chatId: string, turns: Turn[]): void {\n        this.chatId = chatId;\n        this.turns = turns;\n    }\n\n    private setSaved(chatId: string): void {\n        this.chatId = chatId;\n        this.storageError = null;\n        this.saveFailure = null;\n    }\n\n    private setStorageError(message: string): void {\n        this.storageError = message;\n        this.saveFailure = null;\n    }\n\n    private setSaveFailed(message: string, failure: AiChatSaveFailure): void {\n        this.storageError = message;\n        this.saveFailure = failure;\n    }\n\n    private clearStorageError(): void {\n        this.storageError = null;\n        this.saveFailure = null;\n    }\n\n    private clear(): void {\n        this.turns = [];\n        this.busy = false;\n        this.chatId = null;\n        this.opening = false;\n        this.storageError = null;\n        this.saveFailure = null;\n    }\n}\n\nexport const AdminAssistantPresenter = Abstraction.createImplementation({\n    implementation: AdminAssistantPresenterImpl,\n    dependencies: [AdminAssistantGateway, AiChatsRepository]\n});\n"],"names":["NOT_CONFIGURED","saveFailureOf","error","AiChatSaveError","emptyTurn","question","AdminAssistantPresenterImpl","gateway","chats","undefined","Promise","makeAutoObservable","vm","turn","view","trimmed","index","turnIndex","approved","approvals","approval","messages","fresh","history","newest","chatId","generation","chat","turns","turnsFromMessages","message","messageOf","input","summary","failure","upTo","request","resuming","controller","AbortController","existing","text","tools","completed","failed","priorMessages","separateFromExisting","event","Error","String","i","change","busy","model","opening","AdminAssistantPresenter","Abstraction","AdminAssistantGateway","AiChatsRepository"],"mappings":"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"}

package/features/adminAssistant/abstractions.d.ts

@@ -0,0 +1,176 @@
+import type { AiChatSaveFailure } from "../../features/aiChats/abstractions.js";
+/**
+ * Messages are opaque here on purpose. Beyond plain user/assistant turns the server also returns
+ * assistant and tool messages carrying approval requests, which must be replayed VERBATIM for the
+ * agent loop to resume — the request exists nowhere else, since the server keeps no session.
+ */
+export type AdminAssistantMessage = {
+    role: string;
+    content: unknown;
+};
+/** A tool the assistant invoked, so the UI can show its work rather than just an answer. */
+export interface AdminAssistantToolCall {
+    name: string;
+    input: unknown;
+}
+/** A tool call the assistant wants to make but has not made, because it changes something. */
+export interface AdminAssistantPendingApproval {
+    approvalId: string;
+    toolName: string;
+    title?: string;
+    input: unknown;
+    /** The tool declared itself destructive — the UI should say so more loudly. */
+    destructive: boolean;
+}
+export interface AdminAssistantDecision {
+    approvalId: string;
+    approved: boolean;
+    reason?: string;
+}
+export interface AdminAssistantRequest {
+    messages: AdminAssistantMessage[];
+    /** Approve or reject calls the server paused on. */
+    approvals?: AdminAssistantDecision[];
+}
+/**
+ * What the assistant emits while it works. Mirrors the server's `AdminAssistantEvent`; declared here so the
+ * admin bundle carries no server or AI SDK code.
+ */
+export type AdminAssistantStreamEvent = {
+    type: "start";
+    model: string;
+} | {
+    type: "text";
+    text: string;
+} | {
+    type: "tool-call";
+    name: string;
+} | {
+    type: "tool-result";
+    name: string;
+} | {
+    type: "tool-error";
+    name: string;
+    message: string;
+} | {
+    type: "follow-ups";
+    questions: string[];
+} | {
+    type: "approval";
+    approvals: AdminAssistantPendingApproval[];
+} | {
+    type: "done";
+    messages: AdminAssistantMessage[];
+    steps: number;
+} | {
+    type: "error";
+    message: string;
+    code?: "AI_CAPABILITY_NOT_CONFIGURED";
+};
+export interface IAdminAssistantGateway {
+    /**
+     * Run and yield progress as it arrives. Preferred in the UI: a multi-tool question takes tens of
+     * seconds, and an approval request is worth showing the moment it appears.
+     */
+    stream(request: AdminAssistantRequest, signal?: AbortSignal): AsyncIterable<AdminAssistantStreamEvent>;
+}
+/** Sends a question to the server-side AI assistant (`POST /ai/chat`). */
+export declare const AdminAssistantGateway: import("@webiny/di").Abstraction<IAdminAssistantGateway>;
+export declare namespace AdminAssistantGateway {
+    type Interface = IAdminAssistantGateway;
+    type Message = AdminAssistantMessage;
+    type ToolCall = AdminAssistantToolCall;
+    type PendingApproval = AdminAssistantPendingApproval;
+    type Decision = AdminAssistantDecision;
+    type Request = AdminAssistantRequest;
+    type StreamEvent = AdminAssistantStreamEvent;
+}
+/**
+ * One question and the answer to it, as the view needs it.
+ *
+ * The server messages that make a follow-up or a resumed approval work are deliberately absent: they
+ * are conversation state, not something rendered, so they stay inside the presenter.
+ */
+export interface AiTurnViewModel {
+    question: string;
+    /** Answer text so far. Grows as the stream arrives. */
+    text: string;
+    /**
+     * Where the answer proper starts in `text`: after the last tool call. Text before it is the
+     * model saying what it is about to look up, which is no summary of the answer.
+     */
+    answerStart: number;
+    /** Tools called this turn, in call order. */
+    tools: string[];
+    /**
+     * Tools that returned. A call pending approval still emits `tool-call`, so this is the only way
+     * to tell a completed tool from one merely proposed.
+     */
+    completed: string[];
+    /** Tools that threw. Settles the chip as a failure; the run continues. */
+    failed: string[];
+    /** Set while a tool is running and no answer text has arrived yet. */
+    running: boolean;
+    pendingApprovals: AdminAssistantPendingApproval[];
+    /** Questions the assistant suggests asking next. Empty until the answer is in. */
+    followUps: string[];
+    settled: boolean;
+    error?: string;
+    /**
+     * The turn failed because the project has no model set up. Shown as a setup screen rather
+     * than an error; `error` holds the server's reason, which names the setting to fix.
+     */
+    needsSetup: boolean;
+}
+export interface IAdminAssistantViewModel {
+    turns: AiTurnViewModel[];
+    /** A run is in flight. Asking again or deciding again is refused while true. */
+    busy: boolean;
+    /**
+     * The model the last run used, fully qualified. Absent before the first run, since the admin
+     * only learns it from the server.
+     */
+    model?: string;
+    /** The saved chat this conversation is, once its first turn is saved or a chat is opened. */
+    chatId: string | null;
+    /** A saved chat is being read. */
+    opening: boolean;
+    /**
+     * Why the last save or open failed. The conversation on screen carries on either way; this is
+     * only so the view can say it is not saved.
+     */
+    storageError: string | null;
+    /** Set when it was a save that failed, so the view can offer what fixes it. Null for an open. */
+    saveFailure: AiChatSaveFailure | null;
+    /**
+     * A turn waits on an approval, so no save runs until it is decided. Retrying a failed save
+     * would do nothing, so the view can say the save follows the decision instead.
+     */
+    savePaused: boolean;
+    /**
+     * The newest turn needs a model set up first. No question is taken until "Try again" (`retry`)
+     * succeeds, so the view can stop taking input.
+     */
+    setupRequired: boolean;
+}
+export interface IAdminAssistantPresenter {
+    readonly vm: IAdminAssistantViewModel;
+    /** Ask a question, carrying the settled turns before it as context. Refused while `setupRequired`. */
+    ask(question: string): void;
+    /** Approve or reject the calls a turn paused on, then resume it. */
+    decide(turnIndex: number, approved: boolean): void;
+    /** Drop the conversation and stop anything in flight. The saved chat is kept. */
+    reset(): void;
+    /** Replace the conversation with a saved chat, so asking again continues it. */
+    open(chatId: string): Promise<void>;
+    /** Ask the newest question again, when its run failed. */
+    retry(): void;
+    /** Try the failed save again. */
+    retrySave(): void;
+}
+export declare const AdminAssistantPresenter: import("@webiny/di").Abstraction<IAdminAssistantPresenter>;
+export declare namespace AdminAssistantPresenter {
+    type Interface = IAdminAssistantPresenter;
+    type ViewModel = IAdminAssistantViewModel;
+    type Turn = AiTurnViewModel;
+}

package/features/adminAssistant/abstractions.js

@@ -0,0 +1,6 @@
+import { createAbstraction } from "@webiny/feature/admin";
+const AdminAssistantGateway = createAbstraction("AdminAssistantGateway");
+const AdminAssistantPresenter = createAbstraction("AdminAssistantPresenter");
+export { AdminAssistantGateway, AdminAssistantPresenter };
+
+//# sourceMappingURL=abstractions.js.map

package/features/adminAssistant/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/adminAssistant/abstractions.js","sources":["../../../src/features/adminAssistant/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/admin\";\nimport type { AiChatSaveFailure } from \"~/features/aiChats/abstractions.js\";\n\n/**\n * Messages are opaque here on purpose. Beyond plain user/assistant turns the server also returns\n * assistant and tool messages carrying approval requests, which must be replayed VERBATIM for the\n * agent loop to resume — the request exists nowhere else, since the server keeps no session.\n */\nexport type AdminAssistantMessage = { role: string; content: unknown };\n\n/** A tool the assistant invoked, so the UI can show its work rather than just an answer. */\nexport interface AdminAssistantToolCall {\n    name: string;\n    input: unknown;\n}\n\n/** A tool call the assistant wants to make but has not made, because it changes something. */\nexport interface AdminAssistantPendingApproval {\n    approvalId: string;\n    toolName: string;\n    title?: string;\n    input: unknown;\n    /** The tool declared itself destructive — the UI should say so more loudly. */\n    destructive: boolean;\n}\n\nexport interface AdminAssistantDecision {\n    approvalId: string;\n    approved: boolean;\n    reason?: string;\n}\n\nexport interface AdminAssistantRequest {\n    messages: AdminAssistantMessage[];\n    /** Approve or reject calls the server paused on. */\n    approvals?: AdminAssistantDecision[];\n}\n\n/**\n * What the assistant emits while it works. Mirrors the server's `AdminAssistantEvent`; declared here so the\n * admin bundle carries no server or AI SDK code.\n */\nexport type AdminAssistantStreamEvent =\n    // The run is going ahead, on this model (\"anthropic/claude-sonnet-4-5\").\n    | { type: \"start\"; model: string }\n    | { type: \"text\"; text: string }\n    | { type: \"tool-call\"; name: string }\n    | { type: \"tool-result\"; name: string }\n    // A tool threw. Pairs with `tool-call` by name, and does not end the run.\n    | { type: \"tool-error\"; name: string; message: string }\n    | { type: \"follow-ups\"; questions: string[] }\n    | { type: \"approval\"; approvals: AdminAssistantPendingApproval[] }\n    | { type: \"done\"; messages: AdminAssistantMessage[]; steps: number }\n    | { type: \"error\"; message: string; code?: \"AI_CAPABILITY_NOT_CONFIGURED\" };\n\nexport interface IAdminAssistantGateway {\n    /**\n     * Run and yield progress as it arrives. Preferred in the UI: a multi-tool question takes tens of\n     * seconds, and an approval request is worth showing the moment it appears.\n     */\n    stream(\n        request: AdminAssistantRequest,\n        signal?: AbortSignal\n    ): AsyncIterable<AdminAssistantStreamEvent>;\n}\n\n/** Sends a question to the server-side AI assistant (`POST /ai/chat`). */\nexport const AdminAssistantGateway =\n    createAbstraction<IAdminAssistantGateway>(\"AdminAssistantGateway\");\n\nexport namespace AdminAssistantGateway {\n    export type Interface = IAdminAssistantGateway;\n    export type Message = AdminAssistantMessage;\n    export type ToolCall = AdminAssistantToolCall;\n    export type PendingApproval = AdminAssistantPendingApproval;\n    export type Decision = AdminAssistantDecision;\n    export type Request = AdminAssistantRequest;\n    export type StreamEvent = AdminAssistantStreamEvent;\n}\n\n/**\n * One question and the answer to it, as the view needs it.\n *\n * The server messages that make a follow-up or a resumed approval work are deliberately absent: they\n * are conversation state, not something rendered, so they stay inside the presenter.\n */\nexport interface AiTurnViewModel {\n    question: string;\n    /** Answer text so far. Grows as the stream arrives. */\n    text: string;\n    /**\n     * Where the answer proper starts in `text`: after the last tool call. Text before it is the\n     * model saying what it is about to look up, which is no summary of the answer.\n     */\n    answerStart: number;\n    /** Tools called this turn, in call order. */\n    tools: string[];\n    /**\n     * Tools that returned. A call pending approval still emits `tool-call`, so this is the only way\n     * to tell a completed tool from one merely proposed.\n     */\n    completed: string[];\n    /** Tools that threw. Settles the chip as a failure; the run continues. */\n    failed: string[];\n    /** Set while a tool is running and no answer text has arrived yet. */\n    running: boolean;\n    pendingApprovals: AdminAssistantPendingApproval[];\n    /** Questions the assistant suggests asking next. Empty until the answer is in. */\n    followUps: string[];\n    settled: boolean;\n    error?: string;\n    /**\n     * The turn failed because the project has no model set up. Shown as a setup screen rather\n     * than an error; `error` holds the server's reason, which names the setting to fix.\n     */\n    needsSetup: boolean;\n}\n\nexport interface IAdminAssistantViewModel {\n    turns: AiTurnViewModel[];\n    /** A run is in flight. Asking again or deciding again is refused while true. */\n    busy: boolean;\n    /**\n     * The model the last run used, fully qualified. Absent before the first run, since the admin\n     * only learns it from the server.\n     */\n    model?: string;\n    /** The saved chat this conversation is, once its first turn is saved or a chat is opened. */\n    chatId: string | null;\n    /** A saved chat is being read. */\n    opening: boolean;\n    /**\n     * Why the last save or open failed. The conversation on screen carries on either way; this is\n     * only so the view can say it is not saved.\n     */\n    storageError: string | null;\n    /** Set when it was a save that failed, so the view can offer what fixes it. Null for an open. */\n    saveFailure: AiChatSaveFailure | null;\n    /**\n     * A turn waits on an approval, so no save runs until it is decided. Retrying a failed save\n     * would do nothing, so the view can say the save follows the decision instead.\n     */\n    savePaused: boolean;\n    /**\n     * The newest turn needs a model set up first. No question is taken until \"Try again\" (`retry`)\n     * succeeds, so the view can stop taking input.\n     */\n    setupRequired: boolean;\n}\n\nexport interface IAdminAssistantPresenter {\n    readonly vm: IAdminAssistantViewModel;\n    /** Ask a question, carrying the settled turns before it as context. Refused while `setupRequired`. */\n    ask(question: string): void;\n    /** Approve or reject the calls a turn paused on, then resume it. */\n    decide(turnIndex: number, approved: boolean): void;\n    /** Drop the conversation and stop anything in flight. The saved chat is kept. */\n    reset(): void;\n    /** Replace the conversation with a saved chat, so asking again continues it. */\n    open(chatId: string): Promise<void>;\n    /** Ask the newest question again, when its run failed. */\n    retry(): void;\n    /** Try the failed save again. */\n    retrySave(): void;\n}\n\nexport const AdminAssistantPresenter =\n    createAbstraction<IAdminAssistantPresenter>(\"AdminAssistantPresenter\");\n\nexport namespace AdminAssistantPresenter {\n    export type Interface = IAdminAssistantPresenter;\n    export type ViewModel = IAdminAssistantViewModel;\n    export type Turn = AiTurnViewModel;\n}\n"],"names":["AdminAssistantGateway","createAbstraction","AdminAssistantPresenter"],"mappings":";AAmEO,MAAMA,wBACTC,kBAA0C;AAkGvC,MAAMC,0BACTD,kBAA4C"}

package/features/adminAssistant/feature.d.ts

@@ -0,0 +1,3 @@
+export declare const AdminAssistantFeature: import("@webiny/feature/admin").FeatureDefinition<{
+    presenter: import("./abstractions.js").IAdminAssistantPresenter;
+}, []>;

package/features/adminAssistant/feature.js

@@ -0,0 +1,19 @@
+import { createFeature } from "@webiny/feature/admin";
+import { AdminAssistantGateway } from "./AdminAssistantGateway.js";
+import { AdminAssistantPresenter } from "./AdminAssistantPresenter.js";
+import { AdminAssistantPresenter as external_abstractions_js_AdminAssistantPresenter } from "./abstractions.js";
+const AdminAssistantFeature = createFeature({
+    name: "AdminAssistant",
+    register (container) {
+        container.register(AdminAssistantGateway);
+        container.register(AdminAssistantPresenter).inSingletonScope();
+    },
+    resolve (container) {
+        return {
+            presenter: container.resolve(external_abstractions_js_AdminAssistantPresenter)
+        };
+    }
+});
+export { AdminAssistantFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/adminAssistant/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/adminAssistant/feature.js","sources":["../../../src/features/adminAssistant/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/admin\";\nimport { AdminAssistantGateway } from \"./AdminAssistantGateway.js\";\nimport { AdminAssistantPresenter } from \"./AdminAssistantPresenter.js\";\nimport { AdminAssistantPresenter as Abstraction } from \"./abstractions.js\";\n\nexport const AdminAssistantFeature = createFeature({\n    name: \"AdminAssistant\",\n    register(container) {\n        container.register(AdminAssistantGateway);\n        // Singleton so the conversation survives re-renders of the palette that reads it.\n        container.register(AdminAssistantPresenter).inSingletonScope();\n    },\n    resolve(container) {\n        return { presenter: container.resolve(Abstraction) };\n    }\n});\n"],"names":["AdminAssistantFeature","createFeature","container","AdminAssistantGateway","AdminAssistantPresenter","Abstraction"],"mappings":";;;;AAKO,MAAMA,wBAAwBC,cAAc;IAC/C,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;QAEnBD,UAAU,QAAQ,CAACE,yBAAyB,gBAAgB;IAChE;IACA,SAAQF,SAAS;QACb,OAAO;YAAE,WAAWA,UAAU,OAAO,CAACG;QAAa;IACvD;AACJ"}