@sentropic/h2a-cli 0.1.0 → 0.1.6

package/dist/runtime/mcp/tools.js

@@ -0,0 +1,175 @@
+import { H2A_CLI_MCP_TOOL_NAMES } from "../../mcp.js";
+/**
+ * Canonical tool descriptors for the in-process MCP server. Schemas are
+ * intentionally permissive — wire-level validation lives in the store /
+ * @sentropic/h2a invariants, not in the MCP shim.
+ */
+export const H2A_CLI_MCP_TOOL_DESCRIPTORS = [
+    {
+        name: "h2a_register_instance",
+        description: "Register an h2a instance (PRINCIPAL / CONDUCTOR / AGENT / ...) in the local registry.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                registration: {
+                    type: "object",
+                    description: "Full H2AActorRegistration record."
+                }
+            },
+            required: ["registration"]
+        }
+    },
+    {
+        name: "h2a_discover_instances",
+        description: "List instances from the registry, optionally filtered by role and/or scope.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                role: { type: "string" },
+                scope: { type: "string" }
+            }
+        }
+    },
+    {
+        name: "h2a_open_negotiation",
+        description: "Open a new negotiation. The record is persisted under negotiations/<id>/state.json.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                record: {
+                    type: "object",
+                    description: "Full H2ANegotiationRecord: { id, scope, parties, subject, status, requiredSigners, ... }."
+                }
+            },
+            required: ["record"]
+        }
+    },
+    {
+        name: "h2a_offer",
+        description: "Submit an initial offer (journal entry, type=propose) bearing the current artifact.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                negotiationId: { type: "string" },
+                instance: {
+                    type: "string",
+                    description: "Conductor instance id producing the offer."
+                },
+                artifact: {
+                    description: "Arbitrary JSON-serializable artifact to propose."
+                },
+                eventId: {
+                    type: "string",
+                    description: "Optional deterministic event id; generated if absent."
+                }
+            },
+            required: ["negotiationId", "instance", "artifact"]
+        }
+    },
+    {
+        name: "h2a_counteroffer",
+        description: "Submit a counter-offer (journal entry, type=counter) bearing a revised artifact.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                negotiationId: { type: "string" },
+                instance: {
+                    type: "string",
+                    description: "Conductor instance id producing the counter-offer."
+                },
+                artifact: {
+                    description: "Arbitrary JSON-serializable artifact to counter with."
+                },
+                eventId: {
+                    type: "string",
+                    description: "Optional deterministic event id; generated if absent."
+                }
+            },
+            required: ["negotiationId", "instance", "artifact"]
+        }
+    },
+    {
+        name: "h2a_sign",
+        description: "Sign the canonical {artifactHash} of an artifact with an ed25519 PEM-encoded private key. The signature is appended as a journal event with body.kind='signature'.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                negotiationId: { type: "string" },
+                instance: { type: "string" },
+                artifact: {
+                    description: "JSON-serializable artifact whose canonical hash is signed."
+                },
+                privateKeyPem: {
+                    type: "string",
+                    description: "ed25519 PKCS#8 PEM-encoded private key contents (NOT a file path)."
+                },
+                eventId: { type: "string" }
+            },
+            required: ["negotiationId", "instance", "artifact", "privateKeyPem"]
+        }
+    },
+    {
+        name: "h2a_stabilize",
+        description: "Stabilize a negotiation once the registered signers' ed25519 signatures form a quorum on a single artifactHash. Returns the stabilized record and the winning hash.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                negotiationId: { type: "string" },
+                eventId: {
+                    type: "string",
+                    description: "Optional deterministic id for the final 'stabilized' event."
+                }
+            },
+            required: ["negotiationId"]
+        }
+    },
+    {
+        name: "h2a_inbox",
+        description: "Inbox dispatch — read | put | pop envelopes for a given instance.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                action: { type: "string", enum: ["read", "put", "pop"] },
+                instance: { type: "string" },
+                envelope: { type: "object" },
+                envelopeId: { type: "string" }
+            },
+            required: ["action", "instance"]
+        }
+    },
+    {
+        name: "h2a_append_journal",
+        description: "Append a journal event to a negotiation's chained journal.jsonl.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                negotiationId: { type: "string" },
+                payload: { type: "object" }
+            },
+            required: ["negotiationId", "payload"]
+        }
+    },
+    {
+        name: "h2a_escalate",
+        description: "Escalate a negotiation to a higher control surface. Appends a journal event with type=escalate carrying { kind: 'escalation', channel, payload }.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                negotiationId: { type: "string" },
+                instance: {
+                    type: "string",
+                    description: "Instance performing the escalation (acts as MANDATAIRE)."
+                },
+                channel: {
+                    type: "string",
+                    enum: ["advise", "decide", "alert"]
+                },
+                payload: {
+                    description: "Arbitrary JSON-serializable escalation payload."
+                }
+            },
+            required: ["negotiationId", "instance", "channel"]
+        }
+    }
+];
+//# sourceMappingURL=tools.js.map

package/dist/runtime/mcp/tools.js.map

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

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@sentropic/h2a-cli",
-  "version": "0.1.0",
+  "version": "0.1.6",
   "description": "Unified CLI surface for h2a hosts and MCP-oriented coordination flows.",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "scripts": {
+    "prepack": "chmod +x dist/bin.js"
+  },
   "bin": {
-    "h2a": "./dist/bin.js"
+    "h2a": "dist/bin.js"
   },
   "keywords": [
     "h2a",
@@ -36,7 +39,7 @@
     "dist"
   ],
   "dependencies": {
-    "@sentropic/h2a": "^0.1.0"
+    "@sentropic/h2a": "^0.1.6"
   },
   "publishConfig": {
     "access": "public"