@zerox1/client 0.4.2

package/dist/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAgBqB;AAfnB,4GAAA,oBAAoB,OAAA;AACpB,4GAAA,oBAAoB,OAAA;AACpB,4GAAA,oBAAoB,OAAA;AACpB,4GAAA,oBAAoB,OAAA;AACpB,2GAAA,mBAAmB,OAAA;AACnB,2GAAA,mBAAmB,OAAA;AACnB,6GAAA,qBAAqB,OAAA;AACrB,4GAAA,oBAAoB,OAAA;AACpB,yGAAA,iBAAiB,OAAA;AACjB,yGAAA,iBAAiB,OAAA;AACjB,yGAAA,iBAAiB,OAAA;AACjB,qGAAA,aAAa,OAAA;AACb,qGAAA,aAAa,OAAA;AACb,mGAAA,WAAW,OAAA;AACX,mGAAA,WAAW,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @zerox1/client — 0x01 application-layer SDK
+ *
+ * For building apps on top of 0x01 (dashboards, orchestrators, multi-agent
+ * systems) without running your own agent process.
+ *
+ * ## Quick start
+ *
+ * ```ts
+ * import { NodeClient, AggregatorClient, HostedFleet, decodeProposePayload } from '@zerox1/client'
+ *
+ * // 1. Discover agents from the public aggregator
+ * const agg = new AggregatorClient({ url: 'https://agg.0x01.world' })
+ * const agents = await agg.agents({ country: 'US', capabilities: 'code' })
+ *
+ * // 2. Manage multiple hosted agents on a node
+ * const fleet = new HostedFleet({ nodeUrl: 'http://localhost:9090' })
+ * const ceo = await fleet.register('ceo')
+ * const dev  = await fleet.register('dev')
+ *
+ * // 3. React to incoming messages
+ * ceo.on('PROPOSE', async (env, conv) => {
+ *   const p = decodeProposePayload(env.payload_b64)
+ *   if (!p) return  // malformed payload — always null-check decode results
+ *   console.log(`Proposal: ${p.message} for ${p.amount_micro} USDC micro`)
+ *   await ceo.accept({
+ *     recipient: env.sender,
+ *     conversationId: env.conversation_id,
+ *     amountMicro: p.amount_micro,
+ *   })
+ * })
+ * ceo.listen()
+ *
+ * // 4. Initiate work from your app
+ * const { conversation_id } = await ceo.propose({
+ *   recipient: agents[0].agent_id,
+ *   message: 'Build a REST API for our new product',
+ *   amountMicro: 10_000_000n, // 10 USDC
+ * })
+ * ```
+ */
+export { NodeClient } from './NodeClient.js';
+export type { NodeClientOptions, SendParams, ProposeParams, CounterParams, AcceptParams } from './NodeClient.js';
+export { HostedFleet, HostedAgent, Conversation, MultiFleet } from './HostedFleet.js';
+export type { HostedFleetOptions, HostedAgentOptions, HostedSendParams, TokenStore, MultiFleetOptions } from './HostedFleet.js';
+export { AggregatorClient } from './AggregatorClient.js';
+export type { AggregatorClientOptions } from './AggregatorClient.js';
+export { encodeProposePayload, decodeProposePayload, encodeCounterPayload, decodeCounterPayload, encodeAcceptPayload, decodeAcceptPayload, encodeFeedbackPayload, decodeDeliverPayload, encodeJsonPayload, decodeJsonPayload, newConversationId, bytesToBase64, base64ToBytes, hexToBase64, base64ToHex, } from './codec.js';
+export type { NegotiationMsgType, MsgType, InboundEnvelope, FeedbackPayload, NotarizeBidPayload, DeliverPayload, ProposePayload, CounterPayload, AcceptPayload, NodeIdentity, PeerSnapshot, ReputationSnapshot, SendResult, NegotiateResult, SkillMeta, ApiEvent, AgentRecord, AgentProfile, ActivityEvent, NetworkStats, HostingNode, AgentsParams, ActivityParams, } from './types.js';
+/** Public aggregator URL. Override with your own or enterprise aggregator. */
+export declare const PUBLIC_AGGREGATOR_URL = "https://agg.0x01.world";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AACrF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAE/H,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,SAAS,EACT,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,2BAA2B,CAAA"}

package/dist/index.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * @zerox1/client — 0x01 application-layer SDK
+ *
+ * For building apps on top of 0x01 (dashboards, orchestrators, multi-agent
+ * systems) without running your own agent process.
+ *
+ * ## Quick start
+ *
+ * ```ts
+ * import { NodeClient, AggregatorClient, HostedFleet, decodeProposePayload } from '@zerox1/client'
+ *
+ * // 1. Discover agents from the public aggregator
+ * const agg = new AggregatorClient({ url: 'https://agg.0x01.world' })
+ * const agents = await agg.agents({ country: 'US', capabilities: 'code' })
+ *
+ * // 2. Manage multiple hosted agents on a node
+ * const fleet = new HostedFleet({ nodeUrl: 'http://localhost:9090' })
+ * const ceo = await fleet.register('ceo')
+ * const dev  = await fleet.register('dev')
+ *
+ * // 3. React to incoming messages
+ * ceo.on('PROPOSE', async (env, conv) => {
+ *   const p = decodeProposePayload(env.payload_b64)
+ *   if (!p) return  // malformed payload — always null-check decode results
+ *   console.log(`Proposal: ${p.message} for ${p.amount_micro} USDC micro`)
+ *   await ceo.accept({
+ *     recipient: env.sender,
+ *     conversationId: env.conversation_id,
+ *     amountMicro: p.amount_micro,
+ *   })
+ * })
+ * ceo.listen()
+ *
+ * // 4. Initiate work from your app
+ * const { conversation_id } = await ceo.propose({
+ *   recipient: agents[0].agent_id,
+ *   message: 'Build a REST API for our new product',
+ *   amountMicro: 10_000_000n, // 10 USDC
+ * })
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PUBLIC_AGGREGATOR_URL = exports.base64ToHex = exports.hexToBase64 = exports.base64ToBytes = exports.bytesToBase64 = exports.newConversationId = exports.decodeJsonPayload = exports.encodeJsonPayload = exports.decodeDeliverPayload = exports.encodeFeedbackPayload = exports.decodeAcceptPayload = exports.encodeAcceptPayload = exports.decodeCounterPayload = exports.encodeCounterPayload = exports.decodeProposePayload = exports.encodeProposePayload = exports.AggregatorClient = exports.MultiFleet = exports.Conversation = exports.HostedAgent = exports.HostedFleet = exports.NodeClient = void 0;
+var NodeClient_js_1 = require("./NodeClient.js");
+Object.defineProperty(exports, "NodeClient", { enumerable: true, get: function () { return NodeClient_js_1.NodeClient; } });
+var HostedFleet_js_1 = require("./HostedFleet.js");
+Object.defineProperty(exports, "HostedFleet", { enumerable: true, get: function () { return HostedFleet_js_1.HostedFleet; } });
+Object.defineProperty(exports, "HostedAgent", { enumerable: true, get: function () { return HostedFleet_js_1.HostedAgent; } });
+Object.defineProperty(exports, "Conversation", { enumerable: true, get: function () { return HostedFleet_js_1.Conversation; } });
+Object.defineProperty(exports, "MultiFleet", { enumerable: true, get: function () { return HostedFleet_js_1.MultiFleet; } });
+var AggregatorClient_js_1 = require("./AggregatorClient.js");
+Object.defineProperty(exports, "AggregatorClient", { enumerable: true, get: function () { return AggregatorClient_js_1.AggregatorClient; } });
+var codec_js_1 = require("./codec.js");
+Object.defineProperty(exports, "encodeProposePayload", { enumerable: true, get: function () { return codec_js_1.encodeProposePayload; } });
+Object.defineProperty(exports, "decodeProposePayload", { enumerable: true, get: function () { return codec_js_1.decodeProposePayload; } });
+Object.defineProperty(exports, "encodeCounterPayload", { enumerable: true, get: function () { return codec_js_1.encodeCounterPayload; } });
+Object.defineProperty(exports, "decodeCounterPayload", { enumerable: true, get: function () { return codec_js_1.decodeCounterPayload; } });
+Object.defineProperty(exports, "encodeAcceptPayload", { enumerable: true, get: function () { return codec_js_1.encodeAcceptPayload; } });
+Object.defineProperty(exports, "decodeAcceptPayload", { enumerable: true, get: function () { return codec_js_1.decodeAcceptPayload; } });
+Object.defineProperty(exports, "encodeFeedbackPayload", { enumerable: true, get: function () { return codec_js_1.encodeFeedbackPayload; } });
+Object.defineProperty(exports, "decodeDeliverPayload", { enumerable: true, get: function () { return codec_js_1.decodeDeliverPayload; } });
+Object.defineProperty(exports, "encodeJsonPayload", { enumerable: true, get: function () { return codec_js_1.encodeJsonPayload; } });
+Object.defineProperty(exports, "decodeJsonPayload", { enumerable: true, get: function () { return codec_js_1.decodeJsonPayload; } });
+Object.defineProperty(exports, "newConversationId", { enumerable: true, get: function () { return codec_js_1.newConversationId; } });
+Object.defineProperty(exports, "bytesToBase64", { enumerable: true, get: function () { return codec_js_1.bytesToBase64; } });
+Object.defineProperty(exports, "base64ToBytes", { enumerable: true, get: function () { return codec_js_1.base64ToBytes; } });
+Object.defineProperty(exports, "hexToBase64", { enumerable: true, get: function () { return codec_js_1.hexToBase64; } });
+Object.defineProperty(exports, "base64ToHex", { enumerable: true, get: function () { return codec_js_1.base64ToHex; } });
+/** Public aggregator URL. Override with your own or enterprise aggregator. */
+exports.PUBLIC_AGGREGATOR_URL = 'https://agg.0x01.world';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;;;AAEH,iDAA4C;AAAnC,2GAAA,UAAU,OAAA;AAGnB,mDAAqF;AAA5E,6GAAA,WAAW,OAAA;AAAE,6GAAA,WAAW,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,4GAAA,UAAU,OAAA;AAG3D,6DAAwD;AAA/C,uHAAA,gBAAgB,OAAA;AAGzB,uCAgBmB;AAfjB,gHAAA,oBAAoB,OAAA;AACpB,gHAAA,oBAAoB,OAAA;AACpB,gHAAA,oBAAoB,OAAA;AACpB,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AACnB,+GAAA,mBAAmB,OAAA;AACnB,iHAAA,qBAAqB,OAAA;AACrB,gHAAA,oBAAoB,OAAA;AACpB,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,yGAAA,aAAa,OAAA;AACb,yGAAA,aAAa,OAAA;AACb,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AA6Bb,8EAA8E;AACjE,QAAA,qBAAqB,GAAG,wBAAwB,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Public mesh type extensions — re-exports @zerox1/core base types and adds
+ * public-mesh specific fields (geo, latency, system message types).
+ */
+import type { NegotiationMsgType, InboundEnvelope as CoreInboundEnvelope, AgentRecord as CoreAgentRecord, AgentsParams as CoreAgentsParams, NotarizeBidPayload } from '@zerox1/core';
+/** Full public mesh message type — negotiation + system messages. */
+export type MsgType = NegotiationMsgType | 'VERDICT' | 'ADVERTISE' | 'DISCOVER' | 'BEACON' | 'NOTARIZE_BID' | 'NOTARIZE_ASSIGN';
+/**
+ * Public mesh inbound envelope.
+ *
+ * `slot` is always present — it is the Solana slot at which the node
+ * processed the message. Use it for ordering or deduplication.
+ *
+ * `notarize_bid` is pre-decoded by the node and only present on
+ * NOTARIZE_BID messages. For all other types it is undefined.
+ */
+export type InboundEnvelope = CoreInboundEnvelope<MsgType> & {
+    /** Solana slot — always present on public mesh envelopes. */
+    slot: number;
+    /** Pre-decoded notarize bid — only present on NOTARIZE_BID messages. */
+    notarize_bid?: NotarizeBidPayload;
+};
+/** Agent record with geo and latency fields from the public mesh. */
+export interface AgentRecord extends CoreAgentRecord {
+    country?: string;
+    city?: string;
+    latency?: Record<string, number>;
+    geo_consistent?: boolean;
+}
+export interface AgentProfile extends AgentRecord {
+    total_tasks?: number;
+    total_disputes?: number;
+    last_active?: number;
+}
+/** Reputation snapshot with geo consistency data for the public mesh. */
+export interface ReputationSnapshot {
+    agent_id: string;
+    reliability: number;
+    cooperation: number;
+    total_tasks: number;
+    total_disputes: number;
+    last_active_epoch?: number;
+    country?: string;
+    city?: string;
+    latency?: Record<string, number>;
+    geo_consistent?: boolean;
+}
+/** Agent discovery params with geo and capability filtering. */
+export interface AgentsParams extends CoreAgentsParams {
+    country?: string;
+    capabilities?: string;
+}
+export type { NegotiationMsgType, FeedbackPayload, NotarizeBidPayload, DeliverPayload, ProposePayload, CounterPayload, AcceptPayload, NodeIdentity, PeerSnapshot, SendResult, NegotiateResult, SkillMeta, ApiEvent, ActivityEvent, NetworkStats, HostingNode, ActivityParams, } from '@zerox1/core';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,IAAI,mBAAmB,EACtC,WAAW,IAAI,eAAe,EAC9B,YAAY,IAAI,gBAAgB,EAChC,kBAAkB,EACnB,MAAM,cAAc,CAAA;AAIrB,qEAAqE;AACrE,MAAM,MAAM,OAAO,GACf,kBAAkB,GAClB,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,cAAc,GACd,iBAAiB,CAAA;AAErB;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG;IAC3D,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAClC,CAAA;AAID,qEAAqE;AACrE,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAID,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,eAAe,EACf,SAAS,EACT,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,cAAc,CAAA"}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Public mesh type extensions — re-exports @zerox1/core base types and adds
+ * public-mesh specific fields (geo, latency, system message types).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@zerox1/client",
+  "version": "0.4.2",
+  "description": "0x01 app-layer client SDK — talk to nodes and the aggregator without running an agent",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/0x01-a2a/node.git",
+    "directory": "packages/client"
+  },
+  "homepage": "https://0x01.world",
+  "keywords": [
+    "zerox1",
+    "0x01",
+    "agent",
+    "mesh",
+    "p2p",
+    "sdk",
+    "hosted"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "ws": "^8.18.0",
+    "@zerox1/core": "0.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0"
+  }
+}