tai/taicpp/docs/wiring/misc.md

wiring: hooks the integrator must apply for the misc modules

Do not edit these modules; bind them. Include dirs: src/skills src/sched src/telegram src/rag src/install (file names are unique across them). Link: -lsqlite3 -lcurl -lz -lpthread. Sources: add the five dirs to ALL_SRCS (the Makefile find src -name '*.cpp' already picks them up). tests/misc.mk is the standalone build and tests/misc_diff.py the differential test; fold them into make test.

CLI flags (src/cli, main.cpp)

flag	binding
--install	Installer::install_self(); context: script_path = path of the running binary, script_needs_interpreter=false, version_reader for the native binary
--install-telegram	Installer::install_telegram()
--uninstall-telegram	Installer::uninstall_telegram()
--telegram	after boot: TelegramBot(agent_port, nullptr, &box, log).run_telegram_bot(); default profile telegram
--scheduler	print scheduler online, press Ctrl-C to stop, then Scheduler::run_scheduler_loop(StopFlag)
--eval-retrieval	RetrievalEval::run_eval(db, FtsSearch, profile, sealed), print, exit 0
--stats-rag	no tai.py counterpart; leave unbound or remove from the parser
--update-models	not in this area

Ports to implement on the other side

• AgentPort (sched): running_agents, spawn_agent (throw AgentsFull), poll_agent. ScheduleHost, SkillHost, RagHost, AuditHost, ReleaseHost: the Tools object supplies approval, profile, store and skills refresh.
• SealPort/TagPort over the foundation Store; register the tai_dec SQL function when sealed (implicit_pairs).
• ContainerPort (install) and BoxPort (telegram): container engine, box state, ensure_box, box_transcribe.
• LogSink: forward to the DebugLog (event, set_context, clear_context).
• TelegramAgent: profile, bot, home, reset_history, run_turn(capture=True), start_scheduler.

Tool table

Register handlers: load_skill, create_skill, install_skill -> SkillTool; schedule, unschedule, schedules -> ScheduleTool; search -> RagTool; audit, restore, tags -> AuditTool; release -> ReleaseTool; install -> Installer::run_install (refresh skills after a non-status skills action). At boot call SelfRelease::ensure_self_backup; system prompt uses SkillFiles::skill_catalog. INSTALL_TARGETS is InstallConsts::INSTALL_TARGETS(); the skills target is Installer::op_skills.