@edwardlee5423/magi 0.1.0-alpha.0

package/dist/tools/user-question.d.ts

@@ -0,0 +1,88 @@
+import { MagiToolUsePart } from "../providers/ir.js";
+export interface AskUserQuestionOption {
+    label: string;
+    description: string;
+    preview?: string;
+}
+export interface AskUserQuestionItem {
+    question: string;
+    header?: string;
+    options: AskUserQuestionOption[];
+    multiSelect?: boolean;
+}
+export interface AskUserQuestionRequest {
+    questions: AskUserQuestionItem[];
+}
+export interface AskUserQuestionSelection {
+    question: string;
+    selectedLabels: string[];
+    selectedOptions: AskUserQuestionOption[];
+}
+export interface AskUserQuestionAnswer {
+    answers: AskUserQuestionSelection[];
+}
+export type UserQuestionResolver = (request: {
+    toolUse: MagiToolUsePart;
+    question: AskUserQuestionRequest;
+}) => Promise<AskUserQuestionAnswer> | AskUserQuestionAnswer;
+export declare const ASK_USER_QUESTION_SCHEMA: {
+    type: string;
+    properties: {
+        questions: {
+            type: string;
+            minItems: number;
+            maxItems: number;
+            items: {
+                type: string;
+                properties: {
+                    header: {
+                        type: string;
+                    };
+                    question: {
+                        type: string;
+                    };
+                    options: {
+                        type: string;
+                        minItems: number;
+                        maxItems: number;
+                        items: {
+                            type: string;
+                            properties: {
+                                label: {
+                                    type: string;
+                                };
+                                description: {
+                                    type: string;
+                                };
+                                preview: {
+                                    type: string;
+                                };
+                            };
+                            required: string[];
+                            additionalProperties: boolean;
+                        };
+                    };
+                    multiSelect: {
+                        type: string;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseAskUserQuestionInput(input: Record<string, unknown>): AskUserQuestionRequest;
+export declare function normalizeAskUserQuestionAnswer(request: AskUserQuestionRequest, answer: AskUserQuestionAnswer): AskUserQuestionAnswer;
+export declare function formatAskUserQuestionAnswer(answer: AskUserQuestionAnswer): string;
+export declare function formatAskUserQuestionForTerminal(request: AskUserQuestionRequest, questionIndex: number): string;
+export declare function parseAskUserQuestionSelection(input: string, question: AskUserQuestionItem): AskUserQuestionOption[];
+export declare function triggerElicitationHooks(input: {
+    hooks?: import("../config.js").HookDefinition[];
+    sessionId?: string;
+    cwd?: string;
+    question: AskUserQuestionRequest;
+    answer?: AskUserQuestionAnswer;
+}): Promise<void>;

package/dist/tools/user-question.js

@@ -0,0 +1,236 @@
+export const ASK_USER_QUESTION_SCHEMA = {
+    type: "object",
+    properties: {
+        questions: {
+            type: "array",
+            minItems: 1,
+            maxItems: 4,
+            items: {
+                type: "object",
+                properties: {
+                    header: { type: "string" },
+                    question: { type: "string" },
+                    options: {
+                        type: "array",
+                        minItems: 2,
+                        maxItems: 4,
+                        items: {
+                            type: "object",
+                            properties: {
+                                label: { type: "string" },
+                                description: { type: "string" },
+                                preview: { type: "string" }
+                            },
+                            required: ["label", "description"],
+                            additionalProperties: false
+                        }
+                    },
+                    multiSelect: { type: "boolean" }
+                },
+                required: ["question", "options"],
+                additionalProperties: false
+            }
+        }
+    },
+    required: ["questions"],
+    additionalProperties: false
+};
+export function parseAskUserQuestionInput(input) {
+    const rawQuestions = input.questions;
+    if (!Array.isArray(rawQuestions)) {
+        throw new Error("AskUserQuestion input questions must be an array");
+    }
+    if (rawQuestions.length < 1 || rawQuestions.length > 4) {
+        throw new Error("AskUserQuestion requires 1 to 4 questions");
+    }
+    const questions = rawQuestions.map((rawQuestion, questionIndex) => {
+        if (!isRecord(rawQuestion)) {
+            throw new Error(`AskUserQuestion question ${questionIndex + 1} must be an object`);
+        }
+        const question = readNonEmptyString(rawQuestion.question, `questions[${questionIndex}].question`);
+        const header = readOptionalString(rawQuestion.header, `questions[${questionIndex}].header`);
+        const rawOptions = rawQuestion.options;
+        if (!Array.isArray(rawOptions)) {
+            throw new Error(`AskUserQuestion questions[${questionIndex}].options must be an array`);
+        }
+        if (rawOptions.length < 2 || rawOptions.length > 4) {
+            throw new Error(`AskUserQuestion questions[${questionIndex}].options requires 2 to 4 options`);
+        }
+        const options = rawOptions.map((rawOption, optionIndex) => {
+            if (!isRecord(rawOption)) {
+                throw new Error(`AskUserQuestion questions[${questionIndex}].options[${optionIndex}] must be an object`);
+            }
+            return {
+                label: readNonEmptyString(rawOption.label, `questions[${questionIndex}].options[${optionIndex}].label`),
+                description: readNonEmptyString(rawOption.description, `questions[${questionIndex}].options[${optionIndex}].description`),
+                preview: readOptionalString(rawOption.preview, `questions[${questionIndex}].options[${optionIndex}].preview`)
+            };
+        });
+        const multiSelect = readOptionalBoolean(rawQuestion.multiSelect ?? rawQuestion.multi_select, `questions[${questionIndex}].multiSelect`);
+        return {
+            question,
+            header,
+            options,
+            multiSelect
+        };
+    });
+    return { questions };
+}
+export function normalizeAskUserQuestionAnswer(request, answer) {
+    if (!isRecord(answer) || !Array.isArray(answer.answers)) {
+        throw new Error("AskUserQuestion resolver must return { answers: [...] }");
+    }
+    if (answer.answers.length !== request.questions.length) {
+        throw new Error(`AskUserQuestion resolver returned ${answer.answers.length} answers for ${request.questions.length} questions`);
+    }
+    return {
+        answers: answer.answers.map((selection, index) => {
+            if (!isRecord(selection)) {
+                throw new Error(`AskUserQuestion answer ${index + 1} must be an object`);
+            }
+            const question = request.questions[index];
+            const labels = Array.isArray(selection.selectedLabels)
+                ? selection.selectedLabels.map((label, labelIndex) => readNonEmptyString(label, `answers[${index}].selectedLabels[${labelIndex}]`))
+                : Array.isArray(selection.selectedOptions)
+                    ? selection.selectedOptions.map((option, optionIndex) => {
+                        if (!isRecord(option)) {
+                            throw new Error(`AskUserQuestion answers[${index}].selectedOptions[${optionIndex}] must be an object`);
+                        }
+                        return readNonEmptyString(option.label, `answers[${index}].selectedOptions[${optionIndex}].label`);
+                    })
+                    : [];
+            if (labels.length === 0) {
+                throw new Error(`AskUserQuestion answer ${index + 1} must select at least one option`);
+            }
+            if (!question.multiSelect && labels.length !== 1) {
+                throw new Error(`AskUserQuestion answer ${index + 1} must select exactly one option`);
+            }
+            const selectedOptions = labels.map((label) => {
+                const option = question.options.find((candidate) => candidate.label === label);
+                if (!option) {
+                    throw new Error(`AskUserQuestion answer ${index + 1} selected unknown option: ${label}`);
+                }
+                return option;
+            });
+            return {
+                question: question.question,
+                selectedLabels: labels,
+                selectedOptions
+            };
+        })
+    };
+}
+export function formatAskUserQuestionAnswer(answer) {
+    const lines = ["User answered AskUserQuestion:"];
+    answer.answers.forEach((selection, index) => {
+        lines.push(`Question ${index + 1}: ${selection.question}`);
+        for (const option of selection.selectedOptions) {
+            lines.push(`- ${option.label}: ${option.description}`);
+            if (option.preview) {
+                lines.push(`  preview: ${option.preview}`);
+            }
+        }
+    });
+    lines.push("", "JSON:", JSON.stringify({
+        answers: answer.answers.map((selection) => ({
+            question: selection.question,
+            selectedLabels: selection.selectedLabels,
+            selectedOptions: selection.selectedOptions
+        }))
+    }, null, 2));
+    return lines.join("\n");
+}
+export function formatAskUserQuestionForTerminal(request, questionIndex) {
+    const question = request.questions[questionIndex];
+    if (!question) {
+        throw new Error(`AskUserQuestion terminal question index out of range: ${questionIndex}`);
+    }
+    return [
+        `Question ${questionIndex + 1}/${request.questions.length}`,
+        question.header,
+        question.question,
+        ...question.options.map((option, index) => {
+            const description = option.description ? ` - ${option.description}` : "";
+            const preview = option.preview ? `\n   ${option.preview}` : "";
+            return `${index + 1}. ${option.label}${description}${preview}`;
+        }),
+        question.multiSelect ? "Choose one or more numbers separated by commas:" : "Choose one number:"
+    ].filter((line) => Boolean(line)).join("\n");
+}
+export function parseAskUserQuestionSelection(input, question) {
+    const pieces = input.split(/[,\s]+/).map((piece) => piece.trim()).filter(Boolean);
+    if (pieces.length === 0) {
+        throw new Error("Choose at least one option");
+    }
+    if (!question.multiSelect && pieces.length !== 1) {
+        throw new Error("Choose exactly one option");
+    }
+    const selected = pieces.map((piece) => {
+        const index = Number(piece);
+        if (!Number.isInteger(index) || index < 1 || index > question.options.length) {
+            throw new Error(`Option must be a number from 1 to ${question.options.length}`);
+        }
+        return question.options[index - 1];
+    });
+    const unique = new Map(selected.map((option) => [option.label, option]));
+    if (!question.multiSelect && unique.size !== 1) {
+        throw new Error("Choose exactly one option");
+    }
+    return [...unique.values()];
+}
+function readNonEmptyString(value, name) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`AskUserQuestion ${name} must be a non-empty string`);
+    }
+    return value;
+}
+function readOptionalString(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new Error(`AskUserQuestion ${name} must be a string`);
+    }
+    return value;
+}
+function readOptionalBoolean(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "boolean") {
+        throw new Error(`AskUserQuestion ${name} must be a boolean`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export async function triggerElicitationHooks(input) {
+    if (!input.hooks)
+        return;
+    const { triggerHook } = await import("../hooks/trigger.js");
+    if (input.answer) {
+        void triggerHook({
+            event: "elicitation_result",
+            hooks: input.hooks,
+            context: {
+                sessionId: input.sessionId,
+                cwd: input.cwd ?? process.cwd(),
+                elicitationId: `elicitation-${Date.now()}`,
+                requestedSchema: input.question,
+                content: input.answer
+            }
+        });
+    }
+    else {
+        void triggerHook({
+            event: "elicitation",
+            hooks: input.hooks,
+            context: {
+                sessionId: input.sessionId,
+                cwd: input.cwd ?? process.cwd(),
+                elicitationId: `elicitation-${Date.now()}`,
+                requestedSchema: input.question
+            }
+        });
+    }
+}
+//# sourceMappingURL=user-question.js.map

package/dist/tools/user-question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-question.js","sourceRoot":"","sources":["../../src/tools/user-question.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-browser.d.ts

@@ -0,0 +1,53 @@
+export type SearchSource = "bing" | "baidu" | "duckduckgo";
+export interface WebBrowserInput {
+    action: "search" | "fetch";
+    query?: string;
+    url?: string;
+    source?: SearchSource;
+    maxResults?: number;
+    maxChars?: number;
+}
+export interface WebBrowserSearchItem {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface WebBrowserResult {
+    action: "search" | "fetch";
+    query?: string;
+    url?: string;
+    source?: SearchSource;
+    results?: WebBrowserSearchItem[];
+    text?: string;
+    error?: string;
+}
+export declare const WebBrowserInputSchema: {
+    type: string;
+    properties: {
+        action: {
+            type: string;
+            enum: string[];
+        };
+        query: {
+            type: string;
+        };
+        url: {
+            type: string;
+        };
+        source: {
+            type: string;
+            enum: string[];
+        };
+        max_results: {
+            type: string;
+        };
+        max_chars: {
+            type: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseWebBrowserInput(input: Record<string, unknown>): WebBrowserInput;
+export declare function executeWebBrowser(input: WebBrowserInput): Promise<WebBrowserResult>;
+export declare function formatWebBrowserResult(result: WebBrowserResult): string;