@deepnoodle/mobius 0.0.1 → 0.0.3

package/dist/client.d.ts

@@ -1,18 +1,53 @@
 import type { JobClaim, JobClaimRequest, JobCompleteRequest, JobFenceRequest, JobHeartbeat } from "./api/index.js";
+import { RateLimitError } from "./retry.js";
+export { RateLimitError } from "./retry.js";
 export interface ClientOptions {
     apiKey: string;
     baseURL?: string;
-    /** Namespace slug used for all namespace-scoped operations. */
+    /** Project handle used for all project-scoped operations. */
+    project?: string;
+    /** Compatibility alias for older callers. */
     namespace?: string;
     /** Fetch timeout in milliseconds. Defaults to 60_000. */
     timeoutMs?: number;
+    /**
+     * Number of retries for 429/503 responses. Defaults to
+     * {@link DEFAULT_MAX_RETRIES}. Set to 0 to disable retries — 429
+     * responses then surface as {@link RateLimitError} on the first attempt.
+     * See `../../docs/retries.md` for the shared retry policy.
+     */
+    retry?: number;
 }
 export declare const DEFAULT_BASE_URL = "https://api.mobiusops.ai";
+export declare const DEFAULT_PROJECT = "default";
 export declare const DEFAULT_NAMESPACE = "default";
 export declare class LeaseLostError extends Error {
     readonly jobId: string;
     constructor(jobId: string);
 }
+export declare class PayloadTooLargeError extends Error {
+    readonly jobId: string;
+    constructor(jobId: string);
+}
+/**
+ * Legacy per-job rate-limit error raised by {@link Client.emitJobEvents}.
+ * Subclass of {@link RateLimitError} so callers catching the newer,
+ * transport-raised {@link RateLimitError} also catch this. New code
+ * should prefer {@link RateLimitError}.
+ */
+export declare class RateLimitedError extends RateLimitError {
+    readonly jobId: string;
+    constructor(jobId: string, retryAfter?: number);
+}
+export interface JobEventEntry {
+    type: string;
+    payload: Record<string, unknown>;
+}
+export interface JobEventsRequest {
+    worker_id: string;
+    attempt: number;
+    events: JobEventEntry[];
+}
 /**
  * Low-level Mobius runtime API client. Prefer {@link Worker} in worker.ts
  * rather than calling these methods directly.
@@ -23,9 +58,10 @@ export declare class LeaseLostError extends Error {
  */
 export declare class Client {
     private readonly baseURL;
-    private readonly namespace;
+    readonly project: string;
     private readonly headers;
     private readonly timeoutMs;
+    private readonly fetchFn;
     constructor(opts: ClientOptions);
     /**
      * Long-poll for the next claimable job. Returns null when the poll
@@ -36,6 +72,13 @@ export declare class Client {
     heartbeatJob(jobId: string, req: JobFenceRequest): Promise<JobHeartbeat>;
     /** Report the terminal status of a claimed job. */
     completeJob(jobId: string, req: JobCompleteRequest): Promise<void>;
+    emitJobEvents(jobId: string, req: JobEventsRequest): Promise<void>;
+    emitJobEvent(jobId: string, req: {
+        worker_id: string;
+        attempt: number;
+        type: string;
+        payload: Record<string, unknown>;
+    }): Promise<void>;
     private request;
 }
 export type { JobClaim, JobHeartbeat };

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAER,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EAEb,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAC3D,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,qBAAa,cAAe,SAAQ,KAAK;aACX,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAI1C;AAED;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,aAAa;IAU/B;;;OAGG;IACG,QAAQ,CACZ,GAAG,EAAE,eAAe,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAU3B,0CAA0C;IACpC,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,YAAY,CAAC;IAUxB,mDAAmD;IAC7C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ1D,OAAO;CAsBtB;AAED,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAEL,cAAc,EAEf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,gBAAgB,6BAA6B,CAAC;AAC3D,eAAO,MAAM,eAAe,YAAY,CAAC;AACzC,eAAO,MAAM,iBAAiB,YAAkB,CAAC;AAEjD,qBAAa,cAAe,SAAQ,KAAK;aACX,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAI1C;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAI1C;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAW/C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,IAAI,EAAE,aAAa;IAc/B;;;OAGG;IACG,QAAQ,CACZ,GAAG,EAAE,eAAe,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAS3B,0CAA0C;IACpC,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,YAAY,CAAC;IASxB,mDAAmD;IAC7C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlE,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE;QACH,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,GACA,OAAO,CAAC,IAAI,CAAC;YAQF,OAAO;CA8BtB;AAED,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC"}

package/dist/client.js

@@ -1,5 +1,8 @@
+import { DEFAULT_MAX_RETRIES, RateLimitError, wrapFetchWithRetry, } from "./retry.js";
+export { RateLimitError } from "./retry.js";
 export const DEFAULT_BASE_URL = "https://api.mobiusops.ai";
-export const DEFAULT_NAMESPACE = "default";
+export const DEFAULT_PROJECT = "default";
+export const DEFAULT_NAMESPACE = DEFAULT_PROJECT;
 export class LeaseLostError extends Error {
     constructor(jobId) {
         super(`lease lost for job ${jobId}`);
@@ -7,6 +10,31 @@ export class LeaseLostError extends Error {
         this.name = "LeaseLostError";
     }
 }
+export class PayloadTooLargeError extends Error {
+    constructor(jobId) {
+        super(`custom event payload too large for job ${jobId}`);
+        this.jobId = jobId;
+        this.name = "PayloadTooLargeError";
+    }
+}
+/**
+ * Legacy per-job rate-limit error raised by {@link Client.emitJobEvents}.
+ * Subclass of {@link RateLimitError} so callers catching the newer,
+ * transport-raised {@link RateLimitError} also catch this. New code
+ * should prefer {@link RateLimitError}.
+ */
+export class RateLimitedError extends RateLimitError {
+    constructor(jobId, retryAfter) {
+        super({
+            retryAfter: retryAfter ?? 0,
+            message: retryAfter != null
+                ? `custom event rate limited for job ${jobId} (retry after ${retryAfter}s)`
+                : `custom event rate limited for job ${jobId}`,
+        });
+        this.name = "RateLimitedError";
+        this.jobId = jobId;
+    }
+}
 /**
  * Low-level Mobius runtime API client. Prefer {@link Worker} in worker.ts
  * rather than calling these methods directly.
@@ -18,37 +46,52 @@ export class LeaseLostError extends Error {
 export class Client {
     constructor(opts) {
         this.baseURL = (opts.baseURL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
-        this.namespace = opts.namespace ?? DEFAULT_NAMESPACE;
+        this.project = opts.project ?? opts.namespace ?? DEFAULT_PROJECT;
         this.headers = {
             Authorization: `Bearer ${opts.apiKey}`,
             "Content-Type": "application/json",
         };
         this.timeoutMs = opts.timeoutMs ?? 60000;
+        this.fetchFn = wrapFetchWithRetry((input, init) => globalThis.fetch(input, init), { maxRetries: opts.retry ?? DEFAULT_MAX_RETRIES });
     }
     /**
      * Long-poll for the next claimable job. Returns null when the poll
      * window closes without a job being available.
      */
     async claimJob(req, signal) {
-        const resp = await this.request(`/namespaces/${encodeURIComponent(this.namespace)}/jobs/claim`, { method: "POST", body: { data: req }, signal });
+        const resp = await this.request(`/projects/${encodeURIComponent(this.project)}/jobs/claim`, { method: "POST", body: req, signal });
         if (resp.status === 204)
             return null;
-        const body = (await resp.json());
-        return body.data;
+        return (await resp.json());
     }
     /** Refresh the lease on a claimed job. */
     async heartbeatJob(jobId, req) {
-        const resp = await this.request(`/namespaces/${encodeURIComponent(this.namespace)}/jobs/${encodeURIComponent(jobId)}/heartbeat`, { method: "POST", body: { data: req } });
+        const resp = await this.request(`/projects/${encodeURIComponent(this.project)}/jobs/${encodeURIComponent(jobId)}/heartbeat`, { method: "POST", body: req });
         if (resp.status === 409)
             throw new LeaseLostError(jobId);
-        const body = (await resp.json());
-        return body.data;
+        return (await resp.json());
     }
     /** Report the terminal status of a claimed job. */
     async completeJob(jobId, req) {
-        const resp = await this.request(`/namespaces/${encodeURIComponent(this.namespace)}/jobs/${encodeURIComponent(jobId)}/complete`, { method: "POST", body: { data: req } });
+        const resp = await this.request(`/projects/${encodeURIComponent(this.project)}/jobs/${encodeURIComponent(jobId)}/complete`, { method: "POST", body: req });
+        if (resp.status === 409)
+            throw new LeaseLostError(jobId);
+    }
+    async emitJobEvents(jobId, req) {
+        // 429 responses surface as RateLimitError (thrown from the retry
+        // transport below). 409/413 are non-retryable and handled here.
+        const resp = await this.request(`/projects/${encodeURIComponent(this.project)}/jobs/${encodeURIComponent(jobId)}/events`, { method: "POST", body: req });
         if (resp.status === 409)
             throw new LeaseLostError(jobId);
+        if (resp.status === 413)
+            throw new PayloadTooLargeError(jobId);
+    }
+    async emitJobEvent(jobId, req) {
+        await this.emitJobEvents(jobId, {
+            worker_id: req.worker_id,
+            attempt: req.attempt,
+            events: [{ type: req.type, payload: req.payload }],
+        });
     }
     async request(path, opts) {
         const timeout = AbortSignal.timeout(this.timeoutMs);
@@ -61,8 +104,12 @@ export class Client {
         if (opts.body != null) {
             init.body = JSON.stringify(opts.body);
         }
-        const resp = await fetch(this.baseURL + path, init);
-        if (!resp.ok && resp.status !== 204 && resp.status !== 409) {
+        const resp = await this.fetchFn(this.baseURL + path, init);
+        if (!resp.ok &&
+            resp.status !== 204 &&
+            resp.status !== 409 &&
+            resp.status !== 413 &&
+            resp.status !== 429) {
             const text = await resp.text().catch(() => "");
             throw new Error(`mobius API ${opts.method} ${path}: HTTP ${resp.status}: ${text}`);
         }
@@ -76,7 +123,9 @@ function anySignal(...signals) {
             controller.abort(s.reason);
             break;
         }
-        s.addEventListener("abort", () => controller.abort(s.reason), { once: true });
+        s.addEventListener("abort", () => controller.abort(s.reason), {
+            once: true,
+        });
     }
     return controller.signal;
 }

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-export { Client, LeaseLostError } from "./client.js";
-export { DEFAULT_BASE_URL, DEFAULT_NAMESPACE, type ClientOptions } from "./client.js";
+export { Client, LeaseLostError, PayloadTooLargeError, RateLimitedError, RateLimitError, } from "./client.js";
+export { DEFAULT_BASE_URL, DEFAULT_NAMESPACE, DEFAULT_PROJECT, type ClientOptions, type JobEventEntry, type JobEventsRequest, } from "./client.js";
+export { DEFAULT_MAX_RETRIES, MAX_RETRY_BACKOFF_SECONDS, wrapFetchWithRetry, type WrapRetryOptions, } from "./retry.js";
 export { Worker } from "./worker.js";
-export type { WorkerConfig, ActionFn, Logger } from "./worker.js";
-export type { JobClaim, JobClaimDataResponse, JobClaimRequest, JobCompleteRequest, JobFenceRequest, JobHeartbeat, JobHeartbeatDataResponse, JobHeartbeatDirectives, } from "./api/index.js";
+export type { WorkerConfig, ActionFn, Logger, ActionContext, } from "./worker.js";
+export type { JobClaim, JobClaimRequest, JobCompleteRequest, JobFenceRequest, JobHeartbeat, JobHeartbeatDirectives, } from "./api/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAElE,YAAY,EACV,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
-export { Client, LeaseLostError } from "./client.js";
-export { DEFAULT_BASE_URL, DEFAULT_NAMESPACE } from "./client.js";
+export { Client, LeaseLostError, PayloadTooLargeError, RateLimitedError, RateLimitError, } from "./client.js";
+export { DEFAULT_BASE_URL, DEFAULT_NAMESPACE, DEFAULT_PROJECT, } from "./client.js";
+export { DEFAULT_MAX_RETRIES, MAX_RETRY_BACKOFF_SECONDS, wrapFetchWithRetry, } from "./retry.js";
 export { Worker } from "./worker.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AAEtF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAIhB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/retry.d.ts

@@ -0,0 +1,36 @@
+export declare class RateLimitError extends Error {
+    readonly retryAfter: number;
+    readonly limit: number | null;
+    readonly remaining: number | null;
+    readonly resetAt: Date | null;
+    readonly scope: string | null;
+    readonly policy: string | null;
+    constructor(init?: {
+        retryAfter?: number;
+        limit?: number | null;
+        remaining?: number | null;
+        resetAt?: Date | null;
+        scope?: string | null;
+        policy?: string | null;
+        message?: string;
+    });
+}
+export declare const DEFAULT_MAX_RETRIES = 3;
+export declare const MAX_RETRY_BACKOFF_SECONDS = 60;
+type FetchFn = typeof globalThis.fetch;
+export interface WrapRetryOptions {
+    /** Number of retries for 429/503 responses. 0 disables retries. */
+    maxRetries?: number;
+    /** Override for tests — called in place of `setTimeout`-based sleeping. */
+    sleep?: (seconds: number) => Promise<void>;
+    /** Override for tests — called in place of `Date.now()` (milliseconds). */
+    now?: () => number;
+}
+/**
+ * Wrap a `fetch` function so that 429 and 503 responses are retried per
+ * the shared policy. The returned function is a drop-in replacement for
+ * the global `fetch`.
+ */
+export declare function wrapFetchWithRetry(fetchFn: FetchFn, options?: WrapRetryOptions): FetchFn;
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAGA,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnB,IAAI,GAAE;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KACb;CAkBP;AAED,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAK5C,KAAK,OAAO,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAoCT"}

package/dist/retry.js

@@ -0,0 +1,150 @@
+// 429/503-aware retrying `fetch` wrapper. Implements the shared retry
+// policy documented in ../../docs/retries.md.
+export class RateLimitError extends Error {
+    constructor(init = {}) {
+        const scope = init.scope ?? null;
+        const scopeLabel = scope ?? "unknown";
+        const retryAfter = init.retryAfter ?? 0;
+        const message = init.message ??
+            (retryAfter > 0
+                ? `mobius: rate limit exceeded (scope=${scopeLabel}, retry after ${retryAfter}s)`
+                : `mobius: rate limit exceeded (scope=${scopeLabel})`);
+        super(message);
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+        this.limit = init.limit ?? null;
+        this.remaining = init.remaining ?? null;
+        this.resetAt = init.resetAt ?? null;
+        this.scope = scope;
+        this.policy = init.policy ?? null;
+    }
+}
+export const DEFAULT_MAX_RETRIES = 3;
+export const MAX_RETRY_BACKOFF_SECONDS = 60;
+const BASE_RETRY_BACKOFF_SECONDS = 1;
+const IDEMPOTENT_METHODS = new Set(["GET", "HEAD", "PUT", "DELETE", "OPTIONS"]);
+/**
+ * Wrap a `fetch` function so that 429 and 503 responses are retried per
+ * the shared policy. The returned function is a drop-in replacement for
+ * the global `fetch`.
+ */
+export function wrapFetchWithRetry(fetchFn, options = {}) {
+    const maxRetries = Math.max(0, options.maxRetries ?? DEFAULT_MAX_RETRIES);
+    const sleep = options.sleep ?? defaultSleep;
+    const now = options.now ?? (() => Date.now());
+    return (async (input, init) => {
+        let attempt = 0;
+        // Capture method / idempotency bits once — retries re-send the same request.
+        const { method, hasIdempotencyKey } = describeRequest(input, init);
+        const idempotent = isIdempotent(method, hasIdempotencyKey);
+        while (true) {
+            const response = await fetchFn(input, init);
+            const status = response.status;
+            if (status !== 429 && status !== 503) {
+                return response;
+            }
+            const outOfBudget = attempt >= maxRetries || !idempotent;
+            if (status === 429 && outOfBudget) {
+                // Drain body so the connection can be reused.
+                await drainBody(response);
+                throw buildRateLimitError(response);
+            }
+            if (status === 503 && outOfBudget) {
+                return response;
+            }
+            const wait = retryAfterOrBackoff(response, attempt, now);
+            await drainBody(response);
+            if (wait > 0) {
+                await sleep(wait);
+            }
+            attempt++;
+        }
+    });
+}
+function describeRequest(input, init) {
+    let method = (init?.method ?? "GET").toUpperCase();
+    let headers;
+    if (init?.headers) {
+        headers = new Headers(init.headers);
+    }
+    if (input instanceof Request) {
+        if (!init?.method)
+            method = input.method.toUpperCase();
+        if (!headers)
+            headers = new Headers(input.headers);
+    }
+    const hasIdempotencyKey = headers
+        ? (headers.get("Idempotency-Key") ?? "").trim() !== ""
+        : false;
+    return { method, hasIdempotencyKey };
+}
+function isIdempotent(method, hasIdempotencyKey) {
+    if (IDEMPOTENT_METHODS.has(method))
+        return true;
+    if (method === "POST" || method === "PATCH")
+        return hasIdempotencyKey;
+    return false;
+}
+async function drainBody(response) {
+    try {
+        await response.text();
+    }
+    catch {
+        // ignore
+    }
+}
+function retryAfterOrBackoff(response, attempt, now) {
+    const header = response.headers.get("Retry-After");
+    const parsed = parseRetryAfter(header, now);
+    if (parsed !== null)
+        return clamp(parsed);
+    return clamp(BASE_RETRY_BACKOFF_SECONDS * 2 ** attempt);
+}
+function parseRetryAfter(value, now) {
+    if (value == null || value.trim() === "")
+        return null;
+    const trimmed = value.trim();
+    if (/^-?\d+$/.test(trimmed)) {
+        return Number(trimmed);
+    }
+    const ts = Date.parse(trimmed);
+    if (Number.isNaN(ts))
+        return null;
+    const delta = (ts - now()) / 1000;
+    return Math.max(0, delta);
+}
+function clamp(seconds) {
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return 0;
+    if (seconds > MAX_RETRY_BACKOFF_SECONDS)
+        return MAX_RETRY_BACKOFF_SECONDS;
+    return seconds;
+}
+function buildRateLimitError(response) {
+    const headers = response.headers;
+    const retryAfter = parseRetryAfter(headers.get("Retry-After"), () => Date.now()) ?? 0;
+    return new RateLimitError({
+        retryAfter,
+        limit: intOrNull(headers.get("X-RateLimit-Limit")),
+        remaining: intOrNull(headers.get("X-RateLimit-Remaining")),
+        resetAt: unixOrNull(headers.get("X-RateLimit-Reset")),
+        scope: headers.get("X-RateLimit-Scope"),
+        policy: headers.get("X-RateLimit-Policy"),
+    });
+}
+function intOrNull(v) {
+    if (v == null || v === "")
+        return null;
+    const n = Number.parseInt(v, 10);
+    return Number.isFinite(n) ? n : null;
+}
+function unixOrNull(v) {
+    if (v == null || v === "")
+        return null;
+    const n = Number.parseInt(v, 10);
+    return Number.isFinite(n) ? new Date(n * 1000) : null;
+}
+function defaultSleep(seconds) {
+    return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/worker.d.ts

@@ -18,7 +18,7 @@ export interface WorkerConfig {
     version?: string;
     /**
      * Queue names this worker subscribes to. Empty (or omitted) means claim
-     * jobs from any queue in the namespace. Runs default to the "default"
+     * jobs from any queue in the project. Runs default to the "default"
      * queue.
      */
     queues?: string[];
@@ -42,13 +42,29 @@ export interface WorkerConfig {
      * (e.g. pino, winston) to route messages elsewhere.
      */
     logger?: Logger | null;
+    /** Max buffered custom events per in-flight job before dropping oldest. */
+    eventQueueSize?: number;
+    /** Max custom events per HTTP batch. Defaults to 20. */
+    eventBatchSize?: number;
 }
 /**
  * ActionFn implements a single Mobius action. Receives the JSON-decoded
  * parameters delivered with the job claim and returns a JSON-serialisable
  * result.
  */
-export type ActionFn = (params: Record<string, unknown>, signal: AbortSignal) => Promise<unknown>;
+export type ActionFn = (params: Record<string, unknown>, signal: AbortSignal, ctx: ActionContext) => Promise<unknown>;
+export interface ActionContext {
+    jobId: string;
+    runId: string;
+    projectId?: string;
+    workerId: string;
+    attempt: number;
+    queue?: string;
+    workflowName?: string;
+    stepName?: string;
+    action?: string;
+    emitEvent(type: string, payload: Record<string, unknown>): void;
+}
 /**
  * Worker claims jobs from Mobius and dispatches each to the corresponding
  * registered action function. A *job* is a single action invocation on
@@ -68,10 +84,10 @@ export declare class Worker {
      * stopped via {@link stop} or the given signal is aborted.
      */
     run(signal?: AbortSignal): Promise<void>;
-    /** Gracefully stop the worker after in-flight tasks complete. */
+    /** Gracefully stop the worker after in-flight jobs complete. */
     stop(): void;
-    private executeTask;
+    private executeJob;
     private heartbeatInterval;
-    private failTask;
+    private failJob;
 }
 //# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAkB,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAcD,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;GAIG;AACH,qBAAa,MAAM;IASf,OAAO,CAAC,QAAQ,CAAC,MAAM;IARzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,eAAe,CAAyB;gBAG7B,MAAM,EAAE,MAAM,EAC/B,MAAM,EAAE,YAAY;IAgBtB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;IAK1C;;;OAGG;IACG,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C9C,iEAAiE;IACjE,IAAI,IAAI,IAAI;YAME,WAAW;IAuEzB,OAAO,CAAC,iBAAiB;YAQX,QAAQ;CAmBvB"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,MAAM,EAKP,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAcD,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;;;GAIG;AACH,qBAAa,MAAM;IAWf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAIrB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,eAAe,CAAyB;gBAG7B,MAAM,EAAE,MAAM,EAC/B,MAAM,EAAE,YAAY;IAkBtB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;IAK1C;;;OAGG;IACG,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD9C,gEAAgE;IAChE,IAAI,IAAI,IAAI;YAME,UAAU;IAyGxB,OAAO,CAAC,iBAAiB;YASX,OAAO;CAsBtB"}