refactor: migrate attach socket paths to TypeScript

Author: tomdps

.gitignore

@@ -159,6 +159,7 @@ src/agent/critical-agent-policy.js
 src/agent/provider-control-plane.js
 src/agent/structured-output-error.js
 src/agent/validation-platform.js
+src/attach/socket-paths.js
 src/providers/anthropic/index.js
 src/providers/capabilities.js
 src/providers/google/index.js

eslint.config.mjs

@@ -413,6 +413,7 @@ export default [
       'src/agent/provider-control-plane.js',
       'src/agent/structured-output-error.js',
       'src/agent/validation-platform.js',
+      'src/attach/socket-paths.js',
       'src/providers/anthropic/index.js',
       'src/providers/capabilities.js',
       'src/providers/google/index.js',

src/attach/socket-paths.js src/attach/socket-paths.tssrc/attach/socket-paths.js renamed to src/attach/socket-paths.ts

@@ -1,42 +1,34 @@
-/**
- * Deterministic attach socket paths.
- *
- * Unix-domain sockets have a small path budget (104 bytes on macOS). Keep the
- * live socket namespace independent from HOME while retaining one namespace
- * per OS user and Zeroshot home.
- */
-
-const crypto = require('crypto');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
+import crypto = require('crypto');
+import fs = require('fs');
+import os = require('os');
+import path = require('path');
 
 const SOCKET_ROOT = process.platform === 'win32' ? null : '/tmp';
 const SOCKET_DIR_MODE = 0o700;
 
-function shortHash(value) {
+function shortHash(value: string): string {
   return crypto.createHash('sha256').update(value).digest('hex').slice(0, 16);
 }
 
-function userNamespace() {
+function userNamespace(): string {
   if (typeof process.getuid === 'function') {
     return String(process.getuid());
   }
   return shortHash(os.userInfo().username);
 }
 
-function resolveHomeDir(env = process.env) {
+function resolveHomeDir(env: NodeJS.ProcessEnv = process.env): string {
   return env.ZEROSHOT_HOME || env.HOME || env.USERPROFILE || os.homedir();
 }
 
-function getSocketDir(homeDir = resolveHomeDir()) {
-  if (process.platform === 'win32') {
+function getSocketDir(homeDir = resolveHomeDir()): string {
+  if (SOCKET_ROOT === null) {
     return path.join(homeDir, '.zeroshot', 'sockets');
   }
   return path.join(SOCKET_ROOT, `zeroshot-${userNamespace()}-${shortHash(homeDir)}`);
 }
 
-function assertSafeSocketDir(socketDir) {
+function assertSafeSocketDir(socketDir: string): void {
   const stat = fs.lstatSync(socketDir);
   if (!stat.isDirectory() || stat.isSymbolicLink()) {
     throw new Error(`Attach socket path is not a directory: ${socketDir}`);
@@ -46,7 +38,7 @@ function assertSafeSocketDir(socketDir) {
   }
 }
 
-function ensureOwnedDirectory(socketDir) {
+function ensureOwnedDirectory(socketDir: string): string {
   fs.mkdirSync(socketDir, { recursive: true, mode: SOCKET_DIR_MODE });
   assertSafeSocketDir(socketDir);
   if (process.platform !== 'win32') {
@@ -55,26 +47,30 @@ function ensureOwnedDirectory(socketDir) {
   return socketDir;
 }
 
-function ensureSocketDir(homeDir = resolveHomeDir()) {
+function ensureSocketDir(homeDir = resolveHomeDir()): string {
   const socketDir = getSocketDir(homeDir);
   return ensureOwnedDirectory(socketDir);
 }
 
-function getTaskSocketPath(taskId, homeDir = resolveHomeDir()) {
+function getTaskSocketPath(taskId: string, homeDir = resolveHomeDir()): string {
   return path.join(ensureSocketDir(homeDir), `${taskId}.sock`);
 }
 
-function getAgentSocketPath(clusterId, agentId, homeDir = resolveHomeDir()) {
+function getAgentSocketPath(
+  clusterId: string,
+  agentId: string,
+  homeDir = resolveHomeDir()
+): string {
   const clusterDir = path.join(ensureSocketDir(homeDir), clusterId);
   ensureOwnedDirectory(clusterDir);
   return path.join(clusterDir, `${agentId}.sock`);
 }
 
-function getClusterSocketPath(clusterId, homeDir = resolveHomeDir()) {
+function getClusterSocketPath(clusterId: string, homeDir = resolveHomeDir()): string {
   return path.join(ensureSocketDir(homeDir), `${clusterId}.sock`);
 }
 
-module.exports = {
+export = {
   SOCKET_DIR_MODE,
   resolveHomeDir,
   getSocketDir,

tests/helpers/runtime-typescript-package-assertions.js

@@ -21,6 +21,7 @@ const RUNTIME_TYPESCRIPT_OUTPUTS = Object.freeze([
   'src/agent/provider-control-plane.js',
   'src/agent/structured-output-error.js',
   'src/agent/validation-platform.js',
+  'src/attach/socket-paths.js',
   'src/providers/anthropic/index.js',
   'src/providers/capabilities.js',
   'src/providers/google/index.js',