@inspectr/mcplab 1.30.0 → 1.31.1

package/dist/app-server/assistant-graph-nodes.js

@@ -0,0 +1,365 @@
+import { AIMessage } from '@langchain/core/messages';
+import { Command, END, interrupt, START, StateGraph } from '@langchain/langgraph';
+import { randomUUID } from 'node:crypto';
+import { classifyToolCalls, createPendingToolCall, MAX_ASSISTANT_MODEL_CALLS, mergeAssistantSuggestions, OVERSIZED_ASSISTANT_TOOL_BATCH_ERROR, raceAssistantAbort, terminalToolFeedback, terminalToolStatus } from './assistant-runtime-policy.js';
+import { State, messageId, persistNativeMessage, toPersistedToolRequest, hasResult, addResult, addResults, withToolMessages } from './assistant-graph-state.js';
+const commandNode = (handler) => async (state, config) => {
+    const { goto, events = [], ...update } = await handler(state, config);
+    for (const next of events)
+        config.writer?.(next);
+    return new Command({ goto: goto === 'end' ? END : goto, update });
+};
+export function createAssistantGraph(definition, modelCall, saver) {
+    const event = (type, payload = {}) => ({
+        id: randomUUID(),
+        type,
+        payload
+    });
+    const cleanupUpdate = (state, reason, error) => {
+        const detail = error instanceof Error ? error.message : String(error ?? '');
+        const updates = {
+            terminal: reason,
+            proposals: [],
+            goto: 'finish',
+            error: detail || undefined,
+            budgetExceeded: reason === 'budget'
+        };
+        const callsToResolve = state.calls.filter((call) => state.batchIds.includes(call.id) && !hasResult(state.results, call.id));
+        const resolved = addResults(state, callsToResolve, (call) => {
+            const feedback = terminalToolFeedback(reason, call, state.executingId, error);
+            return {
+                content: JSON.stringify({ error: feedback }),
+                status: terminalToolStatus(reason, call, state.executingId),
+                error: feedback
+            };
+        }, event);
+        Object.assign(updates, { ...resolved, executingId: undefined });
+        const combined = { ...state, ...updates };
+        return { ...withToolMessages(combined), ...updates, results: {}, goto: 'finish' };
+    };
+    const executionContinuation = (state, next, id, proposals = state.proposals) => {
+        const rest = state.decisions.some((decision) => decision.toolCallId !== id &&
+            next.calls.find((item) => item.id === decision.toolCallId)?.status === 'approved' &&
+            !hasResult(next.results, decision.toolCallId));
+        const unresolved = state.batchIds.filter((candidate) => !hasResult(next.results, candidate));
+        const partial = !rest && state.decisions.length > 0 && unresolved.length > 0;
+        return {
+            ...next,
+            proposals,
+            decisions: rest ? state.decisions : [],
+            executingId: undefined,
+            goto: rest ? 'select' : partial ? 'approval' : 'policy',
+            ...(partial
+                ? {
+                    response: {
+                        type: 'tool_call_resolved',
+                        text: '',
+                        pendingToolCalls: next.calls.filter((item) => unresolved.includes(item.id))
+                    }
+                }
+                : {})
+        };
+    };
+    const graph = new StateGraph(State)
+        .addNode('model', commandNode(async (state, config) => {
+        const signal = config.configurable?.requestSignal;
+        if (signal?.aborted)
+            return cleanupUpdate({ ...state, executingId: undefined }, state.terminal ?? 'cancelled');
+        if (state.rounds >= MAX_ASSISTANT_MODEL_CALLS)
+            return cleanupUpdate(state, 'budget');
+        const rounds = state.rounds + 1;
+        const assistantMessageId = messageId();
+        const createdAt = new Date().toISOString();
+        let textOffset = 0;
+        try {
+            const output = await raceAssistantAbort(modelCall(definition, [...state.messages], signal, (delta) => {
+                if (delta && !signal?.aborted) {
+                    config.writer?.({
+                        id: randomUUID(),
+                        type: 'assistant_message_delta',
+                        payload: {
+                            turnId: state.turnId,
+                            messageId: assistantMessageId,
+                            offset: textOffset,
+                            delta,
+                            createdAt
+                        }
+                    });
+                    textOffset += delta.length;
+                }
+            }), signal);
+            if (signal?.aborted)
+                return cleanupUpdate(state, 'cancelled');
+            if (output.type === 'assistant_message') {
+                const suggestions = mergeAssistantSuggestions(state.proposals);
+                const ui = {
+                    id: assistantMessageId,
+                    role: 'assistant',
+                    text: output.text,
+                    createdAt,
+                    ...(suggestions ? { suggestions } : {})
+                };
+                const ai = output.nativeMessage ?? new AIMessage({ content: output.text });
+                const persisted = persistNativeMessage(ai, state.messages);
+                return {
+                    messages: [persisted],
+                    uiMessages: [ui],
+                    proposals: [],
+                    rounds,
+                    response: {
+                        type: 'assistant_message',
+                        text: output.text,
+                        ...(suggestions ? { suggestions } : {})
+                    },
+                    goto: 'end',
+                    terminal: undefined,
+                    events: [
+                        event('assistant_message_completed', {
+                            text: output.text,
+                            ...(suggestions ? { suggestions } : {})
+                        })
+                    ]
+                };
+            }
+            const ids = new Set(state.calls.map((call) => call.id));
+            const calls = output.toolCalls.map((call) => createPendingToolCall(definition, call, ids));
+            const incoming = toPersistedToolRequest(output.nativeMessage ?? new AIMessage({ content: output.text }), calls);
+            const persisted = persistNativeMessage(incoming, state.messages);
+            const ui = {
+                id: assistantMessageId,
+                role: 'assistant',
+                text: output.text,
+                createdAt,
+                pendingToolCallId: calls[0]?.id,
+                pendingToolCallIds: calls.map((call) => call.id),
+                toolRequestServer: calls[0]?.server,
+                toolRequestName: calls[0]?.tool,
+                toolRequestPublicName: calls[0]?.publicToolName
+            };
+            return {
+                messages: [persisted],
+                uiMessages: [ui],
+                calls: [...state.calls, ...calls],
+                batchIds: calls.map((call) => call.id),
+                results: {},
+                rounds,
+                response: { type: 'tool_call_request', text: output.text, pendingToolCalls: calls },
+                goto: 'policy',
+                events: []
+            };
+        }
+        catch (error) {
+            return cleanupUpdate(state, signal?.aborted ? 'cancelled' : 'failure', error);
+        }
+    }), { ends: ['policy', 'finish', END] })
+        .addNode('policy', commandNode((state) => {
+        const batch = state.calls.filter((call) => state.batchIds.includes(call.id));
+        if (state.rounds >= MAX_ASSISTANT_MODEL_CALLS)
+            return cleanupUpdate(state, 'budget');
+        const { oversized, unknown, invalid, local, validExternal, needsApproval } = classifyToolCalls(definition, batch);
+        if (oversized) {
+            const update = addResults(state, batch, () => ({
+                content: JSON.stringify({ error: OVERSIZED_ASSISTANT_TOOL_BATCH_ERROR }),
+                status: 'error',
+                error: OVERSIZED_ASSISTANT_TOOL_BATCH_ERROR
+            }), event);
+            return {
+                ...update,
+                ...withToolMessages({ ...state, ...update }),
+                results: {},
+                goto: 'model'
+            };
+        }
+        const update = addResults(state, [...unknown, ...invalid], (call) => {
+            const message = call.validationError ?? `Unknown assistant tool '${call.publicToolName}'`;
+            return { content: JSON.stringify({ error: message }), status: 'error', error: message };
+        }, event);
+        const current = { ...state, ...update };
+        const localPending = local.find((call) => !hasResult(current.results, call.id));
+        if (localPending) {
+            const calls = current.calls.map((call) => call.id === localPending.id ? { ...call, status: 'approved' } : call);
+            return { ...update, calls, executingId: undefined, goto: 'select' };
+        }
+        const waiting = validExternal.filter((call) => !hasResult(current.results, call.id));
+        if (needsApproval && waiting.length)
+            return {
+                ...update,
+                goto: 'approval',
+                response: {
+                    type: 'tool_call_request',
+                    text: state.response?.text ?? '',
+                    pendingToolCalls: waiting
+                },
+                events: [
+                    ...(update.events ?? []),
+                    event('tool_call_requested', {
+                        pendingToolCalls: waiting,
+                        pendingToolCallId: waiting[0]?.id
+                    })
+                ]
+            };
+        if (waiting.length) {
+            const calls = current.calls.map((call) => waiting.some((item) => item.id === call.id)
+                ? { ...call, status: 'approved' }
+                : call);
+            return {
+                ...update,
+                calls,
+                decisions: waiting.map((call) => ({
+                    toolCallId: call.id,
+                    decision: 'approve'
+                })),
+                executingId: undefined,
+                goto: 'select',
+                events: [
+                    ...(update.events ?? []),
+                    ...waiting.map((call) => event('tool_call_approved', { pendingToolCallId: call.id }))
+                ]
+            };
+        }
+        return {
+            ...update,
+            ...withToolMessages({ ...state, ...update }),
+            results: {},
+            goto: 'model'
+        };
+    }), { ends: ['approval', 'select', 'model', 'finish'] })
+        .addNode('approval', commandNode((state, config) => {
+        const signal = config.configurable?.requestSignal;
+        if (signal?.aborted)
+            return {
+                terminal: 'cancelled',
+                goto: 'cleanup'
+            };
+        const resume = interrupt({
+            calls: state.calls.filter((call) => state.batchIds.includes(call.id) && !hasResult(state.results, call.id))
+        });
+        if (!Array.isArray(resume))
+            return {
+                terminal: resume.terminal,
+                error: resume.error,
+                goto: 'cleanup'
+            };
+        return { decisions: resume, goto: 'apply' };
+    }), { ends: ['apply', 'cleanup'] })
+        .addNode('apply', commandNode((state) => {
+        let calls = state.calls;
+        let results = state.results;
+        const events = [];
+        for (const decision of state.decisions) {
+            const call = calls.find((item) => item.id === decision.toolCallId);
+            if (!call || hasResult(results, call.id))
+                continue;
+            if (decision.decision === 'deny') {
+                const error = 'User denied tool call';
+                const next = addResult({ ...state, calls, results }, call.id, JSON.stringify({ denied: true, reason: error }), 'denied', event, error);
+                calls = next.calls;
+                results = next.results;
+                events.push(event('tool_call_denied', { pendingToolCallId: call.id }), ...next.events);
+            }
+            else {
+                calls = calls.map((item) => item.id === call.id
+                    ? {
+                        ...item,
+                        status: 'approved',
+                        ...(decision.arguments !== undefined ? { arguments: decision.arguments } : {})
+                    }
+                    : item);
+                events.push(event('tool_call_approved', { pendingToolCallId: call.id }));
+            }
+        }
+        const nextExec = state.decisions
+            .map((decision) => decision.toolCallId)
+            .find((id) => calls.find((call) => call.id === id)?.status === 'approved' && !hasResult(results, id));
+        if (nextExec)
+            return {
+                calls,
+                results,
+                decisions: state.decisions,
+                executingId: undefined,
+                goto: 'select',
+                events
+            };
+        const unresolved = state.batchIds.filter((id) => !hasResult(results, id));
+        if (unresolved.length)
+            return {
+                calls,
+                results,
+                decisions: [],
+                goto: 'approval',
+                response: {
+                    type: 'tool_call_resolved',
+                    text: '',
+                    pendingToolCalls: calls.filter((call) => unresolved.includes(call.id))
+                },
+                events
+            };
+        return {
+            calls,
+            results: {},
+            decisions: [],
+            ...withToolMessages({ ...state, calls, results }),
+            goto: 'model',
+            events
+        };
+    }), { ends: ['select', 'approval', 'model'] })
+        .addNode('select', commandNode((state, config) => {
+        const signal = config.configurable?.requestSignal;
+        if (signal?.aborted)
+            return cleanupUpdate(state, 'cancelled');
+        const next = state.decisions
+            .map((decision) => decision.toolCallId)
+            .find((id) => state.calls.find((call) => call.id === id)?.status === 'approved' &&
+            !hasResult(state.results, id)) ??
+            state.batchIds.find((id) => state.calls.find((call) => call.id === id)?.status === 'approved' &&
+                !hasResult(state.results, id));
+        return next
+            ? { executingId: next, goto: 'execute' }
+            : { executingId: undefined, goto: 'policy' };
+    }), { ends: ['execute', 'policy', 'finish'] })
+        .addNode('execute', commandNode(async (state, config) => {
+        const id = state.executingId;
+        const call = state.calls.find((item) => item.id === id);
+        if (!id || !call)
+            return { goto: 'policy', executingId: undefined };
+        const signal = config.configurable?.requestSignal;
+        if (signal?.aborted)
+            return cleanupUpdate({ ...state, executingId: undefined }, state.terminal ?? 'cancelled');
+        const tool = definition.tools.find((candidate) => candidate.name === call.publicToolName);
+        if (!tool) {
+            const next = addResult(state, id, JSON.stringify({ error: `Unknown assistant tool '${call.publicToolName}'` }), 'error', event, `Unknown assistant tool '${call.publicToolName}'`);
+            return { ...next, executingId: undefined, goto: 'policy' };
+        }
+        try {
+            const value = await raceAssistantAbort(tool.execute(call.arguments, signal), signal);
+            const proposal = tool.extractProposal?.(value);
+            const next = addResult(state, id, JSON.stringify(value), 'approved', event);
+            if (signal?.aborted) {
+                const updated = {
+                    ...state,
+                    ...next,
+                    proposals: proposal ? [...state.proposals, proposal] : state.proposals,
+                    executingId: undefined
+                };
+                return cleanupUpdate(updated, 'cancelled');
+            }
+            return executionContinuation(state, next, id, proposal ? [...state.proposals, proposal] : state.proposals);
+        }
+        catch (error) {
+            if (signal?.aborted)
+                return cleanupUpdate(state, 'cancelled', error);
+            const message = error instanceof Error ? error.message : String(error);
+            const next = addResult(state, id, JSON.stringify({ error: message }), 'error', event, message);
+            return executionContinuation(state, next, id);
+        }
+    }), { ends: ['select', 'policy', 'approval', 'finish', END] })
+        .addNode('finish', commandNode((state) => {
+        const update = withToolMessages(state);
+        return { ...update, goto: 'end' };
+    }), { ends: [END] })
+        .addNode('cleanup', commandNode((state) => cleanupUpdate(state, state.terminal ?? 'failure', state.error)), { ends: ['finish'] })
+        .addEdge(START, 'model')
+        .compile({ name: 'MCPLab Assistant', checkpointer: saver });
+    return { graph, event, hasResult, cleanupUpdate };
+}
+//# sourceMappingURL=assistant-graph-nodes.js.map

package/dist/app-server/assistant-graph-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-graph-nodes.js","sourceRoot":"","sources":["../../src/app-server/assistant-graph-nodes.ts"],"names":[],"mappings":"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"}

package/dist/app-server/assistant-graph-state.d.ts

@@ -0,0 +1,64 @@
+import { AIMessage, ToolMessage, type BaseMessage } from '@langchain/core/messages';
+import type { AssistantRuntimeMessage, AssistantRuntimeEvent, AssistantRuntimeResponse, AssistantRuntimeToolCall, AssistantToolCallDecision, ScenarioAssistantSuggestionBundle } from '@inspectr/mcplab-core';
+export type TerminalReason = 'cancelled' | 'superseded' | 'budget' | 'failure' | 'disposed';
+export type GraphEvent = {
+    id: string;
+    type: AssistantRuntimeEvent['type'];
+    payload: Record<string, unknown>;
+};
+export declare const State: import("@langchain/langgraph").AnnotationRoot<{
+    messages: import("@langchain/langgraph").BaseChannel<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[], BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[] | import("@langchain/langgraph").OverwriteValue<BaseMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>, import("@langchain/core/messages").MessageType>[]>, unknown>;
+    uiMessages: import("@langchain/langgraph").BaseChannel<AssistantRuntimeMessage[], AssistantRuntimeMessage[] | import("@langchain/langgraph").OverwriteValue<AssistantRuntimeMessage[]>, unknown>;
+    calls: import("@langchain/langgraph").BaseChannel<AssistantRuntimeToolCall[], AssistantRuntimeToolCall[] | import("@langchain/langgraph").OverwriteValue<AssistantRuntimeToolCall[]>, unknown>;
+    batchIds: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+    results: import("@langchain/langgraph").BaseChannel<Record<string, string>, import("@langchain/langgraph").OverwriteValue<Record<string, string>> | Record<string, string>, unknown>;
+    proposals: import("@langchain/langgraph").BaseChannel<ScenarioAssistantSuggestionBundle[], ScenarioAssistantSuggestionBundle[] | import("@langchain/langgraph").OverwriteValue<ScenarioAssistantSuggestionBundle[]>, unknown>;
+    rounds: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    turnId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    response: import("@langchain/langgraph").BaseChannel<AssistantRuntimeResponse | undefined, import("@langchain/langgraph").OverwriteValue<AssistantRuntimeResponse | undefined> | AssistantRuntimeResponse | undefined, unknown>;
+    decisions: import("@langchain/langgraph").BaseChannel<AssistantToolCallDecision[], AssistantToolCallDecision[] | import("@langchain/langgraph").OverwriteValue<AssistantToolCallDecision[]>, unknown>;
+    terminal: import("@langchain/langgraph").BaseChannel<TerminalReason | undefined, import("@langchain/langgraph").OverwriteValue<TerminalReason | undefined> | TerminalReason | undefined, unknown>;
+    error: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    budgetExceeded: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    executingId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+}>;
+export type GraphState = typeof State.State;
+export declare const terminalReasonFrom: (signal: AbortSignal | undefined, fallback?: TerminalReason) => TerminalReason;
+export declare const graphConfig: (threadId: string) => {
+    configurable: {
+        thread_id: string;
+    };
+    recursionLimit: number;
+    durability: 'sync';
+};
+export declare const messageId: () => string;
+export declare const persistNativeMessage: (message: AIMessage, history: BaseMessage[]) => AIMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>;
+export declare const hasResult: (results: Record<string, string>, id: string) => boolean;
+export declare const visibleToolMessage: (call: AssistantRuntimeToolCall, content: string) => AssistantRuntimeMessage;
+export declare const addResult: (state: GraphState, callId: string, content: string, status: AssistantRuntimeToolCall['status'], createEvent: (type: AssistantRuntimeEvent['type'], payload: Record<string, unknown>) => GraphEvent, error?: string) => {
+    calls: AssistantRuntimeToolCall[];
+    results: {
+        [x: string]: string;
+    };
+    events: GraphEvent[];
+};
+export declare const addResults: (state: GraphState, callsToResolve: AssistantRuntimeToolCall[], resultFor: (call: AssistantRuntimeToolCall) => {
+    content: string;
+    status: AssistantRuntimeToolCall['status'];
+    error?: string;
+}, createEvent: (type: AssistantRuntimeEvent['type'], payload: Record<string, unknown>) => GraphEvent) => {
+    calls: AssistantRuntimeToolCall[];
+    results: Record<string, string>;
+    events: GraphEvent[];
+};
+export declare const withToolMessages: (state: GraphState) => {
+    messages?: undefined;
+    uiMessages?: undefined;
+    batchIds?: undefined;
+} | {
+    messages: ToolMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>[];
+    uiMessages: AssistantRuntimeMessage[];
+    batchIds: never[];
+};
+export declare const toPersistedToolRequest: (native: AIMessage, calls: AssistantRuntimeToolCall[]) => AIMessage<import("@langchain/core/messages").MessageStructure<import("@langchain/core/messages").MessageToolSet>>;
+//# sourceMappingURL=assistant-graph-state.d.ts.map

package/dist/app-server/assistant-graph-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-graph-state.d.ts","sourceRoot":"","sources":["../../src/app-server/assistant-graph-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpF,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAG/B,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;EA2BhB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC;AAC5C,eAAO,MAAM,kBAAkB,WACrB,WAAW,GAAG,SAAS,aACrB,cAAc,KACvB,cAA6E,CAAC;AACjF,eAAO,MAAM,WAAW,aAAc,MAAM;IAC1C,YAAY;QAAI,SAAS;;IACzB,cAAc;IACd,UAAU,EAAE,MAAM;CAClB,CAAC;AACH,eAAO,MAAM,SAAS,cAA8B,CAAC;AAErD,eAAO,MAAM,oBAAoB,YAAa,SAAS,WAAW,WAAW,EAAE,sHAU9E,CAAC;AAEF,eAAO,MAAM,SAAS,YAAa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,MAAM,YACzC,CAAC;AAE7B,eAAO,MAAM,kBAAkB,SACvB,wBAAwB,WACrB,MAAM,KACd,uBAOD,CAAC;AAEH,eAAO,MAAM,SAAS,UACb,UAAU,UACT,MAAM,WACL,MAAM,UACP,wBAAwB,CAAC,QAAQ,CAAC,eAC7B,CACX,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,UAAU,UACP,MAAM;;;;;;CAkBf,CAAC;AAEF,eAAO,MAAM,UAAU,UACd,UAAU,kBACD,wBAAwB,EAAE,aAC/B,CAAC,IAAI,EAAE,wBAAwB,KAAK;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,eACY,CAAC,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU;;;;CAkBnG,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,UAAU;;;;;;;;CAgBjD,CAAC;AAEF,eAAO,MAAM,sBAAsB,WAAY,SAAS,SAAS,wBAAwB,EAAE,sHAmC1F,CAAC"}

package/dist/app-server/assistant-graph-state.js

@@ -0,0 +1,137 @@
+import { AIMessage, ToolMessage } from '@langchain/core/messages';
+import { Annotation, messagesStateReducer } from '@langchain/langgraph';
+import { randomUUID } from 'node:crypto';
+import { orderedBatchResults, resultPreview } from './assistant-runtime-policy.js';
+export const State = Annotation.Root({
+    messages: Annotation({ reducer: messagesStateReducer, default: () => [] }),
+    uiMessages: Annotation({
+        reducer: (a, b) => [...a, ...b],
+        default: () => []
+    }),
+    calls: Annotation({ reducer: (_a, b) => b, default: () => [] }),
+    batchIds: Annotation({ reducer: (_a, b) => b, default: () => [] }),
+    results: Annotation({ reducer: (_a, b) => b, default: () => ({}) }),
+    proposals: Annotation({
+        reducer: (_a, b) => b,
+        default: () => []
+    }),
+    rounds: Annotation({ reducer: (_a, b) => b, default: () => 0 }),
+    turnId: Annotation({ reducer: (_a, b) => b, default: () => undefined }),
+    response: Annotation({
+        reducer: (_a, b) => b,
+        default: () => undefined
+    }),
+    decisions: Annotation({ reducer: (_a, b) => b, default: () => [] }),
+    terminal: Annotation({
+        reducer: (_a, b) => b,
+        default: () => undefined
+    }),
+    error: Annotation({ reducer: (_a, b) => b, default: () => undefined }),
+    budgetExceeded: Annotation({ reducer: (_a, b) => b, default: () => false }),
+    executingId: Annotation({ reducer: (_a, b) => b, default: () => undefined })
+});
+export const terminalReasonFrom = (signal, fallback = 'cancelled') => (signal?.reason === 'superseded' ? 'superseded' : fallback);
+export const graphConfig = (threadId) => ({
+    configurable: { thread_id: threadId },
+    recursionLimit: 1000,
+    durability: 'sync'
+});
+export const messageId = () => `msg-${randomUUID()}`;
+export const persistNativeMessage = (message, history) => {
+    if (!message.id || !history.some((existing) => existing.id === message.id))
+        return message;
+    return new AIMessage({
+        content: message.content,
+        id: `${String(message.id)}#${messageId()}`,
+        additional_kwargs: { ...message.additional_kwargs, original_provider_id: message.id },
+        response_metadata: message.response_metadata,
+        usage_metadata: message.usage_metadata,
+        tool_calls: message.tool_calls
+    });
+};
+export const hasResult = (results, id) => Object.hasOwn(results, id);
+export const visibleToolMessage = (call, content) => ({
+    id: messageId(),
+    role: 'tool',
+    text: call.error
+        ? `Tool error (${call.server}::${call.tool}): ${call.error}`
+        : (call.resultPreview ?? content),
+    createdAt: new Date().toISOString()
+});
+export const addResult = (state, callId, content, status, createEvent, error) => {
+    const preview = resultPreview(content);
+    const calls = state.calls.map((call) => call.id !== callId
+        ? call
+        : { ...call, status, resultPreview: preview, ...(error ? { error } : {}) });
+    return {
+        calls,
+        results: { ...state.results, [callId]: preview },
+        events: [
+            createEvent('tool_call_resolved', {
+                pendingToolCallId: callId,
+                pendingToolCall: calls.find((call) => call.id === callId)
+            })
+        ]
+    };
+};
+export const addResults = (state, callsToResolve, resultFor, createEvent) => {
+    let current = state;
+    const events = [];
+    for (const call of callsToResolve) {
+        const result = resultFor(call);
+        const next = addResult(current, call.id, result.content, result.status, createEvent, result.error);
+        current = { ...current, ...next };
+        events.push(...next.events);
+    }
+    return { calls: current.calls, results: current.results, events };
+};
+export const withToolMessages = (state) => {
+    const batch = state.calls.filter((call) => state.batchIds.includes(call.id));
+    const results = orderedBatchResults(batch, (id) => state.results[id]);
+    if (!results)
+        return {};
+    return {
+        messages: results.map(({ call, content }) => new ToolMessage({
+            content: call.resultPreview ?? content,
+            tool_call_id: call.id,
+            name: call.publicToolName
+        })),
+        uiMessages: results.map(({ call, content }) => visibleToolMessage(call, content)),
+        batchIds: []
+    };
+};
+export const toPersistedToolRequest = (native, calls) => {
+    const kwargs = { ...native.additional_kwargs };
+    delete kwargs.tool_calls;
+    let nativeToolIndex = 0;
+    const content = Array.isArray(native.content)
+        ? native.content.map((block) => {
+            if (!block ||
+                typeof block !== 'object' ||
+                block.type !== 'tool_use')
+                return block;
+            const call = calls[nativeToolIndex++];
+            return call
+                ? {
+                    ...block,
+                    id: call.id,
+                    input: call.arguments
+                }
+                : block;
+        })
+        : native.content;
+    return new AIMessage({
+        content,
+        id: native.id ?? messageId(),
+        additional_kwargs: kwargs,
+        response_metadata: native.response_metadata,
+        usage_metadata: native.usage_metadata,
+        tool_calls: calls.map((call) => ({
+            id: call.id,
+            name: call.publicToolName,
+            args: call.arguments,
+            type: 'tool_call'
+        }))
+    });
+};
+//# sourceMappingURL=assistant-graph-state.js.map

package/dist/app-server/assistant-graph-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-graph-state.js","sourceRoot":"","sources":["../../src/app-server/assistant-graph-state.ts"],"names":[],"mappings":"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"}

package/dist/app-server/assistant-mcp-context-tools.d.ts

@@ -0,0 +1,17 @@
+import type { McpClientManager } from '@inspectr/mcplab-core';
+import type { AssistantRuntimeTool } from './assistant-runtime-contract.js';
+export declare const MCP_CONTEXT_TOOL_NAMES: readonly ['list_mcp_resources', 'read_mcp_resource', 'list_mcp_prompts', 'get_mcp_prompt'];
+export interface McpContextServers {
+    /** Selected servers that advertise MCP resources. */
+    resources: string[];
+    /** Selected servers that advertise MCP prompts. */
+    prompts: string[];
+}
+/**
+ * Read-only tools that let an assistant use the server's own resources (documents, schemas)
+ * and prompt templates as context. Only features a server advertises are offered.
+ */
+export declare function createMcpContextTools(mcp: McpClientManager, servers: McpContextServers): AssistantRuntimeTool[];
+/** Prompt guidance for the context tools that are actually available. */
+export declare function mcpContextToolGuidance(servers: McpContextServers): string[];
+//# sourceMappingURL=assistant-mcp-context-tools.d.ts.map

package/dist/app-server/assistant-mcp-context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-mcp-context-tools.d.ts","sourceRoot":"","sources":["../../src/app-server/assistant-mcp-context-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAM9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,eAAO,MAAM,sBAAsB,YACjC,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,CACR,CAAC;AAKX,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,iBAAiB,GACzB,oBAAoB,EAAE,CA0HxB;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAW3E"}