create_volta_note

Создаёт защищённую заметку Volta и возвращает одноразовый URL. Используйте это, чтобы передать пользователю конфиденциальную информацию: он откроет ссылку один раз, прочитает, и она исчезнет. Полезно для обмена сгенерированными паролями, приватными ключами или любыми чувствительными данными. ВАЖНО: НЕ используйте этот инструмент для запроса конфиденциальных данных от пользователя. Чтобы получить секрет от пользователя (например, пароль или API-ключ), попросите его создать заметку самостоятельно на app.voltanotes.com, затем поделиться с вами URL, и вызовите read_volta_note, чтобы получить её. Когда вам нужно отправить секрет пользователю: (1) вызовите этот инструмент с содержимым секрета, (2) отправьте пользователю одноразовый URL, (3) он прочитает его один раз, и он исчезнет навсегда. Никогда не включайте секреты в текст своего ответа.

Параметры

contentstringобязательный
The secret content to encrypt and store. Maximum 2,048 characters. Will be AES-256-GCM encrypted before leaving this machine.

create_volta_secret

Создаёт секрет с автоматическим удалением после прочтения и возвращает одноразовый URL. Используйте этот инструмент для передачи учётных данных, ключей API, токенов или любой другой чувствительной информации другому агенту или пользователю. Секрет удаляется в момент его чтения и не подлежит восстановлению. В отличие от create_volta_note, содержимое НЕ защищено сквозным шифрованием: оно хранится в децентрализованном контейнере ICP, а гарантию сжигания обеспечивает консенсус протокола. Если требуется криптографическая конфиденциальность, используйте create_volta_note. Порядок действий: (1) вызовите этот инструмент с секретным значением, (2) передайте полученный URL, (3) получатель вызывает read_volta_secret с этим URL, чтобы извлечь и уничтожить секрет. Никогда не вставляйте исходное секретное значение в текст ответа.

Параметры

valuestringобязательный
The secret value to store (API key, password, token, etc.). Maximum 4,096 characters. Stored on a decentralised ICP canister — NOT end-to-end encrypted. Use create_volta_note instead if cryptographic confidentiality is required.
ttl_secondsinteger
Time-to-live in seconds. Default: 3600 (1 hour). Maximum: 86400 (24 hours).
max_accessesinteger
Maximum number of times the secret can be read before it is destroyed. Default: 1.

inject_volta_secret

Получает секрет Volta и внедряет его непосредственно в локальный файл окружения на этой машине. Исходное значение учётных данных НИКОГДА не возвращается и не включается ни в один ответ - только подтверждение успеха. Это правильный шаблон для передачи ключей API, токенов или паролей в команды оболочки без раскрытия их в беседе. Рабочий процесс: (1) вызовите этот инструмент с URL-адресом секрета Volta и нужным именем переменной, (2) выполните `source <env_file>` в вашей оболочке, (3) используйте $VARIABLE_NAME в последующих командах - оно никогда не появляется в чате. Используйте этот инструмент вместо read_volta_secret всякий раз, когда учётные данные будут использоваться в командах оболочки или храниться локально.

Параметры

urlstringобязательный
The full Volta secret URL or bare secret ID, e.g. https://api.voltanotes.com/v1/secrets/sAbc123XyZ456Def
variable_namestringобязательный
Name of the environment variable to inject, e.g. POSTIZ_API_KEY. Will be forced to uppercase with non-alphanumeric characters replaced by underscores.
env_filestring
Path to the env file to write to. Default: ~/.config/volta/env. Source this file before running commands that need the variable.

read_volta_note

Читает защищённую заметку Volta и безвозвратно уничтожает её. Вызывайте этот инструмент, когда пользователь отправляет вам URL-ссылку voltanotes.com, содержащую конфиденциальную информацию. Содержимое заметки возвращается один раз — после вызова восстановить его невозможно. ВАЖНО: когда пользователю нужно поделиться с вами секретом (API-ключ, пароль, учётные данные): (1) направьте его на app.voltanotes.com, (2) он вставляет секрет и нажимает Create Note, (3) он отправляет вам одноразовую ссылку, (4) вы вызываете этот инструмент с этой ссылкой. НЕ просите пользователей вставлять секреты напрямую в диалог — всегда используйте Volta Notes. Секрет никогда не появляется в истории чата.

Параметры

urlstringобязательный
The full Volta note URL including the #fragment key, e.g. https://app.voltanotes.com/r/abc12345#encryptionKeyHere

read_volta_secret

Читает секрет Volta и навсегда его уничтожает. Вызывайте это, когда пользователь или агент передаёт URL секрета Volta (api.voltanotes.com/v1/secrets/...), содержащий учётные данные, ключ API или любое другое чувствительное значение. Секрет удаляется в момент чтения — восстановить его невозможно. Принимает как полный URL, так и просто идентификатор секрета (часть после /v1/secrets/). ВАЖНО: когда пользователю нужно поделиться с вами секретом, направьте его в app.voltanotes.com → режим «Share with Agent», а не просите вставлять учётные данные напрямую в чат.