← Files LuciaARCHIVED FILE
mcp-catalog.json
155 KB · Nov 11, 2026 · 18:09 UTC
{
"schema_version": 1,
"product": "lucia",
"version": "0.1.230",
"services": [
{
"name": "luciaPromptOptimizer",
"initialize": {
"protocolVersion": "2024-11-05",
"serverInfo": {
"name": "prompt-optimizer-widgets",
"version": "0.1.54"
},
"capabilities": {
"tools": {},
"prompts": {}
},
"instructions": "Review this Lucia workflow in chat and its professional documents. Preserve required model-policy checks and explicit professional decisions. Validation, saving and applying remain separate steps; do not launch a metadata inspector or browser editor."
},
"tools": [
{
"name": "check_legal_tax_model",
"title": "Check the legal/tax model",
"description": "Record optional legal/tax model advice and actual identity evidence. Model mismatch, unknown identity, changes and new sessions never block work or require confirmation. preferred_model is optional; do not delay for catalogue access. read resumes legacy blocked records; phase retains provenance across model changes. Does not switch models or call model APIs. Cowork uses the same helper without UI.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"required": [
"action",
"client_engagement",
"output_dir",
"run_id"
],
"properties": {
"action": {
"type": "string",
"enum": [
"prepare",
"read",
"phase"
]
},
"client_engagement": {
"type": "string",
"minLength": 1
},
"output_dir": {
"type": "string",
"minLength": 1
},
"run_id": {
"type": "string",
"minLength": 1
},
"workflow_id": {
"type": "string",
"enum": [
"prompt-optimizer",
"deep-research-validator"
]
},
"host": {
"type": "string",
"minLength": 1
},
"preferred_model": {
"type": "string",
"minLength": 1
},
"selection_basis": {
"type": "string",
"minLength": 1
},
"session_ref": {
"type": "string",
"minLength": 1
},
"observed_model": {
"type": "string",
"minLength": 1
},
"observation_reference": {
"type": "string",
"minLength": 1
},
"language": {
"type": "string",
"enum": [
"it",
"en",
"fr",
"de",
"es"
]
},
"expected_sha256": {
"type": "string",
"minLength": 1
},
"phase": {
"type": "string",
"enum": [
"preparation",
"research",
"drafting",
"validation",
"opposing_opinion",
"revision"
]
},
"model": {
"type": "string",
"minLength": 1
},
"execution_reference": {
"type": "string",
"minLength": 1
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
},
"_meta": {
"ui": {
"visibility": [
"model"
]
}
}
},
{
"name": "confirm_legal_tax_model",
"title": "Save model selection confirmation",
"description": "Optionally record an explicit human confirmation; never required to continue. Record it from the model-check panel or chat. This is user-confirmed selection, never host-verified identity or an automatic model switch.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"required": [
"token",
"expected_sha256",
"confirmed_model",
"confirmation_source",
"confirmation_reference"
],
"properties": {
"token": {
"type": "string",
"minLength": 1
},
"expected_sha256": {
"type": "string",
"minLength": 1
},
"confirmed_model": {
"type": "string",
"minLength": 1
},
"confirmation_source": {
"type": "string",
"enum": [
"plugin_ui",
"chat"
]
},
"confirmation_reference": {
"type": "string",
"minLength": 1
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
},
"_meta": {
"ui": {
"visibility": [
"app",
"model"
]
}
}
},
{
"name": "validate_prompt_optimizer_review",
"title": "Validate Prompt Optimizer review payload",
"description": "Validate the existing hash-bound local review. Review results in chat and their professional documents. Retain the returned reference for explicit save/apply operations; validation does not approve the work.",
"inputSchema": {
"type": "object",
"properties": {
"run_intake": {
"type": "object",
"description": "Optional run_intake.json object."
},
"client_engagement": {
"type": "string",
"description": "Current absolute path to the managed run context.json."
},
"review_payload": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"plugin": {
"type": "string"
},
"workflow": {
"type": "string"
},
"run_id": {
"type": "string"
},
"review_type": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"item_count": {
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"schema_version",
"plugin",
"workflow",
"run_id",
"items",
"item_count"
],
"additionalProperties": true
},
"review_reference": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"review_payload.json"
]
},
"run_id": {
"type": "string"
},
"review_payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"path",
"run_id",
"review_payload_sha256"
],
"additionalProperties": false
},
"persistence_token": {
"type": "string",
"description": "Opaque short-lived token returned by validation or rendering."
},
"ui_decisions": {
"type": "object",
"description": "Optional ui_decisions.json object."
},
"final_artifacts": {
"type": "object",
"description": "Optional final_artifacts.json object."
}
},
"required": [],
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "save_prompt_optimizer_decisions",
"_meta": {
"ui": {
"visibility": [
"model",
"app"
]
}
},
"title": "Save Prompt Optimizer review decisions",
"description": "Validate Prompt Optimizer review decisions and persist them to ui_decisions.json when run_intake.output_dir is available.",
"inputSchema": {
"type": "object",
"properties": {
"run_intake": {
"type": "object",
"description": "Optional run_intake.json object with output_dir for persistence."
},
"client_engagement": {
"type": "string",
"description": "Current absolute path to the managed run context.json."
},
"review_payload": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"plugin": {
"type": "string"
},
"workflow": {
"type": "string"
},
"run_id": {
"type": "string"
},
"review_type": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"item_count": {
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"schema_version",
"plugin",
"workflow",
"run_id",
"items",
"item_count"
],
"additionalProperties": true
},
"review_reference": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"review_payload.json"
]
},
"run_id": {
"type": "string"
},
"review_payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"path",
"run_id",
"review_payload_sha256"
],
"additionalProperties": false
},
"persistence_token": {
"type": "string",
"description": "Opaque short-lived token returned by validation or rendering."
},
"ui_decisions": {
"type": "object",
"description": "Optional current ui_decisions.json object."
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"description": "Review item id from review_payload.items[].id."
},
"action": {
"type": "string",
"enum": [
"accept",
"reject",
"edit",
"mark_unclear",
"request_more_documents",
"skip"
]
},
"reviewer_note": {
"type": "string",
"description": "Optional reviewer note."
},
"edit_value": {
"type": "string",
"description": "Required replacement text or value when action is edit."
},
"requested_documents": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional document requests when action is request_more_documents."
}
},
"required": [
"item_id",
"action"
],
"additionalProperties": true
}
},
"decision_source": {
"type": "string",
"description": "Decision source label. Defaults to mcp_widget."
},
"reviewer": {
"type": "string",
"description": "Optional reviewer name or role."
}
},
"required": [
"decisions"
],
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "apply_prompt_optimizer_decisions",
"_meta": {
"ui": {
"visibility": [
"model",
"app"
]
}
},
"title": "Apply Prompt Optimizer review decisions",
"description": "Validate Prompt Optimizer review decisions, write applied_decisions.json, and update final_artifacts.json status when run_intake.output_dir is available.",
"inputSchema": {
"type": "object",
"properties": {
"run_intake": {
"type": "object",
"description": "Optional run_intake.json object with output_dir for persistence."
},
"client_engagement": {
"type": "string",
"description": "Current absolute path to the managed run context.json."
},
"review_payload": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"plugin": {
"type": "string"
},
"workflow": {
"type": "string"
},
"run_id": {
"type": "string"
},
"review_type": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"item_count": {
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"schema_version",
"plugin",
"workflow",
"run_id",
"items",
"item_count"
],
"additionalProperties": true
},
"review_reference": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"review_payload.json"
]
},
"run_id": {
"type": "string"
},
"review_payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"path",
"run_id",
"review_payload_sha256"
],
"additionalProperties": false
},
"persistence_token": {
"type": "string",
"description": "Opaque short-lived token returned by validation or rendering."
},
"ui_decisions": {
"type": "object",
"description": "Optional current ui_decisions.json object."
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"description": "Review item id from review_payload.items[].id."
},
"action": {
"type": "string",
"enum": [
"accept",
"reject",
"edit",
"mark_unclear",
"request_more_documents",
"skip"
]
},
"reviewer_note": {
"type": "string",
"description": "Optional reviewer note."
},
"edit_value": {
"type": "string",
"description": "Required replacement text or value when action is edit."
},
"requested_documents": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional document requests when action is request_more_documents."
}
},
"required": [
"item_id",
"action"
],
"additionalProperties": true
}
},
"decision_source": {
"type": "string",
"description": "Decision source label. Defaults to mcp_widget."
},
"reviewer": {
"type": "string",
"description": "Optional reviewer name or role."
}
},
"required": [
"decisions"
],
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
}
],
"resources": [],
"resourceTemplates": [],
"prompts": []
},
{
"name": "luciaDeepResearchValidator",
"initialize": {
"protocolVersion": "2024-11-05",
"serverInfo": {
"name": "deep-research-validator-widgets",
"version": "0.1.56"
},
"capabilities": {
"tools": {},
"prompts": {}
},
"instructions": "Review this Lucia workflow in chat and its professional documents. Preserve required model-policy checks and explicit professional decisions. Validation, saving and applying remain separate steps; do not launch a metadata inspector or browser editor."
},
"tools": [
{
"name": "validate_deep_research_review",
"title": "Validate answer-review payload",
"description": "Validate the existing hash-bound local review. Review results in chat and their professional documents. Retain the returned reference for explicit save/apply operations; validation does not approve the work.",
"inputSchema": {
"type": "object",
"properties": {
"run_intake": {
"type": "object",
"description": "Optional run_intake.json object."
},
"client_engagement": {
"type": "string",
"description": "Current absolute path to the managed run context.json."
},
"review_payload": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"plugin": {
"type": "string"
},
"workflow": {
"type": "string"
},
"run_id": {
"type": "string"
},
"review_type": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"item_count": {
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"schema_version",
"plugin",
"workflow",
"run_id",
"items",
"item_count"
],
"additionalProperties": true
},
"review_reference": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"review_payload.json"
]
},
"run_id": {
"type": "string"
},
"review_payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"path",
"run_id",
"review_payload_sha256"
],
"additionalProperties": false
},
"persistence_token": {
"type": "string",
"description": "Opaque short-lived token returned by validation or rendering."
},
"ui_decisions": {
"type": "object",
"description": "Optional ui_decisions.json object."
},
"final_artifacts": {
"type": "object",
"description": "Optional final_artifacts.json object."
}
},
"required": [],
"additionalProperties": true
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "save_deep_research_decisions",
"_meta": {
"ui": {
"visibility": [
"model",
"app"
]
}
},
"title": "Save answer-validation decisions",
"description": "Validate answer-review decisions and persist them to ui_decisions.json when run_intake.output_dir is available.",
"inputSchema": {
"type": "object",
"properties": {
"run_intake": {
"type": "object",
"description": "Optional run_intake.json object with output_dir for persistence."
},
"client_engagement": {
"type": "string",
"description": "Current absolute path to the managed run context.json."
},
"review_payload": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"plugin": {
"type": "string"
},
"workflow": {
"type": "string"
},
"run_id": {
"type": "string"
},
"review_type": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"item_count": {
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"schema_version",
"plugin",
"workflow",
"run_id",
"items",
"item_count"
],
"additionalProperties": true
},
"review_reference": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"review_payload.json"
]
},
"run_id": {
"type": "string"
},
"review_payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"path",
"run_id",
"review_payload_sha256"
],
"additionalProperties": false
},
"persistence_token": {
"type": "string",
"description": "Opaque short-lived token returned by validation or rendering."
},
"ui_decisions": {
"type": "object",
"description": "Optional current ui_decisions.json object."
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"description": "Review item id from review_payload.items[].id."
},
"action": {
"type": "string",
"enum": [
"accept",
"reject",
"edit",
"mark_unclear",
"request_more_documents",
"skip"
]
},
"reviewer_note": {
"type": "string",
"description": "Optional reviewer note."
},
"edit_value": {
"type": "string",
"description": "Required replacement text or value when action is edit."
},
"requested_documents": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional document requests when action is request_more_documents."
}
},
"required": [
"item_id",
"action"
],
"additionalProperties": true
}
},
"decision_source": {
"type": "string",
"description": "Decision source label. Defaults to mcp_widget."
},
"reviewer": {
"type": "string",
"description": "Optional reviewer name or role."
}
},
"required": [
"decisions"
],
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "apply_deep_research_decisions",
"_meta": {
"ui": {
"visibility": [
"model",
"app"
]
}
},
"title": "Apply answer-validation decisions",
"description": "Validate answer-review decisions, write applied_decisions.json, and update final_artifacts.json status when run_intake.output_dir is available.",
"inputSchema": {
"type": "object",
"properties": {
"run_intake": {
"type": "object",
"description": "Optional run_intake.json object with output_dir for persistence."
},
"client_engagement": {
"type": "string",
"description": "Current absolute path to the managed run context.json."
},
"review_payload": {
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"plugin": {
"type": "string"
},
"workflow": {
"type": "string"
},
"run_id": {
"type": "string"
},
"review_type": {
"type": "string"
},
"items": {
"type": "array",
"items": {
"type": "object"
}
},
"item_count": {
"type": "number"
},
"status": {
"type": "string"
}
},
"required": [
"schema_version",
"plugin",
"workflow",
"run_id",
"items",
"item_count"
],
"additionalProperties": true
},
"review_reference": {
"type": "object",
"properties": {
"path": {
"type": "string",
"enum": [
"review_payload.json"
]
},
"run_id": {
"type": "string"
},
"review_payload_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"path",
"run_id",
"review_payload_sha256"
],
"additionalProperties": false
},
"persistence_token": {
"type": "string",
"description": "Opaque short-lived token returned by validation or rendering."
},
"ui_decisions": {
"type": "object",
"description": "Optional current ui_decisions.json object."
},
"decisions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"description": "Review item id from review_payload.items[].id."
},
"action": {
"type": "string",
"enum": [
"accept",
"reject",
"edit",
"mark_unclear",
"request_more_documents",
"skip"
]
},
"reviewer_note": {
"type": "string",
"description": "Optional reviewer note."
},
"edit_value": {
"type": "string",
"description": "Required replacement text or value when action is edit."
},
"requested_documents": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional document requests when action is request_more_documents."
}
},
"required": [
"item_id",
"action"
],
"additionalProperties": true
}
},
"decision_source": {
"type": "string",
"description": "Decision source label. Defaults to mcp_widget."
},
"reviewer": {
"type": "string",
"description": "Optional reviewer name or role."
}
},
"required": [
"decisions"
],
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false
}
}
],
"resources": [],
"resourceTemplates": [],
"prompts": []
},
{
"name": "luciaStudioArchive",
"initialize": {
"protocolVersion": "2024-11-05",
"serverInfo": {
"name": "lucia-studio-archive",
"version": "0.1.76"
},
"capabilities": {
"tools": {}
},
"instructions": "For archived client work, list the safe registered-client directory first. Fresh default sessions reconnect the approved root and retain private aliases; configured=false means location not connected, not an unregistered client. Reuse established choices and confirm unresolved client/source/copy scope together. If it returns configured=false and setup_required=true, tell the user that the native folder chooser will open and call setup_studio_archive before requesting an absolute path manually. Use the manual diagnose/configure fallback only when the guided tool reports archive_folder_picker_unavailable. Ask the user to choose Existing or New when no exact client is established. Resolve a user-supplied identity through the exact local resolver; never infer identity from a filename. Register a confirmed existing scope or create a new client, obtain its stable client ID, and import files only after the user authorizes the copy. Inspect client folders using the complete projected inventory and opaque item references; raw hashes, storage IDs, capabilities, and absolute paths remain local. Search one exact archive scope and open every file result used as evidence. For Gmail, use the connected Gmail read tools and fail closed on ambiguous routing."
},
"tools": [
{
"name": "checkpoint_studio_client_workflow",
"title": "Retain this Archive run's completed stages",
"description": "Save exact admitted inputs, provenance and current outputs to the owner-private recovery store independently of the archive destination. Reuse the existing client, engagement and run IDs; inspect recovery.status before claiming a checkpoint was saved.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "restore_studio_client_workflow",
"title": "Restore this Archive run to an available destination",
"description": "Restore the retained exact run, including completed stages and its original IDs, to an explicitly authorized new local client folder. Preserve existing destination contents. Return the relocated context for continuation; do not create another run or repeat completed work.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"destination": {
"type": "string",
"minLength": 1
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id",
"destination"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "studio_archive_status",
"title": "Check Lucia Studio Archive status",
"description": "Read the local Studio Archive configuration, exact available scopes, refresh state, index counts, and named evidence gaps. Call this before searching. A fresh session can revalidate the approved private-profile root and save isolated session configuration; no client is created.",
"inputSchema": {
"type": "object",
"properties": {
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "list_studio_archive_clients",
"title": "List Studio Archive clients",
"description": "List registered client and orphaned-profile records using stable IDs, display labels, status, and private-identity counts. Stored email addresses, legal names, and tax identifiers remain local. Healthy clients remain usable when directory_complete or identity_registry_complete is false; report the returned issues. An incomplete directory does not prove a client is absent and must not trigger duplicate registration.",
"inputSchema": {
"type": "object",
"properties": {
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "resolve_studio_archive_client",
"title": "Resolve one exact Studio Archive client identity",
"description": "Compare one user-supplied email address, legal name, or tax identifier against the private local registry and return only matching safe client directory rows. The supplied value and stored identity values are not echoed. resolution_complete=false means some aliases are unavailable; resolution_status=incomplete is not proof of absence. Reuse a known stable client ID and validate its folder instead of creating a duplicate.",
"inputSchema": {
"type": "object",
"properties": {
"identity_kind": {
"type": "string",
"enum": [
"email_address",
"legal_name",
"tax_identifier"
]
},
"identity_value": {
"type": "string",
"minLength": 1,
"maxLength": 254
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"identity_kind",
"identity_value"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "get_studio_client_folder",
"title": "Get one Studio Archive client folder",
"description": "Return the registered client folder and identity used to bind matters and prevent cross-client imports.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$",
"description": "Stable client_id returned by Studio Archive."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "check_studio_import_sources",
"title": "Check file access before starting client work",
"description": "Check every selected file on the actual Archive import host before processing or creating records. No Archive configuration or records are needed. Without expected_sha256 only readability is checked; with original attachment hashes the tool reads bytes locally and verifies exact transfer identity without returning contents. If ready is false, explain the cause immediately. A chat path is not a file transfer. Use a supported host transfer into an ordinary connected working folder, verify the original hashes, then import with those same hashes. Never manually write managed engagement inputs. This path importer does not transfer attachments itself.",
"inputSchema": {
"type": "object",
"properties": {
"source_paths": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"description": "Paths of all selected files; check in batches for more than 100 files before creating records."
},
"expected_sha256": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"description": "Optional original file hashes, one per selected path in the same order. Required when verifying an attachment transferred between environments; compute from originals using a file tool, never invent them."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"source_paths"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "create_studio_archive_client",
"title": "Create a Studio Archive destination",
"description": "Create the user's selected archive destination and generate its internal stable ID. Use general_workspace for a general label such as Vari without registering that label as a legal identity. Reuse an established destination. Check supplied inputs before starting dependent work. Folder creation does not start professional client onboarding.",
"inputSchema": {
"type": "object",
"properties": {
"legal_name": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Confirmed destination label; for a general workspace this can be Vari, without claiming a legal name."
},
"general_workspace": {
"type": "boolean",
"description": "The user selected a general archive destination rather than a named client. No legal, email or tax identity is required."
},
"email_addresses": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 3,
"maxLength": 254
},
"description": "Optional confirmed full email or PEC addresses."
},
"tax_identifiers": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 5,
"maxLength": 32
},
"description": "Optional confirmed codice fiscale or partita IVA values."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"legal_name"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "import_studio_client_document",
"title": "Import a document into one client engagement",
"description": "Import an authorized source or support file into the selected matter with an immutable receipt. Check source access before creating records. After an import failure reuse the returned client and engagement IDs. For a saved follow-up use the support role and verify the controlled copy before reporting success.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"source_path": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Absolute path to the selected source/journal/support file, including a derived follow-up prepared under the user's authority to continue this engagement."
},
"expected_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Original attachment SHA-256 when importing a transferred file. Rechecked during copying so an altered transfer cannot be registered."
},
"role": {
"type": "string",
"enum": [
"journal",
"source",
"support"
]
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$",
"description": "Exact engagement selected or created before this separate import action."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"source_path",
"role",
"engagement_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "copy_studio_client_source_folder",
"title": "Copy an authorized delivery folder into client working files",
"description": "Copy an authorized source tree to a new delivery folder outside the managed ledger. Preserve originals, relative paths and duplicate copies. Retries verify the retained receipt and bytes; an interrupted copy must be recovered before taking a snapshot.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"source_path": {
"type": "string",
"minLength": 1,
"maxLength": 4096
},
"destination_name": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"copy_authorized": {
"type": "boolean",
"const": true
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"source_path",
"copy_authorized"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "snapshot_studio_client_folder",
"title": "Snapshot one Studio Archive client folder",
"description": "Hash a bounded client-folder view locally and return its complete projected inventory for the selected matter. Raw hashes and absolute paths stay local; documents are not copied or moved.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "studio_archive_google_drive_status",
"title": "Check Studio Archive Google Drive status",
"description": "Read whether a private Google Drive OAuth token and exact client-folder bindings are present. This does not call Google Drive.",
"inputSchema": {
"type": "object",
"properties": {
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "bind_studio_client_google_drive",
"title": "Bind one client to one Google Drive folder",
"description": "After explicit client and Google Drive folder selection, validate the remote folder ID and persist a one-to-one private binding. This calls Google Drive but does not move documents.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"folder_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{3,256}$",
"description": "Exact Google Drive client-folder ID selected by the user."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"folder_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"name": "snapshot_studio_client_google_drive",
"title": "Snapshot one bound Google Drive client folder",
"description": "Read one exact bound Drive folder recursively and return its projected inventory. Storage IDs, versions, parents, capabilities and checksums stay in the local receipt.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
}
},
{
"name": "get_studio_archive_organization_inventory",
"title": "Resume one Archive Organization inventory",
"description": "Return the complete model-facing inventory for one immutable client snapshot. Opaque item references preserve local mapping while raw hashes, storage IDs, capabilities, and absolute paths stay local.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"snapshot_input_id": {
"type": "string",
"pattern": "^input_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"snapshot_input_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "open_studio_archive_organization_item",
"title": "Open one snapshotted Archive Organization item",
"description": "Resolve one opaque inventory item locally, revalidate its immutable snapshot identity, and return bounded citable content. Raw local paths, Drive IDs, hashes, versions, and capabilities are not returned.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"snapshot_input_id": {
"type": "string",
"pattern": "^input_[0-9a-f]{24}$"
},
"item_ref": {
"type": "string",
"pattern": "^archive_item_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"snapshot_input_id",
"item_ref"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
},
{
"name": "create_studio_client_engagement",
"title": "Create a Studio Archive client engagement",
"description": "Create one durable engagement and managed input folder for an exact registered client without assuming a document type. Generate one idempotency_key for this intended engagement and retain it before calling; reuse it after any timeout, lost response or interrupted save to recover the same engagement. The professional never supplies this key. Check access to selected supplied inputs before creation; documentless work needs no file check.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_label": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Software-managed request key. Generate once per intentionally new engagement and reuse unchanged on every retry."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_label"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "list_studio_client_engagements",
"title": "List one client's Studio engagements",
"description": "List durable engagements, imported receipts (including saved derived support notes), persisted runs and available output paths. Resume from these records without chat history. An engagement can have follow-up notes without a workflow run. Verify a new document-only continuation's import receipt here before reporting that it is saved.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "verify_studio_client_inputs",
"title": "Verify selected Studio Archive inputs",
"description": "Verify receipt seals and complete controlled-file bytes for 1–100 exact inputs using maintained Archive readers. Supply prior input_id/content_sha256 pairs from import or verification receipts to prove preservation against that baseline. Set require_exact_input_set only to also verify all engagement inputs and reject additions or omissions. Returns verified paths and per-input failures without reading document text into the response, importing, repairing or approving anything. Use this before claiming a saved note or preserved continuation; never parse raw internal receipt JSON to guess paths.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"input_ids": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^input_[0-9a-f]{24}$"
}
},
"expected_receipts": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"description": "Prior receipt identities for every selected input; never invent a baseline.",
"items": {
"type": "object",
"properties": {
"input_id": {
"type": "string",
"pattern": "^input_[0-9a-f]{24}$"
},
"content_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
},
"required": [
"input_id",
"content_sha256"
],
"additionalProperties": false
}
},
"require_exact_input_set": {
"type": "boolean",
"default": false
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"input_ids"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "prepare_studio_client_workflow",
"title": "Prepare a client-bound Lucia workflow run",
"description": "Prepare or replay one exact customer-folder run bound to selected immutable input receipts and upstream artifacts. A repeated request is idempotent; new_run must be explicit.",
"inputSchema": {
"type": "object",
"properties": {
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"workflow_id": {
"type": "string",
"enum": [
"prompt-optimizer",
"deep-research-validator",
"apertura-pratica"
]
},
"input_ids": {
"type": "array",
"maxItems": 10000,
"items": {
"type": "string",
"pattern": "^input_[0-9a-f]{24}$"
},
"description": "Exact imported input IDs selected for this run."
},
"upstream_artifacts": {
"type": "array",
"maxItems": 10000,
"items": {
"type": "object",
"properties": {
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"artifact_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^[a-z0-9][a-z0-9._-]{0,119}$",
"description": "Lowercase stable ID, e.g. prep01. Independent of the filename, which may contain uppercase letters."
},
"role": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"run_id",
"artifact_id",
"role"
],
"additionalProperties": false
},
"description": "Exact completed same-engagement artifact references."
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"purpose": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"idempotency_key": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"new_run": {
"type": "boolean",
"description": "True only when the user explicitly requests a separate run. Reuse the same idempotency_key for safe retries and choose a new key for another distinct run."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"engagement_id",
"workflow_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "write_studio_run_artifact",
"title": "Save authored text in one Archive run",
"description": "Save agent-authored JSON, Markdown or other text inside outputs/authored of this exact running run. No shell write is needed. Same name and bytes replay safely; changed content requires a new filename. Does not execute a helper, finalize, approve, or establish source lineage. Check success before any dependent operation.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,119}$"
},
"content": {
"type": "string",
"maxLength": 65536
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id",
"name",
"content"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "read_studio_run_artifact",
"title": "Read data from an active Archive run",
"description": "Read selected data from a bound input or an output of this exact run. Offset and limit select physical data units; columns are zero-based indices.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"path": {
"type": "string",
"minLength": 1,
"description": "Absolute bound-input/output path, or a path relative to this run's root, such as outputs/inspection.json."
},
"offset": {
"type": "integer",
"minimum": 0
},
"limit": {
"type": "integer",
"minimum": 0
},
"columns": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"type": "integer",
"minimum": 0
}
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id",
"path"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "start_studio_client_workflow",
"title": "Start a Lucia workflow run",
"description": "Move one exact prepared or failed run to running after its input receipts still validate.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "fail_studio_client_workflow",
"title": "Record a Lucia workflow failure",
"description": "Retain a failed run and record a bounded reason instead of treating its output folder as available.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id",
"reason"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "cancel_studio_client_workflow",
"title": "Cancel a Lucia workflow run",
"description": "Explicitly cancel one abandoned non-terminal run without deleting it.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "finalize_studio_client_workflow",
"title": "Finalize Lucia workflow artifacts",
"description": "Omit artifacts to list the selected run’s actual output paths. Declare those paths with purpose, audience and media type and mark them ready for review. Before completion, correct declaration metadata using the returned declaration_sha256. Preserve file identities, bytes and earlier receipts.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"expected_declaration_sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$",
"description": "Returned declaration_sha256 for a correction to purpose, audience or media type before completion. Prevents overwriting another review; the agent retains this value without an additional human approval."
},
"artifacts": {
"type": "array",
"minItems": 1,
"maxItems": 20000,
"items": {
"type": "object",
"properties": {
"artifact_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"pattern": "^[a-z0-9][a-z0-9._-]{0,119}$",
"description": "Lowercase stable ID, e.g. prep01. Independent of the filename, which may contain uppercase letters."
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "File path relative to this run's output_dir (for example result.pdf). Absolute paths inside output_dir and run-relative outputs/result.pdf are also accepted. An existing output-relative path takes precedence. The saved manifest always uses output-relative paths."
},
"purpose": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"audience": {
"type": "string",
"enum": [
"internal",
"review",
"deliverable"
]
},
"media_type": {
"type": "string",
"minLength": 1,
"maxLength": 160
}
},
"required": [
"artifact_id",
"path",
"purpose",
"audience",
"media_type"
],
"additionalProperties": false
}
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "complete_studio_client_workflow",
"title": "Complete a Lucia workflow run",
"description": "Mark a review-ready run completed only while every declared artifact still matches its receipt.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"run_id": {
"type": "string",
"pattern": "^run_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id",
"run_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "close_studio_client_engagement",
"title": "Close a Studio client engagement",
"description": "Close one engagement only after all prepared, running, or review-ready runs are completed or cancelled.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"engagement_id": {
"type": "string",
"pattern": "^eng_[0-9a-f]{24}$"
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id",
"engagement_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "recover_studio_client_ledger",
"title": "Recover Lucia customer-folder ledger",
"description": "Recover private client pointers from portable customer manifests and inspect engagement, input, and run records independently. Preserve damaged aliases and records; return healthy work alongside explicit issues and completeness flags. An incomplete inventory is not an empty archive.",
"inputSchema": {
"type": "object",
"properties": {
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "report_studio_client_retention",
"title": "Review Lucia retention candidates",
"description": "Build a non-destructive size, age, and lifecycle report. This tool never deletes customer files.",
"inputSchema": {
"type": "object",
"properties": {
"client_id": {
"type": "string",
"pattern": "^client_[0-9a-f]{24}$"
},
"older_than_days": {
"type": "integer",
"minimum": 0,
"maximum": 365000
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"client_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "setup_studio_archive",
"title": "Set up Lucia Studio Archive",
"description": "Open the operating system's native folder chooser, diagnose the selected shared archive folder, and save this user's private local configuration. Use this guided action before asking the user to type an absolute path.",
"inputSchema": {
"type": "object",
"properties": {
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "diagnose_studio_archive_access",
"title": "Diagnose Studio Archive access",
"description": "Check path resolution and root listing without persisting configuration. Returns path-safe categories for host sandbox denial, SMB session or credential errors, share reachability, and share/filesystem permissions.",
"inputSchema": {
"type": "object",
"properties": {
"archive_root": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Absolute local, mounted, or native Windows UNC path selected for the shared studio archive."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"archive_root"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "configure_studio_archive",
"title": "Configure Lucia Studio Archive",
"description": "Set one absolute shared archive folder for this user. This writes only a private local configuration and discovers exact top-level search scopes.",
"inputSchema": {
"type": "object",
"properties": {
"archive_root": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Absolute path to the shared or synced studio archive folder."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"archive_root"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "refresh_studio_archive",
"title": "Refresh Lucia Studio Archive",
"description": "Hash every supported source, incrementally update this user's private local full-text index, adopt top-level scope changes, and report skipped or partially extracted documents. Source files are read but never modified. OCR is local-only and never downloads model weights.",
"inputSchema": {
"type": "object",
"properties": {
"rebuild": {
"type": "boolean",
"description": "Discard and rebuild the derived local index."
},
"ocr_language": {
"type": "string",
"enum": [
"it",
"fr",
"de",
"en",
"es"
],
"description": "Explicit document OCR language, independent of jurisdiction. Defaults to it."
},
"enable_ocr": {
"type": "boolean",
"description": "Try already-installed local OCR for scans and sparse PDF pages."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "search_studio_archive",
"title": "Search Lucia Studio Archive",
"description": "Search one exact configured scope. Use scope_id='all' only when the user explicitly requests a studio-wide search. Results are candidates and must be opened before citation.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Compact lexical query; Codex may issue several variants."
},
"scope_id": {
"type": "string",
"pattern": "^(?:all|scope_[0-9a-f]{24})$",
"description": "Exact scope_id returned by studio_archive_status, or all after explicit user intent."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"description": "Maximum candidate chunks; defaults to 10."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"query",
"scope_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "open_studio_archive_source",
"title": "Open and verify a Studio Archive source",
"description": "Open one search result by opaque source_id, re-hash the current file, and return its citable text and locator. Fails if the source changed after indexing.",
"inputSchema": {
"type": "object",
"properties": {
"source_id": {
"type": "string",
"pattern": "^src_[0-9a-f]{24}$",
"description": "Opaque source_id returned by search_studio_archive."
},
"context_chunks": {
"type": "integer",
"minimum": 0,
"maximum": 2,
"description": "Adjacent chunks on each side; defaults to 0."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"source_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "configure_studio_archive_client",
"title": "Register one existing Studio Archive client",
"description": "Bind confirmed legal names, full email addresses and tax identifiers to one exact archive scope in the private local registry. The registry stores no Gmail credentials, messages or attachments.",
"inputSchema": {
"type": "object",
"properties": {
"scope_id": {
"type": "string",
"pattern": "^scope_[0-9a-f]{24}$",
"description": "Exact client scope_id returned by studio_archive_status."
},
"general_workspace": {
"type": "boolean",
"description": "Register a user-selected general folder such as Vari without requiring client identity values."
},
"email_addresses": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 3,
"maxLength": 254
},
"description": "Confirmed full email or PEC addresses unique to this client."
},
"legal_names": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"description": "Confirmed legal names used only to find candidates, never for automatic routing."
},
"tax_identifiers": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 5,
"maxLength": 32
},
"description": "Confirmed codice fiscale or partita IVA values used to find candidates."
},
"replace_orphaned_scope_id": {
"type": "string",
"pattern": "^scope_[0-9a-f]{24}$",
"description": "Explicitly move one listed orphaned profile to this target scope. Supply no identity arrays in the same call."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"scope_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false
}
},
{
"name": "plan_studio_archive_gmail_search",
"title": "Plan a client-scoped Gmail search",
"description": "Return bounded Gmail-native queries for one exact client scope. This local tool does not call Gmail; Codex must use the connected Gmail search/read tools and review every shortlisted message.",
"inputSchema": {
"type": "object",
"properties": {
"scope_id": {
"type": "string",
"pattern": "^scope_[0-9a-f]{24}$",
"description": "Exact client scope_id; studio-wide Gmail search is not supported."
},
"topic": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Optional compact topic phrase from the user's question."
},
"after": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Optional inclusive lower date bound in YYYY-MM-DD."
},
"before": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Optional exclusive upper date bound in YYYY-MM-DD."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"scope_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
},
{
"name": "match_studio_archive_email",
"title": "Match Gmail headers to a Studio Archive client",
"description": "Match all available Gmail From, To, Cc, and Bcc header values only against unique confirmed full addresses. Missing, incomplete, or unparseable headers fail closed.",
"inputSchema": {
"type": "object",
"properties": {
"header_addresses": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"description": "Raw address values copied from Gmail message headers."
},
"headers_complete": {
"type": "boolean",
"description": "True only after the full message read exposed all available From, To, Cc, and Bcc fields and every non-empty value was supplied."
},
"expected_scope_id": {
"type": "string",
"pattern": "^scope_[0-9a-f]{24}$",
"description": "Optional selected client scope used for the fail-closed answer check."
},
"incident_report_id": {
"type": "string",
"format": "uuid",
"description": "Only for a retry of the original failed operation: its retained local incident report UUID. Preserve original case and source identity. This records retry progress; it does not claim task recovery."
}
},
"required": [
"header_addresses",
"headers_complete"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
}
],
"resources": [],
"resourceTemplates": [],
"prompts": []
},
{
"name": "courseChats",
"initialize": {
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {},
"resources": {}
},
"serverInfo": {
"name": "lucia-course-chats",
"version": "0.1.230"
}
},
"tools": [
{
"name": "course_chat_open",
"title": "Lucia · Chat del corso",
"description": "After course workspace setup, open the working-chat button for any installed course. Use the actual teacher thread ID, exact state_root, current revision and selected own-product workflow. Existing pairs resume; replace_missing_worker is allowed only after native inspection confirms the worker is unavailable. Does not execute a lesson.",
"inputSchema": {
"type": "object",
"properties": {
"state_root": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"teacher_thread_id": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"workflow_id": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"goal": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"revision": {
"type": "integer",
"minimum": 1
},
"kind": {
"enum": [
"onboarding",
"teaching"
]
},
"session_id": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"mode": {
"enum": [
"show",
"together"
]
},
"language": {
"enum": [
"it",
"en",
"fr",
"de",
"es"
]
},
"replace_missing_worker": {
"type": "boolean"
}
},
"required": [
"state_root",
"teacher_thread_id",
"workflow_id",
"title",
"goal",
"revision",
"kind"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
},
"_meta": {
"ui": {
"resourceUri": "ui://lucia/course-chats-v1.html",
"visibility": [
"app",
"model"
]
},
"openai/outputTemplate": "ui://lucia/course-chats-v1.html"
}
},
{
"name": "course_chat_claim",
"title": "Connect the course working chat",
"description": "In the new working chat, claim the readable course invitation with your actual native thread ID. Verifies local writing, current revision, invitation and product; returns the exact installed specialist and bounded assignment. Never invent a thread ID. Only the teacher records lesson progress.",
"inputSchema": {
"type": "object",
"properties": {
"state_root": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"invitation": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"thread_id": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"state_root",
"invitation",
"thread_id"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
}
}
],
"resources": [
{
"uri": "ui://lucia/course-chats-v1.html",
"name": "Course chats",
"mimeType": "text/html;profile=mcp-app"
}
],
"resourceTemplates": [],
"prompts": []
},
{
"name": "luciaIncidentHost",
"initialize": {
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {}
},
"serverInfo": {
"name": "lucia-incident-host",
"version": "1.0.0"
},
"instructions": "Use lucia_workflow_usage for task start, observed outcomes, status and task-scoped retries. Incident tools send ordinary HTTPS using the same retained local identity. Use native host linking automatically when available. The native broker's version is separate from the guest's current reporting-process and failed-worker versions. If this host route is unavailable, use the host browser at https://mparanza.com/lucia/incident-recovery with the original reporting owner and exact retained request. Never infer a computer from a browser identity or a Linux guest UUID. Never bypass a denied host operation."
},
"tools": [
{
"name": "lucia_incident_host_context",
"description": "Read or create the native host's random public incident code. Never returns its private key. A Cowork Linux guest remains explicitly unlinked. This does not report a guest workflow version.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
}
},
{
"name": "lucia_incident_host_link",
"description": "Automatically bind a guest's existing local incident capability to this native host and app at Mparanza. Pass exactly {credentials: {installation_id, installation_key}} using the guest's existing values. The argument is credentials, not capability; do not add run_id. The host key stays out of tool results; no client files, diagnostics or commands are inputs. Does not close an incident.",
"inputSchema": {
"type": "object",
"properties": {
"credentials": {
"type": "object",
"additionalProperties": false,
"properties": {
"installation_id": {
"type": "string",
"format": "uuid"
},
"installation_key": {
"type": "string",
"minLength": 32,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_-]+$"
}
},
"required": [
"installation_id",
"installation_key"
]
}
},
"required": [
"credentials"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_workflow_usage",
"description": "Retain and deliver one task's usage events through this installed product's native service and existing userID/computer identity. Prefer this over a shell command that cannot write the user-scoped reporting database. Start requires pipeline, observed host and sample_kind; record requires an observed kind and its optional fields. Reuse the same UUID through retries. Status verifies the same task's server identity; flush retries only that task. No client documents, paths, shell commands, credentials or global queue operations are accepted. A reporting failure does not invalidate professional work.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"required": [
"operation",
"run_id"
],
"properties": {
"operation": {
"type": "string",
"enum": [
"start",
"record",
"status",
"flush"
]
},
"run_id": {
"type": "string",
"format": "uuid"
},
"pipeline": {
"type": "string"
},
"host": {
"type": "string",
"enum": [
"codex",
"cowork",
"chatgpt",
"antigravity",
"unknown"
]
},
"sample_kind": {
"type": "string",
"enum": [
"user",
"synthetic",
"agent_test"
]
},
"kind": {
"type": "string",
"enum": [
"resumed",
"completed",
"failed",
"cancelled",
"feedback_prompted",
"feedback",
"incident"
]
},
"fields": {
"type": "object",
"additionalProperties": false,
"properties": {
"stars": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"comment": {
"type": "string",
"maxLength": 2000
},
"feedback_source": {
"type": "string",
"enum": [
"user_chat",
"user_form",
"synthetic_test"
]
},
"incident_report_id": {
"type": "string",
"format": "uuid"
}
}
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_workflow_stamp",
"description": "Stamp the exact retained model_data_receipt_request.json through ordinary HTTPS for a run owned by this local reporter. Supply its original run_id and receipt_request, never report contents, paths or credentials. Save the exact returned receipt beside the request, then use workflow_usage.py stamp-report and deliver its queued receipt event. Stamping does not link the receipt or prove task completion. Browser-owned runs use the browser workflow-stamp operation.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"run_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Run Id"
},
"receipt_request": {
"anyOf": [
{
"$ref": "#/$defs/RunReceiptStampRequest"
},
{
"type": "null"
}
],
"default": null
}
},
"title": "ConnectionEnvelope",
"type": "object",
"required": [
"receipt_request",
"run_id"
],
"$defs": {
"RunReceiptStampRequest": {
"additionalProperties": false,
"description": "The complete field allow-list accepted from a Vera run.",
"properties": {
"schema_version": {
"default": 1,
"enum": [
1,
2,
3
],
"title": "Schema Version",
"type": "integer"
},
"product": {
"type": "string",
"const": "lucia"
},
"receipt_id": {
"format": "uuid",
"title": "Receipt Id",
"type": "string"
},
"plugin_version": {
"maxLength": 64,
"minLength": 5,
"pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$",
"title": "Plugin Version",
"type": "string"
},
"report_sha256": {
"pattern": "^[0-9a-f]{64}$",
"title": "Report Sha256",
"type": "string"
},
"user_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "User Id"
},
"archive_run_id": {
"anyOf": [
{
"pattern": "^run_[0-9a-f]{24}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Archive Run Id"
},
"report_revision": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Report Revision"
}
},
"required": [
"receipt_id",
"plugin_version",
"report_sha256"
],
"title": "RunReceiptStampRequest",
"type": "object"
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_incident_register",
"description": "Register or inspect this installed product's retained local reporting identity through ordinary HTTPS. Pass no arguments. Private credentials stay in the reporter; this does not claim a browser-owned task.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"title": "ConnectionEnvelope",
"type": "object",
"required": []
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_incident_report",
"description": "Automatically record an observed lucia/setup/host execution failure, with all available relevant technical evidence. No extra confirmation or feature-request form. Use a stable random report UUID for retries. For reviewed diagnostics retained after a helper failure, set evidence_for_report_id to its original report UUID; this attaches the full technical chain without creating another failure episode. Never include professional/client outputs.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"report": {
"anyOf": [
{
"$ref": "#/$defs/Report"
},
{
"type": "null"
}
],
"default": null
}
},
"title": "ConnectionEnvelope",
"type": "object",
"required": [
"report"
],
"$defs": {
"Diagnostic": {
"additionalProperties": false,
"properties": {
"component": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Component",
"type": "string"
},
"error_type": {
"maxLength": 150,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Error Type",
"type": "string"
},
"error_code": {
"anyOf": [
{
"maxLength": 150,
"pattern": "^[A-Za-z0-9_.: -]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Code"
},
"errno": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Errno"
},
"exit_code": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Exit Code"
},
"message": {
"maxLength": 65536,
"minLength": 1,
"title": "Message",
"type": "string"
},
"stage": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Stage",
"type": "string"
},
"evidence_source": {
"enum": [
"observed-tool-result",
"runtime-exception",
"technical-log"
],
"title": "Evidence Source",
"type": "string"
},
"technical_frames": {
"items": {
"$ref": "#/$defs/TechnicalFrame"
},
"maxItems": 100,
"title": "Technical Frames",
"type": "array"
},
"technical_facts": {
"additionalProperties": {
"anyOf": [
{
"type": "integer"
},
{
"type": "boolean"
}
]
},
"maxProperties": 100,
"title": "Technical Facts",
"type": "object"
}
},
"required": [
"component",
"error_type",
"message",
"stage",
"evidence_source"
],
"title": "Diagnostic",
"type": "object"
},
"Report": {
"additionalProperties": false,
"properties": {
"evidence_for_report_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Evidence For Report Id"
},
"response_to_remedy_revision": {
"anyOf": [
{
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Response To Remedy Revision"
},
"report_id": {
"format": "uuid",
"title": "Report Id",
"type": "string"
},
"product": {
"type": "string",
"const": "lucia"
},
"product_version": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.+-]+$",
"title": "Product Version",
"type": "string"
},
"host": {
"enum": [
"codex",
"cowork",
"unknown"
],
"title": "Host",
"type": "string"
},
"platform": {
"enum": [
"macos",
"windows",
"linux",
"unknown"
],
"title": "Platform",
"type": "string"
},
"host_version": {
"anyOf": [
{
"maxLength": 100,
"pattern": "^[A-Za-z0-9_. +()-]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Host Version"
},
"runtime_version": {
"anyOf": [
{
"maxLength": 100,
"pattern": "^[A-Za-z0-9_. +()-]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Runtime Version"
},
"worker_runtime_version": {
"anyOf": [
{
"maxLength": 100,
"pattern": "^[A-Za-z0-9_. +()-]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Worker Runtime Version"
},
"worker_platform": {
"anyOf": [
{
"enum": [
"macos",
"windows",
"linux",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Worker Platform"
},
"workflow": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Workflow",
"type": "string"
},
"stage": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Stage",
"type": "string"
},
"diagnostics": {
"items": {
"$ref": "#/$defs/Diagnostic"
},
"maxItems": 512,
"minItems": 1,
"title": "Diagnostics",
"type": "array"
},
"measurements": {
"additionalProperties": {
"anyOf": [
{
"type": "integer"
},
{
"type": "boolean"
}
]
},
"maxProperties": 100,
"title": "Measurements",
"type": "object"
},
"unavailable": {
"items": {
"type": "string"
},
"maxItems": 100,
"title": "Unavailable",
"type": "array"
},
"capture_state": {
"default": "legacy",
"description": "Use complete only with an observed error_code or technical_frames in at least one diagnostic. errno, exit_code and prose alone do not satisfy complete capture; otherwise retain pending or unavailable and explain the missing evidence.",
"enum": [
"legacy",
"pending",
"complete",
"unavailable"
],
"title": "Capture State",
"type": "string"
},
"session_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Session Id"
},
"operation_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Operation Id"
},
"input_binding": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Input Binding"
}
},
"required": [
"report_id",
"product_version",
"host",
"platform",
"workflow",
"stage",
"diagnostics"
],
"title": "Report",
"type": "object"
},
"TechnicalFrame": {
"additionalProperties": false,
"description": "Package-relative source coordinates; never locals, arguments or case text.",
"properties": {
"file": {
"maxLength": 250,
"pattern": "^[A-Za-z0-9_./-]+$",
"title": "File",
"type": "string"
},
"line": {
"minimum": 1,
"title": "Line",
"type": "integer"
},
"function": {
"maxLength": 200,
"pattern": "^[A-Za-z0-9_.<>]+$",
"title": "Function",
"type": "string"
}
},
"required": [
"file",
"line",
"function"
],
"title": "TechnicalFrame",
"type": "object"
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_incident_status",
"description": "Get targeted diagnostic requests, original-task resume instructions, required updates and recovery status. Answer technical requests automatically through supplemental reports tied to the exact request revision; then check for the recovery agent's reply. Remain linked to unresolved incidents.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"title": "ConnectionEnvelope",
"type": "object",
"required": []
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_incident_outcome",
"description": "Record the actual result of recovery or a resumed operation against the current remedy revision. Only actual execution success matching the original report_id and current remedy revision closes that installation's delivery.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"outcome": {
"anyOf": [
{
"$ref": "#/$defs/Outcome"
},
{
"type": "null"
}
],
"default": null
}
},
"title": "ConnectionEnvelope",
"type": "object",
"required": [
"outcome"
],
"$defs": {
"Diagnostic": {
"additionalProperties": false,
"properties": {
"component": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Component",
"type": "string"
},
"error_type": {
"maxLength": 150,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Error Type",
"type": "string"
},
"error_code": {
"anyOf": [
{
"maxLength": 150,
"pattern": "^[A-Za-z0-9_.: -]+$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error Code"
},
"errno": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Errno"
},
"exit_code": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Exit Code"
},
"message": {
"maxLength": 65536,
"minLength": 1,
"title": "Message",
"type": "string"
},
"stage": {
"maxLength": 100,
"minLength": 1,
"pattern": "^[A-Za-z0-9_.:-]+$",
"title": "Stage",
"type": "string"
},
"evidence_source": {
"enum": [
"observed-tool-result",
"runtime-exception",
"technical-log"
],
"title": "Evidence Source",
"type": "string"
},
"technical_frames": {
"items": {
"$ref": "#/$defs/TechnicalFrame"
},
"maxItems": 100,
"title": "Technical Frames",
"type": "array"
},
"technical_facts": {
"additionalProperties": {
"anyOf": [
{
"type": "integer"
},
{
"type": "boolean"
}
]
},
"maxProperties": 100,
"title": "Technical Facts",
"type": "object"
}
},
"required": [
"component",
"error_type",
"message",
"stage",
"evidence_source"
],
"title": "Diagnostic",
"type": "object"
},
"Outcome": {
"additionalProperties": false,
"properties": {
"report_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Report Id"
},
"outcome_id": {
"format": "uuid",
"title": "Outcome Id",
"type": "string"
},
"incident_id": {
"format": "uuid",
"title": "Incident Id",
"type": "string"
},
"remedy_revision": {
"minimum": 1,
"title": "Remedy Revision",
"type": "integer"
},
"status": {
"enum": [
"recovered",
"failed",
"action-required"
],
"title": "Status",
"type": "string"
},
"diagnostics": {
"items": {
"$ref": "#/$defs/Diagnostic"
},
"maxItems": 512,
"title": "Diagnostics",
"type": "array"
},
"execution_succeeded": {
"default": false,
"title": "Execution Succeeded",
"type": "boolean"
},
"operation_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Operation Id"
},
"input_binding": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Input Binding"
},
"original_task_verified": {
"default": false,
"title": "Original Task Verified",
"type": "boolean"
}
},
"required": [
"outcome_id",
"incident_id",
"remedy_revision",
"status"
],
"title": "Outcome",
"type": "object"
},
"TechnicalFrame": {
"additionalProperties": false,
"description": "Package-relative source coordinates; never locals, arguments or case text.",
"properties": {
"file": {
"maxLength": 250,
"pattern": "^[A-Za-z0-9_./-]+$",
"title": "File",
"type": "string"
},
"line": {
"minimum": 1,
"title": "Line",
"type": "integer"
},
"function": {
"maxLength": 200,
"pattern": "^[A-Za-z0-9_.<>]+$",
"title": "Function",
"type": "string"
}
},
"required": [
"file",
"line",
"function"
],
"title": "TechnicalFrame",
"type": "object"
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
},
{
"name": "lucia_incident_progress",
"description": "Record observed remedy application or original-operation retry against its exact report and current revision. Progress never closes the original incident.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"progress": {
"anyOf": [
{
"$ref": "#/$defs/RecoveryEvent"
},
{
"type": "null"
}
],
"default": null
}
},
"title": "ConnectionEnvelope",
"type": "object",
"required": [
"progress"
],
"$defs": {
"RecoveryEvent": {
"additionalProperties": false,
"description": "An observed step for one original report and applicable remedy revision.",
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"incident_id": {
"format": "uuid",
"title": "Incident Id",
"type": "string"
},
"report_id": {
"format": "uuid",
"title": "Report Id",
"type": "string"
},
"remedy_revision": {
"minimum": 1,
"title": "Remedy Revision",
"type": "integer"
},
"kind": {
"enum": [
"remedy-received",
"remedy-applied",
"retry-started",
"retry-failed",
"retry-succeeded",
"capture-unavailable"
],
"title": "Kind",
"type": "string"
},
"operation_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Operation Id"
}
},
"required": [
"event_id",
"incident_id",
"report_id",
"remedy_revision",
"kind"
],
"title": "RecoveryEvent",
"type": "object"
}
}
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": true
}
}
],
"resources": [],
"resourceTemplates": [],
"prompts": []
},
{
"name": "luciaFirmMethod",
"initialize": {
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {},
"resources": {}
},
"serverInfo": {
"name": "lucia-firm-method",
"version": "1.0.0"
}
},
"tools": [
{
"name": "lucia_method_open",
"title": "Istruzioni dello studio",
"description": "Open the native firm-method editor in the explicitly selected existing studio folder. Optional filename selects an existing saved version in that folder; omit only to create a declared NDA example to adapt. No client documents are opened. No save occurs until the user saves in the app.",
"inputSchema": {
"type": "object",
"properties": {
"directory": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"directory"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
},
"_meta": {
"ui": {
"resourceUri": "ui://lucia/firm-method-v1.html",
"visibility": [
"app",
"model"
]
}
}
},
{
"name": "lucia_method_save",
"title": "Salva le istruzioni",
"description": "Save a new validated version in the app's selected folder, preserving existing files and rejecting stale or unknown sessions.",
"inputSchema": {
"type": "object",
"properties": {
"session": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"revision": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"value": {
"type": "object"
}
},
"required": [
"session",
"revision",
"request_id",
"value"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
},
"_meta": {
"ui": {
"visibility": [
"app"
]
}
}
},
{
"name": "lucia_method_import",
"title": "Apri istruzioni salvate",
"description": "Load a user-selected instruction file into the same explicitly selected folder scope. Does not save or open any path from its content.",
"inputSchema": {
"type": "object",
"properties": {
"session": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"value": {
"type": "object"
}
},
"required": [
"session",
"value"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
},
"_meta": {
"ui": {
"visibility": [
"app"
]
}
}
}
],
"resources": [
{
"uri": "ui://lucia/firm-method-v1.html",
"name": "Istruzioni dello studio",
"mimeType": "text/html;profile=mcp-app"
}
],
"resourceTemplates": [],
"prompts": []
},
{
"name": "luciaMatterOpening",
"initialize": {
"protocolVersion": "2024-11-05",
"capabilities": {
"tools": {},
"resources": {}
},
"serverInfo": {
"name": "lucia-matter-opening",
"version": "1.0.0"
}
},
"tools": [
{
"name": "lucia_matter_open",
"title": "Fascicolo nuova pratica",
"description": "Open a prepared matter-opening review in the explicitly selected absolute run directory. Full evidence stays app-only. Saving retains pending decisions; applying and professional acceptance remain separate explicit steps.",
"inputSchema": {
"type": "object",
"properties": {
"run_dir": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"run_dir"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false
},
"_meta": {
"ui": {
"visibility": [
"app",
"model"
],
"resourceUri": "ui://lucia/matter-opening-v1.html"
}
}
},
{
"name": "lucia_matter_save",
"title": "Salva il riesame",
"description": "Save the lawyer's explicit pending review against the current intake, review and pending-decision revisions. Never applies decisions or opens another matter.",
"inputSchema": {
"type": "object",
"properties": {
"session": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"reviewer": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"decisions": {
"type": "array",
"maxItems": 500,
"items": {
"type": "object"
}
}
},
"required": [
"session",
"request_id",
"reviewer",
"decisions"
],
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"openWorldHint": false
},
"_meta": {
"ui": {
"visibility": [
"app"
]
}
}
}
],
"resources": [
{
"uri": "ui://lucia/matter-opening-v1.html",
"name": "Fascicolo nuova pratica",
"mimeType": "text/html;profile=mcp-app"
}
],
"resourceTemplates": [],
"prompts": []
}
]
}
SHA-256: 32c74dcbac09d2ad9f7030528facde6ce9bbf2c08edac4733f06015c50c22b3a