@zlink-systems/framework 0.11.0 → 0.12.0

package/dist/contracts/Configuration/EndpointNotation.d.ts

@@ -1,6 +1,7 @@
 /**
- * Deterministic endpoint-notation normalization (endpoint 표기 정책,
- * doc/plan/endpoint-notation-policy.ko.md).
+ * Deterministic endpoint-notation normalization (endpoint 표기 정책),
+ * applied identically across all four language bindings so endpoint
+ * strings compare equal.
  *
  * `new URL()` cannot represent this domain: it throws on bracketed IPv6
  * literals that carry a zone id (`tcp://[fe80::1%eth0]:80`, even with the
@@ -16,7 +17,7 @@
  * public connect/disconnect APIs). Everything downstream compares the
  * resulting strings with plain `===`.
  *
- * Rules (policy 2.2), applied only to authority-bearing schemes
+ * Rules, applied only to authority-bearing schemes
  * (`tcp`, `tls`, `ws`, `wss` -- schemes whose grammar after `scheme://` is
  * `host:port`):
  *  - scheme: lowercased
@@ -39,7 +40,7 @@
  * `normalizeEndpoint(normalizeEndpoint(x)) === normalizeEndpoint(x)`.
  *
  * DNS names are never resolved. `localhost` and `127.0.0.1` remain distinct
- * endpoints (policy 2.1).
+ * endpoints.
  */
 export declare function normalizeEndpoint(endpoint: string): string;
 /**

package/dist/contracts/Configuration/EndpointNotation.js

@@ -1,7 +1,8 @@
 "use strict";
 /**
- * Deterministic endpoint-notation normalization (endpoint 표기 정책,
- * doc/plan/endpoint-notation-policy.ko.md).
+ * Deterministic endpoint-notation normalization (endpoint 표기 정책),
+ * applied identically across all four language bindings so endpoint
+ * strings compare equal.
  *
  * `new URL()` cannot represent this domain: it throws on bracketed IPv6
  * literals that carry a zone id (`tcp://[fe80::1%eth0]:80`, even with the
@@ -17,7 +18,7 @@
  * public connect/disconnect APIs). Everything downstream compares the
  * resulting strings with plain `===`.
  *
- * Rules (policy 2.2), applied only to authority-bearing schemes
+ * Rules, applied only to authority-bearing schemes
  * (`tcp`, `tls`, `ws`, `wss` -- schemes whose grammar after `scheme://` is
  * `host:port`):
  *  - scheme: lowercased
@@ -40,7 +41,7 @@
  * `normalizeEndpoint(normalizeEndpoint(x)) === normalizeEndpoint(x)`.
  *
  * DNS names are never resolved. `localhost` and `127.0.0.1` remain distinct
- * endpoints (policy 2.1).
+ * endpoints.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.normalizeEndpoint = normalizeEndpoint;

package/dist/contracts/Configuration/InternalDefaults.d.ts

@@ -3,5 +3,4 @@ export declare const DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE: number;
 /** Defaults shared by registration normalization and the runtime worker pool. */
 export declare const DEFAULT_WORKER_MIN_THREADS = 0;
 export declare const DEFAULT_WORKER_IDLE_TIMEOUT_MS = 30000;
-export declare const DEFAULT_WORKER_QUEUE_LENGTH = 1024;
 export declare function defaultWorkerMaxThreads(): number;

package/dist/contracts/Configuration/InternalDefaults.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_WORKER_QUEUE_LENGTH = exports.DEFAULT_WORKER_IDLE_TIMEOUT_MS = exports.DEFAULT_WORKER_MIN_THREADS = exports.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE = void 0;
+exports.DEFAULT_WORKER_IDLE_TIMEOUT_MS = exports.DEFAULT_WORKER_MIN_THREADS = exports.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE = void 0;
 exports.defaultWorkerMaxThreads = defaultWorkerMaxThreads;
 const os = __importStar(require("node:os"));
 /** Default complete header plus payload size accepted by a StreamNode. */
@@ -41,7 +41,6 @@ exports.DEFAULT_STREAM_NODE_MAX_MESSAGE_SIZE = 64 * 1024;
 /** Defaults shared by registration normalization and the runtime worker pool. */
 exports.DEFAULT_WORKER_MIN_THREADS = 0;
 exports.DEFAULT_WORKER_IDLE_TIMEOUT_MS = 30_000;
-exports.DEFAULT_WORKER_QUEUE_LENGTH = 1024;
 function defaultWorkerMaxThreads() {
     return Math.max(2, os.availableParallelism());
 }

package/dist/contracts/Configuration/RegistrationNormalizers.js

@@ -31,8 +31,7 @@ function normalizeWorkerOptions(value) {
     return {
         minThreads: partial.minThreads ?? InternalDefaults_1.DEFAULT_WORKER_MIN_THREADS,
         maxThreads: partial.maxThreads ?? (0, InternalDefaults_1.defaultWorkerMaxThreads)(),
-        idleTimeoutMs: partial.idleTimeoutMs ?? InternalDefaults_1.DEFAULT_WORKER_IDLE_TIMEOUT_MS,
-        maxQueueLength: partial.maxQueueLength ?? InternalDefaults_1.DEFAULT_WORKER_QUEUE_LENGTH
+        idleTimeoutMs: partial.idleTimeoutMs ?? InternalDefaults_1.DEFAULT_WORKER_IDLE_TIMEOUT_MS
     };
 }
 function normalizeNetworkOptions(value) {

package/dist/contracts/Configuration/RegistrationTypes.d.ts

@@ -79,16 +79,13 @@ export interface ZLinkLocationRegistration {
 /**
  * CPU worker-thread pool settings. I/O workers do not consume this pool.
  * `minThreads` keeps a warm baseline, `maxThreads` bounds active CPU jobs,
- * `idleTimeoutMs` reclaims workers above the baseline, and `maxQueueLength`
- * bounds queued jobs. The registration normalizer supplies defaults when a
- * JavaScript caller omits a field: `0`, `max(2, availableParallelism())`,
- * `30000`, and `1024`, respectively.
+ * `idleTimeoutMs` reclaims workers above the baseline. The registration
+ * normalizer supplies defaults when a JavaScript caller omits a field.
  */
 export interface ZLinkWorkerOptions {
     readonly minThreads: number;
     readonly maxThreads: number;
     readonly idleTimeoutMs: number;
-    readonly maxQueueLength: number;
 }
 export interface ZLinkCodecSerializerRegistration {
     readonly contentType: string;

package/dist/contracts/Configuration/RegistrationValidators.js

@@ -61,7 +61,6 @@ function validateWorkerOptions(worker) {
     requireNonNegativeInteger('Worker minThreads', worker.minThreads);
     (0, RegistrationNormalizers_1.requirePositiveInteger)('Worker maxThreads', worker.maxThreads);
     requireNonNegativeInteger('Worker idleTimeoutMs', worker.idleTimeoutMs);
-    (0, RegistrationNormalizers_1.requirePositiveInteger)('Worker maxQueueLength', worker.maxQueueLength);
     if (worker.maxThreads < worker.minThreads) {
         throw new ConfigurationException_1.ZLinkConfigurationException('Worker maxThreads must be greater than or equal to minThreads.');
     }

package/dist/contracts/Errors/ZLinkFrameworkException.d.ts

@@ -6,13 +6,12 @@ export declare enum ZLinkFrameworkErrorKind {
     NotConfigured = 3,
     Rejected = 4,
     Unavailable = 5,
-    CapacityExceeded = 6,
-    DeadlineExceeded = 7,
-    ShuttingDown = 8,
-    ProtocolError = 9,
-    InvalidOperation = 10,
-    DataLost = 11,
-    InternalFailure = 12
+    DeadlineExceeded = 6,
+    ShuttingDown = 7,
+    ProtocolError = 8,
+    InvalidOperation = 9,
+    DataLost = 10,
+    InternalFailure = 11
 }
 export declare class ZLinkFrameworkException extends Error {
     readonly kind: ZLinkFrameworkErrorKind;

package/dist/contracts/Errors/ZLinkFrameworkException.js

@@ -10,13 +10,12 @@ var ZLinkFrameworkErrorKind;
     ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["NotConfigured"] = 3] = "NotConfigured";
     ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["Rejected"] = 4] = "Rejected";
     ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["Unavailable"] = 5] = "Unavailable";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["CapacityExceeded"] = 6] = "CapacityExceeded";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["DeadlineExceeded"] = 7] = "DeadlineExceeded";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["ShuttingDown"] = 8] = "ShuttingDown";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["ProtocolError"] = 9] = "ProtocolError";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["InvalidOperation"] = 10] = "InvalidOperation";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["DataLost"] = 11] = "DataLost";
-    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["InternalFailure"] = 12] = "InternalFailure";
+    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["DeadlineExceeded"] = 6] = "DeadlineExceeded";
+    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["ShuttingDown"] = 7] = "ShuttingDown";
+    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["ProtocolError"] = 8] = "ProtocolError";
+    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["InvalidOperation"] = 9] = "InvalidOperation";
+    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["DataLost"] = 10] = "DataLost";
+    ZLinkFrameworkErrorKind[ZLinkFrameworkErrorKind["InternalFailure"] = 11] = "InternalFailure";
 })(ZLinkFrameworkErrorKind || (exports.ZLinkFrameworkErrorKind = ZLinkFrameworkErrorKind = {}));
 class ZLinkFrameworkException extends Error {
     kind;

package/dist/runtime/actors/actor-client.js

@@ -537,7 +537,7 @@ function submitted() {
 //  the reply comes from a remote target, so a fine framework failure code
 //  refines the coarse terminal, and a terminal-only conflict/busy is the
 //  target's owner/queue state (retryable stale/Unavailable), never a
-//  source-owned CapacityExceeded. Backpressure never appears on this reply
+//  source-owned queue exhaustion. Backpressure never appears on this reply
 //  path. Internal kinds are preserved so the stale-actor re-resolve retry
 //  (isStaleActorError) keeps working.
 function actorFailureCodeKind(failureErrno) {

package/dist/runtime/actors/actor-mailbox.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkActorSerialExecutor = void 0;
 const serial_execution_queue_1 = require("../execution/serial-execution-queue");
-const framework_errors_internal_1 = require("../framework-errors-internal");
 const actor_execution_context_1 = require("./actor-execution-context");
 const application_job_queue_scope_1 = require("../application-jobs/application-job-queue-scope");
 class ZLinkActorSerialExecutor {
@@ -12,10 +11,7 @@ class ZLinkActorSerialExecutor {
     constructor(actorId, sourceSpotId, options) {
         this.actorId = actorId;
         this.sourceSpotId = sourceSpotId;
-        this.scheduler = new serial_execution_queue_1.ZLinkSerialExecutionQueue((record) => this.runRecord(record), {
-            ...options,
-            capacityError: options?.capacityError ?? (() => (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.WorkerQueueFull, 'Actor execution queue capacity was exceeded.'))
-        });
+        this.scheduler = new serial_execution_queue_1.ZLinkSerialExecutionQueue((record) => this.runRecord(record), options);
     }
     execute(operation, workOptions) {
         const boundOperation = (0, application_job_queue_scope_1.bindApplicationJobPermit)(() => (0, actor_execution_context_1.runZLinkActorExecution)(this.actorId, this.sourceSpotId, operation));

package/dist/runtime/backend/contracts/index.d.ts

@@ -359,6 +359,8 @@ export interface ZLinkBackendSubscriberSocket extends ZLinkBackendConnectableSoc
 }
 export interface ZLinkBackendReadablePoller {
     wait(timeoutMs: number): boolean;
+    waitForReadable(signal?: AbortSignal): Promise<boolean>;
+    markDrained(): void;
     dispose(): void;
 }
 export interface ZLinkBackendStreamPacket {

package/dist/runtime/backend/mesh-completion-table.d.ts

@@ -1,6 +1,5 @@
 import { ZLinkBufferMessage as Message } from './runtime-message';
 import type { MeshOperationId, ReceiveKindData, ReceiveRecord } from '../foundation/service-runtime-contracts';
-export declare const ZLINK_MESH_COMPLETION_CAPACITY = 4096;
 export interface ZLinkMeshCompletionDiagnostic {
     readonly kind: 'unknownOrLate';
     readonly operationId: MeshOperationId;
@@ -14,11 +13,10 @@ export interface ZLinkMeshCompletion {
     readonly parts: Message[];
 }
 export declare class ZLinkMeshCompletionTable {
-    private readonly maxPendingOperations;
     private readonly onDiagnostic?;
     private readonly pending;
     private disposed;
-    constructor(maxPendingOperations?: number, onDiagnostic?: ((diagnostic: ZLinkMeshCompletionDiagnostic) => void) | undefined);
+    constructor(onDiagnostic?: ((diagnostic: ZLinkMeshCompletionDiagnostic) => void) | undefined);
     /**
      * Submits and registers without yielding control to the event loop. Mesh
      * completion dispatch is asynchronous, so a completion cannot overtake the

package/dist/runtime/backend/mesh-completion-table.js

@@ -1,22 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZLinkMeshCompletionTable = exports.ZLINK_MESH_COMPLETION_CAPACITY = void 0;
+exports.ZLinkMeshCompletionTable = void 0;
 exports.closeMeshCompletion = closeMeshCompletion;
 const runtime_message_1 = require("./runtime-message");
 const operation_identity_1 = require("../foundation/operation-identity");
-const contracts_1 = require("../../contracts");
-exports.ZLINK_MESH_COMPLETION_CAPACITY = 4_096;
 class ZLinkMeshCompletionTable {
-    maxPendingOperations;
     onDiagnostic;
     pending = new Map();
     disposed = false;
-    constructor(maxPendingOperations = exports.ZLINK_MESH_COMPLETION_CAPACITY, onDiagnostic) {
-        this.maxPendingOperations = maxPendingOperations;
+    constructor(onDiagnostic) {
         this.onDiagnostic = onDiagnostic;
-        if (!Number.isSafeInteger(maxPendingOperations) || maxPendingOperations <= 0) {
-            throw new RangeError('maxPendingOperations must be a positive safe integer.');
-        }
     }
     /**
      * Submits and registers without yielding control to the event loop. Mesh
@@ -31,9 +24,6 @@ class ZLinkMeshCompletionTable {
         if (signal?.aborted === true) {
             return Promise.reject(signal.reason ?? new DOMException('The operation was aborted.', 'AbortError'));
         }
-        if (this.pending.size >= this.maxPendingOperations) {
-            return Promise.reject(new contracts_1.ZLinkFrameworkException(contracts_1.ZLinkFrameworkErrorKind.CapacityExceeded, `Mesh completion capacity ${this.maxPendingOperations} is exhausted.`));
-        }
         const operationId = operation();
         // The backend submission callback can synchronously re-enter `dispose()`.
         // TypeScript's control-flow analysis cannot observe mutation through it.
@@ -80,7 +70,7 @@ class ZLinkMeshCompletionTable {
         this.pending.delete(key);
         pending.removeAbort?.();
         try {
-            pending.resolve(copyCompletion(record));
+            pending.resolve(retainCompletion(record));
         }
         catch (error) {
             pending.reject(error);
@@ -105,15 +95,21 @@ class ZLinkMeshCompletionTable {
     }
 }
 exports.ZLinkMeshCompletionTable = ZLinkMeshCompletionTable;
-function copyCompletion(record) {
+function retainCompletion(record) {
     return {
         terminalResult: record.terminalResult,
         failureErrno: record.failureErrno,
         operationKind: record.operationKind,
         kindData: record.kindData,
-        parts: record.parts.map((part) => runtime_message_1.ZLinkBufferMessage.fromOwned(Buffer.from(part.data())))
+        parts: record.parts.map(retainCompletionPart)
     };
 }
+function retainCompletionPart(part) {
+    // A runtime message already owns a managed Buffer and close() is a no-op.
+    // Binding-native messages can expose native storage through data(), which
+    // becomes invalid when their owner closes; materialize that one boundary copy.
+    return part instanceof runtime_message_1.ZLinkBufferMessage ? part : runtime_message_1.ZLinkBufferMessage.fromOwned(Buffer.from(part.data()));
+}
 function closeMeshCompletion(completion) {
     closeParts(completion.parts);
 }

package/dist/runtime/backend/mesh-dispatch-pump.d.ts

@@ -21,17 +21,24 @@ export declare class ZLinkMeshDispatchPump {
     private readonly node;
     private readonly options;
     private pendingDomains;
-    private scheduled;
     private infrastructureScheduled;
     private disposed;
-    private drainPromise?;
     private infrastructureDrainPromise?;
     private readonly activeDrains;
+    private readonly idleApplicationWorkers;
+    private applicationWorkerCount;
     private readonly capacityStop;
+    private recordsSinceYield;
+    private yieldStartedAtMs;
     constructor(node: ZLinkBackendMeshNode, options: ZLinkMeshDispatchPumpOptions);
     start(): void;
     dispose(): Promise<void>;
-    private schedule;
+    private markReady;
+    private wakeApplicationWorker;
+    private startApplicationWorker;
+    private runApplicationWorker;
+    private waitForApplicationReady;
+    private reportDispatchError;
     /**
      * Infrastructure controls must not wait for an application permit. During
      * source draining an application claim can legitimately remain parked at
@@ -40,9 +47,9 @@ export declare class ZLinkMeshDispatchPump {
      * completing the drain that releases the application work.
      */
     private scheduleInfrastructure;
-    private drain;
     private drainInfrastructure;
     private drainDomain;
+    private yieldIfNeeded;
     private nowMs;
     private acquirePermit;
 }