ysagc-agent 0.2.0 → 0.4.0

package/dist/executor.js

@@ -0,0 +1,397 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenize = tokenize;
+exports.shouldUseShell = shouldUseShell;
+exports.sanitizeEnv = sanitizeEnv;
+exports.runCommand = runCommand;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+/** POSIX shell built-ins that cannot be executed as standalone binaries. */
+const POSIX_BUILTINS = new Set([
+    'cd',
+    '.',
+    'source',
+    'export',
+    'set',
+    'unset',
+    'alias',
+    'unalias',
+    'umask',
+    'type',
+    'printf',
+    'read',
+    'exit',
+    'break',
+    'continue',
+    'echo',
+    'true',
+    'false',
+]);
+/** Characters that make a command require interpretation by a shell. */
+const SHELL_META = /[|&;`<>()[\]{}*?~%!\n]/;
+const ENV_MAJOR = /\$\(|\$\{|`/;
+function needsShell(command) {
+    return SHELL_META.test(command) || ENV_MAJOR.test(command);
+}
+function startsWithBuiltin(program) {
+    return POSIX_BUILTINS.has(path.basename(program).toLowerCase());
+}
+/**
+ * Split a simple command string into argv (respects single/double quotes and
+ * backslash escape). Do not use for commands with shell metacharacters.
+ */
+function tokenize(input) {
+    const tokens = [];
+    let cur = '';
+    let quote = null;
+    let escaped = false;
+    for (const ch of input) {
+        if (escaped) {
+            cur += ch;
+            escaped = false;
+            continue;
+        }
+        if (ch === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (quote) {
+            if (ch === quote) {
+                quote = null;
+                continue;
+            }
+            cur += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            if (cur !== '') {
+                tokens.push(cur);
+                cur = '';
+            }
+            continue;
+        }
+        cur += ch;
+    }
+    if (cur !== '')
+        tokens.push(cur);
+    return tokens;
+}
+/** Decide whether a command must run through a shell. On Windows the shell is
+ * always used because many common commands are cmd builtins. */
+function shouldUseShell(command, override) {
+    if (override !== undefined)
+        return override;
+    if (process.platform === 'win32')
+        return true;
+    return needsShell(command) || startsWithBuiltin(tokenize(command)[0] ?? '');
+}
+/** Build a sanitised env so agent/platform credentials never reach child
+ * processes. Essential environment (PATH, HOME, LANG, ...) is preserved. */
+function sanitizeEnv(base, extra) {
+    const out = {};
+    const merged = { ...base, ...(extra ?? {}) };
+    for (const [key, value] of Object.entries(merged)) {
+        const upper = key.toUpperCase();
+        // Drop agent config variables and obvious credentials.
+        if (/^YSAGC_/i.test(key) || upper === 'WS_URL')
+            continue;
+        if (/TOKEN$|SECRET$|PASSWORD$|PASSWD$|API[_-]?KEY$|ACCESS[_-]?KEY$|PRIVATE[_-]?KEY$|AUTHORIZATION$|CREDENTIALS?$|AUTH[_-]?TOKEN$/.test(upper)) {
+            continue;
+        }
+        out[key] = value;
+    }
+    return out;
+}
+/** Create a directory for capturing command output. Tries the OS temp dir
+ * first, then the current working directory (which is normally writable even
+ * when the system temp is not). */
+function makeTempDir() {
+    const candidates = [
+        path.join(os.tmpdir(), `ysagc-out-${process.pid}-${Date.now().toString(36)}`),
+        path.join(process.cwd(), `.ysagc-tmp-${process.pid}-${Date.now().toString(36)}`),
+    ];
+    for (const dir of candidates) {
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            return dir;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    throw new Error('Unable to create a temporary output directory');
+}
+/** Kill a process and its whole tree (best-effort, cross-platform). */
+function killTree(child) {
+    if (child.pid === undefined)
+        return;
+    if (process.platform === 'win32') {
+        try {
+            (0, node_child_process_1.spawn)('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true });
+        }
+        catch {
+            child.kill('SIGKILL');
+        }
+    }
+    else {
+        try {
+            process.kill(-child.pid, 'SIGKILL'); // negative pid = process group (detached)
+        }
+        catch {
+            child.kill('SIGKILL');
+        }
+    }
+}
+/** Read the first `maxBytes` bytes of a file as UTF-8. */
+function readCapped(file, maxBytes) {
+    const total = fs.statSync(file).size;
+    const readLen = Math.min(maxBytes, total);
+    const fd = fs.openSync(file, 'r');
+    try {
+        const buf = Buffer.alloc(readLen);
+        const n = fs.readSync(fd, buf, 0, readLen, 0);
+        return { text: buf.subarray(0, n).toString('utf8'), truncated: total > maxBytes, total };
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/**
+ * Run a command, capturing stdout/stderr (spilled to a temp file when it
+ * exceeds `maxBytes`), enforcing a timeout, and killing the process tree on
+ * timeout or abort. Non-zero exit codes are returned, not thrown. Output is
+ * captured through file-descriptor redirection rather than a pipe so it is
+ * robust on constrained platforms and for very large outputs.
+ */
+function runCommand(opts) {
+    const timeoutMs = opts.timeoutMs ?? 120000;
+    const maxBytes = opts.maxBytes ?? 64000;
+    const useShell = shouldUseShell(opts.command, opts.shell);
+    const env = sanitizeEnv(process.env, opts.env ?? {});
+    return new Promise((resolve) => {
+        const started = process.hrtime();
+        // Choose capture mode: file redirection (preferred) or pipe fallback.
+        let capture = 'file';
+        let tempDir;
+        let stdoutPath = '';
+        let stderrPath = '';
+        let stdoutFd = -1;
+        let stderrFd = -1;
+        try {
+            tempDir = makeTempDir();
+            stdoutPath = path.join(tempDir, 'stdout.log');
+            stderrPath = path.join(tempDir, 'stderr.log');
+            stdoutFd = fs.openSync(stdoutPath, 'w');
+            stderrFd = fs.openSync(stderrPath, 'w');
+        }
+        catch {
+            capture = 'pipe';
+            tempDir = undefined;
+        }
+        const stdio = capture === 'file' ? ['ignore', stdoutFd, stderrFd] : undefined;
+        let child;
+        if (useShell) {
+            child = (0, node_child_process_1.spawn)(opts.command, { cwd: opts.cwd, env, shell: true, windowsHide: true, ...(stdio ? { stdio } : {}) });
+        }
+        else {
+            const args = tokenize(opts.command);
+            child = (0, node_child_process_1.spawn)(args[0] ?? '', args.slice(1), {
+                cwd: opts.cwd,
+                env,
+                shell: false,
+                windowsHide: true,
+                ...(stdio ? { stdio } : {}),
+            });
+        }
+        // The child now owns the file descriptors; close the parent's copies.
+        if (capture === 'file') {
+            if (stdoutFd >= 0) {
+                try {
+                    fs.closeSync(stdoutFd);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            if (stderrFd >= 0) {
+                try {
+                    fs.closeSync(stderrFd);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        let pipeStdout = '';
+        let pipeStderr = '';
+        let pipeTruncated = false;
+        if (capture === 'pipe') {
+            const readPipe = (stream, target) => {
+                if (!stream)
+                    return;
+                stream.setEncoding('utf8');
+                stream.on('data', (chunk) => {
+                    const text = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+                    if (target === 'stdout') {
+                        if (pipeStdout.length < maxBytes) {
+                            const room = maxBytes - pipeStdout.length;
+                            pipeStdout += text.slice(0, room);
+                            if (text.length > room)
+                                pipeTruncated = true;
+                        }
+                        else {
+                            pipeTruncated = true;
+                        }
+                    }
+                    else {
+                        if (pipeStderr.length < maxBytes) {
+                            const room = maxBytes - pipeStderr.length;
+                            pipeStderr += text.slice(0, room);
+                            if (text.length > room)
+                                pipeTruncated = true;
+                        }
+                        else {
+                            pipeTruncated = true;
+                        }
+                    }
+                });
+            };
+            readPipe(child.stdout, 'stdout');
+            readPipe(child.stderr, 'stderr');
+        }
+        let timedOut = false;
+        let settled = false;
+        let timer;
+        const collect = (exitCode) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            const hr = process.hrtime(started);
+            const durationMs = Math.round(hr[0] * 1000 + hr[1] / 1e6);
+            if (capture === 'pipe') {
+                resolve({
+                    stdout: pipeStdout,
+                    stderr: pipeStderr,
+                    exitCode,
+                    durationMs,
+                    timedOut,
+                    truncated: pipeTruncated,
+                });
+                return;
+            }
+            try {
+                const so = readCapped(stdoutPath, maxBytes);
+                const se = readCapped(stderrPath, maxBytes);
+                const truncated = so.truncated || se.truncated;
+                let stdoutFile;
+                let stderrFile;
+                if (truncated) {
+                    // Keep the temp directory so the platform can retrieve full output.
+                    stdoutFile = stdoutPath;
+                    stderrFile = stderrPath;
+                }
+                else if (tempDir) {
+                    try {
+                        fs.rmSync(tempDir, { recursive: true, force: true });
+                    }
+                    catch {
+                        /* best-effort cleanup */
+                    }
+                }
+                resolve({
+                    stdout: so.text,
+                    stderr: se.text,
+                    exitCode,
+                    durationMs,
+                    timedOut,
+                    truncated,
+                    ...(stdoutFile ? { stdoutFile } : {}),
+                    ...(stderrFile ? { stderrFile } : {}),
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                resolve({
+                    stdout: '',
+                    stderr: msg,
+                    exitCode,
+                    durationMs,
+                    timedOut,
+                    truncated: false,
+                });
+            }
+        };
+        child.on('error', (err) => {
+            if (capture === 'pipe' && !pipeStderr)
+                pipeStderr = err.message;
+            collect(127);
+        });
+        let exitCode = 0;
+        child.on('exit', (code, signal) => {
+            exitCode = code ?? (signal ? 1 : 0);
+        });
+        // 'close' fires after all stdio is closed, so output is final.
+        child.on('close', (code, signal) => {
+            exitCode = code ?? (signal ? 1 : 0);
+            collect(exitCode);
+        });
+        timer = setTimeout(() => {
+            timedOut = true;
+            killTree(child);
+            // Timeout kills surface via close; fall back if the OS is slow.
+            const killTimer = setTimeout(() => {
+                if (!settled)
+                    collect(124);
+            }, 2000);
+            killTimer.unref?.();
+        }, timeoutMs);
+        if (opts.signal) {
+            opts.signal.addEventListener('abort', () => {
+                timedOut = false;
+                killTree(child);
+            }, { once: true });
+        }
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { startAgent, AGENT_VERSION } from './agent';
+export type { AgentHandle, AgentEvents } from './agent';
+export { runSelfTest } from './cli';
+export type { SelfTest } from './cli';
+export { canonicalize, isWithinRoot, assertInsideRoot, safeResolve } from './path-utils';
+export type { WithinRootOptions } from './path-utils';
+export { isDangerCommand, isSensitivePath, maskSecrets, MASK, } from './security';
+export type { DangerAssessment, DangerSeverity } from './security';
+export { createToolRegistry } from './tools';
+export type { ToolRegistry, ToolContext, ToolResult, ToolOutcome } from './tools';
+export { loadConfig, validateConfig } from './config';
+export type { AgentConfig, ConfigOverrides, PermissionMode } from './config';
+export { encodeMessage, decodeMessage, computeIdempotencyKey, stableStringify } from './protocol';
+export type { ClientMessage, ServerMessage, PlatformMessage, ToolCallMessage, ToolResultMessage, PingMessage, WelcomeMessage, CancelMessage, HelloMessage, ClientState, } from './protocol';
+export { Logger } from './logger';
+export type { LogLevel, LoggerOptions } from './logger';
+import { startAgent } from './agent';
+export default startAgent;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,YAAY,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACzF,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,eAAe,EACf,WAAW,EACX,IAAI,GACL,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClG,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,eAAe,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+"use strict";
+// Public API for ysagc-agent.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.stableStringify = exports.computeIdempotencyKey = exports.decodeMessage = exports.encodeMessage = exports.validateConfig = exports.loadConfig = exports.createToolRegistry = exports.MASK = exports.maskSecrets = exports.isSensitivePath = exports.isDangerCommand = exports.safeResolve = exports.assertInsideRoot = exports.isWithinRoot = exports.canonicalize = exports.runSelfTest = exports.AGENT_VERSION = exports.startAgent = void 0;
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "startAgent", { enumerable: true, get: function () { return agent_1.startAgent; } });
+Object.defineProperty(exports, "AGENT_VERSION", { enumerable: true, get: function () { return agent_1.AGENT_VERSION; } });
+var cli_1 = require("./cli");
+Object.defineProperty(exports, "runSelfTest", { enumerable: true, get: function () { return cli_1.runSelfTest; } });
+var path_utils_1 = require("./path-utils");
+Object.defineProperty(exports, "canonicalize", { enumerable: true, get: function () { return path_utils_1.canonicalize; } });
+Object.defineProperty(exports, "isWithinRoot", { enumerable: true, get: function () { return path_utils_1.isWithinRoot; } });
+Object.defineProperty(exports, "assertInsideRoot", { enumerable: true, get: function () { return path_utils_1.assertInsideRoot; } });
+Object.defineProperty(exports, "safeResolve", { enumerable: true, get: function () { return path_utils_1.safeResolve; } });
+var security_1 = require("./security");
+Object.defineProperty(exports, "isDangerCommand", { enumerable: true, get: function () { return security_1.isDangerCommand; } });
+Object.defineProperty(exports, "isSensitivePath", { enumerable: true, get: function () { return security_1.isSensitivePath; } });
+Object.defineProperty(exports, "maskSecrets", { enumerable: true, get: function () { return security_1.maskSecrets; } });
+Object.defineProperty(exports, "MASK", { enumerable: true, get: function () { return security_1.MASK; } });
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "createToolRegistry", { enumerable: true, get: function () { return tools_1.createToolRegistry; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_1.validateConfig; } });
+var protocol_1 = require("./protocol");
+Object.defineProperty(exports, "encodeMessage", { enumerable: true, get: function () { return protocol_1.encodeMessage; } });
+Object.defineProperty(exports, "decodeMessage", { enumerable: true, get: function () { return protocol_1.decodeMessage; } });
+Object.defineProperty(exports, "computeIdempotencyKey", { enumerable: true, get: function () { return protocol_1.computeIdempotencyKey; } });
+Object.defineProperty(exports, "stableStringify", { enumerable: true, get: function () { return protocol_1.stableStringify; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+const agent_2 = require("./agent");
+exports.default = agent_2.startAgent;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,8BAA8B;;;AAE9B,iCAAoD;AAA3C,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAGlC,6BAAoC;AAA3B,kGAAA,WAAW,OAAA;AAGpB,2CAAyF;AAAhF,0GAAA,YAAY,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,yGAAA,WAAW,OAAA;AAGlE,uCAKoB;AAJlB,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,uGAAA,WAAW,OAAA;AACX,gGAAA,IAAI,OAAA;AAIN,iCAA6C;AAApC,2GAAA,kBAAkB,OAAA;AAG3B,mCAAsD;AAA7C,oGAAA,UAAU,OAAA;AAAE,wGAAA,cAAc,OAAA;AAGnC,uCAAkG;AAAzF,yGAAA,aAAa,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAc7E,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAGf,mCAAqC;AACrC,kBAAe,kBAAU,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Structured logger. It redacts secret-looking values before they ever reach
+ * stdout/stderr. Log depth is controlled by {@link LogLevel}.
+ */
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+export interface LoggerOptions {
+    /** Minimum level that is emitted. */
+    level?: LogLevel;
+    /** Optional namespace prefix, e.g. "agent". */
+    name?: string;
+    /** Write target. Defaults to process.stdout. */
+    stream?: NodeJS.WriteStream;
+    /** Emit ISO timestamps (default true). */
+    timestamps?: boolean;
+}
+/**
+ * A tiny structured logger. Never throws; any internal failure degrades to a
+ * raw console write so a logging bug cannot take down the agent.
+ */
+export declare class Logger {
+    private readonly min;
+    private readonly name;
+    private readonly stream;
+    private readonly timestamps;
+    constructor(opts?: LoggerOptions);
+    /** Create a child logger with an extra namespace segment. */
+    child(name: string): Logger;
+    debug(msg: string, context?: Record<string, unknown>): void;
+    info(msg: string, context?: Record<string, unknown>): void;
+    warn(msg: string, context?: Record<string, unknown>): void;
+    error(msg: string, context?: Record<string, unknown>): void;
+    private write;
+    private sanitize;
+    private maskValue;
+    private format;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAUtE,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AASD;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,IAAI,GAAE,aAAkB;IAOpC,6DAA6D;IAC7D,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAW3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI1D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI1D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,MAAM;CAWf"}

package/dist/logger.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const security_1 = require("./security");
+const LEVEL_RANK = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+/**
+ * A tiny structured logger. Never throws; any internal failure degrades to a
+ * raw console write so a logging bug cannot take down the agent.
+ */
+class Logger {
+    constructor(opts = {}) {
+        this.min = LEVEL_RANK[opts.level ?? 'info'];
+        this.name = opts.name ?? 'ysagc-agent';
+        this.stream = opts.stream ?? process.stdout;
+        this.timestamps = opts.timestamps ?? true;
+    }
+    /** Create a child logger with an extra namespace segment. */
+    child(name) {
+        return new Logger({
+            level: Object.keys(LEVEL_RANK).find((l) => LEVEL_RANK[l] === this.min),
+            name: `${this.name}.${name}`,
+            stream: this.stream,
+            timestamps: this.timestamps,
+        });
+    }
+    debug(msg, context) {
+        this.write('debug', msg, context);
+    }
+    info(msg, context) {
+        this.write('info', msg, context);
+    }
+    warn(msg, context) {
+        this.write('warn', msg, context);
+    }
+    error(msg, context) {
+        this.write('error', msg, context);
+    }
+    write(level, msg, context) {
+        if (LEVEL_RANK[level] > this.min)
+            return;
+        try {
+            const entry = {
+                level,
+                msg: (0, security_1.maskSecrets)(msg),
+                at: this.timestamps ? new Date().toISOString() : '',
+            };
+            const safeCtx = this.sanitize(context);
+            const line = this.format(entry, safeCtx);
+            this.stream.write(line + '\n');
+        }
+        catch {
+            // Never allow logging to break the agent.
+            try {
+                // eslint-disable-next-line no-console
+                console.error(`[${level}] ${msg}`);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    sanitize(context) {
+        if (!context)
+            return undefined;
+        const out = {};
+        for (const [k, v] of Object.entries(context)) {
+            out[k] = this.maskValue(k, v);
+        }
+        return out;
+    }
+    maskValue(key, value) {
+        const k = key.toLowerCase();
+        if (/token|secret|password|passwd|apikey|api[_-]key|authorization|credential|private[_-]key|access[_-]key|session/.test(k)) {
+            return (0, security_1.maskSecrets)(String(value));
+        }
+        if (typeof value === 'string')
+            return (0, security_1.maskSecrets)(value);
+        if (typeof value === 'object' && value !== null) {
+            return this.sanitize(value);
+        }
+        return value;
+    }
+    format(entry, context) {
+        const parts = [];
+        if (entry.at)
+            parts.push(entry.at);
+        parts.push(`[${entry.level.toUpperCase().padEnd(5)}]`);
+        parts.push(`[${this.name}]`);
+        parts.push(entry.msg);
+        if (context && Object.keys(context).length > 0) {
+            parts.push(safeStringify(context));
+        }
+        return parts.join(' ');
+    }
+}
+exports.Logger = Logger;
+function safeStringify(value) {
+    try {
+        const seen = new WeakSet();
+        return JSON.stringify(value, (_key, v) => {
+            if (typeof v === 'object' && v !== null) {
+                if (seen.has(v))
+                    return '[Circular]';
+                seen.add(v);
+            }
+            if (typeof v === 'bigint')
+                return v.toString();
+            return v;
+        });
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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