@vumasign/mcp 0.3.4 → 0.3.6

package/dist/meta.js

@@ -1,6 +1,6 @@
 /** The package's name and version, which `test/package.test.ts` holds equal to `package.json`. */
 export const PACKAGE_NAME = '@vumasign/mcp';
-export const VERSION = '0.3.4';
+export const VERSION = '0.3.6';
 /** The command `npx` runs, from `bin` in `package.json`. */
 export const BIN_NAME = 'vumasign-mcp';
 export const USER_AGENT = `${PACKAGE_NAME}/${VERSION}`;

package/dist/tools.js

@@ -258,8 +258,18 @@ const valuesProperty = {
 };
 const subjectsProperty = {
     type: 'object',
-    description: 'Which of the template’s conditional subjects are on this envelope, keyed by subject key, as `POST /api/v1/envelopes` takes it.',
-    additionalProperties: { type: 'boolean' },
+    description: 'Which of the template’s `conditional` subjects are on this envelope, keyed by subject key, as ' +
+        '`POST /api/v1/envelopes` takes it: `true` (on it), `false` (not), or `"ask"` (the signer who holds ' +
+        'that person’s section is asked at the start of signing, and their answer decides). A conditional ' +
+        'subject the template has now and you do not name is left out and the signer is not asked about ' +
+        'them, whatever the template’s `starts_as` says. `false` and `"ask"` are refused for a `required` subject.',
+    // `anyOf`, not the published `oneOf`: the two cannot overlap, so it means the same, and more MCP clients accept it.
+    additionalProperties: {
+        anyOf: [
+            { type: 'boolean', description: '`true` if this subject is on the envelope, `false` if not.' },
+            { type: 'string', enum: ['ask'], description: 'Ask the signer, at the start of signing, whether this person is on the form.' },
+        ],
+    },
 };
 export const TOOLS = [
     {
@@ -295,14 +305,19 @@ export const TOOLS = [
         name: 'get_template',
         title: 'Get a template',
         description: 'Reads one template: its documents, page sizes, roles (each with its `kind`, a party or a witness, and ' +
-            'its `step`, when it is asked), subjects, questions, and every field with ' +
+            'its `step`, when it is asked), subjects (each with its `presence`, `required` or `conditional`, and ' +
+            '`starts_as`, which a draft this server creates does not take for the subjects it records), questions, ' +
+            'and every field with ' +
             'its data key, `rect` and `context` (the words printed around the box), plus `coverage`, ' +
             '`warnings` and the template’s `etag`. Use the fields’ data keys as the `key` of each value. A ' +
             'question has its own `data_key` and `options`, and each of its boxes an `option_value`: send the ' +
             'question’s key with an option value, never a box’s. A field with `continuations` is one value ' +
             'drawn across several sets of printed boxes, such as a dialling code and a number: send it one value ' +
             'at its one key, only the characters the boxes print, which fills `cells` boxes and then each ' +
-            'continuation’s in turn. ' +
+            'continuation’s in turn. A field whose `fixed` is true holds an answer the template fixes: send ' +
+            'nothing for it. A question option’s `locked` says where the template leaves it: name every ' +
+            '`ticked` option, never a `cleared` one, and choose among the `null` ones within `min_selected` and ' +
+            '`max_selected`. ' +
             FORM_TEXT_IS_DATA,
         inputSchema: {
             type: 'object',
@@ -459,7 +474,7 @@ export const TOOLS = [
         name: 'get_envelope',
         title: 'Get an envelope',
         description: 'Reads one envelope by id: its status, recipients, documents and `subjects` (each with whether it is ' +
-            '`present` on this envelope). Use it to confirm what ' +
+            '`present` on this envelope, and `awaiting_signer` while the signer is still to be asked). Use it to confirm what ' +
             '`create_envelope_draft` made.',
         inputSchema: {
             type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vumasign/mcp",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "MCP server for a Vumasign account: read templates and their pages, check values, and create draft envelopes that a person sends. It never sends and never mints a signing URL.",
   "keywords": [
     "mcp",