een-api-toolkit 0.3.55 → 0.3.63

package/.claude/agents/docs-accuracy-reviewer.md

@@ -2,7 +2,7 @@
 name: docs-accuracy-reviewer
 description: |
   Use this agent when you need to verify that project documentation accurately reflects the actual codebase, when checking for broken links in markdown files, when validating configuration examples in documentation, or when ensuring README and other docs are up-to-date with implemented features. This agent reads documentation and compares it against source code but does not modify code files.
-model: inherit
+model: sonnet
 color: purple
 ---
 
@@ -70,6 +70,7 @@ assistant: "I'll use the docs-accuracy-reviewer agent to verify the een-* agent
    - List all markdown files in the project (README.md, docs/**, CLAUDE.md, etc.)
    - **Scan ALL example directories** (`examples/*/README.md`) - do not skip any
    - **Check ALL agent files** in `.claude/agents/een-*.md` - verify function signatures and code examples against actual implementations
+   - **Check ALL skill files** in `.claude/skills/*/SKILL.md` - verify referenced scripts, npm commands, and workflows match actual implementations
    - Identify the source code structure for cross-referencing (especially `src/index.ts` exports, `src/*/service.ts` implementations, and `src/types/*.ts` definitions)
 
 2. **Analysis Phase**:
@@ -122,6 +123,17 @@ assistant: "I'll use the docs-accuracy-reviewer agent to verify the een-* agent
 - Verify .env.example matches documentation
 - Check that all required secrets are documented
 
+### For Skills (`.claude/skills/*/SKILL.md`):
+- **Script References**: Verify all referenced scripts exist in `scripts/` and are executable
+- **npm Commands**: Verify all `npm run` commands exist in `package.json` scripts
+- **Workflow Steps**: Verify described workflows match actual tool capabilities and script behavior
+- **File Paths**: Verify all referenced file paths and directories exist
+- Cross-reference the PR-and-check skill's test commands against actual `package.json` scripts
+
+### For Test Runner Agent (`.claude/agents/test-runner.md`):
+- Verify documented test commands match `package.json` scripts (e.g., `npm run test:e2e:examples` for example app E2E tests)
+- Verify the E2E test execution approach matches the actual `scripts/run-examples-e2e.sh` behavior
+
 ### For Claude Agent Files (`.claude/agents/een-*.md`):
 - **Function Signatures**: Verify all documented function signatures match actual implementations in `src/*/service.ts`
 - **Parameter Names**: Check that parameter names in examples match the actual API (e.g., `deviceId` not `cameraId`, `userId` as direct param not `{ id: userId }`)
@@ -176,9 +188,10 @@ Before completing your review:
 1. Verify you've checked ALL markdown files in the project
 2. **Confirm ALL example app READMEs were reviewed** (list them in your report)
 3. **Confirm ALL `.claude/agents/een-*.md` files were reviewed** for API accuracy
-4. Confirm each fix you made is backed by evidence from source code
-5. Re-read modified sections to ensure they're clear and accurate
-6. Check that your fixes didn't introduce new broken links or inconsistencies
+4. **Confirm ALL `.claude/skills/*/SKILL.md` files were reviewed** for script and npm command accuracy
+5. Confirm each fix you made is backed by evidence from source code
+6. Re-read modified sections to ensure they're clear and accurate
+7. Check that your fixes didn't introduce new broken links or inconsistencies
 
 ## Common Agent File Issues to Watch For
 

package/.claude/agents/een-auth-agent.md

@@ -119,7 +119,7 @@ const authStore = useAuthStore()
 authStore.token          // Current access token
 authStore.baseUrl        // EEN API base URL (region-specific)
 authStore.isAuthenticated // Computed: true if valid token exists
-authStore.isExpired      // Computed: true if token expired
+authStore.isTokenExpired // Computed: true if token expired
 ```
 
 ### authStore.initialize() - Session Restoration (CRITICAL)

package/.claude/agents/een-devices-agent.md

@@ -46,9 +46,10 @@ assistant: "I'll use the een-devices-agent to help fetch bridges with getBridges
 1. List and filter cameras with getCameras()
 2. List and filter bridges with getBridges()
 3. Get device details with getCamera() / getBridge()
-4. Implement status filtering (online, offline, streaming, etc.)
-5. Implement tag-based filtering
-6. Full-text search with q parameter
+4. Get camera operational settings with getCameraSettings()
+5. Implement status filtering (online, offline, streaming, etc.)
+6. Implement tag-based filtering
+7. Full-text search with q parameter
 
 ## Key Types
 
@@ -103,6 +104,32 @@ type BridgeStatus =
   | 'initializing'
 ```
 
+### CameraSettings
+```typescript
+interface CameraSettings {
+  data: CameraSettingsData
+  schema?: object         // When include contains 'schema'
+  proposedValues?: object // When include contains 'proposedValues'
+}
+
+interface CameraSettingsData {
+  timeZone?: string
+  rtsp?: CameraRtspConnectionSettings
+  credentials?: { username?: string; password?: string }
+  retention?: CameraSettingsRetention
+  audio?: CameraSettingsAudio
+  previewVideo?: CameraSettingsPreviewVideo
+  mainVideo?: CameraSettingsMainVideo
+  analog?: CameraSettingsAnalog
+  operatingSettings?: CameraSettingsOperating
+  talkdown?: CameraSettingsTalkdown
+}
+
+interface GetCameraSettingsParams {
+  include?: ('schema' | 'proposedValues')[]
+}
+```
+
 ### ListCamerasParams
 ```typescript
 interface ListCamerasParams {
@@ -114,7 +141,7 @@ interface ListCamerasParams {
   status__ne?: CameraStatus      // Exclude this status
   tags__contains?: string[]      // Must have ALL these tags
   tags__any?: string[]           // Must have ANY of these tags
-  bridgeId__eq?: string          // Cameras on specific bridge
+  bridgeId__in?: string[]        // Cameras on specific bridge(s)
   q?: string                     // Full-text search
 }
 ```
@@ -191,6 +218,26 @@ async function fetchCamera(cameraId: string) {
 }
 ```
 
+### getCameraSettings(cameraId, params?)
+Get operational settings for a camera:
+```typescript
+import { getCameraSettings, type CameraSettings } from 'een-api-toolkit'
+
+async function fetchSettings(cameraId: string) {
+  const result = await getCameraSettings(cameraId, {
+    include: ['schema', 'proposedValues']
+  })
+
+  if (result.error) {
+    console.error('Failed to get settings:', result.error.message)
+    return null
+  }
+
+  console.log('Retention:', result.data.data.retention?.cloudDays, 'days')
+  return result.data
+}
+```
+
 ### getBridges()
 List bridges:
 ```typescript

package/.claude/agents/een-events-agent.md

@@ -316,6 +316,7 @@ import { listAlerts, type Alert, type ListAlertsParams } from 'een-api-toolkit'
 async function fetchAlerts() {
   const result = await listAlerts({
     status__in: ['active', 'acknowledged'],
+    include: ['data', 'actions', 'dataSchemas', 'description'],
     pageSize: 20
   })
 
@@ -325,6 +326,13 @@ async function fetchAlerts() {
 }
 ```
 
+#### Alert Include Parameter
+The `include` parameter controls what additional data is returned with each alert:
+- `'data'` - Include alert data objects (varies by alert type)
+- `'actions'` - Include actions executed for this alert
+- `'dataSchemas'` - Include list of data schema types
+- `'description'` - Include human-readable description
+
 ### Alert Priority
 Alert priority is an integer value ranging from **0 to 10**:
 - `0` = Lowest priority

package/.claude/agents/een-media-agent.md

@@ -164,8 +164,8 @@ import { getRecordedImage, formatTimestamp } from 'een-api-toolkit'
 async function fetchRecordedFrame(deviceId: string, date: Date) {
   const result = await getRecordedImage({
     deviceId,
-    timestamp: formatTimestamp(date.toISOString()),  // MUST use formatTimestamp()
-    type: 'preview'  // Optional, defaults to 'preview'
+    timestamp__gte: formatTimestamp(date.toISOString()),  // MUST use formatTimestamp()
+    type: 'preview'  // Optional
   })
 
   if (result.data) {
@@ -179,12 +179,14 @@ List recorded media intervals:
 ```typescript
 import { listMedia, formatTimestamp, type ListMediaParams } from 'een-api-toolkit'
 
-async function fetchRecordings(cameraId: string, startDate: Date, endDate: Date) {
+async function fetchRecordings(deviceId: string, startDate: Date, endDate: Date) {
   const result = await listMedia({
-    cameraId,
+    deviceId,
+    type: 'preview',                              // Stream type: 'preview' or 'main'
+    mediaType: 'video',                            // Content type: 'video' or 'image'
     startTimestamp: formatTimestamp(startDate),
     endTimestamp: formatTimestamp(endDate),
-    type: 'video'
+    include: ['hlsUrl']                            // Request HLS URLs for playback
   })
 
   if (result.data) {

package/.claude/agents/een-users-agent.md

@@ -54,8 +54,8 @@ assistant: "I'll use the een-users-agent to diagnose the user lookup issue and i
 ```typescript
 interface User {
   id: string
-  firstName?: string
-  lastName?: string
+  firstName: string
+  lastName: string
   email: string
   isActive?: boolean
   permissions?: string[]
@@ -71,9 +71,9 @@ interface UserProfile {
   firstName: string
   lastName: string
   email: string
-  accountId: string
-  permissions: string[]
-  // ... profile-specific fields
+  accountId?: string
+  timeZone?: string
+  language?: string
 }
 ```
 

package/.claude/agents/test-runner.md

@@ -2,7 +2,7 @@
 name: test-runner
 description: |
   Use this agent when you need to run the complete test suite for the project, including unit tests (Vitest) and E2E tests (Playwright). This agent is ideal after writing a logical chunk of code, before creating a PR, or when you want to verify the overall health of the codebase. The agent executes tests and reports results but does not modify any code.
-model: inherit
+model: sonnet
 color: green
 ---
 
@@ -69,14 +69,16 @@ Capture and analyze:
 - Test file locations for failures
 
 ### Step 3: Execute E2E Tests
-Run the Playwright E2E test suite:
+Run the Playwright E2E tests for all example apps:
 ```bash
-npm run test:e2e
+npm run test:e2e:examples
 ```
+This script (`scripts/run-examples-e2e.sh`) discovers all example apps with `playwright.config.ts`, frees port 3333 between runs, and stops on first failure.
+
 Capture and analyze:
-- Browser contexts tested
-- Total E2E scenarios run
-- Passed/failed counts
+- Which example apps passed/failed
+- Total E2E scenarios run across all apps
+- Passed/failed counts per app
 - Screenshots or traces for failures (if available)
 - Timeout or network-related issues
 

package/CHANGELOG.md

@@ -2,20 +2,123 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.3.55] - 2026-02-03
+## [0.3.63] - 2026-02-07
 
 ### Release Summary
 
-No PR descriptions available for this release.
+#### PR #90: feat: Add getCameraSettings API, E2E coverage, and PR skill update
+## Summary
+
+- **feat:** Add `getCameraSettings()` API function for `GET /cameras/{cameraId}/settings` endpoint with full TypeScript types
+- **feat:** Simplify camera list cards (name, ID, bridge only) with detail/settings modals fetching full data on demand
+- **feat:** Add Google Maps link on camera detail page when coordinates exist
+- **test:** Add 4 new E2E tests covering card content, details modal includes, settings modal schema/proposedValues, and Google Maps link
+- **chore:** Update PR-and-check skill to run E2E tests sequentially with port 3333 cleanup between apps
+- **docs:** Update vue-cameras home page and screenshot
+
+## Version
+
+`0.3.59`
+
+## Commits
+
+- `0aa36a3` test: Add E2E coverage tests and update PR skill for sequential E2E runs
+- `c8299a9` docs: Update vue-cameras home page to reflect current features
+- `b3507ed` chore: Resize vue-cameras screenshot to 1200px width
+- `bb5f11d` feat: Add getCameraSettings API, simplify camera list, add Google Maps link
+
+## Test Results
+
+| Check | Result |
+|-------|--------|
+| Lint | Passed |
+| Unit Tests | 600 passed (22 files) |
+| Build | Passed |
+| vue-alerts-metrics E2E | 20 passed |
+| vue-automations E2E | 24 passed |
+| vue-bridges E2E | 15 passed |
+| vue-cameras E2E | 41 passed |
+| vue-event-subscriptions E2E | 15 passed |
+| vue-events E2E | 16 passed |
+| vue-feeds E2E | 12 passed |
+| vue-jobs E2E | 34 passed |
+| vue-layouts E2E | 14 passed |
+| vue-media E2E | 15 passed, 1 pre-existing failure* |
+| vue-users E2E | 14 passed |
+| **Total E2E** | **220/225 passed** |
+
+\* vue-media failure is pre-existing: `data-testid="utc-timestamp"` missing from Recorded.vue component
+
+## Security Review
+
+No HIGH severity findings. Notable MEDIUM finding: example app renders full JSON including `adminCredentials` include parameter — acceptable for demo code. All other findings are LOW severity with existing mitigations (Vue auto-escaping, `encodeURIComponent`, `rel="noopener noreferrer"`).
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+#### PR #91: feat: E2E runner script, release summary fix, agent updates
+## Summary
+
+- **feat:** Add `scripts/run-examples-e2e.sh` that dynamically discovers all example apps and runs Playwright E2E tests sequentially with port 3333 cleanup between runs
+- **fix:** Fix npm-publish workflow race condition where Release Summary was always empty — replaced `git log --merges` (which failed when checked-out develop commit didn't have production merge commits as ancestors) with `gh pr list --base production --state merged` via GitHub API
+- **fix:** Update PR-and-check skill to fetch all tags (`git fetch origin --tags`), check for in-progress release workflows before proceeding, use `npm run test:e2e:examples` script, and set 20-minute E2E timeout
+- **chore:** Update docs-accuracy-reviewer to also verify skills and agent files against actual implementations
+- **chore:** Set sonnet model for test-runner and docs-accuracy-reviewer agents
+- **fix:** Correct inaccuracies in een-auth, een-devices, een-media, een-users agent files
+
+## Version
+
+`0.3.62`
+
+## Commits
+
+- `6df59c8` chore: Set 20-minute timeout for example E2E tests in PR skill
+- `fce1f9e` feat: Add E2E runner script, fix release PR summaries, update agents
+
+## Test Results
+
+| Check | Result |
+|-------|--------|
+| Lint | Passed |
+| Unit Tests | 600 passed (22 files) |
+| Build | Passed |
+| vue-alerts-metrics E2E | 20 passed |
+| vue-automations E2E | 24 passed |
+| vue-bridges E2E | 18 passed |
+| vue-cameras E2E | 41 passed |
+| vue-event-subscriptions E2E | 15 passed |
+| vue-events E2E | 16 passed |
+| vue-feeds E2E | 12 passed |
+| vue-jobs E2E | 34 passed |
+| vue-layouts E2E | 14 passed |
+| vue-media E2E | 20 passed |
+| vue-users E2E | 14 passed (passed on retry, transient OAuth callback timeout) |
+| **Total E2E** | **228 passed across 11 apps** |
+
+## Security Review
+
+No security concerns. Changes are limited to:
+- Shell script for test orchestration (no user input, runs locally)
+- GitHub Actions workflow fix (uses `gh` CLI with existing `GH_TOKEN`)
+- Documentation/agent file corrections (markdown only)
+- No new dependencies, no API changes, no auth flow changes
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
 
 ### Detailed Changes
 
 #### Features
-- feat: Update event type to data schema mappings from API v3.0 spec
+- feat: Add E2E runner script, fix release PR summaries, update agents
+
+#### Bug Fixes
+- fix: Address code review feedback for PR #91
+
+#### Other Changes
+- chore: Set 20-minute timeout for example E2E tests in PR skill
 
 ### Links
 - [npm package](https://www.npmjs.com/package/een-api-toolkit)
-- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.54...v0.3.55)
+- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.60...v0.3.63)
 
 ---
-*Released: 2026-02-03 21:02:16 CST*
+*Released: 2026-02-07 14:18:39 CST*