@attentionform/astra-mcp-server 0.2.0 → 0.3.0

package/dist/lib/fork-numbering.d.ts

@@ -0,0 +1,10 @@
+import { type DocumentAST, type DocxParser } from '@attentionform/astra-engine';
+/**
+ * Give a serialization fork the live numbering, including its original part
+ * metadata. The engine uses the source hashes to retain untouched bytes and
+ * the root attributes/extra children when definitions really have changed.
+ * Clone every numbering element and source record so fork serialization cannot
+ * change the session. Pass only numbering/relationships on purpose: the bare
+ * rezip path reads only those fields and must not receive other live AST data.
+ */
+export declare function adoptForkNumbering(fork: DocxParser, ast: DocumentAST): void;

package/dist/lib/mcp/diff.d.ts

@@ -160,6 +160,7 @@ export declare function hashDocumentXml(xml: string): string;
  * for the save path (which does not go through executeBatch).
  */
 export declare function countPendingRevisionsInParser(parser: {
+    countPackageRevisions?: () => number;
     getDocumentDom?: () => unknown;
     getDom?: () => unknown;
 }): number;

package/dist/lib/mcp/handlers/open-inspect.d.ts

@@ -68,4 +68,6 @@ export declare function handleInspectDocument(store: McpSessionStore, input: unk
     remedy?: string;
     /** Compact summary of the session style guide (absent when none attached). */
     styleGuide?: StyleGuideSummary;
+    comments?: unknown;
+    revisions?: unknown;
 } | McpErrorShape>;

package/dist/lib/mcp/handlers/parity.d.ts

@@ -57,6 +57,13 @@ export interface SanitizeDocumentOk {
     piiCoverage: typeof PII_COVERAGE;
     piiNote: string;
     acceptedRevisions: number;
+    unresolvedRevisions: {
+        kind: string;
+        count: number;
+        reason: string;
+        part: string;
+    }[];
+    revisionByKind: Record<string, number>;
     strippedComments: number;
     strippedMacros: string[];
     macroParts: string[];

package/dist/lib/mcp/handlers/search-batch.d.ts

@@ -24,6 +24,8 @@ export declare function handleSearchContent(store: McpSessionStore, input: unkno
         cells?: string[];
     }>;
     hint?: string;
+    /** True when more than 50 items matched and the list was cut at 50. */
+    truncated?: boolean;
 } | McpErrorShape>;
 export declare function handleExecuteBatch(store: McpSessionStore, input: unknown): Promise<{
     ok: true;
@@ -39,8 +41,30 @@ export declare function handleExecuteBatch(store: McpSessionStore, input: unknow
     results: BatchOpCreatedIds[];
     /** R-1: pending tracked revisions (w:ins + w:del) remaining after the batch. */
     revisionsPending: number;
-    /** R-1: accept remedy, present only when revisionsPending > 0. */
+    revisionResolution?: {
+        resolved: number;
+        resolvedIds: number[];
+        byKind: Record<string, number>;
+        unresolved: {
+            kind: string;
+            count: number;
+            reason: string;
+            part: string;
+        }[];
+        removedNodeIds?: string[];
+        idsMayHaveChanged?: boolean;
+        /** Bookmarks, comment ids and links affected when a deleted or moved paragraph was removed. */
+        removedBookmarks?: string[];
+        removedComments?: number[];
+        staleLinks?: {
+            bookmark: string;
+            count: number;
+        }[];
+    };
+    /** R-1: remedy, present only when revisionsPending > 0. Names acceptAll only when running it can still help. */
     revisionsRemedy?: string;
+    /** FX-07: how many of revisionsPending the resolution in this batch could not resolve. Absent when none. */
+    revisionsUnresolved?: number;
     /** R-14: advisory chart stale body refs (same shape [{nodeId, preview}]). Additive, never a failure. */
     possiblyStaleBodyRefs: {
         nodeId: string;

package/dist/lib/mcp/schema-dump.d.ts

@@ -7,6 +7,9 @@ export interface ToolDefinition {
 }
 export declare function getToolDefinitions(): ToolDefinition[];
 export declare function buildStamp(version: string): string;
+/** The SDK defaults to inlining repeated Zod nodes. Use shared definitions for
+ * the published catalog while keeping the same Zod schemas for call validation. */
+export declare function compactToolSchema(schema: unknown): Record<string, unknown>;
 export declare function generateSchemasToDir(targetDir: string, version?: string): {
     written: string[];
     count: number;

package/dist/lib/mcp/schemas.d.ts

@@ -22,11 +22,24 @@ export declare const InspectDocumentSchema: z.ZodObject<{
     aroundNode: z.ZodOptional<z.ZodString>;
     window: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        comments: "comments";
+        revisions: "revisions";
+    }>>>;
+    reviewOffset: z.ZodOptional<z.ZodNumber>;
+    reviewLimit: z.ZodOptional<z.ZodNumber>;
+    commentId: z.ZodOptional<z.ZodNumber>;
+    revisionId: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const SearchContentSchema: z.ZodObject<{
     sessionId: z.ZodString;
     query: z.ZodString;
     regex: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        comments: "comments";
+        body: "body";
+        all: "all";
+    }>>;
 }, z.core.$strict>;
 export declare const ExecuteBatchSchema: z.ZodObject<{
     sessionId: z.ZodString;
@@ -77,8 +90,8 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
         widthEmu: z.ZodOptional<z.ZodNumber>;
         heightEmu: z.ZodOptional<z.ZodNumber>;
         chartType: z.ZodOptional<z.ZodEnum<{
-            line: "line";
             area: "area";
+            line: "line";
             bar: "bar";
             column: "column";
             columnStacked: "columnStacked";
@@ -557,8 +570,8 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
         }>>;
         target: z.ZodOptional<z.ZodString>;
         chartType: z.ZodOptional<z.ZodEnum<{
-            line: "line";
             area: "area";
+            line: "line";
             bar: "bar";
             column: "column";
             columnStacked: "columnStacked";
@@ -598,8 +611,8 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
                     b: "b";
                     tr: "tr";
                     t: "t";
-                    none: "none";
                     r: "r";
+                    none: "none";
                     l: "l";
                 }>>;
                 overlay: z.ZodOptional<z.ZodBoolean>;
@@ -820,24 +833,31 @@ export declare const ExecuteBatchSchema: z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         action: z.ZodLiteral<"comment">;
         operation: z.ZodEnum<{
+            delete: "delete";
             insert: "insert";
             reply: "reply";
+            resolve: "resolve";
+            unresolve: "unresolve";
         }>;
         target: z.ZodString;
-        text: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
         author: z.ZodOptional<z.ZodString>;
         date: z.ZodOptional<z.ZodString>;
         expectedVersion: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
         action: z.ZodLiteral<"trackedChange">;
         operation: z.ZodEnum<{
+            accept: "accept";
+            reject: "reject";
             delete: "delete";
             insert: "insert";
             acceptAll: "acceptAll";
             rejectAll: "rejectAll";
         }>;
+        ids: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         target: z.ZodOptional<z.ZodString>;
         text: z.ZodOptional<z.ZodString>;
+        occurrence: z.ZodOptional<z.ZodNumber>;
         author: z.ZodOptional<z.ZodString>;
         date: z.ZodOptional<z.ZodString>;
         expectedVersion: z.ZodOptional<z.ZodNumber>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attentionform/astra-mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official Model Context Protocol (MCP) server for ASTra document IDE",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,8 +41,8 @@
     "adm-zip-gate": "node ../../scripts/check-adm-zip-imports.mjs"
   },
   "dependencies": {
-    "@attentionform/astra-engine": "^0.2.0",
-    "@attentionform/ooxml-validator": "^0.2.0",
+    "@attentionform/astra-engine": "^0.3.0",
+    "@attentionform/ooxml-validator": "^0.3.0",
     "@modelcontextprotocol/sdk": "^1.32.2",
     "@xmldom/xmldom": "0.8.15",
     "adm-zip": "0.6.1",