@abyss-project/tools 2.6.0 → 3.0.0

package/dist/types/interface/api/responses/abyss.admin.response.d.ts

@@ -15,7 +15,6 @@ export type ISyncProjectAbyssAdminResponse = IResponse<ISyncProjectAbyssAdminDat
 export type IProjectContentSummaryData = {
     draws: number;
     boards: number;
-    memos: number;
     retrospectives: number;
     shortLinks: number;
     atlas: number;

package/dist/types/interface/api/responses/extraction.response.d.ts

@@ -258,6 +258,21 @@ export interface IExtractionUsageSummary {
     byBank: Record<string, number>;
 }
 export type ISummaryUsageResponse = IResponse<IExtractionUsageSummary>;
+export interface IUsageByConfigRow {
+    planPresetId: string;
+    providerId: string | null;
+    interpreterId: string | null;
+    count: number;
+    successCount: number;
+    successRate: number;
+    avgDurationMs: number;
+    avgRecords: number;
+    ocrPagesConsumed: number;
+}
+export interface IUsageByConfig {
+    rows: IUsageByConfigRow[];
+}
+export type IUsageByConfigResponse = IResponse<IUsageByConfig>;
 export interface IListWebhookDeliveriesResponse {
     data: IExtractionWebhookDelivery[];
     total?: number;

package/dist/types/interface/api/responses/index.d.ts

@@ -13,7 +13,6 @@ export * from './board-column.response';
 export * from './board-label.response';
 export * from './draw.response';
 export * from './draw.public.response';
-export * from './memo.response';
 export * from './retrospective.response';
 export * from './retrospective.public.response';
 export * from './retrospective-card.response';

package/dist/types/interface/api/responses/index.js

@@ -29,7 +29,6 @@ __exportStar(require("./board-column.response"), exports);
 __exportStar(require("./board-label.response"), exports);
 __exportStar(require("./draw.response"), exports);
 __exportStar(require("./draw.public.response"), exports);
-__exportStar(require("./memo.response"), exports);
 __exportStar(require("./retrospective.response"), exports);
 __exportStar(require("./retrospective.public.response"), exports);
 __exportStar(require("./retrospective-card.response"), exports);

package/dist/types/interface/api/responses/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/responses/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,mDAAiC;AACjC,0DAAwC;AACxC,4DAA0C;AAC1C,yDAAuC;AACvC,wDAAsC;AACtC,mDAAiC;AACjC,wDAAsC;AACtC,kEAAgD;AAChD,gEAA8C;AAC9C,iEAA+C;AAC/C,0DAAwC;AACxC,yDAAuC;AACvC,kDAAgC;AAChC,yDAAuC;AACvC,kDAAgC;AAChC,2DAAyC;AACzC,kEAAgD;AAChD,gEAA8C;AAC9C,kEAAgD;AAChD,mEAAiD;AACjD,wDAAsC;AACtC,+DAA6C;AAC7C,8DAA4C;AAC5C,kDAAgC;AAChC,qDAAmC;AACnC,iDAA+B;AAC/B,+DAA6C;AAC7C,mDAAiC;AACjC,oDAAkC;AAClC,sDAAoC;AACpC,wDAAsC;AACtC,qDAAmC;AACnC,wDAAsC;AACtC,2DAAyC;AACzC,yDAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/types/interface/api/responses/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,mDAAiC;AACjC,0DAAwC;AACxC,4DAA0C;AAC1C,yDAAuC;AACvC,wDAAsC;AACtC,mDAAiC;AACjC,wDAAsC;AACtC,kEAAgD;AAChD,gEAA8C;AAC9C,iEAA+C;AAC/C,0DAAwC;AACxC,yDAAuC;AACvC,kDAAgC;AAChC,yDAAuC;AACvC,2DAAyC;AACzC,kEAAgD;AAChD,gEAA8C;AAC9C,kEAAgD;AAChD,mEAAiD;AACjD,wDAAsC;AACtC,+DAA6C;AAC7C,8DAA4C;AAC5C,kDAAgC;AAChC,qDAAmC;AACnC,iDAA+B;AAC/B,+DAA6C;AAC7C,mDAAiC;AACjC,oDAAkC;AAClC,sDAAoC;AACpC,wDAAsC;AACtC,qDAAmC;AACnC,wDAAsC;AACtC,2DAAyC;AACzC,yDAAuC"}

package/dist/types/interface/api/responses/metrics.response.d.ts

@@ -2,7 +2,6 @@ import { IResponse } from '../type-message/response';
 export interface IToolsMetrics {
     boardCount: number;
     drawCount: number;
-    memoCount: number;
     atlasCount: number;
     retrospectiveCount: number;
     shortLinkCount: number;

package/dist/types/interface/api/responses/transfer.response.d.ts

@@ -1,7 +1,6 @@
 import { IResponse } from '../type-message/response';
 import { IDraw } from '../../models/draw.dto';
 import { IBoard } from '../../models/board.dto';
-import { IMemo } from '../../models/memo.dto';
 import { IAtlas } from '../../models/atlas.dto';
 import { IRetrospective } from '../../models/retrospective.dto';
 import { IShortLink } from '../../models/short-link.dto';
@@ -11,9 +10,6 @@ export type ITransferDrawResponse = IResponse<{
 export type ITransferBoardResponse = IResponse<{
     board: IBoard;
 }>;
-export type ITransferMemoResponse = IResponse<{
-    memo: IMemo;
-}>;
 export type ITransferAtlasResponse = IResponse<{
     atlas: IAtlas;
 }>;

package/dist/types/interface/models/extraction-plan.dto.d.ts

@@ -1,7 +1,8 @@
 import { ProviderKind, CostTier } from '../../enum/provider-kind.enum';
 import { InterpreterKind } from '../../enum/interpreter-kind.enum';
 import { CombineStrategy } from '../../enum/combine-strategy.enum';
-export { ProviderKind, CostTier, InterpreterKind, CombineStrategy };
+import { ExtractionStepStatus } from '../../enum/extraction-step-status.enum';
+export { ProviderKind, CostTier, InterpreterKind, CombineStrategy, ExtractionStepStatus };
 export interface IModeRef {
     provider: ProviderKind;
     interpreter: InterpreterKind;
@@ -114,6 +115,34 @@ export interface IExecutionManifest {
     passes: IManifestPass[];
     createdAt: string;
 }
+export interface IStepIo {
+    slot: 'providerOutput' | 'interpreterOutput';
+    bytes: number;
+    sha256: string;
+    preview: string;
+    status: 'pending' | 'ready' | 'skipped';
+    applicationFileId: string | null;
+}
+export interface IStepTrace {
+    index: number;
+    providerId: string;
+    providerVersion: string;
+    interpreterId: string;
+    interpreterVersion: string;
+    documentType: string | null;
+    status: ExtractionStepStatus;
+    startedAtMs: number;
+    durationMs: number;
+    ocrPageCount: number;
+    fieldsContributed: number;
+    errorMessage: string | null;
+    io: IStepIo[];
+}
+export interface IExecutionTrace {
+    steps: IStepTrace[];
+    totalDurationMs: number;
+    artifactStatus: 'pending' | 'ready';
+}
 export interface IExtractionPlanPreset {
     id: string;
     name: string;

package/dist/types/interface/models/extraction-plan.dto.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CombineStrategy = exports.InterpreterKind = exports.CostTier = exports.ProviderKind = void 0;
+exports.ExtractionStepStatus = exports.CombineStrategy = exports.InterpreterKind = exports.CostTier = exports.ProviderKind = void 0;
 const provider_kind_enum_1 = require("../../enum/provider-kind.enum");
 Object.defineProperty(exports, "ProviderKind", { enumerable: true, get: function () { return provider_kind_enum_1.ProviderKind; } });
 Object.defineProperty(exports, "CostTier", { enumerable: true, get: function () { return provider_kind_enum_1.CostTier; } });
@@ -8,4 +8,6 @@ const interpreter_kind_enum_1 = require("../../enum/interpreter-kind.enum");
 Object.defineProperty(exports, "InterpreterKind", { enumerable: true, get: function () { return interpreter_kind_enum_1.InterpreterKind; } });
 const combine_strategy_enum_1 = require("../../enum/combine-strategy.enum");
 Object.defineProperty(exports, "CombineStrategy", { enumerable: true, get: function () { return combine_strategy_enum_1.CombineStrategy; } });
+const extraction_step_status_enum_1 = require("../../enum/extraction-step-status.enum");
+Object.defineProperty(exports, "ExtractionStepStatus", { enumerable: true, get: function () { return extraction_step_status_enum_1.ExtractionStepStatus; } });
 //# sourceMappingURL=extraction-plan.dto.js.map

package/dist/types/interface/models/extraction-plan.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-plan.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/extraction-plan.dto.ts"],"names":[],"mappings":";;;AAOA,sEAAuE;AAK9D,6FALA,iCAAY,OAKA;AAAE,yFALA,6BAAQ,OAKA;AAJ/B,4EAAmE;AAIlC,gGAJxB,uCAAe,OAIwB;AAHhD,4EAAmE;AAGjB,gGAHzC,uCAAe,OAGyC"}
+{"version":3,"file":"extraction-plan.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/extraction-plan.dto.ts"],"names":[],"mappings":";;;AAOA,sEAAuE;AAM9D,6FANA,iCAAY,OAMA;AAAE,yFANA,6BAAQ,OAMA;AAL/B,4EAAmE;AAKlC,gGALxB,uCAAe,OAKwB;AAJhD,4EAAmE;AAIjB,gGAJzC,uCAAe,OAIyC;AAHjE,wFAA8E;AAGX,qGAH1D,kDAAoB,OAG0D"}

package/dist/types/interface/models/extraction.dto.d.ts

@@ -2,7 +2,7 @@ import { ExtractionWarningCode } from '../../../types/enum/extraction-warning.en
 import { ExtractionFeedbackIssueType } from '../../../types/enum/extraction-feedback-issue-type.enum';
 import { DocumentType } from '../../../types/enum/document-type.enum';
 import { FileScanStatus } from '../../enum/file-scan-status.enum';
-import type { IFieldValue, IExecutionManifest, IGlobalConfidence } from './extraction-plan.dto';
+import type { IFieldValue, IExecutionManifest, IGlobalConfidence, IExecutionTrace } from './extraction-plan.dto';
 export { ExtractionFeedbackIssueType };
 export type ExtractionMode = 'auto' | 'hint' | 'template';
 export type ProcessingMode = 'sync' | 'queue';
@@ -100,6 +100,7 @@ export interface IExtraction {
     ocrPageCount: number;
     executionManifest?: IExecutionManifest | null;
     globalConfidence?: IGlobalConfidence | null;
+    executionTrace?: IExecutionTrace | null;
     createdAt: string;
 }
 export interface IExtractionTemplate {

package/dist/types/interface/models/extraction.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"extraction.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/extraction.dto.ts"],"names":[],"mappings":";;;AAKA,yFAAoF;AAwF3E,sGAxFA,+CAAqB,OAwFA;AAvF9B,iHAAsG;AAM7F,4GANA,iEAA2B,OAMA;AA+QpC,IAAY,sBAYX;AAZD,WAAY,sBAAsB;IAChC,qEAA2C,CAAA;IAC3C,+DAAqC,CAAA;IACrC,+EAAqD,CAAA;IACrD,uEAA6C,CAAA;IAC7C,6DAAmC,CAAA;IACnC,2DAAiC,CAAA;IACjC,6DAAmC,CAAA;IACnC,uEAA6C,CAAA;IAC7C,uDAA6B,CAAA;IAC7B,mEAAyC,CAAA;IACzC,6DAAmC,CAAA;AACrC,CAAC,EAZW,sBAAsB,sCAAtB,sBAAsB,QAYjC;AAEY,QAAA,yBAAyB,GACpC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAuCxC,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,4CAAa,CAAA;IACb,0CAAW,CAAA;AACb,CAAC,EAHW,2BAA2B,2CAA3B,2BAA2B,QAGtC"}
+{"version":3,"file":"extraction.dto.js","sourceRoot":"","sources":["../../../../src/types/interface/models/extraction.dto.ts"],"names":[],"mappings":";;;AAKA,yFAAoF;AA6F3E,sGA7FA,+CAAqB,OA6FA;AA5F9B,iHAAsG;AAW7F,4GAXA,iEAA2B,OAWA;AAoRpC,IAAY,sBAYX;AAZD,WAAY,sBAAsB;IAChC,qEAA2C,CAAA;IAC3C,+DAAqC,CAAA;IACrC,+EAAqD,CAAA;IACrD,uEAA6C,CAAA;IAC7C,6DAAmC,CAAA;IACnC,2DAAiC,CAAA;IACjC,6DAAmC,CAAA;IACnC,uEAA6C,CAAA;IAC7C,uDAA6B,CAAA;IAC7B,mEAAyC,CAAA;IACzC,6DAAmC,CAAA;AACrC,CAAC,EAZW,sBAAsB,sCAAtB,sBAAsB,QAYjC;AAEY,QAAA,yBAAyB,GACpC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAuCxC,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,4CAAa,CAAA;IACb,0CAAW,CAAA;AACb,CAAC,EAHW,2BAA2B,2CAA3B,2BAA2B,QAGtC"}

package/dist/types/interface/models/index.d.ts

@@ -7,7 +7,6 @@ export * from './atlas-group.dto';
 export * from './atlas-page.dto';
 export * from './atlas-page-content.dto';
 export * from './draw.dto';
-export * from './memo.dto';
 export * from './retrospective.dto';
 export * from './retrospective-section.dto';
 export * from './retrospective-card.dto';

package/dist/types/interface/models/index.js

@@ -23,7 +23,6 @@ __exportStar(require("./atlas-group.dto"), exports);
 __exportStar(require("./atlas-page.dto"), exports);
 __exportStar(require("./atlas-page-content.dto"), exports);
 __exportStar(require("./draw.dto"), exports);
-__exportStar(require("./memo.dto"), exports);
 __exportStar(require("./retrospective.dto"), exports);
 __exportStar(require("./retrospective-section.dto"), exports);
 __exportStar(require("./retrospective-card.dto"), exports);

package/dist/types/interface/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/interface/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC;AACnC,gDAA8B;AAC9B,8CAA4B;AAC5B,uDAAqC;AACrC,oDAAkC;AAClC,mDAAiC;AACjC,2DAAyC;AACzC,6CAA2B;AAC3B,6CAA2B;AAC3B,sDAAoC;AACpC,8DAA4C;AAC5C,2DAAyC;AACzC,6DAA2C;AAC3C,mDAAiC;AACjC,yDAAuC;AACvC,6CAA2B;AAC3B,8CAA4B;AAC5B,uDAAqC;AACrC,mDAAiC;AACjC,6DAA2C;AAC3C,iEAA+C;AAC/C,2DAAyC;AACzC,4DAA0C;AAC1C,yDAAuC;AACvC,0DAAwC;AACxC,qDAAmC;AACnC,oDAAkC;AAClC,6CAA2B;AAC3B,4CAA0B;AAC1B,sDAAoC;AACpC,mDAAiC;AACjC,wDAAsC;AACtC,oEAAkD;AAClD,mDAAiC;AACjC,sDAAoC;AACpC,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/interface/models/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC;AACnC,gDAA8B;AAC9B,8CAA4B;AAC5B,uDAAqC;AACrC,oDAAkC;AAClC,mDAAiC;AACjC,2DAAyC;AACzC,6CAA2B;AAC3B,sDAAoC;AACpC,8DAA4C;AAC5C,2DAAyC;AACzC,6DAA2C;AAC3C,mDAAiC;AACjC,yDAAuC;AACvC,6CAA2B;AAC3B,8CAA4B;AAC5B,uDAAqC;AACrC,mDAAiC;AACjC,6DAA2C;AAC3C,iEAA+C;AAC/C,2DAAyC;AACzC,4DAA0C;AAC1C,yDAAuC;AACvC,0DAAwC;AACxC,qDAAmC;AACnC,oDAAkC;AAClC,6CAA2B;AAC3B,4CAA0B;AAC1B,sDAAoC;AACpC,mDAAiC;AACjC,wDAAsC;AACtC,oEAAkD;AAClD,mDAAiC;AACjC,sDAAoC;AACpC,+DAA6C"}

package/dist/types/interface/models/project.dto.d.ts

@@ -1,6 +1,5 @@
 import { IAtlas } from './atlas.dto';
 import { IDraw } from './draw.dto';
-import { IMemo } from './memo.dto';
 import { IOrganization } from './organization.dto';
 import { IRetrospective } from './retrospective.dto';
 import { IShortLink } from './short-link.dto';
@@ -17,6 +16,5 @@ export interface IProject {
     draws?: IDraw[];
     retrospectives?: IRetrospective[];
     atlases?: IAtlas[];
-    memos?: IMemo[];
     shortLinks?: IShortLink[];
 }

package/dist/types/interface/models/user.dto.d.ts

@@ -2,7 +2,6 @@ import { IAtlas } from './atlas.dto';
 import { IBoard } from './board.dto';
 import { IBoardCardComment } from './board-card-comment.dto';
 import { IDraw } from './draw.dto';
-import { IMemo } from './memo.dto';
 import { IProject } from './project.dto';
 import { IRetrospective } from './retrospective.dto';
 import { IShortLink } from './short-link.dto';
@@ -18,7 +17,6 @@ export interface IUser {
     draws?: IDraw[];
     retrospectives?: IRetrospective[];
     atlases?: IAtlas[];
-    memos?: IMemo[];
     shortLinks?: IShortLink[];
     boardCardComments?: IBoardCardComment[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abyss-project/tools",
-  "version": "2.6.0",
+  "version": "3.0.0",
   "description": "Core package to interact with Abyss-Project Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/api/extraction.api.ts

@@ -18,6 +18,7 @@ import {
   IAsyncExportExtractionBody,
   IListUsageQuery,
   ISummaryUsageQuery,
+  IUsageByConfigQuery,
   IListWebhookDeliveriesQuery,
   IReplayWebhookDeliveryBody,
   IMintShareExtractionBody,
@@ -52,6 +53,7 @@ import {
   IHealthResponse,
   IStatsResponse,
   ISummaryUsageResponse,
+  IUsageByConfigResponse,
   IListWebhookDeliveriesResponse,
   IGetWebhookDeliveryResponse,
   IGetSharedExtractionResponse,
@@ -779,6 +781,39 @@ export const summaryUsage = async (
   ).data;
 };
 
+/** Per-config performance metrics (P2) — compare which config works best. */
+export const usageByConfig = async (
+  query: IUsageByConfigQuery = {},
+  apiKey?: string,
+): Promise<IUsageByConfigResponse> => {
+  return (
+    await AbyssToolsCore.axios.get<IUsageByConfigResponse>(`extract/usage/by-config`, {
+      params: serializeParams(query),
+      headers: authHeader(apiKey),
+    })
+  ).data;
+};
+
+/**
+ * Lazy fetch of ONE trace step's full IO payload (P3). Returns the raw text
+ * (gunzipped server-side). The skeleton + previews already ship on getExtraction;
+ * call this only when the user expands a step.
+ */
+export const getStepIo = async (
+  extractionId: string,
+  stepIndex: number,
+  slot: string,
+  scope: IExtractionContentScopeQuery = {},
+  apiKey?: string,
+): Promise<string> => {
+  return (
+    await AbyssToolsCore.axios.get<string>(
+      `extract/extractions/${extractionId}/steps/${stepIndex}/io/${slot}`,
+      { params: serializeParams(scope), headers: authHeader(apiKey), responseType: 'text' },
+    )
+  ).data;
+};
+
 // ─── SHARED FILES (content_share-backed) ────
 //
 // Types live in `../types/interface/api/requests/extraction.request.ts` so they

package/src/api/index.ts

@@ -20,9 +20,6 @@ export * from './board-label.api';
 export * from './draw.api';
 export * from './draw.public.api';
 
-// Memo
-export * from './memo.api';
-
 // Retrospective
 export * from './retrospective.api';
 export * from './retrospective.public.api';

package/src/constants/index.ts

@@ -1,4 +1,3 @@
-export * from './memo.constants';
 export * from './atlas.constants';
 export * from './board.constants';
 export * from './short-link.constants';

package/src/index.ts

@@ -20,7 +20,6 @@ import * as atlasGroupApi from './api/atlas-group.api';
 import * as atlasPageApi from './api/atlas-page.api';
 import * as atlasDocumentApi from './api/atlas-document.api';
 import * as atlasPublicApi from './api/atlas.public.api';
-import * as memoApi from './api/memo.api';
 import * as shortLinkApiModule from './api/short-link.api';
 import * as shortLinkAdminApiModule from './api/short-link.admin.api';
 import * as shortLinkPublicApiModule from './api/short-link.public.api';
@@ -256,18 +255,6 @@ type AbyssToolsCoreSDK = {
     paginate: typeof atlasDocumentApi.paginateAtlasDocument;
     list: typeof atlasDocumentApi.listAtlasDocument;
   };
-  memo: {
-    paginate: typeof memoApi.paginateMemo;
-    paginateProject: typeof memoApi.paginateProjectMemo;
-    paginateOrganization: typeof memoApi.paginateOrganizationMemo;
-    get: typeof memoApi.getMemo;
-    delete: typeof memoApi.deleteMemo;
-    update: typeof memoApi.updateMemo;
-    create: typeof memoApi.createMemo;
-    createForOrganization: typeof memoApi.createForOrganizationMemo;
-    transfer: typeof memoApi.transferMemo;
-    countOrganization: typeof memoApi.countOrganizationMemo;
-  };
   shortLink: {
     get: typeof shortLinkApiModule.shortLinkApi.get;
     paginate: typeof shortLinkApiModule.shortLinkApi.paginate;
@@ -438,6 +425,8 @@ type AbyssToolsCoreSDK = {
       diff: typeof extractionApi.diffExtractions;
       /** Opt a specific extraction in/out of the improvement-training dataset. */
       toggleTraining: typeof extractionApi.toggleExtractionTraining;
+      /** Lazy fetch of one trace step's full IO payload (P3). */
+      stepIo: typeof extractionApi.getStepIo;
     };
     templates: {
       list: typeof extractionApi.listTemplates;
@@ -469,6 +458,7 @@ type AbyssToolsCoreSDK = {
     usage: {
       list: typeof extractionApi.listUsage;
       summary: typeof extractionApi.summaryUsage;
+      byConfig: typeof extractionApi.usageByConfig;
     };
     share: {
       mint: typeof extractionApi.mintShareExtraction;
@@ -707,18 +697,6 @@ export class AbyssToolsCore {
         paginate: atlasDocumentApi.paginateAtlasDocument,
         list: atlasDocumentApi.listAtlasDocument,
       },
-      memo: {
-        paginate: memoApi.paginateMemo,
-        paginateProject: memoApi.paginateProjectMemo,
-        paginateOrganization: memoApi.paginateOrganizationMemo,
-        get: memoApi.getMemo,
-        delete: memoApi.deleteMemo,
-        update: memoApi.updateMemo,
-        create: memoApi.createMemo,
-        createForOrganization: memoApi.createForOrganizationMemo,
-        transfer: memoApi.transferMemo,
-        countOrganization: memoApi.countOrganizationMemo,
-      },
       shortLink: {
         get: shortLinkApiModule.shortLinkApi.get,
         paginate: shortLinkApiModule.shortLinkApi.paginate,
@@ -863,6 +841,7 @@ export class AbyssToolsCore {
           getExportJob: extractionApi.getExportJob,
           diff: extractionApi.diffExtractions,
           toggleTraining: extractionApi.toggleExtractionTraining,
+          stepIo: extractionApi.getStepIo,
         },
         templates: {
           list: extractionApi.listTemplates,
@@ -891,6 +870,7 @@ export class AbyssToolsCore {
         usage: {
           list: extractionApi.listUsage,
           summary: extractionApi.summaryUsage,
+          byConfig: extractionApi.usageByConfig,
         },
         share: {
           mint: extractionApi.mintShareExtraction,

package/src/types/enum/content-share.enum.ts

@@ -1,7 +1,6 @@
 export enum ShareableContentType {
   DRAW = 'draw',
   BOARD = 'board',
-  MEMO = 'memo',
   ATLAS = 'atlas',
   RETROSPECTIVE = 'retrospective',
   SHORT_LINK = 'short_link',

package/src/types/enum/extraction-step-status.enum.ts

@@ -0,0 +1,7 @@
+/** Terminal disposition of a single plan pass in the execution trace (P1). Mirrors server. */
+export enum ExtractionStepStatus {
+  RAN = 'ran',
+  SKIPPED_BY_GATE = 'skippedByGate',
+  TIMEOUT = 'timeout',
+  FAILED = 'failed',
+}

package/src/types/enum/index.ts

@@ -11,5 +11,6 @@ export * from './extraction-feedback-issue-type.enum';
 export * from './provider-kind.enum';
 export * from './interpreter-kind.enum';
 export * from './combine-strategy.enum';
+export * from './extraction-step-status.enum';
 export * from './probe-scan.enum';
 export * from './file-scan-status.enum';

package/src/types/interface/api/requests/extraction.request.ts

@@ -246,6 +246,12 @@ export interface ISummaryUsageQuery {
   to?: string;
 }
 
+/** Per-config usage window (P2). */
+export interface IUsageByConfigQuery {
+  from?: string;
+  to?: string;
+}
+
 // ─── WEBHOOK DELIVERIES ─────────────────────
 
 export interface IListWebhookDeliveriesQuery {

package/src/types/interface/api/requests/index.ts

@@ -13,7 +13,6 @@ export * from './board-column.request';
 export * from './board-label.request';
 export * from './draw.request';
 export * from './draw.public.request';
-export * from './memo.request';
 export * from './retrospective.request';
 export * from './retrospective.public.request';
 export * from './retrospective-card.request';

package/src/types/interface/api/responses/abyss.admin.response.ts

@@ -19,7 +19,6 @@ export type ISyncProjectAbyssAdminResponse = IResponse<ISyncProjectAbyssAdminDat
 export type IProjectContentSummaryData = {
   draws: number;
   boards: number;
-  memos: number;
   retrospectives: number;
   shortLinks: number;
   atlas: number;

package/src/types/interface/api/responses/extraction.response.ts

@@ -300,6 +300,23 @@ export interface IExtractionUsageSummary {
 }
 export type ISummaryUsageResponse = IResponse<IExtractionUsageSummary>;
 
+/** One config's aggregate performance (P2) — for "which config works best". */
+export interface IUsageByConfigRow {
+  planPresetId: string; // 'factory-default' | 'inline' | 'system:x' | <uuid> | 'unknown'
+  providerId: string | null;
+  interpreterId: string | null;
+  count: number;
+  successCount: number;
+  successRate: number; // 0..1
+  avgDurationMs: number;
+  avgRecords: number;
+  ocrPagesConsumed: number;
+}
+export interface IUsageByConfig {
+  rows: IUsageByConfigRow[];
+}
+export type IUsageByConfigResponse = IResponse<IUsageByConfig>;
+
 // ─── WEBHOOK DELIVERIES ─────────────────────
 
 export interface IListWebhookDeliveriesResponse {

package/src/types/interface/api/responses/index.ts

@@ -13,7 +13,6 @@ export * from './board-column.response';
 export * from './board-label.response';
 export * from './draw.response';
 export * from './draw.public.response';
-export * from './memo.response';
 export * from './retrospective.response';
 export * from './retrospective.public.response';
 export * from './retrospective-card.response';

package/src/types/interface/api/responses/metrics.response.ts

@@ -3,7 +3,6 @@ import { IResponse } from '../type-message/response';
 export interface IToolsMetrics {
   boardCount: number;
   drawCount: number;
-  memoCount: number;
   atlasCount: number;
   retrospectiveCount: number;
   shortLinkCount: number;

package/src/types/interface/api/responses/transfer.response.ts

@@ -1,14 +1,12 @@
 import { IResponse } from '../type-message/response';
 import { IDraw } from '../../models/draw.dto';
 import { IBoard } from '../../models/board.dto';
-import { IMemo } from '../../models/memo.dto';
 import { IAtlas } from '../../models/atlas.dto';
 import { IRetrospective } from '../../models/retrospective.dto';
 import { IShortLink } from '../../models/short-link.dto';
 
 export type ITransferDrawResponse = IResponse<{ draw: IDraw }>;
 export type ITransferBoardResponse = IResponse<{ board: IBoard }>;
-export type ITransferMemoResponse = IResponse<{ memo: IMemo }>;
 export type ITransferAtlasResponse = IResponse<{ atlas: IAtlas }>;
 export type ITransferRetrospectiveResponse = IResponse<{ retrospective: IRetrospective }>;
 export type ITransferShortLinkResponse = IResponse<{ shortLink: IShortLink }>;

package/src/types/interface/models/extraction-plan.dto.ts

@@ -8,9 +8,10 @@
 import { ProviderKind, CostTier } from '../../enum/provider-kind.enum';
 import { InterpreterKind } from '../../enum/interpreter-kind.enum';
 import { CombineStrategy } from '../../enum/combine-strategy.enum';
+import { ExtractionStepStatus } from '../../enum/extraction-step-status.enum';
 
 // Re-export for consumers that import from this barrel.
-export { ProviderKind, CostTier, InterpreterKind, CombineStrategy };
+export { ProviderKind, CostTier, InterpreterKind, CombineStrategy, ExtractionStepStatus };
 
 // ─── Plan building blocks ──────────────────────────────────────────────────
 
@@ -180,15 +181,53 @@ export interface IExecutionManifest {
   createdAt: string;
 }
 
+// ─── Execution trace (P1) ──────────────────────────────────────────────────
+
+/** Per-IO metadata in the persisted trace skeleton. The full payload is fetched lazily. */
+export interface IStepIo {
+  slot: 'providerOutput' | 'interpreterOutput';
+  bytes: number;
+  sha256: string;
+  preview: string;
+  status: 'pending' | 'ready' | 'skipped';
+  applicationFileId: string | null;
+}
+
+/** One executed / gate-skipped / failed pass, with timing, status and IO refs. */
+export interface IStepTrace {
+  index: number;
+  providerId: string;
+  providerVersion: string;
+  interpreterId: string;
+  interpreterVersion: string;
+  documentType: string | null;
+  status: ExtractionStepStatus;
+  startedAtMs: number;
+  durationMs: number;
+  ocrPageCount: number;
+  fieldsContributed: number;
+  errorMessage: string | null;
+  io: IStepIo[];
+}
+
+/**
+ * Per-pass execution trace skeleton persisted in extractions.executionTrace and
+ * surfaced by GET /extractions/:id. Full IO payloads are fetched lazily via
+ * sdk.extract.extractions.stepIo.
+ */
+export interface IExecutionTrace {
+  steps: IStepTrace[];
+  totalDurationMs: number;
+  artifactStatus: 'pending' | 'ready';
+}
+
 // ─── Plan presets ──────────────────────────────────────────────────────────
 
 /** A saved extraction plan preset (DB row + virtual system presets). */
 export interface IExtractionPlanPreset {
   id: string;
   name: string;
-  scope:
-    | { kind: 'user'; userId: string }
-    | { kind: 'org'; organizationId: string };
+  scope: { kind: 'user'; userId: string } | { kind: 'org'; organizationId: string };
   plan: IExtractionPlan;
   isDefault: boolean;
   system: boolean;

package/src/types/interface/models/extraction.dto.ts

@@ -7,7 +7,12 @@ import { ExtractionWarningCode } from '../../../types/enum/extraction-warning.en
 import { ExtractionFeedbackIssueType } from '../../../types/enum/extraction-feedback-issue-type.enum';
 import { DocumentType } from '../../../types/enum/document-type.enum';
 import { FileScanStatus } from '../../enum/file-scan-status.enum';
-import type { IFieldValue, IExecutionManifest, IGlobalConfidence } from './extraction-plan.dto';
+import type {
+  IFieldValue,
+  IExecutionManifest,
+  IGlobalConfidence,
+  IExecutionTrace,
+} from './extraction-plan.dto';
 
 // Re-export so consumers can import ExtractionFeedbackIssueType from the DTO barrel.
 export { ExtractionFeedbackIssueType };
@@ -163,6 +168,11 @@ export interface IExtraction {
    * Surfaced where available; optional/absent otherwise. ADDITIVE, optional.
    */
   globalConfidence?: IGlobalConfidence | null;
+  /**
+   * Per-pass execution trace skeleton (timing/status/impl + lazy IO refs) — P1.
+   * Present on plan-path rows; absent on legacy paths. ADDITIVE, optional.
+   */
+  executionTrace?: IExecutionTrace | null;
   createdAt: string;
 }
 

package/src/types/interface/models/index.ts

@@ -7,7 +7,6 @@ export * from './atlas-group.dto';
 export * from './atlas-page.dto';
 export * from './atlas-page-content.dto';
 export * from './draw.dto';
-export * from './memo.dto';
 export * from './retrospective.dto';
 export * from './retrospective-section.dto';
 export * from './retrospective-card.dto';

package/src/types/interface/models/project.dto.ts

@@ -1,6 +1,5 @@
 import { IAtlas } from './atlas.dto';
 import { IDraw } from './draw.dto';
-import { IMemo } from './memo.dto';
 import { IOrganization } from './organization.dto';
 import { IRetrospective } from './retrospective.dto';
 import { IShortLink } from './short-link.dto';
@@ -20,6 +19,5 @@ export interface IProject {
   draws?: IDraw[];
   retrospectives?: IRetrospective[];
   atlases?: IAtlas[];
-  memos?: IMemo[];
   shortLinks?: IShortLink[];
 }

package/src/types/interface/models/user.dto.ts

@@ -2,7 +2,6 @@ import { IAtlas } from './atlas.dto';
 import { IBoard } from './board.dto';
 import { IBoardCardComment } from './board-card-comment.dto';
 import { IDraw } from './draw.dto';
-import { IMemo } from './memo.dto';
 import { IProject } from './project.dto';
 import { IRetrospective } from './retrospective.dto';
 import { IShortLink } from './short-link.dto';
@@ -24,7 +23,6 @@ export interface IUser {
   draws?: IDraw[];
   retrospectives?: IRetrospective[];
   atlases?: IAtlas[];
-  memos?: IMemo[];
   shortLinks?: IShortLink[];
   boardCardComments?: IBoardCardComment[];
 }