@epilot/sdk 2.7.0 → 2.8.0-rc.0

package/dist/focus-pocus-JGXH42OF.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-NJK5F5TF.cjs');
+
+// src/docs/focus-pocus.json
+var focus_pocus_default = '# Focus Pocus API\n\n- **Base URL:** `https://focus-pocus.dev.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/focus-pocus](https://docs.epilot.io/api/focus-pocus)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.focusPocus.getHealth(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/focus-pocus\'\n\nconst focusPocusClient = getClient()\nauthorize(focusPocusClient, () => \'<token>\')\nconst { data } = await focusPocusClient.getHealth(...)\n```\n\n## Operations\n\n**Health**\n- [`getHealth`](#gethealth)\n\n**Achievements**\n- [`listAchievements`](#listachievements)\n- [`getAchievement`](#getachievement)\n\n**Challenges**\n- [`getSuggestedChallenge`](#getsuggestedchallenge)\n- [`acceptChallenge`](#acceptchallenge)\n- [`dismissChallenge`](#dismisschallenge)\n- [`listActiveChallenges`](#listactivechallenges)\n\n**Events**\n- [`postEvent`](#postevent)\n\n**Schemas**\n- [`HealthResponse`](#healthresponse)\n- [`ErrorResponse`](#errorresponse)\n- [`ConflictError`](#conflicterror)\n- [`ChallengeSuggested`](#challengesuggested)\n- [`ChallengeActive`](#challengeactive)\n- [`ActiveChallengeListResponse`](#activechallengelistresponse)\n- [`AchievementFeedItem`](#achievementfeeditem)\n- [`AchievementFeedListResponse`](#achievementfeedlistresponse)\n- [`EventIngestRequest`](#eventingestrequest)\n- [`EventAccepted`](#eventaccepted)\n\n### `getHealth`\n\nLiveness probe for the Focus Pocus API. Requires a valid EpilotAuth token.\n\n`GET /v1/health`\n\n```ts\nconst { data } = await client.getHealth()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status": "ok",\n  "stage": "dev",\n  "service": "focus-pocus-api"\n}\n```\n\n</details>\n\n---\n\n### `listAchievements`\n\nUnified feed for the authenticated user: returns active challenges and completed\nv1 static achievement unlocks. The `userId` is read from the EpilotAuth claim \u2014\nno user path or query parameter is acce\n\n`GET /v1/achievements`\n\n```ts\nconst { data } = await client.listAchievements()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "id": "string",\n      "challenge_template_id": "string",\n      "category": "string",\n      "title": "string",\n      "description": "string",\n      "badge_image_url": "string",\n      "icon": "string",\n      "status": "active",\n      "accepted_at": "1970-01-01T00:00:00.000Z",\n      "deadline": "1970-01-01T00:00:00.000Z",\n      "time_remaining_ms": 0,\n      "unlocked_at": "1970-01-01T00:00:00.000Z",\n      "xp_awarded": 0,\n      "just_unlocked": true\n    }\n  ],\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n### `getAchievement`\n\nSingle user-scoped achievement or active-challenge item. Returns 404 if the id\ndoes not belong to the authenticated user.\n\n`GET /v1/achievements/{id}`\n\n```ts\nconst { data } = await client.getAchievement({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "challenge_template_id": "string",\n  "category": "string",\n  "title": "string",\n  "description": "string",\n  "badge_image_url": "string",\n  "icon": "string",\n  "status": "active",\n  "accepted_at": "1970-01-01T00:00:00.000Z",\n  "deadline": "1970-01-01T00:00:00.000Z",\n  "time_remaining_ms": 0,\n  "unlocked_at": "1970-01-01T00:00:00.000Z",\n  "xp_awarded": 0,\n  "just_unlocked": true\n}\n```\n\n</details>\n\n---\n\n### `getSuggestedChallenge`\n\nReturns a suggested challenge for the authenticated user. The suggestion is\npersisted with a 7-day TTL. Calling again with the same `(user, category)`\nwithin 24h returns the existing suggestion withou\n\n`GET /v1/challenges/suggest`\n\n```ts\nconst { data } = await client.getSuggestedChallenge({\n  route: \'example\',\n  entity_type: \'example\',\n  category_hint: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "challenge_template_id": "string",\n  "category": "string",\n  "title": "string",\n  "description": "string",\n  "badge_image_url": "string",\n  "default_duration_hours": 1,\n  "status": "suggested",\n  "suggested_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `acceptChallenge`\n\nAccept a suggested challenge. Atomically transitions the challenge from\n`suggested` to `active` using a conditional DynamoDB UpdateItem. Returns 409 if\nthe challenge has already been transitioned or t\n\n`POST /v1/challenges/{id}/accept`\n\n```ts\nconst { data } = await client.acceptChallenge({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "challenge_template_id": "string",\n  "category": "string",\n  "title": "string",\n  "description": "string",\n  "badge_image_url": "string",\n  "status": "active",\n  "accepted_at": "1970-01-01T00:00:00.000Z",\n  "deadline": "1970-01-01T00:00:00.000Z",\n  "time_remaining_ms": 0\n}\n```\n\n</details>\n\n---\n\n### `dismissChallenge`\n\nDismiss a suggested challenge. Atomically transitions the challenge from\n`suggested` to `dismissed`. The challenge template is filtered from `/suggest`\nresponses for the next 24h. Returns 409 if the c\n\n`POST /v1/challenges/{id}/dismiss`\n\n```ts\nconst { data } = await client.dismissChallenge({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `listActiveChallenges`\n\nReturns all active challenges for the authenticated user. Challenges whose\ndeadline has passed are lazily expired (fire-and-forget UpdateItem) and\nexcluded from the response. The result set is bounded\n\n`GET /v1/challenges/active`\n\n```ts\nconst { data } = await client.listActiveChallenges()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "id": "string",\n      "challenge_template_id": "string",\n      "category": "string",\n      "title": "string",\n      "description": "string",\n      "badge_image_url": "string",\n      "status": "active",\n      "accepted_at": "1970-01-01T00:00:00.000Z",\n      "deadline": "1970-01-01T00:00:00.000Z",\n      "time_remaining_ms": 0\n    }\n  ],\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n### `postEvent`\n\nPersist-first event ingest. Accepts an activity event, writes it to the event log\nidempotently (keyed by `event_id`), and returns 202. Achievement evaluation happens\nasynchronously \u2014 no unlocks are re\n\n`POST /v1/events`\n\n```ts\nconst { data } = await client.postEvent(\n  null,\n  {\n    event_id: \'string\',\n    event_type: \'string\',\n    actor_user_id: \'string\',\n    occurred_at: \'1970-01-01T00:00:00.000Z\',\n    properties: {}\n  },\n)\n```\n\n---\n\n## Schemas\n\n### `HealthResponse`\n\n```ts\ntype HealthResponse = {\n  status: "ok"\n  stage: string\n  service: string\n}\n```\n\n### `ErrorResponse`\n\n```ts\ntype ErrorResponse = {\n  status: number\n  error: string\n}\n```\n\n### `ConflictError`\n\n```ts\ntype ConflictError = {\n  status: 409\n  error: string\n  reason: "already_transitioned" | "too_many_active" | "deadline_passed"\n}\n```\n\n### `ChallengeSuggested`\n\n```ts\ntype ChallengeSuggested = {\n  id: string\n  challenge_template_id: string\n  category: string\n  title: string\n  description: string\n  badge_image_url: string\n  default_duration_hours: number\n  status: "suggested"\n  suggested_at: string // date-time\n}\n```\n\n### `ChallengeActive`\n\n```ts\ntype ChallengeActive = {\n  id: string\n  challenge_template_id: string\n  category: string\n  title: string\n  description: string\n  badge_image_url: string\n  status: "active"\n  accepted_at: string // date-time\n  deadline: string // date-time\n  time_remaining_ms: number\n}\n```\n\n### `ActiveChallengeListResponse`\n\n```ts\ntype ActiveChallengeListResponse = {\n  results: Array<{\n    id: string\n    challenge_template_id: string\n    category: string\n    title: string\n    description: string\n    badge_image_url: string\n    status: "active"\n    accepted_at: string // date-time\n    deadline: string // date-time\n    time_remaining_ms: number\n  }>\n  total: number\n}\n```\n\n### `AchievementFeedItem`\n\n```ts\ntype AchievementFeedItem = {\n  id: string\n  challenge_template_id?: string\n  category: string\n  title: string\n  description: string\n  badge_image_url?: string\n  icon?: string\n  status: "active" | "completed" | "expired"\n  accepted_at?: string // date-time\n  deadline?: string // date-time\n  time_remaining_ms?: number\n  unlocked_at?: string // date-time\n  xp_awarded?: number\n  just_unlocked: boolean\n}\n```\n\n### `AchievementFeedListResponse`\n\n```ts\ntype AchievementFeedListResponse = {\n  results: Array<{\n    id: string\n    challenge_template_id?: string\n    category: string\n    title: string\n    description: string\n    badge_image_url?: string\n    icon?: string\n    status: "active" | "completed" | "expired"\n    accepted_at?: string // date-time\n    deadline?: string // date-time\n    time_remaining_ms?: number\n    unlocked_at?: string // date-time\n    xp_awarded?: number\n    just_unlocked: boolean\n  }>\n  total: number\n}\n```\n\n### `EventIngestRequest`\n\n```ts\ntype EventIngestRequest = {\n  event_id: string\n  event_type: string\n  actor_user_id: string\n  occurred_at: string // date-time\n  properties?: Record<string, unknown>\n}\n```\n\n### `EventAccepted`\n\n```ts\ntype EventAccepted = {\n  accepted: true\n}\n```\n';
+
+
+exports.default = focus_pocus_default;

package/dist/focus-pocus-XVDVUYL6.js

@@ -0,0 +1,7 @@
+import "./chunk-YPSWSI3M.js";
+
+// src/docs/focus-pocus.json
+var focus_pocus_default = '# Focus Pocus API\n\n- **Base URL:** `https://focus-pocus.dev.sls.epilot.io`\n- **Full API Docs:** [https://docs.epilot.io/api/focus-pocus](https://docs.epilot.io/api/focus-pocus)\n\n## Usage\n\n```ts\nimport { epilot } from \'@epilot/sdk\'\n\nepilot.authorize(() => \'<token>\')\nconst { data } = await epilot.focusPocus.getHealth(...)\n```\n\n### Tree-shakeable import\n\n```ts\nimport { getClient, authorize } from \'@epilot/sdk/focus-pocus\'\n\nconst focusPocusClient = getClient()\nauthorize(focusPocusClient, () => \'<token>\')\nconst { data } = await focusPocusClient.getHealth(...)\n```\n\n## Operations\n\n**Health**\n- [`getHealth`](#gethealth)\n\n**Achievements**\n- [`listAchievements`](#listachievements)\n- [`getAchievement`](#getachievement)\n\n**Challenges**\n- [`getSuggestedChallenge`](#getsuggestedchallenge)\n- [`acceptChallenge`](#acceptchallenge)\n- [`dismissChallenge`](#dismisschallenge)\n- [`listActiveChallenges`](#listactivechallenges)\n\n**Events**\n- [`postEvent`](#postevent)\n\n**Schemas**\n- [`HealthResponse`](#healthresponse)\n- [`ErrorResponse`](#errorresponse)\n- [`ConflictError`](#conflicterror)\n- [`ChallengeSuggested`](#challengesuggested)\n- [`ChallengeActive`](#challengeactive)\n- [`ActiveChallengeListResponse`](#activechallengelistresponse)\n- [`AchievementFeedItem`](#achievementfeeditem)\n- [`AchievementFeedListResponse`](#achievementfeedlistresponse)\n- [`EventIngestRequest`](#eventingestrequest)\n- [`EventAccepted`](#eventaccepted)\n\n### `getHealth`\n\nLiveness probe for the Focus Pocus API. Requires a valid EpilotAuth token.\n\n`GET /v1/health`\n\n```ts\nconst { data } = await client.getHealth()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "status": "ok",\n  "stage": "dev",\n  "service": "focus-pocus-api"\n}\n```\n\n</details>\n\n---\n\n### `listAchievements`\n\nUnified feed for the authenticated user: returns active challenges and completed\nv1 static achievement unlocks. The `userId` is read from the EpilotAuth claim \u2014\nno user path or query parameter is acce\n\n`GET /v1/achievements`\n\n```ts\nconst { data } = await client.listAchievements()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "id": "string",\n      "challenge_template_id": "string",\n      "category": "string",\n      "title": "string",\n      "description": "string",\n      "badge_image_url": "string",\n      "icon": "string",\n      "status": "active",\n      "accepted_at": "1970-01-01T00:00:00.000Z",\n      "deadline": "1970-01-01T00:00:00.000Z",\n      "time_remaining_ms": 0,\n      "unlocked_at": "1970-01-01T00:00:00.000Z",\n      "xp_awarded": 0,\n      "just_unlocked": true\n    }\n  ],\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n### `getAchievement`\n\nSingle user-scoped achievement or active-challenge item. Returns 404 if the id\ndoes not belong to the authenticated user.\n\n`GET /v1/achievements/{id}`\n\n```ts\nconst { data } = await client.getAchievement({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "challenge_template_id": "string",\n  "category": "string",\n  "title": "string",\n  "description": "string",\n  "badge_image_url": "string",\n  "icon": "string",\n  "status": "active",\n  "accepted_at": "1970-01-01T00:00:00.000Z",\n  "deadline": "1970-01-01T00:00:00.000Z",\n  "time_remaining_ms": 0,\n  "unlocked_at": "1970-01-01T00:00:00.000Z",\n  "xp_awarded": 0,\n  "just_unlocked": true\n}\n```\n\n</details>\n\n---\n\n### `getSuggestedChallenge`\n\nReturns a suggested challenge for the authenticated user. The suggestion is\npersisted with a 7-day TTL. Calling again with the same `(user, category)`\nwithin 24h returns the existing suggestion withou\n\n`GET /v1/challenges/suggest`\n\n```ts\nconst { data } = await client.getSuggestedChallenge({\n  route: \'example\',\n  entity_type: \'example\',\n  category_hint: \'example\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "challenge_template_id": "string",\n  "category": "string",\n  "title": "string",\n  "description": "string",\n  "badge_image_url": "string",\n  "default_duration_hours": 1,\n  "status": "suggested",\n  "suggested_at": "1970-01-01T00:00:00.000Z"\n}\n```\n\n</details>\n\n---\n\n### `acceptChallenge`\n\nAccept a suggested challenge. Atomically transitions the challenge from\n`suggested` to `active` using a conditional DynamoDB UpdateItem. Returns 409 if\nthe challenge has already been transitioned or t\n\n`POST /v1/challenges/{id}/accept`\n\n```ts\nconst { data } = await client.acceptChallenge({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "id": "string",\n  "challenge_template_id": "string",\n  "category": "string",\n  "title": "string",\n  "description": "string",\n  "badge_image_url": "string",\n  "status": "active",\n  "accepted_at": "1970-01-01T00:00:00.000Z",\n  "deadline": "1970-01-01T00:00:00.000Z",\n  "time_remaining_ms": 0\n}\n```\n\n</details>\n\n---\n\n### `dismissChallenge`\n\nDismiss a suggested challenge. Atomically transitions the challenge from\n`suggested` to `dismissed`. The challenge template is filtered from `/suggest`\nresponses for the next 24h. Returns 409 if the c\n\n`POST /v1/challenges/{id}/dismiss`\n\n```ts\nconst { data } = await client.dismissChallenge({\n  id: \'123e4567-e89b-12d3-a456-426614174000\',\n})\n```\n\n---\n\n### `listActiveChallenges`\n\nReturns all active challenges for the authenticated user. Challenges whose\ndeadline has passed are lazily expired (fire-and-forget UpdateItem) and\nexcluded from the response. The result set is bounded\n\n`GET /v1/challenges/active`\n\n```ts\nconst { data } = await client.listActiveChallenges()\n```\n\n<details>\n<summary>Response</summary>\n\n```json\n{\n  "results": [\n    {\n      "id": "string",\n      "challenge_template_id": "string",\n      "category": "string",\n      "title": "string",\n      "description": "string",\n      "badge_image_url": "string",\n      "status": "active",\n      "accepted_at": "1970-01-01T00:00:00.000Z",\n      "deadline": "1970-01-01T00:00:00.000Z",\n      "time_remaining_ms": 0\n    }\n  ],\n  "total": 0\n}\n```\n\n</details>\n\n---\n\n### `postEvent`\n\nPersist-first event ingest. Accepts an activity event, writes it to the event log\nidempotently (keyed by `event_id`), and returns 202. Achievement evaluation happens\nasynchronously \u2014 no unlocks are re\n\n`POST /v1/events`\n\n```ts\nconst { data } = await client.postEvent(\n  null,\n  {\n    event_id: \'string\',\n    event_type: \'string\',\n    actor_user_id: \'string\',\n    occurred_at: \'1970-01-01T00:00:00.000Z\',\n    properties: {}\n  },\n)\n```\n\n---\n\n## Schemas\n\n### `HealthResponse`\n\n```ts\ntype HealthResponse = {\n  status: "ok"\n  stage: string\n  service: string\n}\n```\n\n### `ErrorResponse`\n\n```ts\ntype ErrorResponse = {\n  status: number\n  error: string\n}\n```\n\n### `ConflictError`\n\n```ts\ntype ConflictError = {\n  status: 409\n  error: string\n  reason: "already_transitioned" | "too_many_active" | "deadline_passed"\n}\n```\n\n### `ChallengeSuggested`\n\n```ts\ntype ChallengeSuggested = {\n  id: string\n  challenge_template_id: string\n  category: string\n  title: string\n  description: string\n  badge_image_url: string\n  default_duration_hours: number\n  status: "suggested"\n  suggested_at: string // date-time\n}\n```\n\n### `ChallengeActive`\n\n```ts\ntype ChallengeActive = {\n  id: string\n  challenge_template_id: string\n  category: string\n  title: string\n  description: string\n  badge_image_url: string\n  status: "active"\n  accepted_at: string // date-time\n  deadline: string // date-time\n  time_remaining_ms: number\n}\n```\n\n### `ActiveChallengeListResponse`\n\n```ts\ntype ActiveChallengeListResponse = {\n  results: Array<{\n    id: string\n    challenge_template_id: string\n    category: string\n    title: string\n    description: string\n    badge_image_url: string\n    status: "active"\n    accepted_at: string // date-time\n    deadline: string // date-time\n    time_remaining_ms: number\n  }>\n  total: number\n}\n```\n\n### `AchievementFeedItem`\n\n```ts\ntype AchievementFeedItem = {\n  id: string\n  challenge_template_id?: string\n  category: string\n  title: string\n  description: string\n  badge_image_url?: string\n  icon?: string\n  status: "active" | "completed" | "expired"\n  accepted_at?: string // date-time\n  deadline?: string // date-time\n  time_remaining_ms?: number\n  unlocked_at?: string // date-time\n  xp_awarded?: number\n  just_unlocked: boolean\n}\n```\n\n### `AchievementFeedListResponse`\n\n```ts\ntype AchievementFeedListResponse = {\n  results: Array<{\n    id: string\n    challenge_template_id?: string\n    category: string\n    title: string\n    description: string\n    badge_image_url?: string\n    icon?: string\n    status: "active" | "completed" | "expired"\n    accepted_at?: string // date-time\n    deadline?: string // date-time\n    time_remaining_ms?: number\n    unlocked_at?: string // date-time\n    xp_awarded?: number\n    just_unlocked: boolean\n  }>\n  total: number\n}\n```\n\n### `EventIngestRequest`\n\n```ts\ntype EventIngestRequest = {\n  event_id: string\n  event_type: string\n  actor_user_id: string\n  occurred_at: string // date-time\n  properties?: Record<string, unknown>\n}\n```\n\n### `EventAccepted`\n\n```ts\ntype EventAccepted = {\n  accepted: true\n}\n```\n';
+export {
+  focus_pocus_default as default
+};

package/dist/focus-pocus-runtime-QXBBYVX7.js

@@ -0,0 +1,5 @@
+import {
+  require_focus_pocus_runtime
+} from "./chunk-P42Q6HOW.js";
+import "./chunk-YPSWSI3M.js";
+export default require_focus_pocus_runtime();

package/dist/focus-pocus-runtime-X6GQ3WI4.cjs

@@ -0,0 +1,5 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkA6FYGWQ7cjs = require('./chunk-A6FYGWQ7.cjs');
+require('./chunk-NJK5F5TF.cjs');
+exports. default = _chunkA6FYGWQ7cjs.require_focus_pocus_runtime.call(void 0, );

package/dist/focus-pocus.d-BRFGe53G.d.cts

@@ -0,0 +1,489 @@
+import { OpenAPIClient, Parameters, UnknownParamsObject, AxiosRequestConfig, OperationResponse } from 'openapi-client-axios';
+
+/* Auto-copied from focus-pocus-client */
+
+
+declare namespace Components {
+    namespace Parameters {
+        export type AchievementId = string; // ^[a-z0-9][a-z0-9_-]{0,127}$
+        export type AchievementOrChallengeId = string;
+        export type ChallengeId = string;
+        export type Cursor = string;
+        export type Size = number;
+    }
+    export interface PathParameters {
+        AchievementId?: Parameters.AchievementId /* ^[a-z0-9][a-z0-9_-]{0,127}$ */;
+        AchievementOrChallengeId?: Parameters.AchievementOrChallengeId;
+        ChallengeId?: Parameters.ChallengeId;
+    }
+    export interface QueryParameters {
+        Cursor?: Parameters.Cursor;
+        Size?: Parameters.Size;
+    }
+    namespace Responses {
+        export type BadRequest = Schemas.ErrorResponse;
+        export type Conflict = Schemas.ConflictError;
+        export type NotFound = Schemas.ErrorResponse;
+        export type Unauthorized = Schemas.ErrorResponse;
+    }
+    namespace Schemas {
+        export interface AchievementFeedItem {
+            id: string;
+            /**
+             * Set for challenge-based items; null for v1 static catalog unlocks.
+             */
+            challenge_template_id?: string | null;
+            category: string;
+            title: string;
+            description: string;
+            badge_image_url?: string | null;
+            /**
+             * Kept for v1 catalog unlock compatibility.
+             */
+            icon?: string | null;
+            status: "active" | "completed" | "expired";
+            accepted_at?: string | null; // date-time
+            deadline?: string | null; // date-time
+            /**
+             * Milliseconds remaining until the deadline; null for non-active items.
+             */
+            time_remaining_ms?: number | null;
+            /**
+             * When the achievement was unlocked; null for active challenges.
+             */
+            unlocked_at?: string | null; // date-time
+            /**
+             * XP awarded on unlock; null for active challenges.
+             */
+            xp_awarded?: number | null;
+            /**
+             * True if the item was completed within the last 60 seconds.
+             */
+            just_unlocked: boolean;
+        }
+        export interface AchievementFeedListResponse {
+            results: AchievementFeedItem[];
+            total: number;
+        }
+        export interface ActiveChallengeListResponse {
+            results: ChallengeActive[];
+            total: number;
+        }
+        export interface ChallengeActive {
+            /**
+             * Unique challenge-instance id (UUID).
+             */
+            id: string;
+            challenge_template_id: string;
+            category: string;
+            title: string;
+            description: string;
+            badge_image_url: string;
+            status: "active";
+            accepted_at: string; // date-time
+            deadline: string; // date-time
+            /**
+             * Milliseconds remaining until the deadline (clamped to >= 0).
+             */
+            time_remaining_ms: number;
+        }
+        export interface ChallengeSuggested {
+            /**
+             * Unique suggestion-instance id (UUID).
+             */
+            id: string;
+            /**
+             * FK to the challenge template.
+             */
+            challenge_template_id: string;
+            /**
+             * Open string category propagated from the template.
+             */
+            category: string;
+            title: string;
+            description: string;
+            badge_image_url: string;
+            /**
+             * How many hours the user has to complete the challenge once accepted.
+             */
+            default_duration_hours: number;
+            status: "suggested";
+            suggested_at: string; // date-time
+        }
+        export interface ConflictError {
+            status: 409;
+            error: string;
+            reason: "already_transitioned" | "too_many_active" | "deadline_passed";
+        }
+        export interface ErrorResponse {
+            status: number; // int32
+            error: string;
+        }
+        export interface EventAccepted {
+            accepted: true;
+        }
+        export interface EventIngestRequest {
+            /**
+             * Idempotency key — same id is rejected (already-accepted) on retry.
+             */
+            event_id: string;
+            event_type: string;
+            actor_user_id: string;
+            occurred_at: string; // date-time
+            properties?: {
+                [name: string]: any;
+            };
+        }
+        export interface HealthResponse {
+            status: "ok";
+            /**
+             * example:
+             * dev
+             */
+            stage: string;
+            /**
+             * example:
+             * focus-pocus-api
+             */
+            service: string;
+        }
+    }
+}
+declare namespace Paths {
+    namespace AcceptChallenge {
+        namespace Parameters {
+            export type Id = string;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ChallengeActive;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+            export type $409 = Components.Responses.Conflict;
+        }
+    }
+    namespace DismissChallenge {
+        namespace Parameters {
+            export type Id = string;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export interface $204 {
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+            export type $409 = Components.Responses.Conflict;
+        }
+    }
+    namespace GetAchievement {
+        namespace Parameters {
+            export type Id = string;
+        }
+        export interface PathParameters {
+            id: Parameters.Id;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.AchievementFeedItem;
+            export type $401 = Components.Responses.Unauthorized;
+            export type $404 = Components.Responses.NotFound;
+        }
+    }
+    namespace GetHealth {
+        namespace Responses {
+            export type $200 = Components.Schemas.HealthResponse;
+            export type $401 = Components.Responses.Unauthorized;
+        }
+    }
+    namespace GetSuggestedChallenge {
+        namespace Parameters {
+            export type CategoryHint = string;
+            export type EntityType = string;
+            export type Route = string;
+        }
+        export interface QueryParameters {
+            route?: Parameters.Route;
+            entity_type?: Parameters.EntityType;
+            category_hint?: Parameters.CategoryHint;
+        }
+        namespace Responses {
+            export type $200 = Components.Schemas.ChallengeSuggested;
+            export interface $204 {
+            }
+            export type $401 = Components.Responses.Unauthorized;
+            export type $500 = Components.Schemas.ErrorResponse;
+        }
+    }
+    namespace ListAchievements {
+        namespace Responses {
+            export type $200 = Components.Schemas.AchievementFeedListResponse;
+            export type $401 = Components.Responses.Unauthorized;
+        }
+    }
+    namespace ListActiveChallenges {
+        namespace Responses {
+            export type $200 = Components.Schemas.ActiveChallengeListResponse;
+            export type $401 = Components.Responses.Unauthorized;
+        }
+    }
+    namespace PostEvent {
+        export type RequestBody = Components.Schemas.EventIngestRequest;
+        namespace Responses {
+            export type $202 = Components.Schemas.EventAccepted;
+            export type $400 = Components.Responses.BadRequest;
+            export type $401 = Components.Responses.Unauthorized;
+        }
+    }
+}
+
+
+interface OperationMethods {
+  /**
+   * getHealth - getHealth
+   * 
+   * Liveness probe for the Focus Pocus API. Requires a valid EpilotAuth token.
+   */
+  'getHealth'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetHealth.Responses.$200>
+  /**
+   * listAchievements - listAchievements
+   * 
+   * Unified feed for the authenticated user: returns active challenges and completed
+   * v1 static achievement unlocks. The `userId` is read from the EpilotAuth claim —
+   * no user path or query parameter is accepted. Active challenges appear first,
+   * followed by completed items sorted by `unlocked_at` descending.
+   * Items unlocked within the last 60 seconds have `just_unlocked: true`.
+   * 
+   */
+  'listAchievements'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListAchievements.Responses.$200>
+  /**
+   * getAchievement - getAchievement
+   * 
+   * Single user-scoped achievement or active-challenge item. Returns 404 if the id
+   * does not belong to the authenticated user.
+   * 
+   */
+  'getAchievement'(
+    parameters?: Parameters<Paths.GetAchievement.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetAchievement.Responses.$200>
+  /**
+   * getSuggestedChallenge - getSuggestedChallenge
+   * 
+   * Returns a suggested challenge for the authenticated user. The suggestion is
+   * persisted with a 7-day TTL. Calling again with the same `(user, category)`
+   * within 24h returns the existing suggestion without creating a new row.
+   * Returns 204 when all candidate templates have been dismissed within the last 24h.
+   * 
+   */
+  'getSuggestedChallenge'(
+    parameters?: Parameters<Paths.GetSuggestedChallenge.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.GetSuggestedChallenge.Responses.$200 | Paths.GetSuggestedChallenge.Responses.$204>
+  /**
+   * acceptChallenge - acceptChallenge
+   * 
+   * Accept a suggested challenge. Atomically transitions the challenge from
+   * `suggested` to `active` using a conditional DynamoDB UpdateItem. Returns 409 if
+   * the challenge has already been transitioned or the user already has
+   * MAX_ACTIVE_CHALLENGES (3) active challenges.
+   * 
+   */
+  'acceptChallenge'(
+    parameters?: Parameters<Paths.AcceptChallenge.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.AcceptChallenge.Responses.$200>
+  /**
+   * dismissChallenge - dismissChallenge
+   * 
+   * Dismiss a suggested challenge. Atomically transitions the challenge from
+   * `suggested` to `dismissed`. The challenge template is filtered from `/suggest`
+   * responses for the next 24h. Returns 409 if the challenge has already been
+   * transitioned (e.g. already accepted or dismissed).
+   * 
+   */
+  'dismissChallenge'(
+    parameters?: Parameters<Paths.DismissChallenge.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.DismissChallenge.Responses.$204>
+  /**
+   * listActiveChallenges - listActiveChallenges
+   * 
+   * Returns all active challenges for the authenticated user. Challenges whose
+   * deadline has passed are lazily expired (fire-and-forget UpdateItem) and
+   * excluded from the response. The result set is bounded by MAX_ACTIVE_CHALLENGES=3.
+   * 
+   */
+  'listActiveChallenges'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.ListActiveChallenges.Responses.$200>
+  /**
+   * postEvent - postEvent
+   * 
+   * Persist-first event ingest. Accepts an activity event, writes it to the event log
+   * idempotently (keyed by `event_id`), and returns 202. Achievement evaluation happens
+   * asynchronously — no unlocks are returned in the response.
+   * 
+   */
+  'postEvent'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.PostEvent.RequestBody,
+    config?: AxiosRequestConfig  
+  ): OperationResponse<Paths.PostEvent.Responses.$202>
+}
+
+interface PathsDictionary {
+  ['/v1/health']: {
+    /**
+     * getHealth - getHealth
+     * 
+     * Liveness probe for the Focus Pocus API. Requires a valid EpilotAuth token.
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetHealth.Responses.$200>
+  }
+  ['/v1/achievements']: {
+    /**
+     * listAchievements - listAchievements
+     * 
+     * Unified feed for the authenticated user: returns active challenges and completed
+     * v1 static achievement unlocks. The `userId` is read from the EpilotAuth claim —
+     * no user path or query parameter is accepted. Active challenges appear first,
+     * followed by completed items sorted by `unlocked_at` descending.
+     * Items unlocked within the last 60 seconds have `just_unlocked: true`.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListAchievements.Responses.$200>
+  }
+  ['/v1/achievements/{id}']: {
+    /**
+     * getAchievement - getAchievement
+     * 
+     * Single user-scoped achievement or active-challenge item. Returns 404 if the id
+     * does not belong to the authenticated user.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetAchievement.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetAchievement.Responses.$200>
+  }
+  ['/v1/challenges/suggest']: {
+    /**
+     * getSuggestedChallenge - getSuggestedChallenge
+     * 
+     * Returns a suggested challenge for the authenticated user. The suggestion is
+     * persisted with a 7-day TTL. Calling again with the same `(user, category)`
+     * within 24h returns the existing suggestion without creating a new row.
+     * Returns 204 when all candidate templates have been dismissed within the last 24h.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetSuggestedChallenge.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.GetSuggestedChallenge.Responses.$200 | Paths.GetSuggestedChallenge.Responses.$204>
+  }
+  ['/v1/challenges/{id}/accept']: {
+    /**
+     * acceptChallenge - acceptChallenge
+     * 
+     * Accept a suggested challenge. Atomically transitions the challenge from
+     * `suggested` to `active` using a conditional DynamoDB UpdateItem. Returns 409 if
+     * the challenge has already been transitioned or the user already has
+     * MAX_ACTIVE_CHALLENGES (3) active challenges.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.AcceptChallenge.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.AcceptChallenge.Responses.$200>
+  }
+  ['/v1/challenges/{id}/dismiss']: {
+    /**
+     * dismissChallenge - dismissChallenge
+     * 
+     * Dismiss a suggested challenge. Atomically transitions the challenge from
+     * `suggested` to `dismissed`. The challenge template is filtered from `/suggest`
+     * responses for the next 24h. Returns 409 if the challenge has already been
+     * transitioned (e.g. already accepted or dismissed).
+     * 
+     */
+    'post'(
+      parameters?: Parameters<Paths.DismissChallenge.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.DismissChallenge.Responses.$204>
+  }
+  ['/v1/challenges/active']: {
+    /**
+     * listActiveChallenges - listActiveChallenges
+     * 
+     * Returns all active challenges for the authenticated user. Challenges whose
+     * deadline has passed are lazily expired (fire-and-forget UpdateItem) and
+     * excluded from the response. The result set is bounded by MAX_ACTIVE_CHALLENGES=3.
+     * 
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.ListActiveChallenges.Responses.$200>
+  }
+  ['/v1/events']: {
+    /**
+     * postEvent - postEvent
+     * 
+     * Persist-first event ingest. Accepts an activity event, writes it to the event log
+     * idempotently (keyed by `event_id`), and returns 202. Achievement evaluation happens
+     * asynchronously — no unlocks are returned in the response.
+     * 
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.PostEvent.RequestBody,
+      config?: AxiosRequestConfig  
+    ): OperationResponse<Paths.PostEvent.Responses.$202>
+  }
+}
+
+type Client = OpenAPIClient<OperationMethods, PathsDictionary>
+
+
+type AchievementFeedItem = Components.Schemas.AchievementFeedItem;
+type AchievementFeedListResponse = Components.Schemas.AchievementFeedListResponse;
+type ActiveChallengeListResponse = Components.Schemas.ActiveChallengeListResponse;
+type ChallengeActive = Components.Schemas.ChallengeActive;
+type ChallengeSuggested = Components.Schemas.ChallengeSuggested;
+type ConflictError = Components.Schemas.ConflictError;
+type ErrorResponse = Components.Schemas.ErrorResponse;
+type EventAccepted = Components.Schemas.EventAccepted;
+type EventIngestRequest = Components.Schemas.EventIngestRequest;
+type HealthResponse = Components.Schemas.HealthResponse;
+
+export { type AchievementFeedItem as A, type Client as C, type ErrorResponse as E, type HealthResponse as H, type OperationMethods as O, Paths as P, Components as a, type PathsDictionary as b, type AchievementFeedListResponse as c, type ActiveChallengeListResponse as d, type ChallengeActive as e, type ChallengeSuggested as f, type ConflictError as g, type EventAccepted as h, type EventIngestRequest as i };