@opengoat/core 2026.2.9

package/dist/platform/node/node-logger.js

@@ -0,0 +1,124 @@
+import { StructuredLogger, createNoopLogger, normalizeLogLevel } from "../../core/logging/index.js";
+export function createNodeLogger(config = {}) {
+    const level = config.level ?? normalizeLogLevel(process.env.OPENGOAT_LOG_LEVEL, "warn");
+    if (level === "silent") {
+        return createNoopLogger();
+    }
+    const format = resolveLogFormat(config.format);
+    const stream = config.stream ?? process.stderr;
+    return new StructuredLogger({
+        level,
+        sink: (record) => {
+            stream.write(renderRecord(record, format));
+        }
+    });
+}
+function resolveLogFormat(explicit) {
+    if (explicit === "pretty" || explicit === "json") {
+        return explicit;
+    }
+    const env = process.env.OPENGOAT_LOG_FORMAT?.trim().toLowerCase();
+    if (env === "pretty" || env === "json") {
+        return env;
+    }
+    return "pretty";
+}
+function renderRecord(record, format) {
+    if (format === "json") {
+        return `${JSON.stringify(record)}\n`;
+    }
+    const scope = typeof record.context?.scope === "string" && record.context.scope.trim().length > 0
+        ? ` ${record.context.scope}`
+        : "";
+    const level = record.level.toUpperCase().padEnd(5, " ");
+    const details = formatContext(record.context);
+    return `[${record.timestamp}] ${level}${scope} ${record.message}${details}\n`;
+}
+function formatContext(context) {
+    if (!context) {
+        return "";
+    }
+    const next = { ...context };
+    delete next.scope;
+    if (Object.keys(next).length === 0) {
+        return "";
+    }
+    if (canRenderInline(next)) {
+        const inline = Object.entries(next)
+            .map(([key, value]) => `${key}=${renderInlineScalar(value)}`)
+            .join(" ");
+        return ` ${inline}`;
+    }
+    const lines = Object.entries(next).map(([key, value]) => renderContextField(key, value, 2));
+    return `\n${lines.join("\n")}`;
+}
+function canRenderInline(context) {
+    return Object.values(context).every(isInlineScalar);
+}
+function isInlineScalar(value) {
+    if (value === null || value === undefined) {
+        return true;
+    }
+    if (typeof value === "string") {
+        return value.length <= 80 && !value.includes("\n");
+    }
+    return typeof value === "number" || typeof value === "boolean" || typeof value === "bigint";
+}
+function renderInlineScalar(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (typeof value === "string") {
+        return value.includes(" ") ? `"${value}"` : value;
+    }
+    if (typeof value === "bigint") {
+        return `${value.toString()}n`;
+    }
+    return String(value);
+}
+function renderContextField(key, value, indent) {
+    const prefix = `${" ".repeat(indent)}${key}:`;
+    if (value === undefined) {
+        return `${prefix} undefined`;
+    }
+    if (value === null) {
+        return `${prefix} null`;
+    }
+    if (typeof value === "string") {
+        return renderStringField(prefix, value, indent);
+    }
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+        return `${prefix} ${renderInlineScalar(value)}`;
+    }
+    const serialized = safeStringify(value);
+    if (!serialized.includes("\n")) {
+        return `${prefix} ${serialized}`;
+    }
+    const indented = serialized
+        .split("\n")
+        .map((line) => `${" ".repeat(indent + 2)}${line}`)
+        .join("\n");
+    return `${prefix}\n${indented}`;
+}
+function renderStringField(prefix, value, indent) {
+    if (!value.includes("\n")) {
+        return `${prefix} ${value === "" ? '""' : value}`;
+    }
+    const body = value
+        .split("\n")
+        .map((line) => `${" ".repeat(indent + 2)}${line}`)
+        .join("\n");
+    return `${prefix} |\n${body}`;
+}
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value, null, 2) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=node-logger.js.map

package/dist/platform/node/node-logger.js.map

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

package/dist/platform/node/node-path.port.d.ts

@@ -0,0 +1,9 @@
+import type { OpenGoatPaths } from "../../core/domain/opengoat-paths.js";
+import type { PathPort } from "../../core/ports/path.port.js";
+import type { OpenGoatPathsProvider } from "../../core/ports/paths-provider.port.js";
+export declare class NodePathPort implements PathPort {
+    join(...segments: string[]): string;
+}
+export declare class NodeOpenGoatPathsProvider implements OpenGoatPathsProvider {
+    getPaths(): OpenGoatPaths;
+}

package/dist/platform/node/node-path.port.js

@@ -0,0 +1,41 @@
+import os from "node:os";
+import path from "node:path";
+export class NodePathPort {
+    join(...segments) {
+        return path.join(...segments);
+    }
+}
+export class NodeOpenGoatPathsProvider {
+    getPaths() {
+        const homeDir = resolveOpenGoatHomeDir();
+        return {
+            homeDir,
+            workspacesDir: path.join(homeDir, "workspaces"),
+            agentsDir: path.join(homeDir, "agents"),
+            skillsDir: path.join(homeDir, "skills"),
+            providersDir: path.join(homeDir, "providers"),
+            sessionsDir: path.join(homeDir, "sessions"),
+            runsDir: path.join(homeDir, "runs"),
+            globalConfigJsonPath: path.join(homeDir, "config.json"),
+            globalConfigMarkdownPath: path.join(homeDir, "CONFIG.md"),
+            agentsIndexJsonPath: path.join(homeDir, "agents.json")
+        };
+    }
+}
+function resolveOpenGoatHomeDir() {
+    const override = process.env.OPENGOAT_HOME?.trim();
+    if (override) {
+        return path.resolve(expandTilde(override));
+    }
+    return path.join(os.homedir(), ".opengoat");
+}
+function expandTilde(value) {
+    if (!value.startsWith("~")) {
+        return value;
+    }
+    if (value === "~") {
+        return os.homedir();
+    }
+    return path.join(os.homedir(), value.slice(2));
+}
+//# sourceMappingURL=node-path.port.js.map

package/dist/platform/node/node-path.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-path.port.js","sourceRoot":"","sources":["../../../src/platform/node/node-path.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,MAAM,OAAO,YAAY;IAChB,IAAI,CAAC,GAAG,QAAkB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,yBAAyB;IAC7B,QAAQ;QACb,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACzC,OAAO;YACL,OAAO;YACP,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;YAC/C,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;YACvC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;YACvC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;YAC7C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;YAC3C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;YACnC,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;YACvD,wBAAwB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;YACzD,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;SACvD,CAAC;IACJ,CAAC;CACF;AAED,SAAS,sBAAsB;IAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/platform/node/opengoat-gateway-client.d.ts

@@ -0,0 +1,19 @@
+export interface OpenGoatGatewayCallOptions {
+    url: string;
+    method: string;
+    params?: unknown;
+    token?: string;
+    timeoutMs?: number;
+    abortSignal?: AbortSignal;
+    clientId?: string;
+    clientDisplayName?: string;
+    clientVersion?: string;
+    platform?: string;
+    mode?: string;
+    instanceId?: string;
+}
+export interface OpenGoatGatewayConnectResult<T = unknown> {
+    hello: unknown;
+    payload: T;
+}
+export declare function callOpenGoatGateway<T = unknown>(options: OpenGoatGatewayCallOptions): Promise<OpenGoatGatewayConnectResult<T>>;

package/dist/platform/node/opengoat-gateway-client.js

@@ -0,0 +1,194 @@
+import { randomUUID } from "node:crypto";
+import { WebSocket } from "ws";
+import { OPENGOAT_GATEWAY_DEFAULTS, OPENGOAT_GATEWAY_PROTOCOL_VERSION } from "../../core/gateway/index.js";
+export async function callOpenGoatGateway(options) {
+    const timeoutMs = resolveTimeout(options.timeoutMs);
+    return await new Promise((resolve, reject) => {
+        if (options.abortSignal?.aborted) {
+            reject(createAbortError());
+            return;
+        }
+        const socket = new WebSocket(options.url, {
+            maxPayload: OPENGOAT_GATEWAY_DEFAULTS.maxPayloadBytes
+        });
+        const connectRequestId = randomUUID();
+        const callRequestId = randomUUID();
+        let settled = false;
+        let handshakeSent = false;
+        let helloPayload;
+        const timeout = setTimeout(() => {
+            finish(new Error(`Gateway timeout after ${timeoutMs}ms.`));
+        }, timeoutMs);
+        function onAbort() {
+            finish(createAbortError());
+        }
+        const cleanup = () => {
+            clearTimeout(timeout);
+            socket.removeAllListeners();
+            options.abortSignal?.removeEventListener("abort", onAbort);
+        };
+        const finish = (error, result) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            try {
+                socket.close();
+            }
+            catch {
+                // ignore close failure
+            }
+            if (error) {
+                reject(error);
+                return;
+            }
+            if (!result) {
+                reject(new Error("Gateway call completed without a result."));
+                return;
+            }
+            resolve(result);
+        };
+        options.abortSignal?.addEventListener("abort", onAbort, { once: true });
+        socket.on("error", (error) => {
+            finish(error instanceof Error ? error : new Error(String(error)));
+        });
+        socket.on("close", (code, reasonRaw) => {
+            if (settled) {
+                return;
+            }
+            const reason = toUtf8String(reasonRaw) ?? "no close reason";
+            finish(new Error(`Gateway closed (${code}): ${reason}`));
+        });
+        socket.on("message", (raw) => {
+            const text = toUtf8String(raw);
+            if (!text) {
+                finish(new Error("Received invalid gateway frame payload."));
+                return;
+            }
+            let frame;
+            try {
+                frame = JSON.parse(text);
+            }
+            catch {
+                finish(new Error("Received invalid JSON from gateway."));
+                return;
+            }
+            if (!isRecord(frame)) {
+                return;
+            }
+            if (frame.type === "event" && frame.event === "connect.challenge") {
+                if (handshakeSent) {
+                    return;
+                }
+                handshakeSent = true;
+                const nonce = extractNonce(frame.payload);
+                const connectPayload = {
+                    minProtocol: OPENGOAT_GATEWAY_PROTOCOL_VERSION,
+                    maxProtocol: OPENGOAT_GATEWAY_PROTOCOL_VERSION,
+                    client: {
+                        id: options.clientId ?? "opengoat-cli",
+                        displayName: options.clientDisplayName,
+                        version: options.clientVersion ?? "dev",
+                        platform: options.platform ?? process.platform,
+                        mode: options.mode ?? "operator",
+                        instanceId: options.instanceId
+                    },
+                    auth: options.token
+                        ? {
+                            token: options.token
+                        }
+                        : undefined,
+                    nonce
+                };
+                sendFrame(socket, {
+                    type: "req",
+                    id: connectRequestId,
+                    method: "connect",
+                    params: connectPayload
+                });
+                return;
+            }
+            if (frame.type !== "res" || typeof frame.id !== "string") {
+                return;
+            }
+            const ok = frame.ok === true;
+            if (frame.id === connectRequestId) {
+                if (!ok) {
+                    finish(new Error(formatGatewayError(frame.error, "Gateway connect failed.")));
+                    return;
+                }
+                helloPayload = frame.payload;
+                sendFrame(socket, {
+                    type: "req",
+                    id: callRequestId,
+                    method: options.method,
+                    params: options.params
+                });
+                return;
+            }
+            if (frame.id === callRequestId) {
+                if (!ok) {
+                    finish(new Error(formatGatewayError(frame.error, `Gateway method ${options.method} failed.`)));
+                    return;
+                }
+                finish(undefined, {
+                    hello: helloPayload,
+                    payload: frame.payload
+                });
+            }
+        });
+    });
+}
+function createAbortError() {
+    const error = new Error("Gateway request aborted.");
+    error.name = "AbortError";
+    return error;
+}
+function sendFrame(socket, frame) {
+    socket.send(JSON.stringify(frame));
+}
+function formatGatewayError(error, fallback) {
+    if (!isRecord(error)) {
+        return fallback;
+    }
+    const message = typeof error.message === "string" && error.message.trim() ? error.message.trim() : fallback;
+    const code = typeof error.code === "string" && error.code.trim() ? error.code.trim() : undefined;
+    return code ? `${code}: ${message}` : message;
+}
+function extractNonce(payload) {
+    if (!isRecord(payload)) {
+        return undefined;
+    }
+    const nonce = payload.nonce;
+    if (typeof nonce !== "string") {
+        return undefined;
+    }
+    const trimmed = nonce.trim();
+    return trimmed || undefined;
+}
+function resolveTimeout(timeoutMs) {
+    if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        return 10_000;
+    }
+    return Math.floor(timeoutMs);
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function toUtf8String(raw) {
+    if (typeof raw === "string") {
+        return raw;
+    }
+    if (Buffer.isBuffer(raw)) {
+        return raw.toString("utf-8");
+    }
+    if (Array.isArray(raw)) {
+        return Buffer.concat(raw).toString("utf-8");
+    }
+    if (raw instanceof ArrayBuffer) {
+        return Buffer.from(raw).toString("utf-8");
+    }
+    return null;
+}
+//# sourceMappingURL=opengoat-gateway-client.js.map

package/dist/platform/node/opengoat-gateway-client.js.map

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

package/dist/platform/node/opengoat-gateway-server.d.ts

@@ -0,0 +1,53 @@
+export interface OpenGoatGatewayService {
+    getHomeDir(): string;
+    listAgents(): Promise<unknown>;
+    listSessions(agentId?: string, options?: {
+        activeMinutes?: number;
+    }): Promise<unknown>;
+    getSessionHistory(agentId?: string, options?: {
+        sessionRef?: string;
+        limit?: number;
+        includeCompaction?: boolean;
+    }): Promise<unknown>;
+    runAgent(agentId: string, options: {
+        message: string;
+        sessionRef?: string;
+        forceNewSession?: boolean;
+        disableSession?: boolean;
+        cwd?: string;
+        model?: string;
+        onStdout?: (chunk: string) => void;
+        onStderr?: (chunk: string) => void;
+    }): Promise<unknown>;
+}
+export interface OpenGoatGatewayServerOptions {
+    port?: number;
+    bindHost?: string;
+    path?: string;
+    authToken?: string;
+    requireAuth?: boolean;
+    allowedOrigins?: string[];
+    handshakeTimeoutMs?: number;
+    maxPayloadBytes?: number;
+    maxBufferedBytes?: number;
+    tickIntervalMs?: number;
+    rateLimitPerMinute?: number;
+    idempotencyTtlMs?: number;
+    idempotencyMaxEntries?: number;
+    logger?: {
+        info(message: string, context?: Record<string, unknown>): void;
+        warn(message: string, context?: Record<string, unknown>): void;
+        error(message: string, context?: Record<string, unknown>): void;
+        debug(message: string, context?: Record<string, unknown>): void;
+    };
+}
+export interface OpenGoatGatewayServerHandle {
+    readonly url: string;
+    readonly port: number;
+    readonly bindHost: string;
+    readonly path: string;
+    readonly authToken?: string;
+    readonly closed: Promise<void>;
+    close(): Promise<void>;
+}
+export declare function startOpenGoatGatewayServer(service: OpenGoatGatewayService, options?: OpenGoatGatewayServerOptions): Promise<OpenGoatGatewayServerHandle>;