@compforge/harness-common 0.5.13 → 0.5.14

package/README.md

@@ -217,7 +217,12 @@ usage protection and reclamation belong to consumers. See [the shared contract](
 `Endpoint` describes a network access address: optional lowercase `scheme`, `host`, explicit
 `port`, and optional `secure`. It is independent of the Service, DataSource or resource behind
 that address. IPv6 hosts are unbracketed. Credentials, paths, query parameters, execution
-locations and timeouts are not part of this contract.
+adapters and timeouts are not part of this contract.
+
+Optional `id` and `description` identify and describe the dependency within its consumer.
+Optional `workload` names the consumer Workload from which the address is accessed, not the
+remote Service. Consumers resolve and validate that reference; a declaration does not discover
+instances or grant access. Protocol probing can consume the address fields alone.
 
 `secure: true` requires encrypted transport; the protocol determines whether it uses direct
 TLS or protocol-specific negotiation. Omission makes no encryption requirement. HTTPS/WSS/TLS

package/dist/access/endpoint.d.ts

@@ -1,10 +1,16 @@
 /**
  * A network access address, independent of the Service, DataSource or resource behind it.
- * @spec Endpoint contains no credentials, resource path, query or execution location.
+ * @spec Endpoint contains no credentials, resource path, query or execution adapter.
  * @spec secure requires encrypted transport; the scheme determines how it is established.
  * It does not assert reachability, trust-policy approval or application authorization.
  */
 export interface Endpoint {
+    /** Optional identity within the declaring consumer; not a network address. */
+    readonly id?: string;
+    /** Human-readable description; never credentials or a signed resource URL. */
+    readonly description?: string;
+    /** Canonical consumer Workload name, not the remote Service or destination workload. */
+    readonly workload?: string;
     /** Lowercase URI scheme without a colon; protocol metadata, not a health assertion. */
     readonly scheme?: string;
     /** Hostname or IP literal; IPv6 literals have no surrounding brackets. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-common",
-  "version": "0.5.13",
+  "version": "0.5.14",
   "description": "Execution-neutral client lifecycle and datasource contracts for harnesses",
   "type": "module",
   "scripts": {