@kozou/mcp 0.1.0 → 0.2.0

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { SchemaCache } from './schemaCache.js';
 import { startStdioServer } from './startStdioServer.js';
+import { startHttpServer } from './startHttpServer.js';
 function parseEnvNumber(value, fallback) {
     if (value === undefined)
         return fallback;
@@ -11,6 +12,35 @@ function parseEnvNumber(value, fallback) {
     }
     return n;
 }
+function parseArgs(argv) {
+    const args = { mode: 'stdio' };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--http':
+                args.mode = 'http';
+                break;
+            case '--stdio':
+                args.mode = 'stdio';
+                break;
+            case '--port':
+                args.port = Number(argv[++i]);
+                break;
+            case '--host':
+                args.host = argv[++i];
+                break;
+            default:
+                if (arg.startsWith('--port=')) {
+                    args.port = Number(arg.slice('--port='.length));
+                }
+                else if (arg.startsWith('--host=')) {
+                    args.host = arg.slice('--host='.length);
+                }
+            // Unknown flags are ignored so adopters can pass through extras.
+        }
+    }
+    return args;
+}
 async function main() {
     const connectionString = process.env.KOZOU_DATABASE_URL;
     if (!connectionString) {
@@ -21,6 +51,15 @@ async function main() {
         connection: connectionString,
         ttlMs: parseEnvNumber(process.env.KOZOU_CACHE_TTL_MS, 60_000),
     });
+    const args = parseArgs(process.argv.slice(2));
+    if (args.mode === 'http') {
+        if (args.port !== undefined && (!Number.isFinite(args.port) || args.port < 0)) {
+            console.error(`[@kozou/mcp] invalid --port "${args.port}"`);
+            process.exit(1);
+        }
+        await startHttpServer(cache, { port: args.port, host: args.host });
+        return;
+    }
     await startStdioServer(cache);
 }
 main().catch((err) => {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,SAAS,cAAc,CAAC,KAAyB,EAAE,QAAgB;IACjE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,oCAAoC,KAAK,kBAAkB,QAAQ,EAAE,CAAC,CAAC;QACrF,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC5B,UAAU,EAAE,gBAAgB;QAC5B,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC;KAC9D,CAAC,CAAC;IACH,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { createMcpServer } from './server.js';
 export { SchemaCache, type SchemaCacheOptions } from './schemaCache.js';
 export { startStdioServer, type StartStdioServerOptions } from './startStdioServer.js';
+export { startHttpServer, isLoopbackHost, type StartHttpServerOptions, type HttpServerHandle, } from './startHttpServer.js';
 export { listTables } from './tools/list_tables.js';
 export { describeTable } from './tools/describe_table.js';
 export { listViews } from './tools/list_views.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,eAAe,EACf,cAAc,EACd,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@
 export { createMcpServer } from './server.js';
 export { SchemaCache } from './schemaCache.js';
 export { startStdioServer } from './startStdioServer.js';
+export { startHttpServer, isLoopbackHost, } from './startHttpServer.js';
 export { listTables } from './tools/list_tables.js';
 export { describeTable } from './tools/describe_table.js';
 export { listViews } from './tools/list_views.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,oEAAoE;AACpE,qCAAqC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,oEAAoE;AACpE,qCAAqC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAA2B,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,uBAAuB,CAAC;AACvF,OAAO,EACL,eAAe,EACf,cAAc,GAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC"}

package/dist/schemas/describe_table.d.ts

@@ -1,11 +1,7 @@
 import { z } from 'zod';
 export declare const describeTableInputSchema: z.ZodObject<{
     qualifiedName: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    qualifiedName: string;
-}, {
-    qualifiedName: string;
-}>;
+}, z.core.$strip>;
 declare const columnSchema: z.ZodObject<{
     name: z.ZodString;
     dataType: z.ZodString;
@@ -13,51 +9,21 @@ declare const columnSchema: z.ZodObject<{
     defaultExpr: z.ZodNullable<z.ZodString>;
     description: z.ZodNullable<z.ZodString>;
     aiDescription: z.ZodNullable<z.ZodString>;
-    enumValues: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+    policy: z.ZodArray<z.ZodString>;
+    enumValues: z.ZodNullable<z.ZodArray<z.ZodString>>;
     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;
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export declare const describeTableOutputSchema: z.ZodObject<{
     qualifiedName: z.ZodString;
     label: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     aiDescription: z.ZodNullable<z.ZodString>;
-    primaryKey: z.ZodArray<z.ZodString, "many">;
+    policy: z.ZodArray<z.ZodString>;
+    primaryKey: z.ZodArray<z.ZodString>;
     columns: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         dataType: z.ZodString;
@@ -65,132 +31,25 @@ export declare const describeTableOutputSchema: z.ZodObject<{
         defaultExpr: z.ZodNullable<z.ZodString>;
         description: z.ZodNullable<z.ZodString>;
         aiDescription: z.ZodNullable<z.ZodString>;
-        enumValues: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+        policy: z.ZodArray<z.ZodString>;
+        enumValues: z.ZodNullable<z.ZodArray<z.ZodString>>;
         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">;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     relations: z.ZodArray<z.ZodObject<{
         field: z.ZodString;
         referencesTable: z.ZodString;
         referencesColumn: z.ZodString;
         meaning: z.ZodNullable<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        field: string;
-        referencesTable: string;
-        referencesColumn: string;
-        meaning: string | null;
-    }, {
-        field: string;
-        referencesTable: string;
-        referencesColumn: string;
-        meaning: string | null;
-    }>, "many">;
+    }, z.core.$strip>>;
     checkConstraints: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         expression: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        expression: string;
-    }, {
-        name: string;
-        expression: string;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    qualifiedName: string;
-    label: string;
-    description: string | null;
-    aiDescription: string | null;
-    primaryKey: string[];
-    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;
-    }[];
-    relations: {
-        field: string;
-        referencesTable: string;
-        referencesColumn: string;
-        meaning: string | null;
-    }[];
-    checkConstraints: {
-        name: string;
-        expression: string;
-    }[];
-}, {
-    qualifiedName: string;
-    label: string;
-    description: string | null;
-    aiDescription: string | null;
-    primaryKey: string[];
-    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;
-    }[];
-    relations: {
-        field: string;
-        referencesTable: string;
-        referencesColumn: string;
-        meaning: string | null;
-    }[];
-    checkConstraints: {
-        name: string;
-        expression: string;
-    }[];
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 export type DescribeTableInput = z.infer<typeof describeTableInputSchema>;
 export type DescribeTableOutput = z.infer<typeof describeTableOutputSchema>;
 export type DescribeTableColumn = z.infer<typeof columnSchema>;

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

@@ -1 +1 @@
-{"version":3,"file":"describe_table.d.ts","sourceRoot":"","sources":["../../src/schemas/describe_table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;EAEnC,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAehB,CAAC;AAcH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASpC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"describe_table.d.ts","sourceRoot":"","sources":["../../src/schemas/describe_table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;iBAEnC,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;iBAiBhB,CAAC;AAcH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAWpC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/schemas/describe_table.js

@@ -9,6 +9,8 @@ const columnSchema = z.object({
     defaultExpr: z.string().nullable(),
     description: z.string().nullable(),
     aiDescription: z.string().nullable(),
+    /** `@policy:` lines — advisory business rules for the AI agent. */
+    policy: z.array(z.string()),
     enumValues: z.array(z.string()).nullable(),
     isForeignKey: z.boolean(),
     references: z
@@ -33,6 +35,8 @@ export const describeTableOutputSchema = z.object({
     label: z.string(),
     description: z.string().nullable(),
     aiDescription: z.string().nullable(),
+    /** `@policy:` lines on the table COMMENT — advisory, surfaced to the AI agent. */
+    policy: z.array(z.string()),
     primaryKey: z.array(z.string()),
     columns: z.array(columnSchema),
     relations: z.array(relationSchema),

package/dist/schemas/describe_table.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe_table.js","sourceRoot":"","sources":["../../src/schemas/describe_table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,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,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,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,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAClC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACjD,CAAC,CAAC"}
+{"version":3,"file":"describe_table.js","sourceRoot":"","sources":["../../src/schemas/describe_table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,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,mEAAmE;IACnE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,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,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,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,kFAAkF;IAClF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAClC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACjD,CAAC,CAAC"}

package/dist/schemas/describe_view.d.ts

@@ -1,16 +1,13 @@
 import { z } from 'zod';
 export declare const describeViewInputSchema: z.ZodObject<{
     qualifiedName: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    qualifiedName: string;
-}, {
-    qualifiedName: string;
-}>;
+}, z.core.$strip>;
 export declare const describeViewOutputSchema: z.ZodObject<{
     qualifiedName: z.ZodString;
     label: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
     aiDescription: z.ZodNullable<z.ZodString>;
+    policy: z.ZodArray<z.ZodString>;
     columns: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         dataType: z.ZodString;
@@ -18,90 +15,17 @@ export declare const describeViewOutputSchema: z.ZodObject<{
         defaultExpr: z.ZodNullable<z.ZodString>;
         description: z.ZodNullable<z.ZodString>;
         aiDescription: z.ZodNullable<z.ZodString>;
-        enumValues: z.ZodNullable<z.ZodArray<z.ZodString, "many">>;
+        policy: z.ZodArray<z.ZodString>;
+        enumValues: z.ZodNullable<z.ZodArray<z.ZodString>>;
         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">;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    underlyingTables: z.ZodArray<z.ZodString>;
     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;
-}>;
+}, z.core.$strip>;
 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

@@ -1 +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"}
+{"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;;iBAElC,CAAC;AAqBH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;iBAUnC,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

@@ -9,6 +9,8 @@ const viewColumnSchema = z.object({
     defaultExpr: z.string().nullable(),
     description: z.string().nullable(),
     aiDescription: z.string().nullable(),
+    /** `@policy:` lines — advisory business rules for the AI agent. */
+    policy: z.array(z.string()),
     enumValues: z.array(z.string()).nullable(),
     isForeignKey: z.boolean(),
     references: z
@@ -23,6 +25,8 @@ export const describeViewOutputSchema = z.object({
     label: z.string(),
     description: z.string().nullable(),
     aiDescription: z.string().nullable(),
+    /** `@policy:` lines on the view COMMENT — advisory, surfaced to the AI agent. */
+    policy: z.array(z.string()),
     columns: z.array(viewColumnSchema),
     underlyingTables: z.array(z.string()),
     definition: z.string(),

package/dist/schemas/describe_view.js.map

@@ -1 +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"}
+{"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,mEAAmE;IACnE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,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,iFAAiF;IACjF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,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

@@ -1,74 +1,25 @@
 import { z } from 'zod';
 export declare const getConceptContextInputSchema: z.ZodObject<{
     name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-}, {
-    name: string;
-}>;
+}, z.core.$strip>;
 export declare const getConceptContextOutputSchema: z.ZodObject<{
     name: z.ZodString;
     label: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
-    aiNotes: z.ZodArray<z.ZodString, "many">;
+    aiNotes: z.ZodArray<z.ZodString>;
+    policies: z.ZodArray<z.ZodString>;
     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">;
+    }, z.core.$strip>>;
+    relatedTables: z.ZodArray<z.ZodString>;
     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;
-    }[];
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 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

@@ -1 +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"}
+{"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;;iBAEvC,CAAC;AAaH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;iBAWxC,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

@@ -16,6 +16,8 @@ export const getConceptContextOutputSchema = z.object({
     label: z.string(),
     description: z.string().nullable(),
     aiNotes: z.array(z.string()),
+    /** `@policy:` lines on the concept's VIEW COMMENT — advisory, surfaced to the AI agent. */
+    policies: z.array(z.string()),
     preferredQuerySource: z.string(),
     joinSuggestions: z.array(joinSuggestionSchema),
     relatedTables: z.array(z.string()),

package/dist/schemas/get_concept_context.js.map

@@ -1 +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"}
+{"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,2FAA2F;IAC3F,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,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

@@ -1,37 +1,13 @@
 import { z } from 'zod';
-export declare const listConceptsInputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare const listConceptsInputSchema: z.ZodObject<{}, z.core.$strict>;
 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";
-    }[];
-}>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 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

@@ -1 +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"}
+{"version":3,"file":"list_concepts.d.ts","sourceRoot":"","sources":["../../src/schemas/list_concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB,iCAAqB,CAAC;AAE1D,eAAO,MAAM,wBAAwB;;;;;;;iBASnC,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

@@ -1,5 +1,9 @@
 import { z } from 'zod';
-export const listConceptsInputSchema = z.object({}).strict();
+// No inputs; reject any extra fields. zod 4 infers a strict empty object as
+// `Record<string, never>`, so the tool fn takes the raw `Record<string,
+// unknown>` args and validates them through this schema rather than typing
+// its parameter as the inferred (and unassignable) empty-object type.
+export const listConceptsInputSchema = z.strictObject({});
 export const listConceptsOutputSchema = z.object({
     concepts: z.array(z.object({
         name: z.string(),