buildhive-agent 1.0.0-beta.1

package/README.md

@@ -0,0 +1,166 @@
+# BuildHive Agent
+
+The BuildHive Agent is a lightweight service that runs on developer machines to execute CI/CD build jobs in a secure, isolated environment.
+
+## Configuration
+
+The agent uses a hierarchical configuration system that loads settings from:
+
+1. Default configuration values
+2. Configuration files (JSON format)
+3. Environment variable overrides
+
+### Configuration Files
+
+The agent searches for configuration files in the following locations (in order):
+
+1. `./buildhive-agent.json` (current directory)
+2. `./config/buildhive-agent.json`
+3. `./.config/buildhive-agent.json`
+4. `~/.buildhive/buildhive-agent.json` (user home directory)
+5. `/etc/buildhive/buildhive-agent.json` (system-wide)
+
+Alternative file names are also supported:
+- `buildhive-agent.config.json`
+- `.buildhive-agent.json`
+
+### Environment Variables
+
+All configuration options can be overridden using environment variables:
+
+| Environment Variable | Configuration Field | Type | Example |
+|---------------------|---------------------|------|---------|
+| `BUILDHIVE_PLATFORM_URL` | `platformUrl` | string | `https://api.buildhive.dev` |
+| `BUILDHIVE_API_KEY` | `apiKey` | string | `your-api-key` |
+| `BUILDHIVE_AGENT_ID` | `agentId` | string | `agent-123` |
+| `BUILDHIVE_AGENT_NAME` | `name` | string | `My Agent` |
+| `BUILDHIVE_MAX_CONCURRENT_JOBS` | `maxConcurrentJobs` | number | `2` |
+| `BUILDHIVE_HEARTBEAT_INTERVAL` | `heartbeatInterval` | number | `30` |
+| `BUILDHIVE_TAGS` | `tags` | string (comma-separated) | `android,linux` |
+| `BUILDHIVE_LOG_LEVEL` | `logLevel` | string | `info` |
+| `BUILDHIVE_JOB_TIMEOUT_MINUTES` | `jobTimeoutMinutes` | number | `60` |
+| `BUILDHIVE_ENABLE_METRICS` | `enableMetrics` | boolean | `true` |
+| `BUILDHIVE_ENABLE_AUTO_UPDATES` | `enableAutoUpdates` | boolean | `false` |
+
+### Configuration Schema
+
+#### Required Fields
+
+- `platformUrl`: URL of the BuildHive platform API
+- `apiKey`: Authentication key for the agent
+- `agentId`: Unique identifier for this agent
+- `name`: Human-readable name for the agent
+
+#### Optional Fields
+
+- `maxConcurrentJobs` (default: 1): Maximum number of jobs to run simultaneously
+- `heartbeatInterval` (default: 30): Heartbeat interval in seconds
+- `tags` (default: []): Tags for job matching
+- `logLevel` (default: "info"): Logging level (debug, info, warn, error)
+- `jobTimeoutMinutes` (default: 60): Maximum job execution time
+- `enableMetrics` (default: true): Enable metrics collection
+- `enableAutoUpdates` (default: true): Enable automatic agent updates
+
+#### Docker Configuration
+
+- `dockerConfig.baseImage` (default: "ubuntu:22.04"): Base Docker image
+- `dockerConfig.networkMode` (default: "none"): Network isolation mode
+- `dockerConfig.memoryLimit` (default: "2g"): Memory limit for containers
+- `dockerConfig.cpuLimit` (default: "1.0"): CPU limit for containers
+- `dockerConfig.volumeMounts` (default: []): Volume mount configurations
+
+#### Resource Limits
+
+- `maxMemoryUsage` (default: 80): Maximum memory usage percentage
+- `maxCpuUsage` (default: 80): Maximum CPU usage percentage
+- `maxDiskUsage` (default: 90): Maximum disk usage percentage
+
+#### Security
+
+- `allowedRepositories`: Whitelist of allowed repositories (optional)
+- `blockedRepositories`: Blacklist of blocked repositories (optional)
+
+Note: You cannot specify both `allowedRepositories` and `blockedRepositories`.
+
+### Example Configuration
+
+```json
+{
+  "platformUrl": "https://api.buildhive.dev",
+  "apiKey": "your-api-key-here",
+  "agentId": "agent-unique-id",
+  "name": "My Build Agent",
+  "maxConcurrentJobs": 2,
+  "heartbeatInterval": 30,
+  "tags": ["android", "linux", "docker"],
+  "dockerConfig": {
+    "baseImage": "ubuntu:22.04",
+    "networkMode": "none",
+    "memoryLimit": "4g",
+    "cpuLimit": "2.0",
+    "volumeMounts": [
+      {
+        "hostPath": "/tmp/buildhive-cache",
+        "containerPath": "/cache",
+        "readOnly": false
+      }
+    ]
+  },
+  "maxMemoryUsage": 80,
+  "maxCpuUsage": 75,
+  "maxDiskUsage": 90,
+  "logLevel": "info",
+  "logRetentionDays": 7,
+  "allowedRepositories": [
+    "myorg/repo1",
+    "myorg/repo2"
+  ],
+  "jobTimeoutMinutes": 120,
+  "connectionTimeoutSeconds": 30,
+  "enableMetrics": true,
+  "enableAutoUpdates": true
+}
+```
+
+## Installation
+
+```bash
+npm install
+```
+
+## Development
+
+```bash
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Run tests with coverage
+npm run test:coverage
+
+# Development mode with auto-rebuild
+npm run dev
+```
+
+## Usage
+
+```typescript
+import { loadConfig, saveConfig, validateConfigFile } from '@buildhive/agent';
+
+// Load configuration
+const config = await loadConfig();
+
+// Save configuration
+await saveConfig(config, './my-config.json');
+
+// Validate a configuration file
+const validation = validateConfigFile('./config.json');
+if (!validation.isValid) {
+  console.error('Configuration errors:', validation.errors);
+}
+```

package/dist/__tests__/fakes/FakeDockerManager.d.ts

@@ -0,0 +1,115 @@
+/**
+ * FakeDockerManager — in-memory test double for DockerManager.
+ *
+ * Implements the same public API surface as the real DockerManager
+ * (createContainer, startContainer, executeCommand, stopContainer,
+ * removeContainer, pullImage, copyFromContainer) without touching
+ * the real Docker daemon or the filesystem.
+ *
+ * Usage in tests:
+ *
+ *   const fake = new FakeDockerManager();
+ *   fake.setCommandResult('echo hi', { exitCode: 0, output: 'hi' });
+ *   const id = await fake.createContainer({ image: 'node:20', ... });
+ *   await fake.startContainer(id);
+ *   const result = await fake.executeCommand(id, 'echo hi');
+ *   expect(result.exitCode).toBe(0);
+ */
+import type { ContainerConfig, ExecutionOptions, ExecutionResult } from '../../docker.js';
+type ContainerState = 'created' | 'running' | 'stopped' | 'removed';
+interface ContainerRecord {
+    config: ContainerConfig;
+    state: ContainerState;
+    id: string;
+}
+export interface FakeCommandResult {
+    exitCode: number;
+    output: string;
+    error?: string;
+}
+export declare class FakeDockerManager {
+    private containers;
+    private pulledImages;
+    private commandOverrides;
+    private defaultCommandResult;
+    private copyLog;
+    private idCounter;
+    /**
+     * Override the result returned when executeCommand is called with the exact
+     * command string.  Pass undefined to remove the override.
+     */
+    setCommandResult(command: string, result: FakeCommandResult | undefined): void;
+    /**
+     * Set the result returned by executeCommand when no per-command override
+     * matches.  Defaults to { exitCode: 0, output: '' }.
+     */
+    setDefaultCommandResult(result: FakeCommandResult): void;
+    /**
+     * Reset all internal state (containers, pulled images, overrides, copy log).
+     * Call this in beforeEach to ensure test isolation.
+     */
+    reset(): void;
+    /** Returns true if the container ID is known (not removed). */
+    hasContainer(containerId: string): boolean;
+    /** Returns the state of a container, or undefined if it does not exist. */
+    getContainerState(containerId: string): ContainerState | undefined;
+    /** Returns the config used to create a container, or undefined. */
+    getContainerConfig(containerId: string): ContainerConfig | undefined;
+    /** Returns all containers currently tracked (not yet removed). */
+    getActiveContainers(): ReadonlyMap<string, ContainerRecord>;
+    /** Returns whether an image has been pulled via pullImage(). */
+    isImagePulled(image: string): boolean;
+    /** Returns the log of all copyFromContainer calls in call order. */
+    getCopyLog(): ReadonlyArray<{
+        containerId: string;
+        containerPath: string;
+        hostPath: string;
+    }>;
+    /**
+     * Resolves immediately.  Marks the image as pulled so tests can assert
+     * pullImage() was called.
+     */
+    pullImage(image: string): Promise<void>;
+    /**
+     * Creates an in-memory container record in the 'created' state and returns
+     * its ID.  The ID follows the same "buildhive-<n>" pattern as the real
+     * implementation (predictable in tests).
+     */
+    createContainer(containerConfig: ContainerConfig): Promise<string>;
+    /**
+     * Transitions the container from 'created' to 'running'.
+     * Throws if the container does not exist or is not in 'created' state.
+     */
+    startContainer(containerId: string): Promise<void>;
+    /**
+     * Executes a command against a running container.
+     *
+     * - If a per-command override has been registered via setCommandResult() the
+     *   override result is returned.
+     * - Otherwise the default result (exitCode: 0, output: '') is returned.
+     * - The optional onOutput callback is invoked with the output string when
+     *   output is non-empty, mirroring the streaming behaviour of the real impl.
+     * - Throws if the container is not in 'running' state.
+     */
+    executeCommand(containerId: string, command: string, options?: ExecutionOptions): Promise<ExecutionResult>;
+    /**
+     * Transitions the container to 'stopped' state.
+     * Silently succeeds if the container is already stopped (matches the real
+     * impl's defensive behaviour).
+     */
+    stopContainer(containerId: string, _timeout?: number): Promise<void>;
+    /**
+     * Stops the container (if running) and removes it from the internal map.
+     * Does NOT throw if the container is not found — mirrors the real impl's
+     * "don't throw from cleanup" contract.
+     */
+    removeContainer(containerId: string): Promise<void>;
+    /**
+     * Records the copy operation in the copy log so tests can assert it was
+     * called with the correct paths.  Throws if the container is not running.
+     */
+    copyFromContainer(containerId: string, containerPath: string, hostPath: string): Promise<void>;
+    private requireContainer;
+}
+export {};
+//# sourceMappingURL=FakeDockerManager.d.ts.map

package/dist/__tests__/fakes/FakeDockerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeDockerManager.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fakes/FakeDockerManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAM1F,KAAK,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpE,UAAU,eAAe;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,cAAc,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,iBAAiB;IAE5B,OAAO,CAAC,UAAU,CAAsC;IAGxD,OAAO,CAAC,YAAY,CAAqB;IAKzC,OAAO,CAAC,gBAAgB,CAAwC;IAGhE,OAAO,CAAC,oBAAoB,CAAkD;IAG9E,OAAO,CAAC,OAAO,CAA+E;IAG9F,OAAO,CAAC,SAAS,CAAK;IAMtB;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI;IAQ9E;;;OAGG;IACH,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAIxD;;;OAGG;IACH,KAAK,IAAI,IAAI;IAab,+DAA+D;IAC/D,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI1C,2EAA2E;IAC3E,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIlE,mEAAmE;IACnE,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpE,kEAAkE;IAClE,mBAAmB,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC;IAI3D,gEAAgE;IAChE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIrC,oEAAoE;IACpE,UAAU,IAAI,aAAa,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ7F;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;;OAIG;IACG,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxE;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxD;;;;;;;;;OASG;IACG,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAqB3B;;;;OAIG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1E;;;;OAIG;IACG,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD;;;OAGG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAchB,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/__tests__/fakes/FakeDockerManager.js

@@ -0,0 +1,203 @@
+/**
+ * FakeDockerManager — in-memory test double for DockerManager.
+ *
+ * Implements the same public API surface as the real DockerManager
+ * (createContainer, startContainer, executeCommand, stopContainer,
+ * removeContainer, pullImage, copyFromContainer) without touching
+ * the real Docker daemon or the filesystem.
+ *
+ * Usage in tests:
+ *
+ *   const fake = new FakeDockerManager();
+ *   fake.setCommandResult('echo hi', { exitCode: 0, output: 'hi' });
+ *   const id = await fake.createContainer({ image: 'node:20', ... });
+ *   await fake.startContainer(id);
+ *   const result = await fake.executeCommand(id, 'echo hi');
+ *   expect(result.exitCode).toBe(0);
+ */
+// ---------------------------------------------------------------------------
+// FakeDockerManager
+// ---------------------------------------------------------------------------
+export class FakeDockerManager {
+    // Map of containerId -> record
+    containers = new Map();
+    // Set of images that have been pulled
+    pulledImages = new Set();
+    // Per-command overrides keyed by the command string.
+    // When a command matches a key the configured result is returned;
+    // otherwise the default result is used.
+    commandOverrides = new Map();
+    // Default result returned by executeCommand when no override matches.
+    defaultCommandResult = { exitCode: 0, output: '' };
+    // Track every copy operation for assertion in tests.
+    copyLog = [];
+    // Counter used to generate deterministic container IDs in tests.
+    idCounter = 0;
+    // ---------------------------------------------------------------------------
+    // Configuration helpers (call these from test setup)
+    // ---------------------------------------------------------------------------
+    /**
+     * Override the result returned when executeCommand is called with the exact
+     * command string.  Pass undefined to remove the override.
+     */
+    setCommandResult(command, result) {
+        if (result === undefined) {
+            this.commandOverrides.delete(command);
+        }
+        else {
+            this.commandOverrides.set(command, result);
+        }
+    }
+    /**
+     * Set the result returned by executeCommand when no per-command override
+     * matches.  Defaults to { exitCode: 0, output: '' }.
+     */
+    setDefaultCommandResult(result) {
+        this.defaultCommandResult = result;
+    }
+    /**
+     * Reset all internal state (containers, pulled images, overrides, copy log).
+     * Call this in beforeEach to ensure test isolation.
+     */
+    reset() {
+        this.containers.clear();
+        this.pulledImages.clear();
+        this.commandOverrides.clear();
+        this.copyLog = [];
+        this.idCounter = 0;
+        this.defaultCommandResult = { exitCode: 0, output: '' };
+    }
+    // ---------------------------------------------------------------------------
+    // Inspection helpers (for assertions in tests)
+    // ---------------------------------------------------------------------------
+    /** Returns true if the container ID is known (not removed). */
+    hasContainer(containerId) {
+        return this.containers.has(containerId);
+    }
+    /** Returns the state of a container, or undefined if it does not exist. */
+    getContainerState(containerId) {
+        return this.containers.get(containerId)?.state;
+    }
+    /** Returns the config used to create a container, or undefined. */
+    getContainerConfig(containerId) {
+        return this.containers.get(containerId)?.config;
+    }
+    /** Returns all containers currently tracked (not yet removed). */
+    getActiveContainers() {
+        return this.containers;
+    }
+    /** Returns whether an image has been pulled via pullImage(). */
+    isImagePulled(image) {
+        return this.pulledImages.has(image);
+    }
+    /** Returns the log of all copyFromContainer calls in call order. */
+    getCopyLog() {
+        return this.copyLog;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API — mirrors DockerManager method signatures exactly
+    // ---------------------------------------------------------------------------
+    /**
+     * Resolves immediately.  Marks the image as pulled so tests can assert
+     * pullImage() was called.
+     */
+    async pullImage(image) {
+        this.pulledImages.add(image);
+    }
+    /**
+     * Creates an in-memory container record in the 'created' state and returns
+     * its ID.  The ID follows the same "buildhive-<n>" pattern as the real
+     * implementation (predictable in tests).
+     */
+    async createContainer(containerConfig) {
+        const containerId = `buildhive-fake-${++this.idCounter}`;
+        this.containers.set(containerId, {
+            id: containerId,
+            config: containerConfig,
+            state: 'created',
+        });
+        return containerId;
+    }
+    /**
+     * Transitions the container from 'created' to 'running'.
+     * Throws if the container does not exist or is not in 'created' state.
+     */
+    async startContainer(containerId) {
+        const record = this.requireContainer(containerId);
+        if (record.state !== 'created') {
+            throw new Error(`FakeDockerManager: cannot start container ${containerId} — current state is '${record.state}'`);
+        }
+        record.state = 'running';
+    }
+    /**
+     * Executes a command against a running container.
+     *
+     * - If a per-command override has been registered via setCommandResult() the
+     *   override result is returned.
+     * - Otherwise the default result (exitCode: 0, output: '') is returned.
+     * - The optional onOutput callback is invoked with the output string when
+     *   output is non-empty, mirroring the streaming behaviour of the real impl.
+     * - Throws if the container is not in 'running' state.
+     */
+    async executeCommand(containerId, command, options = {}) {
+        const record = this.requireContainer(containerId);
+        if (record.state !== 'running') {
+            throw new Error(`FakeDockerManager: cannot execute command in container ${containerId} — current state is '${record.state}'`);
+        }
+        const override = this.commandOverrides.get(command);
+        const result = override
+            ? { ...override }
+            : { ...this.defaultCommandResult };
+        // Mirror the real impl: call onOutput if there is output to stream.
+        if (options.onOutput && result.output) {
+            options.onOutput(result.output);
+        }
+        return result;
+    }
+    /**
+     * Transitions the container to 'stopped' state.
+     * Silently succeeds if the container is already stopped (matches the real
+     * impl's defensive behaviour).
+     */
+    async stopContainer(containerId, _timeout) {
+        const record = this.requireContainer(containerId);
+        if (record.state !== 'removed') {
+            record.state = 'stopped';
+        }
+    }
+    /**
+     * Stops the container (if running) and removes it from the internal map.
+     * Does NOT throw if the container is not found — mirrors the real impl's
+     * "don't throw from cleanup" contract.
+     */
+    async removeContainer(containerId) {
+        const record = this.containers.get(containerId);
+        if (!record) {
+            return; // already removed — no-op
+        }
+        record.state = 'removed';
+        this.containers.delete(containerId);
+    }
+    /**
+     * Records the copy operation in the copy log so tests can assert it was
+     * called with the correct paths.  Throws if the container is not running.
+     */
+    async copyFromContainer(containerId, containerPath, hostPath) {
+        const record = this.requireContainer(containerId);
+        if (record.state !== 'running') {
+            throw new Error(`FakeDockerManager: cannot copy from container ${containerId} — current state is '${record.state}'`);
+        }
+        this.copyLog.push({ containerId, containerPath, hostPath });
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    requireContainer(containerId) {
+        const record = this.containers.get(containerId);
+        if (!record) {
+            throw new Error(`FakeDockerManager: container not found: ${containerId}`);
+        }
+        return record;
+    }
+}
+//# sourceMappingURL=FakeDockerManager.js.map

package/dist/__tests__/fakes/FakeDockerManager.js.map

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

package/dist/acceptanceChecker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Acceptance Checker
+ *
+ * Evaluates whether a job should be accepted based on configured
+ * acceptance rules (recipe patterns, repository patterns, duration, Docker).
+ */
+import { AcceptanceRules } from './config/types.js';
+export interface JobCandidate {
+    recipe?: string;
+    repository?: string;
+    estimatedDurationMinutes?: number;
+    requiresDocker?: boolean;
+}
+export interface AcceptanceDecision {
+    accepted: boolean;
+    reason?: string;
+}
+export declare class AcceptanceChecker {
+    private rules;
+    constructor(rules: AcceptanceRules);
+    /**
+     * Check if a job should be accepted based on the configured acceptance rules.
+     */
+    shouldAccept(job: JobCandidate): AcceptanceDecision;
+}
+//# sourceMappingURL=acceptanceChecker.d.ts.map

package/dist/acceptanceChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptanceChecker.d.ts","sourceRoot":"","sources":["../src/acceptanceChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE1C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,kBAAkB;CAqCpD"}

package/dist/acceptanceChecker.js

@@ -0,0 +1,64 @@
+/**
+ * Acceptance Checker
+ *
+ * Evaluates whether a job should be accepted based on configured
+ * acceptance rules (recipe patterns, repository patterns, duration, Docker).
+ */
+/**
+ * Simple glob matcher supporting * and ? wildcards.
+ * Avoids external dependency on minimatch.
+ */
+function globMatch(pattern, value) {
+    // Convert glob to regex
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // escape regex special chars (except * and ?)
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    const regex = new RegExp(`^${escaped}$`, 'i');
+    return regex.test(value);
+}
+function matchesAny(patterns, value) {
+    return patterns.some(p => globMatch(p, value));
+}
+export class AcceptanceChecker {
+    rules;
+    constructor(rules) {
+        this.rules = rules;
+    }
+    /**
+     * Check if a job should be accepted based on the configured acceptance rules.
+     */
+    shouldAccept(job) {
+        // Check blocked recipes first (takes precedence)
+        if (job.recipe && this.rules.blockedRecipes.length > 0) {
+            if (matchesAny(this.rules.blockedRecipes, job.recipe)) {
+                return { accepted: false, reason: `Recipe "${job.recipe}" is blocked` };
+            }
+        }
+        // Check allowed recipes
+        if (job.recipe && this.rules.allowedRecipes.length > 0) {
+            if (!matchesAny(this.rules.allowedRecipes, job.recipe)) {
+                return { accepted: false, reason: `Recipe "${job.recipe}" is not in allowed list` };
+            }
+        }
+        // Check allowed repositories
+        if (job.repository && this.rules.allowedRepositories.length > 0) {
+            if (!matchesAny(this.rules.allowedRepositories, job.repository)) {
+                return { accepted: false, reason: `Repository "${job.repository}" is not in allowed list` };
+            }
+        }
+        // Check max duration
+        if (job.estimatedDurationMinutes !== undefined && job.estimatedDurationMinutes > this.rules.maxJobDurationMinutes) {
+            return {
+                accepted: false,
+                reason: `Estimated duration (${job.estimatedDurationMinutes}m) exceeds max (${this.rules.maxJobDurationMinutes}m)`
+            };
+        }
+        // Check Docker requirement
+        if (this.rules.requireDocker && job.requiresDocker === false) {
+            return { accepted: false, reason: 'Agent requires Docker but job does not use Docker' };
+        }
+        return { accepted: true };
+    }
+}
+//# sourceMappingURL=acceptanceChecker.js.map

package/dist/acceptanceChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptanceChecker.js","sourceRoot":"","sources":["../src/acceptanceChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;GAGG;AACH,SAAS,SAAS,CAAC,OAAe,EAAE,KAAa;IAC/C,wBAAwB;IACxB,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,8CAA8C;SACnF,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,UAAU,CAAC,QAAkB,EAAE,KAAa;IACnD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,OAAO,iBAAiB;IACR;IAApB,YAAoB,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAE9C;;OAEG;IACH,YAAY,CAAC,GAAiB;QAC5B,iDAAiD;QACjD,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,MAAM,cAAc,EAAE,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,MAAM,0BAA0B,EAAE,CAAC;YACtF,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,IAAI,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,GAAG,CAAC,UAAU,0BAA0B,EAAE,CAAC;YAC9F,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,GAAG,CAAC,wBAAwB,KAAK,SAAS,IAAI,GAAG,CAAC,wBAAwB,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,EAAE,CAAC;YAClH,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,uBAAuB,GAAG,CAAC,wBAAwB,mBAAmB,IAAI,CAAC,KAAK,CAAC,qBAAqB,IAAI;aACnH,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,GAAG,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YAC7D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,mDAAmD,EAAE,CAAC;QAC1F,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;CACF"}