@abyss-project/tools 1.0.5 → 1.2.0

package/src/api/board.api.ts

@@ -1,122 +1,122 @@
-import { AbyssToolsCore } from '..';
-import {
-  ICreateBoardBody,
-  ICreateBoardResponse,
-  ICreateForOrganizationBoardParams,
-  IDeleteBoardParams,
-  IDeleteBoardResponse,
-  IGetBoardParams,
-  IGetBoardResponse,
-  IGetBySlugBoardParams,
-  IGetBySlugBoardResponse,
-  IGetNextCardPreviewBoardResponse,
-  IListBoardUserResponse,
-  IPaginateBoardQuery,
-  IPaginateBoardResponse,
-  IPaginateOrganizationBoardParams,
-  IUpdateBoardBody,
-  IUpdateBoardParams,
-  IUpdateBoardResponse,
-  IListOrganizationBoardParams,
-  IListOrganizationBoardQuery,
-  ITransferContentBody,
-  ITransferBoardResponse,
-  ICountOrganizationResponse,
-} from '../types';
-
-export const getBoard = async (params: IGetBoardParams): Promise<IGetBoardResponse> => {
-  return (await AbyssToolsCore.axios.get<IGetBoardResponse>(`board/${params.boardId}`)).data;
-};
-
-export const getBySlugBoard = async (
-  params: IGetBySlugBoardParams,
-): Promise<IGetBySlugBoardResponse> => {
-  return (await AbyssToolsCore.axios.get<IGetBySlugBoardResponse>(`board/slug/${params.slug}`)).data;
-};
-
-export const deleteBoard = async (params: IDeleteBoardParams): Promise<IDeleteBoardResponse> => {
-  return (await AbyssToolsCore.axios.delete<IDeleteBoardResponse>(`board/${params.boardId}`)).data;
-};
-
-export const updateBoard = async (
-  params: IUpdateBoardParams,
-  body: IUpdateBoardBody,
-): Promise<IUpdateBoardResponse> => {
-  return (await AbyssToolsCore.axios.put<IUpdateBoardResponse>(`board/${params.boardId}`, body)).data;
-};
-
-export const createBoard = async (body: ICreateBoardBody): Promise<ICreateBoardResponse> => {
-  return (await AbyssToolsCore.axios.post<ICreateBoardResponse>(`board`, body)).data;
-};
-
-export const createForOrganizationBoard = async (
-  params: ICreateForOrganizationBoardParams,
-  body: ICreateBoardBody,
-): Promise<ICreateBoardResponse> => {
-  return (
-    await AbyssToolsCore.axios.post<ICreateBoardResponse>(`board/organization/${params.organizationId}`, body)
-  ).data;
-};
-
-export const listBoard = async (query?: { sharedWithMe?: boolean }): Promise<IListBoardUserResponse> => {
-  return (await AbyssToolsCore.axios.get<IListBoardUserResponse>('board/list', { params: query })).data;
-};
-
-export const listBoardProject = async (params: {
-  projectId: string;
-}): Promise<IListBoardUserResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<IListBoardUserResponse>(`board/project/${params.projectId}/list`)
-  ).data;
-};
-
-export const getNextCardPreviewBoard = async (): Promise<IGetNextCardPreviewBoardResponse> => {
-  return (await AbyssToolsCore.axios.post<IGetNextCardPreviewBoardResponse>(`board/next-card-preview`))
-    .data;
-};
-
-export const listBoardOrganization = async (
-  params: IListOrganizationBoardParams,
-  query?: IListOrganizationBoardQuery,
-): Promise<IListBoardUserResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<IListBoardUserResponse>(
-      `board/organization/${params.organizationId}/list`,
-      { params: query },
-    )
-  ).data;
-};
-
-export const paginateOrganizationBoard = async (
-  params: IPaginateOrganizationBoardParams,
-  query: IPaginateBoardQuery,
-): Promise<IPaginateBoardResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<IPaginateBoardResponse>(
-      `board/organization/${params.organizationId}/paginate`,
-      { params: query },
-    )
-  ).data;
-};
-
-export const transferBoard = async (
-  params: { boardId: string },
-  body: ITransferContentBody,
-): Promise<ITransferBoardResponse> => {
-  return (
-    await AbyssToolsCore.axios.post<ITransferBoardResponse>(
-      `board/${params.boardId}/transfer`,
-      body,
-    )
-  ).data;
-};
-
-export const countOrganizationBoard = async (
-  params: { organizationId: string },
-): Promise<ICountOrganizationResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<ICountOrganizationResponse>(
-      `board/organization/${params.organizationId}/count`,
-    )
-  ).data;
-};
+import { AbyssToolsCore } from '..';
+import {
+  ICreateBoardBody,
+  ICreateBoardResponse,
+  ICreateForOrganizationBoardParams,
+  IDeleteBoardParams,
+  IDeleteBoardResponse,
+  IGetBoardParams,
+  IGetBoardResponse,
+  IGetBySlugBoardParams,
+  IGetBySlugBoardResponse,
+  IGetNextCardPreviewBoardResponse,
+  IListBoardUserResponse,
+  IPaginateBoardQuery,
+  IPaginateBoardResponse,
+  IPaginateOrganizationBoardParams,
+  IUpdateBoardBody,
+  IUpdateBoardParams,
+  IUpdateBoardResponse,
+  IListOrganizationBoardParams,
+  IListOrganizationBoardQuery,
+  ITransferContentBody,
+  ITransferBoardResponse,
+  ICountOrganizationResponse,
+} from '../types';
+
+export const getBoard = async (params: IGetBoardParams): Promise<IGetBoardResponse> => {
+  return (await AbyssToolsCore.axios.get<IGetBoardResponse>(`board/${params.boardId}`)).data;
+};
+
+export const getBySlugBoard = async (
+  params: IGetBySlugBoardParams,
+): Promise<IGetBySlugBoardResponse> => {
+  return (await AbyssToolsCore.axios.get<IGetBySlugBoardResponse>(`board/slug/${params.slug}`)).data;
+};
+
+export const deleteBoard = async (params: IDeleteBoardParams): Promise<IDeleteBoardResponse> => {
+  return (await AbyssToolsCore.axios.delete<IDeleteBoardResponse>(`board/${params.boardId}`)).data;
+};
+
+export const updateBoard = async (
+  params: IUpdateBoardParams,
+  body: IUpdateBoardBody,
+): Promise<IUpdateBoardResponse> => {
+  return (await AbyssToolsCore.axios.put<IUpdateBoardResponse>(`board/${params.boardId}`, body)).data;
+};
+
+export const createBoard = async (body: ICreateBoardBody): Promise<ICreateBoardResponse> => {
+  return (await AbyssToolsCore.axios.post<ICreateBoardResponse>(`board`, body)).data;
+};
+
+export const createForOrganizationBoard = async (
+  params: ICreateForOrganizationBoardParams,
+  body: ICreateBoardBody,
+): Promise<ICreateBoardResponse> => {
+  return (
+    await AbyssToolsCore.axios.post<ICreateBoardResponse>(`board/organization/${params.organizationId}`, body)
+  ).data;
+};
+
+export const listBoard = async (query?: { sharedWithMe?: boolean }): Promise<IListBoardUserResponse> => {
+  return (await AbyssToolsCore.axios.get<IListBoardUserResponse>('board/list', { params: query })).data;
+};
+
+export const listBoardProject = async (params: {
+  projectId: string;
+}): Promise<IListBoardUserResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IListBoardUserResponse>(`board/project/${params.projectId}/list`)
+  ).data;
+};
+
+export const getNextCardPreviewBoard = async (): Promise<IGetNextCardPreviewBoardResponse> => {
+  return (await AbyssToolsCore.axios.post<IGetNextCardPreviewBoardResponse>(`board/next-card-preview`))
+    .data;
+};
+
+export const listBoardOrganization = async (
+  params: IListOrganizationBoardParams,
+  query?: IListOrganizationBoardQuery,
+): Promise<IListBoardUserResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IListBoardUserResponse>(
+      `board/organization/${params.organizationId}/list`,
+      { params: query },
+    )
+  ).data;
+};
+
+export const paginateOrganizationBoard = async (
+  params: IPaginateOrganizationBoardParams,
+  query: IPaginateBoardQuery,
+): Promise<IPaginateBoardResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IPaginateBoardResponse>(
+      `board/organization/${params.organizationId}/paginate`,
+      { params: query },
+    )
+  ).data;
+};
+
+export const transferBoard = async (
+  params: { boardId: string },
+  body: ITransferContentBody,
+): Promise<ITransferBoardResponse> => {
+  return (
+    await AbyssToolsCore.axios.post<ITransferBoardResponse>(
+      `board/${params.boardId}/transfer`,
+      body,
+    )
+  ).data;
+};
+
+export const countOrganizationBoard = async (
+  params: { organizationId: string },
+): Promise<ICountOrganizationResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<ICountOrganizationResponse>(
+      `board/organization/${params.organizationId}/count`,
+    )
+  ).data;
+};

package/src/api/draw.api.ts

@@ -1,97 +1,97 @@
-import { AbyssToolsCore } from '..';
-import {
-  ICreateDrawBody,
-  ICreateDrawResponse,
-  ICreateForOrganizationDrawParams,
-  IDeleteDrawParams,
-  IDeleteDrawResponse,
-  IGetDrawParams,
-  IGetDrawResponse,
-  IPaginateDrawQuery,
-  IPaginateDrawResponse,
-  IPaginateProjectDrawParams,
-  IUpdateDrawBody,
-  IUpdateDrawParams,
-  IUpdateDrawResponse,
-  IPaginateOrganizationDrawParams,
-  ITransferContentBody,
-  ITransferDrawResponse,
-  ICountOrganizationResponse,
-} from '../types';
-
-export const paginateDraw = async (query: IPaginateDrawQuery): Promise<IPaginateDrawResponse> => {
-  return (await AbyssToolsCore.axios.get<IPaginateDrawResponse>(`draw/paginate`, { params: query }))
-    .data;
-};
-
-export const paginateProjectDraw = async (
-  params: IPaginateProjectDrawParams,
-  query: IPaginateDrawQuery,
-): Promise<IPaginateDrawResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<IPaginateDrawResponse>(`project/${params.projectId}/draw/paginate`, {
-      params: query,
-    })
-  ).data;
-};
-
-export const getDraw = async (params: IGetDrawParams): Promise<IGetDrawResponse> => {
-  return (await AbyssToolsCore.axios.get<IGetDrawResponse>(`draw/${params.drawId}`)).data;
-};
-
-export const deleteDraw = async (params: IDeleteDrawParams): Promise<IDeleteDrawResponse> => {
-  return (await AbyssToolsCore.axios.delete<IDeleteDrawResponse>(`draw/${params.drawId}`)).data;
-};
-
-export const updateDraw = async (
-  params: IUpdateDrawParams,
-  body: IUpdateDrawBody,
-): Promise<IUpdateDrawResponse> => {
-  return (await AbyssToolsCore.axios.put<IUpdateDrawResponse>(`draw/${params.drawId}`, body)).data;
-};
-
-export const createDraw = async (body: ICreateDrawBody): Promise<ICreateDrawResponse> => {
-  return (await AbyssToolsCore.axios.post<ICreateDrawResponse>(`draw`, body)).data;
-};
-
-export const createForOrganizationDraw = async (
-  params: ICreateForOrganizationDrawParams,
-  body: ICreateDrawBody,
-): Promise<ICreateDrawResponse> => {
-  return (await AbyssToolsCore.axios.post<ICreateDrawResponse>(`draw/organization/${params.organizationId}`, body))
-    .data;
-};
-
-export const paginateOrganizationDraw = async (
-  params: IPaginateOrganizationDrawParams,
-  query: IPaginateDrawQuery,
-): Promise<IPaginateDrawResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<IPaginateDrawResponse>(
-      `organization/${params.organizationId}/draw/paginate`,
-      { params: query },
-    )
-  ).data;
-};
-
-export const transferDraw = async (
-  params: { drawId: string },
-  body: ITransferContentBody,
-): Promise<ITransferDrawResponse> => {
-  return (
-    await AbyssToolsCore.axios.post<ITransferDrawResponse>(
-      `draw/${params.drawId}/transfer`,
-      body,
-    )
-  ).data;
-};
-
-export const countOrganizationDraw = async (
-  params: { organizationId: string },
-): Promise<ICountOrganizationResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<ICountOrganizationResponse>(
-      `draw/organization/${params.organizationId}/count`,
-    )
-  ).data;
-};
+import { AbyssToolsCore } from '..';
+import {
+  ICreateDrawBody,
+  ICreateDrawResponse,
+  ICreateForOrganizationDrawParams,
+  IDeleteDrawParams,
+  IDeleteDrawResponse,
+  IGetDrawParams,
+  IGetDrawResponse,
+  IPaginateDrawQuery,
+  IPaginateDrawResponse,
+  IPaginateProjectDrawParams,
+  IUpdateDrawBody,
+  IUpdateDrawParams,
+  IUpdateDrawResponse,
+  IPaginateOrganizationDrawParams,
+  ITransferContentBody,
+  ITransferDrawResponse,
+  ICountOrganizationResponse,
+} from '../types';
+
+export const paginateDraw = async (query: IPaginateDrawQuery): Promise<IPaginateDrawResponse> => {
+  return (await AbyssToolsCore.axios.get<IPaginateDrawResponse>(`draw/paginate`, { params: query }))
+    .data;
+};
+
+export const paginateProjectDraw = async (
+  params: IPaginateProjectDrawParams,
+  query: IPaginateDrawQuery,
+): Promise<IPaginateDrawResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IPaginateDrawResponse>(`project/${params.projectId}/draw/paginate`, {
+      params: query,
+    })
+  ).data;
+};
+
+export const getDraw = async (params: IGetDrawParams): Promise<IGetDrawResponse> => {
+  return (await AbyssToolsCore.axios.get<IGetDrawResponse>(`draw/${params.drawId}`)).data;
+};
+
+export const deleteDraw = async (params: IDeleteDrawParams): Promise<IDeleteDrawResponse> => {
+  return (await AbyssToolsCore.axios.delete<IDeleteDrawResponse>(`draw/${params.drawId}`)).data;
+};
+
+export const updateDraw = async (
+  params: IUpdateDrawParams,
+  body: IUpdateDrawBody,
+): Promise<IUpdateDrawResponse> => {
+  return (await AbyssToolsCore.axios.put<IUpdateDrawResponse>(`draw/${params.drawId}`, body)).data;
+};
+
+export const createDraw = async (body: ICreateDrawBody): Promise<ICreateDrawResponse> => {
+  return (await AbyssToolsCore.axios.post<ICreateDrawResponse>(`draw`, body)).data;
+};
+
+export const createForOrganizationDraw = async (
+  params: ICreateForOrganizationDrawParams,
+  body: ICreateDrawBody,
+): Promise<ICreateDrawResponse> => {
+  return (await AbyssToolsCore.axios.post<ICreateDrawResponse>(`draw/organization/${params.organizationId}`, body))
+    .data;
+};
+
+export const paginateOrganizationDraw = async (
+  params: IPaginateOrganizationDrawParams,
+  query: IPaginateDrawQuery,
+): Promise<IPaginateDrawResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IPaginateDrawResponse>(
+      `organization/${params.organizationId}/draw/paginate`,
+      { params: query },
+    )
+  ).data;
+};
+
+export const transferDraw = async (
+  params: { drawId: string },
+  body: ITransferContentBody,
+): Promise<ITransferDrawResponse> => {
+  return (
+    await AbyssToolsCore.axios.post<ITransferDrawResponse>(
+      `draw/${params.drawId}/transfer`,
+      body,
+    )
+  ).data;
+};
+
+export const countOrganizationDraw = async (
+  params: { organizationId: string },
+): Promise<ICountOrganizationResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<ICountOrganizationResponse>(
+      `draw/organization/${params.organizationId}/count`,
+    )
+  ).data;
+};

package/src/api/draw.public.api.ts

@@ -1,48 +1,48 @@
-import { AbyssToolsCore } from '..';
-import {
-  ICreateDrawPublicBody,
-  ICreateDrawPublicResponse,
-  IDeleteDrawPublicParams,
-  IDeleteDrawPublicResponse,
-  IGetDrawPublicParams,
-  IGetDrawPublicResponse,
-  IUpdateDrawPublicBody,
-  IUpdateDrawPublicParams,
-  IUpdateDrawPublicResponse,
-} from '../types';
-
-export const getDrawPublic = async (
-  params: IGetDrawPublicParams,
-): Promise<IGetDrawPublicResponse> => {
-  return (
-    await AbyssToolsCore.axios.get<IGetDrawPublicResponse>(`draw/public/${params.publicAccessToken}`)
-  ).data;
-};
-
-export const deleteDrawPublic = async (
-  params: IDeleteDrawPublicParams,
-): Promise<IDeleteDrawPublicResponse> => {
-  return (
-    await AbyssToolsCore.axios.delete<IDeleteDrawPublicResponse>(
-      `draw/public/${params.publicAccessToken}`,
-    )
-  ).data;
-};
-
-export const updateDrawPublic = async (
-  params: IUpdateDrawPublicParams,
-  body: IUpdateDrawPublicBody,
-): Promise<IUpdateDrawPublicResponse> => {
-  return (
-    await AbyssToolsCore.axios.put<IUpdateDrawPublicResponse>(
-      `draw/public/${params.publicAccessToken}`,
-      body,
-    )
-  ).data;
-};
-
-export const createDrawPublic = async (
-  body: ICreateDrawPublicBody,
-): Promise<ICreateDrawPublicResponse> => {
-  return (await AbyssToolsCore.axios.post<ICreateDrawPublicResponse>(`draw/public`, body)).data;
-};
+import { AbyssToolsCore } from '..';
+import {
+  ICreateDrawPublicBody,
+  ICreateDrawPublicResponse,
+  IDeleteDrawPublicParams,
+  IDeleteDrawPublicResponse,
+  IGetDrawPublicParams,
+  IGetDrawPublicResponse,
+  IUpdateDrawPublicBody,
+  IUpdateDrawPublicParams,
+  IUpdateDrawPublicResponse,
+} from '../types';
+
+export const getDrawPublic = async (
+  params: IGetDrawPublicParams,
+): Promise<IGetDrawPublicResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IGetDrawPublicResponse>(`draw/public/${params.publicAccessToken}`)
+  ).data;
+};
+
+export const deleteDrawPublic = async (
+  params: IDeleteDrawPublicParams,
+): Promise<IDeleteDrawPublicResponse> => {
+  return (
+    await AbyssToolsCore.axios.delete<IDeleteDrawPublicResponse>(
+      `draw/public/${params.publicAccessToken}`,
+    )
+  ).data;
+};
+
+export const updateDrawPublic = async (
+  params: IUpdateDrawPublicParams,
+  body: IUpdateDrawPublicBody,
+): Promise<IUpdateDrawPublicResponse> => {
+  return (
+    await AbyssToolsCore.axios.put<IUpdateDrawPublicResponse>(
+      `draw/public/${params.publicAccessToken}`,
+      body,
+    )
+  ).data;
+};
+
+export const createDrawPublic = async (
+  body: ICreateDrawPublicBody,
+): Promise<ICreateDrawPublicResponse> => {
+  return (await AbyssToolsCore.axios.post<ICreateDrawPublicResponse>(`draw/public`, body)).data;
+};

package/src/api/extraction-plan-preset.api.test.ts

@@ -0,0 +1,24 @@
+// Type-level compile test for the extraction-plan-preset api surface.
+// No jest runner in this SDK package; compile guard only.
+// Run: npx tsc --noEmit (from packages/abyss_tools_core).
+
+import * as api from './extraction-plan-preset.api';
+
+// All seven functions must be exported.
+const _listModes: typeof api.listModes = api.listModes;
+const _listPresets: typeof api.listExtractionPlanPresets = api.listExtractionPlanPresets;
+const _getPreset: typeof api.getExtractionPlanPreset = api.getExtractionPlanPreset;
+const _createPreset: typeof api.createExtractionPlanPreset = api.createExtractionPlanPreset;
+const _updatePreset: typeof api.updateExtractionPlanPreset = api.updateExtractionPlanPreset;
+const _deletePreset: typeof api.deleteExtractionPlanPreset = api.deleteExtractionPlanPreset;
+const _setDefault: typeof api.setDefaultExtractionPlanPreset = api.setDefaultExtractionPlanPreset;
+
+void _listModes;
+void _listPresets;
+void _getPreset;
+void _createPreset;
+void _updatePreset;
+void _deletePreset;
+void _setDefault;
+
+export {};

package/src/api/extraction-plan-preset.api.ts

@@ -0,0 +1,51 @@
+// ──────────────────────────────────────────────
+// Extraction Plan Preset API (V2-P1).
+//
+// GET  /extract/modes            — list registered providers + interpreters.
+// GET  /extract/plans            — list plan presets (system + scoped).
+// GET  /extract/plans/:id        — get a single preset.
+// POST /extract/plans            — create a preset.
+// PUT  /extract/plans/:id        — update a preset.
+// DELETE /extract/plans/:id      — delete a preset.
+// POST /extract/plans/:id/default — set as scope default.
+// ──────────────────────────────────────────────
+
+import { AbyssToolsCore } from '..';
+import type {
+  ICreatePlanPresetBody,
+  IUpdatePlanPresetBody,
+  IListPlanPresetQuery,
+} from '../types';
+import type {
+  IListModesResponse,
+  IListPlanPresetsResponse,
+  IGetPlanPresetResponse,
+  IDeletePlanPresetResponse,
+} from '../types';
+
+const DEFAULT_API_KEY_HEADER = 'abyss-api-key';
+
+function authHeader(apiKey?: string): Record<string, string> {
+  return apiKey ? { [DEFAULT_API_KEY_HEADER]: apiKey } : {};
+}
+
+export const listModes = async (apiKey?: string): Promise<IListModesResponse> =>
+  (await AbyssToolsCore.axios.get<IListModesResponse>(`extract/modes`, { headers: authHeader(apiKey) })).data;
+
+export const listExtractionPlanPresets = async (query: IListPlanPresetQuery = {}, apiKey?: string): Promise<IListPlanPresetsResponse> =>
+  (await AbyssToolsCore.axios.get<IListPlanPresetsResponse>(`extract/plans`, { params: query, headers: authHeader(apiKey) })).data;
+
+export const getExtractionPlanPreset = async (id: string, apiKey?: string): Promise<IGetPlanPresetResponse> =>
+  (await AbyssToolsCore.axios.get<IGetPlanPresetResponse>(`extract/plans/${id}`, { headers: authHeader(apiKey) })).data;
+
+export const createExtractionPlanPreset = async (body: ICreatePlanPresetBody, apiKey?: string): Promise<IGetPlanPresetResponse> =>
+  (await AbyssToolsCore.axios.post<IGetPlanPresetResponse>(`extract/plans`, body, { headers: authHeader(apiKey) })).data;
+
+export const updateExtractionPlanPreset = async (id: string, body: IUpdatePlanPresetBody, apiKey?: string): Promise<IGetPlanPresetResponse> =>
+  (await AbyssToolsCore.axios.put<IGetPlanPresetResponse>(`extract/plans/${id}`, body, { headers: authHeader(apiKey) })).data;
+
+export const deleteExtractionPlanPreset = async (id: string, apiKey?: string): Promise<IDeletePlanPresetResponse> =>
+  (await AbyssToolsCore.axios.delete<IDeletePlanPresetResponse>(`extract/plans/${id}`, { headers: authHeader(apiKey) })).data;
+
+export const setDefaultExtractionPlanPreset = async (id: string, apiKey?: string): Promise<IGetPlanPresetResponse> =>
+  (await AbyssToolsCore.axios.post<IGetPlanPresetResponse>(`extract/plans/${id}/default`, {}, { headers: authHeader(apiKey) })).data;

package/src/api/extraction-settings.api.ts

@@ -0,0 +1,59 @@
+// ──────────────────────────────────────────────
+// Extraction Settings API (P4 / T7) — per-scope improvement-consent defaults.
+//
+// GET  /extract/settings   — fetch effective improvementDefault for the caller's scope.
+// PUT  /extract/settings   — upsert improvementDefault for the caller's scope.
+//
+// Scope is resolved by the server from standard ?organization_id / ?project_id
+// query params (same as every other extract route).
+// ──────────────────────────────────────────────
+
+import { AbyssToolsCore } from '..';
+import type {
+  IGetExtractionSettingsQuery,
+  IUpsertExtractionSettingsBody,
+} from '../types';
+import type {
+  IGetExtractionSettingsResponse,
+  IUpsertExtractionSettingsResponse,
+} from '../types';
+
+const DEFAULT_API_KEY_HEADER = 'abyss-api-key';
+
+function authHeader(apiKey?: string): Record<string, string> {
+  return apiKey ? { [DEFAULT_API_KEY_HEADER]: apiKey } : {};
+}
+
+/**
+ * Fetch the effective improvementDefault for the caller's scope.
+ * Returns `{ data: { improvement_default: boolean } }`.
+ * Pass `query.organization_id` or `query.project_id` to select org / project scope;
+ * omit both for personal (user) scope.
+ */
+export const getExtractionSettings = async (
+  query: IGetExtractionSettingsQuery = {},
+  apiKey?: string,
+): Promise<IGetExtractionSettingsResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IGetExtractionSettingsResponse>(`extract/settings`, {
+      params: query,
+      headers: authHeader(apiKey),
+    })
+  ).data;
+};
+
+/**
+ * Upsert the improvementDefault for the caller's scope.
+ * Body: `{ improvement_default: boolean }`.
+ * Returns `{ data: { improvement_default: boolean } }` on success.
+ */
+export const upsertExtractionSettings = async (
+  body: IUpsertExtractionSettingsBody,
+  apiKey?: string,
+): Promise<IUpsertExtractionSettingsResponse> => {
+  return (
+    await AbyssToolsCore.axios.put<IUpsertExtractionSettingsResponse>(`extract/settings`, body, {
+      headers: authHeader(apiKey),
+    })
+  ).data;
+};