@a1st/aix-schema 0.0.3

package/dist/skills.d.ts

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+export declare const skillNameSchema: z.ZodString;
+export declare const skillConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    config?: Record<string, unknown> | undefined;
+}, {
+    enabled?: boolean | undefined;
+    config?: Record<string, unknown> | undefined;
+}>;
+export declare const skillRefSchema: z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodObject<{
+    git: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}>, z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>, z.ZodObject<{
+    version: z.ZodEffects<z.ZodString, string, string>;
+    registry: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    registry?: string | undefined;
+}, {
+    version: string;
+    registry?: string | undefined;
+}>]>, z.ZodObject<{
+    source: z.ZodUnion<[z.ZodString, z.ZodObject<{
+        git: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }, {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }>, z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>, z.ZodObject<{
+        version: z.ZodEffects<z.ZodString, string, string>;
+        registry: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        version: string;
+        registry?: string | undefined;
+    }, {
+        version: string;
+        registry?: string | undefined;
+    }>]>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    source: string | {
+        path: string;
+    } | {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | {
+        version: string;
+        registry?: string | undefined;
+    };
+    config?: Record<string, unknown> | undefined;
+}, {
+    source: string | {
+        path: string;
+    } | {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | {
+        version: string;
+        registry?: string | undefined;
+    };
+    enabled?: boolean | undefined;
+    config?: Record<string, unknown> | undefined;
+}>]>;
+export declare const skillsSchema: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodString, z.ZodObject<{
+    git: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}, {
+    git: string;
+    path?: string | undefined;
+    ref?: string | undefined;
+}>, z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>, z.ZodObject<{
+    version: z.ZodEffects<z.ZodString, string, string>;
+    registry: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    registry?: string | undefined;
+}, {
+    version: string;
+    registry?: string | undefined;
+}>]>, z.ZodObject<{
+    source: z.ZodUnion<[z.ZodString, z.ZodObject<{
+        git: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }, {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    }>, z.ZodObject<{
+        path: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+    }, {
+        path: string;
+    }>, z.ZodObject<{
+        version: z.ZodEffects<z.ZodString, string, string>;
+        registry: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        version: string;
+        registry?: string | undefined;
+    }, {
+        version: string;
+        registry?: string | undefined;
+    }>]>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    source: string | {
+        path: string;
+    } | {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | {
+        version: string;
+        registry?: string | undefined;
+    };
+    config?: Record<string, unknown> | undefined;
+}, {
+    source: string | {
+        path: string;
+    } | {
+        git: string;
+        path?: string | undefined;
+        ref?: string | undefined;
+    } | {
+        version: string;
+        registry?: string | undefined;
+    };
+    enabled?: boolean | undefined;
+    config?: Record<string, unknown> | undefined;
+}>]>, z.ZodLiteral<false>]>>;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,aAQ4B,CAAC;AAEzD,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASkC,CAAC;AAE9D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAEuD,CAAC"}

package/dist/skills.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { sourceRefSchema } from './references.js';
+export const skillNameSchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'Skill name must be lowercase alphanumeric with single hyphens (e.g., "pdf-processing")')
+    .describe('Skill name (Agent Skills spec compliant)');
+export const skillConfigSchema = z.object({
+    enabled: z.boolean().default(true).describe('Whether skill is active'),
+    config: z.record(z.unknown()).optional().describe('Skill-specific configuration passed to SKILL.md'),
+});
+export const skillRefSchema = z
+    .union([
+    sourceRefSchema,
+    z.object({
+        source: sourceRefSchema.describe('Where to load the skill from'),
+        enabled: z.boolean().default(true).describe('Whether skill is active'),
+        config: z.record(z.unknown()).optional().describe('Skill-specific configuration'),
+    }),
+])
+    .describe('Skill reference (Agent Skills spec compliant)');
+export const skillsSchema = z
+    .record(skillNameSchema, z.union([skillRefSchema, z.literal(false)]))
+    .describe('Map of skill names to their configurations (or false to disable)');
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACH,0BAA0B,EAC1B,wFAAwF,CAC1F;KACA,QAAQ,CAAC,0CAA0C,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACtE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CACtG,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC3B,KAAK,CAAC;IACJ,eAAe;IACf,CAAC,CAAC,MAAM,CAAC;QACN,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAChE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACtE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KACnF,CAAC;CACJ,CAAC;KACD,QAAQ,CAAC,+CAA+C,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KACzB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KACpE,QAAQ,CAAC,kEAAkE,CAAC,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,17 @@
+import { type AiJsonConfig } from './config.js';
+export interface ValidationResult {
+    success: boolean;
+    data?: AiJsonConfig;
+    errors?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+export declare function validateConfig(input: unknown): ValidationResult;
+export declare function parseConfig(input: unknown): AiJsonConfig;
+/**
+ * Parse and validate a local config (ai.local.json).
+ * Local configs don't allow extends and return a partial config for merging.
+ */
+export declare function parseLocalConfig(input: unknown): Partial<AiJsonConfig>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAGvF,MAAM,WAAW,gBAAgB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACL;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAsB/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAExD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEtE"}

package/dist/validate.js

@@ -0,0 +1,34 @@
+import { aiJsonConfigSchema, localConfigSchema } from './config.js';
+export function validateConfig(input) {
+    try {
+        const data = aiJsonConfigSchema.parse(input);
+        return { success: true, data };
+    }
+    catch (error) {
+        if (error instanceof Error && 'issues' in error) {
+            const zodError = error;
+            return {
+                success: false,
+                errors: zodError.issues.map((issue) => ({
+                    path: issue.path.join('.'),
+                    message: issue.message,
+                })),
+            };
+        }
+        return {
+            success: false,
+            errors: [{ path: '', message: String(error) }],
+        };
+    }
+}
+export function parseConfig(input) {
+    return aiJsonConfigSchema.parse(input);
+}
+/**
+ * Parse and validate a local config (ai.local.json).
+ * Local configs don't allow extends and return a partial config for merging.
+ */
+export function parseLocalConfig(input) {
+    return localConfigSchema.parse(input);
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAqB,MAAM,aAAa,CAAC;AAYvF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC1C,IAAI,CAAC;QACF,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE7C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACd,IAAI,KAAK,YAAY,KAAK,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,KAAiB,CAAC;YAEnC,OAAO;gBACJ,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACrC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;iBACxB,CAAC,CAAC;aACL,CAAC;QACL,CAAC;QACD,OAAO;YACJ,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;SAChD,CAAC;IACL,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACvC,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC5C,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAA0B,CAAC;AAClE,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const SCHEMA_VERSION = "1", SCHEMA_VERSION_FULL = "1.0.0", SCHEMA_BASE_URL = "https://x.a1st.dev/schemas";
+export declare function getSchemaUrl(version?: string): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,MAAM,EACpB,mBAAmB,UAAU,EAC7B,eAAe,+BAA+B,CAAC;AAE5D,wBAAgB,YAAY,CAAC,OAAO,GAAE,MAAuB,GAAG,MAAM,CAErE"}

package/dist/version.js

@@ -0,0 +1,5 @@
+export const SCHEMA_VERSION = '1', SCHEMA_VERSION_FULL = '1.0.0', SCHEMA_BASE_URL = 'https://x.a1st.dev/schemas';
+export function getSchemaUrl(version = SCHEMA_VERSION) {
+    return `${SCHEMA_BASE_URL}/v${version}/ai.json`;
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EACpB,mBAAmB,GAAG,OAAO,EAC7B,eAAe,GAAG,4BAA4B,CAAC;AAE5D,MAAM,UAAU,YAAY,CAAC,UAAkB,cAAc;IAC1D,OAAO,GAAG,eAAe,KAAK,OAAO,UAAU,CAAC;AACnD,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+   "name": "@a1st/aix-schema",
+   "version": "0.0.3",
+   "description": "JSON Schema and validation for aix configuration",
+   "files": [
+      "dist",
+      "schema.json"
+   ],
+   "type": "module",
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": {
+         "types": "./dist/index.d.ts",
+         "import": "./dist/index.js"
+      }
+   },
+   "repository": {
+      "type": "git",
+      "url": "https://github.com/a1st-dev/aix.git",
+      "directory": "packages/schema"
+   },
+   "publishConfig": {
+      "access": "public",
+      "registry": "https://registry.npmjs.org/"
+   },
+   "scripts": {
+      "build": "tsc -p tsconfig.build.json && npm run generate-schema",
+      "generate-schema": "node --import=@poppinss/ts-exec scripts/generate-schema.ts",
+      "test": "vitest run",
+      "test:watch": "vitest"
+   },
+   "dependencies": {
+      "compare-versions": "6.1.1",
+      "jsonc-parser": "3.3.1",
+      "zod": "3.24.1",
+      "zod-to-json-schema": "3.24.1"
+   },
+   "devDependencies": {
+      "@poppinss/ts-exec": "1.4.1"
+   }
+}