@attentionform/astra-mcp-server 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/dist/index.js +569 -227
  2. package/dist/lib/mcp/handlers/open-inspect.d.ts +15 -0
  3. package/dist/lib/mcp/handlers/parity.d.ts +6 -0
  4. package/dist/lib/mcp/schemas.d.ts +60 -5
  5. package/package.json +3 -3
package/dist/lib/mcp/handlers/open-inspect.d.ts CHANGED
@@ -27,6 +27,15 @@ export declare function handleOpenDocument(store: McpSessionStore, input: unknow
27
27
  * full dump to first window — the navigation remedy teaches paging.
28
28
  */
29
29
  export declare const INSPECT_FULL_TOON_TOKEN_THRESHOLD = 2000;
30
+ /** What the `outline` tier counts, over the whole document: rows of that tier are headings only. */
31
+ export interface OutlineCounts {
32
+ /** Headings in the document (all of them, whatever `sectionId`, `offset` or `limit` selected). */
33
+ headings: number;
34
+ nodes: number;
35
+ tables: number;
36
+ images: number;
37
+ words: number;
38
+ }
30
39
  export interface InspectWindowEnvelope {
31
40
  totalNodes: number;
32
41
  returnedNodes: number;
@@ -68,6 +77,12 @@ export declare function handleInspectDocument(store: McpSessionStore, input: unk
68
77
  truncated: boolean;
69
78
  /** Present when windowed: teaches search -> aroundNode zoom -> offset paging. */
70
79
  remedy?: string;
80
+ /** Outline tier only: whole-document counts, because rowCount/totalNodes count heading rows there. */
81
+ outline?: OutlineCounts;
82
+ /** Outline tier with aroundNode: the heading the node resolved to (null before the first heading). */
83
+ aroundResolvedTo?: string | null;
84
+ /** Outline tier: why a window is empty or not centred where aroundNode pointed. */
85
+ note?: string;
71
86
  /** Compact summary of the session style guide (absent when none attached). */
72
87
  styleGuide?: StyleGuideSummary;
73
88
  comments?: unknown;
package/dist/lib/mcp/handlers/parity.d.ts CHANGED
@@ -37,6 +37,12 @@ export declare function handleGetStats(store: McpSessionStore, input: unknown):
37
37
  callouts: number;
38
38
  images: number;
39
39
  pages: number;
40
+ pageTerms: {
41
+ words: number;
42
+ tables: number;
43
+ images: number;
44
+ pageBreaks: number;
45
+ };
40
46
  } | McpErrorShape>;
41
47
  export interface SanitizeDocumentOk {
42
48
  ok: true;
package/dist/lib/mcp/schemas.d.ts CHANGED
@@ -11,6 +11,7 @@ export declare const OpenDocumentSchema: z.ZodObject<{
11
11
  export declare const InspectDocumentSchema: z.ZodObject<{
12
12
  sessionId: z.ZodString;
13
13
  fidelity: z.ZodOptional<z.ZodEnum<{
14
+ outline: "outline";
14
15
  compact: "compact";
15
16
  standard: "standard";
16
17
  full: "full";
@@ -203,7 +204,25 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
203
204
  fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
204
205
  sz: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
205
206
  fontFamily: z.ZodOptional<z.ZodString>;
206
- highlight: z.ZodOptional<z.ZodString>;
207
+ highlight: z.ZodOptional<z.ZodEnum<{
208
+ none: "none";
209
+ red: "red";
210
+ green: "green";
211
+ blue: "blue";
212
+ black: "black";
213
+ white: "white";
214
+ yellow: "yellow";
215
+ cyan: "cyan";
216
+ magenta: "magenta";
217
+ darkBlue: "darkBlue";
218
+ darkCyan: "darkCyan";
219
+ darkGreen: "darkGreen";
220
+ darkMagenta: "darkMagenta";
221
+ darkRed: "darkRed";
222
+ darkYellow: "darkYellow";
223
+ darkGray: "darkGray";
224
+ lightGray: "lightGray";
225
+ }>>;
207
226
  lineSpacing: z.ZodOptional<z.ZodNumber>;
208
227
  spacingBefore: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
209
228
  spacingAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -237,7 +256,25 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
237
256
  fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
238
257
  sz: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
239
258
  fontFamily: z.ZodOptional<z.ZodString>;
240
- highlight: z.ZodOptional<z.ZodString>;
259
+ highlight: z.ZodOptional<z.ZodEnum<{
260
+ none: "none";
261
+ red: "red";
262
+ green: "green";
263
+ blue: "blue";
264
+ black: "black";
265
+ white: "white";
266
+ yellow: "yellow";
267
+ cyan: "cyan";
268
+ magenta: "magenta";
269
+ darkBlue: "darkBlue";
270
+ darkCyan: "darkCyan";
271
+ darkGreen: "darkGreen";
272
+ darkMagenta: "darkMagenta";
273
+ darkRed: "darkRed";
274
+ darkYellow: "darkYellow";
275
+ darkGray: "darkGray";
276
+ lightGray: "lightGray";
277
+ }>>;
241
278
  lineSpacing: z.ZodOptional<z.ZodNumber>;
242
279
  spacingBefore: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
243
280
  spacingAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -270,7 +307,25 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
270
307
  fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
271
308
  sz: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
272
309
  fontFamily: z.ZodOptional<z.ZodString>;
273
- highlight: z.ZodOptional<z.ZodString>;
310
+ highlight: z.ZodOptional<z.ZodEnum<{
311
+ none: "none";
312
+ red: "red";
313
+ green: "green";
314
+ blue: "blue";
315
+ black: "black";
316
+ white: "white";
317
+ yellow: "yellow";
318
+ cyan: "cyan";
319
+ magenta: "magenta";
320
+ darkBlue: "darkBlue";
321
+ darkCyan: "darkCyan";
322
+ darkGreen: "darkGreen";
323
+ darkMagenta: "darkMagenta";
324
+ darkRed: "darkRed";
325
+ darkYellow: "darkYellow";
326
+ darkGray: "darkGray";
327
+ lightGray: "lightGray";
328
+ }>>;
274
329
  lineSpacing: z.ZodOptional<z.ZodNumber>;
275
330
  spacingBefore: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
276
331
  spacingAfter: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
@@ -377,7 +432,7 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
377
432
  }>>;
378
433
  border: z.ZodOptional<z.ZodString>;
379
434
  color: z.ZodOptional<z.ZodString>;
380
- sz: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
435
+ sz: z.ZodOptional<z.ZodNumber>;
381
436
  vAlign: z.ZodOptional<z.ZodString>;
382
437
  align: z.ZodOptional<z.ZodPreprocess<z.ZodEnum<{
383
438
  center: "center";
@@ -777,7 +832,7 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
777
832
  }, z.core.$strict>, z.ZodObject<{
778
833
  action: z.ZodLiteral<"pageBorder">;
779
834
  style: z.ZodOptional<z.ZodString>;
780
- sz: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
835
+ sz: z.ZodOptional<z.ZodNumber>;
781
836
  fontSize: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
782
837
  color: z.ZodOptional<z.ZodString>;
783
838
  marginOffset: z.ZodOptional<z.ZodEnum<{
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@attentionform/astra-mcp-server",
3
3
  "mcpName": "com.attentionform/astra-mcp-server",
4
- "version": "0.5.0",
4
+ "version": "0.5.1",
5
5
  "description": "Official Model Context Protocol (MCP) server for ASTra document IDE",
6
6
  "main": "dist/index.js",
7
7
  "types": "dist/index.d.ts",
@@ -42,8 +42,8 @@
42
42
  "adm-zip-gate": "node ../../scripts/check-adm-zip-imports.mjs"
43
43
  },
44
44
  "dependencies": {
45
- "@attentionform/astra-engine": "^0.5.0",
46
- "@attentionform/ooxml-validator": "^0.5.0",
45
+ "@attentionform/astra-engine": "^0.5.1",
46
+ "@attentionform/ooxml-validator": "^0.5.1",
47
47
  "@modelcontextprotocol/sdk": "^1.32.2",
48
48
  "@xmldom/xmldom": "0.8.15",
49
49
  "adm-zip": "0.6.1",