@borgee/agents-host 0.1.5 → 0.1.7

package/dist/run.d.ts

@@ -1,7 +1,27 @@
-/**
- * Loads config from the environment, starts an `AgentsHost`, and wires up
- * graceful shutdown on SIGINT/SIGTERM. Shared by the plain env-var entry
- * point (`index.ts`) and the CLI entry point (`cli.ts`), which sets the
- * relevant env vars from argv before delegating here.
- */
-export declare function runMain(): Promise<void>;
+import { parseGenerateConfigSpec, resolveLocalConfigLayout } from './local-config.js';
+import type { LocalConfigGenerateResult, LocalConfigGenerateSpec, LocalConfigSnapshot } from './types.js';
+export interface RunMainOptions {
+    configPath?: string;
+}
+export interface ValidateLocalConfigDeps {
+    loadSnapshot?: (configPath: string) => Promise<LocalConfigSnapshot>;
+    logger?: Pick<Console, 'log'>;
+}
+export interface PrintLocalConfigLayoutDeps {
+    resolveLayout?: (rootPath: string) => ReturnType<typeof resolveLocalConfigLayout>;
+    writer?: Pick<Console, 'log'>;
+}
+export interface DescribeLocalConfigDeps {
+    loadSpec?: (configPath: string) => Promise<LocalConfigGenerateSpec>;
+    writer?: Pick<Console, 'log'>;
+}
+export interface GenerateLocalConfigDeps {
+    parseSpec?: (value: unknown, sourceLabel: string) => ReturnType<typeof parseGenerateConfigSpec>;
+    materialize?: (rootPath: string, spec: ReturnType<typeof parseGenerateConfigSpec>) => Promise<LocalConfigGenerateResult>;
+    writer?: Pick<Console, 'log'>;
+}
+export declare function validateLocalConfig(configPath: string, deps?: ValidateLocalConfigDeps): Promise<void>;
+export declare function printLocalConfigLayout(rootPath: string, deps?: PrintLocalConfigLayoutDeps): Promise<void>;
+export declare function describeLocalConfig(configPath: string, deps?: DescribeLocalConfigDeps): Promise<void>;
+export declare function generateLocalConfig(rootPath: string, specJson: string, sourceLabelOrDeps?: string | GenerateLocalConfigDeps, deps?: GenerateLocalConfigDeps): Promise<void>;
+export declare function runMain(options?: RunMainOptions): Promise<void>;

package/dist/run.js

@@ -1,14 +1,51 @@
-import { loadConfigFromEnv } from './config.js';
 import { AgentsHost } from './agents-host.js';
-/**
- * Loads config from the environment, starts an `AgentsHost`, and wires up
- * graceful shutdown on SIGINT/SIGTERM. Shared by the plain env-var entry
- * point (`index.ts`) and the CLI entry point (`cli.ts`), which sets the
- * relevant env vars from argv before delegating here.
- */
-export async function runMain() {
-    const config = loadConfigFromEnv();
-    const host = new AgentsHost(config);
+import { AgentsHostSupervisor } from './agents-host-supervisor.js';
+import { loadConfigFromEnv } from './config.js';
+import { loadLocalConfigGenerateSpec, loadLocalConfigSnapshot, materializeLocalConfig, parseGenerateConfigSpec, resolveLocalConfigLayout, } from './local-config.js';
+export async function validateLocalConfig(configPath, deps = {}) {
+    const loadSnapshot = deps.loadSnapshot ?? loadLocalConfigSnapshot;
+    const logger = deps.logger ?? console;
+    const snapshot = await loadSnapshot(configPath);
+    logger.log('[agents-host] local-config validation OK');
+    logger.log(`[agents-host] host config: ${snapshot.hostConfigPath}`);
+    logger.log(`[agents-host] agents dir: ${snapshot.agentsDir}`);
+    logger.log(`[agents-host] managed agents: ${snapshot.agents.length}`);
+    for (const agent of snapshot.agents) {
+        logger.log(`[agents-host] managed agent key=${agent.key} provider=${agent.config.agent.provider} sourcePath=${agent.sourcePath}`);
+    }
+}
+export async function printLocalConfigLayout(rootPath, deps = {}) {
+    const resolveLayout = deps.resolveLayout ?? resolveLocalConfigLayout;
+    const writer = deps.writer ?? console;
+    writer.log(JSON.stringify(resolveLayout(rootPath), null, 2));
+}
+export async function describeLocalConfig(configPath, deps = {}) {
+    const loadSpec = deps.loadSpec ?? loadLocalConfigGenerateSpec;
+    const writer = deps.writer ?? console;
+    writer.log(JSON.stringify(await loadSpec(configPath), null, 2));
+}
+export async function generateLocalConfig(rootPath, specJson, sourceLabelOrDeps = '--spec-json', deps = {}) {
+    const sourceLabel = typeof sourceLabelOrDeps === 'string' ? sourceLabelOrDeps : '--spec-json';
+    const resolvedDeps = typeof sourceLabelOrDeps === 'string' ? deps : sourceLabelOrDeps;
+    const parseSpec = resolvedDeps.parseSpec ?? parseGenerateConfigSpec;
+    const materialize = resolvedDeps.materialize ?? materializeLocalConfig;
+    const writer = resolvedDeps.writer ?? console;
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(specJson);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid ${sourceLabel}: ${message}`);
+    }
+    const spec = parseSpec(parsedJson, sourceLabel);
+    const result = await materialize(rootPath, spec);
+    writer.log(JSON.stringify(result, null, 2));
+}
+export async function runMain(options = {}) {
+    const host = options.configPath
+        ? new AgentsHostSupervisor(options.configPath)
+        : new AgentsHost(loadConfigFromEnv());
     const shutdown = (signal) => {
         console.log(`[agents-host] received ${signal}, shutting down`);
         host
@@ -19,4 +56,5 @@ export async function runMain() {
     process.on('SIGINT', () => shutdown('SIGINT'));
     process.on('SIGTERM', () => shutdown('SIGTERM'));
     await host.start();
+    console.log('[agents-host] ready');
 }

package/dist/types.d.ts

@@ -4,15 +4,11 @@ export interface ProviderCommandConfig {
     claudeArgs: string[];
     copilotCommand: string;
     copilotArgs: string[];
+    copilotSessionTtlMinutes: number;
 }
 export interface ProviderRuntimeConfig extends ProviderCommandConfig {
     provider: ProviderKind;
 }
-/**
- * Single hosted-agent configuration. The minimal agents host supports exactly
- * one Borgee agent per process — running multiple agents means running
- * multiple processes with different env vars (see README).
- */
 export interface HostedAgentConfig {
     agentApiKey: string;
     agentName: string;
@@ -22,6 +18,66 @@ export interface AgentsHostConfig extends ProviderCommandConfig {
     borgeeBaseUrl: string;
     agent: HostedAgentConfig;
 }
+export interface LocalHostConfigFile {
+    borgeeBaseUrl: string;
+    agentsDir?: string;
+    defaults?: Partial<ProviderCommandConfig>;
+}
+export interface LocalHostGenerateConfigFile {
+    borgeeBaseUrl: string;
+    defaults?: Partial<ProviderCommandConfig>;
+}
+export interface LocalAgentConfigFile extends Partial<ProviderCommandConfig> {
+    key: string;
+    name: string;
+    apiKey: string;
+    provider: ProviderKind;
+    enabled?: boolean;
+}
+export interface ManagedAgentConfigSnapshot {
+    key: string;
+    sourcePath: string;
+    config: AgentsHostConfig;
+}
+export interface LocalConfigSnapshot {
+    /** Stable caller-facing paths, suitable for validation output and publication watches. */
+    hostConfigPath: string;
+    hostConfigDir: string;
+    agentsDir: string;
+    /** Managed stable root when the snapshot comes from generate-config publication. */
+    managedRootPath?: string;
+    /** Resolved paths pinned before config files are read. */
+    resolvedHostConfigPath: string;
+    resolvedHostConfigDir: string;
+    resolvedAgentsDir: string;
+    agents: ManagedAgentConfigSnapshot[];
+}
+export interface LocalConfigGenerateSpec {
+    host: LocalHostGenerateConfigFile;
+    agents: LocalAgentConfigFile[];
+}
+export interface LocalConfigGenerateWarning {
+    code: 'PRUNE_SUPERSEDED_GENERATIONS_FAILED';
+    message: string;
+}
+export interface LocalConfigGenerateResult {
+    root: string;
+    hostConfigPath: string;
+    agentsDir: string;
+    generatedAgents: Array<{
+        key: string;
+        path: string;
+        provider: ProviderKind;
+        enabled: boolean;
+    }>;
+    /**
+     * Agent config paths removed from the active authoritative set. Publication
+     * switches the whole set atomically rather than deleting these paths first.
+     */
+    prunedAgentConfigPaths: string[];
+    /** Non-fatal maintenance problems encountered after publication. */
+    warnings: LocalConfigGenerateWarning[];
+}
 export interface ChannelMessageEvent {
     type?: string;
     channel_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@borgee/agents-host",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -21,7 +21,9 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@agentclientprotocol/sdk": "^1.2.1",
     "cross-spawn": "^7.0.6",
+    "yaml": "^2.8.1",
     "@borgee/plugin-sdk": "0.1.1"
   },
   "devDependencies": {
@@ -42,6 +44,7 @@
     "build": "tsc",
     "typecheck": "tsc --noEmit",
     "pretest": "pnpm --filter @borgee/plugin-sdk build",
-    "test": "vitest run"
+    "test": "vitest run --testTimeout=10000",
+    "pretypecheck": "pnpm --filter @borgee/plugin-sdk build"
   }
 }