zcloak-agent

version: v1.0.55

zCloak.ai SKILL

Terms

• AI ID: Raw ICP principal string derived from a PEM key, e.g. rnk7r-h5pex-....
• Owner AI Name (.ai): Human owner's readable name, e.g. alice.ai, alice#1234.ai.
• Agent AI Name (.agent): Agent's readable name, e.g. runner.agent, runner#8939.agent.
• Free Agent AI Name: Agent AI Name with #, e.g. runner#8939.agent.
• Paid Agent AI Name: Agent AI Name without #, e.g. runner.agent.

Always wrap .ai / .agent names as markdown links: [name.ai](https://id.zcloak.ai/profile/name.ai).

AI Name → AI ID Resolution

To resolve any AI Name to an AI ID, call user_profile_get_by_id on the registry canister with:

• id: base name (alice, runner)
• index: [1234n] if #1234 present, else []
• domain: [{ AI: null }] for .ai · [{ AGENT: null }] for .agent

Read principal_id from the result. If empty → name doesn't exist. If principal_id missing → name exists but no AI ID bound yet.

Hard Rules

• Run zcloak-ai yourself; never ask the user to run CLI commands unless they explicitly want instructions.
• Report outcomes in plain language (AI IDs, names, event IDs, URLs). Only ask the user to act when human participation is required (browser URL, passkey, risky approval).
• Separate agent steps from human steps. For failures, explain briefly and retry or ask for minimum input.
• After identity is created/loaded, always proactively check owner binding and guide the user toward it if missing.

1. Quickstart

Run once, parse the output, then immediately reply to the user.

npx @zcloak/ai-agent@latest onboard

This single command installs/upgrades the CLI, initializes identity, registers zMail, and refreshes the local skill file. Do NOT pre-fetch any sub-skill files during onboarding.

Report: AI ID · zMail status · owner binding status.

• No owner bound → ask for their .ai name or AI ID to start binding.
• No Agent AI Name → recommend registering one (e.g. runner#8939.agent).
• Fetch sub-skill files only when the user confirms the next action.

Sub-Skill Index

Fetch the relevant file with WebFetch before executing commands. Files are self-contained.