qlogicagent 0.1.0

package/dist/skills/tools/team-tool.d.ts

@@ -0,0 +1,90 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const TEAM_TOOL_NAME: "team";
+export type TeamAction = "create" | "delete" | "list" | "status";
+export interface TeamMember {
+    name: string;
+    role: string;
+    tools?: string[];
+}
+export interface TeamToolParams {
+    action: TeamAction;
+    /** Team name (required for create/delete) */
+    teamName?: string;
+    /** Team description */
+    description?: string;
+    /** Members to include (for create) */
+    members?: TeamMember[];
+}
+export declare const TEAM_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly action: {
+            readonly type: "string";
+            readonly enum: readonly ["create", "delete", "list", "status"];
+            readonly description: "Team action: create (new team), delete (disband), list (all teams), status (team details).";
+        };
+        readonly teamName: {
+            readonly type: "string";
+            readonly description: "Team name. Required for create/delete/status.";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: "Team description/objective. Used for create.";
+        };
+        readonly members: {
+            readonly type: "array";
+            readonly description: "Team members with roles and tool restrictions.";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly description: "Agent name/role identifier.";
+                    };
+                    readonly role: {
+                        readonly type: "string";
+                        readonly description: "Role description (e.g. 'frontend developer').";
+                    };
+                    readonly tools: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Allowed tools for this member.";
+                    };
+                };
+                readonly required: readonly ["name", "role"];
+            };
+        };
+    };
+    readonly required: readonly ["action"];
+};
+export interface Team {
+    name: string;
+    description?: string;
+    leadId: string;
+    members: TeamMember[];
+    createdAt: string;
+}
+export interface TeamResult {
+    success: boolean;
+    team?: Team;
+    teams?: Team[];
+    error?: string;
+}
+/**
+ * Host-provided team management backend.
+ * Creates agent teams where members coordinate via send_message.
+ */
+export interface TeamToolDeps {
+    createTeam(params: {
+        teamName: string;
+        description?: string;
+        members?: TeamMember[];
+    }): Promise<TeamResult>;
+    deleteTeam(teamName: string): Promise<TeamResult>;
+    listTeams(): Promise<TeamResult>;
+    getTeamStatus(teamName: string): Promise<TeamResult>;
+}
+export declare function createTeamTool(deps: TeamToolDeps): PortableTool<TeamToolParams>;
+//# sourceMappingURL=team-tool.d.ts.map

package/dist/skills/tools/team-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/team-tool.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,cAAc,EAAG,MAAe,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BnB,CAAC;AAEX,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5G,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC,cAAc,CAAC,CAuE/E"}

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

@@ -0,0 +1,106 @@
+// ============================================================
+// 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" } };
+            }
+        },
+    };
+}
+//# sourceMappingURL=team-tool.js.map

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

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

package/dist/skills/tools/tool-search-tool.d.ts

@@ -0,0 +1,52 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const TOOL_SEARCH_TOOL_NAME: "tool_search";
+export interface ToolSearchToolParams {
+    query: string;
+    maxResults?: number;
+}
+export declare const TOOL_SEARCH_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly query: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly maxResults: {
+            readonly type: "number";
+            readonly description: "Maximum number of results to return (default: 5).";
+        };
+    };
+    readonly required: readonly ["query"];
+};
+export interface DeferredToolInfo {
+    name: string;
+    description: string;
+    /** Optional search hint for better discovery */
+    searchHint?: string;
+}
+export interface ToolSearchOutput {
+    matches: DeferredToolInfo[];
+    query: string;
+    totalDeferred: number;
+}
+/**
+ * Host-provided deferred tool registry.
+ * The host manages which tools are loaded vs deferred,
+ * and handles activation when selected.
+ */
+export interface ToolSearchToolDeps {
+    /**
+     * Search deferred tools by query.
+     * Supports "select:name" for direct activation and keyword search.
+     */
+    searchTools(query: string, options?: {
+        maxResults?: number;
+    }): Promise<ToolSearchOutput>;
+    /**
+     * Activate a deferred tool so it appears in subsequent turns.
+     * Returns true if activation succeeded.
+     */
+    activateTool?(name: string): Promise<boolean>;
+}
+export declare function createToolSearchTool(deps: ToolSearchToolDeps): PortableTool<ToolSearchToolParams>;
+//# sourceMappingURL=tool-search-tool.d.ts.map

package/dist/skills/tools/tool-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-search-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/tool-search-tool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,qBAAqB,EAAG,aAAsB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAgB1B,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B;;;OAGG;IACH,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CA2DjG"}

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

@@ -0,0 +1,111 @@
+// ============================================================
+// 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),
+        },
+    };
+}
+//# sourceMappingURL=tool-search-tool.js.map

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

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

package/dist/skills/tools/tts-tool.d.ts

@@ -0,0 +1,39 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const TTS_TOOL_NAME: "tts";
+export interface TtsToolParams {
+    text: string;
+    channel?: string;
+}
+export declare const TTS_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly text: {
+            readonly type: "string";
+            readonly description: "Text to convert to speech.";
+        };
+        readonly channel: {
+            readonly type: "string";
+            readonly description: "Optional channel id to pick output format (e.g. telegram).";
+        };
+    };
+    readonly required: readonly ["text"];
+};
+export interface TtsResult {
+    audioPath: string;
+    provider?: string;
+    voiceCompatible?: boolean;
+    mediaUrls: string[];
+}
+/** Deps injected by the host runtime for TTS. */
+export interface TtsToolDeps {
+    /**
+     * Convert text to speech via the configured backend.
+     * The host handles voice selection, format conversion, and storage.
+     */
+    textToSpeech(params: {
+        text: string;
+        channel?: string;
+    }): Promise<TtsResult>;
+}
+export declare function createTtsTool(deps: TtsToolDeps): PortableTool<TtsToolParams>;
+//# sourceMappingURL=tts-tool.d.ts.map

package/dist/skills/tools/tts-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tts-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/tts-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,aAAa,EAAG,KAAc,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAalB,CAAC;AAEX,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACxB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,GAChB,YAAY,CAAC,aAAa,CAAC,CA4B7B"}

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

@@ -0,0 +1,46 @@
+// ============================================================
+// 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,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=tts-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tts-tool.js","sourceRoot":"","sources":["../../../src/skills/tools/tts-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,iDAAiD;AACjD,kBAAkB;AAClB,+DAA+D;AAI/D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAc,CAAC;AAO5C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,4BAA4B;SAC1C;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,4DAA4D;SAC1E;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAU;CACnB,CAAC;AAqBX,MAAM,UAAU,aAAa,CAC3B,IAAiB;IAEjB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,KAAK;QACZ,WAAW,EACT,kEAAkE;YAClE,gEAAgE;YAChE,wEAAwE;QAC1E,UAAU,EAAE,eAAe;QAE3B,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAqB,EAA+B,EAAE;YACzF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;gBACrC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;gBAC7C,OAAO,EAAE;oBACP,IAAI,EAAE,KAAK;oBACX,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,eAAe,EAAE,MAAM,CAAC,eAAe;oBACvC,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/skills/tools/video-edit-tool.d.ts

@@ -0,0 +1,70 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const VIDEO_EDIT_TOOL_NAME: "video_edit";
+export interface VideoEditToolParams {
+    prompt: string;
+    source_videos: string[];
+    reference_images?: string[];
+    duration?: number;
+    aspect_ratio?: string;
+    resolution?: string;
+}
+export declare const VIDEO_EDIT_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly prompt: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly source_videos: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly minItems: 1;
+            readonly maxItems: 3;
+            readonly description: "Video(s) to edit (1-3 URLs). Order: [0]=视频1, [1]=视频2, [2]=视频3.";
+        };
+        readonly reference_images: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Optional reference images for element replacement (up to 9).";
+        };
+        readonly duration: {
+            readonly type: "number";
+            readonly description: "Output duration in seconds (4-15s). Default: same as source.";
+        };
+        readonly aspect_ratio: {
+            readonly type: "string";
+            readonly description: "Output aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. Default: same as source.";
+        };
+        readonly resolution: {
+            readonly type: "string";
+            readonly description: "Output resolution: '480p' or '720p'. Default: '720p'.";
+        };
+    };
+    readonly required: readonly ["prompt", "source_videos"];
+};
+export interface VideoEditResult {
+    mediaUrls: string[];
+    model?: string;
+    durationMs?: number;
+}
+/** Deps injected by the host runtime for video editing. */
+export interface VideoEditToolDeps {
+    /**
+     * Edit a video via the configured backend (Seedance 2.0, etc.).
+     * The host handles URL resolution, model routing, and storage.
+     */
+    editVideo(params: {
+        prompt: string;
+        sourceVideos: string[];
+        referenceImages?: string[];
+        duration?: number;
+        aspectRatio?: string;
+        resolution?: string;
+    }): Promise<VideoEditResult>;
+}
+export declare function createVideoEditTool(deps: VideoEditToolDeps): PortableTool<VideoEditToolParams>;
+//# sourceMappingURL=video-edit-tool.d.ts.map

package/dist/skills/tools/video-edit-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-edit-tool.d.ts","sourceRoot":"","sources":["../../../src/skills/tools/video-edit-tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,qBAAqB,CAAC;AAE5E,eAAO,MAAM,oBAAoB,EAAG,YAAqB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCzB,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9B;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,GACtB,YAAY,CAAC,mBAAmB,CAAC,CAqCnC"}

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

@@ -0,0 +1,75 @@
+// ============================================================
+// 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,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=video-edit-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-edit-tool.js","sourceRoot":"","sources":["../../../src/skills/tools/video-edit-tool.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8DAA8D;AAC9D,kBAAkB;AAClB,+DAA+D;AAI/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAqB,CAAC;AAW1D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,QAAiB;IACvB,UAAU,EAAE;QACV,MAAM,EAAE;YACN,IAAI,EAAE,QAAiB;YACvB,WAAW,EACT,uDAAuD;gBACvD,gCAAgC;gBAChC,6DAA6D;SAChE;QACD,aAAa,EAAE;YACb,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,gEAAgE;SAC9E;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,OAAgB;YACtB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;YAClC,WAAW,EAAE,8DAA8D;SAC5E;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,8DAA8D;SAC5E;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,gFAAgF;SAC9F;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,WAAW,EAAE,uDAAuD;SACrE;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAU;CACtC,CAAC;AAwBX,MAAM,UAAU,mBAAmB,CACjC,IAAuB;IAEvB,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,6EAA6E;YAC7E,yDAAyD;YACzD,qEAAqE;QACvE,UAAU,EAAE,sBAAsB;QAElC,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAA2B,EAA+B,EAAE;YAC/F,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;gBAClC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,EAAE,CAAC;YACpF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC;gBAClC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,YAAY,EAAE,MAAM,CAAC,aAAa;gBAClC,eAAe,EAAE,MAAM,CAAC,gBAAgB;gBACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,YAAY;gBAChC,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,4BAA4B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAE3F,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE;oBACP,IAAI,EAAE,YAAY;oBAClB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}