flowstate-obs-client Package Skill

Package: @epicdm/flowstate-obs-client Repository: epic-flowstate-community Path: packages/obs-client 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

OBS Client Consumer Integration

Status: Active Purpose: Preserve compatibility for packages that depend on @epicdm/flowstate-obs-client. Scope: SDK consumers across packages and examples. Trigger: A task changes public SDK types, resource behavior, package version, or consumer wiring. Input: Changed SDK surface and affected consumer package. Output: Updated consumers and targeted verification.

Key Consumers

• packages/flowstate-cli/src/cli-commands/obs/*
• packages/flowstate-mcp/src/tools/obs/*
• packages/obs-middleware/src/*
• packages/flowstate-coordinator/src/logger.ts
• packages/flowstate-workers/src/logger.ts
• packages/flowstate-discord-bot/src/logger.ts
• examples/react-obs-demo/src/main.tsx

Workflow

1. Search consumers before changing exported types:

rg -n "@epicdm/flowstate-obs-client|ObsClient|StreamOptions|ErrorFilters|LogFilters|SessionFilters" packages examples

2. Update consumers and mocks when method signatures change.
3. Keep Jest moduleNameMapper references aligned with source exports.
4. Run package tests plus targeted consumer tests.

Verification

yarn workspace @epicdm/flowstate-obs-client test
yarn workspace @epicdm/flowstate-cli test -- obs
yarn workspace @epicdm/flowstate-mcp test -- obs
yarn workspace @epicdm/flowstate-obs-middleware test

Run broader tests only when shared types changed widely.

Created: 2026-06-29

Package Skill Inventory

@epicdm/flowstate-obs-client Skill Inventory

Inventory date: 2026-06-29 Package path: packages/obs-client Dojo status: local skills authored; publication deferred until package skill review and repo-wide Dojo sync.

Skill Map

Composition

Start with flowstate-obs-client, then pick focused skills:

1. flowstate-obs-client-rest-resources
2. flowstate-obs-client-http-errors-retry
3. flowstate-obs-client-sse-streaming
4. flowstate-obs-client-consumer-integration
5. flowstate-obs-client-maintenance

Review Notes

The generated Dojo skillset under .flowstate/dojo/agent-skillset.md is not sufficient for publication as-is. It lists classes/utilities but does not teach SDK construction, endpoint paths, retry/error behavior, SSE iteration, or downstream consumer compatibility.

Review Gate

@epicdm/flowstate-obs-client Skills Review

Review date: 2026-06-29 Reviewer: Codex Status: reviewed with verification notes

Evidence Used

• packages/obs-client/package.json
• packages/obs-client/README.md
• packages/obs-client/src/index.ts
• packages/obs-client/src/ObsClient.ts
• packages/obs-client/src/http/HttpClient.ts
• packages/obs-client/src/http/SSEClient.ts
• packages/obs-client/src/resources/*.ts
• packages/obs-client/src/types/index.ts
• packages/obs-client/src/utils/retry.ts
• packages/obs-client/tests/**/*.test.ts
• packages/obs-client/.flowstate/feature-matrix/inventory.md
• packages/obs-client/.flowstate/dojo/agent-skillset.md

Quality Gate

• Source-backed purpose: pass
• Public entry points captured: pass
• Package connections captured: pass
• Composable skill inventory: pass
• Skills formatted with name and trigger-focused description: pass
• Generated-skill replacement quality: pass
• Verification commands run: pass with warnings noted

Drift Findings

• README.md uses legacy package name @epic-flow/obs-client; current package is @epicdm/flowstate-obs-client.
• README.md says streaming is future Phase 3, but ObsClient.stream, SSEClient, and StreamResource are implemented and tested.
• README.md says MIT license while package/source declare Apache-2.0.
• .flowstate/docs is useful but does not follow the newer package-docs structure with workflows/troubleshooting/maintenance subfolders.
• Generated Dojo metadata has publisher/title drift and is not ready to publish.
• Generated Dojo skillset is export-list oriented and not ready to publish.

Verification Results

• ASCII scan for package-local skills: passed.
• Skill frontmatter scan for all SKILL.md files: passed.
• yarn workspace @epicdm/flowstate-obs-client test --runInBand --no-cache: passed, 6 suites, 62 tests; malformed SSE test intentionally logs console.error.
• yarn workspace @epicdm/flowstate-obs-client typecheck: passed.
• yarn workspace @epicdm/flowstate-obs-client build: passed.
• yarn workspace @epicdm/flowstate-obs-client lint: passed with 6 existing warnings in SSEClient.ts and StreamResource.ts.
• yarn nx build @epicdm/flowstate-obs-client: passed from local cache; Nx Cloud setup notice reported.

Publication Decision

Do not publish the existing generated Dojo skilllets. Publish only after local package skill verification and the repo-wide Dojo sync step convert these reviewed skills into Dojo payloads.

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/obs-client/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.