flowstate-dojo-community-epicdm-flowstate-shell-server

Use this skill when a task touches packages/flowstate-shell-server, imports @epicdm/flowstate-shell-server, or needs to teach humans/agents how this package works.

Package identity:

• Package: @epicdm/flowstate-shell-server
• Repository: epic-flowstate-community
• Version authority: package.json (1.0.7)
• Dojo course: flowstate-dojo-community-epicdm-flowstate-shell-server

How to use the package:

• Purpose: WebSocket server for FlowState Shell with node-pty
• Start with package-local docs when present.
• Verify details against source and tests before changing behavior.
• Use the Dojo course lessons as the teaching path: setup, mental model, core workflow, integration, feature labs, maintenance.

Public surfaces discovered:

• SessionStore
• TerminalSessionManager
• TmuxAdapter
• ShellWebSocketServer
• createLogger
• getLogFilePath
• SessionConnectionStatus
• ShellType
• SessionContext
• SessionMetadata
• SessionInfo
• SessionManagerConfig
• SessionRecord
• BaseMessage
• ListSessionsMessage
• CreateSessionMessage
• ReconnectSessionMessage
• DataMessage
• ResizeMessage
• DisconnectMessage
• CloseSessionMessage
• RenameSessionMessage
• DeleteSessionMessage
• UpdateSessionMessage
• AuthMessage
• ClientMessage
• SessionsListMessage
• SessionCreatedMessage
• SessionReconnectedMessage
• SessionDataMessage

Composable feature skilllets:

• _reset Key Cache: use feature labs for workflow, source anchor, and regression risk.
• Create Logger: use feature labs for workflow, source anchor, and regression risk.
• Get Log File Path: use feature labs for workflow, source anchor, and regression risk.
• Load Public Key From File: use feature labs for workflow, source anchor, and regression risk.
• Session Store: use feature labs for workflow, source anchor, and regression risk.
• Shell Web Socket Server: use feature labs for workflow, source anchor, and regression risk.
• Terminal Session Manager: use feature labs for workflow, source anchor, and regression risk.
• Tmux Adapter: use feature labs for workflow, source anchor, and regression risk.
• Verify Jwt: use feature labs for workflow, source anchor, and regression risk.

Agent operating rules:

• Treat package.json as the Dojo version authority.
• Do not turn feature inventory into user-facing lessons without workflow context.
• Update this Dojo package when package behavior, docs, examples, or feature inventory changes.
• Verify downstream packages when package use and connection metadata shows inbound dependencies or references.
• Never mark publish status passed without successful cloud publish and catalog lookup.

Use this Dojo skill with package human docs, package-local feature inventory, agent-skillset.md, and the generated course.json in this folder. Keep this manifest version aligned with package.json.