@wowok/agent-mcp 3.4.3 → 3.4.4

package/dist/schemas/wip_file.schema.json

@@ -1,299 +1 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/wip_file.json",
-  "title": "WIP File Operations",
-  "description": "Generate, verify, sign, or convert WIP files",
-  "oneOf": [
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "generate"
-        },
-        "options": {
-          "type": "object",
-          "properties": {
-            "markdown_text": {
-              "type": "string",
-              "maxLength": 10000,
-              "description": "Markdown formatted text content"
-            },
-            "images": {
-              "description": "Optional image list",
-              "maxItems": 10,
-              "type": "array",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "source": {
-                    "type": "string",
-                    "description": "Image source path or URL. Supports: 1) Local file path (e.g., '/path/to/image.png', 'C:\\Users\\name\\image.jpg'), 2) Network URL (e.g., 'https://example.com/image.png', 'http://site.com/photo.jpg'), 3) Data URL (e.g., 'data:image/png;base64,iVBORw0K...')"
-                  },
-                  "id": {
-                    "description": "Optional image ID for reference in the WIP content. If not provided, an ID will be auto-generated based on index (e.g., 'image_0', 'image_1')",
-                    "type": "string"
-                  },
-                  "filename": {
-                    "description": "Optional file name. If not provided, will be extracted from URL path or local file name",
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "source"
-                ],
-                "additionalProperties": false,
-                "description": "Image source for WIP generation"
-              }
-            },
-            "account": {
-              "description": "Optional signing account (account name or address). If specified, uses Account module for signing",
-              "type": "string"
-            }
-          },
-          "required": [
-            "markdown_text"
-          ],
-          "additionalProperties": false,
-          "description": "WIP generation options"
-        },
-        "outputPath": {
-          "description": "Output file path (.wip file). If not specified, defaults to the workspace directory",
-          "type": "string"
-        }
-      },
-      "required": [
-        "type",
-        "options"
-      ],
-      "additionalProperties": false,
-      "description": "Generate WIP file from markdown text and optional images"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "verify"
-        },
-        "wipFilePath": {
-          "type": "string",
-          "description": "WIP file path to verify. Supports: 1) Local file path (e.g., '/path/to/file.wip', 'C:\\Users\\name\\doc.wip'), 2) Network URL (e.g., 'https://example.com/doc.wip', 'http://site.com/file.wip'), 3) Data URL (e.g., 'data:application/json;base64,eyJ3aXAiOi...')"
-        },
-        "hash_equal": {
-          "description": "Optional expected COMMITMENT hash (F-23 field clarification). Compared against the file's meta.hash — the CANONICAL commitment hash (sha256 over key-sorted, whitespace-free {wip, payload} JSON, meta excluded), which is exactly what the Service anchors on-chain as wip_hash. This is NOT the sha256 of the raw downloaded file bytes (the verify result carries that separately as content_sha256): comparing a raw-file digest against meta.hash / the on-chain wip_hash always false-negatives (ddmc4 B-23). If not matched, returns hash mismatch error.",
-          "type": "string"
-        },
-        "requireSignature": {
-          "description": "Optional flag to require digital signature. If true, verification will fail if WIP file has no signature",
-          "type": "boolean"
-        }
-      },
-      "required": [
-        "type",
-        "wipFilePath"
-      ],
-      "additionalProperties": false,
-      "description": "Verify WIP file integrity and signatures"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "sign"
-        },
-        "wipFilePath": {
-          "type": "string",
-          "description": "WIP file path to sign. Supports: 1) Local file path (e.g., '/path/to/file.wip'), 2) Network URL (e.g., 'https://example.com/doc.wip'). The file will be loaded, validated, and signed"
-        },
-        "account": {
-          "description": "Signing account (account name or address). If not specified, uses default account",
-          "type": "string"
-        },
-        "outputPath": {
-          "description": "Output file path. If not specified, adds 'signed_' prefix to original file name (e.g., 'doc.wip' becomes 'signed_doc.wip')",
-          "type": "string"
-        }
-      },
-      "required": [
-        "type",
-        "wipFilePath"
-      ],
-      "additionalProperties": false,
-      "description": "Sign WIP file with account"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "wip2html"
-        },
-        "wipPath": {
-          "type": "string",
-          "description": "WIP file path or directory path. Supports: 1) Single WIP file (e.g., '/path/to/file.wip'), 2) Directory containing .wip files (e.g., '/path/to/wips/'), 3) Network URL (e.g., 'https://example.com/doc.wip'). When directory is provided, all .wip files in the directory will be converted to HTML"
-        },
-        "options": {
-          "description": "Conversion options",
-          "type": "object",
-          "properties": {
-            "title": {
-              "description": "HTML page title",
-              "type": "string"
-            },
-            "theme": {
-              "description": "Theme style",
-              "anyOf": [
-                {
-                  "type": "string",
-                  "const": "light"
-                },
-                {
-                  "type": "string",
-                  "const": "dark"
-                }
-              ]
-            },
-            "outputPath": {
-              "description": "Output file path (if specified, saves to file). For single file: saves HTML to this path. For directory: saves all converted HTML files to this directory",
-              "type": "string"
-            }
-          },
-          "additionalProperties": false
-        }
-      },
-      "required": [
-        "type",
-        "wipPath"
-      ],
-      "additionalProperties": false,
-      "description": "Convert WIP file to HTML format"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "upload"
-        },
-        "wipFilePath": {
-          "type": "string",
-          "description": "WIP file to upload. Supports: 1) Local file path, 2) Network URL, 3) Data URL"
-        },
-        "account": {
-          "description": "Account used to sign the upload (name or address). If omitted, uses the default account",
-          "type": "string"
-        },
-        "storage": {
-          "description": "Storage backend: 'store' = official free wip.store.wowok.net (zero setup, max 10 files per account, files retained 6 months — free best-effort service, force majeure excepted, expired files are purged only by manual admin action, never automatically); 'custom' = your own or a third-party wip storage service via customBaseUrl (recommended: no store quota, full control). Default: 'store'",
-          "anyOf": [
-            {
-              "type": "string",
-              "const": "store",
-              "description": "Official free wip.store.wowok.net storage (zero setup, max 10 files per account, files retained 6 months). Declaration: free best-effort service — availability and data survival are not guaranteed (force majeure excepted); expired files are deleted ONLY by a manual administrator purge, never automatically"
-            },
-            {
-              "type": "string",
-              "const": "custom",
-              "description": "Your own or a third-party wip storage service (recommended: no store quota, full control, permanent self-managed hosting)"
-            }
-          ]
-        },
-        "customBaseUrl": {
-          "description": "Base URL of your own or a third-party wip storage deployment (required when storage='custom'), e.g. 'https://wip.example.com'",
-          "type": "string"
-        },
-        "name": {
-          "description": "Optional display name recorded with the stored file",
-          "type": "string"
-        }
-      },
-      "required": [
-        "type",
-        "wipFilePath"
-      ],
-      "additionalProperties": false,
-      "description": "Upload a signed WIP file to a wip storage service. The upload request is signed with the account's Falcon512 key; the file is validated (format, size limits, content hash, signatures) and stored under its CANONICAL COMMITMENT hash (meta.hash — the same value a Service anchors on-chain as wip_hash; NOT the raw-file sha256) with a public download URL. The upload response's `hash` field IS that commitment value: pass it directly as the sale row's wip_hash (template_generate writes it back automatically when this session performed the upload). When the per-account file limit is reached, the error carries the account's stored file list for deletion. Large, image-heavy WIP files are network-sensitive: keep them small (compress images before generate) and retry on transient network failures. WIP files are off-chain and network-independent: the returned public URL works on both testnet and mainnet"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "storage_list"
-        },
-        "account": {
-          "description": "Account used to sign the request (name or address). If omitted, uses the default account",
-          "type": "string"
-        },
-        "storage": {
-          "description": "Storage backend (default 'store')",
-          "anyOf": [
-            {
-              "type": "string",
-              "const": "store",
-              "description": "Official free wip.store.wowok.net storage (zero setup, max 10 files per account, files retained 6 months). Declaration: free best-effort service — availability and data survival are not guaranteed (force majeure excepted); expired files are deleted ONLY by a manual administrator purge, never automatically"
-            },
-            {
-              "type": "string",
-              "const": "custom",
-              "description": "Your own or a third-party wip storage service (recommended: no store quota, full control, permanent self-managed hosting)"
-            }
-          ]
-        },
-        "customBaseUrl": {
-          "description": "Base URL of your own or a third-party wip storage deployment (required when storage='custom')",
-          "type": "string"
-        }
-      },
-      "required": [
-        "type"
-      ],
-      "additionalProperties": false,
-      "description": "List the WIP files an account currently stores on a wip storage service (signed request). Off-chain and network-independent: the account's stored files are identical on testnet and mainnet — no chain call is involved"
-    },
-    {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "const": "storage_delete"
-        },
-        "hash": {
-          "type": "string",
-          "description": "Hash (meta.hash) of the WIP file to delete"
-        },
-        "account": {
-          "description": "Account used to sign the request (name or address). If omitted, uses the default account",
-          "type": "string"
-        },
-        "storage": {
-          "description": "Storage backend (default 'store')",
-          "anyOf": [
-            {
-              "type": "string",
-              "const": "store",
-              "description": "Official free wip.store.wowok.net storage (zero setup, max 10 files per account, files retained 6 months). Declaration: free best-effort service — availability and data survival are not guaranteed (force majeure excepted); expired files are deleted ONLY by a manual administrator purge, never automatically"
-            },
-            {
-              "type": "string",
-              "const": "custom",
-              "description": "Your own or a third-party wip storage service (recommended: no store quota, full control, permanent self-managed hosting)"
-            }
-          ]
-        },
-        "customBaseUrl": {
-          "description": "Base URL of your own or a third-party wip storage deployment (required when storage='custom')",
-          "type": "string"
-        }
-      },
-      "required": [
-        "type",
-        "hash"
-      ],
-      "additionalProperties": false,
-      "description": "Delete a stored WIP file from a wip storage service. Only files owned by the signing account can be deleted (signed request; off-chain, works identically on testnet and mainnet)"
-    }
-  ]
-}
+{"$schema":"http://json-schema.org/draft-07/schema#","$id":"https://wowok.net/schemas/wip_file.json","title":"WIP File Operations","description":"Generate, verify, sign, or convert WIP files","oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"generate"},"options":{"type":"object","properties":{"markdown_text":{"type":"string","maxLength":10000,"description":"Markdown formatted text content"},"images":{"description":"Optional image list","maxItems":10,"type":"array","items":{"type":"object","properties":{"source":{"type":"string","description":"Image source path or URL. Supports: 1) Local file path (e.g., '/path/to/image.png', 'C:\\Users\\name\\image.jpg'), 2) Network URL (e.g., 'https://example.com/image.png', 'http://site.com/photo.jpg'), 3) Data URL (e.g., 'data:image/png;base64,iVBORw0K...')"},"id":{"description":"Optional image ID for reference in the WIP content. If not provided, an ID will be auto-generated based on index (e.g., 'image_0', 'image_1')","type":"string"},"filename":{"description":"Optional file name. If not provided, will be extracted from URL path or local file name","type":"string"}},"required":["source"],"additionalProperties":false,"description":"Image source for WIP generation"}},"account":{"description":"Optional signing account (account name or address). If specified, uses Account module for signing","type":"string"}},"required":["markdown_text"],"additionalProperties":false,"description":"WIP generation options"},"outputPath":{"description":"Output file path (.wip file). If not specified, defaults to the workspace directory","type":"string"}},"required":["type","options"],"additionalProperties":false,"description":"Generate WIP file from markdown text and optional images"},{"type":"object","properties":{"type":{"type":"string","const":"verify"},"wipFilePath":{"type":"string","description":"WIP file path to verify. Supports: 1) Local file path (e.g., '/path/to/file.wip', 'C:\\Users\\name\\doc.wip'), 2) Network URL (e.g., 'https://example.com/doc.wip', 'http://site.com/file.wip'), 3) Data URL (e.g., 'data:application/json;base64,eyJ3aXAiOi...')"},"hash_equal":{"description":"Optional expected COMMITMENT hash (F-23 field clarification). Compared against the file's meta.hash — the CANONICAL commitment hash (sha256 over key-sorted, whitespace-free {wip, payload} JSON, meta excluded), which is exactly what the Service anchors on-chain as wip_hash. This is NOT the sha256 of the raw downloaded file bytes (the verify result carries that separately as content_sha256): comparing a raw-file digest against meta.hash / the on-chain wip_hash always false-negatives (ddmc4 B-23). If not matched, returns hash mismatch error.","type":"string"},"requireSignature":{"description":"Optional flag to require digital signature. If true, verification will fail if WIP file has no signature","type":"boolean"}},"required":["type","wipFilePath"],"additionalProperties":false,"description":"Verify WIP file integrity and signatures"},{"type":"object","properties":{"type":{"type":"string","const":"sign"},"wipFilePath":{"type":"string","description":"WIP file path to sign. Supports: 1) Local file path (e.g., '/path/to/file.wip'), 2) Network URL (e.g., 'https://example.com/doc.wip'). The file will be loaded, validated, and signed"},"account":{"description":"Signing account (account name or address). If not specified, uses default account","type":"string"},"outputPath":{"description":"Output file path. If not specified, adds 'signed_' prefix to original file name (e.g., 'doc.wip' becomes 'signed_doc.wip')","type":"string"}},"required":["type","wipFilePath"],"additionalProperties":false,"description":"Sign WIP file with account"},{"type":"object","properties":{"type":{"type":"string","const":"wip2html"},"wipPath":{"type":"string","description":"WIP file path or directory path. Supports: 1) Single WIP file (e.g., '/path/to/file.wip'), 2) Directory containing .wip files (e.g., '/path/to/wips/'), 3) Network URL (e.g., 'https://example.com/doc.wip'). When directory is provided, all .wip files in the directory will be converted to HTML"},"options":{"description":"Conversion options","type":"object","properties":{"title":{"description":"HTML page title","type":"string"},"theme":{"description":"Theme style","anyOf":[{"type":"string","const":"light"},{"type":"string","const":"dark"}]},"outputPath":{"description":"Output file path (if specified, saves to file). For single file: saves HTML to this path. For directory: saves all converted HTML files to this directory","type":"string"}},"additionalProperties":false}},"required":["type","wipPath"],"additionalProperties":false,"description":"Convert WIP file to HTML format"},{"type":"object","properties":{"type":{"type":"string","const":"upload"},"wipFilePath":{"type":"string","description":"WIP file to upload. Supports: 1) Local file path, 2) Network URL, 3) Data URL"},"account":{"description":"Account used to sign the upload (name or address). If omitted, uses the default account","type":"string"},"storage":{"description":"Storage backend: 'store' = official free wip.store.wowok.net (zero setup, max 10 files per account, files retained 6 months — free best-effort service, force majeure excepted, expired files are purged only by manual admin action, never automatically); 'custom' = your own or a third-party wip storage service via customBaseUrl (recommended: no store quota, full control). Default: 'store'","anyOf":[{"type":"string","const":"store","description":"Official free wip.store.wowok.net storage (zero setup, max 10 files per account, files retained 6 months). Declaration: free best-effort service — availability and data survival are not guaranteed (force majeure excepted); expired files are deleted ONLY by a manual administrator purge, never automatically"},{"type":"string","const":"custom","description":"Your own or a third-party wip storage service (recommended: no store quota, full control, permanent self-managed hosting)"}]},"customBaseUrl":{"description":"Base URL of your own or a third-party wip storage deployment (required when storage='custom'), e.g. 'https://wip.example.com'","type":"string"},"name":{"description":"Optional display name recorded with the stored file","type":"string"}},"required":["type","wipFilePath"],"additionalProperties":false,"description":"Upload a signed WIP file to a wip storage service. The upload request is signed with the account's Falcon512 key; the file is validated (format, size limits, content hash, signatures) and stored under its CANONICAL COMMITMENT hash (meta.hash — the same value a Service anchors on-chain as wip_hash; NOT the raw-file sha256) with a public download URL. The upload response's `hash` field IS that commitment value: pass it directly as the sale row's wip_hash (template_generate writes it back automatically when this session performed the upload). When the per-account file limit is reached, the error carries the account's stored file list for deletion. Large, image-heavy WIP files are network-sensitive: keep them small (compress images before generate) and retry on transient network failures. WIP files are off-chain and network-independent: the returned public URL works on both testnet and mainnet"},{"type":"object","properties":{"type":{"type":"string","const":"storage_list"},"account":{"description":"Account used to sign the request (name or address). If omitted, uses the default account","type":"string"},"storage":{"description":"Storage backend (default 'store')","anyOf":[{"type":"string","const":"store","description":"Official free wip.store.wowok.net storage (zero setup, max 10 files per account, files retained 6 months). Declaration: free best-effort service — availability and data survival are not guaranteed (force majeure excepted); expired files are deleted ONLY by a manual administrator purge, never automatically"},{"type":"string","const":"custom","description":"Your own or a third-party wip storage service (recommended: no store quota, full control, permanent self-managed hosting)"}]},"customBaseUrl":{"description":"Base URL of your own or a third-party wip storage deployment (required when storage='custom')","type":"string"}},"required":["type"],"additionalProperties":false,"description":"List the WIP files an account currently stores on a wip storage service (signed request). Off-chain and network-independent: the account's stored files are identical on testnet and mainnet — no chain call is involved"},{"type":"object","properties":{"type":{"type":"string","const":"storage_delete"},"hash":{"type":"string","description":"Hash (meta.hash) of the WIP file to delete"},"account":{"description":"Account used to sign the request (name or address). If omitted, uses the default account","type":"string"},"storage":{"description":"Storage backend (default 'store')","anyOf":[{"type":"string","const":"store","description":"Official free wip.store.wowok.net storage (zero setup, max 10 files per account, files retained 6 months). Declaration: free best-effort service — availability and data survival are not guaranteed (force majeure excepted); expired files are deleted ONLY by a manual administrator purge, never automatically"},{"type":"string","const":"custom","description":"Your own or a third-party wip storage service (recommended: no store quota, full control, permanent self-managed hosting)"}]},"customBaseUrl":{"description":"Base URL of your own or a third-party wip storage deployment (required when storage='custom')","type":"string"}},"required":["type","hash"],"additionalProperties":false,"description":"Delete a stored WIP file from a wip storage service. Only files owned by the signing account can be deleted (signed request; off-chain, works identically on testnet and mainnet)"}]}