@kobinflow/canvas-agent 0.6.0

package/dist/canvas/tools.d.ts

@@ -0,0 +1,214 @@
+import { type ToolName } from "./schemas.js";
+import type { CanvasNode, CanvasSnapshot } from "./types.js";
+/** 判断传入名称是否为已注册的画布工具。 */
+export declare function isToolName(name: unknown): name is ToolName;
+/** 按工具名称校验并解析调用参数。 */
+export declare function parseToolInput(name: ToolName, input: unknown): {
+    path: string;
+} | {
+    keyword?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+} | {
+    ops: (import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"add_node">;
+        nodeType: import("zod").ZodOptional<import("zod").ZodEnum<["image", "text", "config", "video", "audio"]>>;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        x: import("zod").ZodOptional<import("zod").ZodNumber>;
+        y: import("zod").ZodOptional<import("zod").ZodNumber>;
+        width: import("zod").ZodOptional<import("zod").ZodNumber>;
+        height: import("zod").ZodOptional<import("zod").ZodNumber>;
+        position: import("zod").ZodOptional<import("zod").ZodObject<{
+            x: import("zod").ZodNumber;
+            y: import("zod").ZodNumber;
+        }, "strip", import("zod").ZodTypeAny, {
+            x: number;
+            y: number;
+        }, {
+            x: number;
+            y: number;
+        }>>;
+        metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"update_node">;
+        id: import("zod").ZodString;
+        patch: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+        metadata: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"delete_node">;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        ids: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"delete_connections">;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        ids: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+        all: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"connect_nodes">;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        fromNodeId: import("zod").ZodString;
+        toNodeId: import("zod").ZodString;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"set_viewport">;
+        viewport: import("zod").ZodObject<{
+            x: import("zod").ZodNumber;
+            y: import("zod").ZodNumber;
+            k: import("zod").ZodNumber;
+        }, "strip", import("zod").ZodTypeAny, {
+            x: number;
+            y: number;
+            k: number;
+        }, {
+            x: number;
+            y: number;
+            k: number;
+        }>;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"select_nodes">;
+        ids: import("zod").ZodArray<import("zod").ZodString, "many">;
+    }, import("zod").ZodTypeAny, "passthrough"> | import("zod").objectOutputType<{
+        type: import("zod").ZodLiteral<"run_generation">;
+        nodeId: import("zod").ZodString;
+        mode: import("zod").ZodOptional<import("zod").ZodEnum<["text", "image", "video", "audio"]>>;
+        prompt: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod").ZodTypeAny, "passthrough">)[];
+} | {
+    nodeType: "image" | "video" | "audio" | "text" | "config";
+    title?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    x?: number | undefined;
+    y?: number | undefined;
+} | {
+    attachmentIds: string[];
+    x?: number | undefined;
+    y?: number | undefined;
+    gap?: number | undefined;
+    direction?: "row" | "column" | undefined;
+} | {
+    text?: string | undefined;
+    title?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    x?: number | undefined;
+    y?: number | undefined;
+} | {
+    items: {
+        text: string;
+        title?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        x?: number | undefined;
+        y?: number | undefined;
+    }[];
+    x?: number | undefined;
+    y?: number | undefined;
+    gap?: number | undefined;
+    direction?: "row" | "column" | undefined;
+} | {
+    [x: string]: any;
+} | {
+    id: string;
+    metadata?: Record<string, unknown> | undefined;
+    patch?: Record<string, unknown> | undefined;
+} | {
+    text: string;
+    id: string;
+    title?: string | undefined;
+} | {
+    items: {
+        id: string;
+        x?: number | undefined;
+        y?: number | undefined;
+        dx?: number | undefined;
+        dy?: number | undefined;
+    }[];
+} | {
+    id: string;
+    width: number;
+    height: number;
+    freeResize?: boolean | undefined;
+} | {
+    ids: string[];
+} | {
+    connections: {
+        fromNodeId: string;
+        toNodeId: string;
+    }[];
+} | {
+    viewport: {
+        x: number;
+        y: number;
+        k: number;
+    };
+} | {
+    nodeId: string;
+    mode?: "image" | "video" | "audio" | "text" | undefined;
+    prompt?: string | undefined;
+} | {
+    limit?: number | undefined;
+    scope?: "image" | "video" | "canvas" | "all" | undefined;
+    taskId?: string | undefined;
+    nodeIds?: string[] | undefined;
+} | {
+    prompt: string;
+    count?: number | undefined;
+    model?: string | undefined;
+    size?: string | undefined;
+    quality?: string | undefined;
+    run?: boolean | undefined;
+} | {
+    prompt: string;
+    mode?: "frames" | "reference" | undefined;
+    model?: string | undefined;
+    size?: string | undefined;
+    seconds?: string | undefined;
+    generateAudio?: boolean | undefined;
+    watermark?: boolean | undefined;
+    run?: boolean | undefined;
+    resolution?: string | undefined;
+} | {
+    kind: "image" | "text";
+    title: string;
+    source?: string | undefined;
+    note?: string | undefined;
+    content?: string | undefined;
+    tags?: string[] | undefined;
+    imageUrl?: string | undefined;
+};
+/** 压缩画布快照，避免向 Agent 返回过长的节点内容。 */
+export declare function compactCanvasState(state: CanvasSnapshot | null): {
+    nodes: {
+        id: string;
+        type: import("./types.js").CanvasNodeType;
+        title: string | undefined;
+        position: import("./types.js").Position;
+        width: number;
+        height: number;
+        metadata: {
+            [x: string]: unknown;
+        };
+    }[];
+    projectId?: string;
+    title?: string;
+    connections?: import("./types.js").CanvasConnection[];
+    selectedNodeIds?: string[];
+    viewport?: import("./types.js").Viewport;
+    clientId?: string;
+};
+/** 压缩单个画布节点的元数据内容。 */
+export declare function compactNode(node: CanvasNode): {
+    id: string;
+    type: import("./types.js").CanvasNodeType;
+    title: string | undefined;
+    position: import("./types.js").Position;
+    width: number;
+    height: number;
+    metadata: {
+        [x: string]: unknown;
+    };
+};
+/** 计算新节点在当前画布右侧的默认横坐标。 */
+export declare function nextCanvasX(state: CanvasSnapshot | null): number;

package/dist/canvas/tools.js

@@ -0,0 +1,27 @@
+import { toolInputSchemas, toolNames } from "./schemas.js";
+/** 判断传入名称是否为已注册的画布工具。 */
+export function isToolName(name) {
+    return typeof name === "string" && toolNames.includes(name);
+}
+/** 按工具名称校验并解析调用参数。 */
+export function parseToolInput(name, input) {
+    return toolInputSchemas[name].parse(input ?? {});
+}
+/** 压缩画布快照，避免向 Agent 返回过长的节点内容。 */
+export function compactCanvasState(state) {
+    if (!state)
+        throw new Error("当前没有已连接画布");
+    return { ...state, nodes: (state.nodes || []).map(compactNode) };
+}
+/** 压缩单个画布节点的元数据内容。 */
+export function compactNode(node) {
+    const metadata = { ...(node.metadata || {}) };
+    if (typeof metadata.content === "string" && metadata.content.length > 240)
+        metadata.content = `${metadata.content.slice(0, 120)}...`;
+    return { id: node.id, type: node.type, title: node.title, position: node.position, width: node.width, height: node.height, metadata };
+}
+/** 计算新节点在当前画布右侧的默认横坐标。 */
+export function nextCanvasX(state) {
+    const nodes = state?.nodes || [];
+    return nodes.length ? Math.max(...nodes.map((node) => node.position.x + node.width)) + 80 : 0;
+}

package/dist/canvas/types.d.ts

@@ -0,0 +1,34 @@
+/** 画布坐标。 */
+export type Position = {
+    x: number;
+    y: number;
+};
+export type Viewport = {
+    x: number;
+    y: number;
+    k: number;
+};
+export type CanvasNodeType = "image" | "text" | "config" | "video" | "audio";
+export type CanvasNode = {
+    id: string;
+    type: CanvasNodeType;
+    title?: string;
+    position: Position;
+    width: number;
+    height: number;
+    metadata?: Record<string, unknown>;
+};
+export type CanvasConnection = {
+    id: string;
+    fromNodeId: string;
+    toNodeId: string;
+};
+export type CanvasSnapshot = {
+    projectId?: string;
+    title?: string;
+    nodes?: CanvasNode[];
+    connections?: CanvasConnection[];
+    selectedNodeIds?: string[];
+    viewport?: Viewport;
+    clientId?: string;
+};

package/dist/canvas/types.js

@@ -0,0 +1 @@
+export {};

package/dist/config.d.ts

@@ -0,0 +1,30 @@
+export declare const DEFAULT_PORT = 17371;
+export declare const CONFIG_DIR: string;
+export declare const CONFIG_FILE: string;
+export declare const VERSION: string;
+export declare const AGENT_PROMPT: string;
+export type SiteWorkspaceConfig = {
+    workspacePath: string;
+    activeThreadId?: string;
+    pinnedThreadIds?: string[];
+};
+export type CanvasAgentConfig = {
+    url: string;
+    token: string;
+    origins?: string[];
+    workspace?: SiteWorkspaceConfig;
+};
+/** 读取本地 Canvas Agent 配置，不存在时生成默认配置。 */
+export declare function loadConfig(create?: boolean): CanvasAgentConfig;
+/** 将 Canvas Agent 配置写入用户配置目录。 */
+export declare function saveConfig(config: CanvasAgentConfig): void;
+/** 写入配置并强制目录 0700、文件 0600，包括纠正已有宽松权限。 */
+export declare function writeConfigFile(dir: string, file: string, config: CanvasAgentConfig): void;
+/** 确保站点级 Codex 工作空间存在并已初始化。 */
+export declare function ensureSiteWorkspace(config: CanvasAgentConfig): {
+    workspacePath: string;
+    activeThreadId?: string;
+    pinnedThreadIds?: string[];
+};
+/** 更新站点级 Codex 工作空间配置。 */
+export declare function updateSiteWorkspace(config: CanvasAgentConfig, patch: Partial<SiteWorkspaceConfig>): SiteWorkspaceConfig;

package/dist/config.js

@@ -0,0 +1,86 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export const DEFAULT_PORT = 17371;
+export const CONFIG_DIR = path.join(os.homedir(), ".infinite-canvas");
+export const CONFIG_FILE = path.join(CONFIG_DIR, "canvas-agent.json");
+export const VERSION = readPackageVersion();
+export const AGENT_PROMPT = fs.readFileSync(new URL("../agent-instructions.md", import.meta.url), "utf8");
+const initializedWorkspaces = new Set();
+/** 读取本地 Canvas Agent 配置，不存在时生成默认配置。 */
+export function loadConfig(create = false) {
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
+    }
+    catch {
+        const config = { url: `http://127.0.0.1:${Number(process.env.PORT) || DEFAULT_PORT}`, token: crypto.randomBytes(18).toString("hex") };
+        if (create)
+            saveConfig(config);
+        return config;
+    }
+}
+/** 将 Canvas Agent 配置写入用户配置目录。 */
+export function saveConfig(config) {
+    writeConfigFile(CONFIG_DIR, CONFIG_FILE, config);
+}
+/** 写入配置并强制目录 0700、文件 0600，包括纠正已有宽松权限。 */
+export function writeConfigFile(dir, file, config) {
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(file, JSON.stringify(config, null, 2), { mode: 0o600 });
+    fs.chmodSync(dir, 0o700);
+    fs.chmodSync(file, 0o600);
+}
+/** 确保站点级 Codex 工作空间存在并已初始化。 */
+export function ensureSiteWorkspace(config) {
+    const current = config.workspace;
+    if (current?.workspacePath) {
+        const workspacePath = resolveWorkspacePath(current.workspacePath);
+        initializeWorkspace(workspacePath);
+        return { ...current, workspacePath };
+    }
+    const workspacePath = path.join(CONFIG_DIR, "codex-workspaces", "site");
+    config.workspace = { workspacePath };
+    initializeWorkspace(workspacePath);
+    saveConfig(config);
+    return { workspacePath };
+}
+/** 更新站点级 Codex 工作空间配置。 */
+export function updateSiteWorkspace(config, patch) {
+    const current = ensureSiteWorkspace(config);
+    const workspacePath = patch.workspacePath ? resolveWorkspacePath(patch.workspacePath) : current.workspacePath;
+    const next = { ...current, ...patch, workspacePath };
+    config.workspace = { workspacePath: next.workspacePath, activeThreadId: next.activeThreadId, pinnedThreadIds: next.pinnedThreadIds };
+    initializeWorkspace(workspacePath);
+    saveConfig(config);
+    return config.workspace;
+}
+/** 创建工作空间目录并写入默认 AGENTS.md。 */
+function initializeWorkspace(workspacePath) {
+    if (initializedWorkspaces.has(workspacePath))
+        return;
+    fs.mkdirSync(workspacePath, { recursive: true });
+    const instructionsFile = path.join(workspacePath, "AGENTS.md");
+    const current = fs.existsSync(instructionsFile) ? fs.readFileSync(instructionsFile, "utf8") : "";
+    if (!current || current.startsWith("# Infinite Canvas Agent"))
+        fs.writeFileSync(instructionsFile, AGENT_PROMPT);
+    initializedWorkspaces.add(workspacePath);
+}
+/** 将用户输入的工作空间路径解析为绝对路径。 */
+function resolveWorkspacePath(value) {
+    if (value === "~")
+        return os.homedir();
+    if (value.startsWith("~/"))
+        return path.join(os.homedir(), value.slice(2));
+    return path.resolve(value);
+}
+/** 从当前包信息中读取 Canvas Agent 版本号。 */
+function readPackageVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        return pkg.version || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { startHttpServer } from "./server/http.js";
+import { startMcpServer } from "./server/mcp.js";
+if (process.argv[2] === "mcp")
+    await startMcpServer();
+else
+    startHttpServer();

package/dist/server/http.d.ts

@@ -0,0 +1,2 @@
+/** 启动仅监听本机的 Canvas Agent HTTP 服务。 */
+export declare function startHttpServer(): void;