@dream-craft/canvas-agent 0.0.0-stage → 0.6.4

package/dist/utils/logger.js

@@ -0,0 +1,81 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { inspect } from "node:util";
+import winston, { format, transports } from "winston";
+import { formatDateForFilename } from "./date.js";
+/** 管理 Canvas Agent 的终端与文件 Debug 日志。 */
+export class Logger {
+    enabled = process.argv.includes("--debug");
+    filePath = this.enabled ? path.join(os.homedir(), ".infinite-canvas", "logs", `canvas-agent-${formatDateForFilename()}.log`) : "";
+    logger;
+    /** 普通模式输出 Info 以上日志，Debug 模式额外输出 Debug 并写入文件。 */
+    constructor() {
+        const line = format.printf(({ level, message, timestamp, details }) => `${timestamp} ${level.toUpperCase()} ${message}${formatDetails(details)}`);
+        const output = format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), line);
+        if (this.enabled)
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+        this.logger = winston.createLogger({
+            level: this.enabled ? "debug" : "info",
+            transports: [
+                new transports.Console({ format: output }),
+                ...(this.enabled ? [new transports.File({ filename: this.filePath, format: output })] : []),
+            ],
+        });
+    }
+    /** 输出 Debug 级别日志。 */
+    debug(message, details) {
+        if (details === undefined)
+            this.logger.debug(message);
+        else
+            this.logger.debug(message, { details: sanitize(details) });
+    }
+    /** 输出 Info 级别日志。 */
+    info(message, details) {
+        if (details === undefined)
+            this.logger.info(message);
+        else
+            this.logger.info(message, { details: sanitize(details) });
+    }
+    /** 输出 Warn 级别日志。 */
+    warn(message, details) {
+        if (details === undefined)
+            this.logger.warn(message);
+        else
+            this.logger.warn(message, { details: sanitize(details) });
+    }
+    /** 输出 Error 级别日志。 */
+    error(message, details) {
+        if (details === undefined)
+            this.logger.error(message);
+        else
+            this.logger.error(message, { details: sanitize(details) });
+    }
+}
+/** 将日志详情格式化为紧凑的单行文本。 */
+function formatDetails(details) {
+    if (details === undefined)
+        return "";
+    if (!details || typeof details !== "object" || Array.isArray(details))
+        return ` ${inspect(details, { depth: null, breakLength: Infinity })}`;
+    const text = Object.entries(details).filter(([, value]) => value !== undefined).map(([key, value]) => `${key}=${inspect(value, { depth: null, breakLength: Infinity })}`).join(" ");
+    return text ? ` ${text}` : "";
+}
+/** 清理日志内容中的敏感数据和不可序列化引用。 */
+function sanitize(value, key = "", seen = new WeakSet()) {
+    if (/token|authorization|api.?key|dataurl/i.test(key))
+        return "[REDACTED]";
+    if (typeof value === "string" && value.startsWith("data:"))
+        return `[DATA URL ${value.length} chars]`;
+    if (value instanceof Error)
+        return { name: value.name, message: value.message, stack: value.stack };
+    if (!value || typeof value !== "object")
+        return value;
+    if (seen.has(value))
+        return "[CIRCULAR]";
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.map((item) => sanitize(item, key, seen));
+    return Object.fromEntries(Object.entries(value).map(([field, item]) => [field, sanitize(item, field, seen)]));
+}
+export const logger = new Logger();

package/dist/utils/value.d.ts

@@ -0,0 +1,5 @@
+export type JsonRecord = Record<string, unknown>;
+/** 安全读取未知对象中的指定字段。 */
+export declare function field(value: unknown, key: string): unknown;
+/** 将未知异常转换为可展示的错误信息。 */
+export declare function errorMessage(error: unknown): string;

package/dist/utils/value.js

@@ -0,0 +1,8 @@
+/** 安全读取未知对象中的指定字段。 */
+export function field(value, key) {
+    return value && typeof value === "object" ? value[key] : undefined;
+}
+/** 将未知异常转换为可展示的错误信息。 */
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/dist/version-check.d.ts

@@ -0,0 +1,2 @@
+/** 输出当前版本，并在后台检查 npm 最新版本。 */
+export declare function checkVersions(): void;

package/dist/version-check.js

@@ -0,0 +1,65 @@
+import { execFile, execFileSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { promisify } from "node:util";
+import { VERSION } from "./config.js";
+import { logger } from "./utils/logger.js";
+const require = createRequire(import.meta.url);
+const execFileAsync = promisify(execFile);
+const CODEX_VERSION = String(require("@openai/codex/package.json").version);
+/** 输出当前版本，并在后台检查 npm 最新版本。 */
+export function checkVersions() {
+    const localCodexVersion = commandVersion("codex");
+    logger.info("Canvas Agent version", { version: VERSION });
+    logger.info("Bundled Codex version", { version: CODEX_VERSION });
+    logger.info("Local Codex version", { version: localCodexVersion || "not found" });
+    if (!localCodexVersion) {
+        logger.warn("Local Codex was not found. Install the latest version with: npm install -g @openai/codex@latest");
+    }
+    else if (localCodexVersion !== CODEX_VERSION) {
+        logger.warn(`Bundled Codex ${CODEX_VERSION} does not match local Codex ${localCodexVersion}. Keep both current with: npm install -g @openai/codex@latest && npx -y @dream-craft/canvas-agent@latest`);
+    }
+    void checkLatestVersions(localCodexVersion);
+}
+/** 查询 npm，提醒升级不再维护的旧版本。 */
+async function checkLatestVersions(localCodexVersion) {
+    try {
+        const [latestAgent, latestCodex] = await Promise.all([
+            npmVersion("@dream-craft/canvas-agent"),
+            npmVersion("@openai/codex"),
+        ]);
+        if (isOlder(VERSION, latestAgent))
+            logger.warn(`Update available: Canvas Agent ${VERSION} -> ${latestAgent}. Run: npx -y @dream-craft/canvas-agent@latest`);
+        if (isOlder(CODEX_VERSION, latestCodex))
+            logger.warn(`Update available: bundled Codex ${CODEX_VERSION} -> ${latestCodex}. Upgrade Canvas Agent with: npx -y @dream-craft/canvas-agent@latest`);
+        if (localCodexVersion && isOlder(localCodexVersion, latestCodex))
+            logger.warn(`Update available: local Codex ${localCodexVersion} -> ${latestCodex}. Run: npm install -g @openai/codex@latest`);
+    }
+    catch {
+        logger.warn("Unable to check the latest npm versions; startup will continue.");
+    }
+}
+/** 读取本机命令输出中的语义版本号。 */
+function commandVersion(command) {
+    try {
+        return execFileSync(command, ["--version"], { encoding: "utf8", timeout: 5_000 }).match(/\d+\.\d+\.\d+/)?.[0] || "";
+    }
+    catch {
+        return "";
+    }
+}
+/** 读取 npm 包的最新版本。 */
+async function npmVersion(name) {
+    const command = process.platform === "win32" ? "npm.cmd" : "npm";
+    const { stdout } = await execFileAsync(command, ["view", name, "version"], { encoding: "utf8", timeout: 10_000 });
+    return stdout.trim();
+}
+/** 比较仅包含数字段的稳定版语义版本。 */
+function isOlder(current, latest) {
+    const left = current.split(".").map(Number);
+    const right = latest.split(".").map(Number);
+    for (let index = 0; index < Math.max(left.length, right.length); index++) {
+        if ((left[index] || 0) !== (right[index] || 0))
+            return (left[index] || 0) < (right[index] || 0);
+    }
+    return false;
+}

package/package.json

@@ -1,6 +1,46 @@
-{
-  "name": "@dream-craft/canvas-agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "@dream-craft/canvas-agent",
+  "version": "0.6.4",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "canvas-agent": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "agent-instructions.md",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "debug": "tsx src/index.ts --debug",
+    "test": "tsx --test src/config.test.ts src/canvas/operations.test.ts src/canvas/session.test.ts src/agent/codex-client.test.ts src/agent/codex-history.test.ts src/agent/message-metadata.test.ts src/skills/store.test.ts src/utils/agent-runtime.test.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "@openai/codex": "0.146.0",
+    "express": "^5.1.0",
+    "gray-matter": "^4.0.3",
+    "strip-ansi": "7.2.0",
+    "winston": "^3.19.0",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}