@agent-relay/utils 0.1.0

package/dist/command-resolver.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Command Path Resolver
+ *
+ * Resolves full paths for CLI commands to avoid posix_spawnp failures
+ * when PATH isn't properly inherited in spawned processes.
+ */
+/**
+ * Resolve the full path of a command using 'which' and resolve any symlinks
+ * Returns the full path if found, or the original command if not found
+ * (letting the spawn fail with a clearer error)
+ */
+export declare function resolveCommand(command: string): string;
+/**
+ * Check if a command exists in PATH
+ */
+export declare function commandExists(command: string): boolean;
+//# sourceMappingURL=command-resolver.d.ts.map

package/dist/command-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-resolver.d.ts","sourceRoot":"","sources":["../src/command-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA6BtD;AAwBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUtD"}

package/dist/command-resolver.js

@@ -0,0 +1,80 @@
+/**
+ * Command Path Resolver
+ *
+ * Resolves full paths for CLI commands to avoid posix_spawnp failures
+ * when PATH isn't properly inherited in spawned processes.
+ */
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+/**
+ * Resolve the full path of a command using 'which' and resolve any symlinks
+ * Returns the full path if found, or the original command if not found
+ * (letting the spawn fail with a clearer error)
+ */
+export function resolveCommand(command) {
+    // If already an absolute path, just resolve symlinks
+    if (command.startsWith('/')) {
+        return resolveSymlinks(command);
+    }
+    try {
+        const output = execSync(`which ${command}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            // Ensure we have a reasonable PATH
+            env: {
+                ...process.env,
+                PATH: process.env.PATH || '/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin',
+            },
+        });
+        const resolvedPath = output.trim();
+        if (resolvedPath) {
+            // Resolve any symlinks to get the actual binary path
+            // This fixes posix_spawnp issues with symlinked binaries
+            return resolveSymlinks(resolvedPath);
+        }
+    }
+    catch (err) {
+        // Command not found in PATH - log for debugging
+        console.warn(`[command-resolver] 'which ${command}' failed:`, err.message?.split('\n')[0] || 'unknown error');
+    }
+    // Return original command - spawn will fail with a clearer error
+    return command;
+}
+/**
+ * Resolve symlinks to get the actual file path
+ * Uses fs.realpathSync which handles all symlink levels
+ */
+function resolveSymlinks(filePath) {
+    try {
+        const resolved = fs.realpathSync(filePath);
+        // Debug log only - symlink resolution is noisy
+        if (resolved !== filePath && process.env.DEBUG_SPAWN === '1') {
+            console.log(`[command-resolver] Resolved symlink: ${filePath} -> ${resolved}`);
+        }
+        return resolved;
+    }
+    catch (err) {
+        // If realpath fails, return original (spawn will give clearer error)
+        // Only warn in debug mode - this is common and not actionable
+        if (process.env.DEBUG_SPAWN === '1') {
+            console.warn(`[command-resolver] realpath failed for ${filePath}:`, err.message);
+        }
+        return filePath;
+    }
+}
+/**
+ * Check if a command exists in PATH
+ */
+export function commandExists(command) {
+    try {
+        execSync(`which ${command}`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=command-resolver.js.map

package/dist/command-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-resolver.js","sourceRoot":"","sources":["../src/command-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,qDAAqD;IACrD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,OAAO,EAAE,EAAE;YAC1C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,mCAAmC;YACnC,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,gDAAgD;aAC3E;SACF,CAAC,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,YAAY,EAAE,CAAC;YACjB,qDAAqD;YACrD,yDAAyD;YACzD,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,gDAAgD;QAChD,OAAO,CAAC,IAAI,CAAC,6BAA6B,OAAO,WAAW,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC;IAChH,CAAC;IAED,iEAAiE;IACjE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,+CAA+C;QAC/C,IAAI,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,EAAE,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,wCAAwC,QAAQ,OAAO,QAAQ,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,qEAAqE;QACrE,8DAA8D;QAC9D,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,GAAG,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,0CAA0C,QAAQ,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,IAAI,CAAC;QACH,QAAQ,CAAC,SAAS,OAAO,EAAE,EAAE;YAC3B,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/error-tracking.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Error Tracking Utilities
+ *
+ * Provides traceable error IDs that users can report to support.
+ * Support can then search logs for the error ID to find full context.
+ *
+ * Error ID format: ERR-{timestamp}-{random}
+ * Example: ERR-1706012345-a7f3
+ *
+ * Usage:
+ *   const error = createTraceableError('Failed to spawn agent', { agentName, cli });
+ *   console.error(error.logMessage); // Full details for logs
+ *   return { error: error.userMessage }; // Safe message with ID for user
+ */
+export interface TraceableError {
+    /** Unique error ID for support lookup (e.g., ERR-1706012345-a7f3) */
+    errorId: string;
+    /** User-facing message with error ID (safe to display) */
+    userMessage: string;
+    /** Full log message with all context (for server logs) */
+    logMessage: string;
+    /** ISO timestamp when error occurred */
+    timestamp: string;
+    /** Original error message */
+    message: string;
+    /** Additional context data */
+    context: Record<string, unknown>;
+}
+/**
+ * Generate a unique error ID.
+ * Format: ERR-{unix_timestamp}-{4_random_hex_chars}
+ */
+export declare function generateErrorId(): string;
+/**
+ * Create a traceable error with ID for support lookup.
+ *
+ * @param message - Human-readable error description
+ * @param context - Additional context (agentName, workspaceId, etc.)
+ * @param originalError - Original error object if wrapping
+ * @returns TraceableError with ID, user message, and log message
+ *
+ * @example
+ * ```typescript
+ * const error = createTraceableError('Failed to spawn agent', {
+ *   agentName: 'Worker1',
+ *   cli: 'claude',
+ *   reason: 'timeout'
+ * });
+ *
+ * // Log full details for support
+ * console.error(error.logMessage);
+ * // => [ERR-1706012345-a7f3] Failed to spawn agent | agentName=Worker1 cli=claude reason=timeout
+ *
+ * // Return safe message to user
+ * res.status(500).json({ error: error.userMessage });
+ * // => "Failed to spawn agent (Error ID: ERR-1706012345-a7f3 - share this with support)"
+ * ```
+ */
+export declare function createTraceableError(message: string, context?: Record<string, unknown>, originalError?: Error): TraceableError;
+/**
+ * Log a traceable error and return user-safe response.
+ * Convenience wrapper that logs and returns in one call.
+ *
+ * @example
+ * ```typescript
+ * const { userMessage, errorId } = logAndTraceError(
+ *   'Workspace creation failed',
+ *   { workspaceId, userId },
+ *   err
+ * );
+ * res.status(500).json({ error: userMessage, errorId });
+ * ```
+ */
+export declare function logAndTraceError(message: string, context?: Record<string, unknown>, originalError?: Error): TraceableError;
+/**
+ * Wrap an async function to automatically trace errors.
+ * Useful for API handlers.
+ *
+ * @example
+ * ```typescript
+ * app.post('/api/spawn', withErrorTracing(async (req, res) => {
+ *   // ... handler code
+ *   // Errors automatically get traced
+ * }, { endpoint: '/api/spawn' }));
+ * ```
+ */
+export declare function withErrorTracing<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, baseContext?: Record<string, unknown>): T;
+/**
+ * Error class that includes trace information.
+ * Thrown by withErrorTracing wrapper.
+ */
+export declare class TracedError extends Error {
+    readonly errorId: string;
+    readonly userMessage: string;
+    readonly context: Record<string, unknown>;
+    constructor(traced: TraceableError);
+}
+/**
+ * Search hint for support: how to find errors in logs.
+ * Include this in documentation or support portal.
+ */
+export declare const ERROR_SEARCH_HINT = "\nTo find error details in logs, search for the error ID:\n\n  grep \"ERR-1706012345-a7f3\" /var/log/agent-relay/*.log\n\nOr in cloud logging:\n\n  fly logs -a agent-relay-cloud | grep \"ERR-1706012345-a7f3\"\n\nThe log entry will include full context: user ID, workspace ID, agent name, etc.\n";
+//# sourceMappingURL=error-tracking.d.ts.map

package/dist/error-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracking.d.ts","sourceRoot":"","sources":["../src/error-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,aAAa,CAAC,EAAE,KAAK,GACpB,cAAc,CA6BhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,aAAa,CAAC,EAAE,KAAK,GACpB,cAAc,CAIhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACjF,EAAE,EAAE,CAAC,EACL,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACxC,CAAC,CAaH;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAErC,MAAM,EAAE,cAAc;CAOnC;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2SAU7B,CAAC"}

package/dist/error-tracking.js

@@ -0,0 +1,149 @@
+/**
+ * Error Tracking Utilities
+ *
+ * Provides traceable error IDs that users can report to support.
+ * Support can then search logs for the error ID to find full context.
+ *
+ * Error ID format: ERR-{timestamp}-{random}
+ * Example: ERR-1706012345-a7f3
+ *
+ * Usage:
+ *   const error = createTraceableError('Failed to spawn agent', { agentName, cli });
+ *   console.error(error.logMessage); // Full details for logs
+ *   return { error: error.userMessage }; // Safe message with ID for user
+ */
+import { randomBytes } from 'node:crypto';
+/**
+ * Generate a unique error ID.
+ * Format: ERR-{unix_timestamp}-{4_random_hex_chars}
+ */
+export function generateErrorId() {
+    const timestamp = Math.floor(Date.now() / 1000);
+    const random = randomBytes(2).toString('hex');
+    return `ERR-${timestamp}-${random}`;
+}
+/**
+ * Create a traceable error with ID for support lookup.
+ *
+ * @param message - Human-readable error description
+ * @param context - Additional context (agentName, workspaceId, etc.)
+ * @param originalError - Original error object if wrapping
+ * @returns TraceableError with ID, user message, and log message
+ *
+ * @example
+ * ```typescript
+ * const error = createTraceableError('Failed to spawn agent', {
+ *   agentName: 'Worker1',
+ *   cli: 'claude',
+ *   reason: 'timeout'
+ * });
+ *
+ * // Log full details for support
+ * console.error(error.logMessage);
+ * // => [ERR-1706012345-a7f3] Failed to spawn agent | agentName=Worker1 cli=claude reason=timeout
+ *
+ * // Return safe message to user
+ * res.status(500).json({ error: error.userMessage });
+ * // => "Failed to spawn agent (Error ID: ERR-1706012345-a7f3 - share this with support)"
+ * ```
+ */
+export function createTraceableError(message, context = {}, originalError) {
+    const errorId = generateErrorId();
+    const timestamp = new Date().toISOString();
+    // Build context string for logging
+    const contextPairs = Object.entries(context)
+        .filter(([, v]) => v !== undefined && v !== null)
+        .map(([k, v]) => `${k}=${typeof v === 'object' ? JSON.stringify(v) : v}`)
+        .join(' ');
+    // Include original error stack if available
+    const stackInfo = originalError?.stack
+        ? `\n  Original error: ${originalError.message}\n  Stack: ${originalError.stack}`
+        : '';
+    const logMessage = `[${errorId}] ${message}${contextPairs ? ` | ${contextPairs}` : ''}${stackInfo}`;
+    const userMessage = `${message} (Error ID: ${errorId} - share this with support)`;
+    return {
+        errorId,
+        userMessage,
+        logMessage,
+        timestamp,
+        message,
+        context: {
+            ...context,
+            originalError: originalError?.message,
+        },
+    };
+}
+/**
+ * Log a traceable error and return user-safe response.
+ * Convenience wrapper that logs and returns in one call.
+ *
+ * @example
+ * ```typescript
+ * const { userMessage, errorId } = logAndTraceError(
+ *   'Workspace creation failed',
+ *   { workspaceId, userId },
+ *   err
+ * );
+ * res.status(500).json({ error: userMessage, errorId });
+ * ```
+ */
+export function logAndTraceError(message, context = {}, originalError) {
+    const error = createTraceableError(message, context, originalError);
+    console.error(error.logMessage);
+    return error;
+}
+/**
+ * Wrap an async function to automatically trace errors.
+ * Useful for API handlers.
+ *
+ * @example
+ * ```typescript
+ * app.post('/api/spawn', withErrorTracing(async (req, res) => {
+ *   // ... handler code
+ *   // Errors automatically get traced
+ * }, { endpoint: '/api/spawn' }));
+ * ```
+ */
+export function withErrorTracing(fn, baseContext = {}) {
+    return (async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (err) {
+            const error = logAndTraceError(err instanceof Error ? err.message : 'Unknown error', baseContext, err instanceof Error ? err : undefined);
+            throw new TracedError(error);
+        }
+    });
+}
+/**
+ * Error class that includes trace information.
+ * Thrown by withErrorTracing wrapper.
+ */
+export class TracedError extends Error {
+    errorId;
+    userMessage;
+    context;
+    constructor(traced) {
+        super(traced.message);
+        this.name = 'TracedError';
+        this.errorId = traced.errorId;
+        this.userMessage = traced.userMessage;
+        this.context = traced.context;
+    }
+}
+/**
+ * Search hint for support: how to find errors in logs.
+ * Include this in documentation or support portal.
+ */
+export const ERROR_SEARCH_HINT = `
+To find error details in logs, search for the error ID:
+
+  grep "ERR-1706012345-a7f3" /var/log/agent-relay/*.log
+
+Or in cloud logging:
+
+  fly logs -a agent-relay-cloud | grep "ERR-1706012345-a7f3"
+
+The log entry will include full context: user ID, workspace ID, agent name, etc.
+`;
+//# sourceMappingURL=error-tracking.js.map

package/dist/error-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-tracking.js","sourceRoot":"","sources":["../src/error-tracking.ts"],"names":[],"mappings":"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"}

package/dist/git-remote.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Git Remote Detection Utility
+ *
+ * Detects the git remote URL from a working directory and parses it
+ * to extract the repository full name (owner/repo).
+ */
+/**
+ * Parse a git remote URL to extract owner/repo format.
+ *
+ * Supports:
+ * - git@github.com:owner/repo.git
+ * - https://github.com/owner/repo.git
+ * - https://github.com/owner/repo
+ * - git://github.com/owner/repo.git
+ */
+export declare function parseGitRemoteUrl(url: string): string | null;
+/**
+ * Get the git remote URL from a directory.
+ *
+ * @param workingDirectory The directory to check for git remote
+ * @param remoteName The remote name to use (default: 'origin')
+ * @returns The remote URL or null if not found
+ */
+export declare function getGitRemoteUrl(workingDirectory: string, remoteName?: string): string | null;
+/**
+ * Get the repository full name (owner/repo) from a working directory.
+ *
+ * @param workingDirectory The directory to check
+ * @returns The repo full name (e.g., "AgentWorkforce/relay") or null
+ */
+export declare function getRepoFullName(workingDirectory: string): string | null;
+/**
+ * Find the git root directory from a given path.
+ * Walks up the directory tree looking for .git folder.
+ *
+ * @param startPath The path to start searching from
+ * @returns The git root directory or null if not in a git repo
+ */
+export declare function findGitRoot(startPath: string): string | null;
+/**
+ * Get repository full name, walking up to find git root if needed.
+ *
+ * @param workingDirectory The directory to start from
+ * @returns The repo full name or null
+ */
+export declare function getRepoFullNameFromPath(workingDirectory: string): string | null;
+//# sourceMappingURL=git-remote.d.ts.map

package/dist/git-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-remote.d.ts","sourceRoot":"","sources":["../src/git-remote.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB5D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,SAAW,GAAG,MAAM,GAAG,IAAI,CAuC9F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOvE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc/E"}

package/dist/git-remote.js

@@ -0,0 +1,125 @@
+/**
+ * Git Remote Detection Utility
+ *
+ * Detects the git remote URL from a working directory and parses it
+ * to extract the repository full name (owner/repo).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+/**
+ * Parse a git remote URL to extract owner/repo format.
+ *
+ * Supports:
+ * - git@github.com:owner/repo.git
+ * - https://github.com/owner/repo.git
+ * - https://github.com/owner/repo
+ * - git://github.com/owner/repo.git
+ */
+export function parseGitRemoteUrl(url) {
+    if (!url)
+        return null;
+    // SSH format: git@github.com:owner/repo.git
+    const sshMatch = url.match(/git@[^:]+:([^/]+\/[^/]+?)(?:\.git)?$/);
+    if (sshMatch) {
+        return sshMatch[1];
+    }
+    // HTTPS/Git format: https://github.com/owner/repo.git
+    const httpsMatch = url.match(/(?:https?|git):\/\/[^/]+\/([^/]+\/[^/]+?)(?:\.git)?$/);
+    if (httpsMatch) {
+        return httpsMatch[1];
+    }
+    return null;
+}
+/**
+ * Get the git remote URL from a directory.
+ *
+ * @param workingDirectory The directory to check for git remote
+ * @param remoteName The remote name to use (default: 'origin')
+ * @returns The remote URL or null if not found
+ */
+export function getGitRemoteUrl(workingDirectory, remoteName = 'origin') {
+    try {
+        // First check if it's a git repository
+        const gitDir = path.join(workingDirectory, '.git');
+        if (!fs.existsSync(gitDir)) {
+            return null;
+        }
+        // Try to get the remote URL using git command
+        const result = execSync(`git remote get-url ${remoteName}`, {
+            cwd: workingDirectory,
+            encoding: 'utf-8',
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim() || null;
+    }
+    catch {
+        // Git command failed - try parsing .git/config directly
+        try {
+            const configPath = path.join(workingDirectory, '.git', 'config');
+            if (!fs.existsSync(configPath)) {
+                return null;
+            }
+            const config = fs.readFileSync(configPath, 'utf-8');
+            // Parse git config to find remote URL
+            const remoteSection = new RegExp(`\\[remote\\s+"${remoteName}"\\][^\\[]*url\\s*=\\s*([^\\n]+)`, 'i');
+            const match = config.match(remoteSection);
+            return match?.[1]?.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Get the repository full name (owner/repo) from a working directory.
+ *
+ * @param workingDirectory The directory to check
+ * @returns The repo full name (e.g., "AgentWorkforce/relay") or null
+ */
+export function getRepoFullName(workingDirectory) {
+    const remoteUrl = getGitRemoteUrl(workingDirectory);
+    if (!remoteUrl) {
+        return null;
+    }
+    return parseGitRemoteUrl(remoteUrl);
+}
+/**
+ * Find the git root directory from a given path.
+ * Walks up the directory tree looking for .git folder.
+ *
+ * @param startPath The path to start searching from
+ * @returns The git root directory or null if not in a git repo
+ */
+export function findGitRoot(startPath) {
+    let currentPath = path.resolve(startPath);
+    const root = path.parse(currentPath).root;
+    while (currentPath !== root) {
+        if (fs.existsSync(path.join(currentPath, '.git'))) {
+            return currentPath;
+        }
+        currentPath = path.dirname(currentPath);
+    }
+    return null;
+}
+/**
+ * Get repository full name, walking up to find git root if needed.
+ *
+ * @param workingDirectory The directory to start from
+ * @returns The repo full name or null
+ */
+export function getRepoFullNameFromPath(workingDirectory) {
+    // First try the exact directory
+    let repoName = getRepoFullName(workingDirectory);
+    if (repoName) {
+        return repoName;
+    }
+    // Walk up to find git root
+    const gitRoot = findGitRoot(workingDirectory);
+    if (gitRoot && gitRoot !== workingDirectory) {
+        repoName = getRepoFullName(gitRoot);
+    }
+    return repoName;
+}
+//# sourceMappingURL=git-remote.js.map

package/dist/git-remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-remote.js","sourceRoot":"","sources":["../src/git-remote.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './name-generator.js';
+export * from './logger.js';
+export * from './precompiled-patterns.js';
+export * from './command-resolver.js';
+export * from './git-remote.js';
+export * from './update-checker.js';
+export * from './error-tracking.js';
+export * from './model-mapping.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './name-generator.js';
+export * from './logger.js';
+export * from './precompiled-patterns.js';
+export * from './command-resolver.js';
+export * from './git-remote.js';
+export * from './update-checker.js';
+export * from './error-tracking.js';
+export * from './model-mapping.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Lightweight DIY Logger for Agent Relay
+ *
+ * Minimal logging utility (~50 lines) with:
+ * - JSON output for easy parsing with jq
+ * - Configurable via environment variables
+ * - Debug-only verbose logging
+ * - No external dependencies
+ */
+export type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+/**
+ * Create a logger for a specific component.
+ * @param component - Component name (e.g., 'daemon', 'router', 'connection')
+ */
+export declare function createLogger(component: string): {
+    debug: (msg: string, extra?: Record<string, unknown>) => void;
+    info: (msg: string, extra?: Record<string, unknown>) => void;
+    warn: (msg: string, extra?: Record<string, unknown>) => void;
+    error: (msg: string, extra?: Record<string, unknown>) => void;
+};
+export declare const daemonLog: {
+    debug: (msg: string, extra?: Record<string, unknown>) => void;
+    info: (msg: string, extra?: Record<string, unknown>) => void;
+    warn: (msg: string, extra?: Record<string, unknown>) => void;
+    error: (msg: string, extra?: Record<string, unknown>) => void;
+};
+export declare const routerLog: {
+    debug: (msg: string, extra?: Record<string, unknown>) => void;
+    info: (msg: string, extra?: Record<string, unknown>) => void;
+    warn: (msg: string, extra?: Record<string, unknown>) => void;
+    error: (msg: string, extra?: Record<string, unknown>) => void;
+};
+export declare const connectionLog: {
+    debug: (msg: string, extra?: Record<string, unknown>) => void;
+    info: (msg: string, extra?: Record<string, unknown>) => void;
+    warn: (msg: string, extra?: Record<string, unknown>) => void;
+    error: (msg: string, extra?: Record<string, unknown>) => void;
+};
+export default createLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAwE3D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM;iBAE7B,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACxC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACvC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACtC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAEvD;AAGD,eAAO,MAAM,SAAS;iBARL,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACxC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACvC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACtC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKT,CAAC;AAChD,eAAO,MAAM,SAAS;iBATL,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACxC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACvC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACtC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMT,CAAC;AAChD,eAAO,MAAM,aAAa;iBAVT,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACxC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBACvC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;iBACtC,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOD,CAAC;AAGxD,eAAe,YAAY,CAAC"}