[a7vinx]

Summary

Add an Instinct setup guide and a reusable Pine skill for agents using Pine's existing user APIs. The skill supports Socket.IO for live updates and REST for HTTP-only environments; Python and native skill installation are not required.

• Add install/instinct.md as the setup entry point.
• Add skills/pine/SKILL.md and references/phone-tasks.md, reusing the existing MCP phone-task guidance. Cover email authentication, secure token storage, task progress, form replies, stopping tasks, and recovery from uncertain requests.
• Link the guide and public OpenAPI and AsyncAPI contracts from the existing documentation.

This is a documentation-only change. SDK runtime behavior and defaults are unchanged.

API documentation availability

The OpenAPI and AsyncAPI links temporarily point to documentation hosted on staging. Authentication, HTTP requests, Socket.IO connections, and task pages continue to use production at https://www.19pine.ai. The skill explicitly resolves the OpenAPI contract's relative /api server against production, independently of the documentation host.

The linked contracts must be available before setup can complete. Their URLs will be updated when production documentation is available.

Validation

• Skill structure validation, local Markdown link checks, and git diff --check passed.
• PYTHONPATH=src python -m pytest tests/protocol -q: 84 passed using local fixtures and a simulated transport; no live connection.
• Reviewed history decoding, form fallback, and uncertain-write recovery against the API implementation.
• End-to-end Instinct setup, secure credential storage in Instinct, and live authentication were not tested.