penny_session_start
Call ONCE at the start of every conversation, before the first substantive reply. First read the installed Penny skill; report its exact metadata via installedSkillStatus/Version/Sha256/Source. Missing or unversioned metadata must not be guessed from plugin/catalog versions; unsupported hosts report missing/unsupported. Retain results in execution storage before bounded display; inspect one text OR structured payload. Check pennySkill.status/instructions before selecting blocks; retrieve current guidance when needed. Reuse the complete, untruncated profile (persona/facts/preferences/custom blocks) and answer from it before searching notes. Follow self_improvement throughout the conversation. meta.onboarding present: offer penny_start_setup, resuming from its phase. meta.saveDrought true: follow drought repair. Inventories of trackers, rhythms, tasks and Projects are capped; meta.truncated.* means drill down with penny_read. skills.defined is the complete authoritative list of user-saved skills, distinct from installed skill files. features says which features are in use and when; consult it and the inventory before choosing entityType. tz is IANA (default UTC) for local Today/Overdue and dueNow. projects is a bounded PRIVATE directory with coverage and dated attention candidates, not a search of all Spaces; read relevant Briefs by projectId. Workspace-only connections cannot call this: use penny_read target:projects view:scopes, then explicit workspaceId. projectKey includes only the matching repository subconscious block, not a Penny Project.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tz | No | IANA timezone for today/overdue boundaries (e.g. America/New_York); default UTC. | |
| projectKey | No | Include subconscious:<projectKey>; exclude all other subconscious blocks. | |
| installedSkillSha256 | No | Exact metadata.bundle_sha256; report absent metadata as unversioned. | |
| installedSkillSource | No | Manage plugin copies via plugin manager; standalone via approved archive installation. | |
| installedSkillStatus | No | Read installed skill, then report. Legacy omission returns not_reported. | |
| installedSkillVersion | No | Exact installed metadata.version; omit if missing or unversioned. |