worker-agent-memory Package Skill

Package: @epicdm/worker-agent-memory Repository: flowstate-platform Path: packages/worker-agent-memory Version: 0.1.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

Agent Memory Worker

Status: Active Purpose: Preserve the worker's route, middleware, queue, and scheduled-handler contracts. Scope: packages/worker-agent-memory Trigger: Worker entrypoint, middleware, route mounting, binding, queue, or scheduled cleanup changes. Input: Target route or lifecycle behavior and required Cloudflare bindings. Output: Correct worker composition and verification plan.

Workflow

Start at src/index.ts and preserve layer order: CORS, public health, auth, rate limiter, route groups.
Mount new API behavior under /v1/* unless it is a deliberate public health/liveness path.
Keep auth context available before the rate limiter; rate limiting uses the authenticated user context.
Update src/bindings.ts and tests when bindings change.
Keep exported lifecycle handlers wired: fetch, queue: handleQueue, and scheduled: handleScheduled.

Route Map

Path	Module
`/v1/working-memory`	`src/routes/working-memory.ts`
`/v1/long-term-memory`	`src/routes/long-term-memory.ts`
`/v1/memory`	`src/routes/memory-prompt.ts`
`/v1` summary views	`src/routes/summary-views.ts`
`/v1` task status	`src/routes/tasks.ts`

Verification

Run yarn workspace @epicdm/worker-agent-memory test.
Run yarn workspace @epicdm/worker-agent-memory typecheck.

Package Skill Inventory

Skill Inventory: @epicdm/worker-agent-memory

Package Role

@epicdm/worker-agent-memory is the D1/KV/Vectorize-backed agent memory worker for working memory sessions, long-term memory, prompt context, summary views, queue jobs, and TTL cleanup.

Skills

Skill	Type	Use When	Source Backing
`agent-memory-worker`	Workflow	Changing worker composition, middleware, bindings, or route mounting.	`src/index.ts`, `src/bindings.ts`, middleware files
`working-memory-workflows`	Workflow/reference	Working on working memory route/service behavior.	`src/routes/working-memory.ts`, `src/services/working-memory.ts`, route tests
`memory-queue-jobs`	Workflow	Adding or debugging queue jobs and scheduled handlers.	`src/queue/consumer.ts`, `src/queue/jobs/*`, `src/cron/ttl-cleanup.ts`, queue tests

Composition Notes

Compose route skills with service tests under src/__tests__/routes and src/__tests__/services.
Compose queue job changes with Cloudflare queue semantics and D1 schema review.
Do not treat memory JSON text fields as typed JSON columns; callers serialize and deserialize.

Review Gate

Review Gate: @epicdm/worker-agent-memory Skills

Result

Pass.

Checks

Skills are backed by app composition, schema, route, service, queue, and test files.
Compatibility and queue ack/retry edge cases are explicit.
Verification commands are package-local.

flowstate-flowstate-platform-epicdm-worker-agent-memory

Tags

Publisher

Versions

Skill