@signetai/connector-hermes-agent 0.208.2 → 0.209.1

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import { BaseConnector, type InstallResult, type UninstallResult } from "@signetai/connector-base";
-import { type HermesTarget } from "@signetai/core";
 export interface HermesDiagnosticCheck {
     readonly id: string;
     readonly label: string;
@@ -7,6 +6,12 @@ export interface HermesDiagnosticCheck {
     readonly detail: string;
     readonly fix?: string;
 }
+export interface HermesConnectorOptions {
+    readonly profile?: string;
+    readonly agentId?: string;
+    readonly memoryPolicy?: "isolated" | "shared" | "group";
+    readonly policyGroup?: string;
+}
 export interface HermesDoctorReport {
     readonly ok: boolean;
     readonly hermesHome: string;
@@ -18,41 +23,15 @@ export interface HermesDoctorReport {
     readonly checks: readonly HermesDiagnosticCheck[];
     readonly warnings: readonly string[];
 }
-type AgentReadPolicy = "isolated" | "shared" | "group";
-export interface AgentRegistrationOptions {
-    readonly agentId: string;
-    readonly readPolicy?: AgentReadPolicy;
-    readonly policyGroup?: string | null;
-    /** Requested profile provisioning must fail closed instead of warning. */
-    readonly strict?: boolean;
-}
-export type AgentRegistrationResult = {
-    readonly ok: true;
-    readonly created: boolean;
-    readonly agentId: string;
-} | {
-    readonly ok: false;
-    readonly agentId: string;
-    readonly error: string;
-};
-export declare function ensureNamedAgentRegistered(daemonUrl: string, agentIdOrOptions: string | AgentRegistrationOptions, warnings: string[]): Promise<AgentRegistrationResult>;
-export interface HermesConnectorOptions {
-    readonly target?: HermesTarget;
-    readonly agentId?: string;
-    readonly readPolicy?: AgentReadPolicy;
-    readonly policyGroup?: string | null;
-}
 export declare class HermesAgentConnector extends BaseConnector {
     readonly name = "Hermes Agent";
     readonly harnessId = "hermes-agent";
-    private readonly target?;
-    private readonly registration?;
-    constructor(options?: HermesTarget | HermesConnectorOptions);
+    private targetOptions;
     private getHermesHome;
     private getHermesRepo;
     getConfigPath(): string;
-    install(basePath: string): Promise<InstallResult>;
-    uninstall(): Promise<UninstallResult>;
+    install(basePath: string, options?: HermesConnectorOptions): Promise<InstallResult>;
+    uninstall(options?: HermesConnectorOptions): Promise<UninstallResult>;
     isInstalled(): boolean;
     diagnose(): Promise<HermesDoctorReport>;
 }

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAuB,MAAM,wBAAwB,CAAC;AACtH,OAAO,EAA4D,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAmD3G,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AA6nBD,KAAK,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,uBAAuB,GAChC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AA2C5E,wBAAsB,0BAA0B,CAC/C,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GAAG,wBAAwB,EACnD,QAAQ,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,uBAAuB,CAAC,CAoFlC;AAMD,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,SAAS,kBAAkB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA2B;gBAE7C,OAAO,CAAC,EAAE,YAAY,GAAG,sBAAsB;IAkB3D,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAKrB,aAAa,IAAI,MAAM;IAIjB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAoNjD,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IA2D3C,WAAW,IAAI,OAAO;IAQhB,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAS7C;AAED,wBAAsB,yBAAyB,CAAC,IAAI,CAAC,EAAE;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuG9B;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAEtD;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAuB,MAAM,wBAAwB,CAAC;AAoDtH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAiuBD,qBAAa,oBAAqB,SAAQ,aAAa;IACtD,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,SAAS,kBAAkB;IACpC,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,aAAa;IAKrB,aAAa,IAAI,MAAM;IAIjB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,aAAa,CAAC;IA8MvF,SAAS,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,eAAe,CAAC;IA6D/E,WAAW,IAAI,OAAO;IAQhB,QAAQ,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAS7C;AAED,wBAAsB,yBAAyB,CAAC,IAAI,CAAC,EAAE;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuG9B;AAED,wBAAgB,eAAe,IAAI,oBAAoB,CAEtD;AAED,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -34505,13 +34505,6 @@ function resolveContainedWritePath(targetPath, targetRoot) {
   if (realpathSync3(rootPath) !== rootPath) {
     throw new Error(`Hermes target root is symlinked and cannot be used for writes: ${targetRoot}`);
   }
-  rootPath = targetRoot;
-  while (!existsSync2(rootPath)) {
-    const parent = dirname6(rootPath);
-    if (parent === rootPath)
-      throw new Error(`Hermes target root does not exist: ${targetRoot}`);
-    rootPath = parent;
-  }
   const root = realpathSync3(rootPath);
   let existing = targetPath;
   const missing = [];
@@ -34529,9 +34522,6 @@ function resolveContainedWritePath(targetPath, targetRoot) {
   }
   return candidate;
 }
-function assertContainedTargetPath(targetPath, targetRoot) {
-  resolveContainedWritePath(targetPath, targetRoot);
-}
 function getRepoPluginTargetDir(hermesRepo) {
   return join4(hermesRepo, "plugins", "memory", "signet");
 }
@@ -34548,7 +34538,7 @@ function installPlugin(targetDir, targetKind, targetRoot) {
   const written = [];
   for (const file of PLUGIN_FILES) {
     const src = join4(sourceDir, file);
-    const dst = join4(writeDir, file);
+    const dst = targetRoot ? resolveContainedWritePath(join4(writeDir, file), targetRoot) : join4(writeDir, file);
     if (existsSync2(src)) {
       writeFileSync2(dst, readFileSync2(src));
       written.push(dst);
@@ -34567,18 +34557,20 @@ function uninstallPlugin(targetDir, targetRoot) {
   rmSync(safeTargetDir, { recursive: true, force: true });
   return [targetDir];
 }
-function getConfigCandidates(hermesHome) {
-  return [join4(hermesHome, "config.yaml"), join4(hermesHome, "cli-config.yaml")];
+function getConfigCandidates(hermesHome, targetRoot) {
+  const candidates = [join4(hermesHome, "config.yaml"), join4(hermesHome, "cli-config.yaml")];
+  return targetRoot ? candidates.map((candidate) => resolveContainedWritePath(candidate, targetRoot)) : candidates;
 }
-function resolveConfigPath(hermesHome) {
-  for (const candidate of getConfigCandidates(hermesHome)) {
+function resolveConfigPath(hermesHome, targetRoot) {
+  for (const candidate of getConfigCandidates(hermesHome, targetRoot)) {
     if (existsSync2(candidate))
       return candidate;
   }
-  return join4(hermesHome, "config.yaml");
+  const fallback = join4(hermesHome, "config.yaml");
+  return targetRoot ? resolveContainedWritePath(fallback, targetRoot) : fallback;
 }
-function readConfigYaml(hermesHome) {
-  const configPath = resolveConfigPath(hermesHome);
+function readConfigYaml(hermesHome, targetRoot) {
+  const configPath = resolveConfigPath(hermesHome, targetRoot);
   if (!existsSync2(configPath))
     return null;
   try {
@@ -34684,10 +34676,10 @@ function parseDottedProviderLine(line) {
 function setDottedProviderLine(lines, line, value) {
   lines[line] = `memory.provider: ${value}`;
 }
-function writeProviderBackup(hermesHome, targetRoot, configPath, providerKind, previousProvider) {
+function writeProviderBackup(hermesHome, configPath, providerKind, previousProvider) {
   if (previousProvider === "signet")
     return null;
-  const backupPath = resolveContainedWritePath(getProviderBackupPath(hermesHome), targetRoot);
+  const backupPath = getProviderBackupPath(hermesHome);
   if (existsSync2(backupPath))
     return null;
   const backup = {
@@ -34744,8 +34736,8 @@ function isProviderConfigured(hermesHome) {
   }
   return false;
 }
-function configureProvider(hermesHome, warnings, targetRoot = hermesHome) {
-  const configPath = resolveContainedWritePath(resolveConfigPath(hermesHome), targetRoot);
+function configureProvider(hermesHome, warnings, targetRoot) {
+  const configPath = resolveConfigPath(hermesHome, targetRoot);
   let content = "";
   if (existsSync2(configPath)) {
     try {
@@ -34766,13 +34758,13 @@ function configureProvider(hermesHome, warnings, targetRoot = hermesHome) {
     let changed = false;
     const dottedWasSignet = dottedProviderLineIsSignet(lines[dottedProvider] ?? "");
     if (!dottedWasSignet) {
-      backupPath = writeProviderBackup(hermesHome, targetRoot, configPath, "dotted", parseDottedProviderLine(lines[dottedProvider] ?? "") ?? "");
+      backupPath = writeProviderBackup(hermesHome, configPath, "dotted", parseDottedProviderLine(lines[dottedProvider] ?? "") ?? "");
       setDottedProviderLine(lines, dottedProvider, "signet");
       changed = true;
     }
     if (block !== null && typeof block === "object" && block.provider !== null && block.provider !== undefined) {
       if (dottedWasSignet) {
-        const nestedBackupPath = writeProviderBackup(hermesHome, targetRoot, configPath, "nested", parseProviderLine(lines[block.provider] ?? "") ?? "");
+        const nestedBackupPath = writeProviderBackup(hermesHome, configPath, "nested", parseProviderLine(lines[block.provider] ?? "") ?? "");
         backupPath = nestedBackupPath ?? backupPath;
       }
       lines.splice(block.provider, 1);
@@ -34793,7 +34785,7 @@ function configureProvider(hermesHome, warnings, targetRoot = hermesHome) {
   if (block !== null && typeof block === "object" && block.provider !== null && block.provider !== undefined) {
     if (providerLineIsSignet(lines[block.provider] ?? ""))
       return { configPath: null, backupPath: null };
-    backupPath = writeProviderBackup(hermesHome, targetRoot, configPath, "nested", parseProviderLine(lines[block.provider] ?? "") ?? "");
+    backupPath = writeProviderBackup(hermesHome, configPath, "nested", parseProviderLine(lines[block.provider] ?? "") ?? "");
     lines[block.provider] = `${(lines[block.provider] ?? "").match(/^\s*/)?.[0] ?? "  "}provider: signet`;
   } else if (block !== null && typeof block === "object") {
     lines.splice(block.start + 1, 0, `${" ".repeat(block.indent)}provider: signet`);
@@ -34813,7 +34805,8 @@ function restoreOrClearProvider(hermesHome, targetRoot) {
   const config = readConfigYaml(hermesHome);
   if (!config)
     return { configPath: null, backupPath: removeProviderBackup(hermesHome, targetRoot) };
-  resolveContainedWritePath(config.path, targetRoot ?? hermesHome);
+  if (targetRoot)
+    resolveContainedWritePath(config.path, targetRoot);
   const lines = config.content.replace(/\r\n/g, `
 `).split(`
 `);
@@ -35007,16 +35000,15 @@ function trustedOriginForDaemonUrl(daemonUrl) {
     return null;
   }
 }
-function configuredAgentReadPolicy(warnings, strict = false) {
+function configuredAgentReadPolicy(warnings, options = {}) {
+  if (options.memoryPolicy)
+    return options.memoryPolicy;
   const raw = sanitizedEnv("SIGNET_AGENT_READ_POLICY") || sanitizedEnv("SIGNET_AGENT_MEMORY_POLICY");
   if (!raw)
     return "shared";
   if (raw === "isolated" || raw === "shared" || raw === "group")
     return raw;
-  const error = `Unsupported SIGNET_AGENT_READ_POLICY '${raw}'. Expected one of: isolated, shared, group.`;
-  if (strict)
-    return null;
-  warnings.push(`Ignoring ${error}`);
+  warnings.push(`Ignoring unsupported SIGNET_AGENT_READ_POLICY '${raw}'. Expected one of: isolated, shared, group.`);
   return "shared";
 }
 async function resolveDaemonAgentId(daemonUrl) {
@@ -35040,20 +35032,11 @@ async function resolveDaemonAgentId(daemonUrl) {
     return null;
   }
 }
-async function ensureNamedAgentRegistered(daemonUrl, agentIdOrOptions, warnings) {
-  const options = typeof agentIdOrOptions === "string" ? { agentId: agentIdOrOptions } : agentIdOrOptions;
-  const { agentId } = options;
-  const strict = options.strict === true;
-  const fail = (error) => {
-    if (!strict)
-      warnings.push(error);
-    return { ok: false, agentId, error };
-  };
-  if (!agentId || agentId === "default" || agentId === "hermes-agent") {
-    return { ok: true, created: false, agentId };
-  }
+async function ensureNamedAgentRegistered(daemonUrl, agentId, warnings, options = {}) {
+  if (!agentId || agentId === "default" || agentId === "hermes-agent")
+    return null;
   if (process.env.SIGNET_SKIP_AGENT_REGISTER === "1")
-    return { ok: true, created: false, agentId };
+    return null;
   const baseUrl = trimTrailingSlashes(daemonUrl);
   const token = sanitizedAuthTokenEnv();
   const headers = {};
@@ -35066,27 +35049,19 @@ async function ensureNamedAgentRegistered(daemonUrl, agentIdOrOptions, warnings)
       signal: AbortSignal.timeout(1000)
     });
     if (getResp.ok)
-      return { ok: true, created: false, agentId };
+      return null;
     if (getResp.status !== 404) {
       const body = await getResp.text();
-      return fail(`Could not check Signet agent '${agentId}' before registration: HTTP ${getResp.status} ${body.slice(0, 200)}`);
-    }
-  } catch (e) {
-    if (strict) {
-      const msg = e instanceof Error ? e.message : String(e);
-      return fail(`Could not check Signet agent '${agentId}' because the daemon was unreachable. (${msg})`);
+      warnings.push(`Could not check Signet agent '${agentId}' before registration: HTTP ${getResp.status} ${body.slice(0, 200)}`);
+      return null;
     }
-  }
-  const readPolicy = options.readPolicy ?? configuredAgentReadPolicy(warnings, strict);
-  if (readPolicy === null)
-    return fail(`Could not register Signet agent '${agentId}' because its read policy is invalid.`);
-  const policyGroup = options.policyGroup !== undefined ? options.policyGroup : readPolicy === "group" ? sanitizedEnv("SIGNET_AGENT_POLICY_GROUP") || null : null;
+  } catch {}
+  const readPolicy = configuredAgentReadPolicy(warnings, options);
+  const policyGroup = readPolicy === "group" ? options.policyGroup?.trim() || sanitizedEnv("SIGNET_AGENT_POLICY_GROUP") || null : null;
   if (readPolicy === "group" && !policyGroup) {
-    if (strict)
-      return fail(`Agent '${agentId}' requested group policy but no policy group was provided.`);
-    warnings.push(`SIGNET_AGENT_READ_POLICY=group requires SIGNET_AGENT_POLICY_GROUP. Registering '${agentId}' with isolated memory instead.`);
+    return `Group memory policy for '${agentId}' requires --group or SIGNET_AGENT_POLICY_GROUP.`;
   }
-  const effectiveReadPolicy = readPolicy === "group" && !policyGroup ? "isolated" : readPolicy;
+  const effectiveReadPolicy = readPolicy;
   const policyHint = effectiveReadPolicy === "shared" ? `Run: signet agent create ${agentId} --memory shared, or use --memory isolated for private memory.` : `Run: signet agent create ${agentId} --memory ${effectiveReadPolicy}.`;
   try {
     const resp = await fetch(`${baseUrl}/api/agents`, {
@@ -35101,64 +35076,54 @@ async function ensureNamedAgentRegistered(daemonUrl, agentIdOrOptions, warnings)
     });
     if (!resp.ok) {
       const body = await resp.text();
-      return fail(`Could not register Signet agent '${agentId}' with ${effectiveReadPolicy} memory policy: ${body.slice(0, 200)}. ${policyHint}`);
+      return `Could not register Signet agent '${agentId}' with ${effectiveReadPolicy} memory policy: ${body.slice(0, 200)}. ${policyHint}`;
     }
-    return { ok: true, created: true, agentId };
   } catch (e) {
     const msg = e instanceof Error ? e.message : String(e);
-    return fail(`Could not register Signet agent '${agentId}' because the daemon was unreachable. ${policyHint} (${msg})`);
+    return `Could not register Signet agent '${agentId}' because the daemon was unreachable. ${policyHint} (${msg})`;
   }
+  return null;
 }
 
 class HermesAgentConnector extends BaseConnector {
   name = "Hermes Agent";
   harnessId = "hermes-agent";
-  target;
-  registration;
-  constructor(options) {
-    super();
-    if (options && "home" in options) {
-      this.target = options;
-      this.registration = { agentId: "", strict: options.kind === "profile" };
-    } else {
-      this.target = options?.target;
-      this.registration = options ? {
-        agentId: options.agentId ?? "",
-        readPolicy: options.readPolicy,
-        policyGroup: options.policyGroup,
-        strict: options.target?.kind === "profile"
-      } : undefined;
-    }
-  }
+  targetOptions = {};
   getHermesHome() {
-    return this.target?.home ?? resolveHermesHomePath();
+    if (this.targetOptions.profile) {
+      if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/.test(this.targetOptions.profile)) {
+        throw new Error("Invalid Hermes profile name; use 1-64 letters, numbers, '.', '_' or '-'.");
+      }
+      const userHome2 = process.env.HOME?.trim() || homedir();
+      const profileHome = join4(userHome2, ".hermes", "profiles", this.targetOptions.profile);
+      return resolveContainedWritePath(profileHome, join4(userHome2, ".hermes", "profiles"));
+    }
+    return resolveHermesHomePath();
   }
   getHermesRepo() {
-    if (this.target?.kind === "profile")
+    if (this.targetOptions.profile)
       return null;
     return resolveHermesRepoPath();
   }
   getConfigPath() {
     return resolveConfigPath(this.getHermesHome());
   }
-  async install(basePath) {
+  async install(basePath, options = {}) {
+    this.targetOptions = options;
     const filesWritten = [];
     const configsPatched = [];
     const warnings = [];
     const expandedBasePath = expandHome(basePath || join4(homedir(), ".agents"));
-    const hermesHome = this.getHermesHome();
-    const legacyAgentsBasePath = this.target?.kind === "profile" ? hermesHome : expandedBasePath;
-    const strippedAgentsPath = this.stripLegacySignetBlock(legacyAgentsBasePath);
+    const strippedAgentsPath = options.profile ? null : this.stripLegacySignetBlock(expandedBasePath);
     if (strippedAgentsPath !== null) {
       filesWritten.push(strippedAgentsPath);
     }
-    if (this.target?.kind === "profile")
-      assertContainedTargetPath(hermesHome, this.target.home);
+    const hermesHome = this.getHermesHome();
     const hermesRepo = this.getHermesRepo();
     let userPluginInstalled = false;
     let repoPluginInstalled = false;
     try {
-      const pluginFiles = installPlugin(getUserPluginTargetDir(hermesHome), "user", hermesHome);
+      const pluginFiles = installPlugin(getUserPluginTargetDir(hermesHome), "user", options.profile ? hermesHome : undefined);
       filesWritten.push(...pluginFiles);
       userPluginInstalled = true;
     } catch (e) {
@@ -35167,7 +35132,7 @@ class HermesAgentConnector extends BaseConnector {
     }
     if (hermesRepo) {
       try {
-        const pluginFiles = installPlugin(getRepoPluginTargetDir(hermesRepo), "repo", hermesRepo);
+        const pluginFiles = installPlugin(getRepoPluginTargetDir(hermesRepo), "repo");
         filesWritten.push(...pluginFiles);
         repoPluginInstalled = true;
       } catch (e) {
@@ -35185,7 +35150,7 @@ class HermesAgentConnector extends BaseConnector {
         warnings
       };
     }
-    const envPath = this.target?.kind === "profile" ? resolveContainedWritePath(join4(hermesHome, ".env"), this.target.home) : join4(hermesHome, ".env");
+    const envPath = options.profile ? resolveContainedWritePath(join4(hermesHome, ".env"), hermesHome) : join4(hermesHome, ".env");
     let configuredSignetAgentId = "default";
     const configuredDaemonUrl = (process.env.SIGNET_DAEMON_URL?.trim() || "http://127.0.0.1:3850").replace(/[\r\n]+/g, "");
     try {
@@ -35200,7 +35165,7 @@ class HermesAgentConnector extends BaseConnector {
       if (process.env.SIGNET_TRUSTED_DAEMON_ORIGINS) {
         signetVars.SIGNET_TRUSTED_DAEMON_ORIGINS = sanitizedEnv("SIGNET_TRUSTED_DAEMON_ORIGINS");
       }
-      let signetAgentId = this.registration?.agentId || sanitizedEnv("SIGNET_AGENT_ID");
+      let signetAgentId = sanitizedEnv("SIGNET_AGENT_ID");
       if (signetAgentId === "hermes-agent") {
         warnings.push("SIGNET_AGENT_ID='hermes-agent' is the harness name, not an agent scope. Re-resolving from the daemon.");
         signetAgentId = "";
@@ -35255,18 +35220,11 @@ ${key}=${value}
       const msg = e instanceof Error ? e.message : String(e);
       warnings.push(`Failed to update .env: ${msg}`);
     }
-    const registration = this.registration ? { ...this.registration, agentId: this.registration.agentId || configuredSignetAgentId } : configuredSignetAgentId;
-    const registrationResult = await ensureNamedAgentRegistered(configuredDaemonUrl, registration, warnings);
-    if (!registrationResult.ok && this.target?.kind === "profile") {
-      return {
-        success: false,
-        message: registrationResult.error,
-        filesWritten,
-        configsPatched,
-        warnings
-      };
+    const registrationError = await ensureNamedAgentRegistered(configuredDaemonUrl, configuredSignetAgentId, warnings, options);
+    if (registrationError) {
+      return { success: false, message: registrationError, filesWritten, configsPatched, warnings };
     }
-    const providerConfig = configureProvider(hermesHome, warnings, this.target?.kind === "profile" ? this.target.home : hermesHome);
+    const providerConfig = configureProvider(hermesHome, warnings, options.profile ? hermesHome : undefined);
     if (providerConfig.configPath) {
       configsPatched.push(providerConfig.configPath);
     }
@@ -35299,28 +35257,30 @@ ${key}=${value}
       warnings
     };
   }
-  async uninstall() {
+  async uninstall(options = {}) {
+    this.targetOptions = options;
     const filesRemoved = [];
     const configsPatched = [];
     const hermesRepo = this.getHermesRepo();
     if (hermesRepo) {
-      const removed = uninstallPlugin(getRepoPluginTargetDir(hermesRepo), hermesRepo);
+      const removed = uninstallPlugin(getRepoPluginTargetDir(hermesRepo));
       filesRemoved.push(...removed);
     }
     const hermesHome = this.getHermesHome();
-    const targetRoot = this.target?.kind === "profile" ? this.target.home : undefined;
-    if (targetRoot)
-      assertContainedTargetPath(hermesHome, targetRoot);
-    const userPluginRemoved = uninstallPlugin(getUserPluginTargetDir(hermesHome), targetRoot);
+    const userPluginTarget = getUserPluginTargetDir(hermesHome);
+    if (options.profile && (!existsSync2(userPluginTarget) || readInstallMarker(userPluginTarget) === null)) {
+      return { filesRemoved, configsPatched };
+    }
+    const userPluginRemoved = uninstallPlugin(userPluginTarget, options.profile ? hermesHome : undefined);
     filesRemoved.push(...userPluginRemoved);
-    const providerConfig = restoreOrClearProvider(hermesHome, targetRoot);
+    const providerConfig = restoreOrClearProvider(hermesHome, options.profile ? hermesHome : undefined);
     if (providerConfig.configPath) {
       configsPatched.push(providerConfig.configPath);
     }
     if (providerConfig.backupPath) {
       filesRemoved.push(providerConfig.backupPath);
     }
-    const envPath = targetRoot ? resolveContainedWritePath(join4(hermesHome, ".env"), targetRoot) : join4(hermesHome, ".env");
+    const envPath = options.profile ? resolveContainedWritePath(join4(hermesHome, ".env"), hermesHome) : join4(hermesHome, ".env");
     if (existsSync2(envPath)) {
       try {
         let envContent = readFileSync2(envPath, "utf-8");
@@ -35454,7 +35414,6 @@ function createConnector() {
 }
 var src_default = HermesAgentConnector;
 export {
-  ensureNamedAgentRegistered,
   diagnoseHermesIntegration,
   src_default as default,
   createConnector,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signetai/connector-hermes-agent",
-  "version": "0.208.2",
+  "version": "0.209.1",
   "description": "Signet connector for Hermes Agent — installs Signet as a pluggable memory provider",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,8 +25,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@signetai/connector-base": "0.208.2",
-    "@signetai/core": "0.208.2"
+    "@signetai/connector-base": "0.209.1",
+    "@signetai/core": "0.209.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",