ysagc-agent 0.6.0 → 0.7.1

package/dist/onboarding.js

@@ -0,0 +1,218 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInteractiveStdin = isInteractiveStdin;
+exports.generateDeviceId = generateDeviceId;
+exports.generateDeviceToken = generateDeviceToken;
+exports.prompt = prompt;
+exports.promptMasked = promptMasked;
+exports.runOnboarding = runOnboarding;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const readline = __importStar(require("node:readline"));
+const readlinePromises = __importStar(require("node:readline/promises"));
+const config_1 = require("./config");
+/** Whether stdin is an interactive terminal (used to avoid hanging in piped runs). */
+function isInteractiveStdin() {
+    return process.stdin.isTTY === true;
+}
+/** A fresh, stable device identifier used for pairing with the platform. */
+function generateDeviceId() {
+    return `device-${node_crypto_1.default.randomBytes(6).toString('hex')}`;
+}
+/** A fresh device token value sent in the hello frame. */
+function generateDeviceToken() {
+    return node_crypto_1.default.randomBytes(18).toString('hex');
+}
+/** Prompt with an echoed line for interactive terminals. */
+async function prompt(question, opts = {}) {
+    const rl = readlinePromises.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const label = opts.default !== undefined ? `${question} [${opts.default}]: ` : `${question}: `;
+        const answer = await rl.question(label);
+        return answer.trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Prompt for a secret WITHOUT echoing (masks each typed character as `*`).
+ * Uses raw-mode keypress handling — no external dependency.
+ */
+function promptMasked(question) {
+    const input = process.stdin;
+    const output = process.stdout;
+    return new Promise((resolve) => {
+        if (input.isTTY !== true) {
+            // Not a TTY: never hang. Return empty so onboarding can derive a token.
+            output.write(`${question}\n`);
+            resolve('');
+            return;
+        }
+        readline.emitKeypressEvents(input);
+        const setRaw = input.setRawMode;
+        if (typeof setRaw === 'function')
+            setRaw.call(input, true);
+        input.resume();
+        let value = '';
+        let done = false;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            input.removeListener('keypress', onKeypress);
+            if (typeof setRaw === 'function')
+                setRaw.call(input, false);
+            output.write('\n');
+            resolve(value);
+        };
+        const onKeypress = (str, key) => {
+            if (key) {
+                if (key.name === 'return' || key.name === 'enter') {
+                    finish();
+                    return;
+                }
+                if (key.name === 'backspace') {
+                    if (value.length > 0) {
+                        value = value.slice(0, -1);
+                        output.write('\b \b');
+                    }
+                    return;
+                }
+                if (key.ctrl && (key.name === 'c' || key.name === 'd')) {
+                    finish();
+                    return;
+                }
+            }
+            if (str && (!key || (!key.ctrl && !key.meta))) {
+                value += str;
+                output.write('*');
+            }
+        };
+        input.on('keypress', onKeypress);
+        output.write(question);
+    });
+}
+/** Resolve a root path, creating it if missing and rejecting non-directories. */
+function resolveAndValidateRoot(raw) {
+    const t = (raw ?? '').trim();
+    let abs;
+    if (!t)
+        abs = process.cwd();
+    else if (t === '~')
+        abs = node_os_1.default.homedir();
+    else if (t.startsWith('~/') || t.startsWith('~\\'))
+        abs = node_path_1.default.join(node_os_1.default.homedir(), t.slice(2));
+    else
+        abs = node_path_1.default.resolve(t);
+    try {
+        if (!node_fs_1.default.existsSync(abs))
+            node_fs_1.default.mkdirSync(abs, { recursive: true });
+    }
+    catch (err) {
+        throw new config_1.ConfigError(`无法创建工作区目录 ${abs}${err instanceof Error ? ` (${err.message})` : ''}`);
+    }
+    if (!node_fs_1.default.statSync(abs).isDirectory()) {
+        throw new config_1.ConfigError(`工作区路径不是目录: ${abs}`);
+    }
+    return abs;
+}
+/**
+ * Interactive first-run onboarding. Prompts for the platform address (server),
+ * the device token (masked) and the workspace root, then returns a fully
+ * resolved {@link AgentConfig}. Any value present in {@link inputs} (from CLI /
+ * env) is used as-is and its prompt is skipped; an empty device token falls back
+ * to a freshly-generated device id + token with a short pairing hint.
+ */
+async function runOnboarding(inputs = {}) {
+    const out = process.stdout;
+    // 1) Platform address (server URL) — http(s) normalised to ws(s).
+    let server;
+    if (inputs.server && inputs.server.trim() !== '') {
+        server = (0, config_1.normalizeServerUrl)(inputs.server);
+        out.write(`\n平台地址: ${server}\n`);
+    }
+    else {
+        const raw = await prompt('平台地址', { default: config_1.DEFAULT_SERVER });
+        server = (0, config_1.normalizeServerUrl)(raw || config_1.DEFAULT_SERVER);
+    }
+    // 2) Device token — masked. Empty => derive a fresh device id + token.
+    let token = (inputs.token ?? '').trim();
+    let deviceId = (inputs.deviceId ?? '').trim() || undefined;
+    if (!token) {
+        out.write('\n从工作台的『如何连接』复制你的设备 Token 粘贴到这里\n');
+        token = await promptMasked('设备 Token（留空则以本机设备 ID 配对）: ');
+        if (!token) {
+            deviceId = deviceId ?? generateDeviceId();
+            token = generateDeviceToken();
+            out.write('\n未提供设备 Token。');
+            out.write(`已生成本机设备 ID: ${deviceId}\n`);
+            out.write('请到平台工作台的『设备』页绑定该设备 ID（并复制 Token 填入）后重试。\n');
+        }
+    }
+    if (!deviceId)
+        deviceId = generateDeviceId();
+    // 3) Workspace root — default cwd, validated (created if missing).
+    let root;
+    if (inputs.root && inputs.root.trim() !== '') {
+        root = resolveAndValidateRoot(inputs.root);
+    }
+    else {
+        const raw = await prompt('工作区目录', { default: process.cwd() });
+        root = resolveAndValidateRoot(raw || process.cwd());
+    }
+    return (0, config_1.loadConfig)({
+        server,
+        token,
+        deviceId,
+        root,
+        mode: inputs.mode,
+        preset: inputs.preset,
+        web: inputs.web,
+        timeoutMs: inputs.timeoutMs,
+        maxBytes: inputs.maxBytes,
+        logLevel: inputs.logLevel,
+    });
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/onboarding.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ysagc-agent",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Local execution agent for ysagc: a state-agnostic, safety-bounded worker that connects to a platform backend over WebSocket, executes tool instructions inside an authorization root, and reports results back.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",