@opengoat/core 2026.2.9

package/dist/core/acp/domain/meta.js

@@ -0,0 +1,31 @@
+export function parseAcpSessionMeta(meta) {
+    if (!meta || typeof meta !== "object") {
+        return {};
+    }
+    const record = meta;
+    return {
+        agentId: readString(record, ["agentId", "agent", "targetAgent"]),
+        sessionKey: readString(record, ["sessionKey", "sessionRef", "session"]),
+        forceNewSession: readBool(record, ["forceNewSession", "newSession"]),
+        disableSession: readBool(record, ["disableSession", "noSession"])
+    };
+}
+function readString(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "string" && value.trim()) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+function readBool(record, keys) {
+    for (const key of keys) {
+        const value = record[key];
+        if (typeof value === "boolean") {
+            return value;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=meta.js.map

package/dist/core/acp/domain/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../../../src/core/acp/domain/meta.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAA+B,CAAC;IAC/C,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;QAChE,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACvE,eAAe,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACpE,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B,EAAE,IAAc;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,MAA+B,EAAE,IAAc;IAC/D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/acp/domain/session.d.ts

@@ -0,0 +1,23 @@
+export interface AcpSessionState {
+    sessionId: string;
+    agentId: string;
+    sessionRef: string;
+    cwd: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface AcpPromptRunState {
+    runId: string;
+    sessionId: string;
+    cancelled: boolean;
+}
+export interface AcpSessionStore {
+    put(session: AcpSessionState): void;
+    get(sessionId: string): AcpSessionState | undefined;
+    update(sessionId: string, update: Partial<AcpSessionState>): AcpSessionState | undefined;
+    list(): AcpSessionState[];
+    setActiveRun(sessionId: string, run: AcpPromptRunState): void;
+    getActiveRun(sessionId: string): AcpPromptRunState | undefined;
+    clearActiveRun(sessionId: string): void;
+    clear(): void;
+}

package/dist/core/acp/domain/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/core/acp/domain/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/core/acp/domain/session.ts"],"names":[],"mappings":""}

package/dist/core/acp/index.d.ts

@@ -0,0 +1,5 @@
+export { OpenGoatAcpAgent } from "./application/acp-agent.js";
+export { InMemoryAcpSessionStore } from "./application/session-store.js";
+export { parseAcpSessionMeta } from "./domain/meta.js";
+export type { AcpSessionMeta } from "./domain/meta.js";
+export type { AcpPromptRunState, AcpSessionState, AcpSessionStore } from "./domain/session.js";

package/dist/core/acp/index.js

@@ -0,0 +1,4 @@
+export { OpenGoatAcpAgent } from "./application/acp-agent.js";
+export { InMemoryAcpSessionStore } from "./application/session-store.js";
+export { parseAcpSessionMeta } from "./domain/meta.js";
+//# sourceMappingURL=index.js.map

package/dist/core/acp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/acp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/agents/application/agent-manifest.service.d.ts

@@ -0,0 +1,20 @@
+import type { OpenGoatPaths } from "../../domain/opengoat-paths.js";
+import type { FileSystemPort } from "../../ports/file-system.port.js";
+import type { PathPort } from "../../ports/path.port.js";
+import { type AgentManifest } from "../domain/agent-manifest.js";
+interface AgentManifestServiceDeps {
+    fileSystem: FileSystemPort;
+    pathPort: PathPort;
+}
+export declare class AgentManifestService {
+    private readonly fileSystem;
+    private readonly pathPort;
+    constructor(deps: AgentManifestServiceDeps);
+    listManifests(paths: OpenGoatPaths): Promise<AgentManifest[]>;
+    getManifest(paths: OpenGoatPaths, agentId: string): Promise<AgentManifest>;
+    syncManifestProvider(paths: OpenGoatPaths, agentId: string, providerId: string): Promise<void>;
+    private readAgentProviderId;
+    private readAgentDisplayName;
+    private readJsonIfPresent;
+}
+export {};

package/dist/core/agents/application/agent-manifest.service.js

@@ -0,0 +1,89 @@
+import { DEFAULT_PROVIDER_ID } from "../../providers/index.js";
+import { formatAgentManifestMarkdown, normalizeAgentManifestMetadata, parseAgentManifestMarkdown } from "../domain/agent-manifest.js";
+export class AgentManifestService {
+    fileSystem;
+    pathPort;
+    constructor(deps) {
+        this.fileSystem = deps.fileSystem;
+        this.pathPort = deps.pathPort;
+    }
+    async listManifests(paths) {
+        const agentIds = await this.fileSystem.listDirectories(paths.workspacesDir);
+        const manifests = await Promise.all(agentIds.map((agentId) => this.getManifest(paths, agentId)));
+        return manifests.sort((left, right) => left.agentId.localeCompare(right.agentId));
+    }
+    async getManifest(paths, agentId) {
+        const workspaceDir = this.pathPort.join(paths.workspacesDir, agentId);
+        const manifestPath = this.pathPort.join(workspaceDir, "AGENTS.md");
+        const providerId = await this.readAgentProviderId(paths, agentId);
+        const displayName = await this.readAgentDisplayName(workspaceDir, agentId);
+        const exists = await this.fileSystem.exists(manifestPath);
+        if (!exists) {
+            const metadata = normalizeAgentManifestMetadata({
+                agentId,
+                displayName,
+                providerId
+            });
+            return {
+                agentId,
+                filePath: manifestPath,
+                workspaceDir,
+                metadata,
+                body: "",
+                source: "derived"
+            };
+        }
+        const markdown = await this.fileSystem.readFile(manifestPath);
+        const parsed = parseAgentManifestMarkdown(markdown);
+        const metadata = normalizeAgentManifestMetadata({
+            agentId,
+            displayName,
+            providerId,
+            metadata: parsed.data
+        });
+        return {
+            agentId,
+            filePath: manifestPath,
+            workspaceDir,
+            metadata,
+            body: parsed.body,
+            source: parsed.hasFrontMatter ? "frontmatter" : "derived"
+        };
+    }
+    async syncManifestProvider(paths, agentId, providerId) {
+        const manifest = await this.getManifest(paths, agentId);
+        const metadata = {
+            ...manifest.metadata,
+            provider: providerId.trim().toLowerCase() || DEFAULT_PROVIDER_ID
+        };
+        const body = manifest.body.trim()
+            ? manifest.body
+            : `# ${metadata.name} (OpenGoat Agent)\n\n## Role\nYou are an autonomous agent managed by OpenGoat.\n`;
+        const markdown = formatAgentManifestMarkdown(metadata, body);
+        await this.fileSystem.writeFile(manifest.filePath, markdown);
+    }
+    async readAgentProviderId(paths, agentId) {
+        const configPath = this.pathPort.join(paths.agentsDir, agentId, "config.json");
+        const config = await this.readJsonIfPresent(configPath);
+        return config?.provider?.id?.trim().toLowerCase() || DEFAULT_PROVIDER_ID;
+    }
+    async readAgentDisplayName(workspaceDir, agentId) {
+        const workspaceMetadataPath = this.pathPort.join(workspaceDir, "workspace.json");
+        const workspaceMetadata = await this.readJsonIfPresent(workspaceMetadataPath);
+        return workspaceMetadata?.displayName?.trim() || agentId;
+    }
+    async readJsonIfPresent(filePath) {
+        const exists = await this.fileSystem.exists(filePath);
+        if (!exists) {
+            return null;
+        }
+        try {
+            const raw = await this.fileSystem.readFile(filePath);
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=agent-manifest.service.js.map

package/dist/core/agents/application/agent-manifest.service.js.map

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

package/dist/core/agents/application/agent.service.d.ts

@@ -0,0 +1,25 @@
+import type { AgentDeletionResult, AgentCreationResult, AgentDescriptor, AgentIdentity } from "../../domain/agent.js";
+import type { OpenGoatPaths } from "../../domain/opengoat-paths.js";
+import type { FileSystemPort } from "../../ports/file-system.port.js";
+import type { PathPort } from "../../ports/path.port.js";
+interface AgentServiceDeps {
+    fileSystem: FileSystemPort;
+    pathPort: PathPort;
+    nowIso: () => string;
+}
+export declare class AgentService {
+    private readonly fileSystem;
+    private readonly pathPort;
+    private readonly nowIso;
+    constructor(deps: AgentServiceDeps);
+    normalizeAgentName(rawName: string): AgentIdentity;
+    ensureAgent(paths: OpenGoatPaths, identity: AgentIdentity): Promise<AgentCreationResult>;
+    listAgents(paths: OpenGoatPaths): Promise<AgentDescriptor[]>;
+    removeAgent(paths: OpenGoatPaths, rawAgentId: string): Promise<AgentDeletionResult>;
+    private isBrandNewWorkspace;
+    private ensureDirectory;
+    private writeJsonIfMissing;
+    private writeMarkdownIfMissing;
+    private readJsonIfPresent;
+}
+export {};

package/dist/core/agents/application/agent.service.js

@@ -0,0 +1,191 @@
+import { isDefaultAgentId, normalizeAgentId } from "../../domain/agent-id.js";
+import { renderAgentsIndex, renderInternalAgentConfig, renderInternalAgentMemoryMarkdown, renderInternalAgentState, renderWorkspaceAgentsMarkdown, renderWorkspaceBootstrapMarkdown, renderWorkspaceContextMarkdown, renderWorkspaceHeartbeatMarkdown, renderWorkspaceIdentityMarkdown, renderDefaultOrchestratorSkillMarkdown, renderWorkspaceSoulMarkdown, renderWorkspaceToolsMarkdown, renderWorkspaceUserMarkdown, renderWorkspaceMetadata } from "../../templates/default-templates.js";
+export class AgentService {
+    fileSystem;
+    pathPort;
+    nowIso;
+    constructor(deps) {
+        this.fileSystem = deps.fileSystem;
+        this.pathPort = deps.pathPort;
+        this.nowIso = deps.nowIso;
+    }
+    normalizeAgentName(rawName) {
+        const displayName = rawName.trim();
+        if (!displayName) {
+            throw new Error("Agent name cannot be empty.");
+        }
+        const id = normalizeAgentId(displayName);
+        if (!id) {
+            throw new Error("Agent name must contain at least one alphanumeric character.");
+        }
+        return { id, displayName };
+    }
+    async ensureAgent(paths, identity) {
+        const workspaceDir = this.pathPort.join(paths.workspacesDir, identity.id);
+        const workspaceSkillsDir = this.pathPort.join(workspaceDir, "skills");
+        const internalConfigDir = this.pathPort.join(paths.agentsDir, identity.id);
+        const sessionsDir = this.pathPort.join(internalConfigDir, "sessions");
+        const createdPaths = [];
+        const skippedPaths = [];
+        await this.ensureDirectory(workspaceDir, createdPaths, skippedPaths);
+        await this.ensureDirectory(workspaceSkillsDir, createdPaths, skippedPaths);
+        await this.ensureDirectory(internalConfigDir, createdPaths, skippedPaths);
+        await this.ensureDirectory(sessionsDir, createdPaths, skippedPaths);
+        const shouldCreateBootstrapFile = await this.isBrandNewWorkspace(workspaceDir);
+        await this.writeJsonIfMissing(this.pathPort.join(workspaceDir, "workspace.json"), renderWorkspaceMetadata(identity), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "AGENTS.md"), renderWorkspaceAgentsMarkdown(identity), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "CONTEXT.md"), renderWorkspaceContextMarkdown(identity), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "SOUL.md"), renderWorkspaceSoulMarkdown(identity), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "TOOLS.md"), renderWorkspaceToolsMarkdown(), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "IDENTITY.md"), renderWorkspaceIdentityMarkdown(identity), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "USER.md"), renderWorkspaceUserMarkdown(), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "HEARTBEAT.md"), renderWorkspaceHeartbeatMarkdown(), createdPaths, skippedPaths);
+        if (shouldCreateBootstrapFile) {
+            await this.writeMarkdownIfMissing(this.pathPort.join(workspaceDir, "BOOTSTRAP.md"), renderWorkspaceBootstrapMarkdown(identity), createdPaths, skippedPaths);
+        }
+        if (isDefaultAgentId(identity.id)) {
+            const orchestratorSkillDir = this.pathPort.join(workspaceSkillsDir, "opengoat-skill");
+            await this.ensureDirectory(orchestratorSkillDir, createdPaths, skippedPaths);
+            await this.writeMarkdownIfMissing(this.pathPort.join(orchestratorSkillDir, "SKILL.md"), renderDefaultOrchestratorSkillMarkdown(), createdPaths, skippedPaths);
+        }
+        await this.writeJsonIfMissing(this.pathPort.join(internalConfigDir, "config.json"), renderInternalAgentConfig(identity), createdPaths, skippedPaths);
+        await this.writeJsonIfMissing(this.pathPort.join(internalConfigDir, "state.json"), renderInternalAgentState(), createdPaths, skippedPaths);
+        await this.writeMarkdownIfMissing(this.pathPort.join(internalConfigDir, "memory.md"), renderInternalAgentMemoryMarkdown(identity), createdPaths, skippedPaths);
+        await this.writeJsonIfMissing(this.pathPort.join(sessionsDir, "sessions.json"), {
+            schemaVersion: 1,
+            sessions: {}
+        }, createdPaths, skippedPaths);
+        const existingIndex = await this.readJsonIfPresent(paths.agentsIndexJsonPath);
+        const agents = dedupe([...(existingIndex?.agents ?? []), identity.id]);
+        const nextIndex = renderAgentsIndex(this.nowIso(), agents);
+        await this.fileSystem.writeFile(paths.agentsIndexJsonPath, toJson(nextIndex));
+        return {
+            agent: {
+                ...identity,
+                workspaceDir,
+                internalConfigDir
+            },
+            createdPaths,
+            skippedPaths
+        };
+    }
+    async listAgents(paths) {
+        const ids = await this.fileSystem.listDirectories(paths.workspacesDir);
+        const descriptors = [];
+        for (const id of ids) {
+            const workspaceDir = this.pathPort.join(paths.workspacesDir, id);
+            const internalConfigDir = this.pathPort.join(paths.agentsDir, id);
+            const metadataPath = this.pathPort.join(workspaceDir, "workspace.json");
+            const metadata = await this.readJsonIfPresent(metadataPath);
+            descriptors.push({
+                id,
+                displayName: metadata?.displayName ?? id,
+                workspaceDir,
+                internalConfigDir
+            });
+        }
+        return descriptors.sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async removeAgent(paths, rawAgentId) {
+        const agentId = normalizeAgentId(rawAgentId);
+        if (!agentId) {
+            throw new Error("Agent id cannot be empty.");
+        }
+        if (isDefaultAgentId(agentId)) {
+            throw new Error("Cannot delete orchestrator. It is the immutable default entry agent.");
+        }
+        const workspaceDir = this.pathPort.join(paths.workspacesDir, agentId);
+        const internalConfigDir = this.pathPort.join(paths.agentsDir, agentId);
+        const removedPaths = [];
+        const skippedPaths = [];
+        const workspaceExists = await this.fileSystem.exists(workspaceDir);
+        if (workspaceExists) {
+            await this.fileSystem.removeDir(workspaceDir);
+            removedPaths.push(workspaceDir);
+        }
+        else {
+            skippedPaths.push(workspaceDir);
+        }
+        const internalConfigExists = await this.fileSystem.exists(internalConfigDir);
+        if (internalConfigExists) {
+            await this.fileSystem.removeDir(internalConfigDir);
+            removedPaths.push(internalConfigDir);
+        }
+        else {
+            skippedPaths.push(internalConfigDir);
+        }
+        const index = await this.readJsonIfPresent(paths.agentsIndexJsonPath);
+        if (index) {
+            const filtered = dedupe(index.agents.filter((id) => id !== agentId));
+            const nextIndex = renderAgentsIndex(this.nowIso(), filtered);
+            await this.fileSystem.writeFile(paths.agentsIndexJsonPath, toJson(nextIndex));
+        }
+        return {
+            agentId,
+            existed: workspaceExists || internalConfigExists,
+            removedPaths,
+            skippedPaths
+        };
+    }
+    async isBrandNewWorkspace(workspaceDir) {
+        const firstRunFiles = [
+            "AGENTS.md",
+            "CONTEXT.md",
+            "SOUL.md",
+            "TOOLS.md",
+            "IDENTITY.md",
+            "USER.md",
+            "HEARTBEAT.md"
+        ];
+        const existence = await Promise.all(firstRunFiles.map((fileName) => this.fileSystem.exists(this.pathPort.join(workspaceDir, fileName))));
+        return existence.every((value) => !value);
+    }
+    async ensureDirectory(directoryPath, createdPaths, skippedPaths) {
+        const existed = await this.fileSystem.exists(directoryPath);
+        await this.fileSystem.ensureDir(directoryPath);
+        if (existed) {
+            skippedPaths.push(directoryPath);
+            return;
+        }
+        createdPaths.push(directoryPath);
+    }
+    async writeJsonIfMissing(filePath, payload, createdPaths, skippedPaths) {
+        const exists = await this.fileSystem.exists(filePath);
+        if (exists) {
+            skippedPaths.push(filePath);
+            return;
+        }
+        await this.fileSystem.writeFile(filePath, toJson(payload));
+        createdPaths.push(filePath);
+    }
+    async writeMarkdownIfMissing(filePath, content, createdPaths, skippedPaths) {
+        const exists = await this.fileSystem.exists(filePath);
+        if (exists) {
+            skippedPaths.push(filePath);
+            return;
+        }
+        const markdown = content.endsWith("\n") ? content : `${content}\n`;
+        await this.fileSystem.writeFile(filePath, markdown);
+        createdPaths.push(filePath);
+    }
+    async readJsonIfPresent(filePath) {
+        const exists = await this.fileSystem.exists(filePath);
+        if (!exists) {
+            return null;
+        }
+        try {
+            const raw = await this.fileSystem.readFile(filePath);
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function dedupe(values) {
+    return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+function toJson(payload) {
+    return `${JSON.stringify(payload, null, 2)}\n`;
+}
+//# sourceMappingURL=agent.service.js.map

package/dist/core/agents/application/agent.service.js.map

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

package/dist/core/agents/application/workspace-context.service.d.ts

@@ -0,0 +1,28 @@
+import { type WorkspaceBootstrapFile, type WorkspaceContextFile } from "../domain/workspace-context.js";
+import type { FileSystemPort } from "../../ports/file-system.port.js";
+import type { PathPort } from "../../ports/path.port.js";
+interface WorkspaceContextServiceDeps {
+    fileSystem: FileSystemPort;
+    pathPort: PathPort;
+}
+export interface BuildContextFilesOptions {
+    maxChars?: number;
+    warn?: (message: string) => void;
+}
+export declare class WorkspaceContextService {
+    private readonly fileSystem;
+    private readonly pathPort;
+    constructor(deps: WorkspaceContextServiceDeps);
+    getDefaultBootstrapFileNames(): string[];
+    resolveBootstrapFileNames(fileNames?: string[]): string[];
+    loadWorkspaceBootstrapFiles(workspaceDir: string, fileNames?: string[]): Promise<WorkspaceBootstrapFile[]>;
+    buildContextFiles(files: WorkspaceBootstrapFile[], options?: BuildContextFilesOptions): WorkspaceContextFile[];
+    buildSystemPrompt(params: {
+        agentId: string;
+        displayName: string;
+        workspaceDir: string;
+        nowIso: string;
+        contextFiles: WorkspaceContextFile[];
+    }): string;
+}
+export {};

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

@@ -0,0 +1,157 @@
+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

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