qlogicagent 0.2.1 → 0.3.0

package/dist/skills/tools/team-tool.js

@@ -1,105 +0,0 @@
-// ============================================================
-// Team Tool — create and manage multi-agent teams (Swarm).
-// Reference: claude-code-haha/src/tools/TeamCreateTool/TeamCreateTool.ts
-//            claude-code-haha/src/tools/TeamDeleteTool/TeamDeleteTool.ts
-// Category: system
-// ============================================================
-export const TEAM_TOOL_NAME = "team";
-export const TEAM_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        action: {
-            type: "string",
-            enum: ["create", "delete", "list", "status"],
-            description: "Team action: create (new team), delete (disband), list (all teams), status (team details).",
-        },
-        teamName: {
-            type: "string",
-            description: "Team name. Required for create/delete/status.",
-        },
-        description: {
-            type: "string",
-            description: "Team description/objective. Used for create.",
-        },
-        members: {
-            type: "array",
-            description: "Team members with roles and tool restrictions.",
-            items: {
-                type: "object",
-                properties: {
-                    name: { type: "string", description: "Agent name/role identifier." },
-                    role: { type: "string", description: "Role description (e.g. 'frontend developer')." },
-                    tools: { type: "array", items: { type: "string" }, description: "Allowed tools for this member." },
-                },
-                required: ["name", "role"],
-            },
-        },
-    },
-    required: ["action"],
-};
-export function createTeamTool(deps) {
-    return {
-        name: TEAM_TOOL_NAME,
-        label: "Team",
-        description: "Manage multi-agent teams. Create teams of specialized agents that collaborate via send_message. " +
-            "Each member has a role and optional tool restrictions. Use for complex tasks requiring parallel work.",
-        parameters: TEAM_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            switch (params.action) {
-                case "create": {
-                    if (!params.teamName) {
-                        return { content: [{ type: "text", text: "Error: teamName required for create." }], details: { type: "team", error: "missing_name" } };
-                    }
-                    const r = await deps.createTeam({ teamName: params.teamName, description: params.description, members: params.members });
-                    if (!r.success) {
-                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "team", error: r.error } };
-                    }
-                    const lines = [`Team "${r.team.name}" created.`, `Lead: ${r.team.leadId}`, `Members: ${r.team.members.length}`];
-                    for (const m of r.team.members) {
-                        lines.push(`  - ${m.name} (${m.role})`);
-                    }
-                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "team", action: "create", teamName: r.team.name } };
-                }
-                case "delete": {
-                    if (!params.teamName) {
-                        return { content: [{ type: "text", text: "Error: teamName required for delete." }], details: { type: "team", error: "missing_name" } };
-                    }
-                    const r = await deps.deleteTeam(params.teamName);
-                    if (!r.success) {
-                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "team", error: r.error } };
-                    }
-                    return { content: [{ type: "text", text: `Team "${params.teamName}" disbanded.` }], details: { type: "team", action: "delete", teamName: params.teamName } };
-                }
-                case "list": {
-                    const r = await deps.listTeams();
-                    if (!r.teams || r.teams.length === 0) {
-                        return { content: [{ type: "text", text: "No active teams." }], details: { type: "team", action: "list", count: 0 } };
-                    }
-                    const lines = [`Active teams (${r.teams.length}):`, ""];
-                    for (const t of r.teams) {
-                        lines.push(`- **${t.name}**: ${t.description || "(no description)"} — ${t.members.length} members`);
-                    }
-                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "team", action: "list", count: r.teams.length } };
-                }
-                case "status": {
-                    if (!params.teamName) {
-                        return { content: [{ type: "text", text: "Error: teamName required for status." }], details: { type: "team", error: "missing_name" } };
-                    }
-                    const r = await deps.getTeamStatus(params.teamName);
-                    if (!r.success) {
-                        return { content: [{ type: "text", text: `Error: ${r.error}` }], details: { type: "team", error: r.error } };
-                    }
-                    const t = r.team;
-                    const lines = [`Team: ${t.name}`, `Description: ${t.description || "—"}`, `Lead: ${t.leadId}`, `Created: ${t.createdAt}`, "", `Members (${t.members.length}):`];
-                    for (const m of t.members) {
-                        const tools = m.tools ? ` [tools: ${m.tools.join(", ")}]` : "";
-                        lines.push(`  - ${m.name} (${m.role})${tools}`);
-                    }
-                    return { content: [{ type: "text", text: lines.join("\n") }], details: { type: "team", action: "status", teamName: t.name } };
-                }
-                default:
-                    return { content: [{ type: "text", text: `Error: unknown action "${params.action}".` }], details: { type: "team", error: "unknown_action" } };
-            }
-        },
-    };
-}

package/dist/skills/tools/tool-search-tool.js

@@ -1,110 +0,0 @@
-// ============================================================
-// Tool Search Tool — discover deferred/hidden tools by keyword.
-// Reference: claude-code-haha/src/tools/ToolSearchTool/ToolSearchTool.ts
-// Category: system
-// ============================================================
-export const TOOL_SEARCH_TOOL_NAME = "tool_search";
-export const TOOL_SEARCH_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        query: {
-            type: "string",
-            description: 'Search query for tools. Use "select:toolName" to directly activate a deferred tool, ' +
-                "or provide keywords to search tool names/descriptions. " +
-                'Prefix a term with "+" to mark it as required (all +terms must match).',
-        },
-        maxResults: {
-            type: "number",
-            description: "Maximum number of results to return (default: 5).",
-        },
-    },
-    required: ["query"],
-};
-const DEFAULT_MAX_RESULTS = 5;
-export function createToolSearchTool(deps) {
-    return {
-        name: TOOL_SEARCH_TOOL_NAME,
-        label: "Tool Search",
-        description: "Search for available tools that are not currently loaded. " +
-            "Many tools are deferred to save context tokens. " +
-            'Use "select:toolName" to directly activate a tool, ' +
-            "or provide keywords to find relevant tools. " +
-            "Activated tools become available in subsequent messages.",
-        parameters: TOOL_SEARCH_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            if (!params.query || params.query.trim().length === 0) {
-                return {
-                    content: [{ type: "text", text: "Error: query is required." }],
-                    details: { type: "tool_search", error: "empty_query" },
-                };
-            }
-            const query = params.query.trim();
-            const maxResults = params.maxResults ?? DEFAULT_MAX_RESULTS;
-            // Handle direct selection: "select:toolName" or "select:A,B,C"
-            if (query.startsWith("select:")) {
-                const names = query.slice(7).split(",").map((n) => n.trim()).filter(Boolean);
-                const activated = [];
-                const notFound = [];
-                if (deps.activateTool) {
-                    for (const name of names) {
-                        const ok = await deps.activateTool(name);
-                        if (ok)
-                            activated.push(name);
-                        else
-                            notFound.push(name);
-                    }
-                }
-                else {
-                    // No activation support — just search
-                    const result = await deps.searchTools(query, { maxResults });
-                    return formatSearchResult(result);
-                }
-                const parts = [];
-                if (activated.length > 0) {
-                    parts.push(`Activated: ${activated.join(", ")}. These tools are now available.`);
-                }
-                if (notFound.length > 0) {
-                    parts.push(`Not found: ${notFound.join(", ")}.`);
-                }
-                return {
-                    content: [{ type: "text", text: parts.join("\n") }],
-                    details: { type: "tool_search", activated, notFound, mode: "select" },
-                };
-            }
-            // Keyword search
-            const result = await deps.searchTools(query, { maxResults });
-            return formatSearchResult(result);
-        },
-    };
-}
-function formatSearchResult(result) {
-    if (result.matches.length === 0) {
-        return {
-            content: [{
-                    type: "text",
-                    text: `No tools found matching "${result.query}". ` +
-                        `Total deferred tools available: ${result.totalDeferred}.`,
-                }],
-            details: { type: "tool_search", query: result.query, matchCount: 0, totalDeferred: result.totalDeferred },
-        };
-    }
-    const lines = [
-        `Found ${result.matches.length} tool(s) matching "${result.query}" (${result.totalDeferred} total deferred):`,
-        "",
-    ];
-    for (const tool of result.matches) {
-        lines.push(`- **${tool.name}**: ${tool.description}`);
-    }
-    lines.push("");
-    lines.push('Use "select:toolName" to activate a tool for use in subsequent messages.');
-    return {
-        content: [{ type: "text", text: lines.join("\n") }],
-        details: {
-            type: "tool_search",
-            query: result.query,
-            matchCount: result.matches.length,
-            totalDeferred: result.totalDeferred,
-            matches: result.matches.map((m) => m.name),
-        },
-    };
-}

package/dist/skills/tools/tts-tool.js

@@ -1,45 +0,0 @@
-// ============================================================
-// TTS Tool — text-to-speech via backend adapter.
-// Category: media
-// ============================================================
-export const TTS_TOOL_NAME = "tts";
-export const TTS_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        text: {
-            type: "string",
-            description: "Text to convert to speech.",
-        },
-        channel: {
-            type: "string",
-            description: "Optional channel id to pick output format (e.g. telegram).",
-        },
-    },
-    required: ["text"],
-};
-export function createTtsTool(deps) {
-    return {
-        name: TTS_TOOL_NAME,
-        label: "TTS",
-        description: "Convert text to speech (TTS) — read text aloud as spoken audio. " +
-            "Use for narration, voice messages, or any spoken-word output. " +
-            "DO NOT use for music, songs, or melodies — use music_generate instead.",
-        parameters: TTS_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            const result = await deps.textToSpeech({
-                text: params.text,
-                channel: params.channel,
-            });
-            return {
-                content: [{ type: "text", text: "已成功生成语音。" }],
-                details: {
-                    type: "tts",
-                    audioPath: result.audioPath,
-                    provider: result.provider,
-                    voiceCompatible: result.voiceCompatible,
-                    mediaUrls: result.mediaUrls,
-                },
-            };
-        },
-    };
-}

package/dist/skills/tools/video-edit-tool.js

@@ -1,74 +0,0 @@
-// ============================================================
-// Video Edit Tool — edit existing videos via backend adapter.
-// Category: media
-// ============================================================
-export const VIDEO_EDIT_TOOL_NAME = "video_edit";
-export const VIDEO_EDIT_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        prompt: {
-            type: "string",
-            description: "Edit instruction. Reference videos as 视频1, 视频2, 视频3. " +
-                "Reference images as 图片1, 图片2. " +
-                "Operations: add/remove/modify elements, extend, track fill.",
-        },
-        source_videos: {
-            type: "array",
-            items: { type: "string" },
-            minItems: 1,
-            maxItems: 3,
-            description: "Video(s) to edit (1-3 URLs). Order: [0]=视频1, [1]=视频2, [2]=视频3.",
-        },
-        reference_images: {
-            type: "array",
-            items: { type: "string" },
-            description: "Optional reference images for element replacement (up to 9).",
-        },
-        duration: {
-            type: "number",
-            description: "Output duration in seconds (4-15s). Default: same as source.",
-        },
-        aspect_ratio: {
-            type: "string",
-            description: "Output aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. Default: same as source.",
-        },
-        resolution: {
-            type: "string",
-            description: "Output resolution: '480p' or '720p'. Default: '720p'.",
-        },
-    },
-    required: ["prompt", "source_videos"],
-};
-export function createVideoEditTool(deps) {
-    return {
-        name: VIDEO_EDIT_TOOL_NAME,
-        label: "Video Edit",
-        description: "Edit existing videos: add/remove/modify elements, extend, or bridge clips. " +
-            "Requires source_videos. Max 3 source videos, max 720p. " +
-            "For generating NEW videos from scratch, use video_generate instead.",
-        parameters: VIDEO_EDIT_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            if (!params.source_videos?.length) {
-                return { content: [{ type: "text", text: "Error: source_videos is required." }] };
-            }
-            const result = await deps.editVideo({
-                prompt: params.prompt,
-                sourceVideos: params.source_videos,
-                referenceImages: params.reference_images,
-                duration: params.duration,
-                aspectRatio: params.aspect_ratio,
-                resolution: params.resolution,
-            });
-            const text = `Video edited successfully${result.model ? ` (model: ${result.model})` : ""}`;
-            return {
-                content: [{ type: "text", text }],
-                details: {
-                    type: "video_edit",
-                    model: result.model,
-                    durationMs: result.durationMs,
-                    mediaUrls: result.mediaUrls,
-                },
-            };
-        },
-    };
-}

package/dist/skills/tools/video-generate-tool.js

@@ -1,66 +0,0 @@
-// ============================================================
-// Video Generate Tool — generate video clips via backend.
-// Category: media
-// ============================================================
-export const VIDEO_GENERATE_TOOL_NAME = "video_generate";
-export const VIDEO_GENERATE_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        prompt: {
-            type: "string",
-            description: "Video generation prompt. MUST be in English. Include scene, movement, camera motion, lighting, style.",
-        },
-        purpose: {
-            type: "string",
-            description: "Intended use: 'social-media', 'short-video', 'presentation', etc.",
-        },
-        style: {
-            type: "string",
-            description: "Visual style: 'cinematic', 'anime', 'watercolor', etc.",
-        },
-        image_url: {
-            type: "string",
-            description: "Reference image for image-to-video. Preview image from storyboard Step 3, or user-uploaded image.",
-        },
-        aspect_ratio: {
-            type: "string",
-            description: "Video aspect ratio: '9:16' (vertical), '16:9' (horizontal), '1:1' (square). Default: '16:9'.",
-        },
-        duration: {
-            type: "number",
-            description: "Video duration in seconds (3-10s single-shot, >10s requires multi-shot workflow). Must be confirmed by user.",
-        },
-    },
-    required: ["prompt"],
-};
-export function createVideoGenerateTool(deps) {
-    return {
-        name: VIDEO_GENERATE_TOOL_NAME,
-        label: "Video Generate",
-        description: "Generate a short video clip from a text prompt (and optional reference image). " +
-            "Prompt MUST be in English. Include scene, movement, camera motion, lighting details. " +
-            "Single-shot: 3–10s. For longer videos (>10s), use multi-shot storyboard workflow.",
-        parameters: VIDEO_GENERATE_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            const result = await deps.generateVideo({
-                prompt: params.prompt,
-                purpose: params.purpose,
-                style: params.style,
-                imageUrl: params.image_url,
-                aspectRatio: params.aspect_ratio,
-                duration: params.duration,
-            });
-            const count = result.mediaUrls.length;
-            const text = `Generated ${count} video${count > 1 ? "s" : ""}${result.model ? ` (model: ${result.model})` : ""}`;
-            return {
-                content: [{ type: "text", text }],
-                details: {
-                    type: "video_generate",
-                    model: result.model,
-                    durationMs: result.durationMs,
-                    mediaUrls: result.mediaUrls,
-                },
-            };
-        },
-    };
-}

package/dist/skills/tools/video-merge-tool.js

@@ -1,92 +0,0 @@
-// ============================================================
-// Video Merge Tool — merge multiple video clips with transitions.
-// Category: media
-// ============================================================
-export const VIDEO_MERGE_TOOL_NAME = "video_merge";
-export const VIDEO_MERGE_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        clips: {
-            type: "array",
-            items: {
-                type: "object",
-                properties: {
-                    video: { type: "string", description: "Video file path." },
-                    audio: { type: "string", description: "Narration audio file path (from TTS)." },
-                    trimStart: { type: "number", description: "Trim start in seconds (default 0)." },
-                    trimEnd: { type: "number", description: "Trim end in seconds (default: full)." },
-                },
-                required: ["video"],
-            },
-            minItems: 2,
-            description: "Array of video clips to merge, in order.",
-        },
-        transition: {
-            type: "string",
-            description: "Transition effect: 'crossfade' (default), 'fade', 'wipeleft', 'cut', 'dissolve', etc.",
-        },
-        transitionDuration: {
-            type: "number",
-            description: "Transition duration in seconds (0.1-2.0, default 0.5).",
-        },
-        subtitles: {
-            type: "string",
-            description: "Path to SRT subtitle file to burn-in.",
-        },
-        bgm: {
-            type: "string",
-            description: "Background music file path.",
-        },
-        bgmVolume: {
-            type: "number",
-            description: "BGM volume (0.0-1.0, default 0.15).",
-        },
-        outputResolution: {
-            type: "string",
-            description: "Output resolution: '1920x1080', '1080x1920', etc. Default: auto.",
-        },
-        outputFps: {
-            type: "number",
-            description: "Output FPS (default 30).",
-        },
-    },
-    required: ["clips"],
-};
-export function createVideoMergeTool(deps) {
-    return {
-        name: VIDEO_MERGE_TOOL_NAME,
-        label: "Video Merge",
-        description: "Merge multiple video clips into a single video with transitions, subtitles, and background music. " +
-            "Requires at least 2 clips. Supports crossfade, fade, wipe, dissolve, and cut transitions. " +
-            "Audio per clip is preserved; BGM is mixed at adjustable volume.",
-        parameters: VIDEO_MERGE_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            if (!params.clips || params.clips.length < 2) {
-                return { content: [{ type: "text", text: "Error: at least 2 clips are required for merging." }] };
-            }
-            const result = await deps.mergeVideos({
-                clips: params.clips,
-                transition: params.transition,
-                transitionDuration: params.transitionDuration,
-                subtitles: params.subtitles,
-                bgm: params.bgm,
-                bgmVolume: params.bgmVolume,
-                outputResolution: params.outputResolution,
-                outputFps: params.outputFps,
-            });
-            const text = `Merged ${result.clipCount} clips → ${result.durationSec.toFixed(1)}s video` +
-                (params.transition ? ` (transition: ${params.transition})` : "");
-            return {
-                content: [{ type: "text", text }],
-                details: {
-                    type: "video_merge",
-                    localPath: result.localPath,
-                    servePath: result.servePath,
-                    durationSec: result.durationSec,
-                    clipCount: result.clipCount,
-                    mediaUrls: result.mediaUrls,
-                },
-            };
-        },
-    };
-}

package/dist/skills/tools/video-upscale-tool.js

@@ -1,52 +0,0 @@
-// ============================================================
-// Video Upscale Tool — upscale video resolution + sharpen.
-// Category: media
-// ============================================================
-export const VIDEO_UPSCALE_TOOL_NAME = "video_upscale";
-export const VIDEO_UPSCALE_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        video: {
-            type: "string",
-            description: "Video file path (local or serve path).",
-        },
-        targetResolution: {
-            type: "string",
-            description: "Target resolution: '1080p' (default, 1920x1080/1080x1920), '2k' (2560x1440/1440x2560).",
-        },
-        sharpness: {
-            type: "string",
-            description: "Sharpening intensity: 'light' (default), 'medium', 'strong'.",
-        },
-    },
-    required: ["video"],
-};
-export function createVideoUpscaleTool(deps) {
-    return {
-        name: VIDEO_UPSCALE_TOOL_NAME,
-        label: "Video Upscale",
-        description: "Upscale a video to higher resolution with optional sharpening. " +
-            "Auto-detects orientation (landscape/portrait). Uses Lanczos interpolation + unsharp mask. " +
-            "Supports 1080p and 2K targets. Best used as post-processing after video_merge.",
-        parameters: VIDEO_UPSCALE_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            const result = await deps.upscaleVideo({
-                video: params.video,
-                targetResolution: params.targetResolution,
-                sharpness: params.sharpness,
-            });
-            const text = `Upscaled to ${result.resolution}${params.sharpness ? ` (sharpness: ${params.sharpness})` : ""}`;
-            return {
-                content: [{ type: "text", text }],
-                details: {
-                    type: "video_upscale",
-                    localPath: result.localPath,
-                    servePath: result.servePath,
-                    resolution: result.resolution,
-                    durationSec: result.durationSec,
-                    mediaUrls: result.mediaUrls,
-                },
-            };
-        },
-    };
-}

package/dist/skills/tools/web-fetch-tool.js

@@ -1,92 +0,0 @@
-// ============================================================
-// Web Fetch Tool — fetch and extract web page content.
-// Category: web
-// ============================================================
-export const WEB_FETCH_TOOL_NAME = "web_fetch";
-export const WEB_FETCH_TOOL_SCHEMA = {
-    type: "object",
-    properties: {
-        url: {
-            type: "string",
-            description: "HTTP or HTTPS URL to fetch.",
-        },
-        extractMode: {
-            type: "string",
-            enum: ["markdown", "text", "json"],
-            description: 'Extraction mode: "markdown" (default), "text", or "json" (LLM-driven structured extraction).',
-        },
-        maxChars: {
-            type: "number",
-            description: "Maximum characters to return (truncates when exceeded).",
-            minimum: 100,
-        },
-        query: {
-            type: "string",
-            description: "Original search query. When provided, returns the most query-relevant sections.",
-        },
-        extract: {
-            type: "boolean",
-            description: "When true, returns structured extraction (title, summary, key facts, entities, topics, sentiment).",
-        },
-        summarize: {
-            type: "boolean",
-            description: "When true, returns a concise summary (< 500 chars) of the page content. " +
-                "Useful for long pages to reduce context usage while preserving key information.",
-        },
-    },
-    required: ["url"],
-};
-const DEFAULT_MAX_CHARS = 50000;
-export function createWebFetchTool(deps) {
-    return {
-        name: WEB_FETCH_TOOL_NAME,
-        label: "Web Fetch",
-        description: "Fetch content from a URL and extract it as markdown, text, or structured JSON. " +
-            "Supports query-based relevance filtering and structured extraction " +
-            "(title, summary, key facts, entities, topics, sentiment).",
-        parameters: WEB_FETCH_TOOL_SCHEMA,
-        execute: async (_toolCallId, params) => {
-            const result = await deps.fetchUrl({
-                url: params.url,
-                extractMode: params.extractMode,
-                maxChars: params.maxChars ?? DEFAULT_MAX_CHARS,
-                query: params.query,
-                extract: params.extract,
-            });
-            // Summarization: if requested and content is long enough to warrant it
-            if (params.summarize && deps.summarizeContent && result.content.length > 1000) {
-                const summary = await deps.summarizeContent(result.content, params.query);
-                return {
-                    content: [{ type: "text", text: result.title ? `# ${result.title}\n\n${summary}` : summary }],
-                    details: {
-                        type: "web_fetch",
-                        url: params.url,
-                        summarized: true,
-                        originalLength: result.content.length,
-                        summaryLength: summary.length,
-                    },
-                };
-            }
-            const parts = [];
-            if (result.title)
-                parts.push(`# ${result.title}\n`);
-            parts.push(result.content);
-            if (result.relevantExcerpts?.length) {
-                parts.push("\n---\n## Relevant Excerpts\n");
-                for (const excerpt of result.relevantExcerpts) {
-                    parts.push(`- ${excerpt}`);
-                }
-            }
-            return {
-                content: [{ type: "text", text: parts.join("\n") }],
-                details: {
-                    type: "web_fetch",
-                    url: params.url,
-                    extractMode: params.extractMode ?? "markdown",
-                    hasExtraction: !!result.extraction,
-                    extraction: result.extraction,
-                },
-            };
-        },
-    };
-}