@maiaos/protocol 0.1.0-canary.1

package/dist/port-lease/contract.d.ts

@@ -0,0 +1,222 @@
+import type { InferRuntimeSchema } from "../runtime-schema/index.js";
+/** Typed failures every port lease client can branch on. */
+export declare const PORT_LEASE_ERROR_CODES: readonly ["port_lease_conflict", "port_lease_expired", "port_lease_not_found", "port_pool_exhausted"];
+export type PortLeaseErrorCode = (typeof PORT_LEASE_ERROR_CODES)[number];
+export declare const portLeaseSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly endReason?: "owner_missing" | "owner_released" | "session_ended" | "ttl_expired" | undefined;
+    readonly expiresAt: string;
+    readonly grantedAt: string;
+    readonly leaseId: string;
+    readonly owner: {
+        readonly kind: "session";
+        readonly sessionId: string;
+    } | {
+        readonly kind: "principal";
+        readonly principalId: string;
+    };
+    readonly ports: readonly number[];
+    readonly purpose: string;
+    readonly revision: string;
+    readonly schemaVersion: "maia.port-lease/v1";
+    readonly state: "active" | "expired" | "released";
+    readonly updatedAt: string;
+}>;
+export type PortLease = InferRuntimeSchema<typeof portLeaseSchema>;
+export declare const portLeaseOwnerSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly kind: "session";
+    readonly sessionId: string;
+} | {
+    readonly kind: "principal";
+    readonly principalId: string;
+}>;
+export type PortLeaseOwner = InferRuntimeSchema<typeof portLeaseOwnerSchema>;
+export declare const portLeaseAcquireParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly count?: number | undefined;
+    readonly preferred?: number | undefined;
+    readonly purpose: string;
+    readonly sessionId?: string | undefined;
+}>;
+export type PortLeaseAcquireParameters = InferRuntimeSchema<typeof portLeaseAcquireParametersSchema>;
+export declare const portLeaseRenewParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly expectedRevision: string;
+    readonly leaseId: string;
+}>;
+export type PortLeaseRenewParameters = InferRuntimeSchema<typeof portLeaseRenewParametersSchema>;
+export declare const portLeaseReleaseParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly leaseId: string;
+}>;
+export type PortLeaseReleaseParameters = InferRuntimeSchema<typeof portLeaseReleaseParametersSchema>;
+export declare const portLeaseListParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly afterCursor?: string | undefined;
+    readonly limit: number;
+    readonly sessionId?: string | undefined;
+}>;
+export type PortLeaseListParameters = InferRuntimeSchema<typeof portLeaseListParametersSchema>;
+export declare const portLeaseAcquireResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly delivery: "duplicate" | "new";
+    readonly lease: {
+        readonly endReason?: "owner_missing" | "owner_released" | "session_ended" | "ttl_expired" | undefined;
+        readonly expiresAt: string;
+        readonly grantedAt: string;
+        readonly leaseId: string;
+        readonly owner: {
+            readonly kind: "session";
+            readonly sessionId: string;
+        } | {
+            readonly kind: "principal";
+            readonly principalId: string;
+        };
+        readonly ports: readonly number[];
+        readonly purpose: string;
+        readonly revision: string;
+        readonly schemaVersion: "maia.port-lease/v1";
+        readonly state: "active" | "expired" | "released";
+        readonly updatedAt: string;
+    };
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly method: "port.lease.acquire";
+}>;
+export type PortLeaseAcquireResult = InferRuntimeSchema<typeof portLeaseAcquireResultSchema>;
+export declare const portLeaseRenewResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly delivery: "duplicate" | "new";
+    readonly lease: {
+        readonly endReason?: "owner_missing" | "owner_released" | "session_ended" | "ttl_expired" | undefined;
+        readonly expiresAt: string;
+        readonly grantedAt: string;
+        readonly leaseId: string;
+        readonly owner: {
+            readonly kind: "session";
+            readonly sessionId: string;
+        } | {
+            readonly kind: "principal";
+            readonly principalId: string;
+        };
+        readonly ports: readonly number[];
+        readonly purpose: string;
+        readonly revision: string;
+        readonly schemaVersion: "maia.port-lease/v1";
+        readonly state: "active" | "expired" | "released";
+        readonly updatedAt: string;
+    };
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly expectedRevision: string;
+    readonly method: "port.lease.renew";
+}>;
+export type PortLeaseRenewResult = InferRuntimeSchema<typeof portLeaseRenewResultSchema>;
+export declare const portLeaseReleaseResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly delivery: "duplicate" | "new";
+    readonly lease: {
+        readonly endReason?: "owner_missing" | "owner_released" | "session_ended" | "ttl_expired" | undefined;
+        readonly expiresAt: string;
+        readonly grantedAt: string;
+        readonly leaseId: string;
+        readonly owner: {
+            readonly kind: "session";
+            readonly sessionId: string;
+        } | {
+            readonly kind: "principal";
+            readonly principalId: string;
+        };
+        readonly ports: readonly number[];
+        readonly purpose: string;
+        readonly revision: string;
+        readonly schemaVersion: "maia.port-lease/v1";
+        readonly state: "active" | "expired" | "released";
+        readonly updatedAt: string;
+    };
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly method: "port.lease.release";
+}>;
+export type PortLeaseReleaseResult = InferRuntimeSchema<typeof portLeaseReleaseResultSchema>;
+export declare const portLeaseListResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly items: readonly {
+        readonly lease: {
+            readonly endReason?: "owner_missing" | "owner_released" | "session_ended" | "ttl_expired" | undefined;
+            readonly expiresAt: string;
+            readonly grantedAt: string;
+            readonly leaseId: string;
+            readonly owner: {
+                readonly kind: "session";
+                readonly sessionId: string;
+            } | {
+                readonly kind: "principal";
+                readonly principalId: string;
+            };
+            readonly ports: readonly number[];
+            readonly purpose: string;
+            readonly revision: string;
+            readonly schemaVersion: "maia.port-lease/v1";
+            readonly state: "active" | "expired" | "released";
+            readonly updatedAt: string;
+        };
+        readonly probes: readonly {
+            readonly inUse: boolean;
+            readonly port: number;
+        }[];
+    }[];
+    readonly method: "port.lease.list";
+    readonly nextCursor?: string | undefined;
+    readonly range: {
+        readonly end: number;
+        readonly start: number;
+    };
+}>;
+export type PortLeaseListResult = InferRuntimeSchema<typeof portLeaseListResultSchema>;
+export declare const PORT_LEASE_SCHEMA_VERSION: "maia.port-lease/v1";
+export declare const PORT_LEASE_AGGREGATE_TYPE: "port_lease";
+export declare const MIN_PORT_LEASE_PORT: number;
+export declare const MAX_PORT_LEASE_PORT: number;
+export declare const MAX_PORT_LEASE_COUNT: number;
+export declare const MAX_PORT_LEASE_PAGE_SIZE: number;
+//# sourceMappingURL=contract.d.ts.map

package/dist/port-lease/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/port-lease/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAuBrE,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB,YACjC,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,CACb,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAAiD,CAAC;AAC9E,MAAM,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,eAAe,CAAC,CAAC;AACnE,eAAO,MAAM,oBAAoB;;;;;;EAEhC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE7E,eAAO,MAAM,gCAAgC;;;;;;EAE5C,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CACzD,OAAO,gCAAgC,CACxC,CAAC;AACF,eAAO,MAAM,8BAA8B;;;;EAE1C,CAAC;AACF,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CACvD,OAAO,8BAA8B,CACtC,CAAC;AACF,eAAO,MAAM,gCAAgC;;;EAE5C,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CACzD,OAAO,gCAAgC,CACxC,CAAC;AACF,eAAO,MAAM,6BAA6B;;;;EAEzC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CACtD,OAAO,6BAA6B,CACrC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAExC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACrD,OAAO,4BAA4B,CACpC,CAAC;AACF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CACnD,OAAO,0BAA0B,CAClC,CAAC;AACF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAExC,CAAC;AACF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACrD,OAAO,4BAA4B,CACpC,CAAC;AACF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAErC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAClD,OAAO,yBAAyB,CACjC,CAAC;AAGF,eAAO,MAAM,yBAAyB,EAAE,oBAAoC,CAAC;AAC7E,eAAO,MAAM,yBAAyB,EAAE,YAA4B,CAAC;AACrE,eAAO,MAAM,mBAAmB,EAAE,MAAoB,CAAC;AACvD,eAAO,MAAM,mBAAmB,EAAE,MAAoB,CAAC;AACvD,eAAO,MAAM,oBAAoB,EAAE,MAAqB,CAAC;AACzD,eAAO,MAAM,wBAAwB,EAAE,MAAwB,CAAC"}

package/dist/port-lease/contract.js

@@ -0,0 +1,28 @@
+import { makeEffectRuntimeSchema } from "../runtime-schema/effect-schema.js";
+import { MAX_PORT_LEASE_COUNT as maximumCount, MAX_PORT_LEASE_PAGE_SIZE as maximumPageSize, MAX_PORT_LEASE_PORT as maximumPort, MIN_PORT_LEASE_PORT as minimumPort, PORT_LEASE_SCHEMA_VERSION as schemaVersion, portLeaseAcquireParametersEffectSchema, portLeaseEffectSchema, portLeaseListParametersEffectSchema, portLeaseOwnerEffectSchema, portLeaseReleaseParametersEffectSchema, portLeaseRenewParametersEffectSchema, } from "./request-effect-schema.js";
+import { PORT_LEASE_AGGREGATE_TYPE as aggregateType, portLeaseAcquireResultEffectSchema, portLeaseListResultEffectSchema, portLeaseReleaseResultEffectSchema, portLeaseRenewResultEffectSchema, } from "./result-effect-schema.js";
+/** Typed failures every port lease client can branch on. */
+export const PORT_LEASE_ERROR_CODES = [
+    "port_lease_conflict",
+    "port_lease_expired",
+    "port_lease_not_found",
+    "port_pool_exhausted",
+];
+export const portLeaseSchema = makeEffectRuntimeSchema(portLeaseEffectSchema);
+export const portLeaseOwnerSchema = makeEffectRuntimeSchema(portLeaseOwnerEffectSchema);
+export const portLeaseAcquireParametersSchema = makeEffectRuntimeSchema(portLeaseAcquireParametersEffectSchema);
+export const portLeaseRenewParametersSchema = makeEffectRuntimeSchema(portLeaseRenewParametersEffectSchema);
+export const portLeaseReleaseParametersSchema = makeEffectRuntimeSchema(portLeaseReleaseParametersEffectSchema);
+export const portLeaseListParametersSchema = makeEffectRuntimeSchema(portLeaseListParametersEffectSchema);
+export const portLeaseAcquireResultSchema = makeEffectRuntimeSchema(portLeaseAcquireResultEffectSchema);
+export const portLeaseRenewResultSchema = makeEffectRuntimeSchema(portLeaseRenewResultEffectSchema);
+export const portLeaseReleaseResultSchema = makeEffectRuntimeSchema(portLeaseReleaseResultEffectSchema);
+export const portLeaseListResultSchema = makeEffectRuntimeSchema(portLeaseListResultEffectSchema);
+// Keep public declarations independent of the private Effect schema module.
+export const PORT_LEASE_SCHEMA_VERSION = schemaVersion;
+export const PORT_LEASE_AGGREGATE_TYPE = aggregateType;
+export const MIN_PORT_LEASE_PORT = minimumPort;
+export const MAX_PORT_LEASE_PORT = maximumPort;
+export const MAX_PORT_LEASE_COUNT = maximumCount;
+export const MAX_PORT_LEASE_PAGE_SIZE = maximumPageSize;
+//# sourceMappingURL=contract.js.map

package/dist/port-lease/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/port-lease/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,EACL,oBAAoB,IAAI,YAAY,EACpC,wBAAwB,IAAI,eAAe,EAC3C,mBAAmB,IAAI,WAAW,EAClC,mBAAmB,IAAI,WAAW,EAClC,yBAAyB,IAAI,aAAa,EAC1C,sCAAsC,EACtC,qBAAqB,EACrB,mCAAmC,EACnC,0BAA0B,EAC1B,sCAAsC,EACtC,oCAAoC,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,yBAAyB,IAAI,aAAa,EAC1C,kCAAkC,EAClC,+BAA+B,EAC/B,kCAAkC,EAClC,gCAAgC,GACjC,MAAM,2BAA2B,CAAC;AAEnC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;CACb,CAAC;AAGX,MAAM,CAAC,MAAM,eAAe,GAAG,uBAAuB,CAAC,qBAAqB,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CACzD,0BAA0B,CAC3B,CAAC;AAGF,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAuB,CACrE,sCAAsC,CACvC,CAAC;AAIF,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CACnE,oCAAoC,CACrC,CAAC;AAIF,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAuB,CACrE,sCAAsC,CACvC,CAAC;AAIF,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAClE,mCAAmC,CACpC,CAAC;AAKF,MAAM,CAAC,MAAM,4BAA4B,GAAG,uBAAuB,CACjE,kCAAkC,CACnC,CAAC;AAIF,MAAM,CAAC,MAAM,0BAA0B,GAAG,uBAAuB,CAC/D,gCAAgC,CACjC,CAAC;AAIF,MAAM,CAAC,MAAM,4BAA4B,GAAG,uBAAuB,CACjE,kCAAkC,CACnC,CAAC;AAIF,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAC9D,+BAA+B,CAChC,CAAC;AAKF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAyB,aAAa,CAAC;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAiB,aAAa,CAAC;AACrE,MAAM,CAAC,MAAM,mBAAmB,GAAW,WAAW,CAAC;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAW,WAAW,CAAC;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAAW,YAAY,CAAC;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAW,eAAe,CAAC"}

package/dist/port-lease/effect-schema.d.ts

@@ -0,0 +1,3 @@
+export { portLeaseRequestEffectSchema } from "./request-effect-schema.js";
+export { portLeaseResultEffectSchema } from "./result-effect-schema.js";
+//# sourceMappingURL=effect-schema.d.ts.map

package/dist/port-lease/effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-schema.d.ts","sourceRoot":"","sources":["../../src/port-lease/effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/port-lease/effect-schema.js

@@ -0,0 +1,3 @@
+export { portLeaseRequestEffectSchema } from "./request-effect-schema.js";
+export { portLeaseResultEffectSchema } from "./result-effect-schema.js";
+//# sourceMappingURL=effect-schema.js.map

package/dist/port-lease/effect-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-schema.js","sourceRoot":"","sources":["../../src/port-lease/effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/port-lease/feature.d.ts

@@ -0,0 +1,121 @@
+import { type MaiaOperationsFeature } from "../feature/descriptor/index.js";
+/** Advisory TCP port leases for Sessions and coordinators. */
+export declare const PORT_LEASE_FEATURE_OPERATIONS: readonly [{
+    readonly method: "port.lease.acquire";
+    readonly nodeHandler: "portLease";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-idempotent";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Lease 1-8 free TCP ports from this Node's range for a Session (sessionId) or for yourself. Leases are advisory and expire unless renewed; a bind probe proves each port free when granted. preferred is honored when it is inside the range and free. Choose a unique commandId and reuse it to retry.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: false;
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "acquirePortLease";
+    };
+}, {
+    readonly method: "port.lease.renew";
+    readonly nodeHandler: "portLease";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-idempotent";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: true;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Extend a port lease by its time to live at the lease's current revision.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: false;
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "renewPortLease";
+    };
+}, {
+    readonly method: "port.lease.release";
+    readonly nodeHandler: "portLease";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "native-idempotent";
+        readonly idempotency: "command-id";
+        readonly ownReceipt: true;
+        readonly receipt: "required";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "reversible";
+    };
+    readonly primitives: readonly ["receipt"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "Release a port lease; releasing a lease that already ended succeeds and frees nothing more.";
+            readonly destructive: false;
+            readonly readOnly: false;
+        };
+        readonly desktop: false;
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "releasePortLease";
+    };
+}, {
+    readonly method: "port.lease.list";
+    readonly nodeHandler: "portLease";
+    readonly policy: {
+        readonly confirmation: "none";
+        readonly effectClass: "none";
+        readonly idempotency: "none";
+        readonly ownReceipt: false;
+        readonly receipt: "none";
+        readonly releaseQualified: false;
+        readonly revisionGuard: false;
+        readonly risk: "read";
+    };
+    readonly primitives: readonly ["read"];
+    readonly projections: {
+        readonly cli: true;
+        readonly coordinator: {
+            readonly description: "List active port leases, optionally for one Session, with whether a process listens on each port now and the Node's range. Next page: afterCursor set to the result nextCursor.";
+            readonly destructive: false;
+            readonly readOnly: true;
+        };
+        readonly desktop: false;
+        readonly mobile: false;
+        readonly voice: false;
+    };
+    readonly sdk: {
+        readonly client: "local-node";
+        readonly operation: "listPortLeases";
+    };
+}];
+export declare const PORT_LEASE_FEATURE: MaiaOperationsFeature<"port-lease", typeof PORT_LEASE_FEATURE_OPERATIONS>;
+//# sourceMappingURL=feature.d.ts.map

package/dist/port-lease/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/port-lease/feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,gCAAgC,CAAC;AAExC,8DAA8D;AAC9D,eAAO,MAAM,6BAA6B;qBAE9B,oBAAoB;0BACf,WAAW;;iBAEtB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,mBAAmB;iBAChC,WAAW,EAAE,YAAY;iBACzB,UAAU;iBACV,OAAO,EAAE,UAAU;iBACnB,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,YAAY;;;;iBAIlB,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,wSAAwS;qBAC1S,WAAW;qBACX,QAAQ;;iBAEV,OAAO;iBACP,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,kBAAkB;;;qBAGlD,kBAAkB;0BACb,WAAW;;iBAEtB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,mBAAmB;iBAChC,WAAW,EAAE,YAAY;iBACzB,UAAU;iBACV,OAAO,EAAE,UAAU;iBACnB,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,YAAY;;;;iBAIlB,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,0EAA0E;qBAC5E,WAAW;qBACX,QAAQ;;iBAEV,OAAO;iBACP,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,gBAAgB;;;qBAGhD,oBAAoB;0BACf,WAAW;;iBAEtB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,mBAAmB;iBAChC,WAAW,EAAE,YAAY;iBACzB,UAAU;iBACV,OAAO,EAAE,UAAU;iBACnB,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,YAAY;;;;iBAIlB,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,6FAA6F;qBAC/F,WAAW;qBACX,QAAQ;;iBAEV,OAAO;iBACP,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,kBAAkB;;;qBAGlD,iBAAiB;0BACZ,WAAW;;iBAEtB,YAAY,EAAE,MAAM;iBACpB,WAAW,EAAE,MAAM;iBACnB,WAAW,EAAE,MAAM;iBACnB,UAAU;iBACV,OAAO,EAAE,MAAM;iBACf,gBAAgB;iBAChB,aAAa;iBACb,IAAI,EAAE,MAAM;;;;iBAIZ,GAAG;iBACH,WAAW;qBACT,WAAW,EACT,iLAAiL;qBACnL,WAAW;qBACX,QAAQ;;iBAEV,OAAO;iBACP,MAAM;iBACN,KAAK;;;iBAEA,MAAM,EAAE,YAAY;iBAAE,SAAS,EAAE,gBAAgB;;EAEE,CAAC;AAE/D,eAAO,MAAM,kBAAkB,EAAE,qBAAqB,CACpD,YAAY,EACZ,OAAO,6BAA6B,CAMpC,CAAC"}

package/dist/port-lease/feature.js

@@ -0,0 +1,119 @@
+import { defineMaiaFeature, } from "../feature/descriptor/index.js";
+/** Advisory TCP port leases for Sessions and coordinators. */
+export const PORT_LEASE_FEATURE_OPERATIONS = [
+    {
+        method: "port.lease.acquire",
+        nodeHandler: "portLease",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-idempotent",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "Lease 1-8 free TCP ports from this Node's range for a Session (sessionId) or for yourself. Leases are advisory and expire unless renewed; a bind probe proves each port free when granted. preferred is honored when it is inside the range and free. Choose a unique commandId and reuse it to retry.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: false,
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "acquirePortLease" },
+    },
+    {
+        method: "port.lease.renew",
+        nodeHandler: "portLease",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-idempotent",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: true,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "Extend a port lease by its time to live at the lease's current revision.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: false,
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "renewPortLease" },
+    },
+    {
+        method: "port.lease.release",
+        nodeHandler: "portLease",
+        policy: {
+            confirmation: "none",
+            effectClass: "native-idempotent",
+            idempotency: "command-id",
+            ownReceipt: true,
+            receipt: "required",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "reversible",
+        },
+        primitives: ["receipt"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "Release a port lease; releasing a lease that already ended succeeds and frees nothing more.",
+                destructive: false,
+                readOnly: false,
+            },
+            desktop: false,
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "releasePortLease" },
+    },
+    {
+        method: "port.lease.list",
+        nodeHandler: "portLease",
+        policy: {
+            confirmation: "none",
+            effectClass: "none",
+            idempotency: "none",
+            ownReceipt: false,
+            receipt: "none",
+            releaseQualified: false,
+            revisionGuard: false,
+            risk: "read",
+        },
+        primitives: ["read"],
+        projections: {
+            cli: true,
+            coordinator: {
+                description: "List active port leases, optionally for one Session, with whether a process listens on each port now and the Node's range. Next page: afterCursor set to the result nextCursor.",
+                destructive: false,
+                readOnly: true,
+            },
+            desktop: false,
+            mobile: false,
+            voice: false,
+        },
+        sdk: { client: "local-node", operation: "listPortLeases" },
+    },
+];
+export const PORT_LEASE_FEATURE = defineMaiaFeature({
+    contributions: { routines: [], rules: [], schedules: [], skills: [] },
+    id: "port-lease",
+    operations: PORT_LEASE_FEATURE_OPERATIONS,
+    schemaVersion: "maia.feature/port-lease/v1",
+});
+//# sourceMappingURL=feature.js.map

package/dist/port-lease/feature.js.map

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

package/dist/port-lease/index.d.ts

@@ -0,0 +1,3 @@
+export { MAX_PORT_LEASE_COUNT, MAX_PORT_LEASE_PAGE_SIZE, MAX_PORT_LEASE_PORT, MIN_PORT_LEASE_PORT, PORT_LEASE_AGGREGATE_TYPE, PORT_LEASE_ERROR_CODES, PORT_LEASE_SCHEMA_VERSION, type PortLease, type PortLeaseAcquireParameters, portLeaseAcquireParametersSchema, type PortLeaseAcquireResult, portLeaseAcquireResultSchema, type PortLeaseErrorCode, type PortLeaseListParameters, portLeaseListParametersSchema, type PortLeaseListResult, portLeaseListResultSchema, type PortLeaseOwner, portLeaseOwnerSchema, type PortLeaseReleaseParameters, portLeaseReleaseParametersSchema, type PortLeaseReleaseResult, portLeaseReleaseResultSchema, type PortLeaseRenewParameters, portLeaseRenewParametersSchema, type PortLeaseRenewResult, portLeaseRenewResultSchema, portLeaseSchema, } from "./contract.js";
+export { PORT_LEASE_FEATURE } from "./feature.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/port-lease/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/port-lease/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,KAAK,SAAS,EACd,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,6BAA6B,EAC7B,KAAK,mBAAmB,EACxB,yBAAyB,EACzB,KAAK,cAAc,EACnB,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,4BAA4B,EAC5B,KAAK,wBAAwB,EAC7B,8BAA8B,EAC9B,KAAK,oBAAoB,EACzB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/port-lease/index.js

@@ -0,0 +1,3 @@
+export { MAX_PORT_LEASE_COUNT, MAX_PORT_LEASE_PAGE_SIZE, MAX_PORT_LEASE_PORT, MIN_PORT_LEASE_PORT, PORT_LEASE_AGGREGATE_TYPE, PORT_LEASE_ERROR_CODES, PORT_LEASE_SCHEMA_VERSION, portLeaseAcquireParametersSchema, portLeaseAcquireResultSchema, portLeaseListParametersSchema, portLeaseListResultSchema, portLeaseOwnerSchema, portLeaseReleaseParametersSchema, portLeaseReleaseResultSchema, portLeaseRenewParametersSchema, portLeaseRenewResultSchema, portLeaseSchema, } from "./contract.js";
+export { PORT_LEASE_FEATURE } from "./feature.js";
+//# sourceMappingURL=index.js.map

package/dist/port-lease/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/port-lease/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EAGzB,gCAAgC,EAEhC,4BAA4B,EAG5B,6BAA6B,EAE7B,yBAAyB,EAEzB,oBAAoB,EAEpB,gCAAgC,EAEhC,4BAA4B,EAE5B,8BAA8B,EAE9B,0BAA0B,EAC1B,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/port-lease/request-effect-schema.d.ts

@@ -0,0 +1,87 @@
+import * as Schema from "effect/Schema";
+export declare const PORT_LEASE_SCHEMA_VERSION = "maia.port-lease/v1";
+/** Ports below this need privileges and belong to system services. */
+export declare const MIN_PORT_LEASE_PORT = 1024;
+export declare const MAX_PORT_LEASE_PORT = 65535;
+export declare const MAX_PORT_LEASE_COUNT = 8;
+export declare const MAX_PORT_LEASE_PAGE_SIZE = 100;
+export declare const portLeasePortEffectSchema: Schema.Int;
+export declare const portLeaseRevisionEffectSchema: Schema.String;
+export declare const portLeaseOwnerEffectSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"session">;
+    readonly sessionId: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"principal">;
+    readonly principalId: Schema.String;
+}>]>;
+export declare const portLeaseEffectSchema: Schema.Struct<{
+    readonly endReason: Schema.optional<Schema.Literals<readonly ["owner_missing", "owner_released", "session_ended", "ttl_expired"]>>;
+    readonly expiresAt: Schema.String;
+    readonly grantedAt: Schema.String;
+    readonly leaseId: Schema.String;
+    readonly owner: Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"session">;
+        readonly sessionId: Schema.String;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"principal">;
+        readonly principalId: Schema.String;
+    }>]>;
+    readonly ports: Schema.$Array<Schema.Int>;
+    readonly purpose: Schema.String;
+    readonly revision: Schema.String;
+    readonly schemaVersion: Schema.Literal<"maia.port-lease/v1">;
+    readonly state: Schema.Literals<readonly ["active", "expired", "released"]>;
+    readonly updatedAt: Schema.String;
+}>;
+export declare const portLeaseAcquireParametersEffectSchema: Schema.Struct<{
+    readonly commandId: Schema.String;
+    readonly count: Schema.optional<Schema.Int>;
+    readonly preferred: Schema.optional<Schema.Int>;
+    readonly purpose: Schema.String;
+    readonly sessionId: Schema.optional<Schema.String>;
+}>;
+export declare const portLeaseRenewParametersEffectSchema: Schema.Struct<{
+    readonly commandId: Schema.String;
+    readonly expectedRevision: Schema.String;
+    readonly leaseId: Schema.String;
+}>;
+export declare const portLeaseReleaseParametersEffectSchema: Schema.Struct<{
+    readonly commandId: Schema.String;
+    readonly leaseId: Schema.String;
+}>;
+export declare const portLeaseListParametersEffectSchema: Schema.Struct<{
+    readonly afterCursor: Schema.optional<Schema.String>;
+    readonly limit: Schema.Int;
+    readonly sessionId: Schema.optional<Schema.String>;
+}>;
+export declare const portLeaseRequestEffectSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly method: Schema.Literal<"port.lease.acquire">;
+    readonly parameters: Schema.Struct<{
+        readonly commandId: Schema.String;
+        readonly count: Schema.optional<Schema.Int>;
+        readonly preferred: Schema.optional<Schema.Int>;
+        readonly purpose: Schema.String;
+        readonly sessionId: Schema.optional<Schema.String>;
+    }>;
+}>, Schema.Struct<{
+    readonly method: Schema.Literal<"port.lease.list">;
+    readonly parameters: Schema.Struct<{
+        readonly afterCursor: Schema.optional<Schema.String>;
+        readonly limit: Schema.Int;
+        readonly sessionId: Schema.optional<Schema.String>;
+    }>;
+}>, Schema.Struct<{
+    readonly method: Schema.Literal<"port.lease.release">;
+    readonly parameters: Schema.Struct<{
+        readonly commandId: Schema.String;
+        readonly leaseId: Schema.String;
+    }>;
+}>, Schema.Struct<{
+    readonly method: Schema.Literal<"port.lease.renew">;
+    readonly parameters: Schema.Struct<{
+        readonly commandId: Schema.String;
+        readonly expectedRevision: Schema.String;
+        readonly leaseId: Schema.String;
+    }>;
+}>]>;
+//# sourceMappingURL=request-effect-schema.d.ts.map

package/dist/port-lease/request-effect-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-effect-schema.d.ts","sourceRoot":"","sources":["../../src/port-lease/request-effect-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAQxC,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAC9D,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,eAAO,MAAM,yBAAyB,YAKrC,CAAC;AAIF,eAAO,MAAM,6BAA6B,eAC4B,CAAC;AAavE,eAAO,MAAM,0BAA0B;;;;;;IAGrC,CAAC;AAkBH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAoBjC,CAAC;AAEF,eAAO,MAAM,sCAAsC;;;;;;EAUjD,CAAC;AACH,eAAO,MAAM,oCAAoC;;;;EAI/C,CAAC;AACH,eAAO,MAAM,sCAAsC;;;EAGjD,CAAC;AACH,eAAO,MAAM,mCAAmC;;;;EAM9C,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBvC,CAAC"}