@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/health/server.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Health check HTTP server.
+ * Provides /health endpoint for container orchestration.
+ */
+import { type Server } from 'node:http';
+/**
+ * Health status response
+ */
+export interface HealthStatus {
+    /** Overall status */
+    status: 'healthy' | 'busy' | 'unhealthy';
+    /** Uptime in milliseconds */
+    uptime?: number;
+    /** Last heartbeat timestamp */
+    lastHeartbeat?: string;
+    /** Currently executing job ID */
+    currentJob?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Health server options
+ */
+export interface HealthServerOptions {
+    /** Port to listen on */
+    port: number;
+    /** Host to bind to */
+    host?: string;
+    /** Function to get current health status */
+    getStatus: () => HealthStatus;
+}
+/**
+ * Health check HTTP server
+ */
+export interface HealthServer {
+    /** Start listening */
+    listen(): void;
+    /** Stop the server */
+    close(): void;
+    /** Get the underlying HTTP server */
+    getServer(): Server;
+}
+/**
+ * Create a health check HTTP server
+ */
+export declare function createHealthServer(options: HealthServerOptions): HealthServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/health/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/health/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;IAEzC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,YAAY,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,MAAM,IAAI,IAAI,CAAC;IAEf,sBAAsB;IACtB,KAAK,IAAI,IAAI,CAAC;IAEd,qCAAqC;IACrC,SAAS,IAAI,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAqF7E"}

package/dist/health/server.js

@@ -0,0 +1,92 @@
+/**
+ * Health check HTTP server.
+ * Provides /health endpoint for container orchestration.
+ */
+import { createServer } from 'node:http';
+/**
+ * Create a health check HTTP server
+ */
+export function createHealthServer(options) {
+    const { port, host = '0.0.0.0', getStatus } = options;
+    const server = createServer((req, res) => {
+        // Only handle GET /health
+        if (req.method === 'GET' && (req.url === '/health' || req.url === '/health/')) {
+            try {
+                const status = getStatus();
+                const statusCode = status.status === 'unhealthy' ? 503 : 200;
+                res.writeHead(statusCode, {
+                    'Content-Type': 'application/json',
+                    'Cache-Control': 'no-cache, no-store, must-revalidate',
+                });
+                res.end(JSON.stringify({
+                    ...status,
+                    timestamp: new Date().toISOString(),
+                }));
+            }
+            catch (error) {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    status: 'unhealthy',
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    timestamp: new Date().toISOString(),
+                }));
+            }
+        }
+        else if (req.method === 'GET' && (req.url === '/ready' || req.url === '/ready/')) {
+            // Readiness probe - same as health for now
+            try {
+                const status = getStatus();
+                const statusCode = status.status === 'unhealthy' ? 503 : 200;
+                res.writeHead(statusCode, {
+                    'Content-Type': 'application/json',
+                    'Cache-Control': 'no-cache, no-store, must-revalidate',
+                });
+                res.end(JSON.stringify({
+                    ready: status.status !== 'unhealthy',
+                    timestamp: new Date().toISOString(),
+                }));
+            }
+            catch (error) {
+                res.writeHead(503, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    ready: false,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    timestamp: new Date().toISOString(),
+                }));
+            }
+        }
+        else if (req.method === 'GET' && (req.url === '/live' || req.url === '/live/')) {
+            // Liveness probe - always return OK if server is running
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'Cache-Control': 'no-cache, no-store, must-revalidate',
+            });
+            res.end(JSON.stringify({
+                alive: true,
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            // Not found
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                error: 'Not found',
+                path: req.url,
+            }));
+        }
+    });
+    return {
+        listen() {
+            server.listen(port, host, () => {
+                console.log(`Health server listening on ${host}:${port}`);
+            });
+        },
+        close() {
+            server.close();
+        },
+        getServer() {
+            return server;
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/health/server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @generacy-ai/generacy
+ *
+ * Headless CLI and library for running Generacy workflows.
+ * Provides orchestrator integration, agency support, and workflow execution.
+ */
+export { OrchestratorClient, OrchestratorClientError, HeartbeatManager, JobHandler, } from './orchestrator/index.js';
+export type { OrchestratorClientOptions, HeartbeatManagerOptions, WorkerStatus, JobHandlerOptions, Job, JobStatus, JobPriority, JobResult, WorkerRegistration, Heartbeat, HeartbeatResponse, PollResponse, OrchestratorError, } from './orchestrator/index.js';
+export { createAgencyConnection, SubprocessAgency, NetworkAgency, } from './agency/index.js';
+export type { AgencyMode, AgencyConnection, AgencyConnectionOptions, ToolCallRequest, ToolCallResponse, SubprocessAgencyOptions, NetworkAgencyOptions, } from './agency/index.js';
+export { createHealthServer } from './health/server.js';
+export type { HealthStatus, HealthServerOptions, HealthServer } from './health/server.js';
+export { createLogger, getLogger, setLogger, createWorkflowLogger, PinoWorkflowLogger } from './cli/utils/logger.js';
+export type { LogLevel, LoggerOptions } from './cli/utils/logger.js';
+export { resolveConfig, validateConfig, createConfig } from './cli/utils/config.js';
+export type { CLIConfig } from './cli/utils/config.js';
+export { createProgram, run } from './cli/index.js';
+export { ProjectConfigSchema, ReposConfigSchema, DefaultsConfigSchema, OrchestratorSettingsSchema, GeneracyConfigSchema, validateConfig as validateGeneracyConfig, ConfigValidationError, validateNoDuplicateRepos, validateSemantics, loadConfig, findConfigFile, parseConfig, ConfigNotFoundError, ConfigParseError, ConfigSchemaError, } from './config/index.js';
+export type { ProjectConfig, ReposConfig, DefaultsConfig, OrchestratorSettings, GeneracyConfig, LoadConfigOptions, } from './config/index.js';
+export * from '@generacy-ai/workflow-engine';
+//# 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;;;;;GAKG;AAGH,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,SAAS,EACT,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG1F,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACrH,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,IAAI,sBAAsB,EACxC,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @generacy-ai/generacy
+ *
+ * Headless CLI and library for running Generacy workflows.
+ * Provides orchestrator integration, agency support, and workflow execution.
+ */
+// Orchestrator client
+export { OrchestratorClient, OrchestratorClientError, HeartbeatManager, JobHandler, } from './orchestrator/index.js';
+// Agency integration
+export { createAgencyConnection, SubprocessAgency, NetworkAgency, } from './agency/index.js';
+// Health server
+export { createHealthServer } from './health/server.js';
+// CLI utilities
+export { createLogger, getLogger, setLogger, createWorkflowLogger, PinoWorkflowLogger } from './cli/utils/logger.js';
+export { resolveConfig, validateConfig, createConfig } from './cli/utils/config.js';
+// CLI entry point (for programmatic use)
+export { createProgram, run } from './cli/index.js';
+// Config schema and validation
+export { ProjectConfigSchema, ReposConfigSchema, DefaultsConfigSchema, OrchestratorSettingsSchema, GeneracyConfigSchema, validateConfig as validateGeneracyConfig, ConfigValidationError, validateNoDuplicateRepos, validateSemantics, loadConfig, findConfigFile, parseConfig, ConfigNotFoundError, ConfigParseError, ConfigSchemaError, } from './config/index.js';
+// Re-export workflow engine
+export * from '@generacy-ai/workflow-engine';
+//# 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;;;;;GAKG;AAEH,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAkBjC,qBAAqB;AACrB,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAY3B,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGrH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGpF,yCAAyC;AACzC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAEpD,+BAA+B;AAC/B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,IAAI,sBAAsB,EACxC,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAW3B,4BAA4B;AAC5B,cAAc,8BAA8B,CAAC"}

package/dist/orchestrator/async-event-queue.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Bounded async queue that posts events to the orchestrator.
+ * Fire-and-forget: drops oldest events on overflow, never blocks the caller.
+ */
+export declare class AsyncEventQueue {
+    private queue;
+    private processing;
+    private readonly maxSize;
+    private readonly postFn;
+    constructor(postFn: (jobId: string, event: object) => Promise<void>, maxSize?: number);
+    /**
+     * Enqueue an event for async posting.
+     * Drops the oldest event if the queue is at capacity.
+     * Triggers async processing without blocking the caller.
+     */
+    push(jobId: string, event: object): void;
+    /**
+     * Process queued items sequentially.
+     * Silently drops events that fail to post (non-critical telemetry).
+     * Re-entrant guard ensures only one processing loop runs at a time.
+     */
+    private processQueue;
+    /**
+     * Drain all pending events. Use for graceful shutdown.
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=async-event-queue.d.ts.map

package/dist/orchestrator/async-event-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-event-queue.d.ts","sourceRoot":"","sources":["../../src/orchestrator/async-event-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;gBAGvE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EACvD,OAAO,SAAM;IAMf;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQxC;;;;OAIG;YACW,YAAY;IAiB1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/orchestrator/async-event-queue.js

@@ -0,0 +1,57 @@
+/**
+ * Bounded async queue that posts events to the orchestrator.
+ * Fire-and-forget: drops oldest events on overflow, never blocks the caller.
+ */
+export class AsyncEventQueue {
+    queue = [];
+    processing = false;
+    maxSize;
+    postFn;
+    constructor(postFn, maxSize = 100) {
+        this.postFn = postFn;
+        this.maxSize = maxSize;
+    }
+    /**
+     * Enqueue an event for async posting.
+     * Drops the oldest event if the queue is at capacity.
+     * Triggers async processing without blocking the caller.
+     */
+    push(jobId, event) {
+        if (this.queue.length >= this.maxSize) {
+            this.queue.shift();
+        }
+        this.queue.push({ jobId, event });
+        void this.processQueue();
+    }
+    /**
+     * Process queued items sequentially.
+     * Silently drops events that fail to post (non-critical telemetry).
+     * Re-entrant guard ensures only one processing loop runs at a time.
+     */
+    async processQueue() {
+        if (this.processing)
+            return;
+        this.processing = true;
+        try {
+            while (this.queue.length > 0) {
+                const item = this.queue.shift();
+                try {
+                    await this.postFn(item.jobId, item.event);
+                }
+                catch {
+                    // Silently drop failed events — non-critical telemetry
+                }
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    /**
+     * Drain all pending events. Use for graceful shutdown.
+     */
+    async flush() {
+        await this.processQueue();
+    }
+}
+//# sourceMappingURL=async-event-queue.js.map

package/dist/orchestrator/async-event-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-event-queue.js","sourceRoot":"","sources":["../../src/orchestrator/async-event-queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,KAAK,GAA4C,EAAE,CAAC;IACpD,UAAU,GAAG,KAAK,CAAC;IACV,OAAO,CAAS;IAChB,MAAM,CAAkD;IAEzE,YACE,MAAuD,EACvD,OAAO,GAAG,GAAG;QAEb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAa,EAAE,KAAa;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,uDAAuD;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/orchestrator/client.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Orchestrator REST client.
+ * Handles communication with the orchestrator service.
+ */
+import type { Job, JobEvent, JobResult, JobEventType, EventFilters, WorkerRegistration, Heartbeat, HeartbeatResponse, PollResponse } from './types.js';
+/**
+ * Client options
+ */
+export interface OrchestratorClientOptions {
+    /** Base URL of the orchestrator service */
+    baseUrl: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Authentication token */
+    authToken?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+}
+/**
+ * REST client for orchestrator communication
+ */
+export declare class OrchestratorClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly authToken?;
+    private readonly customHeaders;
+    constructor(options: OrchestratorClientOptions);
+    /**
+     * Make an HTTP request to the orchestrator
+     */
+    private request;
+    /**
+     * Register worker with orchestrator
+     */
+    register(registration: WorkerRegistration): Promise<{
+        workerId: string;
+    }>;
+    /**
+     * Unregister worker from orchestrator
+     */
+    unregister(workerId: string): Promise<void>;
+    /**
+     * Send heartbeat to orchestrator
+     */
+    heartbeat(data: Heartbeat): Promise<HeartbeatResponse>;
+    /**
+     * Poll for available jobs
+     */
+    pollForJob(workerId: string, capabilities?: string[]): Promise<PollResponse>;
+    /**
+     * Update job status
+     */
+    updateJobStatus(jobId: string, status: Job['status'], metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Report job result
+     */
+    reportJobResult(result: JobResult): Promise<void>;
+    /**
+     * Get job details
+     */
+    getJob(jobId: string): Promise<Job>;
+    /**
+     * Cancel a job
+     */
+    cancelJob(jobId: string, reason?: string): Promise<void>;
+    /**
+     * Publish an event for a job
+     */
+    publishEvent(jobId: string, event: {
+        type: JobEventType;
+        data: Record<string, unknown>;
+        timestamp?: number;
+    }): Promise<{
+        eventId: string;
+    }>;
+    /**
+     * Subscribe to SSE events for a specific job.
+     * Returns an AsyncIterable that yields parsed JobEvent objects.
+     * The stream can be cancelled via AbortSignal or by breaking out of the for-await loop.
+     */
+    subscribeEvents(jobId: string, options?: {
+        lastEventId?: string;
+        signal?: AbortSignal;
+    }): AsyncGenerator<JobEvent, void, undefined>;
+    /**
+     * Subscribe to SSE events for all jobs, optionally filtered.
+     * Returns an AsyncIterable that yields parsed JobEvent objects.
+     * The stream can be cancelled via AbortSignal or by breaking out of the for-await loop.
+     */
+    subscribeAllEvents(options?: {
+        filters?: EventFilters;
+        lastEventId?: string;
+        signal?: AbortSignal;
+    }): AsyncGenerator<JobEvent, void, undefined>;
+    /**
+     * Parse an SSE response stream into JobEvent objects.
+     * Handles `event:`, `id:`, `data:` fields and skips comment lines (heartbeats).
+     */
+    private parseSSEStream;
+}
+/**
+ * Error class for orchestrator client errors
+ */
+export declare class OrchestratorClientError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, statusCode: number, details?: Record<string, unknown> | undefined);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/orchestrator/client.d.ts.map

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