flowstate-epic-flowstate-community-epicdm-flowstate-agents-core
Package-local agent skill for @epicdm/flowstate-agents-core.
Tags
Publisher
Versions
1 version published — latest: 1.0.7
- 1.0.7publishedInvalid Date
Skill
flowstate-agents-core Package Skill
Package: @epicdm/flowstate-agents-core
Repository: epic-flowstate-community
Path: packages/agents-core
Version: 1.0.7
Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.
Primary Package Workflow
Agents Core API Reference
Status: Active
Purpose: Provide lookup guidance for source-backed agents-core API contracts.
Scope: src/index.ts, src/schemas/index.ts, src/collections/index.ts, .flowstate/docs/api/index.md.
Trigger: API lookup, docs repair, skill authoring, package integration.
Input: Source/API question.
Output: Correct field/export/method answer.
Authority Order
src/schemas/*.schema.tssrc/collections/*.collection.tssrc/collections/index.ts.flowstate/docs/api/index.md- Existing docs/README only after source comparison
Known Drift
- README uses stale package scope and symbols.
src/utilsis exported but empty.- Generated Dojo splits symbols into weak feature skilllets.
Done When
- The answer cites source or API docs.
- Stale README/generated Dojo claims are not repeated.
Package Skill Inventory
Package Skill Inventory: @epicdm/flowstate-agents-core
Package Context
Package path: /Users/sthornock/code/epic/epic-flowstate-community/packages/agents-core
This package is a data-contract layer for agents, conversations, messages, providers, usage stats, and model pricing. It already had a useful orchestrator skill; this inventory adds focused subskills and review evidence.
Skill Map
| Skill | Type | Trigger | Teaches | Evidence | Depends On | Dojo |
|---|---|---|---|---|---|---|
flowstate-agents-core | orchestrator | Use when working on agents-core schemas, collections, docs, tests, exports, or feature inventory | Routes validation, RxDB, usage, provider safety, troubleshooting, maintenance | existing SKILL.md, source/docs | package docs | ready-after-review |
flowstate-agents-core-data-contracts | workflow | Use when adding or changing Zod/RxDB agent data contracts | Keep Zod, TS types, RxDB schemas, indexes, and tests aligned | src/schemas, src/collections | orchestrator | ready-after-review |
flowstate-agents-core-rxdb-registration | workflow | Use when wiring agents-core collections into RxDB | Register schema/method/static bundles and collection types | quick-start, collections/index.ts | data contracts | ready-after-review |
flowstate-agents-core-conversation-usage | workflow | Use when storing conversations/messages or calculating usage | Conversation ordering, messages, token aggregation, model pricing null behavior | message/model-pricing collections | RxDB registration | ready-after-review |
flowstate-agents-core-provider-safety | troubleshooting | Use when provider credentials, API keys, or provider lookups are involved | Plain-string apiKey, active lookup, no vault behavior | provider schema/collection | data contracts | local-only |
flowstate-agents-core-api-reference | reference | Use when checking exact fields, enums, exports, or method signatures | Dense source-backed API lookup | docs/api, source | none | ready-after-review |
flowstate-agents-core-maintenance | maintenance | Use when changing fields, schema versions, docs, feature matrix, or exports | Verification, docs/matrix updates, drift checks | maintenance docs, package scripts | orchestrator | ready-after-review |
Anti-Sprawl Decision
Seven skills are appropriate including the existing orchestrator. The package has many exported symbols, but only a few real workflows: evolve contracts, register collections, store/query conversations and usage, handle provider metadata safely, look up APIs, and maintain docs.
Feature Coverage
| Feature Group | Source Evidence | Covered By | Notes |
|---|---|---|---|
| Agent schema/collection | agent.* | data-contracts, rxdb-registration | Active queries and archive methods |
| Conversation schema/collection | conversation.* | conversation-usage | Caller must update lastMessageAt |
| Message/tool/API metadata | message.* | conversation-usage, api-reference | Assistant-only metadata not enforced |
| Provider metadata | provider.* | provider-safety | Encryption not implemented |
| Usage stats | agent-usage-stats.* | conversation-usage, api-reference | Test gaps remain |
| Model pricing/cost | model-pricing.* | conversation-usage | Missing pricing returns null |
| Root exports | src/index.ts | orchestrator, api-reference | utils empty |
Composition Model
Start with flowstate-agents-core. Contract changes go to data-contracts and maintenance. App integration uses RxDB registration and conversation-usage. Provider secrets always load provider-safety. API reference is the dense lookup surface.
Deferred Skills
- Downstream integration skill: defer until real downstream imports exist.
- Migration skill: defer until schema version moves beyond
0. - Utils skill: defer because
src/utilsis empty. - Provider encryption skill: defer until implemented.
Review Questions
- Should provider documents gain archive semantics, or should docs stop saying provider soft-delete exists?
- Should
messageSchemaenforce assistant-onlyapiMetadata? - Should collection tests be added for provider, usage stats, and model pricing before Dojo publish?
Review Gate
Package Skills Review: @epicdm/flowstate-agents-core
Verdict
Pass with fixes.
The package now has a source-backed inventory and focused subskills layered under the existing useful orchestrator. Existing generated Dojo remains unsuitable for publication.
Findings
| Severity | Skill | Issue | Evidence | Required Fix |
|---|---|---|---|---|
| Important | provider-safety | Provider API key encryption is not implemented | provider collection TODO | Keep safety warning until implemented |
| Important | all | Generated Dojo is symbol-sprawly | .flowstate/dojo/* | Rebuild from reviewed skills |
| Minor | API/docs | README is stale | README vs source | Update before final Dojo publish |
| Minor | maintenance | Verification passed after authoring; build emitted an existing package exports warning | test, typecheck, build passed | Track package export condition order separately |
Coverage
| Feature Group | Status | Skill | Notes |
|---|---|---|---|
| Zod/RxDB contracts | Covered | data-contracts | Main change workflow |
| RxDB registration | Covered | rxdb-registration | App integration |
| Conversation/messages/usage/pricing | Covered | conversation-usage | Includes null pricing |
| Provider metadata safety | Covered | provider-safety | Plain API key warning |
| API lookup | Covered | api-reference | Source authority |
| Maintenance/docs/Dojo | Covered | maintenance | Rebuild before publish |
Drift and Contract Risks
| Area | Risk | Evidence | Decision |
|---|---|---|---|
| README | Wrong scope/symbols | README vs source | Source wins |
| Provider docs | Soft-delete/encryption overstated | docs vs source | Warn/defer |
| Dojo | Generated symbol skilllets | .flowstate/dojo/* | Rebuild |
| Tests | Some collection methods untested | review finding | Track follow-up |
Dojo Publication Decision
Do not publish existing generated Dojo files. Rebuild Dojo artifacts from reviewed local skills after verification.
Follow-Up Work
- Package verification passed:
yarn workspace @epicdm/flowstate-agents-core testyarn workspace @epicdm/flowstate-agents-core typecheckyarn workspace @epicdm/flowstate-agents-core build
- Update stale README/docs.
- Add tests for provider, usage stats, and model pricing methods.
- Rebuild Dojo artifacts.
Usage
Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with packages/agents-core/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.
Install
Run this in your project to install via CLI:
fscloud dojo skill install flowstate-epic-flowstate-community-epicdm-flowstate-agents-core --target <target> --out ./skillsReplace <target> with your agent target identifier. See the CLI docs for details.