Envelope Sender
Use this skill to send a single local PDF document for signature with eSignGlobal through an external CLI.
Installation
Use the external CLI through npx:
CODEBLOCK0
Setup
Before calling any send action, set ESIGNGLOBAL_APIKEY in the shell environment.
CODEBLOCK1
Credential handling rules:
- - The CLI reads credentials only from INLINECODE2
- Do not implement local credential storage inside this skill
- Do not print or persist secrets
Workflow
- 1. Collect a single absolute
filePath, signer list, and optional INLINECODE4 - Confirm the file is a
.pdf and the signer data is complete - Set
ESIGNGLOBAL_APIKEY in the current shell session - Run the external CLI command to send the envelope
- Return the CLI result to the user
Safety Rules
- - Only use a file path the user explicitly provided for this task
- Only handle one local PDF file per run
- Refuse relative paths; require an absolute path to a
.pdf file - Reject any non-PDF file before invoking the CLI
- Never print or persist secrets
- Do not scan directories, expand globs, or discover files on the user's behalf
- Only call the trusted eSignGlobal CLI configured for this environment
Required Inputs
- -
filePath: absolute path to an existing local PDF file - INLINECODE9 : JSON array of signer objects
- INLINECODE10 : optional email or envelope subject
Each signer must include:
- - INLINECODE11
- INLINECODE12
Optional field:
- -
signOrder as an integer INLINECODE14
Input Format
filePath
INLINECODE15 must be an absolute path to an existing local PDF file.
Example:
CODEBLOCK2
signers
Each signer must include:
- - INLINECODE16
- INLINECODE17
Optional field:
- -
signOrder (integer, minimum 1)
Single signer example:
CODEBLOCK3
Sequential signing example:
CODEBLOCK4
Parallel signing example:
CODEBLOCK5
External CLI Pattern
Use the external command-line tool instead of bundled scripts:
CODEBLOCK6
Check available commands if needed:
CODEBLOCK7
Example:
CODEBLOCK8
Required Configuration
- - Node.js 18 or later
- Access to the trusted external CLI, either preinstalled or available through INLINECODE20
- INLINECODE21 must already be configured in the shell environment
Output
Return the external CLI result. Do not bundle or implement upload logic inside this skill.
信封发送器
使用此技能通过外部CLI将单个本地PDF文档发送至eSignGlobal进行签名。
安装
通过npx使用外部CLI：
bash
npx @esignglobal/envelope-cli
设置
在执行任何发送操作前，在Shell环境中设置ESIGNGLOBAL_APIKEY。
bash
Windows PowerShell
$env:ESIGNGLOBAL
APIKEY=yourapi_key
macOS / Linux
export ESIGNGLOBAL
APIKEY=yourapi_key
验证连接
npx @esignglobal/envelope-cli config health
凭证处理规则：
- - CLI仅从ESIGNGLOBAL_APIKEY读取凭证
- 请勿在此技能中实现本地凭证存储
- 请勿打印或持久化存储密钥
工作流程
- 1. 收集单个绝对路径filePath、签署人列表及可选的subject
- 确认文件为.pdf格式且签署人数据完整
- 在当前Shell会话中设置ESIGNGLOBAL_APIKEY
- 运行外部CLI命令发送信封
- 将CLI结果返回给用户
安全规则
- - 仅使用用户明确为此任务提供的文件路径
- 每次运行仅处理一个本地PDF文件
- 拒绝相对路径；要求提供指向.pdf文件的绝对路径
- 在调用CLI前拒绝任何非PDF文件
- 切勿打印或持久化存储密钥
- 请勿扫描目录、展开通配符或代用户发现文件
- 仅调用为此环境配置的可信eSignGlobal CLI
必需输入
- - filePath：现有本地PDF文件的绝对路径
- signers：签署人对象的JSON数组
- subject：可选的电子邮件或信封主题
每个签署人必须包含：
可选字段：
输入格式
filePath
filePath必须是现有本地PDF文件的绝对路径。
示例：
text
/tmp/contract.pdf
signers
每个签署人必须包含：
可选字段：
单个签署人示例：
json
[
{
userName: Bob Smith,
userEmail: bob@example.com
}
]
顺序签署示例：
json
[
{
userName: Bob Smith,
userEmail: bob@example.com,
signOrder: 1
},
{
userName: Alice Jones,
userEmail: alice@example.com,
signOrder: 2
}
]
并行签署示例：
json
[
{
userName: Bob Smith,
userEmail: bob@example.com,
signOrder: 1
},
{
userName: Alice Jones,
userEmail: alice@example.com,
signOrder: 1
}
]
外部CLI模式
使用外部命令行工具而非捆绑脚本：
bash
npx @esignglobal/envelope-cli send-envelope --file --signers [--subject ] --confirm
如需查看可用命令：
bash
npx @esignglobal/envelope-cli help
示例：
bash
npx @esignglobal/envelope-cli send-envelope --file C:\\docs\\contract.pdf --signers [{userName:Bob Smith,userEmail:bob@example.com}] --subject 请签署此合同 --confirm
必需配置
- - Node.js 18或更高版本
- 可访问可信的外部CLI，已预安装或可通过npx获取
- Shell环境中必须已配置ESIGNGLOBAL_APIKEY
输出
返回外部CLI结果。请勿在此技能中捆绑或实现上传逻辑。
