@exellix/ai-tasks-service
v0.3.0
Published
HTTP AI-service for tasks — zone ai-tasks, /ai-services/v1/*, runTask + shared skill catalog mutation
Readme
@exellix/ai-tasks-service
Published AI-service for tasks (AI-services/v1 FR).
| | |
|--|--|
| packageId | @exellix/ai-tasks-service |
| aiServiceType | task |
| zoneId | ai-tasks |
| default port | 5440 (AI_TASKS_SERVICE_PORT override) |
| cataloxCatalogIds | ai-skills (HTTP items surface) |
Task strategy catalogs owned by @exellix/ai-tasks remain library concerns; this service lists skills as selectable items, mutates the shared ai-skills catalog (same FR-AIS-6 routes as skills-service), and invokes via runTask().
Install and run
npm install @exellix/ai-tasks-service
npx ai-tasks-service serve
# → HTTP on zone port; /health, /_live, /ai-services/v1/*HTTP contract
| Method | Path | Purpose |
|--------|------|---------|
| GET | /ai-services/v1/descriptor | Service descriptor (+ capabilities) |
| GET | /ai-services/v1/items | List Catalox ai-skills (q, tag, limit) |
| GET | /ai-services/v1/items/:id | Skill/item detail |
| POST | /ai-services/v1/invoke | { itemId, input?, execution? } → runTask |
| POST/PATCH/DELETE | /ai-services/v1/items… | Catalog mutation (shared with skills-service) |
| POST | /ai-services/v1/items/:id/actions/:action | publish, unpublish, archive, rename, fork |
| content / variables / tokens / references / export / import | same as skills-service | FR-AIS-6 |
itemId is the MAIN skill key. Fold the rest of RunTaskRequest into input / execution. If executionStrategies is omitted, it defaults to [] (plain MAIN).
Required env
MONGO_URIorMONGODB_URI— Catalox 6- AI gateway / provider keys as required by
@exellix/ai-tasks
Library embeds remain available via @exellix/ai-tasks (runTask); this package is the HTTP serve surface.
