@gramatr/mcp 0.13.0 → 0.13.10

package/dist/types/generated/rest-api-types.d.ts

@@ -0,0 +1,275 @@
+/**
+ * AUTO-GENERATED — do not edit manually.
+ * Source: contracts/responses/*.yaml
+ * Generator: contracts/generator/generate.ts
+ * Generated: 2026-04-24T06:29:46.353Z
+ */
+import { z } from 'zod';
+/** Response shape for GET /api/v1/orgs/:orgId/brands/:slug — canonical brand entity with structured voice sub-object. metadata field retained for backward compatibility only; new code must use structured fields. */
+export declare const BrandGetResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    slug: z.ZodString;
+    brainVersion: z.ZodOptional<z.ZodNumber>;
+    voice: z.ZodOptional<z.ZodObject<{
+        voiceFingerprint: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            sample_count: z.ZodOptional<z.ZodNumber>;
+            sample_tokens_total: z.ZodOptional<z.ZodNumber>;
+            style_vector: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+            tonal_attributes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                attribute: z.ZodString;
+                confidence: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                confidence: number;
+                attribute: string;
+            }, {
+                confidence: number;
+                attribute: string;
+            }>, "many">>;
+            forbidden_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            preferred_constructions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            fingerprint_model_version: z.ZodOptional<z.ZodString>;
+            last_fingerprinted_at: z.ZodOptional<z.ZodString>;
+            stylistic_descriptors: z.ZodOptional<z.ZodObject<{
+                sentence_length_mean: z.ZodOptional<z.ZodNumber>;
+                sentence_length_stddev: z.ZodOptional<z.ZodNumber>;
+                avg_syllables_per_word: z.ZodOptional<z.ZodNumber>;
+                reading_grade: z.ZodOptional<z.ZodNumber>;
+                passive_voice_ratio: z.ZodOptional<z.ZodNumber>;
+                contraction_rate: z.ZodOptional<z.ZodNumber>;
+                em_dash_density: z.ZodOptional<z.ZodNumber>;
+                oxford_comma_preference: z.ZodOptional<z.ZodString>;
+                first_person_ratio: z.ZodOptional<z.ZodNumber>;
+                hedging_phrase_inventory: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                signature_phrases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            }, {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            sample_count?: number | undefined;
+            sample_tokens_total?: number | undefined;
+            style_vector?: any[] | undefined;
+            tonal_attributes?: {
+                confidence: number;
+                attribute: string;
+            }[] | undefined;
+            forbidden_phrases?: string[] | undefined;
+            preferred_constructions?: string[] | undefined;
+            fingerprint_model_version?: string | undefined;
+            last_fingerprinted_at?: string | undefined;
+            stylistic_descriptors?: {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            } | undefined;
+        }, {
+            sample_count?: number | undefined;
+            sample_tokens_total?: number | undefined;
+            style_vector?: any[] | undefined;
+            tonal_attributes?: {
+                confidence: number;
+                attribute: string;
+            }[] | undefined;
+            forbidden_phrases?: string[] | undefined;
+            preferred_constructions?: string[] | undefined;
+            fingerprint_model_version?: string | undefined;
+            last_fingerprinted_at?: string | undefined;
+            stylistic_descriptors?: {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            } | undefined;
+        }>>>;
+        voiceGenerationRole: z.ZodOptional<z.ZodString>;
+        exemplarExcerpts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            label: string;
+        }, {
+            text: string;
+            label: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        voiceFingerprint?: {
+            sample_count?: number | undefined;
+            sample_tokens_total?: number | undefined;
+            style_vector?: any[] | undefined;
+            tonal_attributes?: {
+                confidence: number;
+                attribute: string;
+            }[] | undefined;
+            forbidden_phrases?: string[] | undefined;
+            preferred_constructions?: string[] | undefined;
+            fingerprint_model_version?: string | undefined;
+            last_fingerprinted_at?: string | undefined;
+            stylistic_descriptors?: {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            } | undefined;
+        } | null | undefined;
+        voiceGenerationRole?: string | undefined;
+        exemplarExcerpts?: {
+            text: string;
+            label: string;
+        }[] | undefined;
+    }, {
+        voiceFingerprint?: {
+            sample_count?: number | undefined;
+            sample_tokens_total?: number | undefined;
+            style_vector?: any[] | undefined;
+            tonal_attributes?: {
+                confidence: number;
+                attribute: string;
+            }[] | undefined;
+            forbidden_phrases?: string[] | undefined;
+            preferred_constructions?: string[] | undefined;
+            fingerprint_model_version?: string | undefined;
+            last_fingerprinted_at?: string | undefined;
+            stylistic_descriptors?: {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            } | undefined;
+        } | null | undefined;
+        voiceGenerationRole?: string | undefined;
+        exemplarExcerpts?: {
+            text: string;
+            label: string;
+        }[] | undefined;
+    }>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    id: string;
+    voice?: {
+        voiceFingerprint?: {
+            sample_count?: number | undefined;
+            sample_tokens_total?: number | undefined;
+            style_vector?: any[] | undefined;
+            tonal_attributes?: {
+                confidence: number;
+                attribute: string;
+            }[] | undefined;
+            forbidden_phrases?: string[] | undefined;
+            preferred_constructions?: string[] | undefined;
+            fingerprint_model_version?: string | undefined;
+            last_fingerprinted_at?: string | undefined;
+            stylistic_descriptors?: {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            } | undefined;
+        } | null | undefined;
+        voiceGenerationRole?: string | undefined;
+        exemplarExcerpts?: {
+            text: string;
+            label: string;
+        }[] | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    brainVersion?: number | undefined;
+}, {
+    slug: string;
+    id: string;
+    voice?: {
+        voiceFingerprint?: {
+            sample_count?: number | undefined;
+            sample_tokens_total?: number | undefined;
+            style_vector?: any[] | undefined;
+            tonal_attributes?: {
+                confidence: number;
+                attribute: string;
+            }[] | undefined;
+            forbidden_phrases?: string[] | undefined;
+            preferred_constructions?: string[] | undefined;
+            fingerprint_model_version?: string | undefined;
+            last_fingerprinted_at?: string | undefined;
+            stylistic_descriptors?: {
+                sentence_length_mean?: number | undefined;
+                sentence_length_stddev?: number | undefined;
+                avg_syllables_per_word?: number | undefined;
+                reading_grade?: number | undefined;
+                passive_voice_ratio?: number | undefined;
+                contraction_rate?: number | undefined;
+                em_dash_density?: number | undefined;
+                oxford_comma_preference?: string | undefined;
+                first_person_ratio?: number | undefined;
+                hedging_phrase_inventory?: string[] | undefined;
+                signature_phrases?: string[] | undefined;
+            } | undefined;
+        } | null | undefined;
+        voiceGenerationRole?: string | undefined;
+        exemplarExcerpts?: {
+            text: string;
+            label: string;
+        }[] | undefined;
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    brainVersion?: number | undefined;
+}>;
+export type BrandGetResponse = z.infer<typeof BrandGetResponseSchema>;
+//# sourceMappingURL=rest-api-types.d.ts.map

package/dist/types/generated/rest-api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-api-types.d.ts","sourceRoot":"","sources":["../../../src/types/generated/rest-api-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,uNAAuN;AACvN,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/types/generated/rest-api-types.js

@@ -0,0 +1,48 @@
+/**
+ * AUTO-GENERATED — do not edit manually.
+ * Source: contracts/responses/*.yaml
+ * Generator: contracts/generator/generate.ts
+ * Generated: 2026-04-24T06:29:46.353Z
+ */
+import { z } from 'zod';
+/** Response shape for GET /api/v1/orgs/:orgId/brands/:slug — canonical brand entity with structured voice sub-object. metadata field retained for backward compatibility only; new code must use structured fields. */
+export const BrandGetResponseSchema = z.object({
+    id: z.string().describe("Brand entity UUID"),
+    slug: z.string().describe("Brand slug (entity name)"),
+    brainVersion: z.number().optional().describe("Studio conflict detection version counter"),
+    voice: z.object({
+        voiceFingerprint: z.object({
+            sample_count: z.number().optional().describe("Number of text samples used to compute this fingerprint"),
+            sample_tokens_total: z.number().optional().describe("Total tokens across all samples"),
+            style_vector: z.array(z.any()).optional().describe("Embedding-space style vector (model-internal)"),
+            tonal_attributes: z.array(z.object({
+                attribute: z.string(),
+                confidence: z.number()
+            })).optional().describe("LLM-extracted tonal qualities with confidence scores"),
+            forbidden_phrases: z.array(z.string()).optional().describe("Phrases the brand voice avoids"),
+            preferred_constructions: z.array(z.string()).optional().describe("Sentence constructions the brand voice favors"),
+            fingerprint_model_version: z.string().optional().describe("Model version that produced this fingerprint"),
+            last_fingerprinted_at: z.string().optional().describe("ISO 8601 timestamp of last fingerprint computation"),
+            stylistic_descriptors: z.object({
+                sentence_length_mean: z.number().optional(),
+                sentence_length_stddev: z.number().optional(),
+                avg_syllables_per_word: z.number().optional(),
+                reading_grade: z.number().optional(),
+                passive_voice_ratio: z.number().optional(),
+                contraction_rate: z.number().optional(),
+                em_dash_density: z.number().optional(),
+                oxford_comma_preference: z.string().optional().describe("always | never | mixed | unknown"),
+                first_person_ratio: z.number().optional(),
+                hedging_phrase_inventory: z.array(z.string()).optional(),
+                signature_phrases: z.array(z.string()).optional()
+            }).optional().describe("Quantitative stylometric measurements computed from raw text")
+        }).nullable().optional().describe("Computed voice fingerprint. Null if brand has not been fingerprinted yet."),
+        voiceGenerationRole: z.string().optional().describe("How the voice fingerprint is used in generation: style_only | full_persona | off"),
+        exemplarExcerpts: z.array(z.object({
+            text: z.string(),
+            label: z.string()
+        })).optional().describe("Representative text excerpts used as generation exemplars")
+    }).optional().describe("Structured voice identity. Canonical path — do not read from metadata.voice_*"),
+    metadata: z.record(z.string(), z.unknown()).optional().describe("Raw entity metadata — backward compatibility only. Deprecated: use structured fields above.")
+});
+//# sourceMappingURL=rest-api-types.js.map

package/dist/types/generated/rest-api-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-api-types.js","sourceRoot":"","sources":["../../../src/types/generated/rest-api-types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gramatr/mcp",
-  "version": "0.13.0",
+  "version": "0.13.10",
   "description": "grāmatr — Intelligence middleware for AI agents. Pre-classifies every request, injects relevant memory and behavioral context, enforces data quality, and maintains session continuity across Claude, ChatGPT, Codex, Cursor, Gemini, and any MCP-compatible client.",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
@@ -41,7 +41,8 @@
   "main": "dist/server/server.js",
   "exports": {
     ".": "./dist/server/server.js",
-    "./bin": "./dist/bin/gramatr-mcp.js"
+    "./bin": "./dist/bin/gramatr-mcp.js",
+    "./types": "./dist/types/generated/rest-api-types.js"
   },
   "files": [
     "dist/**/*.js",
@@ -53,7 +54,8 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "ajv": "^8.18.0"
+    "ajv": "^8.18.0",
+    "zod": "^3.24.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",