hagiscript-sdk 0.2.9-dev.1780142424.1.dedbfb7

package/dist/src/runtime/tool-sync-catalog.js

@@ -0,0 +1,189 @@
+import { basename } from "node:path";
+import semver from "semver";
+import toolSyncCatalogConfig from "./tool-sync-catalog.config.json" with { type: "json" };
+export class ToolSyncCatalogValidationError extends Error {
+    errors;
+    constructor(errors) {
+        super(`Tool sync catalog validation failed: ${errors.join("; ")}`);
+        this.name = "ToolSyncCatalogValidationError";
+        this.errors = errors;
+    }
+}
+export const builtInToolSyncCatalogConfig = toolSyncCatalogConfig;
+export const builtInToolSyncCatalog = builtInToolSyncCatalogConfig.tools;
+export function validateToolSyncCatalog(catalog = builtInToolSyncCatalog) {
+    const errors = [];
+    const seenIds = new Set();
+    const seenMandatory = new Set();
+    for (const entry of catalog) {
+        validateCatalogEntry(entry, errors);
+        if (seenIds.has(entry.id)) {
+            errors.push(`duplicate tool ID: ${entry.id}`);
+        }
+        seenIds.add(entry.id);
+        if (entry.requirement === "mandatory") {
+            seenMandatory.add(entry.id);
+        }
+    }
+    for (const requiredId of ["openspec-skills"]) {
+        if (!seenMandatory.has(requiredId)) {
+            errors.push(`missing mandatory tool: ${requiredId}`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new ToolSyncCatalogValidationError(errors);
+    }
+    return catalog;
+}
+export function buildToolSyncPackageSet(options = {}) {
+    const catalog = validateToolSyncCatalog(options.catalog ?? builtInToolSyncCatalog);
+    const errors = [];
+    const packages = {};
+    const optionalEntries = catalog.filter((entry) => entry.group === "optional-agent-cli");
+    const optionalById = new Map(optionalEntries.map((entry) => [entry.id, entry]));
+    const selectedIds = normalizeSelectedIds(options.selectedOptionalAgentCliIds ?? []);
+    const customEntries = normalizeCustomAgentCliTools(options.customAgentClis ?? [], errors);
+    if (options.optionalAgentCliSyncEnabled) {
+        for (const selectedId of selectedIds) {
+            if (!optionalById.has(selectedId)) {
+                errors.push(`unknown optional agent CLI tool ID: ${selectedId}`);
+            }
+        }
+    }
+    else if (selectedIds.length > 0 || customEntries.length > 0) {
+        errors.push("optional agent CLI sync must be enabled when optional CLI selections are provided");
+    }
+    for (const entry of catalog) {
+        if (entry.requirement !== "mandatory") {
+            continue;
+        }
+        addPackageConstraint(packages, entry, errors);
+    }
+    if (options.optionalAgentCliSyncEnabled) {
+        for (const selectedId of selectedIds) {
+            const entry = optionalById.get(selectedId);
+            if (entry) {
+                addPackageConstraint(packages, entry, errors);
+            }
+        }
+        for (const entry of customEntries) {
+            addPackageConstraint(packages, entry, errors);
+        }
+    }
+    if (errors.length > 0) {
+        throw new ToolSyncCatalogValidationError(errors);
+    }
+    return Object.fromEntries(Object.entries(packages).sort(([left], [right]) => left.localeCompare(right)));
+}
+export function normalizeToolSyncEntry(entry) {
+    return [
+        entry.packageName,
+        {
+            version: normalizeVersionSelector(entry.version),
+            target: entry.target?.trim(),
+            toolId: entry.id,
+            toolDisplayName: entry.displayName,
+            toolGroup: entry.group,
+            toolRequirement: entry.requirement
+        }
+    ];
+}
+function addPackageConstraint(packages, entry, errors) {
+    const [packageName, constraint] = normalizeToolSyncEntry(entry);
+    const existing = packages[packageName];
+    if (existing) {
+        errors.push(`package ${packageName} is declared by both ${existing.toolId} and ${entry.id}`);
+        return;
+    }
+    packages[packageName] = constraint;
+}
+function validateCatalogEntry(entry, errors) {
+    if (!isValidToolId(entry.id)) {
+        errors.push(`invalid tool ID: ${entry.id}`);
+    }
+    if (entry.displayName.trim().length === 0) {
+        errors.push(`${entry.id}.displayName must be non-empty`);
+    }
+    if (!isValidPackageName(entry.packageName)) {
+        errors.push(`${entry.id}.packageName is invalid: ${entry.packageName}`);
+    }
+    if (!isValidVersionSelector(entry.version)) {
+        errors.push(`${entry.id}.version is invalid: ${entry.version}`);
+    }
+    if (entry.target !== undefined && entry.target.trim().length === 0) {
+        errors.push(`${entry.id}.target must be non-empty when provided`);
+    }
+    if (entry.group === "mandatory" && entry.requirement !== "mandatory") {
+        errors.push(`${entry.id} must be mandatory in the mandatory group`);
+    }
+    if (entry.group === "optional-agent-cli" && entry.requirement !== "optional") {
+        errors.push(`${entry.id} must be optional in the optional agent CLI group`);
+    }
+}
+function normalizeSelectedIds(ids) {
+    return Array.from(new Set(ids.map((id) => id.trim()).filter(Boolean))).sort();
+}
+function normalizeCustomAgentCliTools(inputs, errors) {
+    return inputs.map((input, index) => {
+        const packageName = input.packageName?.trim() ?? "";
+        const id = input.id?.trim() || `custom:${packageNameToToolId(packageName)}`;
+        const version = input.version?.trim() || "latest";
+        const displayName = input.displayName?.trim() || packageName;
+        const target = input.target?.trim() || version;
+        const entry = {
+            id,
+            displayName,
+            packageName,
+            version,
+            target,
+            group: "optional-agent-cli",
+            requirement: "optional"
+        };
+        if (!packageName) {
+            errors.push(`customAgentClis[${index}].packageName must be non-empty`);
+        }
+        validateCatalogEntry(entry, errors);
+        return entry;
+    });
+}
+function normalizeVersionSelector(selector) {
+    const trimmed = selector.trim();
+    return trimmed === "latest" ? "*" : trimmed;
+}
+function isValidVersionSelector(selector) {
+    const normalized = normalizeVersionSelector(selector);
+    return normalized.length > 0 && semver.validRange(normalized) !== null;
+}
+function isValidToolId(id) {
+    return /^[a-z0-9][a-z0-9:-]*$/u.test(id);
+}
+function packageNameToToolId(packageName) {
+    return packageName
+        .replace(/^@/u, "")
+        .replace(/[^a-zA-Z0-9]+/gu, "-")
+        .replace(/^-+|-+$/gu, "")
+        .toLowerCase();
+}
+function isValidPackageName(packageName) {
+    if (packageName.trim() !== packageName || packageName.length === 0) {
+        return false;
+    }
+    if (packageName.includes("\\") || packageName.includes("/../")) {
+        return false;
+    }
+    if (packageName.startsWith("@")) {
+        const parts = packageName.split("/");
+        return (parts.length === 2 &&
+            parts[0].startsWith("@") &&
+            isValidPackageNamePart(parts[0].slice(1)) &&
+            isValidPackageNamePart(parts[1]));
+    }
+    return !packageName.includes("/") && isValidPackageNamePart(packageName);
+}
+function isValidPackageNamePart(value) {
+    return (value.length > 0 &&
+        value === basename(value) &&
+        !value.startsWith(".") &&
+        !/[\s@]/u.test(value));
+}
+//# sourceMappingURL=tool-sync-catalog.js.map

package/dist/src/runtime/tool-sync-catalog.js.map

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

package/dist/src/runtime/zip-extract.d.ts

@@ -0,0 +1,6 @@
+import { type CommandRunner } from "./command-launch.js";
+export interface ZipExtractionOptions {
+    platform?: NodeJS.Platform;
+    runCommand?: CommandRunner;
+}
+export declare function extractZipArchive(archivePath: string, destination: string, options?: ZipExtractionOptions): Promise<void>;

package/dist/src/runtime/zip-extract.js

@@ -0,0 +1,90 @@
+import extractZip from "extract-zip";
+import { resolve } from "node:path";
+import { CommandExecutionError, runCommand } from "./command-launch.js";
+const windowsTarCommands = ["tar.exe", "tar"];
+const windowsPowerShellCommands = ["pwsh", "powershell.exe", "powershell"];
+export async function extractZipArchive(archivePath, destination, options = {}) {
+    const platform = options.platform ?? process.platform;
+    const runner = options.runCommand ?? runCommand;
+    const resolvedDestination = resolve(destination);
+    const nativeFailures = [];
+    if (platform === "win32") {
+        const nativeResult = await tryExtractZipArchiveWithNativeTools(archivePath, resolvedDestination, runner);
+        if (nativeResult.success) {
+            return;
+        }
+        nativeFailures.push(...nativeResult.failures);
+    }
+    try {
+        await extractZip(archivePath, {
+            dir: resolvedDestination
+        });
+    }
+    catch (error) {
+        const archiveError = error instanceof Error ? error : new Error(String(error));
+        const nativeSummary = nativeFailures.length > 0
+            ? ` Native attempts: ${nativeFailures.join(" | ")}.`
+            : "";
+        throw new Error(`Failed to extract zip archive ${archivePath}: ${archiveError.message}.${nativeSummary}`);
+    }
+}
+async function tryExtractZipArchiveWithNativeTools(archivePath, destination, runner) {
+    const failures = [];
+    for (const command of windowsTarCommands) {
+        const result = await tryRunZipExtractionCommand(runner, command, [
+            "-xf",
+            archivePath,
+            "-C",
+            destination
+        ]);
+        if (result.success) {
+            return { success: true, failures };
+        }
+        failures.push(result.failure);
+    }
+    for (const command of windowsPowerShellCommands) {
+        const result = await tryRunZipExtractionCommand(runner, command, [
+            "-NoLogo",
+            "-NoProfile",
+            "-NonInteractive",
+            "-Command",
+            buildExpandArchiveCommand(archivePath, destination)
+        ]);
+        if (result.success) {
+            return { success: true, failures };
+        }
+        failures.push(result.failure);
+    }
+    return { success: false, failures };
+}
+async function tryRunZipExtractionCommand(runner, command, args) {
+    try {
+        await runner(command, args);
+        return { success: true };
+    }
+    catch (error) {
+        return {
+            success: false,
+            failure: formatCommandFailure(command, error)
+        };
+    }
+}
+function buildExpandArchiveCommand(archivePath, destination) {
+    const escapedArchivePath = escapePowerShellSingleQuotedString(archivePath);
+    const escapedDestination = escapePowerShellSingleQuotedString(destination);
+    return `Expand-Archive -LiteralPath '${escapedArchivePath}' -DestinationPath '${escapedDestination}' -Force`;
+}
+function escapePowerShellSingleQuotedString(value) {
+    return value.replaceAll("'", "''");
+}
+function formatCommandFailure(command, error) {
+    if (error instanceof CommandExecutionError) {
+        const details = error.context.stderr.trim() || error.context.stdout.trim() || error.message;
+        return `${command}: ${details}`;
+    }
+    if (error instanceof Error) {
+        return `${command}: ${error.message}`;
+    }
+    return `${command}: ${String(error)}`;
+}
+//# sourceMappingURL=zip-extract.js.map

package/dist/src/runtime/zip-extract.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,7 @@
+export interface PackageMetadata {
+    name: string;
+    version: string;
+}
+export declare const packageName: string;
+export declare const packageVersion: string;
+export declare function getPackageMetadata(): PackageMetadata;

package/dist/src/version.js

@@ -0,0 +1,23 @@
+import { readFileSync } from "node:fs";
+function loadPackageMetadata() {
+    const packageJsonUrl = new URL("../package.json", import.meta.url);
+    const packageJson = JSON.parse(readFileSync(packageJsonUrl, "utf8"));
+    if (typeof packageJson.name !== "string" || packageJson.name.length === 0) {
+        throw new Error("package.json must define a non-empty string name.");
+    }
+    if (typeof packageJson.version !== "string" ||
+        packageJson.version.length === 0) {
+        throw new Error("package.json must define a non-empty string version.");
+    }
+    return {
+        name: packageJson.name,
+        version: packageJson.version
+    };
+}
+const packageMetadata = loadPackageMetadata();
+export const packageName = packageMetadata.name;
+export const packageVersion = packageMetadata.version;
+export function getPackageMetadata() {
+    return { ...packageMetadata };
+}
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOvC,SAAS,mBAAmB;IAC1B,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAGlE,CAAC;IAEF,IAAI,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,IACE,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ;QACvC,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAChC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,eAAe,GAAG,mBAAmB,EAAE,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC;AAEtD,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "hagiscript-sdk",
+  "version": "0.2.9-dev.1780142424.1.dedbfb7",
+  "description": "SDK-only distribution of Hagiscript runtime and server management APIs.",
+  "license": "MIT",
+  "homepage": "https://github.com/HagiCode-org/hagiscript#readme",
+  "bugs": {
+    "url": "https://github.com/HagiCode-org/hagiscript/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HagiCode-org/hagiscript.git"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "7zip-bin": "^5.2.0",
+    "execa": "^9.6.1",
+    "extract-zip": "^2.0.1",
+    "semver": "^7.7.4",
+    "yaml": "^2.8.4"
+  }
+}