@opengoat/core 2026.2.9 → 2026.2.14

package/dist/core/agents/application/workspace-context.service.js

@@ -1,157 +0,0 @@
-import { DEFAULT_BOOTSTRAP_MAX_CHARS, DEFAULT_WORKSPACE_BOOTSTRAP_FILES } from "../domain/workspace-context.js";
-const BOOTSTRAP_HEAD_RATIO = 0.7;
-const BOOTSTRAP_TAIL_RATIO = 0.2;
-export class WorkspaceContextService {
-    fileSystem;
-    pathPort;
-    constructor(deps) {
-        this.fileSystem = deps.fileSystem;
-        this.pathPort = deps.pathPort;
-    }
-    getDefaultBootstrapFileNames() {
-        return [...DEFAULT_WORKSPACE_BOOTSTRAP_FILES];
-    }
-    resolveBootstrapFileNames(fileNames) {
-        if (!fileNames || fileNames.length === 0) {
-            return this.getDefaultBootstrapFileNames();
-        }
-        const deduped = new Set();
-        for (const name of fileNames) {
-            const trimmed = name.trim();
-            if (!trimmed) {
-                continue;
-            }
-            deduped.add(trimmed);
-        }
-        if (deduped.size === 0) {
-            return this.getDefaultBootstrapFileNames();
-        }
-        return [...deduped];
-    }
-    async loadWorkspaceBootstrapFiles(workspaceDir, fileNames) {
-        const files = this.resolveBootstrapFileNames(fileNames);
-        const result = [];
-        for (const name of files) {
-            const filePath = this.pathPort.join(workspaceDir, name);
-            try {
-                const content = await this.fileSystem.readFile(filePath);
-                result.push({
-                    name,
-                    path: filePath,
-                    content,
-                    missing: false
-                });
-            }
-            catch {
-                result.push({
-                    name,
-                    path: filePath,
-                    missing: true
-                });
-            }
-        }
-        return result;
-    }
-    buildContextFiles(files, options = {}) {
-        const maxChars = resolveBootstrapMaxChars(options.maxChars);
-        const result = [];
-        for (const file of files) {
-            if (file.missing) {
-                result.push({
-                    path: file.name,
-                    content: `[MISSING] Expected at: ${file.path}`
-                });
-                continue;
-            }
-            const trimmed = trimBootstrapContent(file.content ?? "", file.name, maxChars);
-            if (!trimmed.content) {
-                continue;
-            }
-            if (trimmed.truncated) {
-                options.warn?.(`workspace bootstrap file ${file.name} is ${trimmed.originalLength} chars (limit ${trimmed.maxChars}); truncating in injected context`);
-            }
-            result.push({
-                path: file.name,
-                content: trimmed.content
-            });
-        }
-        return result;
-    }
-    buildSystemPrompt(params) {
-        const lines = [
-            "# OpenGoat System Prompt",
-            `You are ${params.displayName} (${params.agentId}), an autonomous agent managed by OpenGoat.`,
-            "",
-            "## Workspace",
-            `Path: ${params.workspaceDir}`,
-            "The workspace is your default working directory.",
-            "Use Markdown and JSON files for durable context and operational state.",
-            "",
-            "## Workspace Files (injected)",
-            "These workspace files are loaded by OpenGoat and included below in Project Context.",
-            ""
-        ];
-        if (params.contextFiles.length > 0) {
-            const hasSoulFile = params.contextFiles.some((file) => {
-                return normalizePathBasename(file.path).toLowerCase() === "soul.md";
-            });
-            lines.push("# Project Context", "", "The following project context files have been loaded:");
-            if (hasSoulFile) {
-                lines.push("If SOUL.md is present, embody its persona and tone unless higher-priority instructions override it.");
-            }
-            lines.push("");
-            for (const file of params.contextFiles) {
-                lines.push(`## ${file.path}`, "", file.content, "");
-            }
-        }
-        lines.push("## Current Date & Time", params.nowIso);
-        return lines.filter(Boolean).join("\n");
-    }
-}
-function resolveBootstrapMaxChars(maxChars) {
-    if (typeof maxChars === "number" && Number.isFinite(maxChars) && maxChars > 0) {
-        return Math.floor(maxChars);
-    }
-    return DEFAULT_BOOTSTRAP_MAX_CHARS;
-}
-function trimBootstrapContent(content, fileName, maxChars) {
-    const trimmed = content.trimEnd();
-    if (trimmed.length === 0) {
-        return {
-            content: "",
-            truncated: false,
-            maxChars,
-            originalLength: 0
-        };
-    }
-    if (trimmed.length <= maxChars) {
-        return {
-            content: trimmed,
-            truncated: false,
-            maxChars,
-            originalLength: trimmed.length
-        };
-    }
-    const headChars = Math.floor(maxChars * BOOTSTRAP_HEAD_RATIO);
-    const tailChars = Math.floor(maxChars * BOOTSTRAP_TAIL_RATIO);
-    const head = trimmed.slice(0, headChars);
-    const tail = trimmed.slice(-tailChars);
-    const marker = [
-        "",
-        `[...truncated, read ${fileName} for full content...]`,
-        `...(truncated ${fileName}: kept ${headChars}+${tailChars} chars of ${trimmed.length})...`,
-        ""
-    ].join("\n");
-    return {
-        content: [head, marker, tail].join("\n"),
-        truncated: true,
-        maxChars,
-        originalLength: trimmed.length
-    };
-}
-function normalizePathBasename(pathValue) {
-    const normalized = pathValue.replace(/\\/g, "/");
-    const parts = normalized.split("/");
-    return parts[parts.length - 1] ?? normalized;
-}
-//# sourceMappingURL=workspace-context.service.js.map

package/dist/core/agents/application/workspace-context.service.js.map

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

package/dist/core/agents/domain/workspace-context.d.ts

@@ -1,13 +0,0 @@
-export declare const DEFAULT_BOOTSTRAP_MAX_CHARS = 20000;
-export declare const DEFAULT_WORKSPACE_BOOTSTRAP_FILES: readonly ["AGENTS.md", "SOUL.md", "TOOLS.md", "IDENTITY.md", "USER.md", "HEARTBEAT.md", "CONTEXT.md", "BOOTSTRAP.md", "MEMORY.md", "memory.md"];
-export type WorkspaceBootstrapFileName = (typeof DEFAULT_WORKSPACE_BOOTSTRAP_FILES)[number];
-export interface WorkspaceBootstrapFile {
-    name: string;
-    path: string;
-    content?: string;
-    missing: boolean;
-}
-export interface WorkspaceContextFile {
-    path: string;
-    content: string;
-}

package/dist/core/agents/domain/workspace-context.js

@@ -1,14 +0,0 @@
-export const DEFAULT_BOOTSTRAP_MAX_CHARS = 20_000;
-export const DEFAULT_WORKSPACE_BOOTSTRAP_FILES = [
-    "AGENTS.md",
-    "SOUL.md",
-    "TOOLS.md",
-    "IDENTITY.md",
-    "USER.md",
-    "HEARTBEAT.md",
-    "CONTEXT.md",
-    "BOOTSTRAP.md",
-    "MEMORY.md",
-    "memory.md"
-];
-//# sourceMappingURL=workspace-context.js.map

package/dist/core/agents/domain/workspace-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-context.js","sourceRoot":"","sources":["../../../../src/core/agents/domain/workspace-context.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAElD,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,WAAW;IACX,SAAS;IACT,UAAU;IACV,aAAa;IACb,SAAS;IACT,cAAc;IACd,YAAY;IACZ,cAAc;IACd,WAAW;IACX,WAAW;CACH,CAAC"}

package/dist/core/gateway/domain/protocol.d.ts

@@ -1,113 +0,0 @@
-export declare const OPENGOAT_GATEWAY_PROTOCOL_VERSION: 1;
-export declare const OPENGOAT_GATEWAY_DEFAULTS: {
-    readonly path: "/gateway";
-    readonly handshakeTimeoutMs: 10000;
-    readonly maxPayloadBytes: number;
-    readonly maxBufferedBytes: number;
-    readonly tickIntervalMs: 30000;
-    readonly idempotencyTtlMs: number;
-    readonly idempotencyMaxEntries: 1000;
-    readonly rateLimitPerMinute: 180;
-};
-export declare const OPENGOAT_GATEWAY_SCOPES: {
-    readonly read: "operator.read";
-    readonly write: "operator.write";
-    readonly admin: "operator.admin";
-};
-export type OpenGoatGatewayScope = (typeof OPENGOAT_GATEWAY_SCOPES)["read"] | (typeof OPENGOAT_GATEWAY_SCOPES)["write"] | (typeof OPENGOAT_GATEWAY_SCOPES)["admin"];
-export declare const OPENGOAT_GATEWAY_METHODS: readonly ["health", "agent.list", "agent.run", "session.list", "session.history"];
-export type OpenGoatGatewayMethod = (typeof OPENGOAT_GATEWAY_METHODS)[number];
-export declare const OPENGOAT_GATEWAY_EVENTS: readonly ["connect.challenge", "tick", "agent.stream"];
-export type OpenGoatGatewayEvent = (typeof OPENGOAT_GATEWAY_EVENTS)[number];
-export declare const OPENGOAT_GATEWAY_ERROR_CODES: {
-    readonly invalidRequest: "INVALID_REQUEST";
-    readonly protocolMismatch: "PROTOCOL_MISMATCH";
-    readonly unauthorized: "UNAUTHORIZED";
-    readonly forbidden: "FORBIDDEN";
-    readonly rateLimited: "RATE_LIMITED";
-    readonly unavailable: "UNAVAILABLE";
-};
-export interface OpenGoatGatewayErrorShape {
-    code: string;
-    message: string;
-    details?: unknown;
-    retryable?: boolean;
-    retryAfterMs?: number;
-}
-export interface OpenGoatGatewayRequestFrame {
-    type: "req";
-    id: string;
-    method: string;
-    params?: unknown;
-}
-export interface OpenGoatGatewayResponseFrame {
-    type: "res";
-    id: string;
-    ok: boolean;
-    payload?: unknown;
-    error?: OpenGoatGatewayErrorShape;
-}
-export interface OpenGoatGatewayEventFrame {
-    type: "event";
-    event: string;
-    payload?: unknown;
-    seq?: number;
-}
-export interface OpenGoatGatewayClientInfo {
-    id: string;
-    displayName?: string;
-    version: string;
-    platform: string;
-    mode: string;
-    instanceId?: string;
-}
-export interface OpenGoatGatewayConnectParams {
-    minProtocol: number;
-    maxProtocol: number;
-    client: OpenGoatGatewayClientInfo;
-    role?: "operator";
-    scopes?: OpenGoatGatewayScope[];
-    auth?: {
-        token?: string;
-    };
-    nonce?: string;
-    locale?: string;
-    userAgent?: string;
-}
-export interface OpenGoatGatewayAgentRunParams {
-    idempotencyKey: string;
-    message: string;
-    agentId?: string;
-    sessionRef?: string;
-    forceNewSession?: boolean;
-    disableSession?: boolean;
-    cwd?: string;
-    model?: string;
-}
-export interface OpenGoatGatewaySessionListParams {
-    agentId?: string;
-    activeMinutes?: number;
-}
-export interface OpenGoatGatewaySessionHistoryParams {
-    agentId?: string;
-    sessionRef?: string;
-    limit?: number;
-    includeCompaction?: boolean;
-}
-interface ParseSuccess<T> {
-    ok: true;
-    value: T;
-}
-interface ParseFailure {
-    ok: false;
-    error: string;
-}
-export type ParseResult<T> = ParseSuccess<T> | ParseFailure;
-export declare function isOpenGoatGatewayMethod(value: string): value is OpenGoatGatewayMethod;
-export declare function isReadMethod(method: OpenGoatGatewayMethod): boolean;
-export declare function parseGatewayRequestFrame(input: unknown): ParseResult<OpenGoatGatewayRequestFrame>;
-export declare function parseConnectParams(input: unknown): ParseResult<OpenGoatGatewayConnectParams>;
-export declare function parseAgentRunParams(input: unknown): ParseResult<OpenGoatGatewayAgentRunParams>;
-export declare function parseSessionListParams(input: unknown): ParseResult<OpenGoatGatewaySessionListParams>;
-export declare function parseSessionHistoryParams(input: unknown): ParseResult<OpenGoatGatewaySessionHistoryParams>;
-export {};