@kozou/mcp 0.0.1 → 0.1.0

package/dist/schemas/describe_view.d.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+export declare const describeViewInputSchema: z.ZodObject<{
+    qualifiedName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    qualifiedName: string;
+}, {
+    qualifiedName: string;
+}>;
+export declare const describeViewOutputSchema: z.ZodObject<{
+    qualifiedName: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    aiDescription: z.ZodNullable<z.ZodString>;
+    columns: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        dataType: z.ZodString;
+        nullable: z.ZodBoolean;
+        defaultExpr: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        aiDescription: z.ZodNullable<z.ZodString>;
+        enumValues: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+        isForeignKey: z.ZodBoolean;
+        references: z.ZodNullable<z.ZodObject<{
+            table: z.ZodString;
+            column: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            table: string;
+            column: string;
+        }, {
+            table: string;
+            column: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string | null;
+        name: string;
+        dataType: string;
+        nullable: boolean;
+        defaultExpr: string | null;
+        aiDescription: string | null;
+        enumValues: string[] | null;
+        isForeignKey: boolean;
+        references: {
+            table: string;
+            column: string;
+        } | null;
+    }, {
+        description: string | null;
+        name: string;
+        dataType: string;
+        nullable: boolean;
+        defaultExpr: string | null;
+        aiDescription: string | null;
+        enumValues: string[] | null;
+        isForeignKey: boolean;
+        references: {
+            table: string;
+            column: string;
+        } | null;
+    }>, "many">;
+    underlyingTables: z.ZodArray<z.ZodString, "many">;
+    definition: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    qualifiedName: string;
+    label: string;
+    description: string | null;
+    aiDescription: string | null;
+    columns: {
+        description: string | null;
+        name: string;
+        dataType: string;
+        nullable: boolean;
+        defaultExpr: string | null;
+        aiDescription: string | null;
+        enumValues: string[] | null;
+        isForeignKey: boolean;
+        references: {
+            table: string;
+            column: string;
+        } | null;
+    }[];
+    underlyingTables: string[];
+    definition: string;
+}, {
+    qualifiedName: string;
+    label: string;
+    description: string | null;
+    aiDescription: string | null;
+    columns: {
+        description: string | null;
+        name: string;
+        dataType: string;
+        nullable: boolean;
+        defaultExpr: string | null;
+        aiDescription: string | null;
+        enumValues: string[] | null;
+        isForeignKey: boolean;
+        references: {
+            table: string;
+            column: string;
+        } | null;
+    }[];
+    underlyingTables: string[];
+    definition: string;
+}>;
+export type DescribeViewInput = z.infer<typeof describeViewInputSchema>;
+export type DescribeViewOutput = z.infer<typeof describeViewOutputSchema>;
+//# sourceMappingURL=describe_view.d.ts.map

package/dist/schemas/describe_view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe_view.d.ts","sourceRoot":"","sources":["../../src/schemas/describe_view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAmBH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/describe_view.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+export const describeViewInputSchema = z.object({
+    qualifiedName: z.string().min(1),
+});
+const viewColumnSchema = z.object({
+    name: z.string(),
+    dataType: z.string(),
+    nullable: z.boolean(),
+    defaultExpr: z.string().nullable(),
+    description: z.string().nullable(),
+    aiDescription: z.string().nullable(),
+    enumValues: z.array(z.string()).nullable(),
+    isForeignKey: z.boolean(),
+    references: z
+        .object({
+        table: z.string(),
+        column: z.string(),
+    })
+        .nullable(),
+});
+export const describeViewOutputSchema = z.object({
+    qualifiedName: z.string(),
+    label: z.string(),
+    description: z.string().nullable(),
+    aiDescription: z.string().nullable(),
+    columns: z.array(viewColumnSchema),
+    underlyingTables: z.array(z.string()),
+    definition: z.string(),
+});
+//# sourceMappingURL=describe_view.js.map

package/dist/schemas/describe_view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe_view.js","sourceRoot":"","sources":["../../src/schemas/describe_view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;IACzB,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAClC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC"}

package/dist/schemas/get_concept_context.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+export declare const getConceptContextInputSchema: z.ZodObject<{
+    name: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+}, {
+    name: string;
+}>;
+export declare const getConceptContextOutputSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    aiNotes: z.ZodArray<z.ZodString, "many">;
+    preferredQuerySource: z.ZodString;
+    joinSuggestions: z.ZodArray<z.ZodObject<{
+        table: z.ZodString;
+        on: z.ZodString;
+        purpose: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        table: string;
+        purpose: string;
+        on: string;
+    }, {
+        table: string;
+        purpose: string;
+        on: string;
+    }>, "many">;
+    relatedTables: z.ZodArray<z.ZodString, "many">;
+    exampleQueries: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        sql: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        sql: string;
+    }, {
+        description: string;
+        sql: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    description: string | null;
+    name: string;
+    aiNotes: string[];
+    preferredQuerySource: string;
+    joinSuggestions: {
+        table: string;
+        purpose: string;
+        on: string;
+    }[];
+    relatedTables: string[];
+    exampleQueries: {
+        description: string;
+        sql: string;
+    }[];
+}, {
+    label: string;
+    description: string | null;
+    name: string;
+    aiNotes: string[];
+    preferredQuerySource: string;
+    joinSuggestions: {
+        table: string;
+        purpose: string;
+        on: string;
+    }[];
+    relatedTables: string[];
+    exampleQueries: {
+        description: string;
+        sql: string;
+    }[];
+}>;
+export type GetConceptContextInput = z.infer<typeof getConceptContextInputSchema>;
+export type GetConceptContextOutput = z.infer<typeof getConceptContextOutputSchema>;
+//# sourceMappingURL=get_concept_context.d.ts.map

package/dist/schemas/get_concept_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_concept_context.d.ts","sourceRoot":"","sources":["../../src/schemas/get_concept_context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,4BAA4B;;;;;;EAEvC,CAAC;AAaH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASxC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/schemas/get_concept_context.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const getConceptContextInputSchema = z.object({
+    name: z.string().min(1),
+});
+const joinSuggestionSchema = z.object({
+    table: z.string(),
+    on: z.string(),
+    purpose: z.string(),
+});
+const exampleQuerySchema = z.object({
+    description: z.string(),
+    sql: z.string(),
+});
+export const getConceptContextOutputSchema = z.object({
+    name: z.string(),
+    label: z.string(),
+    description: z.string().nullable(),
+    aiNotes: z.array(z.string()),
+    preferredQuerySource: z.string(),
+    joinSuggestions: z.array(joinSuggestionSchema),
+    relatedTables: z.array(z.string()),
+    exampleQueries: z.array(exampleQuerySchema),
+});
+//# sourceMappingURL=get_concept_context.js.map

package/dist/schemas/get_concept_context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_concept_context.js","sourceRoot":"","sources":["../../src/schemas/get_concept_context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;IAChC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;CAC5C,CAAC,CAAC"}

package/dist/schemas/list_concepts.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const listConceptsInputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare const listConceptsOutputSchema: z.ZodObject<{
+    concepts: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        kind: z.ZodLiteral<"VIEW">;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description: string | null;
+        name: string;
+        kind: "VIEW";
+    }, {
+        label: string;
+        description: string | null;
+        name: string;
+        kind: "VIEW";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    concepts: {
+        label: string;
+        description: string | null;
+        name: string;
+        kind: "VIEW";
+    }[];
+}, {
+    concepts: {
+        label: string;
+        description: string | null;
+        name: string;
+        kind: "VIEW";
+    }[];
+}>;
+export type ListConceptsInput = z.infer<typeof listConceptsInputSchema>;
+export type ListConceptsOutput = z.infer<typeof listConceptsOutputSchema>;
+//# sourceMappingURL=list_concepts.d.ts.map

package/dist/schemas/list_concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_concepts.d.ts","sourceRoot":"","sources":["../../src/schemas/list_concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB,iDAAwB,CAAC;AAE7D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASnC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/schemas/list_concepts.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export const listConceptsInputSchema = z.object({}).strict();
+export const listConceptsOutputSchema = z.object({
+    concepts: z.array(z.object({
+        name: z.string(),
+        label: z.string(),
+        description: z.string().nullable(),
+        kind: z.literal('VIEW'),
+    })),
+});
+//# sourceMappingURL=list_concepts.js.map

package/dist/schemas/list_concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_concepts.js","sourceRoot":"","sources":["../../src/schemas/list_concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;KACxB,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/schemas/list_tables.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export declare const listTablesInputSchema: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+    includeSystem: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    schema?: string | undefined;
+    includeSystem?: boolean | undefined;
+}, {
+    schema?: string | undefined;
+    includeSystem?: boolean | undefined;
+}>;
+export declare const listTablesOutputSchema: z.ZodObject<{
+    tables: z.ZodArray<z.ZodObject<{
+        qualifiedName: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        rowCountEstimate: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        qualifiedName: string;
+        label: string;
+        description: string | null;
+        rowCountEstimate: number | null;
+    }, {
+        qualifiedName: string;
+        label: string;
+        description: string | null;
+        rowCountEstimate: number | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    tables: {
+        qualifiedName: string;
+        label: string;
+        description: string | null;
+        rowCountEstimate: number | null;
+    }[];
+}, {
+    tables: {
+        qualifiedName: string;
+        label: string;
+        description: string | null;
+        rowCountEstimate: number | null;
+    }[];
+}>;
+export type ListTablesInput = z.infer<typeof listTablesInputSchema>;
+export type ListTablesOutput = z.infer<typeof listTablesOutputSchema>;
+//# sourceMappingURL=list_tables.d.ts.map

package/dist/schemas/list_tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_tables.d.ts","sourceRoot":"","sources":["../../src/schemas/list_tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/list_tables.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export const listTablesInputSchema = z.object({
+    schema: z.string().optional(),
+    includeSystem: z.boolean().optional(),
+});
+export const listTablesOutputSchema = z.object({
+    tables: z.array(z.object({
+        qualifiedName: z.string(),
+        label: z.string(),
+        description: z.string().nullable(),
+        rowCountEstimate: z.number().nullable(),
+    })),
+});
+//# sourceMappingURL=list_tables.js.map

package/dist/schemas/list_tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_tables.js","sourceRoot":"","sources":["../../src/schemas/list_tables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,KAAK,CACb,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/schemas/list_views.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const listViewsInputSchema: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    schema?: string | undefined;
+}, {
+    schema?: string | undefined;
+}>;
+export declare const listViewsOutputSchema: z.ZodObject<{
+    views: z.ZodArray<z.ZodObject<{
+        qualifiedName: z.ZodString;
+        label: z.ZodString;
+        purpose: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        qualifiedName: string;
+        label: string;
+        purpose: string | null;
+    }, {
+        qualifiedName: string;
+        label: string;
+        purpose: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    views: {
+        qualifiedName: string;
+        label: string;
+        purpose: string | null;
+    }[];
+}, {
+    views: {
+        qualifiedName: string;
+        label: string;
+        purpose: string | null;
+    }[];
+}>;
+export type ListViewsInput = z.infer<typeof listViewsInputSchema>;
+export type ListViewsOutput = z.infer<typeof listViewsOutputSchema>;
+//# sourceMappingURL=list_views.d.ts.map

package/dist/schemas/list_views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_views.d.ts","sourceRoot":"","sources":["../../src/schemas/list_views.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;EAE/B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schemas/list_views.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export const listViewsInputSchema = z.object({
+    schema: z.string().optional(),
+});
+export const listViewsOutputSchema = z.object({
+    views: z.array(z.object({
+        qualifiedName: z.string(),
+        label: z.string(),
+        purpose: z.string().nullable(),
+    })),
+});
+//# sourceMappingURL=list_views.js.map

package/dist/schemas/list_views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_views.js","sourceRoot":"","sources":["../../src/schemas/list_views.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;QACP,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC,CACH;CACF,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SchemaCache } from './schemaCache.js';
+export declare function createMcpServer(cache: SchemaCache): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAWnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAqEpD,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAwC1D"}

package/dist/server.js

@@ -0,0 +1,105 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { listTables } from './tools/list_tables.js';
+import { describeTable } from './tools/describe_table.js';
+import { listViews } from './tools/list_views.js';
+import { describeView } from './tools/describe_view.js';
+import { listConcepts } from './tools/list_concepts.js';
+import { getConceptContext } from './tools/get_concept_context.js';
+const TOOL_DEFINITIONS = [
+    {
+        name: 'list_tables',
+        description: 'List tables with their labels and descriptions',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                schema: { type: 'string', description: 'Target schema (default: public)' },
+                includeSystem: { type: 'boolean', description: 'Include system schemas (ignored in v0.1)' },
+            },
+        },
+    },
+    {
+        name: 'describe_table',
+        description: 'Return the full schema + COMMENT for the given table',
+        inputSchema: {
+            type: 'object',
+            properties: { qualifiedName: { type: 'string', description: 'e.g. public.users' } },
+            required: ['qualifiedName'],
+        },
+    },
+    {
+        name: 'list_views',
+        description: 'List views with their labels and purposes',
+        inputSchema: {
+            type: 'object',
+            properties: { schema: { type: 'string', description: 'Target schema (default: public)' } },
+        },
+    },
+    {
+        name: 'describe_view',
+        description: 'Return columns + purpose + underlying tables + definition for the given view',
+        inputSchema: {
+            type: 'object',
+            properties: { qualifiedName: { type: 'string', description: 'e.g. public.vw_active_users' } },
+            required: ['qualifiedName'],
+        },
+    },
+    {
+        name: 'list_concepts',
+        description: 'List domain concepts (each backed by a VIEW)',
+        inputSchema: { type: 'object', properties: {} },
+    },
+    {
+        name: 'get_concept_context',
+        description: 'Return related tables + recommended query path for the given concept',
+        inputSchema: {
+            type: 'object',
+            properties: { name: { type: 'string', description: 'Matches the VIEW name' } },
+            required: ['name'],
+        },
+    },
+];
+function successResult(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] };
+}
+function errorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: 'text', text: message }],
+    };
+}
+export function createMcpServer(cache) {
+    const server = new Server({ name: 'kozou', version: '0.1.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => Promise.resolve({ tools: TOOL_DEFINITIONS.map((t) => ({ ...t })) }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const name = request.params.name;
+        const args = (request.params.arguments ?? {});
+        try {
+            const ctx = await cache.get();
+            switch (name) {
+                case 'list_tables':
+                    return successResult(listTables(args, ctx));
+                case 'describe_table':
+                    return successResult(describeTable(args, ctx));
+                case 'list_views':
+                    return successResult(listViews(args, ctx));
+                case 'describe_view':
+                    return successResult(describeView(args, ctx));
+                case 'list_concepts':
+                    return successResult(listConcepts(args, ctx));
+                case 'get_concept_context':
+                    return successResult(getConceptContext(args, ctx));
+                default:
+                    return errorResult(`Unknown tool: ${name}`);
+            }
+        }
+        catch (err) {
+            const dev = process.env.KOZOU_DEV === '1';
+            const msg = err instanceof Error ? err.message : String(err);
+            const detail = dev && err instanceof Error && err.stack ? `\n${err.stack}` : '';
+            return errorResult(`${msg}${detail}`);
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/startStdioServer.d.ts

@@ -0,0 +1,14 @@
+import type { SchemaCache } from './schemaCache.js';
+export type StartStdioServerOptions = {
+    /** Prefix used in stderr log lines. Default: '[@kozou/mcp]'. */
+    logPrefix?: string;
+};
+/**
+ * Start the MCP server bound to the given SchemaCache, using a stdio
+ * transport. Installs a SIGHUP handler that invalidates the cache, so
+ * adopters can refresh the schema without restarting the process.
+ *
+ * Resolves once the underlying transport finishes connecting.
+ */
+export declare function startStdioServer(cache: SchemaCache, opts?: StartStdioServerOptions): Promise<void>;
+//# sourceMappingURL=startStdioServer.d.ts.map

package/dist/startStdioServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startStdioServer.d.ts","sourceRoot":"","sources":["../src/startStdioServer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,WAAW,EAClB,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/startStdioServer.js

@@ -0,0 +1,25 @@
+// Convenience helper to start an MCP server with the stdio transport.
+//
+// This lives in @kozou/mcp so callers (the bundled kozou CLI as well as
+// adopters embedding the MCP server in their own scripts) do not need to
+// depend on @modelcontextprotocol/sdk directly.
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createMcpServer } from './server.js';
+/**
+ * Start the MCP server bound to the given SchemaCache, using a stdio
+ * transport. Installs a SIGHUP handler that invalidates the cache, so
+ * adopters can refresh the schema without restarting the process.
+ *
+ * Resolves once the underlying transport finishes connecting.
+ */
+export async function startStdioServer(cache, opts = {}) {
+    const prefix = opts.logPrefix ?? '[@kozou/mcp]';
+    const server = createMcpServer(cache);
+    process.on('SIGHUP', () => {
+        cache.invalidate();
+        process.stderr.write(`${prefix} SIGHUP received, cache invalidated\n`);
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=startStdioServer.js.map

package/dist/startStdioServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startStdioServer.js","sourceRoot":"","sources":["../src/startStdioServer.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,gDAAgD;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQ9C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAkB,EAClB,OAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,cAAc,CAAC;IAChD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,KAAK,CAAC,UAAU,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,uCAAuC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/describe_table.d.ts

@@ -0,0 +1,4 @@
+import type { SchemaContext } from '@kozou/core';
+import { type DescribeTableInput, type DescribeTableOutput } from '../schemas/describe_table.js';
+export declare function describeTable(input: DescribeTableInput, ctx: SchemaContext): DescribeTableOutput;
+//# sourceMappingURL=describe_table.d.ts.map

package/dist/tools/describe_table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe_table.d.ts","sourceRoot":"","sources":["../../src/tools/describe_table.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,8BAA8B,CAAC;AAEtC,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,EAAE,aAAa,GAAG,mBAAmB,CA6ChG"}