n8n 2.46.3 → 2.47.0

package/dist/modules/skills/services/skills-telemetry.service.d.ts

@@ -0,0 +1,38 @@
+import { Logger } from '@n8n/backend-common';
+import { TELEMETRY_EVENT, type InferTelemetryProps } from '@n8n/telemetry';
+import { Telemetry } from '../../../telemetry';
+import type { Skill, SkillSource } from '../database/entities/skill.entity';
+import { SkillRepository } from '../database/repositories/skill.repository';
+export type SkillTelemetrySource = Exclude<SkillSource, 'import'>;
+export type SkillTelemetryMethod = 'manual' | 'upload' | 'ai' | 'sync';
+export type SkillTelemetryOrigin = {
+    source_provider: ConnectedSourceProps['provider'];
+    source_access: ConnectedSourceProps['access'];
+};
+type ConnectedSourceProps = InferTelemetryProps<typeof TELEMETRY_EVENT.CONTEXT.USER_CONNECTED_SKILL_SOURCE>;
+type ImportedFromSourceProps = InferTelemetryProps<typeof TELEMETRY_EVENT.CONTEXT.USER_IMPORTED_SKILLS_FROM_SOURCE>;
+export type SkillSourceTelemetryReason = NonNullable<ConnectedSourceProps['reason']>;
+type FlaggedSkillProps = InferTelemetryProps<typeof TELEMETRY_EVENT.CONTEXT.SKILL_SOURCE_CHECK_FLAGGED_SKILL>;
+type StoppedSyncProps = InferTelemetryProps<typeof TELEMETRY_EVENT.CONTEXT.USER_STOPPED_SKILL_SYNC>;
+type UpdateFoundProps = InferTelemetryProps<typeof TELEMETRY_EVENT.CONTEXT.SKILL_SOURCE_UPDATE_FOUND>;
+type CheckedNowProps = InferTelemetryProps<typeof TELEMETRY_EVENT.CONTEXT.USER_CHECKED_SKILL_SOURCE_NOW>;
+type SkillTelemetryTarget = Pick<Skill, 'id' | 'projectId'>;
+export type SkillTelemetryRef = SkillTelemetryTarget | string;
+export declare class SkillsTelemetry {
+    private readonly telemetry;
+    private readonly skillRepository;
+    private readonly logger;
+    constructor(telemetry: Telemetry, skillRepository: SkillRepository, logger: Logger);
+    created(userId: string, refs: SkillTelemetryRef[], source: SkillTelemetrySource, method: SkillTelemetryMethod, origin?: SkillTelemetryOrigin): Promise<void>;
+    updated(userId: string, ref: SkillTelemetryRef, source: SkillTelemetrySource, version: number, scopeChanged: boolean): Promise<void>;
+    deleted(userId: string, skill: SkillTelemetryTarget, source: SkillTelemetrySource): Promise<void>;
+    connectedSource(props: Omit<ConnectedSourceProps, 'user_id'>, userId: string): Promise<void>;
+    importedFromSource(props: Omit<ImportedFromSourceProps, 'user_id'>, userId: string): Promise<void>;
+    flaggedSkill(props: Omit<FlaggedSkillProps, 'user_id'>, userId?: string): Promise<void>;
+    stoppedSync(props: Omit<StoppedSyncProps, 'user_id'>, userId: string): Promise<void>;
+    updateFound(props: UpdateFoundProps): Promise<void>;
+    checkedNow(props: Omit<CheckedNowProps, 'user_id'>, userId: string): Promise<void>;
+    private resolve;
+    private safely;
+}
+export {};

package/dist/modules/skills/{skills-telemetry.js → services/skills-telemetry.service.js}

@@ -14,20 +14,17 @@ const backend_common_1 = require("@n8n/backend-common");
 const di_1 = require("@n8n/di");
 const telemetry_1 = require("@n8n/telemetry");
 const ensure_error_1 = require("@n8n/utils/errors/ensure-error");
-const telemetry_2 = require("../../telemetry");
-const skill_agents_proxy_service_1 = require("./skill-agents-proxy.service");
-const skill_repository_1 = require("./skill.repository");
+const telemetry_2 = require("../../../telemetry");
+const skill_repository_1 = require("../database/repositories/skill.repository");
 let SkillsTelemetry = class SkillsTelemetry {
-    constructor(telemetry, skillRepository, logger, skillAgents) {
+    constructor(telemetry, skillRepository, logger) {
         this.telemetry = telemetry;
         this.skillRepository = skillRepository;
         this.logger = logger;
-        this.skillAgents = skillAgents;
     }
-    async created(userId, refs, source, method) {
+    async created(userId, refs, source, method, origin) {
         await this.safely(async () => {
             const skills = await this.resolve(refs);
-            const placeOf = await this.placeResolver(skills);
             for (const skill of skills) {
                 this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_CREATED_SKILL, {
                     user_id: userId,
@@ -35,6 +32,7 @@ let SkillsTelemetry = class SkillsTelemetry {
                     ...placeOf(skill),
                     source,
                     method,
+                    ...origin,
                 });
             }
         });
@@ -44,7 +42,6 @@ let SkillsTelemetry = class SkillsTelemetry {
             const [skill] = await this.resolve([ref]);
             if (!skill)
                 return;
-            const placeOf = await this.placeResolver([skill]);
             this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_UPDATED_SKILL, {
                 user_id: userId,
                 skill_id: skill.id,
@@ -57,7 +54,6 @@ let SkillsTelemetry = class SkillsTelemetry {
     }
     async deleted(userId, skill, source) {
         await this.safely(async () => {
-            const placeOf = await this.placeResolver([skill]);
             this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_DELETED_SKILL, {
                 user_id: userId,
                 skill_id: skill.id,
@@ -66,23 +62,56 @@ let SkillsTelemetry = class SkillsTelemetry {
             });
         });
     }
+    async connectedSource(props, userId) {
+        await this.safely(async () => {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_CONNECTED_SKILL_SOURCE, {
+                user_id: userId,
+                ...props,
+            });
+        });
+    }
+    async importedFromSource(props, userId) {
+        await this.safely(async () => {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_IMPORTED_SKILLS_FROM_SOURCE, {
+                user_id: userId,
+                ...props,
+            });
+        });
+    }
+    async flaggedSkill(props, userId) {
+        await this.safely(async () => {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.SKILL_SOURCE_CHECK_FLAGGED_SKILL, {
+                ...(userId ? { user_id: userId } : {}),
+                ...props,
+            });
+        });
+    }
+    async stoppedSync(props, userId) {
+        await this.safely(async () => {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_STOPPED_SKILL_SYNC, {
+                user_id: userId,
+                ...props,
+            });
+        });
+    }
+    async updateFound(props) {
+        await this.safely(async () => {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.SKILL_SOURCE_UPDATE_FOUND, props);
+        });
+    }
+    async checkedNow(props, userId) {
+        await this.safely(async () => {
+            this.telemetry.track(telemetry_1.TELEMETRY_EVENT.CONTEXT.USER_CHECKED_SKILL_SOURCE_NOW, {
+                user_id: userId,
+                ...props,
+            });
+        });
+    }
     async resolve(refs) {
         const ids = refs.filter((ref) => typeof ref === 'string');
         const read = ids.length > 0 ? await this.skillRepository.findByIds(ids) : [];
         return [...refs.filter((ref) => typeof ref !== 'string'), ...read];
     }
-    async placeResolver(skills) {
-        const agents = await this.skillAgents.findAgents(skills.flatMap((skill) => (skill.agentId ? [skill.agentId] : [])));
-        return (skill) => {
-            if (skill.agentId) {
-                const projectId = agents.get(skill.agentId)?.projectId;
-                return { scope: 'agent', ...(projectId ? { project_id: projectId } : {}) };
-            }
-            if (skill.projectId)
-                return { scope: 'project', project_id: skill.projectId };
-            return { scope: 'instance' };
-        };
-    }
     async safely(emit) {
         try {
             await emit();
@@ -95,6 +124,11 @@ let SkillsTelemetry = class SkillsTelemetry {
 exports.SkillsTelemetry = SkillsTelemetry;
 exports.SkillsTelemetry = SkillsTelemetry = __decorate([
     (0, di_1.Service)(),
-    __metadata("design:paramtypes", [telemetry_2.Telemetry, skill_repository_1.SkillRepository, backend_common_1.Logger, skill_agents_proxy_service_1.SkillAgentsProxy])
+    __metadata("design:paramtypes", [telemetry_2.Telemetry, skill_repository_1.SkillRepository, backend_common_1.Logger])
 ], SkillsTelemetry);
-//# sourceMappingURL=skills-telemetry.js.map
+function placeOf(skill) {
+    return skill.projectId
+        ? { scope: 'project', project_id: skill.projectId }
+        : { scope: 'instance' };
+}
+//# sourceMappingURL=skills-telemetry.service.js.map

package/dist/modules/skills/services/skills-telemetry.service.js.map

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

package/dist/modules/skills/skill-sync.config.d.ts

@@ -0,0 +1,3 @@
+export declare class SkillSyncConfig {
+    checkIntervalSeconds: number;
+}

package/dist/modules/skills/skill-sync.config.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillSyncConfig = void 0;
+const config_1 = require("@n8n/config");
+const zod_1 = require("zod");
+let SkillSyncConfig = class SkillSyncConfig {
+    constructor() {
+        this.checkIntervalSeconds = 3600;
+    }
+};
+exports.SkillSyncConfig = SkillSyncConfig;
+__decorate([
+    (0, config_1.Env)('N8N_SKILL_SYNC_CHECK_INTERVAL_SECONDS', zod_1.z.number({ coerce: true }).int().min(60)),
+    __metadata("design:type", Number)
+], SkillSyncConfig.prototype, "checkIntervalSeconds", void 0);
+exports.SkillSyncConfig = SkillSyncConfig = __decorate([
+    config_1.Config
+], SkillSyncConfig);
+//# sourceMappingURL=skill-sync.config.js.map

package/dist/modules/skills/skill-sync.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-sync.config.js","sourceRoot":"","sources":["../../../src/modules/skills/skill-sync.config.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,wCAA0C;AAC1C,6BAAwB;AAIjB,IAAM,eAAe,GAArB,MAAM,eAAe;IAArB;QAGN,yBAAoB,GAAW,IAAI,CAAC;IACrC,CAAC;CAAA,CAAA;;AADA;IADC,IAAA,YAAG,EAAC,uCAAuC,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;;6DACnD;0BAHxB,eAAe;IAD3B,eAAM;GACM,eAAe,CAI3B"}

package/dist/modules/skills/skills.module.d.ts

@@ -1,5 +1,6 @@
 import type { ModuleInterface } from '@n8n/decorators';
 export declare class SkillsModule implements ModuleInterface {
     init(): Promise<void>;
-    entities(): Promise<(typeof import("./skill-version.entity.js").SkillVersion | typeof import("./skill-file.entity.js").SkillFile | typeof import("./skill.entity.js").Skill)[]>;
+    systemTasks(): Promise<typeof import("./services/skill-source-check.task.js").SkillSourceCheckTask[]>;
+    entities(): Promise<(typeof import("./database/entities/skill-version.entity.js").SkillVersion | typeof import("./database/entities/skill.entity.js").Skill | typeof import("./database/entities/skill-source-connection.entity.js").SkillSourceConnection | typeof import("./database/entities/skill-source-link.entity.js").SkillSourceLink | typeof import("./database/entities/skill-file.entity.js").SkillFile)[]>;
 }

package/dist/modules/skills/skills.module.js

@@ -11,16 +11,23 @@ const decorators_1 = require("@n8n/decorators");
 const di_1 = require("@n8n/di");
 let SkillsModule = class SkillsModule {
     async init() {
-        const { AssistantSkillProviderProxy } = await import('@n8n/backend-services');
-        const { HubAssistantSkillProvider } = await import('./hub-assistant-skill-provider.service.js');
-        di_1.Container.get(AssistantSkillProviderProxy).registerProvider(di_1.Container.get(HubAssistantSkillProvider));
-        await import('./skills.controller.js');
+        await import('./controllers/skills.controller.js');
+        await import('./controllers/skill-source.controller.js');
+        const { SkillSourceClientRegistry } = await import('./sources/skill-source-client-registry.service.js');
+        const { GitHubSkillSourceClient } = await import('./sources/github/github-skill-source-client.js');
+        di_1.Container.get(SkillSourceClientRegistry).register(di_1.Container.get(GitHubSkillSourceClient));
+    }
+    async systemTasks() {
+        const { SkillSourceCheckTask } = await import('./services/skill-source-check.task.js');
+        return [SkillSourceCheckTask];
     }
     async entities() {
-        const { Skill } = await import('./skill.entity.js');
-        const { SkillVersion } = await import('./skill-version.entity.js');
-        const { SkillFile } = await import('./skill-file.entity.js');
-        return [Skill, SkillVersion, SkillFile];
+        const { Skill } = await import('./database/entities/skill.entity.js');
+        const { SkillVersion } = await import('./database/entities/skill-version.entity.js');
+        const { SkillFile } = await import('./database/entities/skill-file.entity.js');
+        const { SkillSourceConnection } = await import('./database/entities/skill-source-connection.entity.js');
+        const { SkillSourceLink } = await import('./database/entities/skill-source-link.entity.js');
+        return [Skill, SkillVersion, SkillFile, SkillSourceConnection, SkillSourceLink];
     }
 };
 exports.SkillsModule = SkillsModule;

package/dist/modules/skills/skills.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.module.js","sourceRoot":"","sources":["../../../src/modules/skills/skills.module.ts"],"names":[],"mappings":";;;;;;;;;AACA,gDAAgD;AAChD,gCAAoC;AAQ7B,IAAM,YAAY,GAAlB,MAAM,YAAY;IACxB,KAAK,CAAC,IAAI;QAET,MAAM,EAAE,2BAA2B,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC9E,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;QAChG,cAAS,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC,gBAAgB,CAC1D,cAAS,CAAC,GAAG,CAAC,yBAAyB,CAAC,CACxC,CAAC;QAEF,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACpD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACnE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAE7D,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACzC,CAAC;CACD,CAAA;;uBAnBY,YAAY;IADxB,IAAA,0BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;GACrB,YAAY,CAmBxB"}
+{"version":3,"file":"skills.module.js","sourceRoot":"","sources":["../../../src/modules/skills/skills.module.ts"],"names":[],"mappings":";;;;;;;;;AACA,gDAAgD;AAChD,gCAAoC;AAQ7B,IAAM,YAAY,GAAlB,MAAM,YAAY;IACxB,KAAK,CAAC,IAAI;QACT,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAC;QACnD,MAAM,MAAM,CAAC,0CAA0C,CAAC,CAAC;QAEzD,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CACjD,mDAAmD,CACnD,CAAC;QACF,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAC/C,gDAAgD,CAChD,CAAC;QACF,cAAS,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,QAAQ,CAAC,cAAS,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC3F,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;QACvF,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ;QACb,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;QACtE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,6CAA6C,CAAC,CAAC;QACrF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,0CAA0C,CAAC,CAAC;QAC/E,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAC7C,uDAAuD,CACvD,CAAC;QACF,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,iDAAiD,CAAC,CAAC;QAE5F,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,eAAe,CAAC,CAAC;IACjF,CAAC;CACD,CAAA;;uBA9BY,YAAY;IADxB,IAAA,0BAAa,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;GACrB,YAAY,CA8BxB"}

package/dist/modules/skills/sources/github/git-refs.d.ts

@@ -0,0 +1,7 @@
+export type GitRefs = {
+    defaultBranch: string | undefined;
+    branches: Map<string, string>;
+};
+export declare function lsRefsRequestBody(): Buffer;
+export declare function parseLsRefsResponse(body: Buffer): GitRefs;
+export declare function pktLine(data: string): string;

package/dist/modules/skills/sources/github/git-refs.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lsRefsRequestBody = lsRefsRequestBody;
+exports.parseLsRefsResponse = parseLsRefsResponse;
+exports.pktLine = pktLine;
+const BRANCH_PREFIX = 'refs/heads/';
+function lsRefsRequestBody() {
+    return Buffer.from(pktLine('command=ls-refs\n') +
+        '0001' +
+        pktLine('symrefs\n') +
+        pktLine(`ref-prefix ${BRANCH_PREFIX}\n`) +
+        pktLine('ref-prefix HEAD\n') +
+        '0000');
+}
+function parseLsRefsResponse(body) {
+    const branches = new Map();
+    let defaultBranch;
+    for (const line of readPktLines(body)) {
+        const [sha, ref, ...attributes] = line.trimEnd().split(' ');
+        if (!sha || !ref || !/^[0-9a-f]{40,64}$/.test(sha))
+            continue;
+        if (ref === 'HEAD') {
+            const target = attributes.find((attribute) => attribute.startsWith('symref-target:'));
+            const name = target?.slice('symref-target:'.length);
+            if (name?.startsWith(BRANCH_PREFIX))
+                defaultBranch = name.slice(BRANCH_PREFIX.length);
+        }
+        else if (ref.startsWith(BRANCH_PREFIX)) {
+            branches.set(ref.slice(BRANCH_PREFIX.length), sha);
+        }
+    }
+    return { defaultBranch, branches };
+}
+function pktLine(data) {
+    return (Buffer.byteLength(data) + 4).toString(16).padStart(4, '0') + data;
+}
+function readPktLines(body) {
+    const lines = [];
+    let offset = 0;
+    while (offset < body.length) {
+        const header = body.subarray(offset, offset + 4).toString('ascii');
+        if (!/^[0-9a-f]{4}$/i.test(header))
+            throw new Error('Not a git pkt-line answer');
+        const length = Number.parseInt(header, 16);
+        if (length < 3) {
+            offset += 4;
+            continue;
+        }
+        if (length === 3 || offset + length > body.length) {
+            throw new Error('Not a git pkt-line answer');
+        }
+        lines.push(body.subarray(offset + 4, offset + length).toString('utf8'));
+        offset += length;
+    }
+    return lines;
+}
+//# sourceMappingURL=git-refs.js.map

package/dist/modules/skills/sources/github/git-refs.js.map

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

package/dist/modules/skills/sources/github/github-archive.d.ts

@@ -0,0 +1,20 @@
+import type { Readable } from 'node:stream';
+export type ArchiveLimits = {
+    maxDownloadBytes: number;
+    maxEntries: number;
+    maxUncompressedBytes: number;
+    maxTextBytes: number;
+    maxTextFileBytes: number;
+};
+export declare const DEFAULT_ARCHIVE_LIMITS: ArchiveLimits;
+export type RepositoryArchive = {
+    paths: string[];
+    text: Map<string, string>;
+    oversized: Set<string>;
+};
+export declare function archiveSize(archive: RepositoryArchive): number;
+export declare function readRepositoryArchive(source: Readable, options?: {
+    root?: string;
+    signal?: AbortSignal;
+    limits?: ArchiveLimits;
+}): Promise<RepositoryArchive>;

package/dist/modules/skills/sources/github/github-archive.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ARCHIVE_LIMITS = void 0;
+exports.archiveSize = archiveSize;
+exports.readRepositoryArchive = readRepositoryArchive;
+const tar_1 = require("tar");
+const skill_discovery_1 = require("./skill-discovery");
+const skill_source_read_error_1 = require("../../errors/skill-source-read.error");
+exports.DEFAULT_ARCHIVE_LIMITS = {
+    maxDownloadBytes: 512 * 1024 * 1024,
+    maxEntries: 50_000,
+    maxUncompressedBytes: 200 * 1024 * 1024,
+    maxTextBytes: 20 * 1024 * 1024,
+    maxTextFileBytes: 1024 * 1024,
+};
+function archiveSize(archive) {
+    let bytes = 0;
+    for (const path of archive.paths)
+        bytes += path.length;
+    for (const text of archive.text.values())
+        bytes += text.length;
+    return bytes;
+}
+function tooLarge(root) {
+    return new skill_source_read_error_1.SkillSourceReadError('archive_too_large', root === ''
+        ? 'The repository is too large for n8n to read. Link to the folder of the skills.'
+        : 'The folder is too large for n8n to read. Link to a smaller folder.');
+}
+async function readRepositoryArchive(source, options = {}) {
+    const { root = '', signal, limits = exports.DEFAULT_ARCHIVE_LIMITS } = options;
+    const paths = [];
+    const text = new Map();
+    const oversized = new Set();
+    let downloaded = 0;
+    let entries = 0;
+    let bytes = 0;
+    let textBytes = 0;
+    return await new Promise((resolve, reject) => {
+        let settled = false;
+        const parser = new tar_1.Parser({ strict: true });
+        const onAbort = () => fail(new skill_source_read_error_1.SkillSourceReadError('unreachable', 'GitHub took too long to send the files.'));
+        const settle = () => {
+            settled = true;
+            signal?.removeEventListener('abort', onAbort);
+        };
+        const fail = (error) => {
+            if (settled)
+                return;
+            settle();
+            reject(error);
+            parser.abort(error);
+            source.destroy();
+        };
+        if (signal?.aborted)
+            return onAbort();
+        signal?.addEventListener('abort', onAbort, { once: true });
+        parser.on('entry', (entry) => {
+            const path = withoutTopFolder(entry.path);
+            if (path === undefined || !(0, skill_discovery_1.isInside)(path, root)) {
+                entry.resume();
+                return;
+            }
+            entries += 1;
+            bytes += entry.size;
+            if (entries > limits.maxEntries || bytes > limits.maxUncompressedBytes) {
+                entry.resume();
+                return fail(tooLarge(root));
+            }
+            if (entry.type !== 'File') {
+                entry.resume();
+                return;
+            }
+            paths.push(path);
+            if (!keepsText(path) || entry.size > limits.maxTextFileBytes) {
+                if (keepsText(path))
+                    oversized.add(path);
+                entry.resume();
+                return;
+            }
+            textBytes += entry.size;
+            if (textBytes > limits.maxTextBytes) {
+                entry.resume();
+                return fail(tooLarge(root));
+            }
+            const chunks = [];
+            entry.on('data', (chunk) => chunks.push(chunk));
+            entry.on('end', () => text.set(path, Buffer.concat(chunks).toString('utf8')));
+        });
+        parser.on('error', (error) => fail(new skill_source_read_error_1.SkillSourceReadError('unreachable', 'GitHub sent an archive that n8n cannot read.', {
+            cause: error,
+        })));
+        parser.on('end', () => {
+            if (settled)
+                return;
+            settle();
+            resolve({ paths, text, oversized });
+        });
+        source.on('data', (chunk) => {
+            downloaded += chunk.length;
+            if (downloaded > limits.maxDownloadBytes) {
+                return fail(new skill_source_read_error_1.SkillSourceReadError('archive_too_large', 'The repository is too large for n8n to download.'));
+            }
+            if (!parser.write(chunk)) {
+                source.pause();
+                parser.once('drain', () => source.resume());
+            }
+        });
+        source.on('end', () => parser.end());
+        source.on('error', (error) => fail(new skill_source_read_error_1.SkillSourceReadError('unreachable', 'n8n could not download the files from GitHub.', {
+            cause: error,
+        })));
+    });
+}
+function withoutTopFolder(path) {
+    const slash = path.indexOf('/');
+    const rest = slash === -1 ? '' : path.slice(slash + 1).replace(/\/$/, '');
+    return rest === '' ? undefined : rest;
+}
+function keepsText(path) {
+    const segments = path.split('/');
+    const name = segments.at(-1) ?? '';
+    if (name === 'SKILL.md')
+        return true;
+    return segments.includes('references') && /\.(md|markdown)$/i.test(name);
+}
+//# sourceMappingURL=github-archive.js.map

package/dist/modules/skills/sources/github/github-archive.js.map

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

package/dist/modules/skills/sources/github/github-link.d.ts

@@ -0,0 +1,14 @@
+export type GitHubLink = {
+    owner: string;
+    repository: string;
+    kind: 'repository' | 'tree' | 'blob';
+    rest: string[];
+};
+export declare const GITHUB_HOST = "github.com";
+export declare function isGitHubLink(input: string): boolean;
+export declare function parseGitHubLink(input: string): GitHubLink;
+export declare function splitBranchAndPath(link: GitHubLink, branches: string[]): {
+    branch: string;
+    path: string;
+} | undefined;
+export declare function gitHubTreeUrl(owner: string, repository: string, branch: string, path: string): string;

package/dist/modules/skills/sources/github/github-link.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB_HOST = void 0;
+exports.isGitHubLink = isGitHubLink;
+exports.parseGitHubLink = parseGitHubLink;
+exports.splitBranchAndPath = splitBranchAndPath;
+exports.gitHubTreeUrl = gitHubTreeUrl;
+const skill_discovery_1 = require("./skill-discovery");
+const skill_source_url_error_1 = require("../../errors/skill-source-url.error");
+exports.GITHUB_HOST = 'github.com';
+const HOSTS = new Set([exports.GITHUB_HOST, 'www.github.com']);
+const NAME = /^[A-Za-z0-9_.-]{1,100}$/;
+const NOT_GITHUB = 'This is not a GitHub repository link. Use https://github.com/owner/repo.';
+function isGitHubLink(input) {
+    try {
+        return HOSTS.has(new URL(input.trim()).hostname.toLowerCase());
+    }
+    catch {
+        return false;
+    }
+}
+function parseGitHubLink(input) {
+    let url;
+    try {
+        url = new URL(input.trim());
+    }
+    catch {
+        throw new skill_source_url_error_1.SkillSourceUrlError(NOT_GITHUB);
+    }
+    if (url.protocol !== 'https:' || !HOSTS.has(url.hostname.toLowerCase())) {
+        throw new skill_source_url_error_1.SkillSourceUrlError(NOT_GITHUB);
+    }
+    let segments;
+    try {
+        segments = url.pathname.split('/').filter(Boolean).map(decodeURIComponent);
+    }
+    catch {
+        throw new skill_source_url_error_1.SkillSourceUrlError(NOT_GITHUB);
+    }
+    const [owner, rawRepository, kind, ...rest] = segments;
+    const repository = rawRepository?.replace(/\.git$/, '');
+    if (!owner || !repository || !NAME.test(owner) || !NAME.test(repository)) {
+        throw new skill_source_url_error_1.SkillSourceUrlError(NOT_GITHUB);
+    }
+    if (kind === undefined)
+        return { owner, repository, kind: 'repository', rest: [] };
+    if ((kind !== 'tree' && kind !== 'blob') || rest.length === 0) {
+        throw new skill_source_url_error_1.SkillSourceUrlError('Use a link to a repository, a folder, or a SKILL.md file.');
+    }
+    if (rest.some((segment) => segment === '.' || segment === '..' || segment.includes('/'))) {
+        throw new skill_source_url_error_1.SkillSourceUrlError('This link has an invalid path.');
+    }
+    if (kind === 'blob' && rest.at(-1) !== skill_discovery_1.SKILL_FILE) {
+        throw new skill_source_url_error_1.SkillSourceUrlError('A link to a file must point to a SKILL.md file.');
+    }
+    return { owner, repository, kind, rest };
+}
+function splitBranchAndPath(link, branches) {
+    const segments = link.kind === 'blob' ? link.rest.slice(0, -1) : link.rest;
+    let best;
+    for (const branch of branches) {
+        const parts = branch.split('/');
+        const matches = parts.length <= segments.length && parts.every((part, index) => segments[index] === part);
+        if (matches && (best === undefined || parts.length > best.split('/').length))
+            best = branch;
+    }
+    if (best === undefined)
+        return undefined;
+    return { branch: best, path: segments.slice(best.split('/').length).join('/') };
+}
+function gitHubTreeUrl(owner, repository, branch, path) {
+    const segments = [owner, repository, 'tree', ...branch.split('/'), ...path.split('/')];
+    return `https://${exports.GITHUB_HOST}/${segments.filter(Boolean).map(encodeURIComponent).join('/')}`;
+}
+//# sourceMappingURL=github-link.js.map

package/dist/modules/skills/sources/github/github-link.js.map

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