Function resolveAnnotatedValue

dev/local/env-sync/parse.ts:207–312

(
  key: string,
  entry: ExampleEntry,
  envLocal: Map<string, string>,
  lanIp: string | undefined,
  serviceUsesLanIp: boolean
)

// ---------------------------------------------------------------------------
// Annotation-based value resolution
// ---------------------------------------------------------------------------

const WORKER_LOCALHOST_URL_KEYS = new Set(['KILOCODE_BACKEND_BASE_URL', 'KILO_OPENROUTER_BASE']);

function resolveAnnotatedValue(
  key: string,
  entry: ExampleEntry,
  envLocal: Map<string, string>,
  lanIp: string | undefined,
  serviceUsesLanIp: boolean
): { value: string; resolved: boolean; source: ResolvedValueSource } {
  switch (entry.annotation.type) {
    case 'override':
      return { value: entry.defaultValue, resolved: true, source: 'override' };

    case 'from': {
      const val = envLocal.get(entry.annotation.envLocalKey);
      if (val) return { value: val, resolved: true, source: 'env-local' };
      if (val === '') return { value: '', resolved: false, source: 'missing' };
      if (entry.defaultValue) {
        return { value: entry.defaultValue, resolved: true, source: 'default' };
      }
      return { value: '', resolved: false, source: 'missing' };
    }

    case 'url': {
      const isOrigins = key.includes('ORIGINS');
      const isHostname = key.includes('HOSTNAME') && !key.includes('URL');
      const isWs =
        key.includes('_WS_') ||
        entry.defaultValue.startsWith('ws://') ||
        entry.defaultValue.startsWith('wss://');
      const defaultUsesDockerHost = entry.defaultValue.includes('host.docker.internal');
      const defaultUsesWorkerLocalhost =
        WORKER_LOCALHOST_URL_KEYS.has(key) &&
        (entry.defaultValue.includes('localhost') || entry.defaultValue.includes('127.0.0.1'));
      // LAN IP for container services, except for ORIGINS keys where the host is
      // always localhost for the base entry and a LAN entry is additionally emitted
      // when serviceUsesLanIp is set. Preserve host.docker.internal when the example
      // default uses it (sandbox containers need it to reach the host from inside Docker).
      // Preserve localhost for worker-side URLs that are translated separately
      // before being sent into sandbox containers.
      const host = defaultUsesDockerHost
        ? 'host.docker.internal'
        : defaultUsesWorkerLocalhost
          ? 'localhost'
          : serviceUsesLanIp && !isOrigins && lanIp
            ? lanIp
            : 'localhost';
      const protocol = isWs ? 'ws' : 'http';

      const resolvedParts: string[] = [];
      for (const svcRef of entry.annotation.services) {
        const port = servicePort(svcRef.name);
        if (port === undefined) {
          console.warn(`⚠ Unknown service "${svcRef.name}" in @url annotation for ${key}`);
          continue;
        }