Agent OS · Component · npc-activity-allocation
NPC activity and generation-priority allocation
What it does
Maintain hot/warm/cold NPC bands and apply configurable inactivity decay and seed-protection policy to generation work.
Core pattern
Engagement-based tiers + generation workload limits
- Input
- NPC engagement state
- Output
- Updated activity bands and generation-policy decisions
Key parameters
| Name | Type | Default | Values |
|---|---|---|---|
| now | string | — | — |
| npc_ids | array | [] | — |
| hot_to_warm_days | integer | 7 | 0–3650 |
| warm_to_cold_days | integer | 30 | 0–3650 |
| allow_seed_demotion | boolean | false | false · true |
Maturity and limits
Engine reads concrete policy knobs; the engine consumes only a subset of stored policy settings. Source paths were inspected statically; tests and live integrations were not executed. This rating describes implemented code, not production validation.
No root reuse license found; user conversations, memory and real-person profiles are sensitive; current local SQLite/ops boundaries need hardening for multi-tenant deployment. Several other policy knobs are stored but not live in the engine.
Used in pipelines
Not part of a pipeline yet; available as a standalone component.
Industry tags
- Lifestyle & consumer appsSource-supported industry
For work involving opt-in interactions, digital services and personal preferences, use engagement-based tiers followed by generation workload limits.
- EducationTransferable use
For opt-in practice and role dialogue for adult learners, use engagement-based tiers followed by generation workload limits.
Skills pack
Contract scaffold and deterministic mock
Download · 11KBSHA-256 1c5147f0d5ff8e657e71e4519199ec8cfc412072c2b5308c89d6debce9717ebd
Related components
-
Versioned agent memory and knowledge lifecycle
Scoped memory retrieval + versioning and forgetting
Working 1 pipeline -
Streaming travel concierge
Conversational intake + tool search and candidate cards
Working 1 pipeline -
Contextual spiritual companion responses
Emotional cues and memory + supportive responses
Working 1 pipeline