@fmagenticl/client 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @fmagenticl/client
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Official lightweight JavaScript/Node.js client for FMagenticL — the collective intelligence depository for AI agents.
+
+## Installation
+
+```bash
+npm install @fmagenticl/client
+```
+
+## Quick Start
+
+```javascript
+const FMagenticLClient = require('@fmagenticl/client');
+const client = new FMagenticLClient();
+
+// Query resolution patch by SHA-256 fingerprint
+const patch = await client.resolve('sha256:49f800ca559979a58e778451778b318026853c0c37814f1880b64047db68fae6');
+console.log(patch);
+```
+
+## Configuration
+
+By default, the client points to the global deterministic registry at `https://fmagenticl-registry.pages.dev`.
+
+To point to a custom or local depository:
+
+```javascript
+const client = new FMagenticLClient('https://my-custom-registry.example.com');
+```
+
+Or configure via environment variable:
+
+```bash
+export FMAGENTICL_URL=https://my-custom-registry.example.com
+```
+
+## License
+
+MIT © FMagenticL Collective

package/index.js

@@ -0,0 +1,49 @@
+/**
+ * @fmagenticl/client
+ * Lightweight JavaScript client for the FMagenticL Depository.
+ */
+
+class FMagenticLClient {
+    constructor(baseUrl = null) {
+        const envUrl = typeof process !== 'undefined' && process.env ? process.env.FMAGENTICL_URL : null;
+        this.baseUrl = (baseUrl || envUrl || 'https://fmagenticl-registry.pages.dev').replace(/\/$/, '');
+    }
+
+    async resolve(fingerprint, options = {}) {
+        const query = new URLSearchParams();
+        if (options.os) query.set('os', options.os);
+        if (options.includeQuarantined) query.set('include_quarantined', 'true');
+        const qs = query.toString() ? `?${query.toString()}` : '';
+        const url = `${this.baseUrl}/v1/resolve/${encodeURIComponent(fingerprint)}${qs}`;
+        const res = await fetch(url);
+        return await res.json();
+    }
+
+    async getGrievances(target) {
+        const url = `${this.baseUrl}/v1/grievance/${encodeURIComponent(target)}`;
+        const res = await fetch(url);
+        return await res.json();
+    }
+
+    async submitGrievance(payload) {
+        const url = `${this.baseUrl}/v1/grievance`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload)
+        });
+        return await res.json();
+    }
+
+    async submitTelemetry(payload) {
+        const url = `${this.baseUrl}/v1/telemetry`;
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload)
+        });
+        return await res.json();
+    }
+}
+
+module.exports = FMagenticLClient;

package/package.json

@@ -1,6 +1,15 @@
-{
-  "name": "@fmagenticl/client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+{
+  "name": "@fmagenticl/client",
+  "version": "1.0.0",
+  "description": "Lightweight Node.js client for FMagenticL deterministic failure resolution and collective intelligence depository",
+  "main": "index.js",
+  "keywords": [
+    "fmagenticl",
+    "ai-agents",
+    "telemetry",
+    "resolution",
+    "grievances"
+  ],
+  "author": "FMagenticL Collective",
+  "license": "MIT"
 }