@borgee/agents-host 0.2.0 → 0.2.2

package/dist/state-paths.js

@@ -0,0 +1,46 @@
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+const SINGLE_AGENT_HOME_ROOT = '.borgee';
+const AGENTS_HOST_ROOT = 'agents-host';
+const SINGLE_AGENT_NAMESPACE = 'single-agent';
+const MANAGED_STATE_DIRNAME = '.state';
+const STATE_ROOT_LABEL_MAX_LENGTH = 48;
+function encodeSegment(value) {
+    return encodeURIComponent(value);
+}
+function sanitizeStateRootLabel(agentKey) {
+    const sanitized = encodeSegment(agentKey)
+        .toLowerCase()
+        .replace(/%/g, '-')
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, STATE_ROOT_LABEL_MAX_LENGTH);
+    return sanitized.length > 0 ? sanitized : 'agent';
+}
+function hashStateRootKey(agentKey) {
+    return createHash('sha256').update(agentKey).digest('hex').slice(0, 12);
+}
+export function resolveSingleAgentStateRoot(env = process.env, resolvedHomeDir = homedir()) {
+    const home = env.HOME?.trim() || resolvedHomeDir.trim();
+    if (!home) {
+        throw new Error('Unable to resolve a user home directory for agents-host state');
+    }
+    return join(home, SINGLE_AGENT_HOME_ROOT, AGENTS_HOST_ROOT, SINGLE_AGENT_NAMESPACE);
+}
+export function resolveManagedStateRoot(rootPath) {
+    return join(resolve(rootPath), MANAGED_STATE_DIRNAME);
+}
+export function resolveLocalConfigAgentStateRoot(rootPath, agentKey) {
+    return join(resolveManagedStateRoot(rootPath), `${sanitizeStateRootLabel(agentKey)}-${hashStateRootKey(agentKey)}`);
+}
+export function resolveAgentCursorPath(stateRootDir, agentId) {
+    return join(stateRootDir, `bpp-cursor-${encodeSegment(agentId)}.json`);
+}
+export function resolveClaudeSessionMapPath(stateRootDir, agentId) {
+    return join(stateRootDir, `claude-channel-sessions-${encodeSegment(agentId)}.json`);
+}
+export function resolveCopilotSessionMapPath(stateRootDir, agentId) {
+    return join(stateRootDir, `copilot-channel-sessions-${encodeSegment(agentId)}.json`);
+}

package/dist/types.d.ts

@@ -8,6 +8,8 @@ export interface ProviderCommandConfig {
 }
 export interface ProviderRuntimeConfig extends ProviderCommandConfig {
     provider: ProviderKind;
+    stateRootDir: string;
+    resolveStableAgentId?: () => string | undefined;
 }
 export interface HostedAgentConfig {
     agentApiKey: string;
@@ -16,6 +18,7 @@ export interface HostedAgentConfig {
 }
 export interface AgentsHostConfig extends ProviderCommandConfig {
     borgeeBaseUrl: string;
+    stateRootDir: string;
     agent: HostedAgentConfig;
 }
 export interface LocalHostConfigFile {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@borgee/agents-host",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -8,7 +8,7 @@
   "type": "module",
   "description": "Minimal local agents host: connects a local Claude/Copilot CLI to a Borgee agent over @borgee/plugin-sdk",
   "bin": {
-    "agents-host": "./dist/cli.js"
+    "agents-host": "dist/cli.js"
   },
   "files": [
     "dist",
@@ -20,19 +20,6 @@
     "directory": "packages/agents-host"
   },
   "license": "MIT",
-  "dependencies": {
-    "@agentclientprotocol/sdk": "^1.2.1",
-    "cross-spawn": "^7.0.6",
-    "yaml": "^2.8.1",
-    "@borgee/plugin-sdk": "0.1.2"
-  },
-  "devDependencies": {
-    "@types/cross-spawn": "^6.0.6",
-    "@types/node": "^24.3.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.5"
-  },
   "scripts": {
     "predev": "pnpm --filter @borgee/plugin-sdk build",
     "dev": "tsx src/index.ts",
@@ -46,5 +33,18 @@
     "pretest": "pnpm --filter @borgee/plugin-sdk build",
     "test": "vitest run --testTimeout=10000",
     "pretypecheck": "pnpm --filter @borgee/plugin-sdk build"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^1.2.1",
+    "@borgee/plugin-sdk": "0.1.5",
+    "cross-spawn": "^7.0.6",
+    "yaml": "^2.8.1"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.5"
   }
-}
+}